summary refs log tree commit diff
path: root/manual
diff options
context:
space:
mode:
authorRoland McGrath <roland@gnu.org>2004-07-12 21:44:33 +0000
committerRoland McGrath <roland@gnu.org>2004-07-12 21:44:33 +0000
commit36634622ab6bcdbbaee92a6c9d88898d5352c7fb (patch)
tree6be23e0d6c4f6d4e749270269a77ae8652de1870 /manual
parentee600e3f76afbdc92c3258c362b6c061ada58b21 (diff)
downloadglibc-36634622ab6bcdbbaee92a6c9d88898d5352c7fb.tar.gz
glibc-36634622ab6bcdbbaee92a6c9d88898d5352c7fb.tar.xz
glibc-36634622ab6bcdbbaee92a6c9d88898d5352c7fb.zip
2004-07-12 Roland McGrath <roland@redhat.com>
	* manual/signal.texi (Interrupted Primitives): Make clear that
	TEMP_FAILURE_RETRY evaluates its expression as long int and compares
	it to -1 to define "failure".
Diffstat (limited to 'manual')
-rw-r--r--manual/signal.texi9
1 files changed, 6 insertions, 3 deletions
diff --git a/manual/signal.texi b/manual/signal.texi
index 2c06c6ca2d..1d28f74027 100644
--- a/manual/signal.texi
+++ b/manual/signal.texi
@@ -2083,9 +2083,12 @@ temporary failure, with the macro @code{TEMP_FAILURE_RETRY}:
 @comment unistd.h
 @comment GNU
 @defmac TEMP_FAILURE_RETRY (@var{expression})
-This macro evaluates @var{expression} once.  If it fails and reports
-error code @code{EINTR}, @code{TEMP_FAILURE_RETRY} evaluates it again,
-and over and over until the result is not a temporary failure.
+This macro evaluates @var{expression} once, and examines its value as
+type @code{long int}.  If the value equals @code{-1}, that indicates a
+failure and @code{errno} should be set to show what kind of failure.
+If it fails and reports error code @code{EINTR},
+@code{TEMP_FAILURE_RETRY} evaluates it again, and over and over until
+the result is not a temporary failure.
 
 The value returned by @code{TEMP_FAILURE_RETRY} is whatever value
 @var{expression} produced.