setash(2)							     setash(2)

NAME    [Toc]    [Back]

     setash - set array	session	handle

SYNOPSIS    [Toc]    [Back]

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

     #int setash(ash_t ash);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111