sys_keyctl  [security/keys/keyctl.c]


De-multiplexer for kernel's key management facility manipulation functions.

Arguments

eax 288
ebx Operation to perform. It may be one of the following:

KEYCTL_GET_KEYRING_ID Map a special key ID to a real key ID for current process.
KEYCTL_JOIN_SESSION_KEYRING Replace the session keyring this process subscribes to with a new one.
KEYCTL_UPDATE Update the specified key.
KEYCTL_REVOKE Revoke a key.
KEYCTL_CHOWN Change the ownership of a key.
KEYCTL_SETPERM Change the permissions mask on a key.
KEYCTL_DESCRIBE Get summary of the key's attributes.
KEYCTL_CLEAR Clear out a keyring.
KEYCTL_LINK Link a key into a keyring.
KEYCTL_UNLINK Unlink a key or keyring from another keyring.
KEYCTL_SEARCH Search a keyring tree for a key.
KEYCTL_READ Read the payload data from a key.
KEYCTL_INSTANTIATE Instantiate a partially constructed key.
KEYCTL_NEGATE Negatively instantiate a partially constructed key.
KEYCTL_SET_REQKEY_KEYRING Set the default request-key destination keyring.
KEYCTL_SET_TIMEOUT Set the timeout on a key.
KEYCTL_ASSUME_AUTHORITY Assume or divest the authority granted to instantiate a key.
ecx First parameter to be passed to the specified function. See the documentation about desired function for more info.
edx Second parameter to be passed to the specified function. See the documentation about desired function for more info.
esi Third parameter to be passed to the specified function. See the documentation about desired function for more info.
edi Fourth parameter to be passed to the specified function. See the documentation about desired function for more info.

Return values

The return values depend on the particular function used (See above). This system call will fail with -EOPNOTSUPP if an invalid command was specified in ebx.

Remarks

n/a

Compatibility

Available since 2.6.10