1KEYCTL_CHOWN(3)           Linux Key Management Calls           KEYCTL_CHOWN(3)
2
3
4

NAME

6       keyctl_chown - Change the ownership of a key
7

SYNOPSIS

9       #include <keyutils.h>
10
11       long keyctl_chown(key_serial_t key, uid_t uid, gid_t gid);
12

DESCRIPTION

14       keyctl_chown() changes the user and group ownership details of a key.
15
16       A  setting  of  -1  on  either uid or gid will cause that setting to be
17       ignored.
18
19       A process that does not have the SysAdmin capability may not  change  a
20       key's  UID  or  set  the  key's  GID to a value that does not match the
21       process's GID or one of its group list.
22
23       The caller must have setattr permission on a key to be able change  its
24       ownership.
25

RETURN VALUE

27       On  success  keyctl_chown() returns 0 .  On error, the value -1 will be
28       returned and errno will have been set to an appropriate error.
29

ERRORS

31       ENOKEY The specied key does not exist.
32
33       EKEYEXPIRED
34              The specified key has expired.
35
36       EKEYREVOKED
37              The specified key has been revoked.
38
39       EDQUOT Changing the UID to the one specified would run that UID out  of
40              quota.
41
42       EACCES The  key  exists,  but  does not grant setattr permission to the
43              calling process.
44

LINKING

46       This is a library function that can  be  found  in  libkeyutils.   When
47       linking, -lkeyutils should be specified to the linker.
48

SEE ALSO

50       keyctl(1),
51       add_key(2),
52       keyctl(2),
53       request_key(2),
54       keyctl_get_keyring_ID(3),
55       keyctl_join_session_keyring(3),
56       keyctl_update(3),
57       keyctl_revoke(3),
58       keyctl_setperm(3),
59       keyctl_describe(3),
60       keyctl_clear(3),
61       keyctl_link(3),
62       keyctl_unlink(3),
63       keyctl_search(3),
64       keyctl_read(3),
65       keyctl_instantiate(3),
66       keyctl_negate(3),
67       keyctl_set_reqkey_keyring(3),
68       keyctl_set_timeout(3),
69       keyctl_assume_authority(3),
70       keyctl_describe_alloc(3),
71       keyctl_read_alloc(3),
72       request-key(8)
73
74
75
76Linux                             4 May 2006                   KEYCTL_CHOWN(3)
Impressum