| SCBD_GET_VALUES(3) | SCBD_GET_VALUES(3) |
#include <scboard.h>
int scbd_get_values( char *name, char *attr, char *list[], int *size );
scbd_get_values() attempts to get a value list of a records
which have name name and attribute attr.
The value list 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 values
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_values() 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)