PXFSIGPROCMASK(3F)				      Last changed: 2-26-98

NAME    [Toc]    [Back]

     PXFSIGPROCMASK - Examines and changes blocked signals

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	PXFSIGPROCMASK (ihow, jsigset, josigset, ierror)
     INTEGER ihow, jsigset, josigset, ierror

IMPLEMENTATION    [Toc]    [Back]

     UNICOS, UNICOS/mk,	and IRIX systems

STANDARDS    [Toc]    [Back]

     IEEE standard interface for FORTRAN 77

DESCRIPTION:
     The PXFSIGPROCMASK	subroutine uses	sigprocmask(2) to store	the set	of
     signals blocked from delivery and pending for the calling process.

     The following is a	list of	arguments for this routine:

     ihow      A default integer input variable	containing the manner in
	       which the set is	changed.  The possible values are:

	       SIG_BLOCK      Add to current mask set

	       SIG_UNBLOCK    Delete from current mask set

	       SIG_SETMASK    Replace current mask set

	       This argument is	ignored	if josigset is NULL.  If ihow is
	       zero, the current set is	not changed.

	       On IRIX systems,	the value may also be set to SIG_NOP, which
	       does not	alter the current mask set. This value is
	       equivalent to providing a NULL handle for josigset.

     jsigset   A default integer input variable	containing a handle created
	       by PXFSTRUCTCREATE(sigset,...).	If nonzero, the	handle
	       points to a set of signals that can be used to change the
	       currently blocked set.

     josigset  A default integer output	variable containing a handle
	       created by PXFSTRUCTCREATE(sigset,...).	If nonzero, the
	       handle will be set to the currently blocked signal set.	If
	       zero, the currently blocked signal set will not be changed
	       and the value of	ihow is	ignored.

     ierrno    A default integer output	variable that contains zero if
	       PXFSIGPPROCMASK was successful and nonzero if
	       PXFSIGPPROCMASK was not successful.

     This subroutine may return	any of the following error values:

     EFAULT	    The	jsigset	or josigset argument points outside the
		    allocated space.

     EINVAL	    The	value of ihow is an invalid or unsupported
		    operation.

     EBADHANDLE	    The	jsigset	argument is invalid.

     On	IRIX systems, this routine is in libfortran.so which is	linked by
     default when compiling programs with the MIPSpro 7	Fortran	90 compiler
     or	when compiling programs	with the -craylibs option to the MIPSpro
     7.2 F77 compiler.

     When using	the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk,	or IRIX	systems, all arguments must be of default
     kind unless documented otherwise. On UNICOS and UNICOS/mk,	default
     kind is KIND=8 for	integer, real, complex,	and logical arguments; on
     IRIX systems, the default kind is KIND=4.

NOTES    [Toc]    [Back]

     Replace any Fortran reference to sigpprocmask() with a subroutine call
     to	PXFSIGPROCMASK.

SEE ALSO    [Toc]    [Back]

     sigprocmask(2)
     PXFSTRUCTCREATE(3F)

     Application Programmer's Library Reference	Manual,	publication
     SR-2165, for the printed version of this man page.