SCBD_GET_ATTRIBUTES(3)
SCOREBOARD LIBRARY (C)
SCBD_GET_ATTRIBUTES(3)
NAME
scbd_get_attributes - get list of attribute names of a specified record from scoreboard database

SYNOPSIS
#include <scboard.h>

int scbd_get_attributes( char *name, char *list[], int *size );

DESCRIPTION
scbd_get_attributes() attempts to get a list of attribute names of a record specified by the name argument. The list of attribute names will be stored in the list argument. Thus, list must be an array of character pointers whose size is specified by the size argument. Upon successful return from this function call, size is set to the number of attributes 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.

RETURN VALUES
scbd_get_attributes() returns 0 on success or one of the following errors:

ERRORS
EFAULT
attr or value is a null pointer
EINVAL
attr or value is a null string

ENVIRONMENT
SCBDSERV
Hostname (and port number) of the scoreboard(8) database process

SEE ALSO
scoreboard(8), scorehosts.db(5)

$Id: scbd_get_attributes.html,v 1.2 2002/02/27 12:39:35 liu Exp $