1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
|
==================== Changes in man-pages-4.13 ====================
Released: 2017-09-15, Munich
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:
Aleksa Sarai <asarai@suse.de>
Alex Henrie <alexhenrie24@gmail.com>
Benjamin Peterson <bp@benjamin.pe>
Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Cyrill Gorcunov <gorcunov@openvz.org>
Darrick J. Wong <darrick.wong@oracle.com>
David Wilder <dwilder@us.ibm.com>
Dennis Knorr <dennis.knorr@muenchen.de>
Don Brace <don.brace@microsemi.com>
Douglas Caetano dos Santos <douglascs@taghos.com.br>
Elliott Hughes <enh@google.com>
Eugene Syromyatnikov <evgsyr@gmail.com>
Fabio Scotoni <fabio@esse.ch>
Florian Weimer <fweimer@redhat.com>
Jakub Wilk <jwilk@jwilk.net>
Jason Noakes <jjnoakes@gmail.com>
Jens Axboe <axboe@kernel.dk>
Jonas Grabber <jobegrabber@gmail.com>
Kees Cook <keescook@chromium.org>
Konstantin Shemyak <konstantin@shemyak.com>
Li Zhijian <lizhijian@cn.fujitsu.com>
Marko Myllynen <myllynen@redhat.com>
Mark Wielaard <mark@klomp.org>
Meelis Roos <mroos@linux.ee>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Rapoport <rppt@linux.vnet.ibm.com>
NeilBrown <neilb@suse.com>
Otto Ebeling <oebeling@github.mail.kapsi.fi>
Paul Eggert <eggert@cs.ucla.edu>
Rick Jones <rick.jones2@hpe.com>
Sage Weil <sage@redhat.com>
Sam Varshavchik <mrsam@courier-mta.com>
Sergey Z. <zhurxx@gmail.com>
Shrikant Giridhar <shrikantgiridhar@gmail.com>
Stephan Müller <smueller@chronox.de>
Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com>
Tej Chajed <tchajed@mit.edu>
Thiago Jung Bauermann <bauerman@linux.vnet.ibm.com>
Vincent Bernat <vincent@bernat.im>
Yubin Ruan <ablacktshirt@gmail.com>
Ильдар Низамов <niya3@mail.ru>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
pthread_mutex_consistent.3
Yubin Ruan, Michael Kerrisk
New page documenting pthread_mutex_consistent(3)
pthread_mutexattr_getpshared.3
Michael Kerrisk
New page for pthread_mutexattr_getpshared(3) and pthread_mutexattr_setpshared(3)
pthread_mutexattr_init.3
Michael Kerrisk
New page for pthread_mutexattr_init(3) and pthread_mutexattr_destroy(3)
pthread_mutexattr_setrobust.3
Yubin Ruan, Michael Kerrisk
New page for pthread_mutexattr_setrobust(3) and pthread_mutexattr_getrobust(3)
sysfs.5
Michael Kerrisk [Mark Wielaard]
New page documenting the sysfs filesystem
Just a skeleton page so far, but perhaps it will be filled out
over time.
Newly documented interfaces in existing pages
---------------------------------------------
fcntl.2
Jens Axboe, Michael Kerrisk
Describe the set/get write hints commands that are added in Linux 4.13
Document F_GET_RW_HINT, F_SET_RW_HINT, F_GET_FILE_RW_HINT, and
F_SET_FILE_RW_HINT.
ioctl_tty.2
Aleksa Sarai, Michael Kerrisk
Add TIOCGPTPEER documentation
kcmp.2
Cyrill Gorcunov
Add KCMP_EPOLL_TFD description
keyctl.2
Eugene Syromyatnikov
Document the KEYCTL_RESTRICT_KEYRING operation
Eugene Syromyatnikov [Stephan Müller]
Document the ability to provide KDF parameters in KEYCTL_DH_COMPUTE
New and changed links
---------------------
pthread_mutexattr_destroy.3
Michael Kerrisk
New link to new pthread_mutexattr_init.3 page
pthread_mutexattr_getrobust.3
Michael Kerrisk
New link to new pthread_mutexattr_setrobust.3 page
pthread_mutexattr_getrobust_np.3
Michael Kerrisk
New link to new pthread_mutexattr_setrobust.3 page
pthread_mutexattr_setpshared.3
Michael Kerrisk
New link to new pthread_mutexattr_getpshared.3 page
Global changes
--------------
Various pages
Michael Kerrisk
Use .EX/.EE for EXAMPLE programs
Various pages
Michael Kerrisk
Use consistent markup for code snippets
Change .nf/.fi to .EX/.EE
Various pages
Michael Kerrisk
Use consistent markup for code snippets
The preferred form is
.PP/.IP
.in +4n
.EX
<code>
.EE
.in
.PP/.IP
Various pages
Michael Kerrisk
Formatting fix: replace blank lines with .PP/.IP
Blank lines shouldn't generally appear in *roff source (other
than in code examples), since they create large vertical
spaces between text blocks.
Various pages
Michael Kerrisk [Bjarni Ingi Gislason]
Add a non-breaking space between a number and a unit (prefix)
Based on a patch by Bjarni Ingi Gislason.
Various pages
Michael Kerrisk [Bjarni Ingi Gislason]
Use en-dash for ranges
Based on a patch by Bjarni Ingi Gislason.
A few pages
Michael Kerrisk
Fix misordering of sections
Michael Kerrisk
Fix order of SEE ALSO entries
Changes to individual pages
---------------------------
ldd.1
Michael Kerrisk
Add more detail on ldd security implications, noting glibc 2.27 changes
add_key.2
backtrace.3
syslog.3
Michael Kerrisk
Fix misordered SEE ALSO entries
add_key.2
request_key.2
keyrings.7
Eugene Syromyatnikov
Update Linux documentation pointers
chown.2
Michael Kerrisk
Update kernel version in note on support for grpid/nogrpid mount options
There has been no change since Linux 2.6.25, so update the
kernel version to 4.12.
execve.2
Michael Kerrisk
SEE ALSO: add get_robust_list(2)
getrandom.2
Michael Kerrisk [Fabio Scotoni]
SYNOPSIS: make return type of getrandom() 'ssize_t'
This accords with glibc headers and the Linux kernel source.
getrlimit.2
Thiago Jung Bauermann
Mention unit used by RLIMIT_CORE and RLIMIT_FSIZE
Michael Kerrisk
Note that RLIMIT_AS and RLIMIT_DATA are rounded down to system page size
Michael Kerrisk
Mention unit for RLIMIT_DATA
getrlimit.2
mmap.2
malloc.3
Jonas Grabber
RLIMIT_DATA affects mmap (2) since Linux 4.7
get_robust_list.2
Michael Kerrisk
Detail the operation of robust futex lists
Michael Kerrisk
Since Linux 2.6.28, robust futex lists also have an effect for execve(2)
Michael Kerrisk
Clarify that "thread ID" means "kernel thread ID"
Michael Kerrisk
SEE ALSO: add pthread_mutexattr_setrobust(3)
ioctl_getfsmap.2
Darrick J. Wong
Correct semantics of FMR_OF_LAST flag
ioctl_userfaultfd.2
Mike Rapoport
Document replacement of ENOSPC with ESRCH
Mike Rapoport
Update uffdio_api.features description
There is no requirement that uffdio_api.features must be zero
for newer kernels. This field actually defines what features
space would like to enable.
io_submit.2
Sage Weil
Acknowledge possibility of short return
Note that the return value may be a value less than 'nr'
if not all iocbs were queued at once.
ipc.2
Michael Kerrisk
SEE ALSO: add svipc(7)
keyctl.2
Eugene Syromyatnikov
mention keyctl_dh_compute(3) and keyctl_dh_compute_alloc (3)
These functions have been added in keyutils 1.5.10
Eugene Syromyatnikov
Mention ENOMEM in ERRORS
Eugene Syromyatnikov
Update kernel documentation path reference
move_pages.2
Otto Ebeling [Michael Kerrisk]
Note permission changes that occurred in Linux 4.13
mprotect.2
Michael Kerrisk [Shrikant Giridhar]
Add warning about the use of printf() in the example code
open.2
NeilBrown
Improve O_PATH documentation
- fstatfs is now permitted.
- ioctl isn't, and is worth listing explicitly
- O_PATH allows an automount point to be opened with
triggering the mount.
prctl.2
seccomp.2
Eugene Syromyatnikov
Update pointer to in-kernel seccomp documentation
prctl.2
ptrace.2
Eugene Syromyatnikov
Update pointer to in-kernel Yama documentation
prctl.2
Eugene Syromyatnikov
Update pointer to in-kernel no_new_privs flag documentation
readlink.2
Michael Kerrisk [Jason Noakes]
Fix an off-by-one error in example code
seccomp.2
Kees Cook
Clarify SECCOMP_RET_KILL kills tasks not processes
select_tut.2
Michael Kerrisk [Sergey Z.]
Clarify an ambiguity with respect to select() and EAGAIN
See https://bugzilla.kernel.org/show_bug.cgi?id=196345
set_tid_address.2
Elliott Hughes
Note that there's no glibc wrapper for set_tid_address()
socket.2
Michael Kerrisk [Yubin Ruan]
socket() uses the lowest available file descriptor
_syscall.2
Michael Kerrisk
Remove redundant comment from EXAMPLE
A discussion of the nroff source of the manual
page isn't very useful...
sysfs.2
Michael Kerrisk
Add a pointer to sysfs(5) to help possibly confused readers
Michael Kerrisk
Make it clearer near the start of the page that sysfs(2) is obsolete
timer_create.2
Michael Kerrisk
Strengthen the warning about use of printf() in the example program
Michael Kerrisk
Update cross reference: signal(7) should be signal-safety(7)
umount.2
NeilBrown
Revise MNT_FORCE description
MNT_FORCE does not allow a busy filesystem to be unmounted. Only
MNT_DETACH allows that. MNT_FORCE only tries to abort pending
transactions, in the hope that might help umount not to block,
Also, other filesystems than NFS support MNT_FORCE.
unshare.2
Eugene Syromyatnikov
Update pointer to in-kernel unshare documentation
wait.2
Michael Kerrisk [Ильдар Низамов]
POSIX.1-2008 TC1 clarifies treatment of 'si_pid' for waitid() WNOHANG
cmsg.3
Sukadev Bhattiprolu
Add a scatter/gather buffer to sample code
Michael Kerrisk
Reorganize the text somewhat (no content changes)
crypt.3
Konstantin Shemyak [Michael Kerrisk]
Add description of previously undocumented 'rounds' parameter
Konstantin Shemyak
Encryption isn't done with SHA-xxx, but with a function based on SHA-xxx
Konstantin Shemyak
Clarify that ending of the salt string with '$' is optional
exit.3
Michael Kerrisk
Mention the prctl(2) PR_SET_PDEATHSIG operation
Michael Kerrisk
SEE ALSO: add get_robust_list(2)
Michael Kerrisk
Add a heading to delimit discussion of signals sent to other processes
exp2.3
Alex Henrie
Remove C89 designation
log1p.3
Alex Henrie
Document fixes to give EDOM or ERANGE on error
matherr.3
Michael Kerrisk
Note that glibc 2.27 removes the 'matherr' mechanism
Michael Kerrisk
Remove crufty feature test macro requirements
pow10.3
Michael Kerrisk
Note that pow10() is now obsolete in favor of exp10()
Also, the pow10() functions are no longer supported by glibc,
starting with version 2.27.
sincos.3
Michael Kerrisk
Note that sincos() is intended to be more efficient than sin() + cos()
cciss.4
hpsa.4
Eugene Syromyatnikov [Don Brace, Meelis Roos]
Mention cciss removal in Linux 4.14
During the Linux 4.13 development cycle, the cciss driver has been
removed in favor of the hpsa driver, which has been amended with
some legacy board support.
initrd.4
proc.5
bootparam.7
Eugene Syromyatnikov
Update pointer to in-kernel initrd documentation
initrd.4
Eugene Syromyatnikov
Update pointer to in-kernel root over NFS documentation
intro.4
Michael Kerrisk
SEE ALSO: add mknod(1) and mknod(2)
host.conf.5
Michael Kerrisk
Add cross-reference to hosts(5)
locale.5
Marko Myllynen
Refer to existing locales for encoding details
Since I don't think it would make sense to try to have different
explanation for each glibc version on the locale(5) man page, I'm
proposing that we apply the below patch so that we refer to
existing locale definition files in general and not spell out the
exact format or any certain locale as a definitive guideline.
nologin.5
Michael Kerrisk
Add a sentence explaining why nologin is useful
proc.5
Eugene Syromyatnikov
Document removal of htab-reclaim sysctl file
This PPC-specific sysctl option has been removed in Linux 2.4.9.2,
according to historic Linux repository commit log.
Eugene Syromyatnikov
Add description for cpuN lines in /proc/stat
Eugene Syromyatnikov
Add description for softirq line in /proc/stat
Eugene Syromyatnikov
Document removal of timer_stats file
Michael Kerrisk
Note Linux 4.9 changes to privileges for /proc/[pid]/timerslack_ns
Michael Kerrisk
Show command used to mount /proc
Michael Kerrisk
Explicitly note in intro that some /proc files are writable
Eugene Syromyatnikov
Update pointer to in-kernel SysRq documentation
Michael Kerrisk
SEE ALSO: add sysfs(5)
Eugene Syromyatnikov
Update pointer to in-kernel security keys documentation
Benjamin Peterson
Fix path to binfmt_misc docs
Eugene Syromyatnikov
Update pointer to in-kernel MTRR documentation
Eugene Syromyatnikov
Update reference to kernel's crypto API documentation
tzfile.5
Paul Eggert
Sync from tzdb upstream
This makes tzfile.5 a copy of the tzdb version, except that the
tzdb version's first line is replaced by man-pages boilerplate.
The new version documents version 3 format, among other things.
Also, it removes the "Summary of the timezone information file
format" section, which should no longer be needed due to
improvements in the the part of the man page.
capabilities.7
Michael Kerrisk
Note semantics for a program that is set-UID-root and has capabilities
Note semantics for a program that is both set-user-ID-root and has
file capabilities.
Michael Kerrisk [Dennis Knorr]
Note that a set-UID-root program may have an empty file capabilite set
cgroups.7
Michael Kerrisk
SEE ALSO: systemd-cgls(1)
cpuset.7
Eugene Syromyatnikov
Update pointer to in-kernel cpusets documentation
keyrings.7
Eugene Syromyatnikov
Document description restriction for logon keys
"logon" type has additional check that enforces colon-separated
prefix in key descriptions.
Eugene Syromyatnikov
Add pointers to kernel's documentation
Mostly because of assymmetric-keys.txt, which is outside
security/keys for some reason.
man-pages.7
Michael Kerrisk
Expand the guidance on formatting code snippets
netlink.7
David Wilder
Change buffer size in example code about reading netlink message
Michael Kerrisk [Rick Jones]
Add a comment on 8192 buffer size in example code
pthreads.7
Michael Kerrisk
SEE ALSO: add pthread_mutexattr_destroy(3) and pthread_mutexattr_init(3)
signal.7
Michael Kerrisk
Since glibc 2.26, SIGUNUSED is no longer defined
tcp.7
Vincent Bernat
tcp_tw_recycle is removed from Linux 4.12
And it is completely broken.
unicode.7
Eugene Syromyatnikov
Update pointer to in-kernel Unicode terminal support documentation
|