Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-3.42.tar.gz - man pages for Linux
Tarball download:
http://www.kernel.org/doc/man-pages/download.html
Git repository:
http://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
Online changelog:
http://man7.org/linux/man-pages/changelog.html#release_3.43
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2012/08/man-pages-342-is-released.html
The current version of the pages is browsable at:
http://man7.org/linux/man-pages/
You are receiving this message either because:
a) You contributed to the content of this release.
b) You are subscribed to linux-man@xxxxxxxxxxxxxxx.
c) I have information (possibly inaccurate) that you are the
maintainer of a translation of the manual pages, or are the maintainer
of the manual pages set in a particular distribution, or have
expressed interest in helping with man-pages maintenance, or have
otherwise expressed interest in being notified about man-pages
releases. If you don't want to receive such messages from me, or you
know of some other translator or maintainer who may want to receive
such notifications, send me a message.
Cheers,
Michael
==================== Changes in man-pages-3.42 ====================
Released: 2012-08-14, Konolfingen
Contributors
------------
The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
Aaron Peschel <aaron.peschel@xxxxxxxxx>
Adrian Dabrowski <atrox@xxxxxxxxxxxxxxxxxxx>
Akihiro MOTOKI <amotoki@xxxxxxxxx>
Alan Curry <pacman@xxxxxxxxxxxxx>
Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
Christoph Lameter <cl@xxxxxxxxx>
Colin McCabe <cmccabe@xxxxxxxxxxxxxx>
Daniel Zingaro <daniel.zingaro@xxxxxxxxxxx>
David Prévot <taffit@xxxxxxxxxx>
Denys Vlasenko <vda.linux@xxxxxxxxx>
Henry Hu <henry.hu.sh@xxxxxxxxx>
Herbert Xu <herbert@xxxxxxxxxxxxxxxxxxx>
Jan Engelhardt <jengelh@xxxxxxxxxx>
Jim Hill <gjthill@xxxxxxxxx>
JoonSoo Kim <js1304@xxxxxxxxx>
Kalle Olavi Niemitalo <kon@xxxxxx>
Martin H <textshell-tSIEzQ@xxxxxxxxxxxxxxxxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>
Michael S. Tsirkin <mst@xxxxxxxxxx>
Rasmus Villemoes <Rasmus.Villemoes@xxxxxxxxx>
Sami Kerola <kerolasa@xxxxxx>
Sam Varshavchik <mrsam@xxxxxxxxxxxxxxx>
Shawn Landden <shawnlandden@xxxxxxxxx>
Simon Paillard <spaillard@xxxxxxxxxx>
Tolga Dalman <tolga.dalman@xxxxxxxxxxxxxx>
Ulrich Drepper <drepper@xxxxxxxxx>
Марк Коренберг <socketpair@xxxxxxxxx>
Apologies if I missed anyone!
Global changes
--------------
Various pages
Sami Kerola
Global fix: use UR macro where applicable
The syntax .UR http://example.com paired with .UE will create
links which one can interact, if the pager allows that. One
way to see the effect is ask the man(1) command to use browser
display, e.g.:
man -H man7/uri.7
("\:" is optional groff syntax to permit hyphenless line breaks.)
Changes to individual pages
---------------------------
ldd.1
Michael Kerrisk
Add security note on untrusted executables
See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
and
http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
clone.2
Michael Kerrisk
Rewrite discussion of sys_clone
futex.2
Марк Коренберг
Consolidate error descriptions to ERRORS
Michael Kerrisk
Various wording fix-ups
Michael Kerrisk
Fix description of EINVAL error
The current text seems incorrect. Replace with a more general
description.
getdents.2
select_tut.2
atof.3
atoi.3
pthread_create.3
pthread_sigmask.3
rtime.3
setbuf.3
tsearch.3
netlink.7
Michael Kerrisk [Jan Engelhardt]
Remove unneeded casts
get_robust_list.2
get_thread_area.2
getcpu.2
getdents.2
gettid.2
io_cancel.2
io_destroy.2
io_getevents.2
io_setup.2
io_submit.2
ioprio_set.2
kexec_load.2
llseek.2
modify_ldt.2
mq_getsetattr.2
pivot_root.2
readdir.2
rt_sigqueueinfo.2
set_thread_area.2
sgetmask.2
spu_create.2
spu_run.2
subpage_prot.2
sysctl.2
tkill.2
Michael Kerrisk
Add note to SYNOPSIS that there is no glibc wrapper for system call
Reduce the chance that the reader may be misled into thinking
that there is a wrapper function for this system call by noting
explicitly in the SYNOPSIS that there is no glibc wrapper and
pointing the reader to NOTES for further details.
ioprio_set.2
Colin McCabe
Clarify the multithreaded behavior of ioprio_set(2)
Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
process group.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
migrate_pages.2
Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
Fix description of return value
mount.2
Michael Kerrisk
For MS_REMOUNT, source is ignored
mprotect.2
Michael Kerrisk [Rasmus Villemoes]
'addr' argument is not const
As reported by Rasmus:
Both my system's man-pages (3.22) and the latest online
(3.41) show:
int mprotect(const void *addr, size_t len, int prot);
as the prototype for mprotect(2). However, POSIX [1] and the
actual sys/mman.h (on all the systems I checked) do not have
the const qualifier on the first argument.
msgctl.2
semctl.2
shmctl.2
svipc.7
Michael Kerrisk
Don't mention that ipc_perm is defined in <sys/ipc.h>
There's no need to mention that the 'ipc_perm' structure
is defined in <sys/ipc.h>. That's an implementation detail,
and furthermore <sys/ipc.h> is itself included by the other
System V IPC header files. The current text might lead the
reader to conclude that they must include <sys/ipc.h>, which
is not the case (it is required neither on Linux, nor by the
standards).
msgctl.2
msgget.2
msgop.2
semctl.2
semget.2
semop.2
shmctl.2
shmget.2
Michael Kerrisk
NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
header files aren't required by Linux or the standards, but may
be needed for portability to old systems.
ptrace.2
Denys Vlasenko
Explain WNOHANG behavior and EINTR bug
I didn't like ithe "SIGKILL operates similarly, with exceptions"
phrase (if it's different, then it's not "similar", right?),
and now I got around to changing it. Now it says simply:
"SIGKILL does not generate signal-delivery-stop and therefore
the tracer can't suppress it."
Replaced "why WNOHANG is not reliable" example with a more
realistic one (the one which actually inspired to add this
information to man page in the first place): we got
ESRCH - process is gone! - but waitpid(WNOHANG) can still
confusingly return 0 "no processes to wait for".
Replaced "This means that unneeded trailing arguments may
be omitted" part with a much better recommendation
to never do that and to supply zero arguments instead.
(The part about "undocumentedness" of gcc behavior was bogus,
btw - deleted).
Expanded BUGS section with the explanation and an example
of visible strace behavior on the buggy syscalls which
exit with EINTR on ptrace attach. I hope this will lead
to people submitting better bug reports to lkml about
such syscalls.
seteuid.2
Michael Kerrisk
Note glibc version where setegid() implementation changed
In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
set_tid_address.2
Michael Kerrisk
Rename 'ctid' argument for consistency with clone(2) page
Michael Kerrisk
Some rewordings and minor clarifications
sigwaitinfo.2
Michael Kerrisk [Daniel Zingaro]
Some wording clarifications
Mainly rewording things like "is delivered" to "becomes pending",
which is more accurate terminology.
syscall.2
Michael Kerrisk
Add some more details to the description of syscall(2)
And add another example of using syscall() to the program example.
syscalls.2
Michael Kerrisk
Add kcmp(2)
Michael Kerrisk
Move discussion of set_zone_reclaim(2) out of main table
This system call was never visible to user space, so it makes
sense to move it out of the main table of system calls into
the notes below the table.
getifaddrs.3
Michael Kerrisk [Adrian Dabrowski]
Note that ifa_addr and ifa_netmask can be NULL
readdir.3
Michael Kerrisk [Jan Engelhardt]
Handle -1 error from pathconf() in example code snippet
Improve the example demonstrating allocation of a buffer
for readdir_r() to handle -1 error return from pathconf().
Otherwise, naive readers may think that pathconf() return
value can be used without checking.
realpath.3
Shawn Landden
Use past tense with ancient history (libc4, libc5)
regex.3
Michael Kerrisk
Correct SEE ALSO reference to glibc manual "regex" section
rtime.3
Michael Kerrisk [Jan Engelhardt]
Fix broken pointer cast in example code
sem_close.3
sem_destroy.3
sem_getvalue.3
sem_init.3
sem_open.3
sem_post.3
sem_unlink.3
sem_wait.3
sem_overview.7
Michael Kerrisk
Note that "cc -pthread" is required; "-lrt" no longer works
See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
sigwait.3
Michael Kerrisk
Reword "is delivered" to "becomes pending"
strcat.3
Michael Kerrisk
Add some text to emphasize the dangers of buffer overruns
Michael Kerrisk
NOTES: Add discussion of strlcat()
strcpy.3
Michael Kerrisk
Note that info is lost when strncpy() doesn't null terminate
Michael Kerrisk
Add some text to emphasize possibility of buffer runs with strcpy()
Michael Kerrisk
NOTES: Add a discussion of strlcpy()
Inspired by https://lwn.net/Articles/506530/
Michael Kerrisk
Fix description of the null-byte padding performed by strncpy()
tsearch.3
Michael Kerrisk
NOTES: remove redundant discussion of unorthodox use of term "postorder"
This point is already covered at greater length in the main
text of the page (See the piece "More commonly, ...").
Michael Kerrisk
Clarify use for first argument to the twalk() 'action' function
There's a number of details in POSIX that are omitted in
the current version of this page.
Michael Kerrisk
Some wording fixes
core.5
Michael Kerrisk
Note effect of madvise(2) MADV_DONTDUMP flag
capabilities.7
Michael Kerrisk
Document CAP_BLOCK_SUSPEND
glob.7
Bjarni Ingi Gislason
Change 8 bit characters to 7 bit representation
Fixes rendering errors for accented 'a' characters.
Michael Kerrisk [Aaron Peschel]
Update bash(1) command used to obtain classical globbing behavior
The man page formerly noted the bash(1) v1 command to do this.
iso_8859-1.7
Bjarni Ingi Gislason
Explanation of SOFT HYPHEN and the code for it
<groff: iso_8859-2.7>:89: warning: can't find special
character `shc'
This is the only "iso_8859-*.7" file that has this (now)
undefined character. The code in column four in "iso_8859-1.7" is
"0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
See Debian bug 156154 (or package "manpages").
There should be an explanation for this graphic character and the
code should be 0xAD in iso_8859-1.7 (as in all others), even
though "[gn]roff" does not display a "HYPHEN" in that position of
the table.
The line with "SOFT HYPHEN" gets a footnote and a short
explanation.
mdoc.7
Bjarni Ingi Gislason
Fixing a warning and a table
Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
<groff: mdoc.7>:294: warning:
tab character in unquoted macro argument
In one table the distance between columns is too small in the
"ps" output. (Bug in the groff "doc.tmac" macro?)
mdoc.samples.7
Bjarni Ingi Gislason
Fix warnings from [ng]roff, corrections
From "man -ww ..." (groff -ww ...):
<standard input>:541: warning:
tab character in unquoted macro argument
[+3 similar warnings]
<standard input>:813: warning: macro `Pu' not defined
Usage: .Rv -std in sections 2 and 3 only (#1669)
mdoc warning: A .Bl directive has no matching .El (#1821)
String "Pu" defined as a row of punctuation characters.
".Bl" and ".El" fixed.
Some arguments, that start with a period or are the name of a
macro, protected with "\&".
Variable name for macro ".Rv" corrected.
netdevice.7
Bjarni Ingi Gislason
Line in table too long
Fix warning from "man ..." ("nroff -ww ..."):
nroff: netdevice.7: warning: around line 98:
table wider than line width
Fix: No right adjustment in text blocks in tables.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
netlink.7
Bjarni Ingi Gislason
Line in table is too long
Fix warning from "man ..." ("nroff -ww ..."):
nroff: netlink.7: warning: around line 195:
table wider than line width
Horizontal line incorporated into table.
No right adjustment of text blocks in tables.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
Simon Paillard [Herbert Xu]
Change description of "*_pid" fields to "Port ID"
As reported by Herbert Xu, these should not be considered as PIDs.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
rtnetlink.7
Bjarni Ingi Gislason
Line in table too long
Fix warning from "man ..." ("nroff -ww ..."):
nroff: rtnetlink.7: warning: around line 415:
table wider than line width
Column gutter reduced to fit line length.
Right adjustment in text blocks removed in tables.
Some header made centered in tables.
One table put on same page.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
socket.7
Martin H
Document SO_MARK socket option
Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
the new SO_MARK socket option.
This patch is based on text from the commit message.
See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
svipc.7
Michael Kerrisk
SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
and isn't really relevant for the explanation on this page.
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
