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