~ubuntu-branches/ubuntu/saucy/manpages/saucy

« back to all changes in this revision

Viewing changes to Changes

  • Committer: Bazaar Package Importer
  • Author(s): Loïc Minier
  • Date: 2010-11-11 16:51:09 UTC
  • mfrom: (1.1.44 upstream) (2.2.7 sid)
  • Revision ID: james.westby@ubuntu.com-20101111165109-3yiyen1axa1ju3s0
Tags: 3.26-1ubuntu1
* Merge from Debian unstable; remaining changes:
  - ptrace.2, prctl.2: document Ubuntu-specific PTRACE_ATTACH,
    PR_SET_PTRACER behavior.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
==================== Changes in man-pages-3.25 ====================
 
1
==================== Changes in man-pages-3.26 ====================
2
2
 
3
 
Released: 2010-06-20, Munich
 
3
Released: 2010-09-04, Munich
4
4
 
5
5
 
6
6
Contributors
9
9
The following people contributed notes, ideas, or patches that have
10
10
been incorporated in changes in this release:
11
11
 
12
 
Alexander E. Patrakov <patrakov@gmail.com>
13
 
Andi Kleen <andi@firstfloor.org>
14
 
Andrew Klossner <andrew@cesa.opbu.xerox.com>
15
 
Andr� Goddard Rosa <andre.goddard@gmail.com>
16
 
Bo Borgerson <gigabo@gmail.com>
17
 
Christian Franke <nobody@nowhere.ws>
18
 
Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
19
 
David Sommerseth <davids@redhat.com>
 
12
Alexander Shishkin <virtuoso@slind.org>
 
13
Brian Sutin <Brian.Sutin@hs.utc.com>
20
14
Denis Barbier <bouzim@gmail.com>
21
 
Eric Blake <ebb9@byu.net>
22
 
Fang Wenqi <anton.fang@gmail.com>
23
 
Francesco Cosoleto <cosoleto@gmail.com>
24
 
Gernot Tenchio <gernot@tenchio.de>
25
 
Hugh Dickins <hughd@google.com>
26
 
Ivana Hutarova Varekova <varekova@redhat.com>
27
 
Jan Blunck <jblunck@novell.com>
28
 
Jan Engelhardt <jengelh@medozas.de>
29
 
Jan Kara <jack@suse.cz>
30
 
Jeff Barry <JeffBatHome@myletters.us>
31
 
Manfred Schwarb <manfred99@gmx.ch>
32
 
Mark Hills <mark@pogo.org.uk>
33
 
Martin (Joey) Schulze <joey@infodrom.org>
 
15
Guillem Jover <guillem@hadrons.org>
 
16
Jianhua Li <jhlicc@gmail.com>
 
17
Linus Nilsson <lajnold@gmail.com>
 
18
Lenaic Huard <lenaic.huard@laposte.net>
 
19
mac@mcrowe.com
 
20
Martin Schulze <joey@infodrom.org>
 
21
Maxin John <maxin.john@gmail.com>
34
22
Michael Kerrisk <mtk.manpages@gmail.com>
35
 
Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
36
 
Mike Frysinger <vapier@gentoo.org>
37
 
Miklos Szeredi <miklos@szeredi.hu>
38
 
Petr Baudis <pasky@suse.cz>
39
 
Petr Gajdos <pgajdos@suse.cz>
40
 
Petr Uzel <petr.uzel@suse.cz>
41
 
Pierre Habouzit <madcoder@madism.org>
42
 
Reuben Thomas <rrt@sc3d.org>
43
 
Rob Landley <rob@landley.net>
44
 
Robert Wohlrab <robert.wohlrab@gmx.de>
45
 
Serge E. Hallyn <serge@hallyn.com>
46
 
Tolga Dalman <tdalman@project-psi.org>
47
 
Tom Swigg <swiggtc@lsbu.ac.uk>
48
 
Walter Harms <wharms@bfs.de>
 
23
Nicholas Hunt <nhunt@cs.washington.edu>
 
24
Peng Haitao <penght@cn.fujitsu.com>
 
25
Peter Stuge <peter@stuge.se>
 
26
Przemyslaw Szczepaniak <Przemyslaw.Szczepaniak@imgtec.com>
 
27
Scott Walls <sawalls@umich.edu>
 
28
TAN Yee Fan <tanyeefa@comp.nus.edu.sg>
 
29
Wu Fengguang <fengguang.wu@intel.com>
 
30
Yitzchak Gale <gale@sefer.org>
49
31
Yuri Kozlov <yuray@komyakino.ru>
50
32
 
51
33
Apologies if I missed anyone!
52
34
 
53
 
 
54
 
New and rewritten pages
55
 
-----------------------
56
 
 
57
 
migrate_pages.2
58
 
    Andi Kleen
59
 
        New page documenting migrate_pages(2).
60
 
            Andi's text based on the move_pages.2 page;
61
 
            additional edits by mtk.
62
 
            migrate_pages(2) was new in Linux 2.6.16.
63
 
 
64
 
quotactl.2
65
 
    Jan Kara
66
 
        Major updates
67
 
            Update the page to consolidate information from the
68
 
            outdated man-pages quotactl.2 page and the quotactl.2
69
 
            page in the "quota-tools" pachage. The page in "quota-tools"
70
 
            has now been dropped by Jan Kara, so that there is just one
71
 
            canonical quotactl.2 page (in pan-pages).
72
 
    Michael Kerrisk
73
 
            Various other pieces added to the page by mtk.
74
 
 
75
 
 
76
35
Newly documented interfaces in existing pages
77
36
---------------------------------------------
78
37
 
79
 
fcntl.2
80
 
    Michael Kerrisk
81
 
        Document F_SETPIPE_SZ and F_GETPIPE_SZ
82
 
            These commands, new in kernel 2.6.35, set and get the capacity
83
 
            of pipes.
84
 
 
85
 
madvise.2
86
 
    Andi Kleen
87
 
        Document MADV_HWPOISON
88
 
    Michael Kerrisk
89
 
        Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
90
 
            These flags (used for Kernel Samepage Mergeing, KSM)
91
 
            are new in 2.6.32.
92
 
    Andi Kleen
93
 
        Document MADV_SOFT_OFFLINE
94
 
            This operation was added in Linux 2.6.33.
95
 
 
96
 
mmap.2
97
 
    Michael Kerrisk
98
 
        Document MAP_UNINITIALIZED flag
99
 
            New in Linux 2.6.33.
100
 
 
101
 
prctl.2
102
 
    Andi Kleen
103
 
        Document the hwpoison prctls in 2.6.32
104
 
 
105
 
sched_setscheduler.2
106
 
    Michael Kerrisk
107
 
        Document SCHED_RESET_ON_FORK
108
 
            New in Linux 2.6.32
109
 
 
110
 
umount.2
111
 
    Michael Kerrisk
112
 
        Document UMOUNT_NOFOLLOW
113
 
            New in Linux 2.6.34.
114
 
 
115
 
mkstemp.3
116
 
    Michael Kerrisk
117
 
        Document mkstemps() and mkostemps()
118
 
            These functions are new in glibc 2.11. They allow the template
119
 
            string to include a suffix after the "XXXXXX" string.
120
 
 
121
 
proc.5
122
 
    Michael Kerrisk
123
 
        Document /proc/sys/vm/memory_failure_early_kill
124
 
            New in 2.6.32. Description based on the text in
125
 
            Documentation/sysctl/vm.txt.
126
 
    Michael Kerrisk
127
 
        Document /proc/sys/vm/memory_failure_recovery
128
 
            New in Linux 2.6.32.  Description based on the text in
129
 
            Documentation/sysctl/vm.txt.
130
 
    Michael Kerrisk
131
 
        Document /proc/sys/fs/pipe-max-size
132
 
 
133
 
socket.7
134
 
    Jan Engelhardt
135
 
        Document SO_DOMAIN and SO_PROTOCOL
136
 
            These read-only socket options were new in Linux 2.6.32.
137
 
 
138
 
 
139
 
New and changed links
140
 
---------------------
141
 
 
142
 
fstatvfs.2
143
 
    Michael Kerrisk
144
 
        Adjust link to point to Section 3
145
 
 
146
 
fstatvfs.3
147
 
statvfs.2
148
 
    Michael Kerrisk
149
 
        New link to page relocated to Section 3
150
 
 
151
 
mkstemps.3
152
 
mkostemps.3
153
 
    Michael Kerrisk
154
 
        New links to mkstemp.3
155
 
            mkstemp.3 now describes mkstemps(3) and mkostemps(3).
156
 
 
157
 
timer_create.2
158
 
timer_delete.2
159
 
timer_getoverrun.2
160
 
timer_settime.2
161
 
getline.3
162
 
    Michael Kerrisk
163
 
        Add 'L' to constants in feature test macro specifications
164
 
            Be consistent with POSIX, which uses constants such as 200809L.
 
38
eventfd.2
 
39
    Michael Kerrisk
 
40
        Document EFD_SEMAPHORE
 
41
            Document the EFD_SEMAPHORE flag, added in kernel 2.6.30.
 
42
            Also restructured some parts of the text to fit with the
 
43
            addition of the EFD_SEMAPHORE text.
165
44
 
166
45
 
167
46
Global changes
168
47
--------------
169
48
 
170
 
open.2
171
 
sync_file_range.2
172
 
umount.2
 
49
getaddrinfo.3
 
50
getipnodebyname.3
 
51
st.4
173
52
    Michael Kerrisk
174
 
        Global fix: s/filesystem/file system/
 
53
        s/logical OR/bitwise OR/
175
54
 
176
55
 
177
56
Changes to individual pages
178
57
---------------------------
179
58
 
180
 
fcntl.2
181
 
    Michael Kerrisk
182
 
        Note that glibc 2.11 papers over the kernel F_GETOWN bug
183
 
            Since version 2.11, glibc works around the kernel limitation for
184
 
            process groups IDs < 4096 by implementing F_GETOWN via F_GETOWN_EX.
185
 
 
186
 
futex.2
187
 
    Michael Kerrisk
188
 
        Various fixes in SEE ALSO
189
 
 
190
 
getpriority.2
191
 
nice.2
192
 
    Francesco Cosoleto
193
 
        Move renice from section 8 to section 1
194
 
 
195
 
getrusage.2
196
 
    Mark Hills
197
 
        Add ru_maxrss
198
 
            See kernel commit 1f10206.
199
 
    Mark Hills
200
 
        Description of maintained fields
201
 
            These descriptions are taken from NetBSD 5.0's getrusage(2).
202
 
    Michael Kerrisk
203
 
        Enhanced description of various fields
204
 
 
205
 
mlock.2
206
 
    Michael Kerrisk
207
 
        /proc/PID/status VmLck shows how much memory a process has locked
208
 
            After a note from Tom Swigg, it seems sensible mention VmLck here.
209
 
 
210
 
mount.2
211
 
    Petr Uzel
212
 
        Fix incorrect path
213
 
 
214
 
move_pages.2
215
 
    Andi Kleen
216
 
        Clarify includes/libraries
217
 
 
218
 
mremap.2
219
 
    Michael Kerrisk
220
 
        Clarify existence of fifth argument.
221
 
 
222
 
msgctl.2
223
 
semctl.2
224
 
shmctl.2
225
 
    Francesco Cosoleto
226
 
        Move ipcs from section 8 to section 1
227
 
 
228
 
open.2
229
 
    Michael Kerrisk
230
 
        Remove ambiguity in text on NFS and O_EXCL.
231
 
 
232
 
poll.2
233
 
    Michael Kerrisk
234
 
        Fix discussion of ppoll() timeout argument
235
 
            1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
236
 
               from the poll() argument in the text.
237
 
            2. More accurately describe the poll() call that is equivalent
238
 
               to ppoll().
239
 
 
240
 
posix_fadvise.2
241
 
    Michael Kerrisk
242
 
        Add sync_file_range(2) under SEE ALSO
243
 
 
244
 
prctl.2
245
 
    Michael Kerrisk
246
 
        Correct PR_SET_KEEPCAPS description
247
 
            The "keep capabilities" flag only affects the treatment of
248
 
            permitted capabilities, not effective capabilities.
249
 
            Also: other improvements to make the PR_SET_KEEPCAPS text clearer.
250
 
 
251
 
select_tut.2
252
 
    Michael Kerrisk
253
 
        Fix bug in example program
254
 
 
255
 
sigaction.2
256
 
    Michael Kerrisk
257
 
        Add TRAP_BRANCH and TRAP_HWBKPT to si_code values for SIGTRAP
258
 
    Michael Kerrisk
259
 
        Rearrange text describing fields set by sigqueue(2)
260
 
    Michael Kerrisk
261
 
        Add details for signals sent by POSIX message queue notifications
262
 
    Michael Kerrisk
263
 
        Improve description of various siginfo_t fields
264
 
    Michael Kerrisk
265
 
        Add some details for SIGTRAP and si_trapno
266
 
    Andi Kleen
267
 
        Document hwpoison signal extensions
 
59
clock_nanosleep.2
 
60
    Michael Kerrisk
 
61
        Fix discussion of return value when interrupted by a signal
 
62
 
 
63
epoll_ctl.2
 
64
    Yuri Kozlov
 
65
        Small fix to types in data structures
 
66
 
 
67
eventfd.2
 
68
    Alexander Shishkin
 
69
        Clarified close-on-exec behavior
 
70
 
 
71
madvise.2
 
72
    Michael Kerrisk
 
73
        Improve discussion of MADV_SOFT_OFFLINE
 
74
 
 
75
mkdir.2
 
76
    Michael Kerrisk
 
77
        Add EMLINK error to ERRORS
 
78
 
 
79
mq_getsetattr.2
 
80
mq_close.3
 
81
mq_getattr.3
 
82
mq_notify.3
 
83
mq_send.3
 
84
mq_unlink.3
 
85
    Lnac Huard
 
86
        Fix return type in SYNOPSIS (s/mqd_t/int/)
 
87
 
 
88
recv.2
 
89
send.2
 
90
    Michael Kerrisk
 
91
        Remove obsolete reference to glibc version in NOTES
 
92
 
 
93
recv.2
 
94
send.2
 
95
    Nicholas Hunt
 
96
        Adjust type shown for msg_controllen to glibc reality
 
97
            This patch fixes the type of msg_controllen in the struct msghdr
 
98
            definition given in send.2 and recv.2 to match the definition in
 
99
            glibc and the kernel.
 
100
 
 
101
select.2
 
102
    Michael Kerrisk
 
103
        Update NOTES on old glibc pselect()
 
104
            Make it clear that modern glibc uses the kernel pselect()
 
105
            on systems where it is available.
 
106
            See https://bugzilla.kernel.org/show_bug.cgi?id=14411
268
107
 
269
108
statfs.2
270
 
    Michael Kerrisk
271
 
        Bring statfs struct type declarations closer to glibc reality
272
 
    Fang Wenqi
273
 
        Add definition EXT4_SUPER_MAGIC = 0xEF53
274
 
    Michael Kerrisk
275
 
        Document f_frsize field.
276
 
 
277
 
statvfs.2
278
 
    Michael Kerrisk
279
 
        Move this page to section 3 (since it's a library call)
280
 
 
281
 
swapon.2
282
 
    Ivana Hutarova Varekova
283
 
        Note effect of iCONFIG_MEMORY_FAILURE on MAX_SWAPFILES
284
 
            From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
285
 
            built with CONFIG_MEMORY_FAILURE.
286
 
 
287
 
syscalls.2
288
 
    Michael Kerrisk
289
 
        Bring system call list up to date with Linux 2.6.33
290
 
    Michael Kerrisk
291
 
        Fix kernel version number for utimes()
292
 
 
293
 
cproj.3
294
 
    Michael Kerrisk
295
 
        Note fix for C99 conformance in glibc 2.12.
296
 
 
297
 
crypt.3
298
 
    Petr Baudis
299
 
        Correct note on key portion significance
300
 
            As Marcel Moreaux notes:
301
 
 
302
 
                The Linux manpage for crypt()[1] contains the following
303
 
                statement as the last sentence of the NOTES section:
304
 
 
305
 
                    In the SHA implementation the entire key is significant
306
 
                    (instead of only the first 8 bytes in MD5).
307
 
 
308
 
                It should probably say "DES" where it says "MD5" (and maybe
309
 
                "MD5/SHA" where it says "SHA"), because in MD5 password hashing,
310
 
                the entire key is significant, not just the first 8 bytes.
311
 
 
312
 
            This patch fixes the wording.
313
 
 
314
 
fmemopen.3
315
 
    Michael Kerrisk
316
 
        Bug fix in example program
317
 
 
318
 
ftw.3
319
 
    Michael Kerrisk
320
 
        Note that if 'fn' changes CWD, the results are undefined
321
 
    Michael Kerrisk
322
 
        Clarify description of fpath argument
323
 
            As reported by Pierre Habouzit, 'fpath' is not relative
324
 
            to 'dirpath'. It is either relative to the calling process's
325
 
            current working directory (if 'dirpath' was relative), or it
326
 
            is absolute (if 'dirpath' was absolute).
327
 
 
328
 
getaddrinfo.3
329
 
    Christian Franke
330
 
        Fix a field name mixup: s/ai_family/ai_flags/
331
 
 
332
 
getline.3
333
 
    Robert Wohlrab
334
 
        Remove unneeded check before free()
335
 
            The manpage of getline shows an example with an extra NULL pointer
336
 
            check before it calls free. This is unneeded according to free(3):
337
 
 
338
 
                 If ptr is NULL, no operation is performed.
339
 
 
340
 
            This patch removes the "if" check.
341
 
 
342
 
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572508
343
 
 
344
 
log.3
345
 
log10.3
346
 
log2.3
347
 
    Jan Engelhardt
348
 
        Add cross-references to other-base logarithmic functions
349
 
 
350
 
opendir.3
351
 
    Petr Baudis
352
 
        Specify feature test macro requirements for fdopendir(3)
353
 
            Currently, there is no note on the fact that fdopendir() is
354
 
            POSIX.2008-only.
355
 
 
356
 
openpty.3
357
 
    Eric Blake
358
 
        Use const as appropriate
359
 
    Michael Kerrisk
360
 
        Note glibc version that added "const" to function arguments
361
 
    Michael Kerrisk
362
 
        Explicitly note that these functions are not in POSIX
363
 
 
364
 
resolver.3
365
 
    Michael Kerrisk
366
 
        Fix declaration of dn_comp() in SYNOPSIS
367
 
            Remove the second 'exp_dn' from the calling signature.
368
 
 
369
 
termios.3
370
 
    Michael Kerrisk
371
 
        Change NOFLSH text to speak of characters, not signals
372
 
 
373
 
core.5
374
 
    Michael Kerrisk
375
 
        Update description of coredump_filter
376
 
            Kernel 2.6.24 added MMF_DUMP_ELF_HEADERS.
377
 
            Kernel 2.6.28 added MMF_DUMP_HUGETLB_PRIVATE and
378
 
            MMF_DUMP_HUGETLB_SHARED.
379
 
 
380
 
elf.5
381
 
    Daisuke HATAYAMA
382
 
        Document PN_XNUM extension
383
 
            In linux-2.6.34-rc1, an ELF core extension was added; user-land
384
 
            tools manipulating ELF core dump such as gdb and binutils has
385
 
            already been modified before; so elf.5 needs to be modified
386
 
            accordingly.
387
 
 
388
 
            You can follow information on the ELF extension via the LKML post:
389
 
            http://lkml.org/lkml/2010/1/3/103
390
 
            Date        Mon, 04 Jan 2010 10:06:07 +0900 (JST)
391
 
            Subject     ... elf coredump: Add extended numbering support
392
 
 
393
 
            This Linux-specific extension was added in kernel 2.6.34.
394
 
 
395
 
            Reviewed-by: Petr Baudis <pasky@suse.cz>
396
 
 
397
 
    Michael Kerrisk
398
 
        Remove EI_BRAND
399
 
            As reported by Yuri Kozlov  and confirmed by Mike Frysinger,
400
 
            EI_BRAND is not in GABI
401
 
            (http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
402
 
            It looks to be a BSDism
403
 
    Michael Kerrisk
404
 
        Remove words under '.note': "described below"
405
 
            The existing text is broken, because there is
406
 
            no '"Note Section" format' describe below. Simplest
407
 
            solution is to remove the words "described below".
408
 
 
409
 
filesystems.5
410
 
    Jeff Barry
411
 
        Add discussion of ntfs and ext4
412
 
 
413
 
proc.5
414
 
    Michael Kerrisk
415
 
        Simplify description of /proc/sys and /proc/sys/fs
416
 
            In the description of these directories, there's no need
417
 
            to list all the files and subdirectories that they contain;
418
 
            that information is provided by the entries that follow.
419
 
 
420
 
services.5
 
109
    Guillem Jover
 
110
        Fix copy & paste error for __SWORD_TYPE definition
 
111
 
 
112
sysfs.2
 
113
    Michael Kerrisk
 
114
        Clarify that this syscall is obsolete.
 
115
            And strengthen recommendation to use /proc/filesystems instead.
 
116
 
 
117
write.2
 
118
    Michael Kerrisk
 
119
        Add EDESTADDRREQ error
 
120
 
 
121
a64l.3
 
122
    Peng Haitao
 
123
        Fix error in NOTES, s/a64l/l64a/
 
124
 
 
125
error.3
 
126
    Linus Nilsson
 
127
        Change "perror" to "strerror" in DESCRIPTION of error()
 
128
 
 
129
mq_send.3
 
130
    Michael Kerrisk
 
131
        Fix EAGAIN description (s/empty/full)
 
132
 
 
133
initrd.4
421
134
    Yuri Kozlov
422
 
        Remove crufty reference to nonexistent BUGS section
423
 
 
424
 
capabilities.7
425
 
    Michael Kerrisk
426
 
        Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
427
 
            With CAP_SYS_RESOURCE, a process can increase pipe capacity above
428
 
            /proc/sys/ps/pipe-max-size.
429
 
    Michael Kerrisk
430
 
        Add get_robust_list() info under CAP_SYS_PTRACE
431
 
    Michael Kerrisk
432
 
        Add MADV_HWPOISON under CAP_SYS_ADMIN
433
 
 
434
 
signal.7
435
 
    Michael Kerrisk
436
 
        Make a clearer statement about nonportable aspect of signal(2)
437
 
            Make a clearer statement that signal(2) is less portable for
438
 
            establishing a signal handler.
439
 
 
440
 
socket.7
441
 
    Michael Kerrisk
442
 
        Use consistent language to describe read-only socket options
443
 
 
444
 
udp.7
445
 
    Michael Kerrisk
446
 
        Add FIONREAD warning.
447
 
            Warn that FIONREAD can't can't distinguish case of a zero-length
448
 
            datagram from the case where no datagrams are available.
 
135
        Fix IP address in explanation of NFS example
 
136
 
 
137
tzfile.5
 
138
    Michael Kerrisk
 
139
        Add information on version 2 format timezone files
 
140
            Updated using information from the tzcode 2010l release at
 
141
            ftp://elsie.nci.nih.gov/pub.
 
142
            (It's an open question whether or not a version of tzfile.5
 
143
            should live independently in man-pages. It was added to the
 
144
            man-pages set many years ago. For now, I'll follow a
 
145
            conservative course that causes least pain to downstream,
 
146
            by continuing to maintain a separate copy in man-pages.)
 
147
 
 
148
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219