Commit Graph

18612 Commits

Author SHA1 Message Date
Michael Kerrisk 74f254908f mmap.2: SEE ALSO: add ftruncate(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-31 08:24:13 +01:00
Michael Kerrisk c19250adee mmap.2: Add explicit text noting that 'length' must be greater than 0
Currently, this detail is hidden in ERRORS. Make it clear in
the main text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-31 08:21:43 +01:00
Michael Kerrisk 5f70d096ae stdio.3: Remove crufty reference to pc(1)
I'm not sure what compiler is referred to by "pc(1)",
but "dnf whatprovides" and web searches turn up no
mention of a compiler by that name.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-29 13:23:55 +01:00
Michael Kerrisk 3242546c6e stdio.3: Use proper section cross references in function list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-29 13:23:55 +01:00
Michael Kerrisk dc4674ac40 core.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 21:20:20 +02:00
Michael Kerrisk 404fb8d3fe mq_overview.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 17:41:42 +02:00
G. Branden Robinson 9ab7f611ed Replace Latin abbreviation "cf.".
People seem to be using "cf." ("confere"), which means "compare",
to mean "see" instead, for which the Latin abbreviation would be
"q.v." ("quod vide" -> "which see").

In some cases "cf." might actually be the correct term but it's
still not clear what specific aspects of a function/system call
one is supposed to be comparing.

I left one use in place in hope of obtaining clarification,
because it looks like it might be useful there, if contextualized.

Migrate these uses to English and add them to the list of
abbreviations to be avoided.

If the patch to vfork(2) is not accepted, then the cf. still needs
an \& after it because it is at the end of the line but not the
end of a sentence.

Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 17:39:33 +02:00
Michael Kerrisk 47d0313853 pid_namespaces.7: tfix + srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:43:45 +02:00
Michael Kerrisk 8eb13afb83 proc.5: Add reference to pid_namespaces(7) for /proc/sys/kernel/ns_last_pid
Add reference to pid_namespaces(7) for the description of
/proc/sys/kernel/ns_last_pid.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:30:12 +02:00
Michael Kerrisk 10bd75534e pid_namespaces.7: Document /proc/sys/kernel/ns_last_pid
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:27:58 +02:00
G. Branden Robinson e789e07cb1 man-pages.7: Add a use case for real minus character
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:44:52 +02:00
G. Branden Robinson 679f40d6a5 hier.7: tfix
Escape hyphen in man page cross reference.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:43:57 +02:00
G. Branden Robinson b3f480154d ipv6.7: tfix
Use correct indefinite article before noun beginning with vowel sound.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:43:39 +02:00
G. Branden Robinson 9b13f7700e connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix
Fix nonstandard usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:41:59 +02:00
G. Branden Robinson fedb2ff513 open.2: tfix
This one crept in during the first bit of the "will fail" -> "fails"
migration.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:34:09 +02:00
Michael Kerrisk 86683c22ca lp.4: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:49:27 +02:00
Michael Kerrisk e05f3710a2 lp.4: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:36:21 +02:00
Michael Kerrisk 37f343855c Changes: infnan.3 is removed
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:04:38 +02:00
Michael Kerrisk 84fe93c843 infnan.3: Remove page
This function was in libc4 and libc5, but never part
of glibc. It ceased to be relevant nearly 20 years
ago. Time to remove the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:04:30 +02:00
G. Branden Robinson 59524c5eb3 pthread_spin_init(3): tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 07:50:53 +02:00
Michael Kerrisk 26cd31fd4a access.2, delete_module.2, eventfd.2, fallocate.2, fcntl.2, getrandom.2, init_module.2, open.2, seccomp.2, timerfd_create.2, openpty.3, pthread_spin_lock.3, shm_open.3, tempnam.3, fifo.7, keyrings.7, pid_namespaces.7, sched.7, thread-keyring.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:55:10 +02:00
Michael Kerrisk cdcc4450a0 getrlimit.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:43:11 +02:00
Michael Kerrisk a23d8efafc capget.2, fanotify_init.2, fcntl.2, ioctl_tty.2, madvise.2, mbind.2, prctl.2, sched_setaffinity.2, hash.3, isgreater.3, posix_fallocate.3, sigvec.3, full.4, sd.4, wavelan.4, core.5, host.conf.5, epoll.7, signal.7, unix.7, user_namespaces.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:36:57 +02:00
Michael Kerrisk 6e2767983c reboot.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 12:28:54 +02:00
Michael Kerrisk 9e4be7e9fc open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 12:28:06 +02:00
Michael Kerrisk 5bc53d81f0 times.2: Language fix-up: clarify that "tasks" means "work"
See https://bugzilla.kernel.org/show_bug.cgi?id=197183

Reported-by: Victor Porton <porton@narod.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 11:05:34 +02:00
Michael Kerrisk 90c85e6189 times.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:56:53 +02:00
Michael Kerrisk 5d1efadb0b veth.4: SHow command used to move a veth device into another network namespace
Reported-by: Tomas Pospisek <tpo@sourcepole.ch>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:59 +02:00
Michael Kerrisk 334299e22f veth.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:59 +02:00
Michael Kerrisk 1eef07f09a namespaces.7: Add a reference to new veth(4) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk 6f34a82c42 clone.2: Add a reference to new veth(4) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk ee24ae59cf veth.4: Elaborate on use of ethtool(8) to find veth peer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk eab9cf18f8 veth.4: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk 9354c155a0 veth.4: Integrate content from Eric Biederman
Cowritten-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk 394eea352b veth.4: SEE ALSO: add ip-link(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Tomáš Pospíšek 1459db4abd veth.4: New page document veth virtual ethernet devices
Based on a page from Tomáš Pospíšek, with some clean-ups by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:22:58 +02:00
Michael Kerrisk b858495171 pthread_spin_init.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 5017fc28ec pthread_spin_init.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 28c15b63d6 pthread_spin_init.3: Add more caveats on use of spin locks
Cowritten-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 34d46b816e pthread_spin_init.3: Strengthen note about when spin locks should (not) be used
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 0e905edca8 pthread_spin_init.3: Operations on copies of *lock yield undefined behavior
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk eb93621d10 pthread_spin_init.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk af79528ece pthread_spin_lock.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 4eea22f5ae pthread_spin_lock.3: wfix
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 07fa47a568 pthread_spin_lock.3: Fixes suggested by Carlos O'Donell
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk f3861c72a9 pthread_spin_lock.3: Refer reader to important details in NOTES in pthread_spin_init(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 8cbd1d9e4d pthread_spin_init.3: Warn about deadlock with spin locks
Reported-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 2dea72418d pthread_spin_init.3: Spin locks should be used with real-time scheduling policies
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 41041696d3 pthread_yield.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 534af41391 pthreads.7: SEE ALSO: add pthread_spin_init(3) and pthread_spin_lock(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00