kkeyset_remove_key Kernel Service

Purpose

Removes a kernel key from a kernel keyset.

Syntax

#include <sys/kerrno.h>
#include <sys/skeys.h>

kerrno_t kkeyset_remove_key (set, key, flags) kkeyset_t set; kkey_t key; unsigned long flags;

Parameters

Item	Description
set	Specifies the kernel keyset from which the kkeyset_remove_key kernel service will remove a key.
key	Specifies the kernel key to remove.
flags	You can specify the flags parameter to one of the following values: KA_READ Specifies that the read access for the key is to be removed. KA_WRITE Specifies that the write access for the key is to be removed. KA_RW Specifies that both the read access and the write access are to be removed. This is equivalent to the value of KA_READ \| KA_WRITE.

Description

The kkeyset_remove_key kernel service removes a single kernel key specified by the key parameter from the kernel keyset specified by the set parameter. You must specify the flags parameter to control the read or write authority.

Execution Environment

The kkeyset_remove_key kernel service can be called from the process environment only.

Return Values

Item	Description
0	Indicates a successful completion.
EINVAL_KKEYSET_REMOVE_KEY	Indicates that the parameter or execution environment is not valid.