SCBD_GET_NAMES(3) | SCBD_GET_NAMES(3) |
#include <scboard.h>
int scbd_get_names( char *attr, char *value, char *list[], int *size );
scbd_get_names()
attempts to get a list of record names
which have an attribute specified in the attr
argument and one
of its associated values is the same as that specified in the
value
argument. The list of record names will be stored
in the list
argument. Thus, list
must be an array of
character pointers whose size is specified in the size
argument. Upon successful return from this function call,
size
is set to the number of records found.
All the storage area of the strings set in list
are
allocated using the malloc
function. So it is the user's
responsibility to free those memory regions.
scbd_get_names()
returns 0 on success or one of the
the following errors:
attr
or value
is a null pointer
attr
or value
is a null string
scoreboard
(8)
database process
scoreboard
(8),
scorehosts.db
(5)