1/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
2/* keyctl.h: keyctl command IDs
3 *
4 * Copyright (C) 2004, 2008 Red Hat, Inc. All Rights Reserved.
5 * Written by David Howells (dhowells@redhat.com)
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version
10 * 2 of the License, or (at your option) any later version.
11 */
12
13#ifndef _LINUX_KEYCTL_H
14#define _LINUX_KEYCTL_H
15
16#include <linux/types.h>
17
18/* special process keyring shortcut IDs */
19#define KEY_SPEC_THREAD_KEYRING -1 /* - key ID for thread-specific keyring */
20#define KEY_SPEC_PROCESS_KEYRING -2 /* - key ID for process-specific keyring */
21#define KEY_SPEC_SESSION_KEYRING -3 /* - key ID for session-specific keyring */
22#define KEY_SPEC_USER_KEYRING -4 /* - key ID for UID-specific keyring */
23#define KEY_SPEC_USER_SESSION_KEYRING -5 /* - key ID for UID-session keyring */
24#define KEY_SPEC_GROUP_KEYRING -6 /* - key ID for GID-specific keyring */
25#define KEY_SPEC_REQKEY_AUTH_KEY -7 /* - key ID for assumed request_key auth key */
26#define KEY_SPEC_REQUESTOR_KEYRING -8 /* - key ID for request_key() dest keyring */
27
28/* request-key default keyrings */
29#define KEY_REQKEY_DEFL_NO_CHANGE -1
30#define KEY_REQKEY_DEFL_DEFAULT 0
31#define KEY_REQKEY_DEFL_THREAD_KEYRING 1
32#define KEY_REQKEY_DEFL_PROCESS_KEYRING 2
33#define KEY_REQKEY_DEFL_SESSION_KEYRING 3
34#define KEY_REQKEY_DEFL_USER_KEYRING 4
35#define KEY_REQKEY_DEFL_USER_SESSION_KEYRING 5
36#define KEY_REQKEY_DEFL_GROUP_KEYRING 6
37#define KEY_REQKEY_DEFL_REQUESTOR_KEYRING 7
38
39/* keyctl commands */
40#define KEYCTL_GET_KEYRING_ID 0 /* ask for a keyring's ID */
41#define KEYCTL_JOIN_SESSION_KEYRING 1 /* join or start named session keyring */
42#define KEYCTL_UPDATE 2 /* update a key */
43#define KEYCTL_REVOKE 3 /* revoke a key */
44#define KEYCTL_CHOWN 4 /* set ownership of a key */
45#define KEYCTL_SETPERM 5 /* set perms on a key */
46#define KEYCTL_DESCRIBE 6 /* describe a key */
47#define KEYCTL_CLEAR 7 /* clear contents of a keyring */
48#define KEYCTL_LINK 8 /* link a key into a keyring */
49#define KEYCTL_UNLINK 9 /* unlink a key from a keyring */
50#define KEYCTL_SEARCH 10 /* search for a key in a keyring */
51#define KEYCTL_READ 11 /* read a key or keyring's contents */
52#define KEYCTL_INSTANTIATE 12 /* instantiate a partially constructed key */
53#define KEYCTL_NEGATE 13 /* negate a partially constructed key */
54#define KEYCTL_SET_REQKEY_KEYRING 14 /* set default request-key keyring */
55#define KEYCTL_SET_TIMEOUT 15 /* set key timeout */
56#define KEYCTL_ASSUME_AUTHORITY 16 /* assume request_key() authorisation */
57#define KEYCTL_GET_SECURITY 17 /* get key security label */
58#define KEYCTL_SESSION_TO_PARENT 18 /* apply session keyring to parent process */
59#define KEYCTL_REJECT 19 /* reject a partially constructed key */
60#define KEYCTL_INSTANTIATE_IOV 20 /* instantiate a partially constructed key */
61#define KEYCTL_INVALIDATE 21 /* invalidate a key */
62#define KEYCTL_GET_PERSISTENT 22 /* get a user's persistent keyring */
63#define KEYCTL_DH_COMPUTE 23 /* Compute Diffie-Hellman values */
64#define KEYCTL_PKEY_QUERY 24 /* Query public key parameters */
65#define KEYCTL_PKEY_ENCRYPT 25 /* Encrypt a blob using a public key */
66#define KEYCTL_PKEY_DECRYPT 26 /* Decrypt a blob using a public key */
67#define KEYCTL_PKEY_SIGN 27 /* Create a public key signature */
68#define KEYCTL_PKEY_VERIFY 28 /* Verify a public key signature */
69#define KEYCTL_RESTRICT_KEYRING 29 /* Restrict keys allowed to link to a keyring */
70
71/* keyctl structures */
72struct keyctl_dh_params {
73 union {
74#ifndef __cplusplus
75 __s32 private;
76#endif
77 __s32 priv;
78 };
79 __s32 prime;
80 __s32 base;
81};
82
83struct keyctl_kdf_params {
84 char __user *hashname;
85 char __user *otherinfo;
86 __u32 otherinfolen;
87 __u32 __spare[8];
88};
89
90#define KEYCTL_SUPPORTS_ENCRYPT 0x01
91#define KEYCTL_SUPPORTS_DECRYPT 0x02
92#define KEYCTL_SUPPORTS_SIGN 0x04
93#define KEYCTL_SUPPORTS_VERIFY 0x08
94
95struct keyctl_pkey_query {
96 __u32 supported_ops; /* Which ops are supported */
97 __u32 key_size; /* Size of the key in bits */
98 __u16 max_data_size; /* Maximum size of raw data to sign in bytes */
99 __u16 max_sig_size; /* Maximum size of signature in bytes */
100 __u16 max_enc_size; /* Maximum size of encrypted blob in bytes */
101 __u16 max_dec_size; /* Maximum size of decrypted blob in bytes */
102 __u32 __spare[10];
103};
104
105struct keyctl_pkey_params {
106 __s32 key_id; /* Serial no. of public key to use */
107 __u32 in_len; /* Input data size */
108 union {
109 __u32 out_len; /* Output buffer size (encrypt/decrypt/sign) */
110 __u32 in2_len; /* 2nd input data size (verify) */
111 };
112 __u32 __spare[7];
113};
114
115#endif /* _LINUX_KEYCTL_H */
116