Home | History | Annotate | Download | only in linux
      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 (at) 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_RESTRICT_KEYRING		29	/* Restrict keys allowed to link to a keyring */
     65 
     66 /* keyctl structures */
     67 struct keyctl_dh_params {
     68 	__s32 private;
     69 	__s32 prime;
     70 	__s32 base;
     71 };
     72 
     73 struct keyctl_kdf_params {
     74 	char __user *hashname;
     75 	char __user *otherinfo;
     76 	__u32 otherinfolen;
     77 	__u32 __spare[8];
     78 };
     79 
     80 #endif /*  _LINUX_KEYCTL_H */
     81