2015-08-08 16:24:47 +00:00
|
|
|
==================== Changes in man-pages-4.03 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2015-12-05 09:45:16 +00:00
|
|
|
Released: 2015-12-05, Munich
|
2007-09-19 21:40:03 +00:00
|
|
|
|
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Contributors
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
2011-09-16 02:56:20 +00:00
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
2012-03-05 20:07:17 +00:00
|
|
|
in the changelog below) reports, notes, and ideas that have been
|
2011-09-16 02:56:20 +00:00
|
|
|
incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
2015-12-04 16:20:06 +00:00
|
|
|
Alexander Shishkin <alexander.shishkin@linux.intel.com>
|
|
|
|
Alexei Starovoitov <ast@plumgrid.com>
|
|
|
|
Andy Lutomirski <luto@kernel.org>
|
|
|
|
Arto Bendiken <arto@bendiken.net>
|
|
|
|
Carlos O'Donell <carlos@redhat.com>
|
|
|
|
Casper Ti. Vector <caspervector@gmail.com>
|
|
|
|
Daniel Borkmann <daniel@iogearbox.net>
|
|
|
|
David Drysdale <drysdale@google.com>
|
|
|
|
Eric B Munson <emunson@akamai.com>
|
|
|
|
Florian Weimer <fweimer@redhat.com>
|
|
|
|
Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
|
|
|
|
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
|
|
|
Ingo Molnar <mingo@kernel.org>
|
|
|
|
Jakub Wilk <jwilk@jwilk.net>
|
|
|
|
Johannes Stüttgen <Johannes.Stuettgen@gmail.com>
|
|
|
|
Jonathan Wakely <jwakely@redhat.com>
|
|
|
|
Jonny Grant <jg@jguk.org>
|
|
|
|
Kees Cook <keescook@chromium.org>
|
|
|
|
Maria Guseva <m.guseva@samsung.com>
|
|
|
|
Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
|
|
|
|
Meikun Wang <alikewmk@gmail.com>
|
|
|
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
|
|
Michal Hocko <mhocko@suse.com>
|
|
|
|
Mike Frysinger <vapier@gentoo.org>
|
|
|
|
Namhyung Kim <namhyung@gmail.com>
|
|
|
|
Nikola Forró <nforro@redhat.com>
|
|
|
|
Olivier TARTROU <olivier.tartrou@gmail.com>
|
|
|
|
Peter Hurley <peter@hurleysoftware.com>
|
|
|
|
Peter Zijlstra (Intel) <peterz@infradead.org>
|
|
|
|
Ross Zwisler <ross.zwisler@linux.intel.com>
|
|
|
|
Serge Hallyn <serge.hallyn@canonical.com>
|
|
|
|
Silvan Jegen <s.jegen@gmail.com>
|
|
|
|
Stefan Tauner <tauner@technikum-wien.at>
|
|
|
|
Steven Rostedt <rostedt@goodmis.org>
|
|
|
|
Tobias Stoeckmann <tobias@stoeckmann.org>
|
|
|
|
Tycho Andersen <tycho.andersen@canonical.com>
|
|
|
|
Ville Skyttä <ville.skytta@iki.fi>
|
|
|
|
Vince Weaver <vincent.weaver@maine.edu>
|
|
|
|
Zeng Linggang <zenglg.jy@cn.fujitsu.com>
|
2013-03-10 10:24:30 +00:00
|
|
|
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
|
|
|
2015-03-02 15:18:15 +00:00
|
|
|
Newly documented interfaces in existing pages
|
|
|
|
---------------------------------------------
|
|
|
|
|
2015-12-04 16:20:06 +00:00
|
|
|
perf_event_open.2
|
|
|
|
Vince Weaver
|
|
|
|
4.1 adds AUX sample support
|
|
|
|
Vince Weaver
|
|
|
|
4.1 data_offset and data_size fields
|
|
|
|
Vince Weaver [Alexander Shishkin]
|
|
|
|
Document aux_{head,tail,offset,size} support
|
|
|
|
Vince Weaver
|
|
|
|
4.0 update rdpmc documentation
|
|
|
|
Vince Weaver
|
|
|
|
4.1 adds PERF_RECORD_ITRACE_START
|
|
|
|
Vince Weaver
|
|
|
|
Document 4.1 clockid support
|
|
|
|
Vince Weaver [Steven Rostedt, Masami Hiramatsu]
|
|
|
|
4.1 PERF_EVENT_IOC_SET_BPF support
|
|
|
|
Vince Weaver
|
|
|
|
4.1 adds AUX_FLAG_OVERWRITE support
|
|
|
|
Vince Weaver
|
|
|
|
4.1 PERF_SAMPLE_BRANCH_CALL_STACK
|
|
|
|
Vince Weaver
|
|
|
|
4.1 adds aux_watermark
|
|
|
|
Vince Weaver
|
|
|
|
Add possibility of EBUSY error
|
|
|
|
|
|
|
|
prctl.2
|
|
|
|
Andy Lutomirski [Kees Cook, Serge Hallyn]
|
|
|
|
Document operations for ambient capabilities
|
|
|
|
Michael Kerrisk
|
|
|
|
Rework PR_CAP_AMBIENT text
|
|
|
|
Note that arg4 and arg5 must be zero for CAP_AMBIENT
|
|
|
|
RETURN VALUE: Add PR_CAP_AMBIENT + PR_CAP_AMBIENT_IS_SET case
|
|
|
|
ERRORS: document PR_CAP_AMBIENT error cases
|
|
|
|
|
|
|
|
__ppc_set_ppr_med.3
|
|
|
|
Gabriel F. T. Gomes
|
|
|
|
Document PPC functions providing access to PPR
|
|
|
|
GNU C Library commit 1747fcda4902a3b46183d93fb16ed9b436b2608b
|
|
|
|
extends the priorities that can be set to the Program Priority
|
|
|
|
Register (PPR), with the functions: __ppc_set_ppr_very_low(3)
|
|
|
|
and __ppc_set_ppr_med_high(3).
|
|
|
|
|
|
|
|
capabilities.7
|
|
|
|
Andy Lutomirski [Kees Cook, Serge Hallyn]
|
|
|
|
Document ambient capabilities
|
|
|
|
Michael Kerrisk
|
|
|
|
Various additions and reworkings for ambient capability text
|
|
|
|
|
2015-03-29 16:49:01 +00:00
|
|
|
|
2015-03-29 20:33:06 +00:00
|
|
|
New and changed links
|
|
|
|
---------------------
|
2015-03-29 16:49:01 +00:00
|
|
|
|
2015-12-04 16:20:06 +00:00
|
|
|
__ppc_set_ppr_med_high.3
|
|
|
|
Gabriel F. T. Gomes
|
|
|
|
New link to __ppc_set_ppr_med.3
|
2015-03-29 16:49:01 +00:00
|
|
|
|
2015-12-04 16:20:06 +00:00
|
|
|
__ppc_set_ppr_very_low.3
|
|
|
|
Gabriel F. T. Gomes
|
|
|
|
New link to __ppc_set_ppr_med.3
|
2015-03-29 16:49:01 +00:00
|
|
|
|
|
|
|
|
2015-03-29 20:33:06 +00:00
|
|
|
Changes to individual pages
|
|
|
|
---------------------------
|
2014-10-02 21:44:42 +00:00
|
|
|
|
2015-12-04 16:20:06 +00:00
|
|
|
mremap.2
|
|
|
|
Eric B Munson [Michal Hocko]
|
|
|
|
Add note about mremap() with locked areas
|
|
|
|
When mremap() is used to move or expand a mapping that is locked
|
|
|
|
with mlock() or equivalent it will attempt to populate the new
|
|
|
|
area. However, like mmap(MAP_LOCKED), mremap() will not fail if
|
|
|
|
the area cannot be populated. Also like mmap(MAP_LOCKED) this
|
|
|
|
might come as a surprise to users and should be noted.
|
|
|
|
open.2
|
|
|
|
Michael Kerrisk [David Drysdale]
|
|
|
|
Remove accidental mention of O_TTY_INIT
|
|
|
|
An earlier edit mentioned O_TTY_INIT as a file creation flag.
|
|
|
|
That's true, according POSIX, but Linux does not implement
|
|
|
|
this flag, so remove mention of it.
|
|
|
|
|
|
|
|
pipe.2
|
|
|
|
Michael Kerrisk
|
|
|
|
SEE ALSO: add splice(2)
|
|
|
|
|
|
|
|
prctl.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Reorder options alphabetically
|
|
|
|
Employ a pseudo-alphabetical order, ordering options after removal
|
|
|
|
of any "PR_", "PR_SET_", or "PR_GET" prefix.
|
|
|
|
Michael Kerrisk
|
|
|
|
Fix alphabetical misplacements in ERRORS
|
|
|
|
|
|
|
|
ptrace.2
|
|
|
|
Tycho Andersen
|
|
|
|
Document PTRACE_O_SUSPEND_SECCOMP flag
|
|
|
|
Michael Kerrisk
|
|
|
|
Document /proc/sys/kernel/yama/ptrace_scope
|
|
|
|
Michael Kerrisk
|
|
|
|
Note that PTRACE_ATTACH cannot be applied to nondumpable processes
|
|
|
|
Michael Kerrisk
|
|
|
|
SEE ALSO: add prctl(2)
|
|
|
|
|
|
|
|
reboot.2
|
|
|
|
Casper Ti. Vector
|
|
|
|
1-argument reboot() is also provided by alternative libc
|
|
|
|
|
|
|
|
seccomp.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Describe use of 'instruction_pointer' data field
|
|
|
|
Michael Kerrisk [Kees Cook]
|
|
|
|
Note why all filters in a set are executed even after SECCOMP_RET_KILL
|
|
|
|
|
|
|
|
signalfd.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Describe semantics with respect to SCM_RIGHTS
|
|
|
|
|
|
|
|
syscalls.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Add mlock(2)
|
|
|
|
Michael Kerrisk
|
|
|
|
Add userfaultfd()
|
|
|
|
|
|
|
|
daemon.3
|
|
|
|
Michael Kerrisk [Johannes Stüttgen]
|
|
|
|
Note that daemon() is buggy with respect to controlling tty acquisition
|
|
|
|
|
|
|
|
dirfd.3
|
|
|
|
Jonathan Wakely
|
|
|
|
Remove outdated NOTES
|
|
|
|
As stated in the SYNOPSIS, since glibc 2.10 this function is also
|
|
|
|
declared by the relevant X/Open and POSIX macros.
|
|
|
|
|
|
|
|
dlopen.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Make it more explicit that LD_BIND_NOW overrides RTLD_LAZY
|
|
|
|
Michael Kerrisk [Florian Weimer]
|
|
|
|
Correct the pathname used in EXAMPLE
|
|
|
|
Quoting Florian:
|
|
|
|
|
|
|
|
This does not work because libm.so can be a linker script:
|
|
|
|
|
|
|
|
handle = dlopen("libm.so", RTLD_LAZY);
|
|
|
|
|
|
|
|
The proper way to do this is to include <gnu/lib-names.h>
|
|
|
|
and use LIBM_SO.
|
|
|
|
|
|
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=108821
|
|
|
|
Michael Kerrisk
|
|
|
|
Include a shell session showing build/run in EXAMPLE
|
|
|
|
Michael Kerrisk
|
|
|
|
Change arguments to main() to "void" in EXAMPLE
|
|
|
|
|
|
|
|
fgetgrent.3
|
|
|
|
Zeng Linggang
|
|
|
|
ATTRIBUTES: Note function that is not thread-safe
|
|
|
|
|
|
|
|
fgetpwent.3
|
|
|
|
Zeng Linggang
|
|
|
|
ATTRIBUTES: Note function that is not thread-safe
|
|
|
|
|
|
|
|
getauxval.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Add some details for AT_SECURE
|
|
|
|
|
|
|
|
getspnam.3
|
|
|
|
Zeng Linggang
|
|
|
|
ATTRIBUTES: Note functions that are/aren't thread-safe
|
|
|
|
|
|
|
|
mallinfo.3
|
|
|
|
Zeng Linggang
|
|
|
|
ATTRIBUTES: Note function that is not thread-safe
|
|
|
|
|
|
|
|
mallopt.3
|
|
|
|
Carlos O'Donell
|
|
|
|
Document M_ARENA_TEST and M_ARENA_MAX
|
|
|
|
|
|
|
|
posix_fallocate.3
|
|
|
|
Michael Kerrisk
|
|
|
|
Clarify text relating to MT-safety
|
|
|
|
Carlos O'Donell
|
|
|
|
Mention glibc emulation caveats
|
|
|
|
|
|
|
|
termios.3
|
|
|
|
Olivier TARTROU
|
|
|
|
Add missing details on behaviour of PARMRK
|
|
|
|
For a serial terminal, with a specific configuration, input bytes
|
|
|
|
with value 0377 are passed to the program as two bytes, 0377 0377.
|
|
|
|
|
|
|
|
tty_ioctl.4
|
|
|
|
Michael Kerrisk [Peter Hurley]
|
|
|
|
Note that TIOCTTYGSTRUCT went away in Linux 2.5.67
|
|
|
|
|
|
|
|
core.5
|
|
|
|
Ross Zwisler
|
|
|
|
Add info about DAX coredump filtering flags
|
|
|
|
Kernel 4.4 added two new core dump filtering flags,
|
|
|
|
MMF_DUMP_DAX_PRIVATE and MMF_DUMP_DAX_SHARED.
|
|
|
|
|
|
|
|
These flags allow us to explicitly filter DAX mappings.
|
|
|
|
This is desirable because DAX mappings, like hugetlb
|
|
|
|
mappings, have the potential to be very large.
|
|
|
|
|
|
|
|
nsswitch.conf.5
|
|
|
|
Nikola Forró
|
|
|
|
Add list of files being read when "files" service is used
|
|
|
|
This is not mentioned anywhere. Users can assume that the file
|
|
|
|
being read is something like /etc/$DATABASE, but that's not
|
|
|
|
always the case. It's better to explicitly specify which
|
|
|
|
file is read for each respective database. The list of
|
|
|
|
files was acquired from glibc source code.
|
|
|
|
|
|
|
|
proc.5
|
|
|
|
Heinrich Schuchardt [Michael Kerrisk]
|
|
|
|
Add details for threads-max
|
|
|
|
Add detail information for threads-max.
|
|
|
|
The checks for minimum and maximum values exist since kernel 4.1.
|
|
|
|
https://lkml.org/lkml/2015/3/15/96
|
|
|
|
Heinrich Schuchardt
|
|
|
|
/proc/sys: Describe whitespace characters
|
|
|
|
Michael Kerrisk
|
|
|
|
Document 'CapAmb' in /proc/PID/status
|
|
|
|
Michael Kerrisk
|
|
|
|
Add reference to ptrace(2) for /proc/sys/kernel/yama/ptrace_scope
|
|
|
|
|
|
|
|
aio.7
|
|
|
|
Michael Kerrisk [Meikun Wang]
|
|
|
|
Add missing include file, <fcntl.h>, to example program
|
|
|
|
|
|
|
|
mq_overview.7
|
|
|
|
Michael Kerrisk [Arto Bendiken]
|
|
|
|
Document QSIZE bug that appeared in 3.5 and was fixed in 4.2
|
|
|
|
|
|
|
|
path_resolution.7
|
|
|
|
Michael Kerrisk
|
|
|
|
Clarify recursive resolution of symlinks and note limits
|
|
|
|
|
|
|
|
pipe.7
|
|
|
|
Michael Kerrisk
|
|
|
|
SEE ALSO: add splice(2)
|
|
|
|
|
|
|
|
rtld-audit.7
|
|
|
|
Namhyung Kim
|
|
|
|
Fix (typo) error in la_pltenter() description
|
|
|
|
s/la_pltenter()/la_pltexit()/
|
|
|
|
|
|
|
|
la_pltenter() is called regardless of the value of
|
|
|
|
framesizep but la_pltexit() is called only if la_pltenter()
|
|
|
|
returns with non-zero framesizep set. I spent long time to
|
|
|
|
figure out why la_pltexit() is not called at all.
|
|
|
|
|
|
|
|
signal.7
|
|
|
|
Michael Kerrisk [Michael Hocko]
|
|
|
|
Note async-signal-safe functions added by POSIX.1-2008 TC1
|
|
|
|
|
|
|
|
tcp.7
|
|
|
|
Daniel Borkmann [Michael Kerrisk]
|
|
|
|
Improve paragraphs on tcp_ecn and add tcp_ecn_fallback bullet
|
|
|
|
Improve description of tcp_ecn, fix the RFC number and it's
|
|
|
|
not a boolean anymore since long time, and add a description
|
|
|
|
for tcp_ecn_fallback.
|
|
|
|
|
|
|
|
See also kernel doc under Documentation/networking/ip-sysctl.txt
|
|
|
|
on tcp_ecn and tcp_ecn_fallback.
|
|
|
|
|
|
|
|
ld.so.8
|
|
|
|
Michael Kerrisk
|
|
|
|
LD_POINTER_GUARD has been removed in glibc 2.23
|
|
|
|
Michael Kerrisk
|
|
|
|
Describe secure-execution mode
|
|
|
|
Michael Kerrisk [Maria Guseva]
|
|
|
|
Replace mentions of set-UID/set-GID programs with secure-execution mode
|
|
|
|
Inspired by a patch from Maria Guseva.
|
|
|
|
Maria Guseva [Silvan Jegen]
|
|
|
|
LD_DEBUG is effective in secure-execution mode if /etc/suid-debug exists
|