kkeyset_create Kernel Service

Purpose

Creates and initializes a kernel keyset.

Syntax

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

kerrno_t kkeyset_create (set) kkeyset_t *set;

Parameters

Item	Description
set	Contains the returned newly-created keyset.

Description

The kkeyset_create kernel service creates a new (empty) kernel keyset. You can add or remove the access to an individual or groups of kernel keys using the kkeyset_add_key, kkeyset_remove_key, kkeyset_add_set, and kkeyset_remove_set kernel services.

Important: The kkeyset_create kernel service allocates hidden kernel resources. You must release these resources using the kkeyset_delete kernel service when the kernel keyset is no longer in use. When creating a new set, the caller of the kkeyset_create kernel service must initialize the storage that will contain the returned kernel keyset (*set) to the value of KKEYSET_INVALID.

Execution Environment

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

Return Values

Item	Description
0	Indicates a successful completion.
ENOMEM_KKEYSET_CREATE	Indicates that the available memory is not sufficient to satisfy the request.
EINVAL_KKEYSET_CREATE	Indicates that the parameter or execution environment is not valid.