include/uapi/linux/keyctl.h

   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 */