GNU/Linux | 
					CentOS 5.2 | 
					|
![]()  | 
					keyctl_clear(3) | 
					![]()  | 
				
keyctl_clear − Clear a keyring
#include <keyutils.h>
long keyctl_clear(key_serial_t keyring);
keyctl_clear() clears the contents of a keyring.
The caller must have write permission on a keyring to be able clear it.
On success keyctl_clear() returns 0. On error, the value -1 will be returned and errno will have been set to an appropriate error.
| 
 ENOKEY  | 
 The keyring specified is invalid.  | 
EKEYEXPIRED
The keyring specified has expired.
EKEYREVOKED
The keyring specified had been revoked.
| 
 EACCES  | 
 The keyring exists, but is not writable by the calling process.  | 
This is a library function that can be found in libkeyutils. When linking, -lkeyutils should be specified to the linker.
keyctl(1),
add_key(2), 
keyctl(2), 
request_key(2), 
keyctl_get_keyring_ID(3), 
keyctl_join_session_keyring(3), 
keyctl_update(3), 
keyctl_revoke(3), 
keyctl_chown(3), 
keyctl_setperm(3), 
keyctl_describe(3), 
keyctl_link(3), 
keyctl_unlink(3), 
keyctl_search(3), 
keyctl_read(3), 
keyctl_instantiate(3), 
keyctl_negate(3), 
keyctl_set_reqkey_keyring(3), 
keyctl_set_timeout(3), 
keyctl_assume_authority(3), 
keyctl_describe_alloc(3), 
keyctl_read_alloc(3), 
 request-key(8)
![]()  | 
				keyctl_clear(3) | ![]()  |