kva_match(3SECDBSecurity Attributes Database Library Functionkva_match(3SECDB)NAMEkva_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 func‐
tion 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 ALSOgetauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB), getuser‐
attr(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.
SunOS 5.10 12 Aug 1999 kva_match(3SECDB)