Content-type: text/html Man page of kva_match

kva_match

Section: Security Attributes Database Library Functions (3SECDB)
Updated: 12 Aug 1999
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
MT-LevelMT-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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:39:52 GMT, October 02, 2010