summaryrefslogtreecommitdiffstats
path: root/man2/select.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/select.2')
-rw-r--r--man2/select.266
1 files changed, 33 insertions, 33 deletions
diff --git a/man2/select.2 b/man2/select.2
index bbf8ea9e0..460552108 100644
--- a/man2/select.2
+++ b/man2/select.2
@@ -49,7 +49,7 @@ Standard C library
.P
.RS -4
Feature Test Macro Requirements for glibc (see
-.BR feature_test_macros (7)):
+.MR feature_test_macros 7 ):
.RE
.P
.BR pselect ():
@@ -64,9 +64,9 @@ can monitor only file descriptors numbers that are less than
(1024)\[em]an unreasonably low limit for many modern applications\[em]and
this limitation will not change.
All modern applications should instead use
-.BR poll (2)
+.MR poll 2
or
-.BR epoll (7),
+.MR epoll 7 ,
which do not suffer this limitation.
.P
.BR select ()
@@ -75,9 +75,9 @@ waiting until one or more of the file descriptors become "ready"
for some class of I/O operation (e.g., input possible).
A file descriptor is considered ready if it is possible to
perform a corresponding I/O operation (e.g.,
-.BR read (2),
+.MR read 2 ,
or a sufficiently small
-.BR write (2))
+.MR write 2 )
without blocking.
.\"
.SS fd_set
@@ -181,7 +181,7 @@ The file descriptors in this set are watched for "exceptional conditions".
For examples of some exceptional conditions, see the discussion of
.B POLLPRI
in
-.BR poll (2).
+.MR poll 2 .
.IP
After
.BR select ()
@@ -270,7 +270,7 @@ called with NULL
.P
.I sigmask
is a pointer to a signal mask (see
-.BR sigprocmask (2));
+.MR sigprocmask 2 );
if it is not NULL, then
.BR pselect ()
first replaces the current signal mask by the one pointed to by
@@ -349,7 +349,7 @@ struct timeval {
The corresponding argument for
.BR pselect ()
is a
-.BR timespec (3)
+.MR timespec 3
structure.
.P
On Linux,
@@ -404,14 +404,14 @@ However, see BUGS.
.TP
.B EINTR
A signal was caught; see
-.BR signal (7).
+.MR signal 7 .
.TP
.B EINVAL
.I nfds
is negative or exceeds the
.B RLIMIT_NOFILE
resource limit (see
-.BR getrlimit (2)).
+.MR getrlimit 2 ).
.TP
.B EINVAL
The value contained within
@@ -430,7 +430,7 @@ if the system fails to allocate kernel-internal resources, rather than
.B ENOMEM
as Linux does.
POSIX specifies this error for
-.BR poll (2),
+.MR poll 2 ,
but not for
.BR select ().
Portable programs may wish to check for
@@ -506,7 +506,7 @@ nonblocking I/O is used when reading from and writing to the pipe.)
.\"
.SS Emulating usleep(3)
Before the advent of
-.BR usleep (3),
+.MR usleep 3 ,
some code employed a call to
.BR select ()
with all three sets empty,
@@ -522,9 +522,9 @@ we find the following definitions which show the correspondence
between the readable, writable, and exceptional condition notifications of
.BR select ()
and the event notifications provided by
-.BR poll (2)
+.MR poll 2
and
-.BR epoll (7):
+.MR epoll 7 :
.P
.in +4n
.EX
@@ -609,7 +609,7 @@ a pointer to the signal set and its size,
while allowing for the fact that most architectures
support a maximum of 6 arguments to a system call.
See
-.BR sigprocmask (2)
+.MR sigprocmask 2
for a discussion of the difference between the kernel and libc
notion of the signal set.
.\"
@@ -641,17 +641,17 @@ defined as 1024, and the
.BR FD_* ()
macros operating according to that limit.
To monitor file descriptors greater than 1023, use
-.BR poll (2)
+.MR poll 2
or
-.BR epoll (7)
+.MR epoll 7
instead.
.P
The implementation of the
.I fd_set
arguments as value-result arguments is a design error that is avoided in
-.BR poll (2)
+.MR poll 2
and
-.BR epoll (7).
+.MR epoll 7 .
.P
According to POSIX,
.BR select ()
@@ -668,7 +668,7 @@ of the sets should result in the error
Starting with glibc 2.1, glibc provided an emulation of
.BR pselect ()
that was implemented using
-.BR sigprocmask (2)
+.MR sigprocmask 2
and
.BR select ().
This implementation remained vulnerable to the very race condition that
@@ -748,18 +748,18 @@ main(void)
.EE
.\" SRC END
.SH SEE ALSO
-.BR accept (2),
-.BR connect (2),
-.BR poll (2),
-.BR read (2),
-.BR recv (2),
-.BR restart_syscall (2),
-.BR send (2),
-.BR sigprocmask (2),
-.BR write (2),
-.BR timespec (3),
-.BR epoll (7),
-.BR time (7)
+.MR accept 2 ,
+.MR connect 2 ,
+.MR poll 2 ,
+.MR read 2 ,
+.MR recv 2 ,
+.MR restart_syscall 2 ,
+.MR send 2 ,
+.MR sigprocmask 2 ,
+.MR write 2 ,
+.MR timespec 3 ,
+.MR epoll 7 ,
+.MR time 7
.P
For a tutorial with discussion and examples, see
-.BR select_tut (2).
+.MR select_tut 2 .