Commit Graph

11914 Commits

Author SHA1 Message Date
Manuel López-Ibáñez 285d20e353 pow.3: Add note on performance characteristics of pow()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 13:56:34 +01:00
David Wragg a7bd3dab97 cmsg.3: ensure buf is suitably aligned in sending example
Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
the suggested definition in RFC3542) shows that it yields the
msg_control field.  So when sending, the pointer placed in
msg_control should be suitably aligned as a struct cmsghdr.
In the sending example, buf was declared as a bare char array,
and so is not necessarily suitably aligned.

The solution here involves placing buf inside a union, and is
based on the sockets/scm_rights_send.c sample from The Linux
Programming Interface "dist" source code collection.

Signed-off-by: David Wragg <david@wragg.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 10:01:59 +01:00
Michael Kerrisk e0f1f1765b posix_fadvise.2: ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
Reported-by: Weijie Yang <weijie.yang.kh@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 09:32:53 +01:00
Mike Frysinger 445d38c9b5 user_namespaces(7): tfix: drop spurious underline
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 06:39:06 +01:00
Heinrich Schuchardt 943c52b7bb fanotify.7: Allow relative paths in example
The current example code requires passing an absolute
path to the mount to be watched.

By passing AT_FDCWD to fanotify_mark it can use both
absolute and relative paths.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 06:38:27 +01:00
Heinrich Schuchardt 8e38f6d391 fanotify.7: wfix
Removed duplicate "using".

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 06:36:36 +01:00
Adam Jiang 59ab8fcf0f sched_setscheduler.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-11 06:16:39 +01:00
Michael Kerrisk 001fed0312 epoll_ctl.2: Regular files and directories can't be monitored with epoll_ctl()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-10 14:00:25 +01:00
Michael Kerrisk f285a958f3 clock_nanosleep.2: Note that 'clock_id' can also be a CPU clock ID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-10 13:25:30 +01:00
Michael Kerrisk e125c3e172 timerfd_create.2: srcfix: added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-10 11:56:49 +01:00
Michael Kerrisk 3e35b19b10 unix.7: Fix buglet in code snippet in BUGS section
Reported-by: Scott Harvey <scott.harvey@stonybrook.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 21:15:56 +01:00
Heinrich Schuchardt b7670bdd0d ioctl.2: Rename 'd' argument to 'fd' in text
In most other manpages file descriptors are called 'fd'.
This patches renames attribute 'd' to 'fd'.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 21:11:52 +01:00
Michael Kerrisk c7383f92d4 proc.5: srcfix: Note commit that introduced /proc/thread-self
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 20:29:43 +01:00
Bernhard Walle 0ad6ad9c0c proc.5: Document /proc/thread-self
/proc/thread-self has been introduced in Linux 3.17 with
commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.

Signed-off-by: Bernhard Walle <bernhard@bwalle.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 20:25:39 +01:00
Michael Kerrisk 34fcd227fb abort.3: Note that SIGABRT is raised as though raise(3) is called
Also note that abort is POSIX.1-2008 compliant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 19:52:34 +01:00
Mike Frysinger f7611a00f6 namespaces(7): minor tweaks
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 14:27:47 +01:00
Michael Kerrisk d74f805937 mq_open.3: Document the O_CLOEXEC flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:49:54 +01:00
Michael Kerrisk 8d121cc5c1 mq_open.3: Place 'flags' constants in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:37:10 +01:00
Michael Kerrisk ee56674428 proc.5: tfix
Reported-by: Huxiaoxiang <huxiaoxiang@huawei.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:24:10 +01:00
Michael Kerrisk 464b254bb8 unix.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 06:13:13 +01:00
Michael Kerrisk 5bc20f9e79 syscalls.2: SEE ALSO: add errno(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-04 08:20:07 +01:00
Michael Kerrisk 4e0b8e82c7 syscall.2: SEE ALSO: add errno(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-04 08:19:25 +01:00
Michael Kerrisk 1bcb7fdbb0 standards.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-31 07:25:54 +01:00
Michael Kerrisk 31e025bf45 tgamma.3: Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-31 07:25:54 +01:00
Michael Kerrisk 8ee4373d37 ilogb.3: Since glibc 2.16, ilogb() does correctly diagnore domain errors
Reported-by: Will Newton <will.newton@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-31 07:24:37 +01:00
Michael Kerrisk 0ba5517581 exp10.3: Before glibc 2.19, exp() did not give ERANGE error on underflow
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-30 19:08:26 +01:00
Marko Myllynen 73d11aabbb locale.5: Fix miscoded character
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 20:32:16 +01:00
Josh Triplett 4d300f4a48 sysconf.3: Document _SC_NGROUPS_MAX
Already documented in getgroups(2), but not in sysconf(3).

Signed-off-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:27:16 +01:00
Josh Triplett fadd2e6538 credentials.7: Cross-reference getgroups(2)
Since credentials.7 discusses supplementary GIDs, it should reference
getgroups(2).

Signed-off-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:26:24 +01:00
Michael Kerrisk 984bf8fc33 locale.5: Minor fixes to Marko Myllynnen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:23:15 +01:00
Marko Myllynen f809007b99 locale.5: Describe the formats of values
locale(5) describes what a locale should define but doesn't
spell out how (in what format). The patch attempts to address
this, it also has few trivial additional enhancements.

* Reference to locale(7) for category descriptions.
* Clarify first_workday in NOTES a bit.
* Add upstream BZ reference for two missing LC_ADDRESS fields.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:18:21 +01:00
Michael Kerrisk 476cab32c2 locale.7: Minor tweaks to Marko Myllynen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:11:44 +01:00
Marko Myllynen c5466970d7 locale.7: Improve LOCPATH description
LOCPATH is ignored by privileged programs.

Add locale archive references.

Add FILES section.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:06:42 +01:00
Marko Myllynen 3d49eaadf6 localedef.1: Mention default path for compiled files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:03:28 +01:00
刘湃 78e369ff57 pthread_setschedparam.3: Small fixes to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:02:47 +01:00
Florian Westphal ed8de0e44e proc.5: Document /proc/net/netfilter/nfnetlink_queue
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:55:29 +01:00
Jonathan Wakely d3acae5682 ld.so.8: Correct documentation of $ORIGIN
As noted by Siddhesh:

    The ld.so man page says:

        $ORIGIN (or equivalently ${ORIGIN})
            This expands to the directory containing the
            application executable.  Thus, an application located
            in somedir/app could be compiled with

    This is incorrect since it expands to the directory containing
    the DSO and not the application executable.  This seems like
    deliberate behaviour in dl-object.c, so it needs to be fixed in
    the man page.

See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226

Reported-by: Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:49:12 +01:00
Michael Kerrisk ea55bc7b3a prctl.2: PR_SET_NAME silently truncates strings that exceed 16 bytes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:26:23 +01:00
Andreas Schwab db6d60b30a prctl.2: Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
The size of the process name has always been at most 16 byte
_including_ the null terminator.  This also means that the
name returned by PR_GET_NAME is always null-terminated.

Signed-off-by: Andreas Schwab <schwab@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:22:55 +01:00
Mike Frysinger 891121f60e pid_namespaces(7): Minor grammar tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:15:27 +01:00
Michael Gehring 4cd11c5594 process_vm_readv.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:14:17 +01:00
Michael Kerrisk c5a000246c fanotify.7: Tweaks to Heinrich Schuchard's patch on mount paths
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Heinrich Schuchardt a4b394f246 fanotify.7: fanotify notifies only events generated on the same mount
Unfortunately, fanotify does not inform listeners for all paths
under which a touched filesystem object is visible, but only the
listener using the same path as the process touching the
filesystem object.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Heinrich Schuchardt e75c6d07ff inotify.7: fallocate(2) does not trigger inotify events
Calling fallocate(2) does not result in inotify events.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Heinrich Schuchardt 9ee7cc4faa fanotify.7: fallocate(2) creates no events
fallocate(2) should create FAN_MODIFY events but does not.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Heinrich Schuchardt d5b26a6978 fanotify.7: Update BUGS to note bugs still not fixed in 3.17
I bumped the Linux version number in the BUGS section to 3.17.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Michael Kerrisk f7d11fdac6 tee.2: Add shell session demonstrating use of the example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Michael Kerrisk ced56703cb vmsplice.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Michael Kerrisk 2377c64851 splice.2: Reformat description of 'fd_in' and 'off_in' to improve readability
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:24 +01:00
Michael Kerrisk 9c11e37c8f sched_setaffinity.2: NOTES: Add paragraph on how to discover set of CPUs available on system
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:23 +01:00