1 ==================== Changes in man-pages-4.03 ====================
3 Released: 2015-12-05, Munich
9 The following people contributed patches/fixes or (noted in brackets
10 in the changelog below) reports, notes, and ideas that have been
11 incorporated in changes in this release:
13 Alexander Shishkin <alexander.shishkin@linux.intel.com>
14 Alexei Starovoitov <ast@plumgrid.com>
15 Andy Lutomirski <luto@kernel.org>
16 Arto Bendiken <arto@bendiken.net>
17 Carlos O'Donell <carlos@redhat.com>
18 Casper Ti. Vector <caspervector@gmail.com>
19 Daniel Borkmann <daniel@iogearbox.net>
20 David Drysdale <drysdale@google.com>
21 Eric B Munson <emunson@akamai.com>
22 Florian Weimer <fweimer@redhat.com>
23 Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
24 Heinrich Schuchardt <xypron.glpk@gmx.de>
25 Ingo Molnar <mingo@kernel.org>
26 Jakub Wilk <jwilk@jwilk.net>
27 Johannes Stüttgen <Johannes.Stuettgen@gmail.com>
28 Jonathan Wakely <jwakely@redhat.com>
29 Jonny Grant <jg@jguk.org>
30 Kees Cook <keescook@chromium.org>
31 Maria Guseva <m.guseva@samsung.com>
32 Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
33 Meikun Wang <alikewmk@gmail.com>
34 Michael Kerrisk <mtk.manpages@gmail.com>
35 Michal Hocko <mhocko@suse.com>
36 Mike Frysinger <vapier@gentoo.org>
37 Namhyung Kim <namhyung@gmail.com>
38 Nikola Forró <nforro@redhat.com>
39 Olivier TARTROU <olivier.tartrou@gmail.com>
40 Peter Hurley <peter@hurleysoftware.com>
41 Peter Zijlstra (Intel) <peterz@infradead.org>
42 Ross Zwisler <ross.zwisler@linux.intel.com>
43 Serge Hallyn <serge.hallyn@canonical.com>
44 Silvan Jegen <s.jegen@gmail.com>
45 Stefan Tauner <tauner@technikum-wien.at>
46 Steven Rostedt <rostedt@goodmis.org>
47 Tobias Stoeckmann <tobias@stoeckmann.org>
48 Tycho Andersen <tycho.andersen@canonical.com>
49 Ville Skyttä <ville.skytta@iki.fi>
50 Vince Weaver <vincent.weaver@maine.edu>
51 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
53 Apologies if I missed anyone!
56 Newly documented interfaces in existing pages
57 ---------------------------------------------
61 4.1 adds AUX sample support
63 4.1 data_offset and data_size fields
64 Vince Weaver [Alexander Shishkin]
65 Document aux_{head,tail,offset,size} support
67 4.0 update rdpmc documentation
69 4.1 adds PERF_RECORD_ITRACE_START
71 Document 4.1 clockid support
72 Vince Weaver [Steven Rostedt, Masami Hiramatsu]
73 4.1 PERF_EVENT_IOC_SET_BPF support
75 4.1 adds AUX_FLAG_OVERWRITE support
77 4.1 PERF_SAMPLE_BRANCH_CALL_STACK
79 4.1 adds aux_watermark
81 Add possibility of EBUSY error
84 Andy Lutomirski [Kees Cook, Serge Hallyn]
85 Document operations for ambient capabilities
87 Rework PR_CAP_AMBIENT text
88 Note that arg4 and arg5 must be zero for CAP_AMBIENT
89 RETURN VALUE: Add PR_CAP_AMBIENT + PR_CAP_AMBIENT_IS_SET case
90 ERRORS: document PR_CAP_AMBIENT error cases
94 Document PPC functions providing access to PPR
95 GNU C Library commit 1747fcda4902a3b46183d93fb16ed9b436b2608b
96 extends the priorities that can be set to the Program Priority
97 Register (PPR), with the functions: __ppc_set_ppr_very_low(3)
98 and __ppc_set_ppr_med_high(3).
101 Andy Lutomirski [Kees Cook, Serge Hallyn]
102 Document ambient capabilities
104 Various additions and reworkings for ambient capability text
107 New and changed links
108 ---------------------
110 __ppc_set_ppr_med_high.3
112 New link to __ppc_set_ppr_med.3
114 __ppc_set_ppr_very_low.3
116 New link to __ppc_set_ppr_med.3
119 Changes to individual pages
120 ---------------------------
123 Eric B Munson [Michal Hocko]
124 Add note about mremap() with locked areas
125 When mremap() is used to move or expand a mapping that is locked
126 with mlock() or equivalent it will attempt to populate the new
127 area. However, like mmap(MAP_LOCKED), mremap() will not fail if
128 the area cannot be populated. Also like mmap(MAP_LOCKED) this
129 might come as a surprise to users and should be noted.
131 Michael Kerrisk [David Drysdale]
132 Remove accidental mention of O_TTY_INIT
133 An earlier edit mentioned O_TTY_INIT as a file creation flag.
134 That's true, according POSIX, but Linux does not implement
135 this flag, so remove mention of it.
139 SEE ALSO: add splice(2)
143 Reorder options alphabetically
144 Employ a pseudo-alphabetical order, ordering options after removal
145 of any "PR_", "PR_SET_", or "PR_GET" prefix.
147 Fix alphabetical misplacements in ERRORS
151 Document PTRACE_O_SUSPEND_SECCOMP flag
153 Document /proc/sys/kernel/yama/ptrace_scope
155 Note that PTRACE_ATTACH cannot be applied to nondumpable processes
157 SEE ALSO: add prctl(2)
161 1-argument reboot() is also provided by alternative libc
165 Describe use of 'instruction_pointer' data field
166 Michael Kerrisk [Kees Cook]
167 Note why all filters in a set are executed even after SECCOMP_RET_KILL
171 Describe semantics with respect to SCM_RIGHTS
180 Michael Kerrisk [Johannes Stüttgen]
181 Note that daemon() is buggy with respect to controlling tty acquisition
185 Remove outdated NOTES
186 As stated in the SYNOPSIS, since glibc 2.10 this function is also
187 declared by the relevant X/Open and POSIX macros.
191 Make it more explicit that LD_BIND_NOW overrides RTLD_LAZY
192 Michael Kerrisk [Florian Weimer]
193 Correct the pathname used in EXAMPLE
196 This does not work because libm.so can be a linker script:
198 handle = dlopen("libm.so", RTLD_LAZY);
200 The proper way to do this is to include <gnu/lib-names.h>
203 See https://bugzilla.kernel.org/show_bug.cgi?id=108821
205 Include a shell session showing build/run in EXAMPLE
207 Change arguments to main() to "void" in EXAMPLE
211 ATTRIBUTES: Note function that is not thread-safe
215 ATTRIBUTES: Note function that is not thread-safe
219 Add some details for AT_SECURE
223 ATTRIBUTES: Note functions that are/aren't thread-safe
227 ATTRIBUTES: Note function that is not thread-safe
231 Document M_ARENA_TEST and M_ARENA_MAX
235 Clarify text relating to MT-safety
237 Mention glibc emulation caveats
241 Add missing details on behaviour of PARMRK
242 For a serial terminal, with a specific configuration, input bytes
243 with value 0377 are passed to the program as two bytes, 0377 0377.
246 Michael Kerrisk [Peter Hurley]
247 Note that TIOCTTYGSTRUCT went away in Linux 2.5.67
251 Add info about DAX coredump filtering flags
252 Kernel 4.4 added two new core dump filtering flags,
253 MMF_DUMP_DAX_PRIVATE and MMF_DUMP_DAX_SHARED.
255 These flags allow us to explicitly filter DAX mappings.
256 This is desirable because DAX mappings, like hugetlb
257 mappings, have the potential to be very large.
261 Add list of files being read when "files" service is used
262 This is not mentioned anywhere. Users can assume that the file
263 being read is something like /etc/$DATABASE, but that's not
264 always the case. It's better to explicitly specify which
265 file is read for each respective database. The list of
266 files was acquired from glibc source code.
269 Heinrich Schuchardt [Michael Kerrisk]
270 Add details for threads-max
271 Add detail information for threads-max.
272 The checks for minimum and maximum values exist since kernel 4.1.
273 https://lkml.org/lkml/2015/3/15/96
275 /proc/sys: Describe whitespace characters
277 Document 'CapAmb' in /proc/PID/status
279 Add reference to ptrace(2) for /proc/sys/kernel/yama/ptrace_scope
282 Michael Kerrisk [Meikun Wang]
283 Add missing include file, <fcntl.h>, to example program
286 Michael Kerrisk [Arto Bendiken]
287 Document QSIZE bug that appeared in 3.5 and was fixed in 4.2
291 Clarify recursive resolution of symlinks and note limits
295 SEE ALSO: add splice(2)
299 Fix (typo) error in la_pltenter() description
300 s/la_pltenter()/la_pltexit()/
302 la_pltenter() is called regardless of the value of
303 framesizep but la_pltexit() is called only if la_pltenter()
304 returns with non-zero framesizep set. I spent long time to
305 figure out why la_pltexit() is not called at all.
308 Michael Kerrisk [Michael Hocko]
309 Note async-signal-safe functions added by POSIX.1-2008 TC1
312 Daniel Borkmann [Michael Kerrisk]
313 Improve paragraphs on tcp_ecn and add tcp_ecn_fallback bullet
314 Improve description of tcp_ecn, fix the RFC number and it's
315 not a boolean anymore since long time, and add a description
316 for tcp_ecn_fallback.
318 See also kernel doc under Documentation/networking/ip-sysctl.txt
319 on tcp_ecn and tcp_ecn_fallback.
323 LD_POINTER_GUARD has been removed in glibc 2.23
325 Describe secure-execution mode
326 Michael Kerrisk [Maria Guseva]
327 Replace mentions of set-UID/set-GID programs with secure-execution mode
328 Inspired by a patch from Maria Guseva.
329 Maria Guseva [Silvan Jegen]
330 LD_DEBUG is effective in secure-execution mode if /etc/suid-debug exists