setash(2)setash(2)NAMEsetash - 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).
ERRORSsetash 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 ALSOsystune(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
