|KEYCTL_GET_KEYRING_ID(3)||Linux Key Management Calls||KEYCTL_GET_KEYRING_ID(3)|
#include <keyutils.h> key_serial_t keyctl_get_keyring_ID(key_serial_t key, int create);
If the key or keyring does not yet exist, then if create is non-zero, the key or keyring will be created if it is appropriate to do so.
The following special key IDs may be specified as key:
- This specifies the caller's thread-specific keyring.
- This specifies the caller's process-specific keyring.
- This specifies the caller's session-specific keyring.
- This specifies the caller's UID-specific keyring.
- This specifies the caller's UID-session keyring.
- This specifies the authorisation key created by request_key() and passed to the process it spawns to generate a key.
If a valid keyring ID is passed in, then this will simply be returned if the key exists; an error will be issued if it doesn't exist.
- No matching key was found.
- Insufficient memory to create a key.
- The key quota for this user would be exceeded by creating this key or linking it to the keyring.
|4 May 2006||Linux|