assetserveropt(3x)assetserveropt(3x)NAME
assetserveropt, asgetserveropt, asdfltserveropt - set/retrieve server
options
SYNOPSIS
#include <arraysvcs.h>
int assetserveropt(asserver_t Server, int OptName,
const void *OptVal, int OptLen);
int asgetserveropt(asserver_t Server, int OptName,
void *OptVal, int OptLen);
int asdfltserveropt(int OptName, void *OptVal, int OptLen);
DESCRIPTION
asgetserveropt and assetserveropt are used to manipulate options
associated with the server token Server. asdfltserveropt is used to
retrieve the standard default value for those options when a new server
token is created using asopenserver(3X). The particular option to be
manipulated is specified by OptName, which may be one of the following
values (defined in <arraysvcs.h>):
AS_SO_TIMEOUT
Sets or retrieves the timeout value (in seconds) for a response to
a request made to the array services daemon associated with the
server token. The timeout value is of type "int".
AS_SO_CTIMEOUT
Sets or retrieves the timeout value (in seconds) for establishing
an initial connection with the array services daemon associated
with the server token. The timeout value is of type "int".
AS_SO_FORWARD
Sets or retrieves the state of the forwarding flag associated with
the server token. If the flag is non-zero, then any requests made
with the token will be forwarded to the server associated with the
token via the array services daemon at the default port on the
local machine. If the flag is zero, requests are sent directly to
the server associated with the token. The default setting of this
flag is 0 unless the environment variable ARRAYD_FORWARD had a
value beginning with the letter "Y" (as in "yes", in either upper
or lower case) at the time the token was created. The value of
the flag is of type "int".
AS_SO_LOCALKEY
Sets or retrieves the authentication key that is used for any
messages sent to the array services daemon associated with the
server token. The default value of this key is obtained from the
environment variable ARRAYD_LOCALKEY if it exists, or otherwise is
set to 0. The key is of type askey_t.
Page 1
assetserveropt(3x)assetserveropt(3x)
AS_SO_REMOTEKEY
Sets or retrieves the authentication key that is used for any
messages received from the array services daemon associated with
the server token. The default value of this key is obtained from
the environment variable ARRAYD_REMOTEKEY if it exists, or
otherwise is set to 0. The key is of type askey_t.
AS_SO_PORTNUM
(Only valid with asdfltserveropt). Retrieves the port number of
the default array services daemon. This value is obtained from
the environment variable ARRAYD_PORT if it exists, otherwise the
port number associated with the service "sgi-arrayd" is used.
AS_SO_HOSTNAME
(Only valid with asdfltserveropt). Retrieves the hostname of the
default array services daemon. This value is obtained from the
environment variable ARRAYD if it exists, otherwise "localhost" is
used.
The parameters OptVal and OptLen are used to access option values for
assetserveropt. For asgetserveropt and asdfltserveropt, they identify a
buffer in which the value for the requested option is to be returned.
For those functions, OptLen is a value-result parameter, initially
containing the size in bytes of the buffer pointed to by OptVal, and
modified on return to indicate the actual size of the value returned.
If any of these functions is unsuccessful, -1 is returned and
aserrorcode(3X) will be set appropriately.
NOTES
These functions are found in the library "libarray.so", and will be
loaded if the option "-larray" is used with cc(1) or ld(1).
SEE ALSOascloseserver(3X), aserrorcode(3X), asopenserver(3X), array_services(5).
DIAGNOSTICS
Both functions return 0 if successful, -1 if not. If unsuccessful,
aserrorcode(3X) will be set appropriately.
Page 2