summaryrefslogtreecommitdiff
path: root/gnulib/doc/pastposix-functions/usleep.texi
diff options
context:
space:
mode:
Diffstat (limited to 'gnulib/doc/pastposix-functions/usleep.texi')
m---------gnulib0
-rw-r--r--gnulib/doc/pastposix-functions/usleep.texi28
2 files changed, 28 insertions, 0 deletions
diff --git a/gnulib b/gnulib
deleted file mode 160000
-Subproject 4fc10daa05477586fea99b6b3ca02a87d1102fa
diff --git a/gnulib/doc/pastposix-functions/usleep.texi b/gnulib/doc/pastposix-functions/usleep.texi
new file mode 100644
index 00000000..8ca0da9e
--- /dev/null
+++ b/gnulib/doc/pastposix-functions/usleep.texi
@@ -0,0 +1,28 @@
+@node usleep
+@section @code{usleep}
+@findex usleep
+
+POSIX specification: @url{http://www.opengroup.org/susv3xsh/usleep.html}
+
+Gnulib module: usleep
+
+Portability problems fixed by Gnulib:
+@itemize
+@item
+On some systems, @code{usleep} rejects attempts to sleep longer than 1
+second, as allowed by POSIX:
+mingw.
+@item
+This function is missing on some platforms. However, the replacement
+is designed to be lightweight, and may round to the neareset second;
+use @code{select} or @code{nanosleep} if better resolution is needed:
+IRIX 5.3, Solaris 2.4, older mingw, BeOS.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+According to POSIX, the @code{usleep} function may interfere with the program's
+use of the @code{SIGALRM} signal. On Linux, it doesn't; on other platforms,
+it may.
+@end itemize