KVA_MATCH(3SECDB) Security Attributes Database Library Functions


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.


August 13, 2018 KVA_MATCH(3SECDB)