[Python-checkins] python/dist/src/Doc/lib libsignal.tex,1.23,1.24

2002年5月27日 08:08:26 -0700

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv24806/Doc/lib
Modified Files:
	libsignal.tex 
Log Message:
This is patch
[ 559250 ] more POSIX signal stuff
Adds support (and docs and tests and autoconfery) for posix signal
mask handling -- sigpending, sigprocmask and sigsuspend.
Index: libsignal.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsignal.tex,v
retrieving revision 1.23
retrieving revision 1.24
diff -C2 -d -r1.23 -r1.24
*** libsignal.tex	15 Feb 2002 20:59:43 -0000	1.23
--- libsignal.tex	27 May 2002 15:08:24 -0000	1.24
***************
*** 19,26 ****
 
 \item
- There is no way to ``block'' signals temporarily from critical
- sections (since this is not supported by all \UNIX{} flavors).
- 
- \item
 Although Python signal handlers are called asynchronously as far as
 the Python user is concerned, they can only occur between the
--- 19,22 ----
***************
*** 93,96 ****
--- 89,102 ----
 \end{datadesc}
 
+ \begin{datadesc}{SIG_BLOCK}
+ \end{datadesc}
+ \begin{datadesc}{SIG_UNBLOCK}
+ \end{datadesc}
+ \begin{datadesc}{SIG_SETMASK}
+ These constants are for use as the first parameter of the
+ \function{sigprocmask} function described below.
+ \end{datadesc}
+ 
+ 
 The \module{signal} module defines the following functions:
 
***************
*** 143,146 ****
--- 149,192 ----
 reference manual for a description of frame objects).
 \obindex{frame}
+ \end{funcdesc}
+ 
+ The following functions are supported if your platform does. Most
+ modern \UNIX-alikes now do.
+ 
+ \begin{funcdesc}{sigpending}{}
+ Return the set of pending signals, i.e. a list containing the
+ numbers of those signals that have been raised while blocked.
+ \versionadded{2.3}
+ \end{funcdesc}
+ 
+ \begin{funcdesc}{sigprocmask}{how, sigset}
+ Change the list of currently blocked signals. The parameter
+ \var{how} should be one of \constant{SIG_BLOCK},
+ \constant{SIG_UNBLOCK} or \constant{SIG_SETMASK} and \var{sigset}
+ should be a sequence of signal numbers. The behaviour of the call
+ depends on the value of \var{how}:
+ 
+ \begin{tableii}{l|l}{textrm}{Value of \var{how}}{Behaviour of call}
+ \lineii{\constant{SIG_BLOCK}}
+ 	 {The set of blocked signals is the union of the current set
+ and \var{sigset}.}
+ \lineii{\constant{SIG_UNBLOCK}} 
+ {The signals in \var{sigset} are removed from the current
+ set of blocked signals. It is legal to attempt to unblock 
+ a signal which is not blocked.}
+ \lineii{\constant{SIG_SETMASK}}
+ 	 {The set of blocked signals is set to the \var{sigset}.}
+ \end{tableii}
+ 
+ A list contating the numbers of the previously blocked signals is
+ returned.
+ \versionadded{2.3}
+ \end{funcdesc}
+ 
+ \begin{funcdesc}{sigsuspend}{sigset}
+ Temporarily replace the signal mask with \var{sigset} (which should
+ be a sequnce of signal numbers) and suspend the process until a
+ signal is received.
+ \versionadded{2.3}
 \end{funcdesc}