freebsd man page for kva_match

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.

SunOS 5.10							    12 Aug 1999 						 kva_match(3SECDB)