137 lines · c
1/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */2/* keyctl.h: keyctl command IDs3 *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/or8 * modify it under the terms of the GNU General Public License9 * as published by the Free Software Foundation; either version10 * 2 of the License, or (at your option) any later version.11 */12 13#ifndef _LINUX_KEYCTL_H14#define _LINUX_KEYCTL_H15 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 -130#define KEY_REQKEY_DEFL_DEFAULT 031#define KEY_REQKEY_DEFL_THREAD_KEYRING 132#define KEY_REQKEY_DEFL_PROCESS_KEYRING 233#define KEY_REQKEY_DEFL_SESSION_KEYRING 334#define KEY_REQKEY_DEFL_USER_KEYRING 435#define KEY_REQKEY_DEFL_USER_SESSION_KEYRING 536#define KEY_REQKEY_DEFL_GROUP_KEYRING 637#define KEY_REQKEY_DEFL_REQUESTOR_KEYRING 738 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#define KEYCTL_MOVE 30 /* Move keys between keyrings */71#define KEYCTL_CAPABILITIES 31 /* Find capabilities of keyrings subsystem */72#define KEYCTL_WATCH_KEY 32 /* Watch a key or ring of keys for changes */73 74/* keyctl structures */75struct keyctl_dh_params {76 union {77#ifndef __cplusplus78 __s32 private;79#endif80 __s32 priv;81 };82 __s32 prime;83 __s32 base;84};85 86struct keyctl_kdf_params {87 char __user *hashname;88 char __user *otherinfo;89 __u32 otherinfolen;90 __u32 __spare[8];91};92 93#define KEYCTL_SUPPORTS_ENCRYPT 0x0194#define KEYCTL_SUPPORTS_DECRYPT 0x0295#define KEYCTL_SUPPORTS_SIGN 0x0496#define KEYCTL_SUPPORTS_VERIFY 0x0897 98struct keyctl_pkey_query {99 __u32 supported_ops; /* Which ops are supported */100 __u32 key_size; /* Size of the key in bits */101 __u16 max_data_size; /* Maximum size of raw data to sign in bytes */102 __u16 max_sig_size; /* Maximum size of signature in bytes */103 __u16 max_enc_size; /* Maximum size of encrypted blob in bytes */104 __u16 max_dec_size; /* Maximum size of decrypted blob in bytes */105 __u32 __spare[10];106};107 108struct keyctl_pkey_params {109 __s32 key_id; /* Serial no. of public key to use */110 __u32 in_len; /* Input data size */111 union {112 __u32 out_len; /* Output buffer size (encrypt/decrypt/sign) */113 __u32 in2_len; /* 2nd input data size (verify) */114 };115 __u32 __spare[7];116};117 118#define KEYCTL_MOVE_EXCL 0x00000001 /* Do not displace from the to-keyring */119 120/*121 * Capabilities flags. The capabilities list is an array of 8-bit integers;122 * each integer can carry up to 8 flags.123 */124#define KEYCTL_CAPS0_CAPABILITIES 0x01 /* KEYCTL_CAPABILITIES supported */125#define KEYCTL_CAPS0_PERSISTENT_KEYRINGS 0x02 /* Persistent keyrings enabled */126#define KEYCTL_CAPS0_DIFFIE_HELLMAN 0x04 /* Diffie-Hellman computation enabled */127#define KEYCTL_CAPS0_PUBLIC_KEY 0x08 /* Public key ops enabled */128#define KEYCTL_CAPS0_BIG_KEY 0x10 /* big_key-type enabled */129#define KEYCTL_CAPS0_INVALIDATE 0x20 /* KEYCTL_INVALIDATE supported */130#define KEYCTL_CAPS0_RESTRICT_KEYRING 0x40 /* KEYCTL_RESTRICT_KEYRING supported */131#define KEYCTL_CAPS0_MOVE 0x80 /* KEYCTL_MOVE supported */132#define KEYCTL_CAPS1_NS_KEYRING_NAME 0x01 /* Keyring names are per-user_namespace */133#define KEYCTL_CAPS1_NS_KEY_TAG 0x02 /* Key indexing can include a namespace tag */134#define KEYCTL_CAPS1_NOTIFICATIONS 0x04 /* Keys generate watchable notifications */135 136#endif /* _LINUX_KEYCTL_H */137