asopenserver(3x)asopenserver(3x)NAME
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.
NOTESasopenserver 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 ALSOaserrorcode(3X), assetserveropt(3X), array_sessions(5).
DIAGNOSTICSasopenserver returns a non-zero array server token if successful, or NULL
if not. If unsuccessful, aserrorcode(3X) will be set appropriately.
Page 1