Commit Graph

3523 Commits

Author SHA1 Message Date
Michael Kerrisk f30b741526 chown.2, clone.2, mmap.2, pipe.2, ftw.3, mq_notify.3: Add "Program source" subheading under EXAMPLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:30:41 +13:00
Michael Kerrisk 22617a74a7 mprotect.2: Add "static" to global variable in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:30:35 +13:00
Michael Kerrisk 571767ca38 perf_event_open.2: Add "static" qualifier to function in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 13:12:32 +13:00
Michael Kerrisk 9a141bfb1f get_mempolicy.2, mbind.2, mlock.2, set_mempolicy.2, bootparam.7, packet.7: grfix: s/memory mapped/memory-mapped/ when used attributively
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-05 11:00:31 +13:00
Michael Kerrisk b437fdd90a epoll_ctl.2, execve.2, recv.2, timer_create.2, wait.2, argz_add.3, basename.3, dlopen.3, exec.3, fopencookie.3, fts.3, getaddrinfo.3, getcwd.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getlogin.3, getnetent.3, getprotoent.3, getrpcent.3, getservent.3, getusershell.3, glob.3, if_nameindex.3, inet_ntop.3, lio_listio.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mq_notify.3, ptsname.3, realpath.3, setnetgrent.3, sigvec.3, strsignal.3, strtok.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, xdr.3: Global fix of "NULL pointer"
Change "NULL pointer: to "NUL " or null pointer".
POSIX uses the term "null pointer", not "NULL pointer".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:06 +13:00
Michael Kerrisk 7d182bb660 perf_event_open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 15:47:05 +13:00
Michael Kerrisk 314ef95df4 prctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:26:45 +13:00
Michael Kerrisk 4651e41294 perf_event_open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:19:25 +13:00
Michael Kerrisk 850905cf88 clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:13:23 +13:00
Michael Kerrisk 9e802a1f57 spu_create.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-03 10:08:16 +13:00
Mike Frysinger a9deb5e056 ptrace.2: tfix userspace->user space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Mike Frysinger 951ae9c063 syscall.2, syscalls.2, getauxval.3: Add references to new vdso(7) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 10850212d0 uselib.2, getfsent.3, regex.3, nsswitch.conf.5, inotify.7, man-pages.7, symlink.7: Replace uses of "e.g." in main text with "for example" or similar
Usual man-pages style is to use "e.g." only within
    parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 88879aebdd eventfd.2, set_mempolicy.2, timerfd_create.2, fwide.3, resolver.3, spufs.7, symlink.7, udplite.7, unicode.7: Replace uses of "i.e.," in main text with "that is" or similar
Usual man-pages style is to use "i.e." only within
parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk d332f86f5a socket.2: Remove crufty statement that AF_INET does not support SOCK_SEQPACKET
Linux AF_INET supports SOCK_SEQPACKET via SCTP.

Reported-by: Dongsheng Song <dongsheng.song@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:16 +13:00
Michael Kerrisk 445319fd4a close.2: Note that errors from close() should be used only for diagnosis
In particular, retrying after EINTR is a bad idea.

See http://austingroupbugs.net/view.php?id=529

See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
         when interrupted in signal.

Reported-by: P?draig Brady <P@draigBrady.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk aefd6f899d select_tut.2, dlopen.3, err.3, printf.3: Stylistic changes to code example
For ease of reading, don't embed assignments inside if().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 17068fad8c utimensat.2: Small wording improvement for times!=NULL case
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 79e20ac183 utimensat.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Mike Frysinger 5e16419235 syscall.2: Fix ia64 registers
The original list of registers was created by confusing strace
source code--this is for parsing legacy 32-bit code (which is
dead and no one cares). Update the list to reflect native ia64
syscall interface.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 4cead6db49 reboot.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 3b95429be2 reboot.2: Add RB_SW_SUSPEND synonym
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk d1d5d51c06 reboot.2: Add RB_KEXEC synonym
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Elie De Brauwer 2d37a9603b reboot.2: Document LINUX_REBOOT_SW_SUSPEND
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Elie De Brauwer 0b23bb07a3 reboot.2: Add "Linux" to kernel version numbers
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Elie De Brauwer c2e32bfe27 reboot.2: Mention RB_POWER_OFF
The manpage did not mention RB_POWER_OFF which is the glibc
symbolic name for LINUX_REBOOT_CMD_POWER_OFF.

$ cd /usr/include
$ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF
 define RB_POWER_OFF	0x4321fedc

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
Michael Kerrisk 2fd2c35cc6 clock_getres.2: Improve description of CLOCK_PROCESS_CPUTIME_ID
See https://bugzilla.kernel.org/show_bug.cgi?id=67291

Reported-by:  Nadav Har'El <nyh@math.technion.ac.il>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:15 +13:00
David Prévot cd7c700a16 perf_event_open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
Michael Kerrisk 7607f23546 perf_event_open.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:14 +13:00
Vince Weaver 406650db6b perf_event_open.2: Clarify issues with the disabled bit
Clarify the perf_event_open behavior with respect to the disabled
bit and creating event groups.

Reported-by: Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-02 11:49:08 +13:00
Vince Weaver bea10c8c40 perf_event_open.2. Clarify issues with the exclusive bit
Warn that using the perf_event_open "exclusive" bit, while it might seem
like a good idea, might lead to all 0 results in some common usage cases.

Reported-by: Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-27 07:31:46 +13:00
Michael Kerrisk b8efc3ed61 Removed trailing white space at end of lines 2013-12-12 20:42:43 +13:00
Michael Kerrisk 42f05d6438 futex.2, send.2, setreuid.2, malloc.3, tcp.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 20:40:15 +13:00
Michael Kerrisk f2d15dc910 perf_event_open.2: ffix + tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:45:03 +13:00
Vince Weaver 75ee11e514 perf_event_open.2: Update description for mmap_data bit
Here's an updated version of [David Ahern's] patch that
expands the "mmap" definition as well as that of "mmap_data".
Also some manpage related formatting improvements from the
original patch.

Link: https://lkml.org/lkml/2013/11/11/505

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Acked-by: David Ahern <dsahern@gmail.com>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:42:03 +13:00
Vince Weaver a02a1737af perf_event_open.2: cpu/pid argument cleanup
This patch attempts to clarify the pid and cpu options to
perf_event_open().

It does two things:
  1.  Tries to make clear that the "pid" argument can mean
      process *or* thread.  This is made confusing by
      how Linux uses the terms mostly interchangeably.
  2.  The cpu/pid documentation was confusing because of
      how the parameters are interdependent.  Since there
      are only 6 possible combinations I broke out the
      possibilities into a table.

Reported-by: Manuel Selva <selva.manuel@gmail.com>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:41:47 +13:00
Michael Kerrisk 7af75ade78 sigpending.2: Note treatment of signals that are blocked *and* ignored
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
Michael Kerrisk 827edbd201 stat.2: wspfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
Trevor Bramwell 25505615fe pipe.2: Fix error in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
David Prévot 7205b8dfd8 perf_event_open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
David Prévot 8859d3a9e2 perf_event_open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
David Prévot 27f52b5209 perf_event_open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
Michael Kerrisk 6add864cd4 kcmp.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
Shawn Landden df2f284e48 kcmp.3: Reword slightly awkward section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
Peng Haitao 6ab6b8e2f9 capget.2: wfix
Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:07 +13:00
Michael Kerrisk 210cded680 poll.2: Clarify meaning of events==0
events==0 does not mean that revents is always returned as
zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
can still be returned.

See https://bugzilla.kernel.org/show_bug.cgi?id=61911

Reported-by: Paolo Bonzini <bonzini@gnu.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 07:13:19 +13:00
Michael Kerrisk 82f955d28a ioctl.2: 'request' argument is typed as 'unsigned long' in glibc
See https://bugzilla.kernel.org/show_bug.cgi?id=42705

Reported-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Reported-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 06:43:47 +13:00
Michael Kerrisk e9bd9b2ca9 perf_event_open.2: tstamp + white space fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 06:43:46 +13:00
Vince Weaver 135cba8b70 perf_event_open.2: Linux 3.12 rdpmc/mmap
It turns out that the perf_event mmap page rdpmc/time setting was
broken, dating back to the introduction of the feature.  Due
to a mistake with a bitfield, two different values mapped to
the same feature bit.

A new somewhat backwards compatible interface was introduced
in Linux 3.12.  A much longer report on the issue can be found
here:
   https://lwn.net/Articles/567894/

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 06:43:46 +13:00
Vince Weaver a0dcc8dd16 perf_event_open.2: Linux 3.12 adds PERF_EVENT_IOC_ID
A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
in Linux 3.12.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-11-08 06:43:46 +13:00