KVA_MATCH(3SECDB) Security Attributes Database Library Functions
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 |
+---------------+-----------------+
getauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB),
getuserattr(3SECDB)
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)
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(7) 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)