tools/crypto/ccp/dbc.c
Source file repositories/reference/linux-study-clean/tools/crypto/ccp/dbc.c
File Facts
- System
- Linux kernel
- Corpus path
tools/crypto/ccp/dbc.c- Extension
.c- Size
- 1466 bytes
- Lines
- 73
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: implementation source
- Status
- source implementation candidate
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
assert.herrno.hstring.hsys/ioctl.hlinux/psp-dbc.h
Detected Declarations
function Copyrightfunction set_uidfunction process_param
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-only
/*
* AMD Secure Processor Dynamic Boost Control sample library
*
* Copyright (C) 2023 Advanced Micro Devices, Inc.
*
* Author: Mario Limonciello <mario.limonciello@amd.com>
*/
#include <assert.h>
#include <errno.h>
#include <string.h>
#include <sys/ioctl.h>
/* if uapi header isn't installed, this might not yet exist */
#ifndef __packed
#define __packed __attribute__((packed))
#endif
#include <linux/psp-dbc.h>
int get_nonce(int fd, void *nonce_out, void *signature)
{
struct dbc_user_nonce tmp = {
.auth_needed = !!signature,
};
assert(nonce_out);
if (signature)
memcpy(tmp.signature, signature, sizeof(tmp.signature));
if (ioctl(fd, DBCIOCNONCE, &tmp))
return errno;
memcpy(nonce_out, tmp.nonce, sizeof(tmp.nonce));
return 0;
}
int set_uid(int fd, __u8 *uid, __u8 *signature)
{
struct dbc_user_setuid tmp;
assert(uid);
assert(signature);
memcpy(tmp.uid, uid, sizeof(tmp.uid));
memcpy(tmp.signature, signature, sizeof(tmp.signature));
if (ioctl(fd, DBCIOCUID, &tmp))
return errno;
return 0;
}
int process_param(int fd, int msg_index, __u8 *signature, int *data)
{
struct dbc_user_param tmp = {
.msg_index = msg_index,
.param = *data,
};
assert(signature);
assert(data);
memcpy(tmp.signature, signature, sizeof(tmp.signature));
if (ioctl(fd, DBCIOCPARAM, &tmp))
return errno;
*data = tmp.param;
memcpy(signature, tmp.signature, sizeof(tmp.signature));
return 0;
}
Annotation
- Immediate include surface: `assert.h`, `errno.h`, `string.h`, `sys/ioctl.h`, `linux/psp-dbc.h`.
- Detected declarations: `function Copyright`, `function set_uid`, `function process_param`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.