pthread_sigmask(3t) [hpux man page]

pthread_sigmask(3T)													       pthread_sigmask(3T)

NAME

       pthread_sigmask() - examine/change signal mask of calling thread

SYNOPSIS

PARAMETERS

	      how	This parameter defines how the signal mask of the calling thread will be changed.

	      set	Pointer to the set of signals that will be used to change the currently blocked signal set.

	      oset	Pointer to where the previous signal mask will be returned.

DESCRIPTION

       allows the calling thread to examine and/or change its signal mask.

       Unless it is a null pointer, the argument set points to a set of signals which are to be used to change the currently blocked signal set.

       The argument how indicates how the set is changed.  The legal values are:

	      The resulting set is the union of the current set and the signal
				set pointed to by set.

	      The resulting set is the intersection of the current set
				and the complement of the signal set pointed to by set.

	      The resulting set is the signal set pointed to by
				set.

       If the argument oset is not a null pointer, the previous signal mask is returned in oset.  If set is a null pointer, the value of the argu-
       ment how is insignificant and the thread's signal mask is unchanged; thus, the call can be used to inquire about currently blocked signals.

       If there any pending unblocked signals after the call to at least one of those signals is delivered before the call to returns.

       It is impossible to block the or signal.  This is enforced by the system without causing an error to be indicated.

       The thread's signal mask is not changed if fails for any reason.

RETURN VALUE

       Upon successful completion, returns zero.  Otherwise, an error number is returned to indicate the error (the variable is not set).

ERRORS

       If any of the following occur, the function returns the corresponding error number:

	      how	     contains an invalid value.

	      set	     or oset points to an invalid address.  The reliable detection of this error is implementation dependent.

AUTHOR

       was derived from the IEEE POSIX P1003.1c standard.

SEE ALSO

       sigprocmask(2).

STANDARDS CONFORMANCE

								  Pthread Library					       pthread_sigmask(3T)

pthread_sigmask(3)					     Library Functions Manual						pthread_sigmask(3)

NAME

       pthread_sigmask - Examine or change the current thread's signal mask.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h> #include <signal.h>

       int   pthread_sigmask(
			     int	     how,
			     const sigset_t  *set,
			     sigset_t	     *oset);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       IEEE Std 1003.1c-1995, POSIX System Application Program Interface

PARAMETERS

       Indicates  the manner in which the set of masked signals is changed.  The optional values are as follows: The resulting set is the union of
       the current set and the signal set pointed to by the set argument.)  The resulting set is the intersection of the current set and the  com-
       plement	of  the signal set pointed to by the set argument.  The resulting set is the signal set pointed to by the set argument.  Specifies
       the signal set by pointing to a set of signals used to change the blocked set.  If this set value is NULL, the how argument is ignored  and
       the process signal mask is unchanged.  Receives the value of the current signal mask (unless this value is NULL).

DESCRIPTION

       This routine is for UNIX systems only.

       This routine examines or changes the calling thread's signal mask.  Typically, you use the SIG_BLOCK option for the how value to block sig-
       nals during a critical section of code, and then use this routine's SIG_SETMASK option to restore the mask to the previous  value  returned
       by the previous call to the pthread_sigmask(3) routine.

       If  there  are  any  unblocked signals pending after a call to this routine, at least one of those signals is delivered before this routine
       returns.

       This routine does not allow the SIGKILL or SIGSTOP signals to  be  blocked.   If  a  program  attempts  to  block  one  of  these  signals,
       pthread_sigmask(3) gives no indication of the error.

RETURN VALUES

       If  an  error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are as follows:
       Successful completion.  The value specified for how is invalid.

ERRORS

       None

RELATED INFORMATION

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																pthread_sigmask(3)