path: root/manual/signal.texi
diff options
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/signal.texi
parentee600e3f76afbdc92c3258c362b6c061ada58b21 (diff)
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/signal.texi')
1 files changed, 6 insertions, 3 deletions
diff --git a/manual/signal.texi b/manual/signal.texi
index 2c06c6ca2d8..1d28f74027a 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.