diff options
Diffstat (limited to 'man2/select.2')
-rw-r--r-- | man2/select.2 | 66 |
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 . |