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
|
==================== Changes in man-pages-3.43 ====================
Released: 2012-10-05, 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:
Adrian Bunk <bunk@kernel.org>
Anatoli Klassen <anatoli@aksoft.net>
Andreas Schwab <schwab@linux-m68k.org>
Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
David Prévot <taffit@debian.org>
Eric Dumazet <edumazet@google.com>
Florian Weimer <fweimer@redhat.com>
Frédéric Brière <fbriere@fbriere.net>
Fredrik Arnerup <arnerup@kth.se>
Guillem Jover <guillem@hadrons.org>
Jan Engelhardt <jengelh@inai.de>
Michael Kerrisk <mtk.manpages@gmail.com>
Simon Josefsson <simon@josefsson.org>
Stephane Fillod <fillods@users.sf.net>
Trevor Woerner <twoerner@gmail.com>
Yuri Kozlov <yuray@komyakino.ru>
Apologies if I missed anyone!
Newly documented interfaces in existing pages
---------------------------------------------
getenv.3
Michael Kerrisk [Florian Weimer, Andreas Schwab]
Document secure_getenv(3)
New and changed links
---------------------
phys.2
Michael Kerrisk
New link to unimplemented.2
secure_getenv.3
Michael Kerrisk
New link to getenv.3
Global changes
--------------
Various pages
Michael Kerrisk
Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
Various pages
David Prévot [Michael Kerrisk]
Global fix: Various consistency fixes for SEE ALSO
Various pages
Michael Kerrisk
Global fix: use "Linux kernel source" consistently
Rather than "kernel source".
Various pages
Michael Kerrisk
Global fix: disable justification and hyphenation in SEE ALSO
For a better visual result, disable justification and hyphenation
in SEE ALSO where page names are long.
Changes to individual pages
---------------------------
epoll_wait.2
Michael Kerrisk [Fredrik Arnerup]
Describe timeout limitation in kernels < 2.6.37
As reported by Fredrik (and as far as I can tell the problem
went back to 2.6.0):
The timeout argument has an upper limit. Any values above that
limit are treated the same as -1, i.e. to wait indefinitely.
The limit is given by:
#define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
(LONG_MAX - 999ULL) / HZ)
That is, the limit depends on the size of a long and the timer
frequency. Assuming the a long is never smaller than 32 bits
and HZ never larger than 1000, the worst case is 35 minutes.
I think this should be mentioned under "BUGS".
Although this is likely to be fixed in the future
(http://lkml.org/lkml/2010/8/8/144), the problem exists in
at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
are affected.
https://bugzilla.kernel.org/show_bug.cgi?id=20762
Michael Kerrisk
Add pointer to select(2) for discussion of close in another thread
getitimer.2
Michael Kerrisk [Trevor Woerner]
Note Linux's odd handling of the new_value==NULL case
Michael Kerrisk [Trevor Woerner]
Fix types used to declare fields in timeval struct
keyctl.2
David Prévot
Reorder SEE ALSO, without .br
poll.2
Michael Kerrisk
Add pointer to select(2) for discussion of close in another thread
select.2
Michael Kerrisk [Stephane Fillod]
Note behavior if monitored file descriptor is closed in another thread
Executive summary: a sane application can't rely on any
particular behavior if another thread closes a file descriptor
being monitored by select().
See https://bugzilla.kernel.org/show_bug.cgi?id=40852
Michael Kerrisk
Clarify equivalent pselect() code in terms of threads
s/sigprogmask/pthread_sigmask/
semop.2
Michael Kerrisk
Recast discussion of blocking behavior in terms of threads
semop() blocks the calling thread, not the process.
Michael Kerrisk
SEE ALSO: Add clone(2)
Give reader a clue about CLONE_SYSVSEM.
shutdown.2
Michael Kerrisk [Eric Dumazet]
Document EINVAL error (and associated bug)
Eric Dumazet noted that EINVAL was not documented. Some further
digging shows that it's also not diagnosed consistently.
See https://bugzilla.kernel.org/show_bug.cgi?id=47111.
sigaction.2
Michael Kerrisk
Tweak SA_RESETHAND description
syscalls.2, uname.2, boot.7
Michael Kerrisk
Global fix: s/OS/operating system/
timer_settime.2
Michael Kerrisk
Small rewording around discussion of pointer arguments
wait4.2
Adrian Bunk
Note that these functions are nonstandard and recommend alternatives
Some edits to Adrian's path by mtk.
Michael Kerrisk
CONFORMING TO: Note SUS details for wait3()
gnu_get_libc_version.3
Michael Kerrisk
Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
pthread_kill.3, pthread_sigqueue.3
Michael Kerrisk
Remove wording "another"
Writing "another thread" in these pages implies that these
functions can't be used to send a signal to the calling thread
itself, which is of course untrue.
sigvec.3
Michael Kerrisk
Add "int" arg to sv_handler definition in sigvec structure
Michael Kerrisk
Fix small error in discussion of blocking of signals
The signal that causes the handler to be invoked is blocked,
but saying "by default" implies that this can be changed via
the API. It cannot. (One needs sigaction(2) for that.)
syslog.3
Simon Josefsson
Remove (apparently bogus) text claiming LOG_AUTH is deprecated
LOG_AUTH is in POSIX, and widely available. There
seems to be no basis to the claim it is deprecated.
Quoting Simon:
I cannot find any other source that claim LOG_AUTH is
deprecated in any way. LOG_AUTH is distinct from
LOG_AUTHPRIV. The GNU C Library manual only documents
LOG_AUTH. The header files contains both without any
comment. Common systems like Debian appear to refer to
both auth and authpriv facilities in syslog configurations.
Popular daemons appear to use both facilities.
Both facilities are discussed in several RFCs.
See https://bugzilla.kernel.org/show_bug.cgi?id=46091
ttyname.3
Michael Kerrisk
SEE ALSO: Add ctermid(3)
proc.5
Michael Kerrisk
Clarify header file related to 'flags' field of /proc/PID/stat
Michael Kerrisk [Frédéric Brière]
Update description of 'starttime' field of /proc/PID/stat
The unit of measurement changed from jiffies to clock ticks in
Linux 2.6.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891
Michael Kerrisk
Document /proc/sys/kernel/kptr_restrict
Michael Kerrisk [Kees Cook]
Document /proc/sys/fs/protected_symlinks
Based on text in Documentation/sysctl/fs.txt by Kees Cook
Michael Kerrisk [Kees Cook]
Document /proc/sys/fs/protected_hardlinks
Based on text in Documentation/sysctl/fs.txt by Kees Cook
capabilities.7
Michael Kerrisk
Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
ip.7
Michael Kerrisk
SEE ALSO: Add ipv6(7)
SEE ALSO: Add icmp(7)
man-pages.7
Michael Kerrisk
Add some advice about disabling hyphenation in SEE ALSO
ld.so.8
Michael Kerrisk
Describe interpretation of slashes in dependency strings
Michael Kerrisk
Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
This point is already noted when discussing search order for
libraries, but it's worth repeating under the specific discussion
of LD_LIBRARY_PATH further down the page.
Michael Kerrisk
Add some details for LD_PRELOAD
Note that LD_PRELOAD list separator can be space or colon
|
