KEYCTL\_CHOWN(3) Linux Key Management Calls KEYCTL\_CHOWN(3) # [NAME](#NAME) keyctl\_chown - change the ownership of a key # [SYNOPSIS](#SYNOPSIS) ``` #include long keyctl_chown(key_serial_t key, uid_t uid, gid_t gid); ``` # [DESCRIPTION](#DESCRIPTION) **keyctl\_chown**() changes the user and group ownership details of a key. A setting of **-1** on either *uid* or *gid* will cause that setting to be ignored. A process that does not have the **SysAdmin** capability may not change a key's UID or set the key's GID to a value that does not match the process's GID or one of its group list. The caller must have **setattr** permission on a key to be able to change its ownership. # [RETURN VALUE](#RETURN_VALUE) On success **keyctl\_chown**() returns **0 .** On error, the value **-1** will be returned and *errno* will have been set to an appropriate error. # [ERRORS](#ERRORS) [**ENOKEY**](#ENOKEY) The specified key does not exist. [**EKEYEXPIRED**](#EKEYEXPIRED) The specified key has expired. [**EKEYREVOKED**](#EKEYREVOKED) The specified key has been revoked. [**EDQUOT**](#EDQUOT) Changing the UID to the one specified would run that UID out of quota. [**EACCES**](#EACCES) The key exists, but does not grant **setattr** permission to the calling process. # [LINKING](#LINKING) This is a library function that can be found in *libkeyutils*. When linking, **-lkeyutils** should be specified to the linker. # [SEE ALSO](#SEE_ALSO) [**keyctl**(1)](/man/os/keyutils/keyctl.1), [**add\_key**(2)](/man/os/keyutils/add_key.2), [**keyctl**(2)](/man/os/keyutils/keyctl.2), [**request\_key**(2)](/man/os/keyutils/request_key.2), [**keyctl**(3)](/man/os/keyutils/keyctl.3), [**keyrings**(7)](/man/os/keyutils/keyrings.7), [**keyutils**(7)](/man/os/keyutils/keyutils.7) 4 May 2006 Linux --- Document: keyctl_chown(3) from keyutils 1.6.3-r41 (Chainguard OS) Source: https://kernel.googlesource.com/pub/scm/linux/kernel/git/dhowells/keyutils.git