asallocash - 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 ses
sion 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 spe
cific 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.
NOTES
asallocash is found in the library "libarray.so", and will
be loaded if the option "-larray" is used with cc(1) or
ld(1).
SEE ALSO
setash(2), asashisglobal(3X), aserrorcode(3X),
asopenserver(3X), array_sessions(5).
DIAGNOSTICS
asallocash returns the newly allocated global array ses
sion handle if successful. If unsuccessful, -1LL is
returned and aserrorcode is set appropriately.
Man(1) output converted with
man2html