summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libsignal.tex
diff options
context:
space:
mode:
authorMichael W. Hudson <mwh@python.net>2003-03-13 13:56:53 (GMT)
committerMichael W. Hudson <mwh@python.net>2003-03-13 13:56:53 (GMT)
commit43ed43bfc1380d36dd87f405080b5b3fae55532a (patch)
treea021c5fc5004bf2a4894e9b84f841d764222b424 /Doc/lib/libsignal.tex
parent94afd3095ee37dfcc672ebcd6ade8a3b00a39a69 (diff)
downloadcpython-43ed43bfc1380d36dd87f405080b5b3fae55532a.zip
cpython-43ed43bfc1380d36dd87f405080b5b3fae55532a.tar.gz
cpython-43ed43bfc1380d36dd87f405080b5b3fae55532a.tar.bz2
Take out my (long since disabled) POSIX signal mask handling code.
I'm not going to have the time or energy to get this working x-platform -- anyone who does is welcome to the code!
Diffstat (limited to 'Doc/lib/libsignal.tex')
-rw-r--r--Doc/lib/libsignal.tex54
1 files changed, 4 insertions, 50 deletions
diff --git a/Doc/lib/libsignal.tex b/Doc/lib/libsignal.tex
index 3029385..e3aa171 100644
--- a/Doc/lib/libsignal.tex
+++ b/Doc/lib/libsignal.tex
@@ -18,6 +18,10 @@ the handler for \constant{SIGCHLD}, which follows the underlying
implementation.
\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
``atomic'' instructions of the Python interpreter. This means that
@@ -88,16 +92,6 @@ The variables defined in the \module{signal} module are:
One more than the number of the highest signal number.
\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:
\begin{funcdesc}{alarm}{time}
@@ -150,46 +144,6 @@ The \module{signal} module defines the following functions:
\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}
-
\subsection{Example}
\nodename{Signal Example}