| .\" |
| .\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved. |
| .\" Written by David Howells (dhowells@redhat.com) |
| .\" |
| .\" This program is free software; you can redistribute it and/or |
| .\" modify it under the terms of the GNU General Public License |
| .\" as published by the Free Software Foundation; either version |
| .\" 2 of the License, or (at your option) any later version. |
| .\" |
| .TH KEYCTL_CHOWN 3 "4 May 2006" Linux "Linux Key Management Calls" |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH NAME |
| keyctl_chown \- change the ownership of a key |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH SYNOPSIS |
| .nf |
| .B #include <keyutils.h> |
| .sp |
| .BI "long keyctl_chown(key_serial_t " key ", uid_t " uid ", gid_t " gid ");" |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH DESCRIPTION |
| .BR keyctl_chown () |
| changes the user and group ownership details of a key. |
| .P |
| A setting of |
| .B -1 |
| on either |
| .I uid |
| or |
| .I gid |
| will cause that setting to be ignored. |
| .P |
| A process that does not have the |
| .B 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. |
| .P |
| The caller must have |
| .B setattr |
| permission on a key to be able to change its ownership. |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH RETURN VALUE |
| On success |
| .BR keyctl_chown () |
| returns |
| .B 0 . |
| On error, the value |
| .B -1 |
| will be returned and |
| .I errno |
| will have been set to an appropriate error. |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH ERRORS |
| .TP |
| .B ENOKEY |
| The specified key does not exist. |
| .TP |
| .B EKEYEXPIRED |
| The specified key has expired. |
| .TP |
| .B EKEYREVOKED |
| The specified key has been revoked. |
| .TP |
| .B EDQUOT |
| Changing the UID to the one specified would run that UID out of quota. |
| .TP |
| .B EACCES |
| The key exists, but does not grant |
| .B setattr |
| permission to the calling process. |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH LINKING |
| This is a library function that can be found in |
| .IR libkeyutils . |
| When linking, |
| .B \-lkeyutils |
| should be specified to the linker. |
| .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" |
| .SH SEE ALSO |
| .ad l |
| .nh |
| .BR keyctl (1), |
| .BR add_key (2), |
| .BR keyctl (2), |
| .BR request_key (2), |
| .BR keyctl (3), |
| .BR keyrings (7), |
| .BR keyutils (7) |
