1kva_match(3SECDB)Security Attributes Database Library Functionskva_match(3SECDB)
2
3
4

NAME

6       kva_match - look up a key in a key-value array
7

SYNOPSIS

9       cc [ flag... ] file...- lsecdb [ library... ]
10       #include <secdb.h>
11
12       char *kva_match(kva_t *kva, char *key);
13
14

DESCRIPTION

16       The  kva_match()  function searches a kva_t structure, which is part of
17       the  authattr_t, execattr_t, profattr_t, or userattr_t structures.  The
18       function  takes  two  arguments:  a pointer to a key value array, and a
19       key.  If the key is in the array, the function returns a pointer to the
20       first  corresponding value that matches that key.  Otherwise, the func‐
21       tion returns NULL.
22

RETURN VALUES

24       Upon successful completion, the function returns a pointer to the value
25       sought. Otherwise, it returns NULL.
26

ATTRIBUTES

28       See attributes(5) for descriptions of the following attributes:
29
30
31
32
33       ┌─────────────────────────────┬─────────────────────────────┐
34       │ATTRIBUTE TYPE               │ATTRIBUTE VALUE              │
35       ├─────────────────────────────┼─────────────────────────────┤
36       │MT-Level                     │MT-Safe                      │
37       └─────────────────────────────┴─────────────────────────────┘
38

SEE ALSO

40       getauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB), getuser‐
41       attr(3SECDB)
42

NOTES

44       The kva_match() function returns a pointer to data that already  exists
45       in  the  key-value  array. It does not allocate its own memory for this
46       pointer but obtains it from the key-value array that is passed  as  its
47       first argument.
48
49
50
51SunOS 5.11                        12 Aug 1999                kva_match(3SECDB)