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
|
==================== Changes in man-pages-2.80 ====================
Released: 2008-06-04
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Adrian Bunk <bunk@kernel.org>
Alain Portal <aportal@univ-montp2.fr>
Andreas Herrmann <andreas.herrmann3@amd.com>
Andrew Morton <akpm@linux-foundation.org>
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Anoop <acv@linux.vnet.ibm.com>
Aurelien Gerome <ag@roxor.cx>
Daniel Burr <dburr@topcon.com>
Davide Libenzi <davidel@xmailserver.org>
Felix Kater <fkater@googlemail.com>
Folkert van Heusden <folkert@vanheusden.com>
Hamaji Shinichiro <shnichiro.hamaji@gmail.com>
Heikki Orsila <shd@modeemi.fi>
Ingo Molnar <mingo@elte.hu>
Justin Pryzby <justinpryzby@users.sourceforge.net>
Karsten Weiss <K.Weiss@science-computing.de>
Martin Pitt <mpitt@debian.org>
Marty Leisner <leisner@rochester.rr.com>
Nicolas François <nicolas.francois@trialog.com>
Nick Piggin <npiggin@suse.de>
Petter Reinholdtsen <pere@hungry.com>
Reuben Thomas <rrt@sc3d.org>
Sam Varshavchik <mrsam@courier-mta.com>
Stuart Brady <sdbrady@ntlworld.com>
Theodoros V. Kalamatianos <thkala@softlab.ece.ntua.gr>
Thomas Huriaux <thomas.huriaux@gmail.com>
Tim Stoakes <tim@stoakes.net>
Timothy Baldwin <T.E.Baldwin99@members.leeds.ac.uk>
Tolga Dalman <tdalman@project-psi.org>
Apologies if I missed anyone!
Global changes
--------------
bdflush.2
inotify_add_watch.2
mprotect.2
sigprocmask.2
ctime.3
getusershell.3
setbuf.3
st.4
ip.7
packet.7
mtk
Replace "(il)legal" by "(not) permitted" or "(in)valid".
read.2
utime.2
filesystems.5
packet.7
mtk
s/time stamp/timestamp/, for consistency with majority use
in other pages, and in POSIX.1.
madvise.2
mbind.2
mincore.2
mmap.2
mmap2.2
msync.2
remap_file_pages.2
mtk
Change name of 'start' argument to 'addr' for consistency
with:
* other memory-related interfaces
* POSIX specification (for those interfaces in POSIX)
* Linux and glibc source code (in at least some cases)
Various pages
mtk
s/filesystem/file system/, for consistency with majority use
in other pages, and in POSIX.1.
Various pages
mtk
s/zeroes/zeros/, for consistency with majority use
in other pages, and in POSIX.1.
abs.3
proc.5
mtk
s/builtin/built-in/, for consistency with majority use
in other pages, and in POSIX.1.
mknod.2
ftw.3
mtk
s/normal file/regular file/
Various pages
mtk
s/nonempty/non-empty/
Various pages
mtk
s/nonzero/non-zero/
Various pages
mtk
s/realtime/real-time/, for consistency with majority usage.
Various pages
mtk
s/command line/command-line/ when used attributively.
Various pages
mtk
Use "run time" when non-attributive, "run-time" when attributive.
Various pages
mtk
Various pages that I wrote carried a slightly modified version
of the "verbatim" license. In the interests of minimizing
license proliferation, I've reverted the modified form
so that the license is exactly the same as on other pages
carrying the verbatim license.
epoll_ctl.2
getitimer.2
getrlimit.2
unix.7
mtk
s/since kernel x.y.z/since Linux x.y.z/
wait.2
inotify.7
mtk
Reformat kernel version information for flags.
Typographical or grammatical errors have been corrected in several places.
(Special thanks to Nicolas François.)
New pages
---------
random_r.3
mtk, after a suggestion by aeb
Documents random_r(3), srandom_r(3), initstate_r(2), and
setstate_r(3), which are the reentrant equivalents of
random(3), srandom(3), initstate(3), and setstate(3).
New links
---------
lutimes.3
mtk
Link to futimes.3.
initstate_r.3
setstate_r.3
srandom_r.3
mtk
Links to random_r.3.
daylight.3
timezone.3
tzname.3
mtk
Links to tzset.3.
isnanf.3
isnanl.3
mtk
Links to finite.3.
encrypt_r.3
setkey_r.3
mtk
Links to encrypt.3.
Changes to individual pages
---------------------------
clone.2
mtk
Added note that CLONE_STOPPED (which no-one uses anyway) is
now deprecated.
epoll_create.2
mtk
Add NOTES section pointing out that 'size' argument is unused
since kernel 2.6.8.
epoll_ctl.2
mtk
Added portability note to BUGS text for EPOLL_CTL_DEL.
epoll_wait.2
mtk
If the 'sigmask' is NULL, then epoll_pwait() is equivalent
to epoll_wait().
fork.2
mtk
NOTES: since glibc 2.3.3, the glibc NPTL fork() wrapper
bypasses the fork() system call to invoke clone() with
flags providing equivalent functionality.
futex.2
mtk, after a note from Adrian Bunk
FUTEX_FD has been removed, as of kernel 2.6.26.
futimesat.2
mtk
Note that this system call is made obsolete by utimensat(2).
getgroups.2
Petter Reinholdtsen
SEE ALSO: Add getgrouplist(3).
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
mtk
NGROUPS_MAX increased in kernel 2.6.4.
SEE ALSO: Add credentials(7).
mtk
Reformat DESCRIPTION and RETURN VALUE sections to be more
consistent with man-pages style.
Add some more detail to descriptions of system calls.
Clarified what happens if caller of getgroups() is a member of
more than 'size' supplementary groups.
ERRORS: Add ENOMEM.
getpriority.2
mtk, after a note from Ingo Molnar
Add text in NOTES about the punchier effect of nice values in
kernel 2.6.23 and later.
Add Documentation/scheduler/sched-nice-design.txt to SEE ALSO list.
gettid.2
mtk
Added VERSIONS section noting that this system call first
appeared in 2.4.11.
kill.2
Marty Leisner / mtk
Add text explicitly noting that sig==0 can be used to check for
the existence of a PID or PGID.
mtk
A few minor rewordings.
mbind.2
mtk
The location of the numactl package has changed.
mmap.2
mtk
Added some .SS headings to make structure of page a little
more obvious.
mtk, with input from Nick Piggin
MAP_POPULATE supports both file and anonymous mappings.
Since 2.6.23, MAP_POPULATE supports private mappings.
Since 2.6.23, MAP_NONBLOCK causes MAP_POPULATE to be a no-op.
mtk
NOTES: Added details on mapping address that is selected by
kernel when MAP_FIXED is / isn't specified.
mount.2
mtk
The MS_REMOUNT changes in 2.4 were at 2.4.10 (not 2.4).
mtk
Minor wording change.
msgctl.2
mtk
Clarify that "unused" fields in msginfo structure are
"unused within the kernel".
msginfo.msgpool is measured in kilobytes, not bytes.
Minor rewordings in comments for msginfo structure.
msgop.2
mtk
Various minor rewordings and restructurings for clarity.
mtk, after a note from Reuben Thomas
Remove "msgop" from NAME section.
mkdir.2
mtk
Clarify meaning of "BSD group semantics".
SEE ALSO: add chown(2).
mknod.2
mtk
SEE ALSO: add chown(2) and chmod(2).
mmap.2
mtk
SEE ALSO: add mprotect(2) and shmat(2).
mprotect.2
Hamaji Shinichiro
SYNOPSIS: s/size_t \*len/size_t len/
open.2
mtk
Note that O_CLOEXEC should be in the next POSIX.1 revision.
mtk
More than just ext2 supports "mount -o bsdgroups" nowadays,
so make the discussion about group ownership of new files a bit
more generic.
mtk
SEE ALSO: add chown(2) and chmod(2).
poll.2
mtk
If the 'sigmask' is NULL, then ppoll() is equivalent to poll()
with respect to signal mask manipulations.
posix_fadvise.2
mtk
s/posix_madvise (2)/posix_madvise (3)/;
(The referred-to page still doesn't exist yet, but hopefully
will do sometime soon.)
ptrace.2
Anoop, Acked by Roland McGrath.
Re PTRACE_PEEKUSER: the offsets and data returned might not
match with the definition of struct user.
See also http://lkml.org/lkml/2008/5/8/375
recv.2
Felix Kater / mtk
Improve wording for EAGAIN error in discussion of MSG_DONTWAIT.
rmdir.2
Martin Pitt
POSIX.1 also allows EEXIST for the ENOTEMPTY error condition.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=467552.
sched_setscheduler.2
mtk, with input from Ingo Molnar
Add description of SCHED_IDLE policy (new in 2.6.23).
Tweak description of SCHED_BATCH.
Minor rewordings.
select_tut.2
Justin Pryzby
Various wording clean-ups.
semctl.2
mtk
Clarify that "unused" fields in seminfo structure are
"unused within the kernel".
Minor rewordings in comments for seminfo structure.
semop.2
Aurelien Gerome
Small fix in example code.
setpgid.2
mtk / Karsten Weiss
Clarify description of setpgid() a little.
shmctl.2
mtk
Clarify that "unused" fields in shminfo structure are
"unused within the kernel".
Minor rewordings in comments for shminfo structure.
shmop.2
mtk, after a note from Reuben Thomas
Remove "shmop" from NAME section.
signalfd.2
mtk
Added BUGS text noting that before kernel 2.6.25, the ssi_int
and ssi_ptr fields are not set.
Added comments describing fields in signalfd_siginfo structure.
Update field names in example program (s/signo/ssi_signo/).
Various small fixes, and remove duplicated sentence.
Minor edits to structure definition.
sigqueue.2
mtk
Added some comments to code in NOTES.
stat.2
mtk
Minor wording change.
symlink.2
mtk
SEE ALSO: add lchown(2).
sync_file_range.2
mtk / Andrew Morton
Remove statement that (SYNC_FILE_RANGE_WAIT_BEFORE |
SYNC_FILE_RANGE_WRITE | SYNC_FILE_RANGE_WAIT_AFTER) is
a traditional fdatasync(2) operation.
See https://bugzilla.mozilla.org/show_bug.cgi?id=421482
comments 129 to 131.
syscalls.2
mtk
This page is now up to date as at kernel 2.6.25.
syslog.2
mtk
Small tidy up of language relating to permissions/capabilities.
timerfd_create.2
mtk
Minor change to example program.
Minor wording change.
utime.2
Reuben Thomas
Remove unnecessary subheading for utimes().
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=477402.
mtk
Change description in NAME line ("or" is not correct: these calls
always change *both* timestamps).
CONFORMING TO: utimes() is in POSIX.1-2001.
mtk
Rename 'buf' argument of utime() to 'times' (like utimes()).
Clarify explanation of EACCES and EPERM errors.
Remove BUGS section, since it doesn't seem to add useful
information.
Clarified discussion of capabilities, and noted that
CAP_DAC_OVERRIDE also has a role.
Other minor rewordings.
wait.2
mtk, after a note by Justin Pryzby
Add a sentence clarifying that even though the default disposition
of SIGCHLD is "ignore", explicitly setting the disposition to
SIG_IGN results in different treatment of zombies.
aio_cancel.3
aio_error.3
aio_fsync.3
aio_read.3
aio_return.3
aio_suspend.3
aio_write.3
Kevin O'Gorman <kogorman@csc.calpoly.edu>
Add "Link with -lrt" to SYNOPSIS.
backtrace.3
Nicolas François
s/backtrace_symbols/backtrace_symbols_fd/ in one sentence.
mtk
Fix bogus reference to variable 'strings': should be:
"the array of pointers".
ctime.3
mtk
Add warning under NOTES that asctime(), ctime(), gmtime(), and
localtime() may each overwrite the static object returned by any
of the other calls.
Other minor edits.
dlopen.3
mtk
Add more detail to the description of the fields in the
structure returned by dladdr().
fexecve.3
mtk
Clean up SYNOPSIS after work by cut-and-paste-Pete:
the necessary header file is <unistd.h> not <sys/time.h>!
futimes.3
mtk
Add documentation of lutimes(), which appeared in glibc 2.6.
mtk
Change description in NAME line ("or" is not correct: these calls
always change *both* timestamps).
CONFORMING TO: futimes() did not come from 4.2BSD. (It came from
FreeBSD; see the FreeBSD man page.)
getenv.3
mtk
Noted that caller must not modify returned value string.
Noted that getenv() is not reentrant: the buffer may be statically
allocated and overwritten by later calls to getenv(), putenv(),
setenv(), or unsetenv().
Other minor rewrites.
getgrent.3
Petter Reinholdtsen
SEE ALSO: Add getgrouplist(3).
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
gethostbyname.3
mtk
Add 'h_errno' to NAME list.
getopt.3
mtk
Add 'optarg', 'optind', 'opterr', and 'optopt' to NAME section.
Add subheading for getopt_long() and getopt_long_only()
description.
getpt.3
mtk
Point out that this function should be avoided in favor of
posix_openpt().
Add ERRORS section referring to open(2).
getsubopt.3
Daniel Burr
SYNOPSIS: Fix declaration of valuep.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476672.
malloc.3
mtk
RETURN VALUE: Note circumstances in which successful malloc() and
calloc() can return NULL.
mq_open.3
mtk, after a note by Marty Leisner
Note that <fcntl.h> is needed for O_* constants and <sys/stat.h>
is needed for 'mode' constants.
opendir.3
mtk
Describe treatment of close-on-exec flag by opendir() and
fdopendir().
openpty.3
mtk
SEE ALSO: add ttyname(3).
raise.3
mtk / Timothy Baldwin
Clarify semantics of raise() when called from a multithreaded
program.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476484.
mtk
Rewrites and additions to various parts of the page.
rand.3
Tolga Dalman / aeb / mtk
Remove outdated warning in NOTES; encourage the use of
random(3) instead.
Folkert van Heusden
Clarify wording describing range of values returned by rand().
random.3
aeb / mtk / Tolga Dalman
Recommend use or random_r(3) for multithreaded applications
that need independent, reproducible sequences of random numbers.
Move references to "The Art of Computer Programming" and
"Numerical Recipes", formerly in rand(3), to this page.
Add drand48(93) to SEE ALSO list.
regex.3
Heikki Orsila
Clarify description of 'rm_eo' field.
sem_open.3
mtk, after a note by Marty Leisner
Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
needed for 'mode' constants.
sem_post.3
mtk
Added pointer to example in sem_wait(3).
sem_close.3
sem_destroy.3
sem_getvalue.3
sem_init.3
sem_open.3
sem_post.3
sem_unlink.3
sem_wait.3
mtk, after a note from Marty Leisner
Add text to SYNOPSIS noting the need to link with "-lrt" or
"-pthread".
setenv.3
mtk
setenv() copies 'name' and 'value' (contrast with putenv()).
unsetenv() of a nonexistent variable does nothing and is
considered successful.
Noted that setenv() and unsetenv() need not be reentrant.
shm_open.3
mtk, after a note by Marty Leisner
Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
needed for 'mode' constants.
undocumented.3
mtk
initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
utmp.5
Nicolas François
Small rewording.
resolv.conf.5
Nicolas François
gethostname() is in Section 2, not section 3.
ascii.7
Stuart Brady
Fix rendering of ' (backtick) and apostrophe (') in tables
charsets.7
Nicolas François
s/unicode.com/unicode.org/
credentials.7
mtk
NOTES: Pthreads requires that all threads share the same UIDs and
GIDs. But the Linux kernel maintains separate UIDs and GIDs for
every thread. NPTL does some work to ensure that credential
changes by any thread are carried through to all POSIX threads in
a process.
mtk
sysconf(_SC_NGROUPS_MAX) can be used to determine the number of
supplementary groups that a process may belong to.
Clarify that supplementary group IDs are specified in POSIX.1-2001.
epoll.7
mtk, after a note from Sam Varshavchik
For answer A2, change "not recommended" to "careful programming
may be required".
inotify.7
mtk
Document SIGIO feature (new in 2.6.25) for inotify file descriptors.
mtk
Note that select()/poll()/epoll_wait() indicate a ready inotify
file descriptor as readable.
mtk
Document IN_ATTRIB in a little more detail.
pthreads.7
Justin Pryzby
Grammar fix, plus fix typo in script.
mtk
Add list of thread-safe functions.
standards.7
mtk
Add a section on the upcoming POSIX revision.
ld.so.8
Justin Pryzby / mtk
Various wording improvements.
|