IBM AIX Continuous Availability Features - IBM Redbooks
IBM AIX Continuous Availability Features - IBM Redbooks
IBM AIX Continuous Availability Features - IBM Redbooks
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
that allows access to the kernel keyset it was derived from. It is<br />
implemented as a raw AMR value.<br />
The following APIs are available for managing kernel and hardware keysets:<br />
kerrno_t kkeyset_create(kkeyset_t *set)<br />
This creates a kernel keyset.<br />
kerrno_t kkeyset_delete(kkeyset_t set)<br />
This deletes a kernel keyset.<br />
kerrno_t kkeyset_add_key(kkeyset_t set, kkey_t key, unsigned long flags)<br />
This adds a kernel key to a kernel keyset.<br />
kerrno_t kkeyset_add_set(kkeyset_t set, kkeyset_t addset)<br />
This adds a kernel keyset to an existing kernel keyset.<br />
kerrno_t kkeyset_remove_key(kkeyset_t set, kkey_t key, unsigned long flags)<br />
This removes a kernel key- from an existing kernel keyset.<br />
kerrno_t kkeyset_remove_keyset(kkeyset_t set, kkeyset_t removeset)<br />
This removes members of one kernel keyset from an existing kernel<br />
keyset.<br />
kerrno_t kkeyset_to_hkeyset(kkeyset_t kkeyset, hkeyset_t *hkey)<br />
This computes the hardware key (AMR value) that provides memory<br />
access specified by the inputted kernel keyset.<br />
hkeyset_t hkeyset_add(hkeyset_t keyset)<br />
This updates the protection domain by adding the hardware-keyset<br />
specified by keyset to the currently addressable hardware-keyset. The<br />
previous hardware-keyset is returned.<br />
hkeyset_t hkeyset_replace(hkeyset_t keyset)<br />
This updates the protection domain by loading the set specified by<br />
keyset as the currently addressable storage set. The previous<br />
hardware-keyset is returned.<br />
void hkeyset_restore(hkeyset_t keyset)<br />
This updates the protection domain by loading the set specified by<br />
keyset as the currently addressable storage set. No return value is<br />
provided by this function. Because this service is slightly more efficient<br />
than hkeyset_replace(), it can be used to load a hardware-keyset<br />
when the previous keyset does not need to be restored.<br />
hkeyset_t hkeyset_get()<br />
This reads the current hardware-key-set without altering it.<br />
Hardware keysets can also be statically assigned several predefined values. This is often<br />
useful to deal with use of a hardware keyset before a component can initialize it.<br />
HKEYSET_INVALID<br />
HKEYSET_GLOBAL<br />
This keyset is invalid. When used, it will cause a storage-key<br />
exception on the next data reference.<br />
This keyset allows access to all kernel keys. It is implemented as an<br />
all zeroes AMR value.<br />
Chapter 3. <strong>AIX</strong> advanced continuous availability tools and features 99