IBM AIX Continuous Availability Features - IBM Redbooks

# ls core
core not found
Because the child process was able to read and write the content of shared object, there is no
core file at this time.
User key API
The following data structures and APIs are declared for the user key feature. They are
declared in . For a more detailed explanation of the APIs refer to the IBM white
paper “Storage Protection Keys on AIX Version 5.3”, which can be downloaded from:
ftp://ftp.software.ibm.com/common/ssi/rep_wh/n/PSW03013USEN/PSW03013USEN.PDF
In AIX V6.1 documentation, the white paper is available at:
http://publib.boulder.ibm.com/infocenter/pseries/v6r1/index.jsp
ukey_t
This is a basic type for a user-mode storage protection key.
ukeyset_t
This is a user key set with read/write attributes for each key in the set.
sysconf(_SC_AIX_UKEYS)
This returns the number of user keys available.
int ukey_enable()
This grants a process access to user keys memory protection
facilities. It returns the number of user keys configured on the system.
int ukey_getkey(void *addr, ukey_t *ukey)
This is used to determine the user key associated with a memory
address.
int ukey_protect (void *addr, size_t len, ukey_t ukey)
This modifies the memory's user key protection for a given address
range. This range must include only whole pages.
int ukeyset_init (ukeyset_t *nset, unsigned int flags)
This initializes a user key set with just UKEY_PUBLIC (unless
UK_INIT_ADD_PRIVATE flag is specified). The value of “flags” may
be UK_READ, UK_WRITE, or UK_RW.
int ukeyset_add_key (ukeyset_t *set, ukey_t key, unsigned int flags)
This adds a user key to a user key set.
int ukeyset_remove_key (ukeyset_t *set, ukey_t key, unsigned int flags)
This removes a user key from a user key set. The value of “flags” may
be UK_READ, UK_WRITE, or UK_RW.
int ukeyset_ismember (ukeyset_t set, ukey_t key, unsigned int flags)
This determines if a key is part of a keyset. The value of “flags” may be
UK_READ, UK_WRITE, or UK_RW.
int ukeyset_add_set (ukeyset_t *set, ukeyset_t aset)
This adds a user key set.
int ukeyset_remove_set (ukeyset_t *set, ukeyset_t rset)
This removes a user key set.
int pthread_attr_getukeyset_np (pthread_attr_t *attr, ukeyset_t *ukeyset)
This returns a thread attributes object's user key set attribute.
Chapter 3. AIX advanced continuous availability tools and features 107