KEYCTL_SET_TIMEOUT


Sets or clears the expiration timer on a key.

Arguments

ecx Key serial number.
edx Timeout (in seconds) to set. If this values is null the the timeout is cleared. When the key expires, further attempts to access it will be met with error EKEYEXPIRED.

Return values

If the system call succeeds the return value is 0.
If the system call fails the return value is one of the following errno values:

-ENOKEY No matching key was found.
-EKEYEXPIRED The keyring specified has expired.
-EKEYREVOKED The keyring specified had been revoked.
-EACCES The named key exists, but does not grant setattr permission to the calling process.

Remarks

The process must have attribute modification access on a key to set its timeout. Timeouts may not be set with this function on negative, revoked or expired keys.