asallocash(3x)asallocash(3x)NAMEasallocash - allocate a global array session handle
SYNOPSIS
#include <sys/types.h>
#include <arraysvcs.h>
ash_t asallocash(asserver_t server, const char *array);
DESCRIPTION
The asallocash function allocates a global array session handle in the
specified array. The resulting array session handle is guaranteed to be
unique across all of the machines in that array.
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).
The array parameter specifies the name of the array as an ordinary
character string. If NULL is specified instead, the array session handle
will be allocated in the default array of the array services daemon.
NOTESasallocash is found in the library "libarray.so", and will be loaded if
the option "-larray" is used with cc(1) or ld(1).
SEE ALSOsetash(2), asashisglobal(3X), aserrorcode(3X), asopenserver(3X),
array_sessions(5).
DIAGNOSTICSasallocash returns the newly allocated global array session handle if
successful. If unsuccessful, -1LL is returned and aserrorcode is set
appropriately.
Page 1