kkeyset_add_key Kernel Service

Purpose

Adds a kernel key to a kernel keyset.

Syntax

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

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

Parameters

Item	Description
set	Specifies the kernel keyset to which the kkeyset_add_key kernel service will add a key.
key	Specifies the kernel key to add.
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 added. KA_WRITE Specifies that the write access for the key is to be added. KA_RW Specifies that both the read access and the write access are to be added. This is equivalent to the value of KA_READ \| KA_WRITE.

Description

The kkeyset_add_key kernel service adds a single kernel key specified by the key parameter to 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_add_key kernel service can be called from the process environment only.

Return Values

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