Manual Pages for UNIX Operating System command usage for man kva_match

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 

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