aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorArnd Bergmann <arnd@arndb.de>2011-07-28 11:25:46 -0400
committerArnd Bergmann <arnd@arndb.de>2011-07-28 11:25:46 -0400
commit6124a4e430b64d1577438c8648c59e996d02e73e (patch)
tree49cfafad785d1c9e403a5b0d755298b9af2c260f /Documentation
parent8e267f3da5f117d2f1316cf6ddf740f93f1c73aa (diff)
parent580975d7f48d7d047e22bb0f42adf7557801d8d4 (diff)
Merge branch 'imx/dt' into next/dt
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/ABI/obsolete/proc-pid-oom_adj2
-rw-r--r--Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa948021
-rw-r--r--Documentation/ABI/testing/sysfs-module23
-rw-r--r--Documentation/DMA-API-HOWTO.txt12
-rw-r--r--Documentation/DocBook/v4l/io.xml2
-rw-r--r--Documentation/RCU/NMI-RCU.txt4
-rw-r--r--Documentation/SubmitChecklist4
-rw-r--r--Documentation/arm/Samsung-S3C24XX/Overview.txt7
-rw-r--r--Documentation/block/queue-sysfs.txt10
-rw-r--r--Documentation/blockdev/README.DAC9602
-rw-r--r--Documentation/blockdev/ramdisk.txt8
-rw-r--r--Documentation/cgroups/memory.txt85
-rw-r--r--Documentation/cpu-freq/cpu-drivers.txt2
-rw-r--r--Documentation/devicetree/bindings/arm/sirf.txt3
-rw-r--r--Documentation/devicetree/bindings/arm/xilinx.txt7
-rw-r--r--Documentation/devicetree/bindings/dma/fsl-imx-sdma.txt17
-rw-r--r--Documentation/devicetree/bindings/mmc/fsl-imx-esdhc.txt34
-rw-r--r--[-rwxr-xr-x]Documentation/devicetree/bindings/net/can/fsl-flexcan.txt0
-rw-r--r--Documentation/devicetree/bindings/net/fsl-fec.txt24
-rw-r--r--Documentation/devicetree/bindings/rtc/olpc-xo1-rtc.txt5
-rw-r--r--Documentation/devicetree/bindings/tty/serial/fsl-imx-uart.txt19
-rw-r--r--Documentation/driver-model/device.txt2
-rw-r--r--Documentation/driver-model/overview.txt52
-rw-r--r--Documentation/fb/modedb.txt21
-rw-r--r--Documentation/feature-removal-schedule.txt70
-rw-r--r--Documentation/filesystems/Locking28
-rw-r--r--Documentation/filesystems/debugfs.txt4
-rw-r--r--Documentation/filesystems/ext3.txt13
-rw-r--r--Documentation/filesystems/ext4.txt23
-rw-r--r--Documentation/filesystems/nfs/nfs41-server.txt33
-rw-r--r--Documentation/filesystems/nfs/nfsroot.txt2
-rw-r--r--Documentation/filesystems/porting7
-rw-r--r--Documentation/filesystems/squashfs.txt4
-rw-r--r--Documentation/filesystems/vfs.txt2
-rw-r--r--Documentation/hwmon/it873
-rw-r--r--Documentation/hwmon/lm783
-rw-r--r--Documentation/hwmon/sch563631
-rw-r--r--Documentation/i2o/ioctl2
-rw-r--r--Documentation/ioctl/ioctl-number.txt1
-rw-r--r--Documentation/isdn/README.HiSax2
-rw-r--r--Documentation/ja_JP/SubmittingPatches258
-rw-r--r--Documentation/kbuild/makefiles.txt38
-rw-r--r--Documentation/kernel-parameters.txt14
-rw-r--r--Documentation/magic-number.txt2
-rw-r--r--Documentation/mca.txt4
-rw-r--r--Documentation/scheduler/sched-arch.txt2
-rw-r--r--Documentation/scsi/BusLogic.txt2
-rw-r--r--Documentation/serial/computone.txt2
-rw-r--r--Documentation/sysctl/kernel.txt22
-rw-r--r--Documentation/usb/ehci.txt2
-rw-r--r--Documentation/usb/gadget_hid.txt6
-rw-r--r--Documentation/zh_CN/email-clients.txt210
-rw-r--r--Documentation/zh_CN/magic-number.txt2
53 files changed, 801 insertions, 357 deletions
diff --git a/Documentation/ABI/obsolete/proc-pid-oom_adj b/Documentation/ABI/obsolete/proc-pid-oom_adj
index cf63f264ce0f..9a3cb88ade47 100644
--- a/Documentation/ABI/obsolete/proc-pid-oom_adj
+++ b/Documentation/ABI/obsolete/proc-pid-oom_adj
@@ -14,7 +14,7 @@ Why: /proc/<pid>/oom_adj allows userspace to influence the oom killer's
14 14
15 A much more powerful interface, /proc/<pid>/oom_score_adj, was 15 A much more powerful interface, /proc/<pid>/oom_score_adj, was
16 introduced with the oom killer rewrite that allows users to increase or 16 introduced with the oom killer rewrite that allows users to increase or
17 decrease the badness() score linearly. This interface will replace 17 decrease the badness score linearly. This interface will replace
18 /proc/<pid>/oom_adj. 18 /proc/<pid>/oom_adj.
19 19
20 A warning will be emitted to the kernel log if an application uses this 20 A warning will be emitted to the kernel log if an application uses this
diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
new file mode 100644
index 000000000000..9de269bb0ae5
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
@@ -0,0 +1,21 @@
1What: /sys/bus/i2c/devices/.../device
2Date: February 2011
3Contact: Minkyu Kang <mk7.kang@samsung.com>
4Description:
5 show what device is attached
6 NONE - no device
7 USB - USB device is attached
8 UART - UART is attached
9 CHARGER - Charger is attaced
10 JIG - JIG is attached
11
12What: /sys/bus/i2c/devices/.../switch
13Date: February 2011
14Contact: Minkyu Kang <mk7.kang@samsung.com>
15Description:
16 show or set the state of manual switch
17 VAUDIO - switch to VAUDIO path
18 UART - switch to UART path
19 AUDIO - switch to AUDIO path
20 DHOST - switch to DHOST path
21 AUTO - switch automatically by device
diff --git a/Documentation/ABI/testing/sysfs-module b/Documentation/ABI/testing/sysfs-module
index cfcec3bffc0a..9489ea8e294c 100644
--- a/Documentation/ABI/testing/sysfs-module
+++ b/Documentation/ABI/testing/sysfs-module
@@ -10,3 +10,26 @@ KernelVersion: 2.6.35
10Contact: masa-korg@dsn.okisemi.com 10Contact: masa-korg@dsn.okisemi.com
11Description: Write/read Option ROM data. 11Description: Write/read Option ROM data.
12 12
13
14What: /sys/module/ehci_hcd/drivers/.../uframe_periodic_max
15Date: July 2011
16KernelVersion: 3.1
17Contact: Kirill Smelkov <kirr@mns.spb.ru>
18Description: Maximum time allowed for periodic transfers per microframe (μs)
19
20 [ USB 2.0 sets maximum allowed time for periodic transfers per
21 microframe to be 80%, that is 100 microseconds out of 125
22 microseconds (full microframe).
23
24 However there are cases, when 80% max isochronous bandwidth is
25 too limiting. For example two video streams could require 110
26 microseconds of isochronous bandwidth per microframe to work
27 together. ]
28
29 Through this setting it is possible to raise the limit so that
30 the host controller would allow allocating more than 100
31 microseconds of periodic bandwidth per microframe.
32
33 Beware, non-standard modes are usually not thoroughly tested by
34 hardware designers, and the hardware can malfunction when this
35 setting differ from default 100.
diff --git a/Documentation/DMA-API-HOWTO.txt b/Documentation/DMA-API-HOWTO.txt
index d568bc235bc0..a0b6250add79 100644
--- a/Documentation/DMA-API-HOWTO.txt
+++ b/Documentation/DMA-API-HOWTO.txt
@@ -613,13 +613,13 @@ to use the dma_sync_*() interfaces.
613 pass_to_upper_layers(cp->rx_buf); 613 pass_to_upper_layers(cp->rx_buf);
614 make_and_setup_new_rx_buf(cp); 614 make_and_setup_new_rx_buf(cp);
615 } else { 615 } else {
616 /* Just sync the buffer and give it back 616 /* CPU should not write to
617 * to the card. 617 * DMA_FROM_DEVICE-mapped area,
618 * so dma_sync_single_for_device() is
619 * not needed here. It would be required
620 * for DMA_BIDIRECTIONAL mapping if
621 * the memory was modified.
618 */ 622 */
619 dma_sync_single_for_device(&cp->dev,
620 cp->rx_dma,
621 cp->rx_len,
622 DMA_FROM_DEVICE);
623 give_rx_buf_to_card(cp); 623 give_rx_buf_to_card(cp);
624 } 624 }
625 } 625 }
diff --git a/Documentation/DocBook/v4l/io.xml b/Documentation/DocBook/v4l/io.xml
index 227e7ac45a06..c57d1ec6291c 100644
--- a/Documentation/DocBook/v4l/io.xml
+++ b/Documentation/DocBook/v4l/io.xml
@@ -210,7 +210,7 @@ for (i = 0; i &lt; reqbuf.count; i++)
210 <programlisting> 210 <programlisting>
211&v4l2-requestbuffers; reqbuf; 211&v4l2-requestbuffers; reqbuf;
212/* Our current format uses 3 planes per buffer */ 212/* Our current format uses 3 planes per buffer */
213#define FMT_NUM_PLANES = 3; 213#define FMT_NUM_PLANES = 3
214 214
215struct { 215struct {
216 void *start[FMT_NUM_PLANES]; 216 void *start[FMT_NUM_PLANES];
diff --git a/Documentation/RCU/NMI-RCU.txt b/Documentation/RCU/NMI-RCU.txt
index a8536cb88091..bf82851a0e57 100644
--- a/Documentation/RCU/NMI-RCU.txt
+++ b/Documentation/RCU/NMI-RCU.txt
@@ -5,8 +5,8 @@ Although RCU is usually used to protect read-mostly data structures,
5it is possible to use RCU to provide dynamic non-maskable interrupt 5it is possible to use RCU to provide dynamic non-maskable interrupt
6handlers, as well as dynamic irq handlers. This document describes 6handlers, as well as dynamic irq handlers. This document describes
7how to do this, drawing loosely from Zwane Mwaikambo's NMI-timer 7how to do this, drawing loosely from Zwane Mwaikambo's NMI-timer
8work in "arch/i386/oprofile/nmi_timer_int.c" and in 8work in "arch/x86/oprofile/nmi_timer_int.c" and in
9"arch/i386/kernel/traps.c". 9"arch/x86/kernel/traps.c".
10 10
11The relevant pieces of code are listed below, each followed by a 11The relevant pieces of code are listed below, each followed by a
12brief explanation. 12brief explanation.
diff --git a/Documentation/SubmitChecklist b/Documentation/SubmitChecklist
index 7b13be41c085..dc0e33210d7e 100644
--- a/Documentation/SubmitChecklist
+++ b/Documentation/SubmitChecklist
@@ -53,8 +53,8 @@ kernel patches.
53 53
5412: Has been tested with CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT, 5412: Has been tested with CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
55 CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES, 55 CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
56 CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_ATOMIC_SLEEP all simultaneously 56 CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_ATOMIC_SLEEP, CONFIG_PROVE_RCU
57 enabled. 57 and CONFIG_DEBUG_OBJECTS_RCU_HEAD all simultaneously enabled.
58 58
5913: Has been build- and runtime tested with and without CONFIG_SMP and 5913: Has been build- and runtime tested with and without CONFIG_SMP and
60 CONFIG_PREEMPT. 60 CONFIG_PREEMPT.
diff --git a/Documentation/arm/Samsung-S3C24XX/Overview.txt b/Documentation/arm/Samsung-S3C24XX/Overview.txt
index c12bfc1a00c9..359587b2367b 100644
--- a/Documentation/arm/Samsung-S3C24XX/Overview.txt
+++ b/Documentation/arm/Samsung-S3C24XX/Overview.txt
@@ -8,10 +8,13 @@ Introduction
8 8
9 The Samsung S3C24XX range of ARM9 System-on-Chip CPUs are supported 9 The Samsung S3C24XX range of ARM9 System-on-Chip CPUs are supported
10 by the 's3c2410' architecture of ARM Linux. Currently the S3C2410, 10 by the 's3c2410' architecture of ARM Linux. Currently the S3C2410,
11 S3C2412, S3C2413, S3C2416 S3C2440, S3C2442, S3C2443 and S3C2450 devices 11 S3C2412, S3C2413, S3C2416, S3C2440, S3C2442, S3C2443 and S3C2450 devices
12 are supported. 12 are supported.
13 13
14 Support for the S3C2400 and S3C24A0 series are in progress. 14 Support for the S3C2400 and S3C24A0 series was never completed and the
15 corresponding code has been removed after a while. If someone wishes to
16 revive this effort, partial support can be retrieved from earlier Linux
17 versions.
15 18
16 The S3C2416 and S3C2450 devices are very similar and S3C2450 support is 19 The S3C2416 and S3C2450 devices are very similar and S3C2450 support is
17 included under the arch/arm/mach-s3c2416 directory. Note, whilst core 20 included under the arch/arm/mach-s3c2416 directory. Note, whilst core
diff --git a/Documentation/block/queue-sysfs.txt b/Documentation/block/queue-sysfs.txt
index f65274081c8d..d8147b336c35 100644
--- a/Documentation/block/queue-sysfs.txt
+++ b/Documentation/block/queue-sysfs.txt
@@ -45,9 +45,13 @@ device.
45 45
46rq_affinity (RW) 46rq_affinity (RW)
47---------------- 47----------------
48If this option is enabled, the block layer will migrate request completions 48If this option is '1', the block layer will migrate request completions to the
49to the CPU that originally submitted the request. For some workloads 49cpu "group" that originally submitted the request. For some workloads this
50this provides a significant reduction in CPU cycles due to caching effects. 50provides a significant reduction in CPU cycles due to caching effects.
51
52For storage configurations that need to maximize distribution of completion
53processing setting this option to '2' forces the completion to run on the
54requesting cpu (bypassing the "group" aggregation logic).
51 55
52scheduler (RW) 56scheduler (RW)
53-------------- 57--------------
diff --git a/Documentation/blockdev/README.DAC960 b/Documentation/blockdev/README.DAC960
index 0e8f618ab534..bd85fb9dc6e5 100644
--- a/Documentation/blockdev/README.DAC960
+++ b/Documentation/blockdev/README.DAC960
@@ -214,7 +214,7 @@ replacing "/usr/src" with wherever you keep your Linux kernel source tree:
214 make config 214 make config
215 make bzImage (or zImage) 215 make bzImage (or zImage)
216 216
217Then install "arch/i386/boot/bzImage" or "arch/i386/boot/zImage" as your 217Then install "arch/x86/boot/bzImage" or "arch/x86/boot/zImage" as your
218standard kernel, run lilo if appropriate, and reboot. 218standard kernel, run lilo if appropriate, and reboot.
219 219
220To create the necessary devices in /dev, the "make_rd" script included in 220To create the necessary devices in /dev, the "make_rd" script included in
diff --git a/Documentation/blockdev/ramdisk.txt b/Documentation/blockdev/ramdisk.txt
index 6c820baa19a6..fa72e97dd669 100644
--- a/Documentation/blockdev/ramdisk.txt
+++ b/Documentation/blockdev/ramdisk.txt
@@ -64,9 +64,9 @@ the RAM disk dynamically grows as data is being written into it, a size field
64is not required. Bits 11 to 13 are not currently used and may as well be zero. 64is not required. Bits 11 to 13 are not currently used and may as well be zero.
65These numbers are no magical secrets, as seen below: 65These numbers are no magical secrets, as seen below:
66 66
67./arch/i386/kernel/setup.c:#define RAMDISK_IMAGE_START_MASK 0x07FF 67./arch/x86/kernel/setup.c:#define RAMDISK_IMAGE_START_MASK 0x07FF
68./arch/i386/kernel/setup.c:#define RAMDISK_PROMPT_FLAG 0x8000 68./arch/x86/kernel/setup.c:#define RAMDISK_PROMPT_FLAG 0x8000
69./arch/i386/kernel/setup.c:#define RAMDISK_LOAD_FLAG 0x4000 69./arch/x86/kernel/setup.c:#define RAMDISK_LOAD_FLAG 0x4000
70 70
71Consider a typical two floppy disk setup, where you will have the 71Consider a typical two floppy disk setup, where you will have the
72kernel on disk one, and have already put a RAM disk image onto disk #2. 72kernel on disk one, and have already put a RAM disk image onto disk #2.
@@ -85,7 +85,7 @@ The command line equivalent is: "prompt_ramdisk=1"
85Putting that together gives 2^15 + 2^14 + 0 = 49152 for an rdev word. 85Putting that together gives 2^15 + 2^14 + 0 = 49152 for an rdev word.
86So to create disk one of the set, you would do: 86So to create disk one of the set, you would do:
87 87
88 /usr/src/linux# cat arch/i386/boot/zImage > /dev/fd0 88 /usr/src/linux# cat arch/x86/boot/zImage > /dev/fd0
89 /usr/src/linux# rdev /dev/fd0 /dev/fd0 89 /usr/src/linux# rdev /dev/fd0 /dev/fd0
90 /usr/src/linux# rdev -r /dev/fd0 49152 90 /usr/src/linux# rdev -r /dev/fd0 49152
91 91
diff --git a/Documentation/cgroups/memory.txt b/Documentation/cgroups/memory.txt
index 06eb6d957c83..6f3c598971fc 100644
--- a/Documentation/cgroups/memory.txt
+++ b/Documentation/cgroups/memory.txt
@@ -380,7 +380,7 @@ will be charged as a new owner of it.
380 380
3815.2 stat file 3815.2 stat file
382 382
383memory.stat file includes following statistics 3835.2.1 memory.stat file includes following statistics
384 384
385# per-memory cgroup local status 385# per-memory cgroup local status
386cache - # of bytes of page cache memory. 386cache - # of bytes of page cache memory.
@@ -438,6 +438,89 @@ Note:
438 file_mapped is accounted only when the memory cgroup is owner of page 438 file_mapped is accounted only when the memory cgroup is owner of page
439 cache.) 439 cache.)
440 440
4415.2.2 memory.vmscan_stat
442
443memory.vmscan_stat includes statistics information for memory scanning and
444freeing, reclaiming. The statistics shows memory scanning information since
445memory cgroup creation and can be reset to 0 by writing 0 as
446
447 #echo 0 > ../memory.vmscan_stat
448
449This file contains following statistics.
450
451[param]_[file_or_anon]_pages_by_[reason]_[under_heararchy]
452[param]_elapsed_ns_by_[reason]_[under_hierarchy]
453
454For example,
455
456 scanned_file_pages_by_limit indicates the number of scanned
457 file pages at vmscan.
458
459Now, 3 parameters are supported
460
461 scanned - the number of pages scanned by vmscan
462 rotated - the number of pages activated at vmscan
463 freed - the number of pages freed by vmscan
464
465If "rotated" is high against scanned/freed, the memcg seems busy.
466
467Now, 2 reason are supported
468
469 limit - the memory cgroup's limit
470 system - global memory pressure + softlimit
471 (global memory pressure not under softlimit is not handled now)
472
473When under_hierarchy is added in the tail, the number indicates the
474total memcg scan of its children and itself.
475
476elapsed_ns is a elapsed time in nanosecond. This may include sleep time
477and not indicates CPU usage. So, please take this as just showing
478latency.
479
480Here is an example.
481
482# cat /cgroup/memory/A/memory.vmscan_stat
483scanned_pages_by_limit 9471864
484scanned_anon_pages_by_limit 6640629
485scanned_file_pages_by_limit 2831235
486rotated_pages_by_limit 4243974
487rotated_anon_pages_by_limit 3971968
488rotated_file_pages_by_limit 272006
489freed_pages_by_limit 2318492
490freed_anon_pages_by_limit 962052
491freed_file_pages_by_limit 1356440
492elapsed_ns_by_limit 351386416101
493scanned_pages_by_system 0
494scanned_anon_pages_by_system 0
495scanned_file_pages_by_system 0
496rotated_pages_by_system 0
497rotated_anon_pages_by_system 0
498rotated_file_pages_by_system 0
499freed_pages_by_system 0
500freed_anon_pages_by_system 0
501freed_file_pages_by_system 0
502elapsed_ns_by_system 0
503scanned_pages_by_limit_under_hierarchy 9471864
504scanned_anon_pages_by_limit_under_hierarchy 6640629
505scanned_file_pages_by_limit_under_hierarchy 2831235
506rotated_pages_by_limit_under_hierarchy 4243974
507rotated_anon_pages_by_limit_under_hierarchy 3971968
508rotated_file_pages_by_limit_under_hierarchy 272006
509freed_pages_by_limit_under_hierarchy 2318492
510freed_anon_pages_by_limit_under_hierarchy 962052
511freed_file_pages_by_limit_under_hierarchy 1356440
512elapsed_ns_by_limit_under_hierarchy 351386416101
513scanned_pages_by_system_under_hierarchy 0
514scanned_anon_pages_by_system_under_hierarchy 0
515scanned_file_pages_by_system_under_hierarchy 0
516rotated_pages_by_system_under_hierarchy 0
517rotated_anon_pages_by_system_under_hierarchy 0
518rotated_file_pages_by_system_under_hierarchy 0
519freed_pages_by_system_under_hierarchy 0
520freed_anon_pages_by_system_under_hierarchy 0
521freed_file_pages_by_system_under_hierarchy 0
522elapsed_ns_by_system_under_hierarchy 0
523
4415.3 swappiness 5245.3 swappiness
442 525
443Similar to /proc/sys/vm/swappiness, but affecting a hierarchy of groups only. 526Similar to /proc/sys/vm/swappiness, but affecting a hierarchy of groups only.
diff --git a/Documentation/cpu-freq/cpu-drivers.txt b/Documentation/cpu-freq/cpu-drivers.txt
index 6c30e930c122..c436096351f8 100644
--- a/Documentation/cpu-freq/cpu-drivers.txt
+++ b/Documentation/cpu-freq/cpu-drivers.txt
@@ -168,7 +168,7 @@ in-chipset dynamic frequency switching to policy->min, the upper limit
168to policy->max, and -if supported- select a performance-oriented 168to policy->max, and -if supported- select a performance-oriented
169setting when policy->policy is CPUFREQ_POLICY_PERFORMANCE, and a 169setting when policy->policy is CPUFREQ_POLICY_PERFORMANCE, and a
170powersaving-oriented setting when CPUFREQ_POLICY_POWERSAVE. Also check 170powersaving-oriented setting when CPUFREQ_POLICY_POWERSAVE. Also check
171the reference implementation in arch/i386/kernel/cpu/cpufreq/longrun.c 171the reference implementation in drivers/cpufreq/longrun.c
172 172
173 173
174 174
diff --git a/Documentation/devicetree/bindings/arm/sirf.txt b/Documentation/devicetree/bindings/arm/sirf.txt
new file mode 100644
index 000000000000..6b07f65b32de
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/sirf.txt
@@ -0,0 +1,3 @@
1prima2 "cb" evalutation board
2Required root node properties:
3 - compatible = "sirf,prima2-cb", "sirf,prima2";
diff --git a/Documentation/devicetree/bindings/arm/xilinx.txt b/Documentation/devicetree/bindings/arm/xilinx.txt
new file mode 100644
index 000000000000..6f1ed830b4f7
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/xilinx.txt
@@ -0,0 +1,7 @@
1Xilinx Zynq EP107 Emulation Platform board
2
3This board is an emulation platform for the Zynq product which is
4based on an ARM Cortex A9 processor.
5
6Required root node properties:
7 - compatible = "xlnx,zynq-ep107";
diff --git a/Documentation/devicetree/bindings/dma/fsl-imx-sdma.txt b/Documentation/devicetree/bindings/dma/fsl-imx-sdma.txt
new file mode 100644
index 000000000000..d1e3f443e205
--- /dev/null
+++ b/Documentation/devicetree/bindings/dma/fsl-imx-sdma.txt
@@ -0,0 +1,17 @@
1* Freescale Smart Direct Memory Access (SDMA) Controller for i.MX
2
3Required properties:
4- compatible : Should be "fsl,<chip>-sdma"
5- reg : Should contain SDMA registers location and length
6- interrupts : Should contain SDMA interrupt
7- fsl,sdma-ram-script-name : Should contain the full path of SDMA RAM
8 scripts firmware
9
10Examples:
11
12sdma@83fb0000 {
13 compatible = "fsl,imx51-sdma", "fsl,imx35-sdma";
14 reg = <0x83fb0000 0x4000>;
15 interrupts = <6>;
16 fsl,sdma-ram-script-name = "sdma-imx51.bin";
17};
diff --git a/Documentation/devicetree/bindings/mmc/fsl-imx-esdhc.txt b/Documentation/devicetree/bindings/mmc/fsl-imx-esdhc.txt
new file mode 100644
index 000000000000..ab22fe6e73ab
--- /dev/null
+++ b/Documentation/devicetree/bindings/mmc/fsl-imx-esdhc.txt
@@ -0,0 +1,34 @@
1* Freescale Enhanced Secure Digital Host Controller (eSDHC) for i.MX
2
3The Enhanced Secure Digital Host Controller on Freescale i.MX family
4provides an interface for MMC, SD, and SDIO types of memory cards.
5
6Required properties:
7- compatible : Should be "fsl,<chip>-esdhc"
8- reg : Should contain eSDHC registers location and length
9- interrupts : Should contain eSDHC interrupt
10
11Optional properties:
12- fsl,card-wired : Indicate the card is wired to host permanently
13- fsl,cd-internal : Indicate to use controller internal card detection
14- fsl,wp-internal : Indicate to use controller internal write protection
15- cd-gpios : Specify GPIOs for card detection
16- wp-gpios : Specify GPIOs for write protection
17
18Examples:
19
20esdhc@70004000 {
21 compatible = "fsl,imx51-esdhc";
22 reg = <0x70004000 0x4000>;
23 interrupts = <1>;
24 fsl,cd-internal;
25 fsl,wp-internal;
26};
27
28esdhc@70008000 {
29 compatible = "fsl,imx51-esdhc";
30 reg = <0x70008000 0x4000>;
31 interrupts = <2>;
32 cd-gpios = <&gpio0 6 0>; /* GPIO1_6 */
33 wp-gpios = <&gpio0 5 0>; /* GPIO1_5 */
34};
diff --git a/Documentation/devicetree/bindings/net/can/fsl-flexcan.txt b/Documentation/devicetree/bindings/net/can/fsl-flexcan.txt
index 1a729f089866..1a729f089866 100755..100644
--- a/Documentation/devicetree/bindings/net/can/fsl-flexcan.txt
+++ b/Documentation/devicetree/bindings/net/can/fsl-flexcan.txt
diff --git a/Documentation/devicetree/bindings/net/fsl-fec.txt b/Documentation/devicetree/bindings/net/fsl-fec.txt
new file mode 100644
index 000000000000..de439517dff0
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/fsl-fec.txt
@@ -0,0 +1,24 @@
1* Freescale Fast Ethernet Controller (FEC)
2
3Required properties:
4- compatible : Should be "fsl,<soc>-fec"
5- reg : Address and length of the register set for the device
6- interrupts : Should contain fec interrupt
7- phy-mode : String, operation mode of the PHY interface.
8 Supported values are: "mii", "gmii", "sgmii", "tbi", "rmii",
9 "rgmii", "rgmii-id", "rgmii-rxid", "rgmii-txid", "rtbi", "smii".
10- phy-reset-gpios : Should specify the gpio for phy reset
11
12Optional properties:
13- local-mac-address : 6 bytes, mac address
14
15Example:
16
17fec@83fec000 {
18 compatible = "fsl,imx51-fec", "fsl,imx27-fec";
19 reg = <0x83fec000 0x4000>;
20 interrupts = <87>;
21 phy-mode = "mii";
22 phy-reset-gpios = <&gpio1 14 0>; /* GPIO2_14 */
23 local-mac-address = [00 04 9F 01 1B B9];
24};
diff --git a/Documentation/devicetree/bindings/rtc/olpc-xo1-rtc.txt b/Documentation/devicetree/bindings/rtc/olpc-xo1-rtc.txt
new file mode 100644
index 000000000000..a2891ceb6344
--- /dev/null
+++ b/Documentation/devicetree/bindings/rtc/olpc-xo1-rtc.txt
@@ -0,0 +1,5 @@
1OLPC XO-1 RTC
2~~~~~~~~~~~~~
3
4Required properties:
5 - compatible : "olpc,xo1-rtc"
diff --git a/Documentation/devicetree/bindings/tty/serial/fsl-imx-uart.txt b/Documentation/devicetree/bindings/tty/serial/fsl-imx-uart.txt
new file mode 100644
index 000000000000..a9c0406280e8
--- /dev/null
+++ b/Documentation/devicetree/bindings/tty/serial/fsl-imx-uart.txt
@@ -0,0 +1,19 @@
1* Freescale i.MX Universal Asynchronous Receiver/Transmitter (UART)
2
3Required properties:
4- compatible : Should be "fsl,<soc>-uart"
5- reg : Address and length of the register set for the device
6- interrupts : Should contain uart interrupt
7
8Optional properties:
9- fsl,uart-has-rtscts : Indicate the uart has rts and cts
10- fsl,irda-mode : Indicate the uart supports irda mode
11
12Example:
13
14uart@73fbc000 {
15 compatible = "fsl,imx51-uart", "fsl,imx21-uart";
16 reg = <0x73fbc000 0x4000>;
17 interrupts = <31>;
18 fsl,uart-has-rtscts;
19};
diff --git a/Documentation/driver-model/device.txt b/Documentation/driver-model/device.txt
index b2ff42685bcb..bdefe728a737 100644
--- a/Documentation/driver-model/device.txt
+++ b/Documentation/driver-model/device.txt
@@ -104,4 +104,4 @@ Then in the module init function is would do:
104 104
105And assuming 'dev' is the struct device passed into the probe hook, the driver 105And assuming 'dev' is the struct device passed into the probe hook, the driver
106probe function would do something like: 106probe function would do something like:
107 create_device(&mydriver_class, dev, chrdev, &private_data, "my_name"); 107 device_create(&mydriver_class, dev, chrdev, &private_data, "my_name");
diff --git a/Documentation/driver-model/overview.txt b/Documentation/driver-model/overview.txt
index 07236ed968da..6a8f9a8075d8 100644
--- a/Documentation/driver-model/overview.txt
+++ b/Documentation/driver-model/overview.txt
@@ -30,7 +30,7 @@ management, and hot plug. In particular, the model dictated by Intel and
30Microsoft (namely ACPI) ensures that almost every device on almost any bus 30Microsoft (namely ACPI) ensures that almost every device on almost any bus
31on an x86-compatible system can work within this paradigm. Of course, 31on an x86-compatible system can work within this paradigm. Of course,
32not every bus is able to support all such operations, although most 32not every bus is able to support all such operations, although most
33buses support a most of those operations. 33buses support most of those operations.
34 34
35 35
36Downstream Access 36Downstream Access
@@ -46,25 +46,29 @@ struct pci_dev now looks like this:
46struct pci_dev { 46struct pci_dev {
47 ... 47 ...
48 48
49 struct device dev; 49 struct device dev; /* Generic device interface */
50 ...
50}; 51};
51 52
52Note first that it is statically allocated. This means only one allocation on 53Note first that the struct device dev within the struct pci_dev is
53device discovery. Note also that it is at the _end_ of struct pci_dev. This is 54statically allocated. This means only one allocation on device discovery.
54to make people think about what they're doing when switching between the bus 55
55driver and the global driver; and to prevent against mindless casts between 56Note also that that struct device dev is not necessarily defined at the
56the two. 57front of the pci_dev structure. This is to make people think about what
58they're doing when switching between the bus driver and the global driver,
59and to discourage meaningless and incorrect casts between the two.
57 60
58The PCI bus layer freely accesses the fields of struct device. It knows about 61The PCI bus layer freely accesses the fields of struct device. It knows about
59the structure of struct pci_dev, and it should know the structure of struct 62the structure of struct pci_dev, and it should know the structure of struct
60device. Individual PCI device drivers that have been converted to the current 63device. Individual PCI device drivers that have been converted to the current
61driver model generally do not and should not touch the fields of struct device, 64driver model generally do not and should not touch the fields of struct device,
62unless there is a strong compelling reason to do so. 65unless there is a compelling reason to do so.
63 66
64This abstraction is prevention of unnecessary pain during transitional phases. 67The above abstraction prevents unnecessary pain during transitional phases.
65If the name of the field changes or is removed, then every downstream driver 68If it were not done this way, then when a field was renamed or removed, every
66will break. On the other hand, if only the bus layer (and not the device 69downstream driver would break. On the other hand, if only the bus layer
67layer) accesses struct device, it is only that layer that needs to change. 70(and not the device layer) accesses the struct device, it is only the bus
71layer that needs to change.
68 72
69 73
70User Interface 74User Interface
@@ -73,15 +77,27 @@ User Interface
73By virtue of having a complete hierarchical view of all the devices in the 77By virtue of having a complete hierarchical view of all the devices in the
74system, exporting a complete hierarchical view to userspace becomes relatively 78system, exporting a complete hierarchical view to userspace becomes relatively
75easy. This has been accomplished by implementing a special purpose virtual 79easy. This has been accomplished by implementing a special purpose virtual
76file system named sysfs. It is hence possible for the user to mount the 80file system named sysfs.
77whole sysfs filesystem anywhere in userspace. 81
82Almost all mainstream Linux distros mount this filesystem automatically; you
83can see some variation of the following in the output of the "mount" command:
84
85$ mount
86...
87none on /sys type sysfs (rw,noexec,nosuid,nodev)
88...
89$
90
91The auto-mounting of sysfs is typically accomplished by an entry similar to
92the following in the /etc/fstab file:
93
94none /sys sysfs defaults 0 0
78 95
79This can be done permanently by providing the following entry into the 96or something similar in the /lib/init/fstab file on Debian-based systems:
80/etc/fstab (under the provision that the mount point does exist, of course):
81 97
82none /sys sysfs defaults 0 0 98none /sys sysfs nodev,noexec,nosuid 0 0
83 99
84Or by hand on the command line: 100If sysfs is not automatically mounted, you can always do it manually with:
85 101
86# mount -t sysfs sysfs /sys 102# mount -t sysfs sysfs /sys
87 103
diff --git a/Documentation/fb/modedb.txt b/Documentation/fb/modedb.txt
index ec4dee75a354..16aa08453911 100644
--- a/Documentation/fb/modedb.txt
+++ b/Documentation/fb/modedb.txt
@@ -20,7 +20,7 @@ in a video= option, fbmem considers that to be a global video mode option.
20 20
21Valid mode specifiers (mode_option argument): 21Valid mode specifiers (mode_option argument):
22 22
23 <xres>x<yres>[M][R][-<bpp>][@<refresh>][i][m] 23 <xres>x<yres>[M][R][-<bpp>][@<refresh>][i][m][eDd]
24 <name>[-<bpp>][@<refresh>] 24 <name>[-<bpp>][@<refresh>]
25 25
26with <xres>, <yres>, <bpp> and <refresh> decimal numbers and <name> a string. 26with <xres>, <yres>, <bpp> and <refresh> decimal numbers and <name> a string.
@@ -36,6 +36,21 @@ pixels and 1.8% of yres).
36 36
37 Sample usage: 1024x768M@60m - CVT timing with margins 37 Sample usage: 1024x768M@60m - CVT timing with margins
38 38
39DRM drivers also add options to enable or disable outputs:
40
41'e' will force the display to be enabled, i.e. it will override the detection
42if a display is connected. 'D' will force the display to be enabled and use
43digital output. This is useful for outputs that have both analog and digital
44signals (e.g. HDMI and DVI-I). For other outputs it behaves like 'e'. If 'd'
45is specified the output is disabled.
46
47You can additionally specify which output the options matches to.
48To force the VGA output to be enabled and drive a specific mode say:
49 video=VGA-1:1280x1024@60me
50
51Specifying the option multiple times for different ports is possible, e.g.:
52 video=LVDS-1:d video=HDMI-1:D
53
39***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** 54***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo ***** oOo *****
40 55
41What is the VESA(TM) Coordinated Video Timings (CVT)? 56What is the VESA(TM) Coordinated Video Timings (CVT)?
@@ -132,5 +147,5 @@ There may be more modes.
132 tridentfb - Trident (Cyber)blade chipset frame buffer 147 tridentfb - Trident (Cyber)blade chipset frame buffer
133 vt8623fb - VIA 8623 frame buffer 148 vt8623fb - VIA 8623 frame buffer
134 149
135BTW, only a few drivers use this at the moment. Others are to follow 150BTW, only a few fb drivers use this at the moment. Others are to follow
136(feel free to send patches). 151(feel free to send patches). The DRM drivers also support this.
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt
index d59e71df5c5c..dfd6a9f4a583 100644
--- a/Documentation/feature-removal-schedule.txt
+++ b/Documentation/feature-removal-schedule.txt
@@ -184,7 +184,7 @@ Why: /proc/<pid>/oom_adj allows userspace to influence the oom killer's
184 184
185 A much more powerful interface, /proc/<pid>/oom_score_adj, was 185 A much more powerful interface, /proc/<pid>/oom_score_adj, was
186 introduced with the oom killer rewrite that allows users to increase or 186 introduced with the oom killer rewrite that allows users to increase or
187 decrease the badness() score linearly. This interface will replace 187 decrease the badness score linearly. This interface will replace
188 /proc/<pid>/oom_adj. 188 /proc/<pid>/oom_adj.
189 189
190 A warning will be emitted to the kernel log if an application uses this 190 A warning will be emitted to the kernel log if an application uses this
@@ -193,20 +193,6 @@ Why: /proc/<pid>/oom_adj allows userspace to influence the oom killer's
193 193
194--------------------------- 194---------------------------
195 195
196What: CS5535/CS5536 obsolete GPIO driver
197When: June 2011
198Files: drivers/staging/cs5535_gpio/*
199Check: drivers/staging/cs5535_gpio/cs5535_gpio.c
200Why: A newer driver replaces this; it is drivers/gpio/cs5535-gpio.c, and
201 integrates with the Linux GPIO subsystem. The old driver has been
202 moved to staging, and will be removed altogether around 2.6.40.
203 Please test the new driver, and ensure that the functionality you
204 need and any bugfixes from the old driver are available in the new
205 one.
206Who: Andres Salomon <dilinger@queued.net>
207
208--------------------------
209
210What: remove EXPORT_SYMBOL(kernel_thread) 196What: remove EXPORT_SYMBOL(kernel_thread)
211When: August 2006 197When: August 2006
212Files: arch/*/kernel/*_ksyms.c 198Files: arch/*/kernel/*_ksyms.c
@@ -294,7 +280,7 @@ When: The schedule was July 2008, but it was decided that we are going to keep t
294Why: The support code for the old firmware hurts code readability/maintainability 280Why: The support code for the old firmware hurts code readability/maintainability
295 and slightly hurts runtime performance. Bugfixes for the old firmware 281 and slightly hurts runtime performance. Bugfixes for the old firmware
296 are not provided by Broadcom anymore. 282 are not provided by Broadcom anymore.
297Who: Michael Buesch <mb@bu3sch.de> 283Who: Michael Buesch <m@bues.ch>
298 284
299--------------------------- 285---------------------------
300 286
@@ -430,7 +416,7 @@ Who: Avi Kivity <avi@redhat.com>
430---------------------------- 416----------------------------
431 417
432What: iwlwifi 50XX module parameters 418What: iwlwifi 50XX module parameters
433When: 2.6.40 419When: 3.0
434Why: The "..50" modules parameters were used to configure 5000 series and 420Why: The "..50" modules parameters were used to configure 5000 series and
435 up devices; different set of module parameters also available for 4965 421 up devices; different set of module parameters also available for 4965
436 with same functionalities. Consolidate both set into single place 422 with same functionalities. Consolidate both set into single place
@@ -441,7 +427,7 @@ Who: Wey-Yi Guy <wey-yi.w.guy@intel.com>
441---------------------------- 427----------------------------
442 428
443What: iwl4965 alias support 429What: iwl4965 alias support
444When: 2.6.40 430When: 3.0
445Why: Internal alias support has been present in module-init-tools for some 431Why: Internal alias support has been present in module-init-tools for some
446 time, the MODULE_ALIAS("iwl4965") boilerplate aliases can be removed 432 time, the MODULE_ALIAS("iwl4965") boilerplate aliases can be removed
447 with no impact. 433 with no impact.
@@ -474,15 +460,8 @@ Who: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
474 460
475---------------------------- 461----------------------------
476 462
477What: DMA_xxBIT_MASK macros
478When: Jun 2011
479Why: DMA_xxBIT_MASK macros were replaced with DMA_BIT_MASK() macros.
480Who: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
481
482----------------------------
483
484What: iwlwifi disable_hw_scan module parameters 463What: iwlwifi disable_hw_scan module parameters
485When: 2.6.40 464When: 3.0
486Why: Hareware scan is the prefer method for iwlwifi devices for 465Why: Hareware scan is the prefer method for iwlwifi devices for
487 scanning operation. Remove software scan support for all the 466 scanning operation. Remove software scan support for all the
488 iwlwifi devices. 467 iwlwifi devices.
@@ -491,16 +470,6 @@ Who: Wey-Yi Guy <wey-yi.w.guy@intel.com>
491 470
492---------------------------- 471----------------------------
493 472
494What: access to nfsd auth cache through sys_nfsservctl or '.' files
495 in the 'nfsd' filesystem.
496When: 2.6.40
497Why: This is a legacy interface which have been replaced by a more
498 dynamic cache. Continuing to maintain this interface is an
499 unnecessary burden.
500Who: NeilBrown <neilb@suse.de>
501
502----------------------------
503
504What: Legacy, non-standard chassis intrusion detection interface. 473What: Legacy, non-standard chassis intrusion detection interface.
505When: June 2011 474When: June 2011
506Why: The adm9240, w83792d and w83793 hardware monitoring drivers have 475Why: The adm9240, w83792d and w83793 hardware monitoring drivers have
@@ -518,22 +487,6 @@ Files: net/netfilter/xt_connlimit.c
518 487
519---------------------------- 488----------------------------
520 489
521What: noswapaccount kernel command line parameter
522When: 2.6.40
523Why: The original implementation of memsw feature enabled by
524 CONFIG_CGROUP_MEM_RES_CTLR_SWAP could be disabled by the noswapaccount
525 kernel parameter (introduced in 2.6.29-rc1). Later on, this decision
526 turned out to be not ideal because we cannot have the feature compiled
527 in and disabled by default and let only interested to enable it
528 (e.g. general distribution kernels might need it). Therefore we have
529 added swapaccount[=0|1] parameter (introduced in 2.6.37) which provides
530 the both possibilities. If we remove noswapaccount we will have
531 less command line parameters with the same functionality and we
532 can also cleanup the parameter handling a bit ().
533Who: Michal Hocko <mhocko@suse.cz>
534
535----------------------------
536
537What: ipt_addrtype match include file 490What: ipt_addrtype match include file
538When: 2012 491When: 2012
539Why: superseded by xt_addrtype 492Why: superseded by xt_addrtype
@@ -552,7 +505,7 @@ Who: Jean Delvare <khali@linux-fr.org>
552---------------------------- 505----------------------------
553 506
554What: Support for UVCIOC_CTRL_ADD in the uvcvideo driver 507What: Support for UVCIOC_CTRL_ADD in the uvcvideo driver
555When: 2.6.42 508When: 3.2
556Why: The information passed to the driver by this ioctl is now queried 509Why: The information passed to the driver by this ioctl is now queried
557 dynamically from the device. 510 dynamically from the device.
558Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> 511Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
@@ -560,7 +513,7 @@ Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
560---------------------------- 513----------------------------
561 514
562What: Support for UVCIOC_CTRL_MAP_OLD in the uvcvideo driver 515What: Support for UVCIOC_CTRL_MAP_OLD in the uvcvideo driver
563When: 2.6.42 516When: 3.2
564Why: Used only by applications compiled against older driver versions. 517Why: Used only by applications compiled against older driver versions.
565 Superseded by UVCIOC_CTRL_MAP which supports V4L2 menu controls. 518 Superseded by UVCIOC_CTRL_MAP which supports V4L2 menu controls.
566Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> 519Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
@@ -568,7 +521,7 @@ Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
568---------------------------- 521----------------------------
569 522
570What: Support for UVCIOC_CTRL_GET and UVCIOC_CTRL_SET in the uvcvideo driver 523What: Support for UVCIOC_CTRL_GET and UVCIOC_CTRL_SET in the uvcvideo driver
571When: 2.6.42 524When: 3.2
572Why: Superseded by the UVCIOC_CTRL_QUERY ioctl. 525Why: Superseded by the UVCIOC_CTRL_QUERY ioctl.
573Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> 526Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
574 527
@@ -595,3 +548,10 @@ Why: Just opening a V4L device should not change the state of the hardware
595Who: Hans Verkuil <hans.verkuil@cisco.com> 548Who: Hans Verkuil <hans.verkuil@cisco.com>
596 549
597---------------------------- 550----------------------------
551
552What: g_file_storage driver
553When: 3.8
554Why: This driver has been superseded by g_mass_storage.
555Who: Alan Stern <stern@rowland.harvard.edu>
556
557----------------------------
diff --git a/Documentation/filesystems/Locking b/Documentation/filesystems/Locking
index ca7e25292542..653380793a6c 100644
--- a/Documentation/filesystems/Locking
+++ b/Documentation/filesystems/Locking
@@ -52,7 +52,7 @@ ata *);
52 void (*put_link) (struct dentry *, struct nameidata *, void *); 52 void (*put_link) (struct dentry *, struct nameidata *, void *);
53 void (*truncate) (struct inode *); 53 void (*truncate) (struct inode *);
54 int (*permission) (struct inode *, int, unsigned int); 54 int (*permission) (struct inode *, int, unsigned int);
55 int (*check_acl)(struct inode *, int); 55 int (*get_acl)(struct inode *, int);
56 int (*setattr) (struct dentry *, struct iattr *); 56 int (*setattr) (struct dentry *, struct iattr *);
57 int (*getattr) (struct vfsmount *, struct dentry *, struct kstat *); 57 int (*getattr) (struct vfsmount *, struct dentry *, struct kstat *);
58 int (*setxattr) (struct dentry *, const char *,const void *,size_t,int); 58 int (*setxattr) (struct dentry *, const char *,const void *,size_t,int);
@@ -80,7 +80,7 @@ put_link: no
80truncate: yes (see below) 80truncate: yes (see below)
81setattr: yes 81setattr: yes
82permission: no (may not block if called in rcu-walk mode) 82permission: no (may not block if called in rcu-walk mode)
83check_acl: no 83get_acl: no
84getattr: no 84getattr: no
85setxattr: yes 85setxattr: yes
86getxattr: no 86getxattr: no
@@ -338,21 +338,21 @@ fl_release_private: maybe no
338 338
339----------------------- lock_manager_operations --------------------------- 339----------------------- lock_manager_operations ---------------------------
340prototypes: 340prototypes:
341 int (*fl_compare_owner)(struct file_lock *, struct file_lock *); 341 int (*lm_compare_owner)(struct file_lock *, struct file_lock *);
342 void (*fl_notify)(struct file_lock *); /* unblock callback */ 342 void (*lm_notify)(struct file_lock *); /* unblock callback */
343 int (*fl_grant)(struct file_lock *, struct file_lock *, int); 343 int (*lm_grant)(struct file_lock *, struct file_lock *, int);
344 void (*fl_release_private)(struct file_lock *); 344 void (*lm_release_private)(struct file_lock *);
345 void (*fl_break)(struct file_lock *); /* break_lease callback */ 345 void (*lm_break)(struct file_lock *); /* break_lease callback */
346 int (*fl_change)(struct file_lock **, int); 346 int (*lm_change)(struct file_lock **, int);
347 347
348locking rules: 348locking rules:
349 file_lock_lock may block 349 file_lock_lock may block
350fl_compare_owner: yes no 350lm_compare_owner: yes no
351fl_notify: yes no 351lm_notify: yes no
352fl_grant: no no 352lm_grant: no no
353fl_release_private: maybe no 353lm_release_private: maybe no
354fl_break: yes no 354lm_break: yes no
355fl_change yes no 355lm_change yes no
356 356
357--------------------------- buffer_head ----------------------------------- 357--------------------------- buffer_head -----------------------------------
358prototypes: 358prototypes:
diff --git a/Documentation/filesystems/debugfs.txt b/Documentation/filesystems/debugfs.txt
index ed52af60c2d8..742cc06e138f 100644
--- a/Documentation/filesystems/debugfs.txt
+++ b/Documentation/filesystems/debugfs.txt
@@ -73,8 +73,8 @@ the following functions can be used instead:
73 struct dentry *parent, u16 *value); 73 struct dentry *parent, u16 *value);
74 struct dentry *debugfs_create_x32(const char *name, mode_t mode, 74 struct dentry *debugfs_create_x32(const char *name, mode_t mode,
75 struct dentry *parent, u32 *value); 75 struct dentry *parent, u32 *value);
76 76 struct dentry *debugfs_create_x64(const char *name, mode_t mode,
77Note that there is no debugfs_create_x64(). 77 struct dentry *parent, u64 *value);
78 78
79These functions are useful as long as the developer knows the size of the 79These functions are useful as long as the developer knows the size of the
80value to be exported. Some types can have different widths on different 80value to be exported. Some types can have different widths on different
diff --git a/Documentation/filesystems/ext3.txt b/Documentation/filesystems/ext3.txt
index 272f80d5f966..22f3a0eda1d2 100644
--- a/Documentation/filesystems/ext3.txt
+++ b/Documentation/filesystems/ext3.txt
@@ -147,15 +147,6 @@ grpjquota=<file> during journal replay. They replace the above
147 package for more details 147 package for more details
148 (http://sourceforge.net/projects/linuxquota). 148 (http://sourceforge.net/projects/linuxquota).
149 149
150bh (*) ext3 associates buffer heads to data pages to
151nobh (a) cache disk block mapping information
152 (b) link pages into transaction to provide
153 ordering guarantees.
154 "bh" option forces use of buffer heads.
155 "nobh" option tries to avoid associating buffer
156 heads (supported only for "writeback" mode).
157
158
159Specification 150Specification
160============= 151=============
161Ext3 shares all disk implementation with the ext2 filesystem, and adds 152Ext3 shares all disk implementation with the ext2 filesystem, and adds
@@ -227,5 +218,5 @@ kernel source: <file:fs/ext3/>
227programs: http://e2fsprogs.sourceforge.net/ 218programs: http://e2fsprogs.sourceforge.net/
228 http://ext2resize.sourceforge.net 219 http://ext2resize.sourceforge.net
229 220
230useful links: http://www.ibm.com/developerworks/library/l-fs7.html 221useful links: http://www.ibm.com/developerworks/library/l-fs7/index.html
231 http://www.ibm.com/developerworks/library/l-fs8.html 222 http://www.ibm.com/developerworks/library/l-fs8/index.html
diff --git a/Documentation/filesystems/ext4.txt b/Documentation/filesystems/ext4.txt
index 3ae9bc94352a..232a575a0c48 100644
--- a/Documentation/filesystems/ext4.txt
+++ b/Documentation/filesystems/ext4.txt
@@ -68,12 +68,12 @@ Note: More extensive information for getting started with ext4 can be
68 '-o barriers=[0|1]' mount option for both ext3 and ext4 filesystems 68 '-o barriers=[0|1]' mount option for both ext3 and ext4 filesystems
69 for a fair comparison. When tuning ext3 for best benchmark numbers, 69 for a fair comparison. When tuning ext3 for best benchmark numbers,
70 it is often worthwhile to try changing the data journaling mode; '-o 70 it is often worthwhile to try changing the data journaling mode; '-o
71 data=writeback,nobh' can be faster for some workloads. (Note 71 data=writeback' can be faster for some workloads. (Note however that
72 however that running mounted with data=writeback can potentially 72 running mounted with data=writeback can potentially leave stale data
73 leave stale data exposed in recently written files in case of an 73 exposed in recently written files in case of an unclean shutdown,
74 unclean shutdown, which could be a security exposure in some 74 which could be a security exposure in some situations.) Configuring
75 situations.) Configuring the filesystem with a large journal can 75 the filesystem with a large journal can also be helpful for
76 also be helpful for metadata-intensive workloads. 76 metadata-intensive workloads.
77 77
782. Features 782. Features
79=========== 79===========
@@ -272,14 +272,6 @@ grpjquota=<file> during journal replay. They replace the above
272 package for more details 272 package for more details
273 (http://sourceforge.net/projects/linuxquota). 273 (http://sourceforge.net/projects/linuxquota).
274 274
275bh (*) ext4 associates buffer heads to data pages to
276nobh (a) cache disk block mapping information
277 (b) link pages into transaction to provide
278 ordering guarantees.
279 "bh" option forces use of buffer heads.
280 "nobh" option tries to avoid associating buffer
281 heads (supported only for "writeback" mode).
282
283stripe=n Number of filesystem blocks that mballoc will try 275stripe=n Number of filesystem blocks that mballoc will try
284 to use for allocation size and alignment. For RAID5/6 276 to use for allocation size and alignment. For RAID5/6
285 systems this should be the number of data 277 systems this should be the number of data
@@ -393,8 +385,7 @@ dioread_nolock locking. If the dioread_nolock option is specified
393 write and convert the extent to initialized after IO 385 write and convert the extent to initialized after IO
394 completes. This approach allows ext4 code to avoid 386 completes. This approach allows ext4 code to avoid
395 using inode mutex, which improves scalability on high 387 using inode mutex, which improves scalability on high
396 speed storages. However this does not work with nobh 388 speed storages. However this does not work with
397 option and the mount will fail. Nor does it work with
398 data journaling and dioread_nolock option will be 389 data journaling and dioread_nolock option will be
399 ignored with kernel warning. Note that dioread_nolock 390 ignored with kernel warning. Note that dioread_nolock
400 code path is only used for extent-based files. 391 code path is only used for extent-based files.
diff --git a/Documentation/filesystems/nfs/nfs41-server.txt b/Documentation/filesystems/nfs/nfs41-server.txt
index 04884914a1c8..092fad92a3f0 100644
--- a/Documentation/filesystems/nfs/nfs41-server.txt
+++ b/Documentation/filesystems/nfs/nfs41-server.txt
@@ -39,27 +39,17 @@ interoperability problems with future clients. Known issues:
39 from a linux client are possible, but we aren't really 39 from a linux client are possible, but we aren't really
40 conformant with the spec (for example, we don't use kerberos 40 conformant with the spec (for example, we don't use kerberos
41 on the backchannel correctly). 41 on the backchannel correctly).
42 - no trunking support: no clients currently take advantage of
43 trunking, but this is a mandatory feature, and its use is
44 recommended to clients in a number of places. (E.g. to ensure
45 timely renewal in case an existing connection's retry timeouts
46 have gotten too long; see section 8.3 of the RFC.)
47 Therefore, lack of this feature may cause future clients to
48 fail.
49 - Incomplete backchannel support: incomplete backchannel gss 42 - Incomplete backchannel support: incomplete backchannel gss
50 support and no support for BACKCHANNEL_CTL mean that 43 support and no support for BACKCHANNEL_CTL mean that
51 callbacks (hence delegations and layouts) may not be 44 callbacks (hence delegations and layouts) may not be
52 available and clients confused by the incomplete 45 available and clients confused by the incomplete
53 implementation may fail. 46 implementation may fail.
54 - Server reboot recovery is unsupported; if the server reboots,
55 clients may fail.
56 - We do not support SSV, which provides security for shared 47 - We do not support SSV, which provides security for shared
57 client-server state (thus preventing unauthorized tampering 48 client-server state (thus preventing unauthorized tampering
58 with locks and opens, for example). It is mandatory for 49 with locks and opens, for example). It is mandatory for
59 servers to support this, though no clients use it yet. 50 servers to support this, though no clients use it yet.
60 - Mandatory operations which we do not support, such as 51 - Mandatory operations which we do not support, such as
61 DESTROY_CLIENTID, FREE_STATEID, SECINFO_NO_NAME, and 52 DESTROY_CLIENTID, are not currently used by clients, but will be
62 TEST_STATEID, are not currently used by clients, but will be
63 (and the spec recommends their uses in common cases), and 53 (and the spec recommends their uses in common cases), and
64 clients should not be expected to know how to recover from the 54 clients should not be expected to know how to recover from the
65 case where they are not supported. This will eventually cause 55 case where they are not supported. This will eventually cause
@@ -69,8 +59,9 @@ In addition, some limitations are inherited from the current NFSv4
69implementation: 59implementation:
70 60
71 - Incomplete delegation enforcement: if a file is renamed or 61 - Incomplete delegation enforcement: if a file is renamed or
72 unlinked, a client holding a delegation may continue to 62 unlinked by a local process, a client holding a delegation may
73 indefinitely allow opens of the file under the old name. 63 continue to indefinitely allow opens of the file under the old
64 name.
74 65
75The table below, taken from the NFSv4.1 document, lists 66The table below, taken from the NFSv4.1 document, lists
76the operations that are mandatory to implement (REQ), optional 67the operations that are mandatory to implement (REQ), optional
@@ -99,7 +90,7 @@ Operations
99 +----------------------+------------+--------------+----------------+ 90 +----------------------+------------+--------------+----------------+
100 | ACCESS | REQ | | Section 18.1 | 91 | ACCESS | REQ | | Section 18.1 |
101NS | BACKCHANNEL_CTL | REQ | | Section 18.33 | 92NS | BACKCHANNEL_CTL | REQ | | Section 18.33 |
102NS | BIND_CONN_TO_SESSION | REQ | | Section 18.34 | 93I | BIND_CONN_TO_SESSION | REQ | | Section 18.34 |
103 | CLOSE | REQ | | Section 18.2 | 94 | CLOSE | REQ | | Section 18.2 |
104 | COMMIT | REQ | | Section 18.3 | 95 | COMMIT | REQ | | Section 18.3 |
105 | CREATE | REQ | | Section 18.4 | 96 | CREATE | REQ | | Section 18.4 |
@@ -111,7 +102,7 @@ NS*| DELEGPURGE | OPT | FDELG (REQ) | Section 18.5 |
111NS | DESTROY_CLIENTID | REQ | | Section 18.50 | 102NS | DESTROY_CLIENTID | REQ | | Section 18.50 |
112I | DESTROY_SESSION | REQ | | Section 18.37 | 103I | DESTROY_SESSION | REQ | | Section 18.37 |
113I | EXCHANGE_ID | REQ | | Section 18.35 | 104I | EXCHANGE_ID | REQ | | Section 18.35 |
114NS | FREE_STATEID | REQ | | Section 18.38 | 105I | FREE_STATEID | REQ | | Section 18.38 |
115 | GETATTR | REQ | | Section 18.7 | 106 | GETATTR | REQ | | Section 18.7 |
116P | GETDEVICEINFO | OPT | pNFS (REQ) | Section 18.40 | 107P | GETDEVICEINFO | OPT | pNFS (REQ) | Section 18.40 |
117P | GETDEVICELIST | OPT | pNFS (OPT) | Section 18.41 | 108P | GETDEVICELIST | OPT | pNFS (OPT) | Section 18.41 |
@@ -145,14 +136,14 @@ NS*| OPENATTR | OPT | | Section 18.17 |
145 | RESTOREFH | REQ | | Section 18.27 | 136 | RESTOREFH | REQ | | Section 18.27 |
146 | SAVEFH | REQ | | Section 18.28 | 137 | SAVEFH | REQ | | Section 18.28 |
147 | SECINFO | REQ | | Section 18.29 | 138 | SECINFO | REQ | | Section 18.29 |
148NS | SECINFO_NO_NAME | REC | pNFS files | Section 18.45, | 139I | SECINFO_NO_NAME | REC | pNFS files | Section 18.45, |
149 | | | layout (REQ) | Section 13.12 | 140 | | | layout (REQ) | Section 13.12 |
150I | SEQUENCE | REQ | | Section 18.46 | 141I | SEQUENCE | REQ | | Section 18.46 |
151 | SETATTR | REQ | | Section 18.30 | 142 | SETATTR | REQ | | Section 18.30 |
152 | SETCLIENTID | MNI | | N/A | 143 | SETCLIENTID | MNI | | N/A |
153 | SETCLIENTID_CONFIRM | MNI | | N/A | 144 | SETCLIENTID_CONFIRM | MNI | | N/A |
154NS | SET_SSV | REQ | | Section 18.47 | 145NS | SET_SSV | REQ | | Section 18.47 |
155NS | TEST_STATEID | REQ | | Section 18.48 | 146I | TEST_STATEID | REQ | | Section 18.48 |
156 | VERIFY | REQ | | Section 18.31 | 147 | VERIFY | REQ | | Section 18.31 |
157NS*| WANT_DELEGATION | OPT | FDELG (OPT) | Section 18.49 | 148NS*| WANT_DELEGATION | OPT | FDELG (OPT) | Section 18.49 |
158 | WRITE | REQ | | Section 18.32 | 149 | WRITE | REQ | | Section 18.32 |
@@ -206,12 +197,6 @@ CREATE_SESSION:
206SEQUENCE: 197SEQUENCE:
207* no support for dynamic slot table renegotiation (optional) 198* no support for dynamic slot table renegotiation (optional)
208 199
209nfsv4.1 COMPOUND rules:
210The following cases aren't supported yet:
211* Enforcing of NFS4ERR_NOT_ONLY_OP for: BIND_CONN_TO_SESSION, CREATE_SESSION,
212 DESTROY_CLIENTID, DESTROY_SESSION, EXCHANGE_ID.
213* DESTROY_SESSION MUST be the final operation in the COMPOUND request.
214
215Nonstandard compound limitations: 200Nonstandard compound limitations:
216* No support for a sessions fore channel RPC compound that requires both a 201* No support for a sessions fore channel RPC compound that requires both a
217 ca_maxrequestsize request and a ca_maxresponsesize reply, so we may 202 ca_maxrequestsize request and a ca_maxresponsesize reply, so we may
@@ -219,3 +204,5 @@ Nonstandard compound limitations:
219 negotiation. 204 negotiation.
220* No more than one IO operation (read, write, readdir) allowed per 205* No more than one IO operation (read, write, readdir) allowed per
221 compound. 206 compound.
207
208See also http://wiki.linux-nfs.org/wiki/index.php/Server_4.0_and_4.1_issues.
diff --git a/Documentation/filesystems/nfs/nfsroot.txt b/Documentation/filesystems/nfs/nfsroot.txt
index 90c71c6f0d00..ffdd9d866ad7 100644
--- a/Documentation/filesystems/nfs/nfsroot.txt
+++ b/Documentation/filesystems/nfs/nfsroot.txt
@@ -226,7 +226,7 @@ They depend on various facilities being available:
226 cdrecord. 226 cdrecord.
227 227
228 e.g. 228 e.g.
229 cdrecord dev=ATAPI:1,0,0 arch/i386/boot/image.iso 229 cdrecord dev=ATAPI:1,0,0 arch/x86/boot/image.iso
230 230
231 For more information on isolinux, including how to create bootdisks 231 For more information on isolinux, including how to create bootdisks
232 for prebuilt kernels, see http://syslinux.zytor.com/ 232 for prebuilt kernels, see http://syslinux.zytor.com/
diff --git a/Documentation/filesystems/porting b/Documentation/filesystems/porting
index 7f8861d341ea..b4a3d765ff9a 100644
--- a/Documentation/filesystems/porting
+++ b/Documentation/filesystems/porting
@@ -407,10 +407,11 @@ to some pointer to returning that pointer. On errors return ERR_PTR(...).
407 407
408-- 408--
409[mandatory] 409[mandatory]
410 ->permission(), generic_permission() and ->check_acl() have lost flags 410 ->permission() and generic_permission()have lost flags
411argument; instead of passing IPERM_FLAG_RCU we add MAY_NOT_BLOCK into mask. 411argument; instead of passing IPERM_FLAG_RCU we add MAY_NOT_BLOCK into mask.
412 generic_permission() has also lost the check_acl argument; if you want 412 generic_permission() has also lost the check_acl argument; ACL checking
413non-NULL to be used for that inode, put it into ->i_op->check_acl. 413has been taken to VFS and filesystems need to provide a non-NULL ->i_op->get_acl
414to read an ACL from disk.
414 415
415-- 416--
416[mandatory] 417[mandatory]
diff --git a/Documentation/filesystems/squashfs.txt b/Documentation/filesystems/squashfs.txt
index d4d41465a0b1..7db3ebda5a4c 100644
--- a/Documentation/filesystems/squashfs.txt
+++ b/Documentation/filesystems/squashfs.txt
@@ -2,7 +2,7 @@ SQUASHFS 4.0 FILESYSTEM
2======================= 2=======================
3 3
4Squashfs is a compressed read-only filesystem for Linux. 4Squashfs is a compressed read-only filesystem for Linux.
5It uses zlib/lzo compression to compress files, inodes and directories. 5It uses zlib/lzo/xz compression to compress files, inodes and directories.
6Inodes in the system are very small and all blocks are packed to minimise 6Inodes in the system are very small and all blocks are packed to minimise
7data overhead. Block sizes greater than 4K are supported up to a maximum 7data overhead. Block sizes greater than 4K are supported up to a maximum
8of 1Mbytes (default block size 128K). 8of 1Mbytes (default block size 128K).
@@ -55,6 +55,8 @@ create populated squashfs filesystems. This and other squashfs utilities
55can be obtained from http://www.squashfs.org. Usage instructions can be 55can be obtained from http://www.squashfs.org. Usage instructions can be
56obtained from this site also. 56obtained from this site also.
57 57
58The squashfs-tools development tree is now located on kernel.org
59 git://git.kernel.org/pub/scm/fs/squashfs/squashfs-tools.git
58 60
593. SQUASHFS FILESYSTEM DESIGN 613. SQUASHFS FILESYSTEM DESIGN
60----------------------------- 62-----------------------------
diff --git a/Documentation/filesystems/vfs.txt b/Documentation/filesystems/vfs.txt
index eff6617c9a0f..52d8fb81cfff 100644
--- a/Documentation/filesystems/vfs.txt
+++ b/Documentation/filesystems/vfs.txt
@@ -356,7 +356,7 @@ struct inode_operations {
356 void (*put_link) (struct dentry *, struct nameidata *, void *); 356 void (*put_link) (struct dentry *, struct nameidata *, void *);
357 void (*truncate) (struct inode *); 357 void (*truncate) (struct inode *);
358 int (*permission) (struct inode *, int); 358 int (*permission) (struct inode *, int);
359 int (*check_acl)(struct inode *, int); 359 int (*get_acl)(struct inode *, int);
360 int (*setattr) (struct dentry *, struct iattr *); 360 int (*setattr) (struct dentry *, struct iattr *);
361 int (*getattr) (struct vfsmount *mnt, struct dentry *, struct kstat *); 361 int (*getattr) (struct vfsmount *mnt, struct dentry *, struct kstat *);
362 int (*setxattr) (struct dentry *, const char *,const void *,size_t,int); 362 int (*setxattr) (struct dentry *, const char *,const void *,size_t,int);
diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87
index 38425f0f2645..6f496a586732 100644
--- a/Documentation/hwmon/it87
+++ b/Documentation/hwmon/it87
@@ -76,7 +76,8 @@ IT8718F, IT8720F, IT8721F, IT8726F, IT8758E and SiS950 chips.
76These chips are 'Super I/O chips', supporting floppy disks, infrared ports, 76These chips are 'Super I/O chips', supporting floppy disks, infrared ports,
77joysticks and other miscellaneous stuff. For hardware monitoring, they 77joysticks and other miscellaneous stuff. For hardware monitoring, they
78include an 'environment controller' with 3 temperature sensors, 3 fan 78include an 'environment controller' with 3 temperature sensors, 3 fan
79rotation speed sensors, 8 voltage sensors, and associated alarms. 79rotation speed sensors, 8 voltage sensors, associated alarms, and chassis
80intrusion detection.
80 81
81The IT8712F and IT8716F additionally feature VID inputs, used to report 82The IT8712F and IT8716F additionally feature VID inputs, used to report
82the Vcore voltage of the processor. The early IT8712F have 5 VID pins, 83the Vcore voltage of the processor. The early IT8712F have 5 VID pins,
diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78
index 60932e26abaa..2bdc881a0c12 100644
--- a/Documentation/hwmon/lm78
+++ b/Documentation/hwmon/lm78
@@ -13,7 +13,8 @@ Supported chips:
13 Datasheet: Publicly available at the National Semiconductor website 13 Datasheet: Publicly available at the National Semiconductor website
14 http://www.national.com/ 14 http://www.national.com/
15 15
16Author: Frodo Looijaard <frodol@dds.nl> 16Authors: Frodo Looijaard <frodol@dds.nl>
17 Jean Delvare <khali@linux-fr.org>
17 18
18Description 19Description
19----------- 20-----------
diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636
new file mode 100644
index 000000000000..f83bd1c260f0
--- /dev/null
+++ b/Documentation/hwmon/sch5636
@@ -0,0 +1,31 @@
1Kernel driver sch5636
2=====================
3
4Supported chips:
5 * SMSC SCH5636
6 Prefix: 'sch5636'
7 Addresses scanned: none, address read from Super I/O config space
8
9Author: Hans de Goede <hdegoede@redhat.com>
10
11
12Description
13-----------
14
15SMSC SCH5636 Super I/O chips include an embedded microcontroller for
16hardware monitoring solutions, allowing motherboard manufacturers to create
17their own custom hwmon solution based upon the SCH5636.
18
19Currently the sch5636 driver only supports the Fujitsu Theseus SCH5636 based
20hwmon solution. The sch5636 driver runs a sanity check on loading to ensure
21it is dealing with a Fujitsu Theseus and not with another custom SCH5636 based
22hwmon solution.
23
24The Fujitsu Theseus can monitor up to 5 voltages, 8 fans and 16
25temperatures. Note that the driver detects how many fan headers /
26temperature sensors are actually implemented on the motherboard, so you will
27likely see fewer temperature and fan inputs.
28
29An application note describing the Theseus' registers, as well as an
30application note describing the protocol for communicating with the
31microcontroller is available upon request. Please mail me if you want a copy.
diff --git a/Documentation/i2o/ioctl b/Documentation/i2o/ioctl
index 1e77fac4e120..22ca53a67e23 100644
--- a/Documentation/i2o/ioctl
+++ b/Documentation/i2o/ioctl
@@ -110,7 +110,7 @@ V. Getting Logical Configuration Table
110 ENOBUFS Buffer not large enough. If this occurs, the required 110 ENOBUFS Buffer not large enough. If this occurs, the required
111 buffer length is written into *(lct->reslen) 111 buffer length is written into *(lct->reslen)
112 112
113VI. Settting Parameters 113VI. Setting Parameters
114 114
115 SYNOPSIS 115 SYNOPSIS
116 116
diff --git a/Documentation/ioctl/ioctl-number.txt b/Documentation/ioctl/ioctl-number.txt
index 3a46e360496d..72ba8d51dbc1 100644
--- a/Documentation/ioctl/ioctl-number.txt
+++ b/Documentation/ioctl/ioctl-number.txt
@@ -301,6 +301,7 @@ Code Seq#(hex) Include File Comments
301 <mailto:rusty@rustcorp.com.au> 301 <mailto:rusty@rustcorp.com.au>
3020xAE all linux/kvm.h Kernel-based Virtual Machine 3020xAE all linux/kvm.h Kernel-based Virtual Machine
303 <mailto:kvm@vger.kernel.org> 303 <mailto:kvm@vger.kernel.org>
3040xAF 00-1F linux/fsl_hypervisor.h Freescale hypervisor
3040xB0 all RATIO devices in development: 3050xB0 all RATIO devices in development:
305 <mailto:vgo@ratio.de> 306 <mailto:vgo@ratio.de>
3060xB1 00-1F PPPoX <mailto:mostrows@styx.uwaterloo.ca> 3070xB1 00-1F PPPoX <mailto:mostrows@styx.uwaterloo.ca>
diff --git a/Documentation/isdn/README.HiSax b/Documentation/isdn/README.HiSax
index 99e87a61897d..b1a573cf4472 100644
--- a/Documentation/isdn/README.HiSax
+++ b/Documentation/isdn/README.HiSax
@@ -506,7 +506,7 @@ to e.g. the Internet:
506 <ISDN subsystem - ISDN support -- HiSax> 506 <ISDN subsystem - ISDN support -- HiSax>
507 make clean; make zImage; make modules; make modules_install 507 make clean; make zImage; make modules; make modules_install
5082. Install the new kernel 5082. Install the new kernel
509 cp /usr/src/linux/arch/i386/boot/zImage /etc/kernel/linux.isdn 509 cp /usr/src/linux/arch/x86/boot/zImage /etc/kernel/linux.isdn
510 vi /etc/lilo.conf 510 vi /etc/lilo.conf
511 <add new kernel in the bootable image section> 511 <add new kernel in the bootable image section>
512 lilo 512 lilo
diff --git a/Documentation/ja_JP/SubmittingPatches b/Documentation/ja_JP/SubmittingPatches
index f107c834d242..97f78dd0c085 100644
--- a/Documentation/ja_JP/SubmittingPatches
+++ b/Documentation/ja_JP/SubmittingPatches
@@ -11,16 +11,18 @@ for non English (read: Japanese) speakers and is not intended as a
11fork. So if you have any comments or updates of this file, please try 11fork. So if you have any comments or updates of this file, please try
12to update the original English file first. 12to update the original English file first.
13 13
14Last Updated: 2007/10/24 14Last Updated: 2011/06/09
15
15================================== 16==================================
16これは、 17これは、
17linux-2.6.23/Documentation/SubmittingPatches の和訳 18linux-2.6.39/Documentation/SubmittingPatches の和訳
18です。 19です。
19翻訳団体: JF プロジェクト < http://www.linux.or.jp/JF/ > 20翻訳団体: JF プロジェクト < http://www.linux.or.jp/JF/ >
20翻訳日: 2007/10/17 21翻訳日: 2011/06/09
21翻訳者: Keiichi Kii <k-keiichi at bx dot jp dot nec dot com> 22翻訳者: Keiichi Kii <k-keiichi at bx dot jp dot nec dot com>
22校正者: Masanari Kobayashi さん <zap03216 at nifty dot ne dot jp> 23校正者: Masanari Kobayashi さん <zap03216 at nifty dot ne dot jp>
23 Matsukura さん <nbh--mats at nifty dot com> 24 Matsukura さん <nbh--mats at nifty dot com>
25 Takeshi Hamasaki さん <hmatrjp at users dot sourceforge dot jp>
24================================== 26==================================
25 27
26 Linux カーネルに変更を加えるための Howto 28 Linux カーネルに変更を加えるための Howto
@@ -97,7 +99,7 @@ Quilt:
97http://savannah.nongnu.org/projects/quilt 99http://savannah.nongnu.org/projects/quilt
98 100
99Andrew Morton's patch scripts: 101Andrew Morton's patch scripts:
100http://userweb.kernel.org/~akpm/stuff/tpp.txt 102http://userweb.kernel.org/~akpm/stuff/patch-scripts.tar.gz
101このリンクの先のスクリプトの代わりとして、quilt がパッチマネジメント 103このリンクの先のスクリプトの代わりとして、quilt がパッチマネジメント
102ツールとして推奨されています(上のリンクを見てください)。 104ツールとして推奨されています(上のリンクを見てください)。
103 105
@@ -109,9 +111,25 @@ http://userweb.kernel.org/~akpm/stuff/tpp.txt
109「ドライバー X に対するバグフィックス」あるいは「このパッチはサブシス 111「ドライバー X に対するバグフィックス」あるいは「このパッチはサブシス
110テム X に対する更新を含んでいます。どうか取り入れてください。」などです。 112テム X に対する更新を含んでいます。どうか取り入れてください。」などです。
111 113
114パッチの説明を Linux カーネルのソースコードマネジメントシステム「 git 」の
115コミットログとして簡単に引用できる形で書けば、メンテナから感謝されるでしょう。
116以下の #15 を見てください。
117
112説明が長くなりだしたのであれば、おそらくそれはパッチを分ける必要がある 118説明が長くなりだしたのであれば、おそらくそれはパッチを分ける必要がある
113という兆候です。次の #3 を見てください。 119という兆候です。次の #3 を見てください。
114 120
121パッチ(シリーズ)を(再)投稿する時、十分なパッチの説明とそのパッチが必要な理由を
122パッチに含めてください。ただ「これはパッチ(シリーズ)のバージョン N」とだけ
123書かないでください。そして、パッチをマージする人にパッチの説明を探させそれを
124パッチに追記させるため、過去のバージョンのパッチやそのパッチの URL を参照する
125手間をかけさせないでください。
126つまり、パッチシリーズとその説明は一緒にあるべきです。これはパッチをマージする
127人、レビューする人、どちらのためにもなります。レビューする人の中には、おそらく
128過去のバージョンのパッチを受け取ってもいない人がいます。
129
130登録済みのバグエントリを修正するパッチであれば、そのバグエントリを示すバグ ID
131や URL を明記してください。
132
1153) パッチの分割 1333) パッチの分割
116 134
117意味のあるひとまとまりごとに変更を個々のパッチファイルに分けてください。 135意味のあるひとまとまりごとに変更を個々のパッチファイルに分けてください。
@@ -141,7 +159,7 @@ http://userweb.kernel.org/~akpm/stuff/tpp.txt
141拒否されるでしょう。 159拒否されるでしょう。
142 160
143あなたはパッチを投稿する前に最低限パッチスタイルチェッカー 161あなたはパッチを投稿する前に最低限パッチスタイルチェッカー
144( scripts/patchcheck.pl )を利用してパッチをチェックすべきです。 162( scripts/checkpatch.pl )を利用してパッチをチェックすべきです。
145もしパッチに違反がのこっているならば、それらの全てについてあなたは正当な 163もしパッチに違反がのこっているならば、それらの全てについてあなたは正当な
146理由を示せるようにしておく必要があります。 164理由を示せるようにしておく必要があります。
147 165
@@ -192,13 +210,13 @@ VGER.KERNEL.ORG でホスティングされているメーリングリストの
192情報がマニュアルページの中に入ってくるように、変更が起きたという 210情報がマニュアルページの中に入ってくるように、変更が起きたという
193通知を送ってください。 211通知を送ってください。
194 212
195たとえ、メンテナが #4 で反応がなかったとしても、メンテナのコードに変更を 213たとえ、メンテナが #5 で反応がなかったとしても、メンテナのコードに変更を
196加えたときには、いつもメンテナに CC するのを忘れないようにしてください。 214加えたときには、いつもメンテナに CC するのを忘れないようにしてください。
197 215
198小さなパッチであれば、Adrian Bunk している Trivial Patch Monkey 216小さなパッチであれば、Trivial Patch Monkey(パッチを集めいる)
199(ちょっとしたパッチを集めている)<trivial@kernel.org>に CC してもいい 217<trivial@kernel.org>に CC してもいいです。その現管理者については MAINTAINERS
200。ちょっとしたパッチとは以下のルールのどれか1つを満たしていなけ 218ァイルを見さいちょっとしたパッチとは以下のルールのどれか1つを満たして
201ればなりません。 219なけばなりません。
202 ・ドキュメントのスペルミスの修正 220 ・ドキュメントのスペルミスの修正
203 ・grep(1) コマンドによる検索を困難にしているスペルの修正 221 ・grep(1) コマンドによる検索を困難にしているスペルの修正
204 ・コンパイル時の警告の修正(無駄な警告が散乱することは好ましくないた 222 ・コンパイル時の警告の修正(無駄な警告が散乱することは好ましくないた
@@ -210,7 +228,6 @@ VGER.KERNEL.ORG でホスティングされているメーリングリストの
210 ・移植性のないコードから移植性のあるコードへの置き換え(小さい範囲で 228 ・移植性のないコードから移植性のあるコードへの置き換え(小さい範囲で
211 あればアーキテクチャ特有のことでも他の人がコピーできます) 229 あればアーキテクチャ特有のことでも他の人がコピーできます)
212 ・作者やメンテナによる修正(すなわち patch monkey の再転送モード) 230 ・作者やメンテナによる修正(すなわち patch monkey の再転送モード)
213EMAIL: <trivial@kernel.org>
214 231
2157) MIME やリンクや圧縮ファイルや添付ファイルではなくプレインテキストのみ 2327) MIME やリンクや圧縮ファイルや添付ファイルではなくプレインテキストのみ
216 233
@@ -233,26 +250,15 @@ MIME 形式の添付ファイルは Linus に手間を取らせることにな
233例外:お使いの電子メールクライアントがパッチをめちゃくちゃにするので 250例外:お使いの電子メールクライアントがパッチをめちゃくちゃにするので
234あれば、誰かが MIME 形式のパッチを再送するよう求めるかもしれません。 251あれば、誰かが MIME 形式のパッチを再送するよう求めるかもしれません。
235 252
236警告: Mozilla のような特定の電子メールクライアントは電子メールの 253余計な変更を加えずにあなたのパッチを送信するための電子メールクライアントの設定
237ヘッダに以下のものを付加して送ります。 254のヒントについては Documentation/email-clients.txt を参照してください。
238---- message header ----
239Content-Type: text/plain; charset=us-ascii; format=flowed
240---- message header ----
241問題は、「 format=flowed 」が付いた電子メールを特定の受信側の電子メール
242クライアントがタブをスペースに置き換えるというような変更をすることです。
243したがって送られてきたパッチは壊れているように見えるでしょう。
244
245これを修正するには、mozilla の defaults/pref/mailnews.js ファイルを
246以下のように修正します。
247pref("mailnews.send_plaintext_flowed", false); // RFC 2646=======
248pref("mailnews.display.disable_format_flowed_support", true);
249 255
2508) 電子メールのサイズ 2568) 電子メールのサイズ
251 257
252パッチを Linus へ送るときは常に #7 の手順に従ってください。 258パッチを Linus へ送るときは常に #7 の手順に従ってください。
253 259
254大きなパッチはメーリングリストやメンテナにとって不親切です。パッチが 260大きなパッチはメーリングリストやメンテナにとって不親切です。パッチが
255未圧縮で 40KB を超えるようであるなら、インターネット上のアクセス可能な 261未圧縮で 300KB を超えるようであるなら、インターネット上のアクセス可能な
256サーバに保存し、保存場所を示す URL を伝えるほうが適切です。 262サーバに保存し、保存場所を示す URL を伝えるほうが適切です。
257 263
2589) カーネルバージョンの明記 2649) カーネルバージョンの明記
@@ -324,7 +330,7 @@ Linus や LKML への大量の電子メールのために、サブジェクト
324 (c) 本寄与は(a)、(b)、(c)を証明する第3者から私へ直接提供された 330 (c) 本寄与は(a)、(b)、(c)を証明する第3者から私へ直接提供された
325 ものであり、私はそれに変更を加えていない。 331 ものであり、私はそれに変更を加えていない。
326 332
327 (d) 私はこのプロジェクトと本寄与が公のものであることに理解及び同意す 333 (d) 私はこのプロジェクトと本寄与が公のものであることに理解及び同意す
328 る。同時に、関与した記録(投稿の際の全ての個人情報と sign-off を 334 る。同時に、関与した記録(投稿の際の全ての個人情報と sign-off を
329 含む)が無期限に保全されることと、当該プロジェクト又は関連する 335 含む)が無期限に保全されることと、当該プロジェクト又は関連する
330 オープンソースライセンスに沿った形で再配布されることに理解及び 336 オープンソースライセンスに沿った形で再配布されることに理解及び
@@ -340,7 +346,51 @@ Linus や LKML への大量の電子メールのために、サブジェクト
340無視されますが、あなたはそのタグを社内の手続きに利用したり、sign-off に特別 346無視されますが、あなたはそのタグを社内の手続きに利用したり、sign-off に特別
341な情報を示したりすることができます。 347な情報を示したりすることができます。
342 348
34313) いつ Acked-by: を使うのか 349あなたがサブシステムまたはブランチのメンテナであれば、受け取ったパッチを自身の
350ツリーにマージするために、わずかに変更が必要となる場合があります。なぜなら
351あなたのツリーの中のコードと投稿者のツリーの中のコードは同一ではないためです。
352もし、あなたが厳密に上記ルール(c)にこだわるのであれば、投稿者に再度差分を
353とるよう依頼すべきです。しかし、これは時間とエネルギーを非生産的に浪費する
354ことになります。ルール(b)はあなたにコードを修正する権利を与えてくれます。
355しかし、投稿者のコードを修正し、その修正によるバグを投稿者に押し付けてしまう
356ことはとても失礼なことです。この問題を解決するために、末尾の投稿者の
357Signed-off-by とあなたがその末尾に追加する Signed-off-by の間に、修正を
358加えたことを示す1行を追加することが推奨されています。
359(その1行の書き方に)決まりはありませんが、大括弧の中に電子メールアドレスや氏名
360と修正内容を記載するやり方は目につきやすく、最終段階での変更の責任があなたに
361あることを明確にするのに十分な方法のようです。例えば、
362
363 Signed-off-by: Random J Developer <random@developer.example.org>
364 [lucky@maintainer.example.org: struct foo moved from foo.c to foo.h]
365 Signed-off-by: Lucky K Maintainer <lucky@maintainer.example.org>
366
367あなたが安定版のブランチを管理しており、作成者のクレジット、変更の追跡、
368修正のマージ、と同時に苦情からの投稿者の保護を行いたい場合、この慣習は特に
369有用となります。いかなる事情があってもチェンジログに出てくる作成者の
370アイデンティティ情報(From ヘッダ)は変更できないことに注意してください。
371
372バックポートする人のための特別な注意事項。追跡を容易に行うために、コミット
373メッセージのトップ(サブジェクト行のすぐ後)にパッチの起源を示す情報を記述する
374ことは一般的で有用な慣習です。例えば、これは 2.6-stable ツリーでの一例です。
375
376 Date: Tue May 13 19:10:30 2008 +0000
377
378 SCSI: libiscsi regression in 2.6.25: fix nop timer handling
379
380 commit 4cf1043593db6a337f10e006c23c69e5fc93e722 upstream
381
382そして、これは 2.4 ツリーでの一例です。
383
384 Date: Tue May 13 22:12:27 2008 +0200
385
386 wireless, airo: waitbusy() won't delay
387
388 [backport of 2.6 commit b7acbdfbd1f277c1eb23f344f899cfa4cd0bf36a]
389
390どんな形式であれ、この情報はあなたのツリーを追跡する人やあなたのツリーのバグを
391解決しようとしている人にとって価値のある支援となります。
392
39313) いつ Acked-by: と Cc: を使うのか
344 394
345「 Signed-off-by: 」タグはその署名者がパッチの開発に関わっていたことやパッチ 395「 Signed-off-by: 」タグはその署名者がパッチの開発に関わっていたことやパッチ
346の伝播パスにいたことを示しています。 396の伝播パスにいたことを示しています。
@@ -354,7 +404,7 @@ Linus や LKML への大量の電子メールのために、サブジェクト
354 404
355Acked-by: は Signed-off-by: のように公式なタグではありません。それはメンテナが 405Acked-by: は Signed-off-by: のように公式なタグではありません。それはメンテナが
356少なくともパッチをレビューし、同意を示しているという記録です。そのような 406少なくともパッチをレビューし、同意を示しているという記録です。そのような
357ことからパッチ統合者がメンテナの「うん、良いと思うよ」という発言を 407ことからパッチマージメンテナの「うん、良いと思うよ」という発言を
358Acked-by: へ置き換えることがあります。 408Acked-by: へ置き換えることがあります。
359 409
360Acked-by: が必ずしもパッチ全体の承認を示しているわけではありません。例えば、 410Acked-by: が必ずしもパッチ全体の承認を示しているわけではありません。例えば、
@@ -364,7 +414,62 @@ Acked-by: が必ずしもパッチ全体の承認を示しているわけでは
364この点は、ご自分で判断してください。(その Acked-by: が)疑わしい場合は、 414この点は、ご自分で判断してください。(その Acked-by: が)疑わしい場合は、
365メーリングリストアーカイブの中の大元の議論を参照すべきです。 415メーリングリストアーカイブの中の大元の議論を参照すべきです。
366 416
36714) 標準的なパッチのフォーマット 417パッチにコメントする機会を持っていたが、その時にコメントしなかった人がいれば、
418その人を指す「Cc:」タグを任意で追加してもかまいません。これは指定された人からの
419明確なアクションなしに付与できる唯一のタグです。
420このタグはパッチに関心があると思われる人達がそのパッチの議論に含まれていたこと
421を明文化します。
422
42314) Reported-by と Tested-by: と Reviewed-by: の利用
424
425他の誰かによって報告された問題を修正するパッチであれば、問題報告者という寄与を
426クレジットするために、Reported-by: タグを追加することを検討してください。
427こまめにバグ報告者をクレジットしていくことで、うまくいけばその人たちが将来再び
428コミュニティの力となってくれるでしょう。
429ただし、報告者の許可無くこのタグを追加しないように注意してください。特に、
430問題が公の場で報告されていなかったのであれば。
431
432Tested-by: タグはタグで指定された人によって(ある環境下で)パッチのテストに成功
433していることを示します。このタグはメンテナにテストが実施済みであることを
434知らせ、将来の関連パッチのテスト協力者を見つける方法を提供し、テスト実施者に
435対するクレジットを保証します。
436
437Reviewed-by: タグは、それとは異なり、下記のレビューア宣言の下にレビューされ、
438受け入れ可能とみなされたパッチであることを示します。
439
440 レビューアによる監督宣言
441
442 私は Reviewed-by: タグを提示することによって、以下のことを明言する。
443
444 (a) 私はメインラインカーネルへの統合に向け、その妥当性及び「即応性
445 (訳注)」を検証し、技術的側面からパッチをレビュー済みである。
446
447 訳注:
448 「即応性」の原文は "readiness"。
449 パッチが十分な品質を持っており、メインラインカーネルへの統合を即座に
450 行うことができる状態であるかどうかを "readiness" という単語で表現
451 している。
452
453 (b) パッチに関するあらゆる問題、懸念、あるいは、疑問は投稿者へ伝達済み
454 である。私はそれらのコメントに対する投稿者の返答に満足している。
455
456 (c) 投稿に伴い改良されるコードがある一方で、現時点で、私は(1)それが
457 カーネルにとって価値のある変更であること、そして、(2)統合に際して
458 議論になり得るような問題はないものと確信している。
459
460 (d) 私はパッチをレビューし適切であると確信している一方で、あらゆる
461 状況においてその宣言した目的や機能が正しく実現することに関して、
462 いかなる保証もしない(特にどこかで明示しない限り)。
463
464Reviewd-by タグはそのパッチがカーネルに対して適切な修正であって、深刻な技術的
465問題を残していないという意見の宣言です。興味のあるレビューアは誰でも(レビュー
466作業を終えたら)パッチに対して Reviewed-by タグを提示できます。このタグは
467レビューアの寄与をクレジットする働き、レビューの進捗の度合いをメンテナに
468知らせる働きを持ちます。そのパッチの領域に詳しく、そして、しっかりとした
469レビューを実施したレビューアによって提供される時、Reviewed-by: タグがあなたの
470パッチをカーネルにマージする可能性を高めるでしょう。
471
47215) 標準的なパッチのフォーマット
368 473
369標準的なパッチのサブジェクトは以下のとおりです。 474標準的なパッチのサブジェクトは以下のとおりです。
370 475
@@ -396,18 +501,37 @@ Acked-by: が必ずしもパッチ全体の承認を示しているわけでは
396電子メールのサブジェクト内のサブシステム表記は、パッチが適用される 501電子メールのサブジェクト内のサブシステム表記は、パッチが適用される
397分野またはサブシステムを識別できるようにすべきです。 502分野またはサブシステムを識別できるようにすべきです。
398 503
399電子メールのサブジェクトの「概要い回しはそのパッチの概要を正確 504電子メールのサブジェクトの「summary phrase」はそのパッチの概要を正確
400に表現しなければなりません。「概要い回しをファイル名にしてはい 505に表現しなければなりません。「summary phrase」をファイル名にしてはい
401けません。一連ッチ中でそれぞれのパッチは同じ「概要い回し 506けません。パッチシリーズ中でそれぞれのパッチは同じ「summary phrase」を
402使ってはいけません(「一連ッチ」とは順序付けられた関連のある複数の 507使ってはいけません(「パッチリーズとは順序付けられた関連のある複数の
403パッチ群です)。 508パッチ群です)。
404 509
405あなたの電子メールの「概要の言い回し」がそのパッチにとって世界で唯 510あなたの電子メールの「summary phrase」がそのパッチにとって世界で唯一の識別子に
406一の識別子になるように心がけてください。「概要の言い回し」は git の 511なるように心がけてください。「summary phrase」は git のチェンジログの中へ
407チェンジログの中へずっと伝播していきます。「概要の言い回し」は、開 512ずっと伝播していきます。「summary phrase」は、開発者が後でパッチを参照する
408発者が後でパッチを参照するために議論の中で利用するかもしれません。 513ために議論の中で利用するかもしれません。
409人々はそのパッチに関連した議論を読むために「概要の言い回し」を使って 514人々はそのパッチに関連した議論を読むために「summary phrase」を使って google で
410google で検索したがるでしょう。 515検索したがるでしょう。それはまた2、3ヶ月あとで、人々が「gitk」や
516「git log --oneline」のようなツールを使用して何千ものパッチに目を通す時、
517唯一目にとまる情報となるでしょう。
518
519これらの理由のため、「summary phrase」はなぜパッチが必要であるか、パッチが何を
520変更するかの2つの情報をせいぜい70〜75文字で表現していなければなりません。
521「summary phrase」は簡潔であり説明的である表現を目指しつつ、うまく
522まとめられている概要となるべきです。
523
524「summary phrase」は「Subject: [PATCH tag] <summary phrase>」のように、
525大括弧で閉じられたタグを接頭辞として付加してもかまいません。このタグは
526「summary phrase」の一部とは考えませんが、パッチをどのように取り扱うべきかを
527表現します。
528一般的には「v1, v2, v3」のようなバージョン情報を表すタグ(過去のパッチに対する
529コメントを反映するために複数のバージョンのパッチが投稿されているのであれば)、
530「RFC」のようなコメントを要求するタグが挙げられます。パッチシリーズとして4つの
531パッチがあれば、個々のパッチに「1/4, 2/4, 3/4, 4/4」のように番号を付けても
532かまいません。これは開発者がパッチを適用する順番を確実に把握するためです。
533そして、開発者がパッチシリーズの中のすべてのパッチをもらさずレビュー或いは
534適用するのを保証するためです。
411 535
412サブジェクトの例を二つ 536サブジェクトの例を二つ
413 537
@@ -426,7 +550,12 @@ google で検索したがるでしょう。
426 550
427説明本体は無期限のソースのチェンジログにコミットされます。なので、説明 551説明本体は無期限のソースのチェンジログにコミットされます。なので、説明
428本体はそのパッチに至った議論の詳細を忘れているある程度の技量を持っている人 552本体はそのパッチに至った議論の詳細を忘れているある程度の技量を持っている人
429がその詳細を思い出すことができるものでなければなりません。 553がその詳細を思い出すことができるものでなければなりません。パッチが対処する
554障害の症状(カーネルログメッセージや oops メッセージ等)を記載することは問題に
555対処可能なパッチを求めてコミットログを検索する人々にとって特に有用です。
556パッチがコンパイル問題を解決するのであれば、そのパッチを探している人が見つける
557ことができる情報だけで十分であり、コンパイル時の全てのエラーを含める必要は
558ありません。「summary phrase」と同様に、簡潔であり説明的であることが重要です。
430 559
431「 --- 」マーカー行はパッチ処理ツールに対して、チェンジログメッセージの終端 560「 --- 」マーカー行はパッチ処理ツールに対して、チェンジログメッセージの終端
432部分を認識させるという重要な役目を果たします。 561部分を認識させるという重要な役目を果たします。
@@ -436,14 +565,46 @@ google で検索したがるでしょう。
436追加され何行消されたかを示すものです。diffstat コマンドは特に大きなパッチに 565追加され何行消されたかを示すものです。diffstat コマンドは特に大きなパッチに
437おいて役立ちます。その時点でだけ又はメンテナにとってのみ関係のあるコメント 566おいて役立ちます。その時点でだけ又はメンテナにとってのみ関係のあるコメント
438は無期限に保存されるチェンジログにとって適切ではありません。そのため、この 567は無期限に保存されるチェンジログにとって適切ではありません。そのため、この
439ようなコメントもマーカー行の後に書かれるべきです。ファイル名はカーネルソー 568ようなコメントもマーカー行の後に書かれるべきです。
440スツリーのトップディレクトリからの表記でリストされるため、横方向のスペース 569このようなコメントの良い例として、v1 と v2 のバージョン間で何が変更されたかを
441をとり過ぎないように、diffstat コマンドにオプション「 -p 1 -w 70 」を指定し 570表す「パッチの変更履歴」が挙げられます。
442てください(インデントを含めてちょうど80列に合うでしょう)。 571
572「 --- 」マーカー行の後に diffstat コマンドの結果を含めるのであれば、ファイル
573名はカーネルソースツリーのトップディレクトリからの表記で列記されるため、横方向
574のスペースをとり過ぎないように、diffstat コマンドにオプション「 -p 1 -w 70 」
575を指定してください(インデントを含めてちょうど80列に合うでしょう)。
443 576
444適切なパッチのフォーマットの詳細についてはセクション3の参考文献を参照して 577適切なパッチのフォーマットの詳細についてはセクション3の参考文献を参照して
445ください。 578ください。
446 579
58016) 「git pull」要求の送り方(Linus の電子メールから)
581
582間違ったブランチから引っ張るのを防ぐために、git リポジトリのアドレスと
583ブランチ名を同じ行に1行で記載してください。そうすることで、3回の連続クリック
584で全て選択できます。
585
586正しい形式は下記の通りです。
587
588 "Please pull from
589
590 git://jdelvare.pck.nerim.net/jdelvare-2.6 i2c-for-linus
591
592 to get these changes:"
593
594その結果、アドレスを自分自身でタイピングして間違えることはなくなります(実際に、
595何度か間違ったブランチから引っ張ってきてしまい、その時に diffstat の結果を
596検証して間違っていることに気づいたことがあります。どこから何を引っ張るべきかを
597「探したり」、正しいブランチ名かどうかを重ねてチェックしたりする必要が
598なくなればより快適になるでしょう)。
599
600diffstat の結果を生成するために「 git diff -M --stat --summary 」を使って
601ください。-M オプションはファイル名の変更を検知でき、--summary オプションは
602新規ファイル、削除されたファイル、名前が変更されたファイルの概要を生成します。
603
604-M オプション(ファイル名の変更検知)を指定すると、diffstat の結果はかなり
605異なってきます。git は大規模な変更(追加と削除のペア)をファイル名の変更と
606判断するためです。
607
447------------------------------------ 608------------------------------------
448セクション2 - ヒントとTIPSと小技 609セクション2 - ヒントとTIPSと小技
449------------------------------------ 610------------------------------------
@@ -459,7 +620,7 @@ google で検索したがるでしょう。
459も逸脱していると、レビューやコメントなしに受け取ってもらえないかもし 620も逸脱していると、レビューやコメントなしに受け取ってもらえないかもし
460れません。 621れません。
461 622
462唯一の特筆すべき例外は、コードをあるファイルから別のファイルに移動 623特筆すべき例外は、コードをあるファイルから別のファイルに移動
463するときです。この場合、コードを移動するパッチでは、移動されるコード 624するときです。この場合、コードを移動するパッチでは、移動されるコード
464に関して移動以外の変更を一切加えるべきではありません。これにより、 625に関して移動以外の変更を一切加えるべきではありません。これにより、
465コードの移動とあなたが行ったコードの修正を明確に区別できるようにな 626コードの移動とあなたが行ったコードの修正を明確に区別できるようにな
@@ -553,4 +714,11 @@ Kernel Documentation/CodingStyle:
553 714
554Linus Torvalds's mail on the canonical patch format: 715Linus Torvalds's mail on the canonical patch format:
555 <http://lkml.org/lkml/2005/4/7/183> 716 <http://lkml.org/lkml/2005/4/7/183>
717
718Andi Kleen, "On submitting kernel patches"
719 Some strategies to get difficult or controversial changes in.
720 http://halobates.de/on-submitting-patches.pdf
721
556-- 722--
723
724
diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
index 47435e56c5da..f47cdefb4d1e 100644
--- a/Documentation/kbuild/makefiles.txt
+++ b/Documentation/kbuild/makefiles.txt
@@ -441,7 +441,7 @@ more details, with real examples.
441 specified if first option are not supported. 441 specified if first option are not supported.
442 442
443 Example: 443 Example:
444 #arch/i386/kernel/Makefile 444 #arch/x86/kernel/Makefile
445 vsyscall-flags += $(call cc-ldoption, -Wl$(comma)--hash-style=sysv) 445 vsyscall-flags += $(call cc-ldoption, -Wl$(comma)--hash-style=sysv)
446 446
447 In the above example, vsyscall-flags will be assigned the option 447 In the above example, vsyscall-flags will be assigned the option
@@ -460,7 +460,7 @@ more details, with real examples.
460 supported to use an optional second option. 460 supported to use an optional second option.
461 461
462 Example: 462 Example:
463 #arch/i386/Makefile 463 #arch/x86/Makefile
464 cflags-y += $(call cc-option,-march=pentium-mmx,-march=i586) 464 cflags-y += $(call cc-option,-march=pentium-mmx,-march=i586)
465 465
466 In the above example, cflags-y will be assigned the option 466 In the above example, cflags-y will be assigned the option
@@ -522,7 +522,7 @@ more details, with real examples.
522 even though the option was accepted by gcc. 522 even though the option was accepted by gcc.
523 523
524 Example: 524 Example:
525 #arch/i386/Makefile 525 #arch/x86/Makefile
526 cflags-y += $(shell \ 526 cflags-y += $(shell \
527 if [ $(call cc-version) -ge 0300 ] ; then \ 527 if [ $(call cc-version) -ge 0300 ] ; then \
528 echo "-mregparm=3"; fi ;) 528 echo "-mregparm=3"; fi ;)
@@ -802,7 +802,7 @@ but in the architecture makefiles where the kbuild infrastructure
802is not sufficient this sometimes needs to be explicit. 802is not sufficient this sometimes needs to be explicit.
803 803
804 Example: 804 Example:
805 #arch/i386/boot/Makefile 805 #arch/x86/boot/Makefile
806 subdir- := compressed/ 806 subdir- := compressed/
807 807
808The above assignment instructs kbuild to descend down in the 808The above assignment instructs kbuild to descend down in the
@@ -812,12 +812,12 @@ To support the clean infrastructure in the Makefiles that builds the
812final bootimage there is an optional target named archclean: 812final bootimage there is an optional target named archclean:
813 813
814 Example: 814 Example:
815 #arch/i386/Makefile 815 #arch/x86/Makefile
816 archclean: 816 archclean:
817 $(Q)$(MAKE) $(clean)=arch/i386/boot 817 $(Q)$(MAKE) $(clean)=arch/x86/boot
818 818
819When "make clean" is executed, make will descend down in arch/i386/boot, 819When "make clean" is executed, make will descend down in arch/x86/boot,
820and clean as usual. The Makefile located in arch/i386/boot/ may use 820and clean as usual. The Makefile located in arch/x86/boot/ may use
821the subdir- trick to descend further down. 821the subdir- trick to descend further down.
822 822
823Note 1: arch/$(ARCH)/Makefile cannot use "subdir-", because that file is 823Note 1: arch/$(ARCH)/Makefile cannot use "subdir-", because that file is
@@ -882,7 +882,7 @@ When kbuild executes, the following steps are followed (roughly):
882 LDFLAGS_vmlinux uses the LDFLAGS_$@ support. 882 LDFLAGS_vmlinux uses the LDFLAGS_$@ support.
883 883
884 Example: 884 Example:
885 #arch/i386/Makefile 885 #arch/x86/Makefile
886 LDFLAGS_vmlinux := -e stext 886 LDFLAGS_vmlinux := -e stext
887 887
888 OBJCOPYFLAGS objcopy flags 888 OBJCOPYFLAGS objcopy flags
@@ -920,14 +920,14 @@ When kbuild executes, the following steps are followed (roughly):
920 Often, the KBUILD_CFLAGS variable depends on the configuration. 920 Often, the KBUILD_CFLAGS variable depends on the configuration.
921 921
922 Example: 922 Example:
923 #arch/i386/Makefile 923 #arch/x86/Makefile
924 cflags-$(CONFIG_M386) += -march=i386 924 cflags-$(CONFIG_M386) += -march=i386
925 KBUILD_CFLAGS += $(cflags-y) 925 KBUILD_CFLAGS += $(cflags-y)
926 926
927 Many arch Makefiles dynamically run the target C compiler to 927 Many arch Makefiles dynamically run the target C compiler to
928 probe supported options: 928 probe supported options:
929 929
930 #arch/i386/Makefile 930 #arch/x86/Makefile
931 931
932 ... 932 ...
933 cflags-$(CONFIG_MPENTIUMII) += $(call cc-option,\ 933 cflags-$(CONFIG_MPENTIUMII) += $(call cc-option,\
@@ -1038,8 +1038,8 @@ When kbuild executes, the following steps are followed (roughly):
1038 into the arch/$(ARCH)/boot/Makefile. 1038 into the arch/$(ARCH)/boot/Makefile.
1039 1039
1040 Example: 1040 Example:
1041 #arch/i386/Makefile 1041 #arch/x86/Makefile
1042 boot := arch/i386/boot 1042 boot := arch/x86/boot
1043 bzImage: vmlinux 1043 bzImage: vmlinux
1044 $(Q)$(MAKE) $(build)=$(boot) $(boot)/$@ 1044 $(Q)$(MAKE) $(build)=$(boot) $(boot)/$@
1045 1045
@@ -1051,7 +1051,7 @@ When kbuild executes, the following steps are followed (roughly):
1051 To support this, $(archhelp) must be defined. 1051 To support this, $(archhelp) must be defined.
1052 1052
1053 Example: 1053 Example:
1054 #arch/i386/Makefile 1054 #arch/x86/Makefile
1055 define archhelp 1055 define archhelp
1056 echo '* bzImage - Image (arch/$(ARCH)/boot/bzImage)' 1056 echo '* bzImage - Image (arch/$(ARCH)/boot/bzImage)'
1057 endif 1057 endif
@@ -1065,7 +1065,7 @@ When kbuild executes, the following steps are followed (roughly):
1065 from vmlinux. 1065 from vmlinux.
1066 1066
1067 Example: 1067 Example:
1068 #arch/i386/Makefile 1068 #arch/x86/Makefile
1069 all: bzImage 1069 all: bzImage
1070 1070
1071 When "make" is executed without arguments, bzImage will be built. 1071 When "make" is executed without arguments, bzImage will be built.
@@ -1083,7 +1083,7 @@ When kbuild executes, the following steps are followed (roughly):
1083 2) kbuild knows what files to delete during "make clean" 1083 2) kbuild knows what files to delete during "make clean"
1084 1084
1085 Example: 1085 Example:
1086 #arch/i386/kernel/Makefile 1086 #arch/x86/kernel/Makefile
1087 extra-y := head.o init_task.o 1087 extra-y := head.o init_task.o
1088 1088
1089 In this example, extra-y is used to list object files that 1089 In this example, extra-y is used to list object files that
@@ -1133,7 +1133,7 @@ When kbuild executes, the following steps are followed (roughly):
1133 Compress target. Use maximum compression to compress target. 1133 Compress target. Use maximum compression to compress target.
1134 1134
1135 Example: 1135 Example:
1136 #arch/i386/boot/Makefile 1136 #arch/x86/boot/Makefile
1137 LDFLAGS_bootsect := -Ttext 0x0 -s --oformat binary 1137 LDFLAGS_bootsect := -Ttext 0x0 -s --oformat binary
1138 LDFLAGS_setup := -Ttext 0x0 -s --oformat binary -e begtext 1138 LDFLAGS_setup := -Ttext 0x0 -s --oformat binary -e begtext
1139 1139
@@ -1193,7 +1193,7 @@ When kbuild executes, the following steps are followed (roughly):
1193 1193
1194 When updating the $(obj)/bzImage target, the line 1194 When updating the $(obj)/bzImage target, the line
1195 1195
1196 BUILD arch/i386/boot/bzImage 1196 BUILD arch/x86/boot/bzImage
1197 1197
1198 will be displayed with "make KBUILD_VERBOSE=0". 1198 will be displayed with "make KBUILD_VERBOSE=0".
1199 1199
@@ -1207,7 +1207,7 @@ When kbuild executes, the following steps are followed (roughly):
1207 kbuild knows .lds files and includes a rule *lds.S -> *lds. 1207 kbuild knows .lds files and includes a rule *lds.S -> *lds.
1208 1208
1209 Example: 1209 Example:
1210 #arch/i386/kernel/Makefile 1210 #arch/x86/kernel/Makefile
1211 always := vmlinux.lds 1211 always := vmlinux.lds
1212 1212
1213 #Makefile 1213 #Makefile
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt
index 40cc653984ee..4ca93898fbd3 100644
--- a/Documentation/kernel-parameters.txt
+++ b/Documentation/kernel-parameters.txt
@@ -1846,7 +1846,9 @@ bytes respectively. Such letter suffixes can also be entirely omitted.
1846 See Documentation/sound/oss/oss-parameters.txt 1846 See Documentation/sound/oss/oss-parameters.txt
1847 1847
1848 panic= [KNL] Kernel behaviour on panic: delay <timeout> 1848 panic= [KNL] Kernel behaviour on panic: delay <timeout>
1849 seconds before rebooting 1849 timeout > 0: seconds before rebooting
1850 timeout = 0: wait forever
1851 timeout < 0: reboot immediately
1850 Format: <timeout> 1852 Format: <timeout>
1851 1853
1852 parkbd.port= [HW] Parallel port number the keyboard adapter is 1854 parkbd.port= [HW] Parallel port number the keyboard adapter is
@@ -2526,6 +2528,11 @@ bytes respectively. Such letter suffixes can also be entirely omitted.
2526 <port#>,<js1>,<js2>,<js3>,<js4>,<js5>,<js6>,<js7> 2528 <port#>,<js1>,<js2>,<js3>,<js4>,<js5>,<js6>,<js7>
2527 See also Documentation/input/joystick-parport.txt 2529 See also Documentation/input/joystick-parport.txt
2528 2530
2531 udbg-immortal [PPC] When debugging early kernel crashes that
2532 happen after console_init() and before a proper
2533 console driver takes over, this boot options might
2534 help "seeing" what's going on.
2535
2529 uhash_entries= [KNL,NET] 2536 uhash_entries= [KNL,NET]
2530 Set number of hash buckets for UDP/UDP-Lite connections 2537 Set number of hash buckets for UDP/UDP-Lite connections
2531 2538
@@ -2540,6 +2547,11 @@ bytes respectively. Such letter suffixes can also be entirely omitted.
2540 unknown_nmi_panic 2547 unknown_nmi_panic
2541 [X86] Cause panic on unknown NMI. 2548 [X86] Cause panic on unknown NMI.
2542 2549
2550 usbcore.authorized_default=
2551 [USB] Default USB device authorization:
2552 (default -1 = authorized except for wireless USB,
2553 0 = not authorized, 1 = authorized)
2554
2543 usbcore.autosuspend= 2555 usbcore.autosuspend=
2544 [USB] The autosuspend time delay (in seconds) used 2556 [USB] The autosuspend time delay (in seconds) used
2545 for newly-detected USB devices (default 2). This 2557 for newly-detected USB devices (default 2). This
diff --git a/Documentation/magic-number.txt b/Documentation/magic-number.txt
index 4b12abcb2ad3..abf481f780ec 100644
--- a/Documentation/magic-number.txt
+++ b/Documentation/magic-number.txt
@@ -66,7 +66,7 @@ MKISS_DRIVER_MAGIC 0x04bf mkiss_channel drivers/net/mkiss.h
66RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h 66RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h
67SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h 67SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h
68HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c 68HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c
69APM_BIOS_MAGIC 0x4101 apm_user arch/i386/kernel/apm.c 69APM_BIOS_MAGIC 0x4101 apm_user arch/x86/kernel/apm_32.c
70CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h 70CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h
71DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c 71DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c
72DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c 72DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c
diff --git a/Documentation/mca.txt b/Documentation/mca.txt
index 510375d4209a..dfd130c2207d 100644
--- a/Documentation/mca.txt
+++ b/Documentation/mca.txt
@@ -11,7 +11,7 @@ Adapter Detection
11 11
12The ideal MCA adapter detection is done through the use of the 12The ideal MCA adapter detection is done through the use of the
13Programmable Option Select registers. Generic functions for doing 13Programmable Option Select registers. Generic functions for doing
14this have been added in include/linux/mca.h and arch/i386/kernel/mca.c. 14this have been added in include/linux/mca.h and arch/x86/kernel/mca_32.c.
15Everything needed to detect adapters and read (and write) configuration 15Everything needed to detect adapters and read (and write) configuration
16information is there. A number of MCA-specific drivers already use 16information is there. A number of MCA-specific drivers already use
17this. The typical probe code looks like the following: 17this. The typical probe code looks like the following:
@@ -81,7 +81,7 @@ more people use shared IRQs on PCI machines.
81In general, an interrupt must be acknowledged not only at the ICU (which 81In general, an interrupt must be acknowledged not only at the ICU (which
82is done automagically by the kernel), but at the device level. In 82is done automagically by the kernel), but at the device level. In
83particular, IRQ 0 must be reset after a timer interrupt (now done in 83particular, IRQ 0 must be reset after a timer interrupt (now done in
84arch/i386/kernel/time.c) or the first timer interrupt hangs the system. 84arch/x86/kernel/time.c) or the first timer interrupt hangs the system.
85There were also problems with the 1.3.x floppy drivers, but that seems 85There were also problems with the 1.3.x floppy drivers, but that seems
86to have been fixed. 86to have been fixed.
87 87
diff --git a/Documentation/scheduler/sched-arch.txt b/Documentation/scheduler/sched-arch.txt
index d43dbcbd163b..28aa1075e291 100644
--- a/Documentation/scheduler/sched-arch.txt
+++ b/Documentation/scheduler/sched-arch.txt
@@ -66,7 +66,7 @@ Your cpu_idle routines need to obey the following rules:
66 barrier issued (followed by a test of need_resched with 66 barrier issued (followed by a test of need_resched with
67 interrupts disabled, as explained in 3). 67 interrupts disabled, as explained in 3).
68 68
69arch/i386/kernel/process.c has examples of both polling and 69arch/x86/kernel/process.c has examples of both polling and
70sleeping idle functions. 70sleeping idle functions.
71 71
72 72
diff --git a/Documentation/scsi/BusLogic.txt b/Documentation/scsi/BusLogic.txt
index d7fbc9488b98..48e982cd6fe7 100644
--- a/Documentation/scsi/BusLogic.txt
+++ b/Documentation/scsi/BusLogic.txt
@@ -553,7 +553,7 @@ replacing "/usr/src" with wherever you keep your Linux kernel source tree:
553 make config 553 make config
554 make zImage 554 make zImage
555 555
556Then install "arch/i386/boot/zImage" as your standard kernel, run lilo if 556Then install "arch/x86/boot/zImage" as your standard kernel, run lilo if
557appropriate, and reboot. 557appropriate, and reboot.
558 558
559 559
diff --git a/Documentation/serial/computone.txt b/Documentation/serial/computone.txt
index c57ea4781e5d..60a6f657c37d 100644
--- a/Documentation/serial/computone.txt
+++ b/Documentation/serial/computone.txt
@@ -87,7 +87,7 @@ c) Set address on ISA cards then:
87 edit /usr/src/linux/drivers/char/ip2.c 87 edit /usr/src/linux/drivers/char/ip2.c
88 (Optional - may be specified on kernel command line now) 88 (Optional - may be specified on kernel command line now)
89d) Run "make zImage" or whatever target you prefer. 89d) Run "make zImage" or whatever target you prefer.
90e) mv /usr/src/linux/arch/i386/boot/zImage to /boot. 90e) mv /usr/src/linux/arch/x86/boot/zImage to /boot.
91f) Add new config for this kernel into /etc/lilo.conf, run "lilo" 91f) Add new config for this kernel into /etc/lilo.conf, run "lilo"
92 or copy to a floppy disk and boot from that floppy disk. 92 or copy to a floppy disk and boot from that floppy disk.
93g) Reboot using this kernel 93g) Reboot using this kernel
diff --git a/Documentation/sysctl/kernel.txt b/Documentation/sysctl/kernel.txt
index 1c7fb0a94e28..704e474a93df 100644
--- a/Documentation/sysctl/kernel.txt
+++ b/Documentation/sysctl/kernel.txt
@@ -61,6 +61,7 @@ show up in /proc/sys/kernel:
61- rtsig-nr 61- rtsig-nr
62- sem 62- sem
63- sg-big-buff [ generic SCSI device (sg) ] 63- sg-big-buff [ generic SCSI device (sg) ]
64- shm_rmid_forced
64- shmall 65- shmall
65- shmmax [ sysv ipc ] 66- shmmax [ sysv ipc ]
66- shmmni 67- shmmni
@@ -518,6 +519,27 @@ kernel. This value defaults to SHMMAX.
518 519
519============================================================== 520==============================================================
520 521
522shm_rmid_forced:
523
524Linux lets you set resource limits, including how much memory one
525process can consume, via setrlimit(2). Unfortunately, shared memory
526segments are allowed to exist without association with any process, and
527thus might not be counted against any resource limits. If enabled,
528shared memory segments are automatically destroyed when their attach
529count becomes zero after a detach or a process termination. It will
530also destroy segments that were created, but never attached to, on exit
531from the process. The only use left for IPC_RMID is to immediately
532destroy an unattached segment. Of course, this breaks the way things are
533defined, so some applications might stop working. Note that this
534feature will do you no good unless you also configure your resource
535limits (in particular, RLIMIT_AS and RLIMIT_NPROC). Most systems don't
536need this.
537
538Note that if you change this from 0 to 1, already created segments
539without users and with a dead originative process will be destroyed.
540
541==============================================================
542
521softlockup_thresh: 543softlockup_thresh:
522 544
523This value can be used to lower the softlockup tolerance threshold. The 545This value can be used to lower the softlockup tolerance threshold. The
diff --git a/Documentation/usb/ehci.txt b/Documentation/usb/ehci.txt
index 9dcafa7d930d..160bd6c3ab7b 100644
--- a/Documentation/usb/ehci.txt
+++ b/Documentation/usb/ehci.txt
@@ -210,3 +210,5 @@ TBD: Interrupt and ISO transfer performance issues. Those periodic
210transfers are fully scheduled, so the main issue is likely to be how 210transfers are fully scheduled, so the main issue is likely to be how
211to trigger "high bandwidth" modes. 211to trigger "high bandwidth" modes.
212 212
213TBD: More than standard 80% periodic bandwidth allocation is possible
214through sysfs uframe_periodic_max parameter. Describe that.
diff --git a/Documentation/usb/gadget_hid.txt b/Documentation/usb/gadget_hid.txt
index f4a51f567427..12696c2e43fb 100644
--- a/Documentation/usb/gadget_hid.txt
+++ b/Documentation/usb/gadget_hid.txt
@@ -81,8 +81,8 @@ Send and receive HID reports
81 to do this. 81 to do this.
82 82
83 hid_gadget_test is a small interactive program to test the HID 83 hid_gadget_test is a small interactive program to test the HID
84 gadget driver. To use, point it at a hidg device and set the 84 gadget driver. To use, point it at a hidg device and set the
85 device type (keyboard / mouse / joystick) - E.G.: 85 device type (keyboard / mouse / joystick) - E.G.:
86 86
87 # hid_gadget_test /dev/hidg0 keyboard 87 # hid_gadget_test /dev/hidg0 keyboard
88 88
@@ -97,7 +97,7 @@ Send and receive HID reports
97 HID gadget. 97 HID gadget.
98 98
99 Another interesting example is the caps lock test. Type 99 Another interesting example is the caps lock test. Type
100 -caps-lock and hit return. A report is then sent by the 100 --caps-lock and hit return. A report is then sent by the
101 gadget and you should receive the host answer, corresponding 101 gadget and you should receive the host answer, corresponding
102 to the caps lock LED status. 102 to the caps lock LED status.
103 103
diff --git a/Documentation/zh_CN/email-clients.txt b/Documentation/zh_CN/email-clients.txt
index 5d65e323d060..b9a1a3e6c78d 100644
--- a/Documentation/zh_CN/email-clients.txt
+++ b/Documentation/zh_CN/email-clients.txt
@@ -1,4 +1,4 @@
1锘?Chinese translated version of Documentation/email-clients.txt 1Chinese translated version of Documentation/email-clients.txt
2 2
3If you have any comment or update to the content, please contact the 3If you have any comment or update to the content, please contact the
4original document maintainer directly. However, if you have a problem 4original document maintainer directly. However, if you have a problem
@@ -8,203 +8,203 @@ or if there is a problem with the translation.
8 8
9Chinese maintainer: Harry Wei <harryxiyou@gmail.com> 9Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
10--------------------------------------------------------------------- 10---------------------------------------------------------------------
11Documentation/email-clients.txt ???涓?????? 11Documentation/email-clients.txt 翻译
12 12
13濡????????璁????存??????????????璇?存?ヨ??诲???????缁存?よ?????????????? 13评论更新本文,请的维如果你使
14ゆ???????????锛?????ュ??涓???????缁??????┿??????????????颁????????????? 14困难的话以向中文新不
15璇?瀛???ㄩ??棰??????????缁存?????? 15译存在题,请
16 16
17???????存???锛? ??濞? Harry Wei <harryxiyou@gmail.com> 17者: 贾威威 Harry Wei <harryxiyou@gmail.com>
18???????昏?????锛? 惧??? Harry Wei <harryxiyou@gmail.com> 18译者: 贾威威 Harry Wei <harryxiyou@gmail.com>
19?????????¤?????锛? Yinglin Luan <synmyth@gmail.com> 19版校译者: Yinglin Luan <synmyth@gmail.com>
20 Xiaochen Wang <wangxiaochen0@gmail.com> 20 Xiaochen Wang <wangxiaochen0@gmail.com>
21 yaxinsn <yaxinsn@163.com> 21 yaxinsn <yaxinsn@163.com>
22 22
23ヤ??烘?f?? 23以下为
24--------------------------------------------------------------------- 24---------------------------------------------------------------------
25 25
26Linux???跺????????℃?? 26Linux邮件客
27====================================================================== 27======================================================================
28 28
29?????????? 29普通配
30---------------------------------------------------------------------- 30----------------------------------------------------------------------
31Linux?????歌ˉ涓???????杩????浠惰?????浜ょ??锛????濂芥??琛ヤ??浣?涓洪??浠朵????????宓?????????????浜?缁存?よ?? 31Linux内核补丁是通过邮件被提交的,最好把补丁作为邮件体的内嵌文本。有些维护者
32??ユ?堕????????????????瀹?煎???璇ユ??"text/plain"?????惰??????????????涓????????锛? 32收附件,但是附件的内"text/plain"。然而,件一般
33???涓???浣ˉ涓????寮???ㄩ??????????涓??????????伴?俱?? 33使分在评论的很难。
34 34
35??ㄦ?ュ?????Linux?????歌ˉ涓???????浠跺?㈡?风????ㄥ?????琛ヤ????跺??璇ュ??浜?????????????濮???舵?????渚?濡?锛? 35用来发送Linux内核补丁的邮件客户端在发送补丁时应该处于文本的原始状态。例如,
36???????????????????ゅ?????????硷???????????ㄦ???琛?????澶??????俱?? 36他们不能每一行头或者尾。
37 37
38涓?瑕????杩?"format=flowed"????????琛???????????璧??????????????崇?????琛???? 38不要通过"format=flowed"补丁会引以及害的
39 39
40涓?瑕?╀????????浠?㈡?风?????????????????????????浣????????? 40邮件客端进行自动补丁
41 41
42???浠跺?㈡?风??涓???芥?瑰???????????瀛?绗????缂??????瑰?????瑕??????????琛ヤ???????芥??ASCII??????UTF-8缂??????瑰??锛? 42邮件客户端不能改变文本的字符集编码方式。要发送的补丁只能是ASCII或者UTF-8编码方式,
43????浣?浣??UTF-8?????????????????讹????d??浣????????浜??????????????????????棰???? 43UTF-8,那么你将会避免一些可发生的题。
44 44
45???浠跺?㈡???????骞?????? References: ?????? In-Reply-To: ????????? 45件客并且保 References: 或者 In-Reply-To: 那么
46???浠惰??棰?灏?????????? 46邮件话就不
47 47
48澶???剁??甯?(?????????璐寸??甯?)???甯镐????界?ㄤ??琛ヤ??锛????涓哄?惰〃绗?浼?杞????涓虹┖??笺??浣跨??xclipboard, xclip 48复制粘帖(或者剪贴粘帖)通常不能用于补丁,因为制表符会转换为空格。使用xclipboard, xclip
49??????xcutsel涔?璁稿??浠ワ??浣???????濂??璇??????????????ㄥ?????????? 49或者xcutsel,但一下或者免使复制粘帖。
50 50
51涓?瑕???ㄤ娇???PGP/GPG缃插????????浠朵腑??????琛ヤ?????杩???蜂??浣垮??寰?澶???????涓???借?诲??????????ㄤ??浣????琛ヤ????? 51不要在使用PGP/GPG署名的邮件中包含补丁。这样会使得很多脚本不能读取和适用于你的补丁。
52??涓????棰?搴?璇ユ?????浠慨澶????锛? 52(这个可以修的)
53 53
54??ㄧ???????搁??浠跺??琛ㄥ?????琛ヤ??涔????锛?缁????宸卞?????涓?涓?琛ヤ?????涓?涓???????涓绘??锛?淇?瀛???ユ?跺?扮?? 54在给内核邮件列表发送补丁之前,给自己发送一个补丁是个不错的主意,保存接收到的
55???浠???ヤ?????'patch'??戒????锛????????????锛????缁??????????琛???????? 55件,将补'patch'上,如功了,再给内邮件列发送
56 56
57 57
58?????浠跺??风?????? 58一些邮提示
59---------------------------------------------------------------------- 59----------------------------------------------------------------------
60杩????缁???轰??浜?璇?缁????MUA???缃????绀猴?????浠ョ?ㄤ??缁?Linux?????稿?????琛ヤ?????杩?浜?骞朵???????虫?? 60这里给出一些详细的MUA配置提示,可以用于给Linux内核发送补丁。这些并不意味是
61??????????跺????????????? 61件包置总结。
62 62
63??锛? 63
64TUI = ユ??????虹???????ㄦ???? 64TUI =
65GUI = ??惧舰??????ㄦ???? 65GUI =
66 66
67~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 67~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
68Alpine (TUI) 68Alpine (TUI)
69 69
70???????椤癸?? 70选项
71???"Sending Preferences"??ㄥ??? 71"Sending Preferences"分:
72 72
73- "Do Not Send Flowed Text"蹇?椤????? 73- "Do Not Send Flowed Text"必须开
74- "Strip Whitespace Before Sending"蹇?椤诲?抽?? 74- "Strip Whitespace Before Sending"必须关闭
75 75
76褰????????讹?????????ユ?惧?ˉ?浼????扮?????????跺?????涓?CTRL-R?????????????? 76当写邮件,光在补丁会CTRL-R,使
77琛ヤ?????浠?????????? 77到邮件中。
78 78
79~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 79~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
80Evolution (GUI) 80Evolution (GUI)
81 81
82涓?浜?????????????????浣??????????? 82一些成功使发送补丁
83 83
84褰??????╅??浠??癸??Preformat 84邮件选项:Preformat
85 浠?Format->Heading->Preformatted (Ctrl-7)???????锋?? 85 Format->Heading->Preformatted (Ctrl-7)或者具栏
86 86
87??跺??浣跨??? 87然后使
88 Insert->Text File... (Alt-n x)?????ヨˉ????浠?? 88 Insert->Text File... (Alt-n x)丁文件。
89 89
90浣?杩?????"diff -Nru old.c new.c | xclip"???????Preformat锛???跺??浣跨?ㄤ腑??撮??杩??????? 90还可以"diff -Nru old.c new.c | xclip"Preformat使中间进行帖。
91 91
92~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 92~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
93Kmail (GUI) 93Kmail (GUI)
94 94
95?浜?????????????????浣?????????琛????? 95一些开发者的使用发送
96 96
97榛?よ?剧疆涓?涓?HTML??煎???????????????涓???????????? 97默认设不为HTML格式是合不要启
98 98
99褰?涔????涓?灏????浠剁????跺??锛???ㄩ??椤逛?????涓?瑕??????╄????ㄦ?㈣????????涓????缂虹?瑰氨???浣???ㄩ??浠朵腑杈???ョ??浠讳???????? 99当书写一封邮件的时候,在选项下面不要选择自动换行。唯一的缺点就是你在邮件中输入的任何文本
100??戒??浼?琚??????ㄦ?㈣??锛????姝や??蹇?椤诲?ㄥ?????琛ヤ??涔?????????ㄦ?㈣????????绠?????????规??灏辨???????ㄨ????ㄦ?㈣????ヤ功??????浠讹?? 100都不会被自动换行,因此你必须在发送补丁之前手动换行。最简单的方法就是启用自动换行来书写邮件,
101??跺?????瀹?淇?瀛?涓鸿??绋裤??涓????浣???ㄨ??绋夸腑???娆℃??寮?瀹?锛?瀹?宸茬????ㄩ?ㄨ????ㄦ?㈣??浜?锛???d??浣???????浠惰?界?舵病??? 101然后把它保存为草稿。一旦你在草稿中再次打开它,它已经全部自动换行了,那么你的邮件虽然没有
102?????╄????ㄦ?㈣???????????????????????㈣????? 102自动行,但还不失去已的自
103 103
104????浠??搴??????????ˉ?????锛?????哥?ㄧ??ヤ???????锛?涓?涓?杩?瀛????(---)??? 104在邮件入补丁之前,补丁定:三个连(---)
105 105
106??跺?????"Message"????????$??锛??????╂????ユ??浠讹????ョ????????浣????琛ヤ?????浠躲??杩????涓?涓?棰?澶???????椤癸??浣????浠? 106然后在"Message"菜单条目,选择插入文件,接着选取你的补丁文件。还有一个额外的选项,你可以
107???杩?????缃?浣???????浠缓绔??????????锛?杩?????"insert file"??????? 107邮件建工具菜单,还可以带上"insert file"图标
108 108
109浣????浠ュ????ㄥ?伴??杩?GPG???璁伴??浠讹??浣???????宓?琛ヤ?????濂戒??瑕?浣跨??GPG???璁板??浠????浣?涓哄??宓??????????绛惧??琛ヤ??锛? 109你可以安全地通过GPG标记附件,但是内嵌补丁最好不要使用GPG标记它们。作为内嵌文本的签发补丁,
110褰?浠?GPG???????7浣?????????浣?????????????澶??????? 110当从GPG7会使他们
111 111
112濡????浣????瑕?浠ラ??浠剁??褰㈠????????琛ヤ??锛???d??灏卞?抽????瑰?婚??浠讹????跺?????涓?灞???э??绐????"Suggest automatic 112如果你非要以附件的形式发送补丁,那么就右键点击附件,然后选中属性,突出"Suggest automatic
113display"锛??????????舵?村???璁╄?????????? 113display",这读者看
114 114
115褰?浣?瑕?淇?瀛?灏?瑕?????????????宓???????琛ヤ??锛?浣????浠ヤ??娑???????琛ㄧ????奸????╁?????琛ヤ????????浠讹????跺????冲?婚????? 115当你要保存将要发送的内嵌文本补丁,你可以从消息列表窗格选择包含补丁的邮件,然后右击选择
116"save as"???浣????浠ヤ娇??ㄤ??涓?娌℃????存?圭????????琛ヤ????????浠讹??濡????瀹????浠ユ?g‘???褰㈠??缁???????褰?浣?姝g????ㄥ?? 116"save as"。你可以使用一个没有更改的包含补丁的邮件,如果它是以正确的形式组成。当你正真在它
117???宸辩??绐???d??涓?瀵????锛???f?舵病??????椤瑰??浠ヤ??瀛????浠?--宸茬?????涓?涓?杩???风??bug琚?姹???ュ?颁??kmail???bugzilla 117自己的窗口之下察看,那时没有选项可以保存邮件--已经有一个这样的bug被汇报到了kmail的bugzilla
118骞朵??甯????杩?灏?浼?琚?澶??????????浠舵??浠ュ?????瀵规??涓???ㄦ?峰??璇诲???????????琚?淇?瀛????锛????浠ュ?????浣???虫?????浠跺????跺?板?朵????版?癸?? 118并且希望这将会被处理。邮件是以只针对某个用户可读写的权限被保存的,所以如果你想把邮件复制到其他地方,
119浣?涓???????浠?????????????????????翠?????璇?? 119你不他们的改为者整体可读。
120 120
121~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 121~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
122Lotus Notes (GUI) 122Lotus Notes (GUI)
123 123
124涓?瑕?浣?????? 124使
125 125
126~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 126~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
127Mutt (TUI) 127Mutt (TUI)
128 128
129??Linux????浜??浣??mutt瀹㈡?风??锛????ヨ?????????瀹??????????????? 129Linux人员使mutt以证明的非常漂亮。
130 130
131Mutt涓????甯?缂?杈????锛????浠ヤ??绠′??浣跨?ㄤ??涔?缂?杈???ㄩ?戒??搴?璇ュ甫????????ㄦ??琛????澶у????扮??杈???ㄩ?藉甫??? 131Mutt不自带编辑器,所以不管你使用什么编辑器都不应该带有自动断行。大多数编辑器都带有
132涓?涓?"insert file"???椤癸??????浠???????????跺??????瑰???????ユ??躲?? 132一个"insert file"可以通过不内容入文件。
133 133
134'vim'浣?涓?mutt????杈????锛? 134'vim'作为mutt辑器:
135 set editor="vi" 135 set editor="vi"
136 136
137 ????浣??xclip锛????ヤ涓???戒 137 xclip下命
138 :set paste 138 :set paste
139 ?????????????????shift-insert???????? 139 之前或者shift-insert使
140 :r filename 140 :r filename
141 141
142濡???????????琛ヤ??????????????? 142要把补丁作为文本。
143(a)ttachヤ??????斤??涓?甯????"set paste"??? 143(a)ttach作的很好,"set paste"
144 144
145???????椤癸?? 145选项
146瀹?搴?璇互榛?璁よ?疆???㈠??????? 146以默置的形式工作
147????锛????"send_charset"剧疆涓?"us-ascii::utf-8"????涓?涓?涓???????涓????? 147然而,"send_charset""us-ascii::utf-8"一个不意。
148 148
149~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 149~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
150Pine (TUI) 150Pine (TUI)
151 151
152Pine杩?????????????????锛?浣????杩????板???璇???淇?澶?浜???? 152Pine一些格删减问题这些被修
153 153
154???????浠ワ??璇???alpine(pine??????) 154以,请使alpine(pine继承)
155 155
156???????椤癸?? 156选项
157- ?????????????????娑???ゆ????????? 157- 版本需要消除流文本
158- "no-strip-whitespace-before-send"?????????????????? 158- "no-strip-whitespace-before-send"选项也
159 159
160 160
161~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 161~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
162Sylpheed (GUI) 162Sylpheed (GUI)
163 163
164- ?????????????ュ????ヤ??锛??????????浠讹????? 164- 本可以很好作(使件)。
165- ?????????ㄧ???杈????? 165- 许使用辑器
166- ????????????甯告????? 166- 对于慢。
167- ???????杩?non-SSL???ワ?????娉???TLS SMTP????????? 167- non-SSL法使TLS SMTP授权。
168- ??ㄧ????????腑?????????????ruler bar??? 168- 窗口中一个有用ruler bar
169- ?????????娣诲??????灏??浼???????????? 169- 就不会显示名
170 170
171~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 171~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
172Thunderbird (GUI) 172Thunderbird (GUI)
173 173
174榛?璁ゆ????典??锛?thunderbird寰?瀹规??????????????锛?浣????杩????涓?浜???规?????浠ュ己??跺?????寰???村ソ??? 174默认情况下,thunderbird很容易损坏文本,但是还有一些方法可以强制它变得更好。
175 175
176- ??ㄧ?ㄦ?????????????????????瑕???????"Compose messages in HTML format"??? 176- 号设成和寻,不"Compose messages in HTML format"
177 177
178- ?杈?浣????Thunderbird????疆??娇瀹??瑕????琛?浣???user_pref("mailnews.wraplength", 0); 178- 辑你的Thunderbird来使不要使user_pref("mailnews.wraplength", 0);
179 179
180- ?杈?浣????Thunderbird?????浣垮??涓?瑕?浣??"format=flowed"??煎??锛?user_pref("mailnews. 180- 辑你的Thunderbird设置使使用"format=flowed"格式:user_pref("mailnews.
181 send_plaintext_flowed", false); 181 send_plaintext_flowed", false);
182 182
183- 浣????瑕?浣?Thunderbird??????????煎????瑰??锛? 183- 你需要使Thunderbird变为预先式:
184 濡????榛?璁ゆ????典??浣?涔??????????HTML??煎??锛???d?????寰???俱??浠?浠?浠????棰???????涓????妗?涓???????"Preformat"??煎????? 184 如果默认情况下你书写的是HTML格式,那不是很难。仅仅从标题栏的下拉框中选择"Preformat"格式。
185 濡????榛?璁ゆ????典??浣?涔??????????????????煎??锛?浣?涓?寰????瀹???逛负HTML??煎??锛?浠?浠?浣?涓轰??娆℃?х??锛???ヤ功?????扮??娑????锛? 185 如果默认情况下你书写的是文本格式,你不得把它改为HTML格式(仅仅作为一次性的)来书写新的消息,
186 ??跺??寮哄?朵娇瀹??????版???????煎??锛???????瀹?灏变?????琛????瑕?瀹???板??锛???ㄥ??淇$????炬??涓?浣跨??shift?????ヤ娇瀹????涓?HTML 186 然后强制使它回到文本格式,否则它就会拆行。要实现它,在写信的图标上使用shift键来使它变为HTML
187 ???????跺????????????????妗????????"Preformat"??煎????? 187 格式,的下中选择"Preformat"格式。
188 188
189- ?????????ㄧ???杈????锛? 189- 许使用辑器:
190 ???瀵?Thunderbird???琛ヤ?????绠?????????规??灏辨??浣跨?ㄤ??涓?"external editor"??╁??锛???跺??浣跨?ㄤ????????娆㈢?? 190 针对Thunderbird打补丁最简单的方法就是使用一个"external editor"扩展,然后使用你最喜欢的
191 $EDITOR??ヨ?诲???????????骞惰ˉ涓???版?????涓????瑕?瀹???板??锛????浠ヤ??杞藉苟涓?瀹?瑁?杩?涓???╁??锛???跺??娣诲??涓?涓?浣跨?ㄥ????? 191 $EDITOR来读取或者合并补丁到文本中。要实现它,可以下载并且安装这个扩展,然后添加一个使用它的
192 ??????View->Toolbars->Customize...??????褰??????淇???????跺???浠????诲??灏??浠????? 192 按键View->Toolbars->Customize...后当你书写信候仅仅击它以了
193 193
194~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 194~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
195TkRat (GUI) 195TkRat (GUI)
196 196
197???浠ヤ???????浣??"Insert file..."????????????杈????? 197以使使"Insert file..."者外部辑器
198 198
199~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 199~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
200Gmail (Web GUI) 200Gmail (Web GUI)
201 201
202涓??浣?????????琛????? 202不要使
203 203
204Gmail?椤??风???????ㄥ?版?????????┖???? 204Gmail自动地转换空格。
205 205
206??界?跺?惰〃绗?杞????涓虹┖??奸??棰????浠ヨ??澶???ㄧ??杈???ㄨВ??筹???????跺??杩?浼?浣跨?ㄥ??杞???㈣?????姣?琛???????涓?78涓?瀛?绗???? 206虽然制表符转换为空格问题可以被外部编辑器解决,同时它还会使用回车换行把每行拆分为78个字符。
207 207
208???涓?涓????棰????Gmail杩?浼????浠讳??涓????ASCII???瀛?绗????淇℃????逛负base64缂???????瀹????涓?瑗垮????????娆ф床浜虹?????瀛???? 208另一个问题是Gmail还会把任何不是ASCII的字符的信息改为base64编码。它把东西变的像欧洲人的名字。
209 209
210 ### 210 ###
diff --git a/Documentation/zh_CN/magic-number.txt b/Documentation/zh_CN/magic-number.txt
index 4c4ce853577b..c278f412dc65 100644
--- a/Documentation/zh_CN/magic-number.txt
+++ b/Documentation/zh_CN/magic-number.txt
@@ -66,7 +66,7 @@ MKISS_DRIVER_MAGIC 0x04bf mkiss_channel drivers/net/mkiss.h
66RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h 66RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h
67SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h 67SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h
68HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c 68HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c
69APM_BIOS_MAGIC 0x4101 apm_user arch/i386/kernel/apm.c 69APM_BIOS_MAGIC 0x4101 apm_user arch/x86/kernel/apm_32.c
70CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h 70CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h
71DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c 71DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c
72DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c 72DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c