Commit Graph

2394 Commits

Author SHA1 Message Date
Michael Kerrisk 2ff07a1e5f statfs.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-13 05:30:04 +02:00
Michael Kerrisk b7b46bf606 statfs.2: Document f_frsize field.
Reported-by: Miklos Szeredi <miklos@szeredi.hu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-13 05:29:29 +02:00
Michael Kerrisk 13a36929ad recv.2: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 14:42:50 +02:00
Yuri Kozlov 687b7c838d pread.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 14:35:03 +02:00
Andi Kleen f01470e6e3 migrate_pages.2: New page documenting migrate_pages(2).
Andi's text based on the move_pages.2 page; additional edits by mtk.
migrate_pages(2) was new in Linux 2.6.16.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 14:27:49 +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
Andi Kleen ed31c5727f prctl.2: Document the hwpoison prctls in 2.6.32
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 13:47:27 +02:00
Michael Kerrisk 81fff50bbf move_pages.2: minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 14:26:36 +02:00
Michael Kerrisk ebbb5118f0 mremap.2: Clarify existence of fifth argument.
Reported-by: Andi Kleen <andi@firstfloor.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 08:07:47 +02:00
Michael Kerrisk 1fd0fa4338 move_pages.2: minor tweak to Andi's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 07:38:13 +02:00
Andi Kleen cb8fbbcd47 Clarify includes/libraries in move_pages page
Signed-off-by: Andi Kleen <ak@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 07:38:13 +02:00
Michael Kerrisk 665f1e69cf sigaction.2: Improve description of various siginfo_t fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 07:38:13 +02:00
Andi Kleen f402032c67 sigaction.2: Document hwpoison signal extensions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 07:38:12 +02:00
Michael Kerrisk b2b49ccb2d select_tut.2: Fix bug in example program
Reported-by: Andrew Klossner <andrew@cesa.opbu.xerox.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-11 07:38:10 +02:00
Fang Wenqi a30508988b statfs.2: Add definition EXT4_SUPER_MAGIC = 0xEF53
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 15:05:59 +02:00
Yuri Kozlov 84492c365b setsid.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 14:43:43 +02:00
Michael Kerrisk 57440a987d getrusage.2: Enhanced description of various fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 05:21:17 +02:00
Michael Kerrisk e3f4bf3ee4 getrusage.2: srcfix: Update change history to note Mark Hills' updates
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 05:21:05 +02:00
Mark Hills c90ccb4e1b getrusage.2: Add ru_maxrss
See kernel commit 1f10206.

Signed-off-by: Mark Hills <mark@pogo.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 04:27:40 +02:00
Mark Hills d1cd1e055a getrusage.2: Description of maintained fields
These descriptions are taken from NetBSD 5.0's getrusage(2).

Signed-off-by: Mark Hills <mark@pogo.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 04:27:28 +02:00
Michael Kerrisk 3a7c32f47e timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, getline.3: Add 'L' to constants in feature test macro specifications
Be consistent with POSIX, which uses constants such as 200809L.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-24 03:58:26 +02:00
Michael Kerrisk b182a7e530 msgop.2: tfix: s/msg_bytes/msg_qbytes/
Reported-by: Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-23 03:19:34 +02:00
Petr Uzel 2dc48048f4 mount.2: Fix incorrect path
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-22 05:32:46 +02:00
Michael Kerrisk 9b936e9eec futex.2: Various fixes in SEE ALSO
Reported-by: Rob Landley <rob@landley.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-22 05:23:14 +02:00
Michael Kerrisk 028cb0809b prctl.2: Correct PR_SET_KEEPCAPS description
The "keep capabilities" flag only affects the treatment of
permitted capabilities, not effective capabilities.

Also: other improvements to make the PR_SET_KEEPCAPS text clearer.

Reported-by: Serge E. Hallyn <serge@hallyn.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-13 06:16:25 +02:00
Michael Kerrisk 623ba005ca prctl.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-05-10 05:30:56 +02:00
Michael Kerrisk 12062404f9 mmap.2: Document MAP_UNINITIALIZED flag
New in Linux 2.6.33.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-03-13 08:08:06 +01:00
Michael Kerrisk 7c7adcbe55 mmap.2: minor: fix text ordering (MAP_STACK)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-03-13 07:11:08 +01:00
Michael Kerrisk 285bf67e18 syscalls.2: Bring system call list up to date with Linux 2.6.33
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-03-06 06:46:15 +01:00
Michael Kerrisk d3ea5e9928 syscalls.2: Fix kernel version number for utimes()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-03-06 06:31:08 +01:00
Michael Kerrisk ec8bcce2a8 mlock.2: /proc/PID/status VmLck shows how much memory a process has locked
After a note from Tom Swigg, it seems sensible mention VmLck here.

Reported-by: Tom Swigg <swiggtc@lsbu.ac.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-03-05 04:02:19 +01:00
Michael Kerrisk 736bedf67b sigprocmask.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-26 11:15:26 +01:00
Michael Kerrisk d5dd3a91dc Removed trailing white space at end of lines 2010-02-26 05:45:27 +01:00
Michael Kerrisk 513051f769 add_key.2, keyctl.2, request_key.2, stime.2, time.2, ctime.3, difftime.3, ftime.3, getspnam.3, mq_receive.3, mq_send.3, rtime.3, sem_wait.3, string.3, timeradd.3, tzset.3, rtc.4, core.5, icmp.7, time.7, zic.8: Updated .TH timestamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-25 10:43:57 +01:00
Michael Kerrisk 4509c62e84 keyctl.2: New page documenting keyctl(2)
Taken from keyutils-1.1 package.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-25 08:29:42 +01:00
Michael Kerrisk 6dd17d2301 request_key: New page documenting request_key(2)
Taken from keyutils-1.1 package.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-25 08:29:02 +01:00
Michael Kerrisk 2e2f82fc2a add_key.2: New page documenting add_key(2)
Taken from keyutils-1.1 package.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-25 08:24:00 +01:00
Michael Kerrisk 38271a2dc6 sched_setscheduler.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-21 15:18:42 +01:00
Michael Kerrisk 821c035685 setuid.2: Remove crufty statement that seteuid() is not in POSIX
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=569812

Reported-by: Ansgar Burchardt <ansgar@2008.43-1.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-21 15:14:09 +01:00
Michael Kerrisk 5d469421e6 madvise.2: srcfix: added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-21 15:14:09 +01:00
Michael Kerrisk f859dc58b6 setpgid.2: tfix
Reported-by: Kevin <tsubasa.xw@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-21 15:14:08 +01:00
Michael Kerrisk 5227ef33b5 sendfile.2: Clarify behavior when offset is NULL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-21 15:14:08 +01:00
Michael Kerrisk 763cccc52e intro.2, intro.3: Make subsection heading consistent with other intro.? pages
These pages used "Copyright Terms"; the other intro.? pages
used "Copyright Conditions". Make these pages like the others.

Reported-by: Yuri Kozlov <yoray@komyakino.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-03 06:14:26 +01:00
Michael Kerrisk a113440ce6 clock_getres.2: Update text on nonsetabble CLOCK_*_CPUTIME_ID clocks
SUSv3 permits, but does not require CLOCK_THREAD_CPUTIME_ID and
CLOCK_PROCESS_CPUTIME_ID to be settable.
See http://bugzilla.kernel.org/show_bug.cgi?id=11972.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-03 04:27:11 +01:00
Christoph Hellwig db3e674548 sync_file_range.2: Add some big warnings re data integrity
This system call is by design completely unsuitable for any data
integrity operations.  Make that very clear in the manpage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-17 05:44:25 +01:00
Michael Kerrisk ef2e066053 stime.2, time.2, difftime.3, rtime.3, core.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-17 04:58:36 +01:00
Michael Witten f49c451a62 stime.2, time.2, utimensat.2, ctime.3, difftime.3, ftime.3, getspnam.3, mq_receive.3, mq_send.3, rtime.3, sem_wait.3, strftime.3, strptime.3, timeradd.3, rtc.4, core.5, proc.5, icmp.7, time.7: Global fix: Consistently define the Epoch
All definitions of the Epoch have been refactored to the following:

  1970-01-01 00:00:00 +0000 (UTC)

That form is more consistent, logical, precise, and internationally
recognizable than the other variants.

Also, some wording has been altered as well.

Signed-off-by: Michael Witten <mfwitten@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-17 04:55:05 +01:00
Michael Witten 750d65df7d stime.2, strftime.3, tzset.3, zic.8: GMT -> UTC (where appropriate)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 19:17:39 +01:00
Michael Kerrisk bd74a87338 prctl.2, putgrent.3, strcat.3, strcpy.3, console_ioctl.4: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:56:17 +01:00
Michael Kerrisk 3b777affca close.2, epoll_create.2, epoll_ctl.2, fcntl.2, madvise.2, mmap.2, mremap.2, select_tut.2, setgid.2, setuid.2, syscalls.2, vmsplice.2, dlopen.3, fts.3, getpw.3, stdio.3, fd.4, initrd.4, random.4, sd.4, bootparam.7, capabilities.7, cpuset.7, epoll.7, inotify.7, man.7, socket.7, x25.7: Global fix: s/re-/re/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "re-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:45:23 +01:00
Michael Kerrisk 310672d6b1 ioctl_list.2, mount.2, select_tut.2, stat.2, getifaddrs.3, pthread_cleanup_push_defer_np.3, pthread_getcpuclockid.3, proc.5, bootparam.7: Global fix: s/sub-/sub/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "sub-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:36:10 +01:00
Michael Kerrisk 488007e867 nanosleep.2: minor: Remove unneeded word "non-blocked"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:30:49 +01:00
Michael Kerrisk 60b9e97c05 ioperm.2, setresuid.2, tcp.7: GLobal fix: s/non-privileged/unprivileged/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:29:41 +01:00
Michael Kerrisk c95853ae66 chown.2, statfs.2: Global fix: /non-superuser/unprivileged user/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:26:41 +01:00
Michael Kerrisk f38d8f717e sigaction.2, sigprocmask.2, inet_ntop.3: wfix: s/non-null/non-NULL/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:25:31 +01:00
Michael Kerrisk 00b08db3b4 clone.2, ptrace.2, setuid.2, statvfs.2, ulimit.3, nologin.5: Global fix: s/non-root/unprivileged/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:24:09 +01:00
Michael Kerrisk 24b74457e7 accept.2, access.2, acct.2, clock_nanosleep.2, mbind.2, mincore.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, splice.2, stat.2, syslog.2, timer_create.2, timerfd_create.2, truncate.2, fenv.3, ferror.3, fflush.3, fgetwc.3, fgetws.3, flockfile.3, fputwc.3, fputws.3, fread.3, getopt.3, gets.3, getwchar.3, glob.3, iconv.3, longjmp.3, pow.3, printf.3, puts.3, putwchar.3, regex.3, rpc.3, scanf.3, setjmp.3, termios.3, unlocked_stdio.3, wcswidth.3, hd.4, rtc.4, st.4, core.5, dir_colors.5, elf.5, proc.5, arp.7, ascii.7, boot.7, bootparam.7, charsets.7, futex.7, ip.7, iso_8859-11.7, man-pages.7, man.7, mdoc.samples.7, path_resolution.7, pipe.7, posixoptions.7, unicode.7, unix.7, uri.7, utf-8.7, ld.so.8: s/non-/non/
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 18:20:12 +01:00
Michael Kerrisk f74bac5df4 spu_create.2, getopt.3, passwd.5: Global fix: s/non-existing/nonexistent/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:04:12 +01:00
Michael Kerrisk 44732c9c88 sendfile.2, wctrans.3, wctype.3, pipe.7, zic.8: Global fix: s/Non-/Non/
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 18:02:43 +01:00
Michael Kerrisk b28f6e5645 prctl.2, fmtmsg.3, gethostbyname.3, getnameinfo.3: Global fix: s/non-recoverable/nonrecoverable/
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 18:01:12 +01:00
Michael Kerrisk fb0e9c4809 mincore.2, remap_file_pages.2, random.3: Global fix: s/non-linear/nonlinear/
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:58:03 +01:00
Michael Kerrisk ffa1b462e4 timer_settime.2: s/non-zero/nonzero/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:57:16 +01:00
Michael Kerrisk a6712802e2 getitimer.2, termios.3: Gloabl fix: s/non-canonical/noncanonical/
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:54:51 +01:00
Michael Kerrisk cfea513249 getitimer.2, getrusage.2, times.2, utimensat.2, pthread_create.3, pthreads.7, utf-8.7: Global fix: s/non-conform/nonconform/
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:48:00 +01:00
Michael Kerrisk 657316c092 msgop.2, semop.2, lgamma.3, tgamma.3, mdoc.samples.7: Global fix: s/non-positive/nonpositive/
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:47:13 +01:00
Michael Kerrisk d603cc27b6 execve.2, fallocate.2, futex.2, sched_rr_get_interval.2, select_tut.2, shmget.2, timer_getoverrun.2, times.2, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, sem_open.3, stdin.3, rtc.4, tty_ioctl.4, unix.7: Global fix: s/non-portable/nonportable/
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:46:09 +01:00
Michael Kerrisk 2fda57bd09 _syscall.2, accept.2, epoll_create.2, inotify_add_watch.2, ioctl.2, msgget.2, msgop.2, open.2, prctl.2, sched_setscheduler.2, semctl.2, semget.2, swapon.2, addseverity.3, cacosh.3, csqrt.3, dirfd.3, drand48.3, fputws.3, mq_send.3, posix_openpt.3, puts.3, sched_getcpu.3, shm_open.3, sqrt.3, sysconf.3, tgamma.3, ulimit.3, credentials.7, svipc.7: Global fix: s/non-negative/nonnegative/
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:44:48 +01:00
Michael Kerrisk ff40dbb354 accept.2, connect.2, eventfd.2, flock.2, open.2, posix_fadvise.2, read.2, recv.2, sched_setscheduler.2, select_tut.2, send.2, signalfd.2, splice.2, timerfd_create.2, write.2, flockfile.3, mkfifo.3, mq_notify.3, mq_open.3, pthread_tryjoin_np.3, scanf.3, random.4, ddp.7, epoll.7, fifo.7, ip.7, pipe.7, socket.7, spufs.7: Global fix: s/non-blocking/nonblocking/
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:43:10 +01:00
Michael Kerrisk aa79648125 mbind.2, rename.2, sched_setscheduler.2, set_mempolicy.2, syslog.2, argz_add.3, dlopen.3, scanf.3, strtod.3, strtok.3, tcgetpgrp.3, hd.4, cpuset.7, regex.7, ld.so.8: Global fix: s/non-empty/nonempty/
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:41:47 +01: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 7111f89ff2 open.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-05 17:49:46 +01:00
Michael Kerrisk a417046130 madvise.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-05 17:20:52 +01:00
Colin Watson 9ec8f8605e execve.2: Fix description of treatment of caught signals
Caught signals reset to their default on an execve() (not
to being ignored).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-05 15:07:22 +01:00
Michael Kerrisk 7cc796ee52 faccessat.2, fchmodat.2, fchownat.2, fstatat.2, futimesat.2, linkat.2, mkdirat.2, mknodat.2, openat.2, readlinkat.2, renameat.2, symlinkat.2, unlinkat.2, utimensat.2, mkfifoat.3: Update feature test macro requirements
Starting in glibc 2.10, defining _XOPEN_SOURCE >= 700,
or _POSIX_C_SOURCE >= 200809 exposes the declarations of
these functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-12-13 22:54:45 +01:00
Michael Kerrisk 43ada5d427 madvise.2: scrfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-11-27 08:17:35 +01:00
Michael Kerrisk 715e4bec08 setreuid.2: Add more detail on POSIX.1 specification for these syscalls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-10-17 07:35:40 +02:00
Michael Kerrisk b033d60f29 seteuid.2: Note unstandardized behavior for effective ID
PSOIX.1 doesn't require that the effective ID can be changed
to the same value it currently has (a no-op). The man page
should note this, since some other implementations
don't permit it.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-10-17 07:06:46 +02:00
Andries E. Brouwer 130b2e49b1 clone.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-10-17 06:39:02 +02:00
Michael Kerrisk 7a8fe6a940 setgid.2: Fix EPERM error description
s/effective group ID/real group ID/
This bug lived in man pages for 15 years before Jason
spotted it! I checked back in Linux 1.0, and the behavior
was as the fixed man page describes.

Reported-by: Jason Noakes <jjnoakes@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-10-17 06:36:12 +02:00
Michael Kerrisk 1eef2ba881 fcntl.2: s/F_OWNER_GID/F_OWNER_PGRP/
Peter Zijlstra took the name change I suggested.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-10-17 06:00:04 +02:00
Michael Kerrisk dd164bfcd5 fcntl.2: Document F_[SG]ETOWN_EX; update details on F_SETOWN
Linux 2.6.32 adds F_SETOWN_EX and F_GETOWN_EX.
Linux 2.6.12 changed (broke) the former behavior of
F_SETOWN with respect to threads.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-10-03 17:23:31 +02:00
Michael Kerrisk 2843ba93d4 stat.2, posix_fallocate.3, proc.5, tcp.7, udp.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-30 03:28:34 +02:00
Michael Kerrisk c440fe01d3 clone.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:30 +02:00
Michael Kerrisk e4f09fd444 timer_getoverrun.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:30 +02:00
Nicolas Franois bdfd22665a stat.2: Fix small bug in example program
Since it is a failure, EXIT_FAILURE looks more appropriate
than EXIT_SUCCESS.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:29 +02:00
Nicolas Franois a4d45bc1b9 semctl.2: Remove some redundant words
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:29 +02:00
Nicolas Franois 5feae95791 move_pages.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:29 +02:00
Nicolas Franois 64f6ff57b8 epoll_ctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:29 +02:00
Michael Kerrisk 17b7878618 sigaction.2: Minor fixes
Minor grammar fixes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:29 +02:00
Michael Kerrisk a8974b6de4 getdomainname.2: Minor change
s/current processors/host system/, which is a little clearer.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:28 +02:00
Nicolas Franois 3f1a745d44 timer_settime.2: Minor fixes
Fix typos:
 * duplicate the
 * curr_value is a pointer
 * misplaced 'a'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:25 +02:00
Nicolas Franois 37f0c8322e timer_create.2: Minor fixes
Add missing parenthesis
Explicitly indicate that conditions are ORed.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:25 +02:00
Nicolas Franois ec28c6b988 stat.2: Minor fixes
Fix to formatting issues:
 * remove ending tabulation
 * add missing parenthesis

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:25 +02:00
Nicolas Franois b6a046323e set_thread_area.2: Minor fixes
set_thread_area is a system call, not a library function.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:24 +02:00
Nicolas Franois dc99a2a724 select_tut.2: Minor fixes
Wording and spelling fix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:24 +02:00
Nicolas Franois c9065be1c4 sched_setaffinity.2: Minor fixes
Consistency for references to manpages

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:24 +02:00
Nicolas Franois 22e7039097 recv.2: Minor fixes
Fix some formatting typos
 * the period should be in Roman font
 * .RP does not exist, it should be .RB

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:24 +02:00
Nicolas Franois 073161a3f0 mount.2: Minor fixes
There was too many verbs in the last part of the sentence.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:24 +02:00
Nicolas Franois ced55c9139 mbind.2: Minor fixes
there should be no commas here.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Nicolas Franois 2c1c0a319a get_thread_area.2: Minor fixes
get_thread_area.2 is a system call.
Other manpages seems to differentiate functions (i.e. (g)lib(c) functions)
and system calls. This make it more consistent.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Nicolas Franois 5c03d6b181 get_mempolicy.2: Minor fixes
There should be no comma here.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Nicolas Franois f7bf69adcc getdents.2: Minor fixes
2 typos:
 * Wrong end of comments
 * etx3 should be ext3

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Nicolas Franois 5541fa5210 fcntl.2: Minor fixes
Just a formatting typo.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Nicolas Franois 8ce39f8681 clone.2: Minor fixes
"PID namespace" is what is new.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Nicolas Franois 5113b11a03 epoll_ctl.2: tfix: This patch fixes a formatting typo.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:21 +02:00
Michael Kerrisk 76a34baa39 mmap.2: Add brief documentation of MAP_HUGETLB
This flag is new in 2.6.32, and serves a similar
purpose to the shmget() SHM_HUGETLB flag.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:21 +02:00
Christoph Hellwig 015221eff8 open.2: add some comments on O_SYNC and friends
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:21 +02:00
Michael Kerrisk a38dc43a2d setpgid.2: Add an explanation of orphaned process groups
Reported-by: Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:20 +02:00
Michael Kerrisk 6b34fb3f5a execve.2, pipe.2, tee.2, fmemopen.3, mq_notify.3, qsort.3: Replace use of assert() by code that checks argc
See http://bugzilla.kernel.org/show_bug.cgi?id=13569

As noted by Andrey:
The purpose of the assert macro, defined in <assert.h>,
is to provide a tool to check for programming mistakes
or program logic errors. However, the assert macro must
never be used to perform checks for run time errors,
since, with the NDEBUG macro defined, expressions within
the assert macro invocations are not evaluated/checked
for, resulting in behavior that was not originally intended.
...
The pages affected in the core package are

execve(2)
pipe(2)
tee(2)
fmemopen(3)
mq_notify(3)
qsort(3)

Reported-by: Andrey Vihrov <vihrov@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:19 +02:00
Michael Kerrisk 3392d76d6f kill.2: wfix: add missing word to NOTES
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=543686.

Reported-by: Marc Lehmann <debian-reportbug@plan9.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:19 +02: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
Mark Hills 52520fb570 splice.2, tee.2, vmsplice.2: Fix return type
Since glibc 2.7, the return type for these functions
is ssize_t (formerly it was long).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:18 +02:00
Michael Kerrisk 8749bd1a31 umount.2: glibc only exposes MNT_DETACH and MNT_EXPIRE since version 2.11
See http://sourceware.org/bugzilla/show_bug.cgi?id=10092

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-03 06:07:57 +02:00
Michael Kerrisk 835c57e9cc umount.2: glibc only exposes MNT_DETACH and MNT_EXPIRE since version 2.11
See http://sourceware.org/bugzilla/show_bug.cgi?id=10092

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-03 06:06:54 +02:00
Michael Kerrisk 6f6a9bc76e getrusage.2: ru_inblock and ru_oublock are now implemented
These fields of the rusage structure are filled in since
Linux 2.6.22.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-08-25 11:00:44 +02:00
Michael Kerrisk 0f7654e417 sigaction.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-25 08:45:44 +02:00
Michael Kerrisk 6da336d7fe fcntl.2: The kernel source file mandatory.txt is now mandatory-locking.txt
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-25 08:30:59 +02:00
Michael Kerrisk de544d7faf fcntl.2, flock.2: The Documentation/* files are now in Documentation/filesystems
Reported-by: Tolga Dalman <tdalman@project-psi.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-25 08:30:51 +02:00
Michael Kerrisk f62a64aa05 flock.2: Remove unneeded reference to Documentation/mandatory.txt
Mandatory locks are only implemented by fcntl() locking

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-25 07:22:37 +02:00
Michael Kerrisk 8722311bc5 clone.2: Fix version number for CLONE_NEWIPC
It's 2.6.19, not 2.4.19.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-18 06:16:12 +02:00
Michael Kerrisk 6909213aa5 getdents.2: The d_type field is fully supported on Btrfs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-04 15:04:43 +02:00
Michael Kerrisk 21d995a882 mount.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-26 14:48:14 +02:00
Michael Kerrisk 02a4e226a6 mount.2: Document MS_STRICTATIME, update description of MS_RELATIME
Starting with Linux 2.6.30, the MS_RELATIME behavior became
the default, and MS_STRICTATIME is required to obtain the
traditional semantics.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-26 14:36:28 +02:00
Michael Kerrisk 577f9b624b clone.2: Rewrite crufty text about number of args in older version of clone()
Some bit rot had crept in regarding the discussion of the
    number of arguments in older versions of this syscall.
    Simplify the text to just say that Linux 2.4 and earlier
    didn't have ptid, tls, and ctid arguments.

    See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533868

    Reported-by: Shachar Shemesh <shachar@debian.org>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-21 15:30:21 +02:00
Michael Kerrisk d3dbc9b11a clone.2: Fix errors in argument names in text (ptid, ctd)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-21 15:14:28 +02:00
sobtwmxt bd16963cbe vfork.2: tfix: s/exit(2)/_exit(2)/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-21 14:38:05 +02:00
Michael Kerrisk 45f2d4eb13 sigaction.2: EWxpand description of si_utime and si_stime fields of siginfo_t
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-09 06:01:59 +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 0877a26bbe syscalls.2: Ad preadv() and pwritev(), new in kernel 2.6.30
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-05-06 16:43:44 +12:00
Jeff Moyer cb6a78e664 fork.2: Document fork() behaviour for the Linux native AIO io_context
It was noted on lkml that the fork behaviour is documented
for the POSIX AIO calls, but not for the Linux native calls.
Here is a patch which adds a small blurb that folks will
hopefully find useful.

Upon fork(), the child process does not inherit the
io_context_t data structures returned by io_setup,
and thus cannot submit further asynchronous I/O or
reap event completions for said contexts.

Signed-off-by: Jeff Moyer <jmoyer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-28 16:53:42 +12:00
Michael Kerrisk 6ebde978ef epoll_ctl.2: ffix 2009-04-27 15:26:19 +12:00
Gokdeniz Karadag 73ac11ee65 wait.2: Document CLD_DUMPED and CLD_TRAPPED si_code values
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 16:43:46 +12:00
Michael Kerrisk 94ea1e9d16 stat.2: Improve wording of ENOTDIR error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 14:57:42 +12:00
Michael Kerrisk 5cf0b3b40e stat.2: wfix
Reported-by: Tolga Dalman <tdalman@project-psi.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 14:53:07 +12:00
Mike Frysinger 472e8c79c3 sigpending.2: tfix + wfix
Reported-by: Christopher Head <chead@telus.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 14:40:41 +12:00
Mike Frysinger c62e7abad4 execve.2: Remove erroneous statement that pending signal set is cleared on execve(2)
Reported-by: Christopher Head <chead@telus.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 14:35:39 +12:00
Michael Kerrisk 3d81b96737 rename.2: Make ENOENT description consistent with POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-30 15:19:48 +13:00
Michael Kerrisk 94cffcd707 ptrace.2: Note use of 'data' for PTRACE_SYS{CALL,EMU} and PTRCAE_*_SINGLESTEP
These operations use the 'data' argument as a signal number,
like PTRACE_CONT.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Reported-by: Roland McGrath <roland@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-30 13:32:37 +13:00
Mike Frysinger c71df6fba0 ptrace.2: only reference <sys/user.h>
The kernel no longer installs linux/user.h, so update
references to sys/user.h.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-30 09:30:23 +13:00
Michael Kerrisk bd314baf09 getcontext.2: Note that POSIX.1-2008 removes the specification of getcontext()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:07:54 +13:00
Michael Kerrisk b822e47c52 getitimer.2: Note that POSIX.1-2008 recommends POSIX timers API instead of this API
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:57 +13:00
Michael Kerrisk 3f372391ea gettimeofday.2: Note that POSIX.1-2008 recommends clock_gettime() instead of this API
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-15 08:04:46 +13:00
Michael Kerrisk ff6db39993 fallocate.2: VERSIONS: glibc support is provided since version 2.10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-13 07:20:09 +13:00
Michael Kerrisk 7c1f78d417 fallocate.2: srcfix: Update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-12 15:03:32 +13:00
Michael Kerrisk 86d95cf2dc timerfd_create.2: ERRORS: add EINVAL for invalid 'flags' for timer_settime()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-10 16:36:34 +13:00
Michael Kerrisk c71b054dbc timerfd_create.2: Minor logical restructuring of ERRORS text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-10 16:31:09 +13:00
Michael Kerrisk f9fb3ffcb5 recv.2: Add 'iovec' defn to defn of 'msghdr' structure
The 'msghdr' structure includes a field of type 'iovec',
so show the definition of that structure in this page.

Reported-by: Johannes Stezenbach <js@sig21.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-10 11:02:58 +13:00
Michael Kerrisk 7a5097a15c truncate.2: srcfix: spfix 2009-03-08 13:35:19 +13:00
Michael Kerrisk 3ca7341fc9 truncate.2: SYNOPSIS: Fix description of feature test macro requirements
After a report by Arvid Norlander.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-08 13:35:18 +13:00
Michael Kerrisk 702cbe158e timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, numa.7: Make source layout of 'Link with' text consistent with other pages
No actual change to formatted output, but this makes the
page sources more consistent for the purpose of grepping, etc.

Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 07:50:06 +13:00
Michael Kerrisk 4ed3353db2 get_mempolicy.2, mbind.2, set_mempolicy.2: grfix
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 07:49:59 +13:00
Michael Kerrisk 86426e0be4 accept.2, read.2, recv.2, send.2, write.2: Fix discussion of EAGAIN/EWOULDBLOCK errors
For a non-blocking socket, POSIX.1-2001/2008 allow either
EAGAIN or EWOULDBLOCK to be returned in cases where a call
would have blocked.  Although these constants are defined
with the same value on most Linux architectures (PA-RISC
is the exception), POSIX.1 does not require them to have
the same value.  Therefore, a portable application using
the sockets API should test for both errors when checking
this case.

(NB POSIX.1 only mentions EWOULDBLOCK in the context of
the sockets interfaces.)

Change made after a note cross-posted on linux-arch@vger,
http://thread.gmane.org/gmane.linux.debian.ports.hppa/5615
and a suggestion for write(2) from Carlos O'Donell

Reported-by: Carlos O'Donell <carlos@systemhalted.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 20:31:52 +13:00
Michael Kerrisk 962939dd7e fcntl.2: Remove mention of EWOULDBLOCK from discussion of mandatory locking
In the kernel, the error on encountering a mandatory lock is
EAGAIN.  Although EAGAIN and EWOULDBLOCK are the same on
most Linux architectures, on some they are not, so don't
mention EWOULDBLOCK as it is misleading.  (Mea culpa.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 17:21:00 +13:00
Michael Kerrisk 8e415e6187 shmop.2: srcfix: fix kernel version number in FIXME 2009-02-21 14:07:56 +13:00
Mark Hills 28081592c7 splice.2: ERRORS: Add EINVAL case for file opened O_APPEND
Target file cannot be opened in append (O_APPEND) mode

In kernels prior to v2.6.27 splice() to a file in append mode is broken,
and since that version it is disallowed. It is possible this behaviour
may change in the future; see the kernel commit message
(efc968d450e013049a662d22727cf132618dcb2f) for more information.

Signed-off-by: Mark Hills <mark@pogo.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:31 +13:00
Parag Warudkar 6dd57cb443 vm86.2: CONFORMING TO: Add 32-bit specific
Note that this call is only on *32-bit* Intel

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:30 +13:00
Michael Kerrisk d08919a375 timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2: Reviewed by Peter Zijlstra
Reviewed-by: Peter Zijlstra <a.p.zijlstra@chello.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:29 +13:00
Kir Kolyshkin baf17bc4f2 Trivial punctuation fixes in SEE ALSO
In SEE ALSO, when a few man pages are referenced, those are divided by commas.
Every reference is on a separate line, and all lines but the last one should
end with comma. I spotted one place where there is no comma in between
references, and mocked up an awk script to find similar places:

for f in man*/*; do awk '/^.SH ["]SEE ALSO["]/ {sa=1; print "== " FILENAME " =="; print; next } /^\.(PP|SH)/ {sa=0; no=0; next} /^\.BR/ { if (sa==1) { print; if (no == 1) print "Missing comma in " FILENAME " +" FNR-1; no=0 } } /^\.BR .*)$/ { if (sa==1) no=1; next } /\.\\"/ {next} /.*/ { if (sa==1) { print; next }}' $f; done | fgrep 'Missing comma'

This patch fixes all the places found by the above script.

Also, there is an extra dot at the end of uri.7 "SEE ALSO" section.
Removed as per man-pages(7) recommendation.

Signed-off-by: Kir Kolyshkin <kir@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:29 +13:00
Michael Kerrisk d34ba634d1 timer_getoverrun.2, timer_settime.2: Add EXAMPLES section referring to example in timer_create(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-20 19:52:29 +13:00
Michael Kerrisk 02539b88ba timer_create.2: Minor change to example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 21:41:59 +13:00
Michael Kerrisk a31a4d2918 timer_create.2: Fix small bug in example
Reported-by: Peter Zijlstra <a.p.zijlstra@chello.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 21:41:04 +13:00
Michael Kerrisk 826ed36b7e select_tut.2: minor: fix small bug in example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 19:26:37 +13:00
Michael Kerrisk 75362965dd syscalls.2: Note that getpmsg(2) and putmsg(2) are unimplemented
See See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771

Reported-by: Sami Liedes <sliedes@cc.hut.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 17:37:36 +13:00
Michael Kerrisk 8699ebd957 getitimer.2, clock_getcpuclockid.3, time.7: SEE ALSO: add timer_create(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 14:42:17 +13:00
Michael Kerrisk 527d64f841 timer_delete.2: New page documenting timer_delete(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 13:37:22 +13:00
Michael Kerrisk c6f51a127e timer_getoverrun.2: New page documenting timer_getoverrun(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 13:37:07 +13:00
Michael Kerrisk 167f7e62e1 timer_gettime.2: New link to new tiemr_settime.2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 13:36:47 +13:00
Michael Kerrisk d268951f33 timer_settime.2: New page documenting timer_settime(2) and timer_gettime(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 13:35:46 +13:00
Michael Kerrisk 944f8a69c0 timer_create.2: New page documenting timer_create(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 13:35:25 +13:00
Michael Kerrisk b8fb88249b getitimer.2: Rename arguments for consistency with other timer pages
Also some other minor wording improvements

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 12:37:42 +13:00
Michael Kerrisk d6a54d42ba timerfd_create.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 12:36:54 +13:00
Michael Kerrisk 2bbb390720 timerfd_create.2: ERRORS: add EFAULT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 12:36:28 +13:00
Michael Kerrisk 5c9025973e timerfd_create.2: Rename timerfd_settime() 'curr_value' arg to 'old_value'
For consistency with related pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-10 12:35:13 +13:00
Michael Kerrisk f09cbcf3f0 Removed trailing white space at end of lines 2009-02-09 15:12:23 +13:00
Michael Kerrisk 874f7568f3 timerfd_create.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 15:03:53 +13:00
Michael Kerrisk eb9bcd8678 eventfd.2: srcfix: Remove out-of-date FIXME 2009-02-09 12:32:01 +13:00
Michael Kerrisk 0eb443910b clock_nanosleep.2, getrusage.2, timerfd_create.2, clock.3, clock_getcpuclockid.3, ftime.3, pthread_create.3, pthread_getcpuclockid.3, pthread_tryjoin_np.3, sem_wait.3, time.7: Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk 58ebb7ec73 clock_gettime.2, clock_settime.2, clock_gettime.3, clock_settime.3: Update links to reflect the fact that clock_* pages are now in Section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk 8c7e5701a0 clock_getres.2: Update .TH line to reflect move to Section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk 9bdcdd5e27 clock_getres.2: Move page from Section 3 to Section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:32:00 +13:00
Michael Kerrisk cc22d4c064 clock_getres.2: Remove, in preparation for moving clock_*.3 pages to Section 2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:31:53 +13:00
Michael Kerrisk 804f03e657 clock_nanosleep.2, execve.2, fork.2, nanosleep.2, sigaction.2, timerfd_create.2, pthread_getcpuclockid.3, ualarm.3, usleep.3, pthreads.7, time.7: Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
The POSIX timers API is implemented (mostly) within the kernel,
so thse interfaces are system calls.  Although there are as yet
no man pages, when they are added they should be in Section 2,
not 3.  Therefore fix those pages that currently refer to these
interfaces as being in Section 3.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:29:10 +13:00
Michael Kerrisk 6f8303a95a timerfd_create.2: Add BUGS noting that timerfd supports fewer clock types than timer_create()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:29:04 +13:00
Mike Frysinger e1fbfba539 epoll_create.2: wfix: s/flags/size/
Reported-by: Christopher Head <chead@telus.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-09 12:29:03 +13:00
Michael Kerrisk d0e95dbcd1 shmop.2: srcfix: added FIXME 2009-02-03 23:08:05 +13:00
Michael Kerrisk 9fa3ad83b3 fork.2: SEE ALSO: add daemon(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-03 10:05:09 +13:00
Michael Kerrisk 66bbce0015 eventfd.2: glibc eventfd() supports the use of eventfd2() since version 2.9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 06:05:56 +01:00
Andi Kleen 065c543677 capget.2: Add some details and relocate a paragraph
While writing a little program using capset
I found the capset manpage quite light on crucial
details and I had to resort to RTFS.

This patch improves the points I found unclear
and also moves one misplaced paragraph around.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 01:42:01 +01:00
Michael Kerrisk 7ce9ffda47 select_tut.2: Many parts tidied and rewritten
Remove some redundant text, clarify various pieces,
tidy example code, etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 01:20:55 +01:00
Michael Kerrisk b0cac4c7aa select_tut.2: Bug fixes + rewrites in example program
Sebastien pointed out that the first example program
wrongly thinks it can count signals.
Also, some further rewrites by mtk.

Reported-by: Sebastian Kienzl <seb@riot.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-27 01:20:37 +01:00
Michael Kerrisk 0e888d6adb select_tut.2: Clean up error checking in example program (no semantic changes)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-24 23:34:23 +01:00
Michael Kerrisk 6197b465ef getdents.2: Remove unneeded HAVE_D_TYPE from example program
Since d_type will always just return DT_UNKNOWN before
kernel 2.6.4, we don't need to use a conditional for
determining whether we use this flag.

Reported-by: Bastien ROUCARIES <roucaries.bastien@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 20:56:50 +01:00
Michael Kerrisk 14adeb6d28 stat.2: Note that open(O_NOATIME) also cause st_atime not to be updated
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 20:53:44 +01:00
Michael Kerrisk 56d2079da7 ioprio_set.2: srcfix 2009-01-20 15:14:57 +13:00
Michael Kerrisk 523c1b2c03 socket.2: BUGS: Remove discussion SOCK_UUCP
As time goes on, this sentence becomes less a piece of humor,
and more a puzzle.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-19 22:25:34 +13:00
Michael Kerrisk 762c2446e8 nanosleep.2: Relocated misplaced BUGS heading
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-19 22:15:09 +13:00
Michael Kerrisk f7d1749738 syscalls.2: Minor: update kernel version number in DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-19 17:49:38 +13:00
Michael Kerrisk 74ee79b977 Removed trailing white space at end of lines 2009-01-19 17:12:10 +13:00
Michael Kerrisk 52c385c592 getdents.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-18 14:48:06 +13:00