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 */ 72 struct 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 83 struct 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 95 struct 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 105 struct 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