setash(2)                                                            setash(2)


NAME
     setash - set array session handle

SYNOPSIS
     #include <sys/types.h>
     #include <unistd.h>

     int setash(ash_t ash);

DESCRIPTION
     The setash function changes the handle for the array session containing
     the current process to the value specified by ash.  The current process
     must have superuser privileges to invoke setash.

     Ordinarily, a handle that is unique within the current system is assigned
     to an array session when the array session is created using the
     newarraysess(2) function.  The setash function can be used to override
     this default handle, perhaps for assigning a handle that is unique across
     an entire array or for synchronizing handles with an array session on
     another system.

     The handle specified by ash must be a positive value, must not be in use
     on the current system, and must not be in the range of values that IRIX
     uses for default array session handles.  This range of default handles is
     defined by the system variables min_local_paggid and max_local_paggid and
     can be examined and/or modified using systune(1).

ERRORS
     setash may fail if one or more of these conditions are true:

     EINVAL    ash is negative, in use by another array session on this
               system, or in the range of values reserved by the system for
               default array session handles.

     EPERM     The current process does not have superuser privileges.

SEE ALSO
     systune(1), getash(2), newarraysess(2), array_sessions(5).

DIAGNOSTICS
     Upon successful completion, setash returns a value of 0.  Otherwise, a
     value of -1 is returned and errno is set to indicate the error.


                                                                        Page 1