| 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)