keyctl_keyring_clear

Name:Clear the specified keyring, creating an empty process keyring if one of the* special keyring IDs is used.* The keyring must grant the caller Write permission and not have* KEY_FLAG_KEEP set for this to work. If successful, 0 will be returned.

Proto:long keyctl_keyring_clear(key_serial_t ringid)

Type:long

Parameter:

Type	Parameter	Name
key_serial_t	ringid

474

keyring_ref = Look up a key ID given us by userspace with a given permissions mask to get* the key it refers to.* Flags can be passed to request that special keyrings be created if referred* to directly, to permit partially constructed keys to be found and to skip

475

If IS_ERR(keyring_ref) Then

476

ret = PTR_ERR(keyring_ref)

479

If Check operation authority Then

480

keyring_ref = Look up a key ID given us by userspace with a given permissions mask to get* the key it refers to.* Flags can be passed to request that special keyrings be created if referred* to directly, to permit partially constructed keys to be found and to skip

481

If IS_ERR(keyring_ref) Then Go to error

483

If st_bit - Determine whether a bit is set*@nr: bit number to test*@addr: Address to start counting from Then Go to clear

486

Go to error_put

489

Go to error

492

clear :

493

keyring = key_ref_to_ptr(keyring_ref)

494

If st_bit - Determine whether a bit is set*@nr: bit number to test*@addr: Address to start counting from Then ret = -EPERM

496

Else ret = keyring_clear - Clear a keyring*@keyring: The keyring to clear.* Clear the contents of the specified keyring.* Returns 0 if successful or -ENOTDIR if the keyring isn't a keyring.

498

499

key_ref_put(keyring_ref)

500

error :

501

Return ret

**Caller**
Name	Describe
SYSCALL_DEFINE5	The key control system call
COMPAT_SYSCALL_DEFINE5	The key control system call, 32-bit compatibility version for 64-bit archs

Source code conversion tool public plug-in interface	X
Support c/c++/esqlc/java Oracle/Informix/Mysql Plug-in can realize: logical Report Code generation and batch code conversion