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
|
==================== Changes in man-pages-2.65 ====================
Released: 2007-??-??
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Aleksandr Koltsoff <czr@iki.fi>
Andi Kleen <ak@suse.de>
Anton Blanchard <anton@samba.org>
Ari Entlich <lmage11@twcny.rr.com>
Carsten Emde <Carsten.Emde@osadl.org>
François Diakhate <diakhate@enseirb.fr>
Geoff Clare <gclare@gclare.org.uk>
Jon Burgess <jburgess777@googlemail.com>
Julien Cristau <jcristau@debian.org>
Lee Schermerhorn <Lee.Schermerhorn@hp.com>
Mats Wichmann <mats.d.wichmann@intel.com>
Maxime Bizon <mbizon@freebox.fr>
Maxime Vaudequin <maxime.vaudequin@gmail.com>
Michael Prokop <mika@grml.org>
Mike Frysinger <vapier@gentoo.org>
Nicolas François <nicolas.francois@centraliens.net>
Nicolas George <nicolas.george@ens.fr>
Paul Brook <paul@nowt.org>
Reuben Thomas <rrt@sc3d.org>
Sam Varshavchik <mrsam@courier-mta.com>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Thomas Huriaux <thomas.huriaux@gmail.com>
Tolga Dalman <tdalman@project-psi.org>
Ulrich Drepper <drepper@redhat.com>
Vincent Lefevre <vincent@vinc17.org>
Apologies if I missed anyone!
Global changes
--------------
Typographical or grammatical errors have been corrected in several
places.
Various pages
mtk
Use 'glibc' consistently to refer to GNU C library.
Various pages
mtk
Order errors under ERRORS alphabetically.
Various pages
Nicolas François
Spelling and formatting fixes, as per Debian bug 439560.
intro.2
select.2
fmtmsg.3
getgrent_r.3
envz_add.3
rtime.3
strptime.3
wordexp.3
Maxime Vaudequin
Add "#include <stdlib.h>" (to declare exit(3)) to example program.
New pages
---------
timeradd.3
mtk
Description of timeradd(), timersub(), timerclear(),
timerisset(), timercmp() macros for operating on
struct timeval.
Removed pages
-------------
fdatasync.2
mtk
Somehow, over time, material on fdatasync(2) crept into
fsync.2, and fdatasync also got added to the NAME section
of fsync.2. All of the material in fdatasync.2 that was
not already in fsync.2 has now been moved there, and
the former page has been removed.
In place of the content there, is now a link to fsync.2.
New links
---------
clock_getres.2
clock_gettime.2
clock_settime.2
mtk
Link to man3/clock_getres.3.
fdatasync.2
mtk
Link to fsync.2.
fdopendir.3
mtk
Link to opendir.3.
gethostbyaddr_r.3
Mats Wichmann
Link to gethostbyaddr.3.
timerclear.3
timercmp.3
timerisset.3
timersub.3
mtk
Links to new timeradd.3.
Changes to individual pages
---------------------------
Makefile
Mike Frysinger
Make the install target of man-pages respect the standard
"DESTDIR" variable as well as check the exit status of the
install command so errors aren't ignored.
get_mempolicy.2
Lee Schermerhorn
changed the "policy" parameter to "mode" through out the
descriptions in an attempt to promote the concept that the memory
policy is a tuple consisting of a mode and optional set of nodes.
added requirement to link '-lnuma' to synopsis
rewrite portions of description for clarification.
added all errors currently returned by sys call.
removed cautionary note that use of MPOL_F_NODE|MPOL_F_ADDR
is not supported. This is no longer true.
added mmap(2) to See Also list.
getitimer.2
mtk
Since kernel 2.6.22, Linux setitimer() now conforms to POSIX.1,
giving an EINVAL error for a non-canonical tv_usec value.
gettimeofday.2
mtk
Replace discussion of timer* macros with a pointer
to new page timeradd.3.
ioctl_list.2
Nicolas George
Fixed argument type for BLKGETSIZE.
mbind.2
Lee Schermerhorn
changed the "policy" parameter to "mode" throughout the
descriptions in an attempt to promote the concept that the memory
policy is a tuple consisting of a mode and optional set of nodes.
rewrite portions of description for clarification.
clarify interaction of policy with mmap()'d files and shared
memory regions, including SHM_HUGE regions.
defined how "empty set of nodes" specified and what this
means for MPOL_PREFERRED.
mention what happens if local/target node contains no
free memory.
clarify semantics of multiple nodes to BIND policy.
Note: subject to change. We'll fix the man pages when/if
this happens.
added all errors currently returned by sys call.
added mmap(2), shmget(2), shmat(2) to See Also list.
mmap.2
mprotect.2
François Diakhate
Add text noting that PROT_WRITE may (and on x86 does)
imply PROT_READ.
See Debian bug 441387.
nfsservctl.2
Aleksandr Koltsoff
Fix prototype.
oldfstat.2
oldlstat.2
oldstat.2
mtk
Fix broken link
prctl.2
mtk
Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.
readahead.2
mtk
Removed SEE ALSO reference to nonexistent fadvise.2.
reboot.2
mtk
Place SYNOPSIS comments inside C comments (/* ... */).
sched_setaffinity.2
Samuel Thibault
Note what thread is affected if 'pid' is specified
as 0, or as the value returned by getpid().
sched_setscheduler.2
Carsten Emde
Add text on real-time features of mainline Linux kernel.
select.2
mtk
sync SYNOPSIS with select.2
set_mempolicy.2
Lee Schermerhorn
changed the "policy" parameter to "mode" throughout the
descriptions in an attempt to promote the concept that the memory
policy is a tuple consisting of a mode and optional set of nodes.
added requirement to link '-lnuma' to synopsis
rewrite portions of description for clarification.
clarify interaction of policy with mmap()'d files.
defined how "empty set of nodes" specified and what this
means for MPOL_PREFERRED.
mention what happens if local/target node contains no
free memory.
clarify semantics of multiple nodes to BIND policy.
Note: subject to change. We'll fix the man pages when/if
this happens.
added all errors currently returned by sys call.
added mmap(2) to See Also list.
sigaction.2
mtk
s/si_sign/si_errno/ in statement about which field is unused.
Ari Entlich
s/SIGILL/SIGCHLD/ for paragraph describing SIGCHLD.
stat.2
mtk
Improve text describing underlying system calls.
swapon.2
Michael Prokop
EINVAL also occurs if target path is on tmpfs or similar.
See Debian bug 435885.
sync.2
mtk
Incorporated material from now deleted fdatasync.2.
syscall.2
mtk
Small fix in example program.
uname.2
mtk
Improve text describing underlying system calls.
utime.2
Vincent Lefevre / mtk
Clarify utimes() behaviour when 'times' is NULL.
See Debian bug 431480.
mtk
Other minor clarifications of description of utimes().
copysign.3
Vincent Lefevre
s/sign/sign bit/ to remove ambiguity in description.
See Debian bug 435415.
euidaccess.3
mtk
Changed NOTES to VERSIONS.
ffsl.3
mtk
Add ffsl and ffsll to NAME line.
fts.3
mtk
Removed statement that fts functions are expected to appear
soon in POSIX; it's years old and has not yet come to pass.
ftw.3
mtk / Geoff Clare
Fixes/improvements for example program.
getdate.3
mtk
Add getdate_r to NAME section.
getaddrinfo.3
mtk / Geoff Clare
Fixes/improvements for example program.
gethostbyaddr.3
Mats Wichmann
Add documentation for gethostbyaddr_r().
Plus a few other small fixes.
gethostbyname.3
mtk
Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
gethostent_r to NAME line.
getmntent.3
mtk
Fix misnamed function references.
getopt.3
Jon Burgess
Fix small error in example program.
getrpcent.3
mtk
Add setrpcent and endrpcent to NAME line.
gsignal.3
Aleksandr Koltsoff
Fix gsignal() prototype.
hsearch.3
mtk
Add hcreate_r, hdestroy_r, hsearch_r to NAME line.
inet.3
Maxime Bizon
Correct definition of "struct in_addr".
isatty.3
mtk
Minor wording fix.
isgreater.3
mtk
Add islessequal to NAME line.
lgamma.3
Vincent Lefevre
Fix CONFORMING TO section.
See Debian bug 417592.
log1p.3
mtk
Add log1pf and log1pl to NAME line.
longjmp.3
Paul Brook / mtk
After a call to longjmp(), the values of modified, non-volatile
variables in the function that called setjmp() are unspecified.
makecontext.3
Aleksandr Koltsoff
Fix makecontext() prototype.
malloc.3
mtk / Tolga Dalman
Explain what happens for malloc(0), or calloc() where one of the
arguments is 0.
mtk
Added notes on malloc()'s use of sbrk() and mmap().
mtk
Add mmap(2), alloca(3) to SEE ALSO.
mq_close.3
mq_getattr.3
mq_notify.3
mq_open.3
mq_receive.3
mq_send.3
mq_unlink.3
mtk
Add "Link with -lrt." to SYNOPSIS.
opendir.3
Ulrich Drepper; some edits and additional text by mtk
Document fdopendir().
readdir.3
mtk, after a note by Andi Kleen
Document DT_* constants for d_type.
Ulrich Drepper / mtk
Rework discussion of non-standard structure fields.
sem_wait.3
mtk
Minor improvements to example program.
syslog.3
mtk
Add vsyslog to NAME section.
termios.3
Nicolas François
Fix XCASE feature test macro description.
wcsspn.3
Aleksandr Koltsoff
Add return type to prototype.
proc.5
mtk
Improve description of num_threads field under /proc/PID/stat.
Maxime Vaudequin
Fix path error (s%proc/sys%proc/sys/kernel%) in mentions of
/proc/sys/ostype, /proc/sys/osrelease and proc/sys/version.
Maxime Vaudequin
I noticed things to correct and to clarify in subsection
"/proc/filesystems" of proc.5:
- clarify filesystems listing: not only FS compiled
into the kernel, also FS kernel modules currently loaded
- add a reference to fs(5)
- add an explanation for FS marked with "nodev"
- s/mount(1)/mount(8)/, also corrected in section "SEE ALSO"
- clarify usage by mount: the current wording may lead to
think /proc/filesystems is always used by mount when no FS
is specified. So, usage of "may" which IMHO is more
appropriate + additional explanations
In mount(8) we can see:
If no -t option is given, or if the auto type is
specified, mount will try to guess the desired type.
If mount was compiled with the blkid library, the
guessing is done by this library. Otherwise, mount
guesses itself by probing the superblock; if that
does not turn up anything that looks familiar,
mount will try to read the file /etc/filesystems,
or, if that does not exist, /proc/filesystems.
All of the filesystem types listed there will be
tried, except for those that are labeled "nodev"
(e.g., devpts, proc and nfs). If /etc/filesystems
ends in a line with a single * only, mount will
read /proc/filesystems afterwards.
Samuel Thibault
Since linux 2.6.11, /proc/stat has an eighth value for cpu
lines: stolen time, which is the time spent in other operating
systems when running in a virtualized environment.
arp.7
Updated BUGS text referring to jiffies; refer to time.7 instead.
credentials.7
mtk
Add words to note that file system ID is Linux specific.
hier.7
Maxime Vaudequin
This is some corrections for hier.7:
- missing period for /media and /mnt
- /mnt description is not totally correct, it is true for some
distributions but in others /mnt is used as a temporary FS
mount point, as it is specified by FHS:
http://www.pathname.com/fhs/pub/fhs-2.3.html#
MNTMOUNTPOINTFORATEMPORARILYMOUNT
- s/X-Windows/X-Window/ (3 occurrences)
- section "SEE ALSO": s/mount(1)/mount(8)/
man-pages.7
man.7
mdoc.7
mdoc.samples.7
mtk / Nicolas François
Nowadays tmac.XXX are called XXX.tmac.
pthreads.7
mtk
Update text about modern threading implementations
(NPTL vs LinuxThreads).
socket.7
mtk, after a note by Andi Kleen
Clarify that SO_SNDTIMEO and SO_RCVTIMEO only have effect for
socket I/O calls; not for multiplexing system calls like
select() and poll().
time.7
mtk
Add SEE ALSO reference to new timeradd.3.
|