keyctl_session_to_parent (3) - Linux Man Pages
keyctl_session_to_parent: Set the parent process's session keyring
keyctl_session_to_parent - Set the parent process's session keyring
#include <keyutils.h> long keyctl_session_to_parent();
DESCRIPTIONkeyctl_session_to_parent() changes the session keyring to which the calling process's parent subscribes to be the that of the calling process.
The keyring must have link permission available to the calling process, the parent process must have the same UIDs/GIDs as the calling process, and the LSM must not reject the replacement. Furthermore, this may not be used to affect init or a kernel thread.
RETURN VALUEOn success keyctl_session_to_parent() returns 0. On error, the value -1 will be returned and errno will have been set to an appropriate error.
- Insufficient memory to create a key.
- The credentials of the parent don't match those of the caller.
- The named keyring exists, but is not linkable by the calling process.