Michael Kerrisk
e417acb023
fcntl.2, intro.2, open.2, poll.2, ftw.3, intro.3, matherr.3, system.3, tmpnam.3, unix.7: Note that feature test macros must be defined before *any* includes
...
Programmers often make the mistake of including a feature test
macro only after having already included some header files.
This patch adds some text at opportune places to remind
programmers to do things the right way.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-10 06:33:31 +02:00
Michael Kerrisk
ba2e3e9a04
poll.2: tfix
...
Reported-by: Denis Barbier <bouzim@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-07-02 07:12:35 +02:00
Michael Kerrisk
b8c599cba0
poll.2: Fix discussion of ppoll() timeout argument
...
1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
from the poll() argument in the text.
2. More accurately describe the poll() call that is equivalent
to ppoll().
Reported-by: Andi Kleen <andi@firstfloor.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 14:15:00 +02:00
Michael Kerrisk
c7094399ad
intro.1, time.1, adjtimex.2, capget.2, eventfd.2, fcntl.2, getrlimit.2, getsockopt.2, gettimeofday.2, intro.2, ioctl_list.2, ioperm.2, mlock.2, pivot_root.2, poll.2, prctl.2, ptrace.2, sched_setscheduler.2, select_tut.2, semget.2, sigaltstack.2, signalfd.2, sysctl.2, timer_settime.2, timerfd_create.2, wait.2, CPU_SET.3, argz_add.3, assert_perror.3, atexit.3, backtrace.3, bcmp.3, clearenv.3, ctime.3, dl_iterate_phdr.3, dlopen.3, ecvt.3, errno.3, error.3, ether_aton.3, exit.3, fenv.3, ferror.3, finite.3, flockfile.3, fnmatch.3, fpathconf.3, fpclassify.3, ftime.3, ftok.3, ftw.3, fwide.3, getaddrinfo.3, gethostbyname.3, getlogin.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getrpcent.3, getservent.3, glob.3, hsearch.3, inet.3, isalpha.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, longjmp.3, lsearch.3, malloc.3, matherr.3, mblen.3, mbsinit.3, mbtowc.3, on_exit.3, printf.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_equal.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, ptsname.3, putenv.3, putgrent.3, raise.3, rcmd.3, regex.3, rexec.3, rpc.3, rpmatch.3, rtnetlink.3, scandir.3, sem_init.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, signbit.3, stdio_ext.3, strtod.3, strtol.3, strtoul.3, system.3, termios.3, timeradd.3, tzset.3, ualarm.3, wctomb.3, xdr.3, st.4, tty_ioctl.4, core.5, elf.5, proc.5, bootparam.7, capabilities.7, icmp.7, ip.7, ipv6.7, math_error.7, mdoc.samples.7, mq_overview.7, pthreads.7, raw.7, regex.7, socket.7, tcp.7, tzselect.8: Global fix: s/non-zero/nonzero/
...
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:40:55 +01:00
Michael Kerrisk
c8f2dd479b
accept.2, execve.2, futimesat.2, getresuid.2, getrlimit.2, madvise.2, mq_getsetattr.2, msgctl.2, nice.2, open.2, poll.2, setresuid.2, shmctl.2, sigaction.2, times.2, utimensat.2, __setfpucw.3, atoi.3, endian.3, err.3, euidaccess.3, fenv.3, fopencookie.3, fpurge.3, getgrouplist.3, getutmp.3, j0.3, lgamma.3, netlink.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, pthread_yield.3, random_r.3, readdir.3, rtnetlink.3, scanf.3, setenv.3, significand.3, sigsetops.3, strerror.3, strstr.3, sysv_signal.3, termios.3, timegm.3, unlocked_stdio.3, y0.3, locale.5, bootparam.7, feature_test_macros.7, ip.7, locale.7, pthreads.7, rtld-audit.7, nscd.8: Global fix: s/non-standard/nonstandard/
...
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:40:20 +01:00
Michael Kerrisk
d8dfbff93f
poll.2: Clarify wording describing of 'nfds' argument.
...
reported by: rui rlex <rui.rlex@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:19 +02:00
Michael Kerrisk
f1a291ecd0
poll.2: Remove EBADF error from ERRORS
...
As reported by Motohiro:
"man poll" describe this error code.
>ERRORS
> EBADF An invalid file descriptor was given in one of the sets.
but current kernel implementation ignore invalid file descriptor,
not return EBADF.
...
In the other hand, SUSv3 talk about
> POLLNVAL
> The specified fd value is invalid. This flag is only valid in the
> revents member; it shall ignored in the events member.
and
> If the value of fd is less than 0, events shall be ignored, and
> ireevents shall be set to 0 in that entry on return from poll().
but, no desribe EBADF.
(see http://www.opengroup.org/onlinepubs/009695399/functions/poll.html )
So, I think the implementation is correct.
Why don't we remove EBADF description?
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
2008-06-11 02:09:08 +02:00
Michael Kerrisk
01538d0d51
ERRORS: Added reference to signal(7) in dicussion of EINTR.
2008-07-04 15:50:36 +00:00
Michael Kerrisk
1d7c4d16b2
SEE ALSO: add time(7)
2008-06-23 08:48:25 +00:00
Michael Kerrisk
a20e907fde
Remove out-of-date FIXME
2008-05-09 21:15:33 +00:00
Michael Kerrisk
3ee895129b
If the 'sigmask' is NULL, the ppoll() is equivalent to poll()
...
with respect tio signal mask manipulations.
2008-04-23 14:49:53 +00:00
Michael Kerrisk
14946d05f3
tstamp
2008-04-23 14:42:14 +00:00
Michael Kerrisk
eba722884d
s/nonzero/non-zero/
2008-03-19 13:16:39 +00:00
Michael Kerrisk
c382a36592
hyphenation fixes
2007-12-25 22:02:19 +00:00
Michael Kerrisk
8382f16db1
grfix
2007-12-25 21:28:09 +00:00
Michael Kerrisk
088a639be3
Make the standard indent for code samples, shell session
...
logs, etc. to be ".in +4n".
2007-12-19 06:57:44 +00:00
Michael Kerrisk
a08ea57c20
Make the standard indent for code samples, shell session
...
logs, etc. to be ".in +4n".
2007-12-19 05:53:30 +00:00
Michael Kerrisk
c11b1abf2e
Change mtk's email address
2007-09-20 06:52:22 +00:00
Michael Kerrisk
10f5f29476
s/bitmask/bit mask/
2007-07-01 04:23:34 +00:00
Michael Kerrisk
682edefb1b
ffix
2007-06-22 17:16:20 +00:00
Michael Kerrisk
c84371c688
Italics for header file references
2007-06-20 21:53:34 +00:00
Michael Kerrisk
d9bfdb9c21
Convert to American spelling conventions
2007-06-08 09:56:56 +00:00
Michael Kerrisk
d9343c5c13
Removed version number from .TH line
2007-05-30 05:36:26 +00:00
Michael Kerrisk
a7b9318d06
Updated FIXME.
2007-05-21 06:52:12 +00:00
Michael Kerrisk
a1d5f77cc8
Reordered sections to be more consistent, in some cases renaming
...
sections or shifting paragraphs between sections.
2007-05-18 16:06:42 +00:00
Michael Kerrisk
4fb3134194
Relocated LINUX NOTES as subsection under NOTES
2007-05-18 10:39:45 +00:00
Michael Kerrisk
0bfa087b03
Add section numbers to references to other pages
2007-05-11 23:07:02 +00:00
Michael Kerrisk
c13182efa3
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
...
white space.
2007-04-12 22:42:49 +00:00
Michael Kerrisk
cf0a9ace57
ffix
2007-04-05 12:36:57 +00:00
Michael Kerrisk
00877d8f0f
tfix
2007-03-01 01:27:34 +00:00
Michael Kerrisk
24b3ed1dad
Updated FIXME
2006-07-11 04:24:13 +00:00
Michael Kerrisk
23cb3cb55d
Added POLLRDHUP description.
...
The correct header file is <poll.h>, not <sys/poll.h>.
Rewrote and reformatted various other parts.
2006-07-01 08:30:56 +00:00
Michael Kerrisk
7145b9a93c
spfix
2006-06-03 01:26:30 +00:00
Michael Kerrisk
a8e7c990dc
Rename ftm.7 to feature_test_macros.7
2006-05-15 09:13:10 +00:00
Michael Kerrisk
50e5322c85
Added SEE ALSO reference to ftm.7
2006-04-21 06:49:34 +00:00
Michael Kerrisk
0c373d0150
Added FIXME.
2006-04-03 23:35:16 +00:00
Michael Kerrisk
4b9d4c1ac5
Added FIXME
2006-03-25 21:07:31 +00:00
Michael Kerrisk
22ca838f59
ppoll() proto needs _GNU_SOURCE
2006-03-19 23:37:17 +00:00
Michael Kerrisk
e755a587cd
Further changes for ppoll.2.
2006-03-16 00:06:34 +00:00
Michael Kerrisk
c1164764b0
Added NOTES about INFTIM contant provided on some other implementations.
2005-12-01 16:03:36 +00:00
Michael Kerrisk
1e32103455
Formatting fixes
2005-10-20 15:11:10 +00:00
Michael Kerrisk
4d52e8f81c
Formatting fixes
2005-10-19 14:54:31 +00:00
Michael Kerrisk
b5cc2ffbaa
Formatting fixes
2005-10-19 14:48:35 +00:00
Michael Kerrisk
96296ef0fa
nfds should be prototyped as nfds_t; as per Debian bug 322934
...
Some wording and formatting improvements.
2005-08-16 08:46:16 +00:00
Michael Kerrisk
d301ee6c72
Fix typos and spelling mistakes
2005-04-18 14:25:45 +00:00
Michael Kerrisk
fea681dafb
Import of man-pages 1.70
2004-11-03 13:51:07 +00:00