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. asdflt
serveropt 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>):
AASS_SSOO_TTIIMMEEOOUUTT
Sets or retrieves the timeout value (in seconds)
for a response to a request made to the array ser
vices daemon associated with the server token.
The timeout value is of type "int".
AASS_SSOO_CCTTIIMMEEOOUUTT
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".
AASS_SSOO_FFOORRWWAARRDD
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
AARRRRAAYYDD_FFOORRWWAARRDD had a value beginning with the let
ter "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".
AASS_SSOO_LLOOCCAALLKKEEYY
Sets or retrieves the authentication key that is
daemon associated with the server token. The
default value of this key is obtained from the
environment variable AARRRRAAYYDD_LLOOCCAALLKKEEYY if it exists,
or otherwise is set to 0. The key is of type
askey_t.
AASS_SSOO_RREEMMOOTTEEKKEEYY
Sets or retrieves the authentication key that is
used for any messages received from the array ser
vices daemon associated with the server token.
The default value of this key is obtained from the
environment variable AARRRRAAYYDD_RREEMMOOTTEEKKEEYY if it
exists, or otherwise is set to 0. The key is of
type askey_t.
AASS_SSOO_PPOORRTTNNUUMM
(Only valid with asdfltserveropt). Retrieves the
port number of the default array services daemon.
This value is obtained from the environment vari
able AARRRRAAYYDD_PPOORRTT if it exists, otherwise the port
number associated with the service "sgi-arrayd" is
used.
AASS_SSOO_HHOOSSTTNNAAMMEE
(Only valid with asdfltserveropt). Retrieves the
hostname of the default array services daemon.
This value is obtained from the environment vari
able AARRRRAAYYDD 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 ALSO
ascloseserver(3X), aserrorcode(3X), asopenserver(3X),
array_services(5).
DIAGNOSTICS
Both functions return 0 if successful, -1 if not. If
Man(1) output converted with
man2html