asopenserver, ascloseserver - create or destroy an array
server token
SYNOPSIS
#include <arraysvcs.h>
asserver_t asopenserver(const char *ServerName, int PortNumber);
void ascloseserver(asserver_t Server);
DESCRIPTION
The asopenserver function is used to create an "array
server token". This token can be used with other libarray
functions to direct array services requests to a specific
array services daemon. The ServerName parameter specifies
the hostname of the machine to which array services
requests made with this token should be directed. If NULL
is specified, the request will be processed by the default
array services host. The PortNumber parameter specifies
the network port number of the array services daemon on
the specified machine. If -1 is specified instead, the
default port number will be used. See array(1) for more
information on how the default array services host and
port number are determined.
The ascloseserver function should be used to destroy the
array server token specified by Server when it is no
longer needed. This will release any resources that it
may be using.
NOTES
asopenserver and ascloseserver are found in the library
"libarray.so", and will be loaded if the option "-larray"
is used with cc(1) or ld(1).
SEE ALSO
aserrorcode(3X), assetserveropt(3X), array_sessions(5).
DIAGNOSTICS
asopenserver returns a non-zero array server token if suc
cessful, or NULL if not. If unsuccessful, aserrorcode(3X)
will be set appropriately.
Man(1) output converted with
man2html