aslistmachines(3x)aslistmachines(3x)NAMEaslistmachines - enumerate machines in an array
SYNOPSIS
#include <arraysvcs.h>
asmachinelist_t *aslistmachines(asserver_t Server, const char *Name);
DESCRIPTION
The aslistmachines function returns a list of the machines that are
members of the array specified by Name. If Name is NULL, the machines
that are members of the default array is returned.
The Server parameter specifies an optional array server token, which can
be used to direct the request to a specific array services daemon. If
NULL is specified instead, the request will be processed by the default
array services daemon (see array(1) for more information on how the
default array services daemon is selected). For more details on creating
an array server token, see asopenserver(3X).
Each machine is described by an asmachine_t structure, and the entire
list is contained in an asmachinelist_t structure. Both of these are
defined in <arraysvcs.h>. The storage for these structures is allocated
using malloc(3) and can be released using asfreemachinelist(3X).
NOTESaslistmachines is found in the library "libarray.so", and will be loaded
if the option "-larray" is used with cc(1) or ld(1).
SEE ALSOaserrorcode(3X), asfreemachinelist(3X), aslistarrays(3X),
asopenserver(3X).
DIAGNOSTICSaslistmachines returns a pointer to an asmachinelist_t structure if
successful. If unsuccessful, NULL is returned and aserrorcode(3X) is set
appropriately.
Page 1