kva_match - look up a key in a key-value array
cc [ flag... ] file... -lsecdb [ library... ]
#include <secdb.h>
char *kva_match(kva_t *kva, char *key);
The kva_match() function searches a kva_t structure, which is part
of the authattr_t, execattr_t, profattr_t, or
userattr_t structures. The function takes two arguments: a pointer to a
key value array, and a key. If the key is in the array, the function returns a
pointer to the first corresponding value that matches that key. Otherwise, the
function returns NULL.
Upon successful completion, the function returns a pointer to the value sought.
Otherwise, it returns NULL.
See attributes(7) for descriptions of the following attributes:
ATTRIBUTE
TYPE |
ATTRIBUTE VALUE |
MT-Level |
MT-Safe |
The kva_match() function returns a pointer to data that already exists in
the key-value array. It does not allocate its own memory for this pointer but
obtains it from the key-value array that is passed as its first argument.