1e2be04c7SGreg Kroah-Hartman /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ 2607ca46eSDavid Howells /* keyctl.h: keyctl command IDs 3607ca46eSDavid Howells * 4607ca46eSDavid Howells * Copyright (C) 2004, 2008 Red Hat, Inc. All Rights Reserved. 5607ca46eSDavid Howells * Written by David Howells (dhowells@redhat.com) 6607ca46eSDavid Howells * 7607ca46eSDavid Howells * This program is free software; you can redistribute it and/or 8607ca46eSDavid Howells * modify it under the terms of the GNU General Public License 9607ca46eSDavid Howells * as published by the Free Software Foundation; either version 10607ca46eSDavid Howells * 2 of the License, or (at your option) any later version. 11607ca46eSDavid Howells */ 12607ca46eSDavid Howells 13607ca46eSDavid Howells #ifndef _LINUX_KEYCTL_H 14607ca46eSDavid Howells #define _LINUX_KEYCTL_H 15607ca46eSDavid Howells 16ddbb4114SMat Martineau #include <linux/types.h> 17ddbb4114SMat Martineau 18607ca46eSDavid Howells /* special process keyring shortcut IDs */ 19607ca46eSDavid Howells #define KEY_SPEC_THREAD_KEYRING -1 /* - key ID for thread-specific keyring */ 20607ca46eSDavid Howells #define KEY_SPEC_PROCESS_KEYRING -2 /* - key ID for process-specific keyring */ 21607ca46eSDavid Howells #define KEY_SPEC_SESSION_KEYRING -3 /* - key ID for session-specific keyring */ 22607ca46eSDavid Howells #define KEY_SPEC_USER_KEYRING -4 /* - key ID for UID-specific keyring */ 23607ca46eSDavid Howells #define KEY_SPEC_USER_SESSION_KEYRING -5 /* - key ID for UID-session keyring */ 24607ca46eSDavid Howells #define KEY_SPEC_GROUP_KEYRING -6 /* - key ID for GID-specific keyring */ 25607ca46eSDavid Howells #define KEY_SPEC_REQKEY_AUTH_KEY -7 /* - key ID for assumed request_key auth key */ 26607ca46eSDavid Howells #define KEY_SPEC_REQUESTOR_KEYRING -8 /* - key ID for request_key() dest keyring */ 27607ca46eSDavid Howells 28607ca46eSDavid Howells /* request-key default keyrings */ 29607ca46eSDavid Howells #define KEY_REQKEY_DEFL_NO_CHANGE -1 30607ca46eSDavid Howells #define KEY_REQKEY_DEFL_DEFAULT 0 31607ca46eSDavid Howells #define KEY_REQKEY_DEFL_THREAD_KEYRING 1 32607ca46eSDavid Howells #define KEY_REQKEY_DEFL_PROCESS_KEYRING 2 33607ca46eSDavid Howells #define KEY_REQKEY_DEFL_SESSION_KEYRING 3 34607ca46eSDavid Howells #define KEY_REQKEY_DEFL_USER_KEYRING 4 35607ca46eSDavid Howells #define KEY_REQKEY_DEFL_USER_SESSION_KEYRING 5 36607ca46eSDavid Howells #define KEY_REQKEY_DEFL_GROUP_KEYRING 6 37607ca46eSDavid Howells #define KEY_REQKEY_DEFL_REQUESTOR_KEYRING 7 38607ca46eSDavid Howells 39607ca46eSDavid Howells /* keyctl commands */ 40607ca46eSDavid Howells #define KEYCTL_GET_KEYRING_ID 0 /* ask for a keyring's ID */ 41607ca46eSDavid Howells #define KEYCTL_JOIN_SESSION_KEYRING 1 /* join or start named session keyring */ 42607ca46eSDavid Howells #define KEYCTL_UPDATE 2 /* update a key */ 43607ca46eSDavid Howells #define KEYCTL_REVOKE 3 /* revoke a key */ 44607ca46eSDavid Howells #define KEYCTL_CHOWN 4 /* set ownership of a key */ 45607ca46eSDavid Howells #define KEYCTL_SETPERM 5 /* set perms on a key */ 46607ca46eSDavid Howells #define KEYCTL_DESCRIBE 6 /* describe a key */ 47607ca46eSDavid Howells #define KEYCTL_CLEAR 7 /* clear contents of a keyring */ 48607ca46eSDavid Howells #define KEYCTL_LINK 8 /* link a key into a keyring */ 49607ca46eSDavid Howells #define KEYCTL_UNLINK 9 /* unlink a key from a keyring */ 50607ca46eSDavid Howells #define KEYCTL_SEARCH 10 /* search for a key in a keyring */ 51607ca46eSDavid Howells #define KEYCTL_READ 11 /* read a key or keyring's contents */ 52607ca46eSDavid Howells #define KEYCTL_INSTANTIATE 12 /* instantiate a partially constructed key */ 53607ca46eSDavid Howells #define KEYCTL_NEGATE 13 /* negate a partially constructed key */ 54607ca46eSDavid Howells #define KEYCTL_SET_REQKEY_KEYRING 14 /* set default request-key keyring */ 55607ca46eSDavid Howells #define KEYCTL_SET_TIMEOUT 15 /* set key timeout */ 56607ca46eSDavid Howells #define KEYCTL_ASSUME_AUTHORITY 16 /* assume request_key() authorisation */ 57607ca46eSDavid Howells #define KEYCTL_GET_SECURITY 17 /* get key security label */ 58607ca46eSDavid Howells #define KEYCTL_SESSION_TO_PARENT 18 /* apply session keyring to parent process */ 59607ca46eSDavid Howells #define KEYCTL_REJECT 19 /* reject a partially constructed key */ 60607ca46eSDavid Howells #define KEYCTL_INSTANTIATE_IOV 20 /* instantiate a partially constructed key */ 61607ca46eSDavid Howells #define KEYCTL_INVALIDATE 21 /* invalidate a key */ 62f36f8c75SDavid Howells #define KEYCTL_GET_PERSISTENT 22 /* get a user's persistent keyring */ 63ddbb4114SMat Martineau #define KEYCTL_DH_COMPUTE 23 /* Compute Diffie-Hellman values */ 6400d60fd3SDavid Howells #define KEYCTL_PKEY_QUERY 24 /* Query public key parameters */ 6500d60fd3SDavid Howells #define KEYCTL_PKEY_ENCRYPT 25 /* Encrypt a blob using a public key */ 6600d60fd3SDavid Howells #define KEYCTL_PKEY_DECRYPT 26 /* Decrypt a blob using a public key */ 6700d60fd3SDavid Howells #define KEYCTL_PKEY_SIGN 27 /* Create a public key signature */ 6800d60fd3SDavid Howells #define KEYCTL_PKEY_VERIFY 28 /* Verify a public key signature */ 696563c91fSMat Martineau #define KEYCTL_RESTRICT_KEYRING 29 /* Restrict keys allowed to link to a keyring */ 70ed0ac5c7SDavid Howells #define KEYCTL_MOVE 30 /* Move keys between keyrings */ 7145e0f30cSDavid Howells #define KEYCTL_CAPABILITIES 31 /* Find capabilities of keyrings subsystem */ 72*f7e47677SDavid Howells #define KEYCTL_WATCH_KEY 32 /* Watch a key or ring of keys for changes */ 73ddbb4114SMat Martineau 74ddbb4114SMat Martineau /* keyctl structures */ 75ddbb4114SMat Martineau struct keyctl_dh_params { 762ecefa0aSDavid Howells union { 772ecefa0aSDavid Howells #ifndef __cplusplus 78ddbb4114SMat Martineau __s32 private; 792ecefa0aSDavid Howells #endif 802ecefa0aSDavid Howells __s32 priv; 812ecefa0aSDavid Howells }; 82ddbb4114SMat Martineau __s32 prime; 83ddbb4114SMat Martineau __s32 base; 84ddbb4114SMat Martineau }; 85607ca46eSDavid Howells 86f1c316a3SStephan Mueller struct keyctl_kdf_params { 87a7739544SEric Biggers char __user *hashname; 88a7739544SEric Biggers char __user *otherinfo; 89f1c316a3SStephan Mueller __u32 otherinfolen; 90f1c316a3SStephan Mueller __u32 __spare[8]; 91f1c316a3SStephan Mueller }; 92f1c316a3SStephan Mueller 9370025f84SDavid Howells #define KEYCTL_SUPPORTS_ENCRYPT 0x01 9470025f84SDavid Howells #define KEYCTL_SUPPORTS_DECRYPT 0x02 9570025f84SDavid Howells #define KEYCTL_SUPPORTS_SIGN 0x04 9670025f84SDavid Howells #define KEYCTL_SUPPORTS_VERIFY 0x08 9770025f84SDavid Howells 9800d60fd3SDavid Howells struct keyctl_pkey_query { 9900d60fd3SDavid Howells __u32 supported_ops; /* Which ops are supported */ 10000d60fd3SDavid Howells __u32 key_size; /* Size of the key in bits */ 10100d60fd3SDavid Howells __u16 max_data_size; /* Maximum size of raw data to sign in bytes */ 10200d60fd3SDavid Howells __u16 max_sig_size; /* Maximum size of signature in bytes */ 10300d60fd3SDavid Howells __u16 max_enc_size; /* Maximum size of encrypted blob in bytes */ 10400d60fd3SDavid Howells __u16 max_dec_size; /* Maximum size of decrypted blob in bytes */ 10500d60fd3SDavid Howells __u32 __spare[10]; 10600d60fd3SDavid Howells }; 10700d60fd3SDavid Howells 10800d60fd3SDavid Howells struct keyctl_pkey_params { 10900d60fd3SDavid Howells __s32 key_id; /* Serial no. of public key to use */ 11000d60fd3SDavid Howells __u32 in_len; /* Input data size */ 11100d60fd3SDavid Howells union { 11200d60fd3SDavid Howells __u32 out_len; /* Output buffer size (encrypt/decrypt/sign) */ 11300d60fd3SDavid Howells __u32 in2_len; /* 2nd input data size (verify) */ 11400d60fd3SDavid Howells }; 11500d60fd3SDavid Howells __u32 __spare[7]; 11600d60fd3SDavid Howells }; 11700d60fd3SDavid Howells 118ed0ac5c7SDavid Howells #define KEYCTL_MOVE_EXCL 0x00000001 /* Do not displace from the to-keyring */ 119ed0ac5c7SDavid Howells 12045e0f30cSDavid Howells /* 12145e0f30cSDavid Howells * Capabilities flags. The capabilities list is an array of 8-bit integers; 12245e0f30cSDavid Howells * each integer can carry up to 8 flags. 12345e0f30cSDavid Howells */ 12445e0f30cSDavid Howells #define KEYCTL_CAPS0_CAPABILITIES 0x01 /* KEYCTL_CAPABILITIES supported */ 12545e0f30cSDavid Howells #define KEYCTL_CAPS0_PERSISTENT_KEYRINGS 0x02 /* Persistent keyrings enabled */ 12645e0f30cSDavid Howells #define KEYCTL_CAPS0_DIFFIE_HELLMAN 0x04 /* Diffie-Hellman computation enabled */ 12745e0f30cSDavid Howells #define KEYCTL_CAPS0_PUBLIC_KEY 0x08 /* Public key ops enabled */ 12845e0f30cSDavid Howells #define KEYCTL_CAPS0_BIG_KEY 0x10 /* big_key-type enabled */ 12945e0f30cSDavid Howells #define KEYCTL_CAPS0_INVALIDATE 0x20 /* KEYCTL_INVALIDATE supported */ 13045e0f30cSDavid Howells #define KEYCTL_CAPS0_RESTRICT_KEYRING 0x40 /* KEYCTL_RESTRICT_KEYRING supported */ 13145e0f30cSDavid Howells #define KEYCTL_CAPS0_MOVE 0x80 /* KEYCTL_MOVE supported */ 132b206f281SDavid Howells #define KEYCTL_CAPS1_NS_KEYRING_NAME 0x01 /* Keyring names are per-user_namespace */ 1333b6e4de0SDavid Howells #define KEYCTL_CAPS1_NS_KEY_TAG 0x02 /* Key indexing can include a namespace tag */ 134*f7e47677SDavid Howells #define KEYCTL_CAPS1_NOTIFICATIONS 0x04 /* Keys generate watchable notifications */ 13545e0f30cSDavid Howells 136607ca46eSDavid Howells #endif /* _LINUX_KEYCTL_H */ 137