Introduction to 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 success, the function returns a pointer  to  the  value
     sought. Otherwise, it returns NULL.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       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.8           Last change: 12 Aug 1999                    1