|
KVA_MATCH(3SECDB) |
Security Attributes Database Library Functions |
KVA_MATCH(3SECDB) |
NAME
kva_match - look up a key in a key-value array
SYNOPSIS
cc [
flag... ]
file... -lsecdb [
library... ]
#include <secdb.h>
char *kva_match(
kva_t *kva,
char *key);
DESCRIPTION
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.
RETURN VALUES
Upon successful completion, the function returns a pointer to the value sought. Otherwise, it returns NULL.
ATTRIBUTES
See
attributes(5) for descriptions of the following attributes:
|
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
|
|
|
MT-Level |
MT-Safe |
SEE ALSO
getauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB), getuserattr(3SECDB)
NOTES
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.