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
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
|
==================== Changes in man-pages-4.10 ====================
Released: 2017-03-13, Paris
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:
Adam Martindale <adam.john.martindale@gmail.com>
Alex <psybin@riseup.net>
Anders Thulin <anders@thulin.name>
Andreas Gruenbacher <agruenba@redhat.com>
Brian Masney <masneyb@onstation.org>
Casey Schaufler <casey@schaufler-ca.com>
David Howells <dhowells@redhat.com>
Erik Kline <ekline@gmail.com>
Erik Roland van der Meer <ervdmeer@gmail.com>
Eugene Syromyatnikov <evgsyr@gmail.com>
Fabjan Sukalia <fsukalia@gmail.com>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Helmut Eller <eller.helmut@gmail.com>
Hugo Guiroux <hugo.guiroux@gmail.com>
Ian Jackson <ijackson@chiark.greenend.org.uk>
Jakub Wilk <jwilk@jwilk.net>
Jann Horn <jannh@google.com>
Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
John Wiersba <jrw32982@yahoo.com>
Jon Jensen <jon@endpoint.com>
Kai NODA <nodakai@gmail.com>
KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Keno Fischer <keno@juliacomputing.com>
Kent Fredic <kentfredric@gmail.com>
Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
Maik Zumstrull <maik@zumstrull.net>
Mat Martineau <mathew.j.martineau@linux.intel.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@chromium.org>
Nadav Har'El <nyh@math.technion.ac.il>
Namhyung Kim <namhyung@gmail.com>
Nicolas Biscos <nicolas.biscos+man7@gmail.com>
Omar Sandoval <osandov@osandov.com>
Paul Fee <paul.f.fee@gmail.com>
Reverend Homer <mk.43.ecko@gmail.com>
Rob Landley <rob@landley.net>
Sergey Polovko <sergey@polovko.me>
Steven Luo <steven@steven676.net>
Tadeusz Struk <tadeusz.struk@intel.com>
Vincent Bernat <vincent@bernat.im>
Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Willy Tarreau <w@1wt.eu>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
add_key.2
Michael Kerrisk [Eugene Syromyatnikov, David Howells]
Major improvements and additions
The page has doubled in length.
ioctl_iflags.2
Michael Kerrisk
New page describing inode flags and ioctl() operations
ioctl_ns.2
Michael Kerrisk
New page created by splitting ioctl(2) operations out of namespaces(7)
keyctl.2
Michael Kerrisk, Eugene Syromyatnikov [David Howells, Mat Martineau]
A vast number of additions and improvements
The page has gone from somewhat over 100 lines to well over
1000 lines and now more or less documents the complete interface
provided by this system call.
getentropy.3
Michael Kerrisk
New page documenting getentropy(3)
getentropy(3) is added to glibc in version 2.25.
keyrings.7
David Howells
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk [Eugene Syromyatnikov, David Howells]
Very many additions and improvements
Michael Kerrisk
Document /proc/keys
Michael Kerrisk
Document /proc/sys/kernel/keys/persistent_keyring_expiry
Michael Kerrisk
Document /proc/key-users
Michael Kerrisk
Document /proc/sys/kernel/keys/gc_delay
Michael Kerrisk
Document /proc files that define key quotas
persistent-keyring.7
Michael Kerrisk
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk
Various clean-ups and additions
process-keyring.7
Michael Kerrisk
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk
Various additions and improvements
request_key.2
Michael Kerrisk, Eugene Syromyatnikov [David Howells]
Very many additions and improvements
The page is now three times its former length.
session-keyring.7
Michael Kerrisk
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk
Various reworking and additions
signal-safety.7
Michael Kerrisk
New page created by migrating the signal-safety discussion from
signal(7). Along the way some more details got added.
Michael Kerrisk [KASAKI Motohiro]
Note async-signal-safety problems caused by pthread_atfork()
See https://bugzilla.kernel.org/show_bug.cgi?id=25292
Michael Kerrisk [KASAKI Motohiro]
Note glibc deviations from POSIX requirements
See https://bugzilla.kernel.org/show_bug.cgi?id=25292
thread-keyring.7
Michael Kerrisk
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk
Various rewordings and additions
user-keyring.7
Michael Kerrisk
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk
Various reworking and improvements
user-session-keyring.7
Michael Kerrisk
New page (written by David Howells) adopted from keyutils
Since this page documents kernel-user-space interfaces,
it makes sense to have it as part of man-pages, rather
than the keyutils package.
Michael Kerrisk
Various rewordings and additions
Newly documented interfaces in existing pages
---------------------------------------------
bzero.3
Michael Kerrisk
Document explicit_bzero() (new in glibc 2.25)
Also, reword the description of bzero somewhat.
proc.5
Michael Kerrisk
Document /proc/sys/vm/user_reserve_kbytes
Michael Kerrisk
Document /proc/sys/vm/admin_reserve_kbytes
Michael Kerrisk
Document /proc/sys/fs/mount-max
Michael Kerrisk
Document /proc/PID/status 'NoNewPrivs' field
New and changed links
---------------------
explicit_bzero.3
Michael Kerrisk
New link to bzero.3
Changes to individual pages
---------------------------
chmod.2
Michael Kerrisk
ERRORS: add EPERM error for immutable/append-only file
chown.2
Michael Kerrisk
ERRORS: add EPERM error for immutable/append-only file
chroot.2
Michael Kerrisk
SEE ALSO: add switch_root(8)
clock_getres.2
Michael Kerrisk
Note POSIX.1 requirements re relative time services and CLOCK_REALTIME
clone.2
Michael Kerrisk
clone() does not execute fork handlers
execve.2
Michael Kerrisk
Rework text describing when effective IDs aren't transformed by execve()
Michael Kerrisk
File capabilities can be ignored for the same reasons as set-UID/set-GID
Michael Kerrisk
The 'no_new_privs' bit inhibits transformations of the effective IDs
fork.2
Michael Kerrisk
cgroup PIDs controller may also be trigger for EAGAIN error
fsync.2
Michael Kerrisk
SEE ALSO: add posix_fadvise(2)
getrandom.2
Michael Kerrisk
Remove getentropy(3) details and defer to new getentropy(3) page
Michael Kerrisk
Starting with glibc 2.25, getrandom() is now declared in <sys/random.h>
Michael Kerrisk
glibc support was added in version 2.25
getrlimit.2
Michael Kerrisk
Document role of RLIMIT_NOFILE for FD passing over UNIX sockets
getxattr.2
listxattr.2
Andreas Gruenbacher
Document E2BIG errors
inotify_add_watch.2
Michael Kerrisk
Note "inode" as a synonym for "filesystem object"
Consistent with clarifications just made in inotify(7).
ioctl.2
Michael Kerrisk
SEE ALSO: add ioctl_ns(2), ioctl_iflags(2)
ioctl_fat.2
Brian Masney
Correctly reference volume ID instead of volume label
kcmp.2
Michael Kerrisk
Mention the clone(2) flags relating to various kcmp() 'type' values
Michael Kerrisk
KCMP_FILE: note reasons why FDs may refer to same open file description
link.2
Michael Kerrisk
When using linkat() AT_EMPTY_PATH, 'olddirfd' must not be a directory
Michael Kerrisk
ERRORS: add EPERM for immutable/append-only files
Michael Kerrisk
Note limits where EMLINK is encountered on ext4 and Btrfs
listxattr.2
Michael Kerrisk
Eliminate extra E2BIG error text
Andreas' patch added a second description of E2BIG that
was (mostly) more detailed than the existing text. Combine
the two texts.
lseek.2
Michael Kerrisk
O_APPEND overrides the effect of lseek() when doing file writes
Michael Kerrisk
Remove ancient info about whence values and return values on old systems
Michael Kerrisk
Remove slightly bogus advice about race conditions
The page already (by now) contains a reference to open(2)
for a discussion of open file descriptions. Leave it at that,
since the reader can then deduce how things work.
madvise.2
Michael Kerrisk
Note that madvise() is generally about improving performance
mbind.2
Krzysztof Kulakowski [Michael Kerrisk]
Update MPOL_BIND description
Behavior of MPOL_BIND Linux 2.6.26.
mincore.2
Michael Kerrisk
SEE ALSO: add madvise(2), posix_fadvise(2), posix_madvise(3)
mlock.2
Michael Kerrisk
Note pre-4.9 bug in RLIMIT_MEMLOCK accounting for overlapping locks
Michael Kerrisk
SEE ALSO: add mincore(2)
mmap.2
Michael Kerrisk
mincore(2) can be used to discover which pages of a mapping are resident
mount.2
Michael Kerrisk [Rob Landley]
Refer to mount_namespaces(7) for details of default propagation type
nanosleep.2
Michael Kerrisk
Describe "creeping sleep" problem
nanosleep() has a problem if used in a program that catches
signals and those signals are delivered at a very high rate.
Describe the problem, and note that clock_nanosleep(2)
provides a solution.
Michael Kerrisk
BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6
open.2
Michael Kerrisk
Make it clear that O_APPEND implies atomicity
Michael Kerrisk
Clarify distinction between file creation flags and file status flags
Michael Kerrisk
Note ambiguity of ELOOP error when using O_NOFOLLOW
Michael Kerrisk
Restructure O_NOFOLLOW text for easier parsing
Michael Kerrisk
Clarify that O_NOFOLLOW is now in POSIX
poll.2
select.2
Nicolas Biscos
Add a reference to the sigset discussion in sigprocmask(2)
A little while back, I added a note to sigprocmask.2 that
discussed the difference between the libc's and the kernel's
sigset_t structures. I added that note, because I saw this being
done wrong in a tool tracing system calls (causing subtle bugs).
As it turns out, the same bugs existed for ppoll and pselect, for
the same reason. I'm hoping by adding the reference here, future
writers of similar tools will find that discussion and not make
the same mistake.
posix_fadvise.2
Michael Kerrisk
Mention /proc/sys/vm/drop_caches
It may be helpful for the reader of this page to know about
/proc/sys/vm/drop_caches.
Michael Kerrisk
Reorganize some text
Details for various flags were hidden under NOTES.
Move them to DESCRIPTION, to make the details more
obvious.
Michael Kerrisk
One can use open(2) + mmap(2) + mincore(2) as a 'fincore'
Note that open(2) + mmap(2) + mincore(2) to get a view of which
pages of a file are currently cached.
Michael Kerrisk [Maik Zumstrull]
Note that POSIX_FADV_DONTNEED *may* try to write back dirty pages
Michael Kerrisk
SEE ALSO: mincore(2)
prctl.2
Michael Kerrisk
Clarify that the ambient capability set is per-thread
Keno Fischer
Be more precise in what causes dumpable to reset
Michael Kerrisk
The no_new_privs setting is per-thread (not per-process)
Michael Kerrisk
Mention /proc/PID/status 'NoNewPrivs' field
Michael Kerrisk
Add reference to seccomp(2) in discussion of PR_SET_NO_NEW_PRIVS
ptrace.2
Omar Sandoval
Clarify description of PTRACE_O_EXITKILL
read.2
Michael Kerrisk [Kai NODA]
Rework text in DESCRIPTION that talks about limits for 'count'
See https://bugzilla.kernel.org/show_bug.cgi?id=86061
Michael Kerrisk [Steven Luo]
Remove crufty text about EINTR and partial read
Remove bogus text saying that POSIX permits partial read
to return -1/EINTR on interrupt by a signal handler.
That statement already ceased to be true in SUSv1 (1995)!
See https://bugzilla.kernel.org/show_bug.cgi?id=193111
readv.2
Michael Kerrisk
Remove generic advice about mixing stdio and syscalls on same file
There is nothing specific to readv()/writev() about this advice.
recv.2
Michael Kerrisk [Vincent Bernat]
Remove duplicate paragraph
man-pages-1.34 included changes that duplicated an existing
paragraph. Remove that duplicate.
Michael Kerrisk
SEE ALSO: add ip(7), ipv6(7), tcp(7), udp(7), unix(7)
remap_file_pages.2
Michael Kerrisk
remap_file_pages() has been replaced by a slower in-kernel emulation
send.2
Michael Kerrisk
SEE ALSO: add ipv6(7), socket(7), unix(7)
setxattr.2
Michael Kerrisk
ERRORS: add EPERM for immutable/append-only files
signalfd.2
Michael Kerrisk
signalfd() doesn't play well with helper programs spawned by libraries
See https://lwn.net/Articles/415684/.
Michael Kerrisk
signalfd can't be used to receive synchronously generated signals
Signals such as the SIGSEGV that results from an invalid
memory access can be caught only with a handler.
stat.2
Michael Kerrisk
EXAMPLE: extend program to also show ID of the containing device
Michael Kerrisk
NOTES: mention fstatat() AT_NO_AUTOMOUNT in discussion of automounting
statfs.2
Namhyung Kim
Add more filesystem types
Add missing magic numbers from /usr/include/linux/magic.h
syscall.2
Mike Frysinger
Add endian details with 64-bit splitting
Architectures that split 64-bit values across register pairs
usually do so according to their C ABI calling convention (which
means endianness). Add some notes to that effect, and change the
readahead example to show a little endian example (since that is
way more common than big endian).
Also start a new list of syscalls that this issue does not apply
to.
Mike Frysinger
Note parisc handling of aligned register pairs
While parisc would normally have the same behavior as ARM/PowerPC,
they decide to write shim syscall stubs to unpack/realign rather
than expose the padding to userspace.
tkill.2
Jann Horn
Document EAGAIN error for real-time signals
truncate.2
Michael Kerrisk
Note use of ftruncate() for POSIX shared memory objects
unlink.2
Michael Kerrisk
ERRORS: add EPERM error for immutable/read-only files
vfork.2
Michael Kerrisk
Explain why the child should not call exit(3)
Michael Kerrisk
Another reason to use vfork() is to avoid overcommitting memory
Michael Kerrisk
Note some caveats re the use of vfork()
Inspired by Rich Felker's post at http://ewontfix.com/7/.
See also https://sourceware.org/bugzilla/show_bug.cgi?id=14749 and
See also https://sourceware.org/bugzilla/show_bug.cgi?id=14750.
Michael Kerrisk
SEE ALSO: add _exit(2)
write.2
Michael Kerrisk [Kai NODA]
Alert the reader that there is a limit on 'count'
See https://bugzilla.kernel.org/show_bug.cgi?id=86061
aio_suspend.3
Michael Kerrisk
Note that the glibc implementation is not async-signal-safe
See https://sourceware.org/bugzilla/show_bug.cgi?id=13172
backtrace.3
Michael Kerrisk
SEE ALSO: add addr2line(1) and gdb(1)
bcmp.3
bcopy.3
bzero.3
memccpy.3
memchr.3
memcmp.3
memcpy.3
memfrob.3
memmem.3
memmove.3
memset.3
Michael Kerrisk
SEE ALSO: add bstring(3)
exec.3
Michael Kerrisk
execl() and execle() were not async-signal-safe before glibc 2.24
fopen.3
Michael Kerrisk [Helmut Eller]
Describe freopen() behavior for NULL pathname argument
See https://bugzilla.kernel.org/show_bug.cgi?id=191261
Michael Kerrisk
Note the open(2) flags that correspond to the 'mode' argument
Michael Kerrisk
Change argument name: 'path' to 'pathname'
For consistency with open(2).
Michael Kerrisk
Add subsection headings for each function
fts.3
Michael Kerrisk
Use better argument name for fts_children() and fts_set()
Michael Kerrisk
Fix minor error in FTSENT structure definition
Michael Kerrisk
Improve explanation of 'fts_errno'
Michael Kerrisk
Give a hint that there are further fields in the FTSENT structure
Michael Kerrisk
Clarify meaning of zero as 'instr' value for fts_set()
ftw.3
Michael Kerrisk
Correctly handle use of stat info for FTW_NS in example program
Michael Kerrisk
Clarify that stat buffer is undefined for FTW_NS
getline.3
Michael Kerrisk
EXAMPLE: better error handling
Michael Kerrisk [Kent Fredic]
EXAMPLE: handle null bytes in input
Jann Horn
Document ENOMEM error case
see the error handling in libio/iogetdelim.c
Michael Kerrisk
EXAMPLE: specify file to be opened as command-line argument
Michael Kerrisk
Use better variable name in example program
getmntent.3
Michael Kerrisk [Anders Thulin]
Prefer '\\' as the escape to get a backslash
See https://bugzilla.kernel.org/show_bug.cgi?id=191611
getopt.3
Michael Kerrisk
Reword discussion of error handling and reporting
The existing description was hard to understand. Break
it into a bullet list that separates out the details
in a manner that is easier to parse.
Michael Kerrisk
Correct details of use of <stdio.h> to get getopt() declaration
Michael Kerrisk [John Wiersba]
Remove some redundant text
mq_open.3
Michael Kerrisk [Adam Martindale]
Include definition of the 'mq_attr' structure in this man page
Make the reader's life a little easier by saving them from
having to refer to mq_getattr(3).
mq_send.3
Michael Kerrisk [Adam Martindale]
Refer to mq_overview(7) for details on range of message priority
__ppc_set_ppr_med.3
Wainer dos Santos Moschetta
Note need for _ARCH_PWR8 macro
The _ARCH_PWR8 macro must be defined to get the
__ppc_set_ppr_very_low() and __ppc_set_ppr_med_high()
definitions.
printf.3
Michael Kerrisk
Document nonstandard 'Z' modifier
Michael Kerrisk
Document 'q' length modifier
Michael Kerrisk [Erik Roland van der Meer]
Fix a small bug in example code
Move the second call to va_end(ap) to above the if-block that
precedes it, so that the va_list 'ap' will be cleaned up in
all cases.
Michael Kerrisk [Nadav Har'El]
As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
See https://bugzilla.kernel.org/show_bug.cgi?id=190341.
Michael Kerrisk
Add references to setlocale(3) in discussions of locales
Michael Kerrisk
SEE ALSO: remove bogus self reference (dprintf(3))
random.3
Michael Kerrisk
Relocate information of "optimal" value of initstate() 'n' argument
The information was a bit hidden in NOTES.
random_r.3
Michael Kerrisk [Jan Ziak]
'buf.state' must be initialized to NULL before calling initstate_r()
See https://bugzilla.kernel.org/show_bug.cgi?id=192801.
Michael Kerrisk
Add some usage notes for setstate_r()
Michael Kerrisk
Note that 'buf' records a pointer to 'statebuf'
See https://sourceware.org/bugzilla/show_bug.cgi?id=3662.
Michael Kerrisk
Add BUGS section pointing out the weirdness of the initstate_r() API
resolver.3
Michael Kerrisk
RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated
These options were never implemented; since glibc 2.25, they
are deprecated.
Michael Kerrisk
The RES_NOIP6DOTINT is removed in glibc 2.25
Michael Kerrisk
Note that RES_BLAST was unimplemented and is now deprecated
Michael Kerrisk
RES_USE_INET6 is deprecated since glibc 2.25
Michael Kerrisk
RES_USEBSTRING was removed in glibc 2.25
resolver.3
resolv.conf.5
Michael Kerrisk
Note that RES_USEBSTRING defaults to off
scandir.3
Michael Kerrisk [Ian Jackson]
Fix errors in example program
See http://bugs.debian.org/848231.
Michael Kerrisk
Improve logic of the example program
scanf.3
Michael Kerrisk
Document the quote (') modifier for decimal conversions
sem_post.3
setjmp.3
Michael Kerrisk
SEE ALSO: add signal-safety(7)
sem_wait.3
Michael Kerrisk [Fabjan Sukalia]
Remove statement that SA_RESTART does not cause restarting
This has not been true since Linux 2.6.22. The description
of EINTR maintains a reference to signal(7), which explains
the historical details.
See https://bugzilla.kernel.org/show_bug.cgi?id=192071
sleep.3
Michael Kerrisk [Mike Frysiner]
Note that sleep() is implemented via nanosleep(2)
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
Michael Kerrisk [Mike Frysinger]
Note that sleep() sleeps for a real-time number of seconds
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
Michael Kerrisk
Convert BUGS text to "Portability notes" subsection
The existing text is not a bug, as such.
Michael Kerrisk
DESCRIPTION: minor reworking
strerror.3
Heinrich Schuchardt
Indicate reasonable buffer size for strerror_r() and strerror_l()
Add a hint which buffer size is needed for
strerror_r() and strerror_l().
strverscmp.3
Michael Kerrisk [Vivenzio Pagliari]
Fix comparison error in example program
system.3
Michael Kerrisk
In the glibc implementation, fork handlers are not executed by system()
random.4
Michael Kerrisk [Jon Jensen]
Note that entropY-avail will be a number in the range 0..4096
core.5
Michael Kerrisk
Clarify that dumping program's initial CWD is root directory
Michael Kerrisk
The target of core dump piping can also be a script
filesystems.5
Michael Kerrisk
SEE ALSO: add btrfs(5), nfs(5), tmpfs(5)
intro.5
Michael Kerrisk
Document the reality that by now Section 5 also covers filesystems
There are by now, from various filesystem projects, various
pages in Section 5 that document different filesystems.
Change intro(5) to reflect that.
Documented after following: http://bugs.debian.org/847998
proc.5
Mike Frysinger [Michael Kerrisk]
Clarify /proc/pid/environ behavior
/proc/pid/environ reflects process environment at
*start* of program execution; it is set at time of execve(2)
Michael Kerrisk
Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field
Michael Kerrisk
Add entries for "keys" files that refer reader to keyrings(7)
Michael Kerrisk
Remove duplicate /proc/[pid]/seccomp entry
Michael Kerrisk
Mention other system calls that create 'anon_inode' file descriptors
Mention a few other system calls that create file descriptors
that display an 'anon_inode' symlink in /proc/PID/fd
Michael Kerrisk
Add some detail on overcommit_memory value 1
Michael Kerrisk
Add reference to vdso(7) in discussion of /proc/PID/maps
resolv.conf.5
Michael Kerrisk
ip6-bytestring was removed in glibc 2.25
Michael Kerrisk
The ipc-dotint and no-ip6-dotint options were removed in glibc 2.25
Michael Kerrisk
The 'inet6' option is deprecated since glibc 2.25
slabinfo.5
Michael Kerrisk
SEE ALSO: add slabtop(1)
capabilities.7
Michael Kerrisk [Casey Schaufler]
Add subsection with notes to kernel developers
Provide some notes to kernel developers considering how to choose
which capability should govern a new kernel feature.
Michael Kerrisk
Further enhance the recommendation against new uses of CAP_SYS_ADMIN
Michael Kerrisk
Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers"
Michael Kerrisk
Add another case for CAP_DAC_READ_SEARCH
Michael Kerrisk
Refer to execve(2) for the reasons that file capabilities may be ignored
Michael Kerrisk
Document a new use of CAP_SYS_RESOURCE
Michael Kerrisk
Add some more operations governed by CAP_SYS_ADMIN
Michael Kerrisk
Adjust references to chattr(1) to point to ioctl_iflags(2)
environ.7
Michael Kerrisk
Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations
inotify.7
Michael Kerrisk
Point out that inotify monitoring is inode based
ip.7
Michael Kerrisk
SEE ALSO: add ip(8)
man.7
uri.7
Jakub Wilk
Use "www.kernel.org" in example URLs
Apparently www.kernelnotes.org is now a spam site.
mount_namespaces.7
Michael Kerrisk [Rob Landley]
Rework the discussion of defaults for mount propagation types
Add rather more detail. In particular, note the cases where the
default propagation type is MS_PRIVATE vs MS_SHARED.
namespaces.7
Michael Kerrisk
EXAMPLE: fix an error in shell session
Michael Kerrisk
EXAMPLE: rename the example program
Use a more generic name, since this program may be expanded
in various ways in the future.
Michael Kerrisk
SEE ALSO: add ip-netns(8)
Michael Kerrisk
Remove content split out into ioctl_ns(2)
netlink.7
Michael Kerrisk
NETLINK_IP6_FW went away in Linux 3.5
Michael Kerrisk
NETLINK_W1 went away in Linux 2.6.18
Michael Kerrisk
Add NETLINK_SCSITRANSPORT to list
Michael Kerrisk
Add NETLINK_RDMA to list
Michael Kerrisk
NETLINK_FIREWALL was removed in Linux 3.5
Michael Kerrisk
NETLINK_NFLOG was removed in Linux 3.17
Jakub Wilk
Update libnl homepage URL
The original URL is 404.
pid_namespaces.7
user_namespaces.7
Michael Kerrisk
Adjust references to namespaces(7) to ioctl_ns(2)
pid_namespaces.7
Keno Fischer
CLONE_SIGHAND|CLONE_VM|CLONE_NEWPID is no longer disallowed
pipe.7
Michael Kerrisk
Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity
Michael Kerrisk
Clarify that default pipe capacity is 16 pages
The statement that the default pipe capacity is 65536 bytes
is accurate only on systems where the page size is 4096B.
See the use of PIPE_DEF_BUFFERS in the kernel source.
random.7
Michael Kerrisk
Mention getentropy(3)
Michael Kerrisk
SEE ALSO: add getentropy(3)
Michael Kerrisk
SEE ALSO: add getauxval(3)
A small hint to the reader that some random bytes arrive
in the auxiliary vector.
signal.7
Michael Kerrisk
SIGSYS: add reference to seccomp(2)
Michael Kerrisk
Change description of SIGSYS to "Bad system call"
This is the more typical definition.
Michael Kerrisk
SIGPIPE: add reference to pipe(7)
Michael Kerrisk
SIGXFSZ: add reference to setrlimit(2)
Michael Kerrisk
Add a name for SIGEMT
Michael Kerrisk
SIGXCPU: add reference to setrlimit(2)
Michael Kerrisk
Migrated signal-safety discussion to new signal-safet(7) page
unix.7
Michael Kerrisk [Sergey Polovko]
Since Linux 3.4, UNIX domain sockets support MSG_TRUNC
This was correctly noted in recv(2), but the unix(7) page
was not correspondingly updated for the Linux 3.4 change.
Michael Kerrisk [Willy Tarreau]
Document ETOOMANYREFS for SCM_RIGHTS send exceeding RLIMIT_NOFILE limit
user_namespaces.7
Michael Kerrisk
Change page cross reference: keyctl(2) ==> keyrings(7)
ld.so.8
Michael Kerrisk
LD_BIND_NOT has effect only for function symbols
Michael Kerrisk
Describe use of LD_DEBUG with LD_BIND_NOT
Michael Kerrisk
In secure mode, LD_AUDIT restricts the libraries that it will load
Michael Kerrisk
LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
|