xmsethkeyset Kernel Service

Purpose

Alters hardware keyset associated with a cross-memory descriptor.

Syntax

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

kerrno_t xmsethkeyset (dp, hkeyset, flags) struct xmem * dp; hkeyset_t hkeyset; long flags;

Parameters

Item	Description
dp	Specifies a valid cross-memory descriptor.
hkeyset	Hardware keyset to assign to the cross-memory descriptor.
flags	Must be set to zero.

Description

The xmsethkeyset() kernel service can be used to modify the keyset associated with a cross-memory descriptor.

Kernel-key protection can be enforced on memory regions described by a cross-memory descriptor. The enforcement is done during normal access checking performed by cross-memory services, such as the xmemdma() service.

Execution Environment

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

Return Values

Item	Description
0	Successful.
EINVAL_XMSETHKEYSET	Invalid parameter or execution environment.