2 .\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
3 .\" Written by David Howells (dhowells@redhat.com)
5 .\" This program is free software; you can redistribute it and/or
6 .\" modify it under the terms of the GNU General Public License
7 .\" as published by the Free Software Foundation; either version
8 .\" 2 of the License, or (at your option) any later version.
10 .TH KEYCTL_LINK 3 "4 May 2006" Linux "Linux Key Management Calls"
11 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
13 keyctl_link \- Link a key to a keyring
14 keyctl_unlink \- Unlink a key from a keyring
15 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
18 .B #include <keyutils.h>
20 .BI "long keyctl_link(key_serial_t " key ", key_serial_t " keyring ");"
22 .BI "long keyctl_unlink(key_serial_t " key ", key_serial_t " keyring ");"
23 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
30 displacing any link to another key of the same type and description in that
31 keyring if one exists.
42 permission on a keyring to be able create or remove links in it.
46 permission on a key to be able to create a link to it.
47 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
57 will be returned and errno will have been set to an appropriate error.
58 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
62 The key or the keyring specified are invalid.
65 The key or the keyring specified have expired.
68 The key or the keyring specified have been revoked.
71 The keyring exists, but is not
73 by the calling process.
80 Insufficient memory to expand the keyring
83 Expanding the keyring would exceed the keyring owner's quota.
86 The key exists, but is not
88 by the calling process.
89 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
91 This is a library function that can be found in
95 should be specified to the linker.
96 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""