diff options
author | Arnd Bergmann <arnd@arndb.de> | 2011-07-28 11:25:46 -0400 |
---|---|---|
committer | Arnd Bergmann <arnd@arndb.de> | 2011-07-28 11:25:46 -0400 |
commit | 6124a4e430b64d1577438c8648c59e996d02e73e (patch) | |
tree | 49cfafad785d1c9e403a5b0d755298b9af2c260f /Documentation | |
parent | 8e267f3da5f117d2f1316cf6ddf740f93f1c73aa (diff) | |
parent | 580975d7f48d7d047e22bb0f42adf7557801d8d4 (diff) |
Merge branch 'imx/dt' into next/dt
Diffstat (limited to 'Documentation')
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 @@ | |||
1 | What: /sys/bus/i2c/devices/.../device | ||
2 | Date: February 2011 | ||
3 | Contact: Minkyu Kang <mk7.kang@samsung.com> | ||
4 | Description: | ||
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 | |||
12 | What: /sys/bus/i2c/devices/.../switch | ||
13 | Date: February 2011 | ||
14 | Contact: Minkyu Kang <mk7.kang@samsung.com> | ||
15 | Description: | ||
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 | |||
10 | Contact: masa-korg@dsn.okisemi.com | 10 | Contact: masa-korg@dsn.okisemi.com |
11 | Description: Write/read Option ROM data. | 11 | Description: Write/read Option ROM data. |
12 | 12 | ||
13 | |||
14 | What: /sys/module/ehci_hcd/drivers/.../uframe_periodic_max | ||
15 | Date: July 2011 | ||
16 | KernelVersion: 3.1 | ||
17 | Contact: Kirill Smelkov <kirr@mns.spb.ru> | ||
18 | Description: 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 < 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 | ||
215 | struct { | 215 | struct { |
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, | |||
5 | it is possible to use RCU to provide dynamic non-maskable interrupt | 5 | it is possible to use RCU to provide dynamic non-maskable interrupt |
6 | handlers, as well as dynamic irq handlers. This document describes | 6 | handlers, as well as dynamic irq handlers. This document describes |
7 | how to do this, drawing loosely from Zwane Mwaikambo's NMI-timer | 7 | how to do this, drawing loosely from Zwane Mwaikambo's NMI-timer |
8 | work in "arch/i386/oprofile/nmi_timer_int.c" and in | 8 | work in "arch/x86/oprofile/nmi_timer_int.c" and in |
9 | "arch/i386/kernel/traps.c". | 9 | "arch/x86/kernel/traps.c". |
10 | 10 | ||
11 | The relevant pieces of code are listed below, each followed by a | 11 | The relevant pieces of code are listed below, each followed by a |
12 | brief explanation. | 12 | brief 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 | ||
54 | 12: Has been tested with CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT, | 54 | 12: 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 | ||
59 | 13: Has been build- and runtime tested with and without CONFIG_SMP and | 59 | 13: 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 | ||
46 | rq_affinity (RW) | 46 | rq_affinity (RW) |
47 | ---------------- | 47 | ---------------- |
48 | If this option is enabled, the block layer will migrate request completions | 48 | If this option is '1', the block layer will migrate request completions to the |
49 | to the CPU that originally submitted the request. For some workloads | 49 | cpu "group" that originally submitted the request. For some workloads this |
50 | this provides a significant reduction in CPU cycles due to caching effects. | 50 | provides a significant reduction in CPU cycles due to caching effects. |
51 | |||
52 | For storage configurations that need to maximize distribution of completion | ||
53 | processing setting this option to '2' forces the completion to run on the | ||
54 | requesting cpu (bypassing the "group" aggregation logic). | ||
51 | 55 | ||
52 | scheduler (RW) | 56 | scheduler (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 | ||
217 | Then install "arch/i386/boot/bzImage" or "arch/i386/boot/zImage" as your | 217 | Then install "arch/x86/boot/bzImage" or "arch/x86/boot/zImage" as your |
218 | standard kernel, run lilo if appropriate, and reboot. | 218 | standard kernel, run lilo if appropriate, and reboot. |
219 | 219 | ||
220 | To create the necessary devices in /dev, the "make_rd" script included in | 220 | To 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 | |||
64 | is not required. Bits 11 to 13 are not currently used and may as well be zero. | 64 | is not required. Bits 11 to 13 are not currently used and may as well be zero. |
65 | These numbers are no magical secrets, as seen below: | 65 | These 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 | ||
71 | Consider a typical two floppy disk setup, where you will have the | 71 | Consider a typical two floppy disk setup, where you will have the |
72 | kernel on disk one, and have already put a RAM disk image onto disk #2. | 72 | kernel 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" | |||
85 | Putting that together gives 2^15 + 2^14 + 0 = 49152 for an rdev word. | 85 | Putting that together gives 2^15 + 2^14 + 0 = 49152 for an rdev word. |
86 | So to create disk one of the set, you would do: | 86 | So 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 | ||
381 | 5.2 stat file | 381 | 5.2 stat file |
382 | 382 | ||
383 | memory.stat file includes following statistics | 383 | 5.2.1 memory.stat file includes following statistics |
384 | 384 | ||
385 | # per-memory cgroup local status | 385 | # per-memory cgroup local status |
386 | cache - # of bytes of page cache memory. | 386 | cache - # 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 | ||
441 | 5.2.2 memory.vmscan_stat | ||
442 | |||
443 | memory.vmscan_stat includes statistics information for memory scanning and | ||
444 | freeing, reclaiming. The statistics shows memory scanning information since | ||
445 | memory cgroup creation and can be reset to 0 by writing 0 as | ||
446 | |||
447 | #echo 0 > ../memory.vmscan_stat | ||
448 | |||
449 | This file contains following statistics. | ||
450 | |||
451 | [param]_[file_or_anon]_pages_by_[reason]_[under_heararchy] | ||
452 | [param]_elapsed_ns_by_[reason]_[under_hierarchy] | ||
453 | |||
454 | For example, | ||
455 | |||
456 | scanned_file_pages_by_limit indicates the number of scanned | ||
457 | file pages at vmscan. | ||
458 | |||
459 | Now, 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 | |||
465 | If "rotated" is high against scanned/freed, the memcg seems busy. | ||
466 | |||
467 | Now, 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 | |||
473 | When under_hierarchy is added in the tail, the number indicates the | ||
474 | total memcg scan of its children and itself. | ||
475 | |||
476 | elapsed_ns is a elapsed time in nanosecond. This may include sleep time | ||
477 | and not indicates CPU usage. So, please take this as just showing | ||
478 | latency. | ||
479 | |||
480 | Here is an example. | ||
481 | |||
482 | # cat /cgroup/memory/A/memory.vmscan_stat | ||
483 | scanned_pages_by_limit 9471864 | ||
484 | scanned_anon_pages_by_limit 6640629 | ||
485 | scanned_file_pages_by_limit 2831235 | ||
486 | rotated_pages_by_limit 4243974 | ||
487 | rotated_anon_pages_by_limit 3971968 | ||
488 | rotated_file_pages_by_limit 272006 | ||
489 | freed_pages_by_limit 2318492 | ||
490 | freed_anon_pages_by_limit 962052 | ||
491 | freed_file_pages_by_limit 1356440 | ||
492 | elapsed_ns_by_limit 351386416101 | ||
493 | scanned_pages_by_system 0 | ||
494 | scanned_anon_pages_by_system 0 | ||
495 | scanned_file_pages_by_system 0 | ||
496 | rotated_pages_by_system 0 | ||
497 | rotated_anon_pages_by_system 0 | ||
498 | rotated_file_pages_by_system 0 | ||
499 | freed_pages_by_system 0 | ||
500 | freed_anon_pages_by_system 0 | ||
501 | freed_file_pages_by_system 0 | ||
502 | elapsed_ns_by_system 0 | ||
503 | scanned_pages_by_limit_under_hierarchy 9471864 | ||
504 | scanned_anon_pages_by_limit_under_hierarchy 6640629 | ||
505 | scanned_file_pages_by_limit_under_hierarchy 2831235 | ||
506 | rotated_pages_by_limit_under_hierarchy 4243974 | ||
507 | rotated_anon_pages_by_limit_under_hierarchy 3971968 | ||
508 | rotated_file_pages_by_limit_under_hierarchy 272006 | ||
509 | freed_pages_by_limit_under_hierarchy 2318492 | ||
510 | freed_anon_pages_by_limit_under_hierarchy 962052 | ||
511 | freed_file_pages_by_limit_under_hierarchy 1356440 | ||
512 | elapsed_ns_by_limit_under_hierarchy 351386416101 | ||
513 | scanned_pages_by_system_under_hierarchy 0 | ||
514 | scanned_anon_pages_by_system_under_hierarchy 0 | ||
515 | scanned_file_pages_by_system_under_hierarchy 0 | ||
516 | rotated_pages_by_system_under_hierarchy 0 | ||
517 | rotated_anon_pages_by_system_under_hierarchy 0 | ||
518 | rotated_file_pages_by_system_under_hierarchy 0 | ||
519 | freed_pages_by_system_under_hierarchy 0 | ||
520 | freed_anon_pages_by_system_under_hierarchy 0 | ||
521 | freed_file_pages_by_system_under_hierarchy 0 | ||
522 | elapsed_ns_by_system_under_hierarchy 0 | ||
523 | |||
441 | 5.3 swappiness | 524 | 5.3 swappiness |
442 | 525 | ||
443 | Similar to /proc/sys/vm/swappiness, but affecting a hierarchy of groups only. | 526 | Similar 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 | |||
168 | to policy->max, and -if supported- select a performance-oriented | 168 | to policy->max, and -if supported- select a performance-oriented |
169 | setting when policy->policy is CPUFREQ_POLICY_PERFORMANCE, and a | 169 | setting when policy->policy is CPUFREQ_POLICY_PERFORMANCE, and a |
170 | powersaving-oriented setting when CPUFREQ_POLICY_POWERSAVE. Also check | 170 | powersaving-oriented setting when CPUFREQ_POLICY_POWERSAVE. Also check |
171 | the reference implementation in arch/i386/kernel/cpu/cpufreq/longrun.c | 171 | the 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 @@ | |||
1 | prima2 "cb" evalutation board | ||
2 | Required 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 @@ | |||
1 | Xilinx Zynq EP107 Emulation Platform board | ||
2 | |||
3 | This board is an emulation platform for the Zynq product which is | ||
4 | based on an ARM Cortex A9 processor. | ||
5 | |||
6 | Required 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 | |||
3 | Required 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 | |||
10 | Examples: | ||
11 | |||
12 | sdma@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 | |||
3 | The Enhanced Secure Digital Host Controller on Freescale i.MX family | ||
4 | provides an interface for MMC, SD, and SDIO types of memory cards. | ||
5 | |||
6 | Required properties: | ||
7 | - compatible : Should be "fsl,<chip>-esdhc" | ||
8 | - reg : Should contain eSDHC registers location and length | ||
9 | - interrupts : Should contain eSDHC interrupt | ||
10 | |||
11 | Optional 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 | |||
18 | Examples: | ||
19 | |||
20 | esdhc@70004000 { | ||
21 | compatible = "fsl,imx51-esdhc"; | ||
22 | reg = <0x70004000 0x4000>; | ||
23 | interrupts = <1>; | ||
24 | fsl,cd-internal; | ||
25 | fsl,wp-internal; | ||
26 | }; | ||
27 | |||
28 | esdhc@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 | |||
3 | Required 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 | |||
12 | Optional properties: | ||
13 | - local-mac-address : 6 bytes, mac address | ||
14 | |||
15 | Example: | ||
16 | |||
17 | fec@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 @@ | |||
1 | OLPC XO-1 RTC | ||
2 | ~~~~~~~~~~~~~ | ||
3 | |||
4 | Required 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 | |||
3 | Required 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 | |||
8 | Optional properties: | ||
9 | - fsl,uart-has-rtscts : Indicate the uart has rts and cts | ||
10 | - fsl,irda-mode : Indicate the uart supports irda mode | ||
11 | |||
12 | Example: | ||
13 | |||
14 | uart@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 | ||
105 | And assuming 'dev' is the struct device passed into the probe hook, the driver | 105 | And assuming 'dev' is the struct device passed into the probe hook, the driver |
106 | probe function would do something like: | 106 | probe 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 | |||
30 | Microsoft (namely ACPI) ensures that almost every device on almost any bus | 30 | Microsoft (namely ACPI) ensures that almost every device on almost any bus |
31 | on an x86-compatible system can work within this paradigm. Of course, | 31 | on an x86-compatible system can work within this paradigm. Of course, |
32 | not every bus is able to support all such operations, although most | 32 | not every bus is able to support all such operations, although most |
33 | buses support a most of those operations. | 33 | buses support most of those operations. |
34 | 34 | ||
35 | 35 | ||
36 | Downstream Access | 36 | Downstream Access |
@@ -46,25 +46,29 @@ struct pci_dev now looks like this: | |||
46 | struct pci_dev { | 46 | struct pci_dev { |
47 | ... | 47 | ... |
48 | 48 | ||
49 | struct device dev; | 49 | struct device dev; /* Generic device interface */ |
50 | ... | ||
50 | }; | 51 | }; |
51 | 52 | ||
52 | Note first that it is statically allocated. This means only one allocation on | 53 | Note first that the struct device dev within the struct pci_dev is |
53 | device discovery. Note also that it is at the _end_ of struct pci_dev. This is | 54 | statically allocated. This means only one allocation on device discovery. |
54 | to make people think about what they're doing when switching between the bus | 55 | |
55 | driver and the global driver; and to prevent against mindless casts between | 56 | Note also that that struct device dev is not necessarily defined at the |
56 | the two. | 57 | front of the pci_dev structure. This is to make people think about what |
58 | they're doing when switching between the bus driver and the global driver, | ||
59 | and to discourage meaningless and incorrect casts between the two. | ||
57 | 60 | ||
58 | The PCI bus layer freely accesses the fields of struct device. It knows about | 61 | The PCI bus layer freely accesses the fields of struct device. It knows about |
59 | the structure of struct pci_dev, and it should know the structure of struct | 62 | the structure of struct pci_dev, and it should know the structure of struct |
60 | device. Individual PCI device drivers that have been converted to the current | 63 | device. Individual PCI device drivers that have been converted to the current |
61 | driver model generally do not and should not touch the fields of struct device, | 64 | driver model generally do not and should not touch the fields of struct device, |
62 | unless there is a strong compelling reason to do so. | 65 | unless there is a compelling reason to do so. |
63 | 66 | ||
64 | This abstraction is prevention of unnecessary pain during transitional phases. | 67 | The above abstraction prevents unnecessary pain during transitional phases. |
65 | If the name of the field changes or is removed, then every downstream driver | 68 | If it were not done this way, then when a field was renamed or removed, every |
66 | will break. On the other hand, if only the bus layer (and not the device | 69 | downstream driver would break. On the other hand, if only the bus layer |
67 | layer) 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 |
71 | layer that needs to change. | ||
68 | 72 | ||
69 | 73 | ||
70 | User Interface | 74 | User Interface |
@@ -73,15 +77,27 @@ User Interface | |||
73 | By virtue of having a complete hierarchical view of all the devices in the | 77 | By virtue of having a complete hierarchical view of all the devices in the |
74 | system, exporting a complete hierarchical view to userspace becomes relatively | 78 | system, exporting a complete hierarchical view to userspace becomes relatively |
75 | easy. This has been accomplished by implementing a special purpose virtual | 79 | easy. This has been accomplished by implementing a special purpose virtual |
76 | file system named sysfs. It is hence possible for the user to mount the | 80 | file system named sysfs. |
77 | whole sysfs filesystem anywhere in userspace. | 81 | |
82 | Almost all mainstream Linux distros mount this filesystem automatically; you | ||
83 | can see some variation of the following in the output of the "mount" command: | ||
84 | |||
85 | $ mount | ||
86 | ... | ||
87 | none on /sys type sysfs (rw,noexec,nosuid,nodev) | ||
88 | ... | ||
89 | $ | ||
90 | |||
91 | The auto-mounting of sysfs is typically accomplished by an entry similar to | ||
92 | the following in the /etc/fstab file: | ||
93 | |||
94 | none /sys sysfs defaults 0 0 | ||
78 | 95 | ||
79 | This can be done permanently by providing the following entry into the | 96 | or 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 | ||
82 | none /sys sysfs defaults 0 0 | 98 | none /sys sysfs nodev,noexec,nosuid 0 0 |
83 | 99 | ||
84 | Or by hand on the command line: | 100 | If 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 | ||
21 | Valid mode specifiers (mode_option argument): | 21 | Valid 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 | ||
26 | with <xres>, <yres>, <bpp> and <refresh> decimal numbers and <name> a string. | 26 | with <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 | ||
39 | DRM 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 | ||
42 | if a display is connected. 'D' will force the display to be enabled and use | ||
43 | digital output. This is useful for outputs that have both analog and digital | ||
44 | signals (e.g. HDMI and DVI-I). For other outputs it behaves like 'e'. If 'd' | ||
45 | is specified the output is disabled. | ||
46 | |||
47 | You can additionally specify which output the options matches to. | ||
48 | To force the VGA output to be enabled and drive a specific mode say: | ||
49 | video=VGA-1:1280x1024@60me | ||
50 | |||
51 | Specifying 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 | ||
41 | What is the VESA(TM) Coordinated Video Timings (CVT)? | 56 | What 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 | ||
135 | BTW, only a few drivers use this at the moment. Others are to follow | 150 | BTW, 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 | ||
196 | What: CS5535/CS5536 obsolete GPIO driver | ||
197 | When: June 2011 | ||
198 | Files: drivers/staging/cs5535_gpio/* | ||
199 | Check: drivers/staging/cs5535_gpio/cs5535_gpio.c | ||
200 | Why: 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. | ||
206 | Who: Andres Salomon <dilinger@queued.net> | ||
207 | |||
208 | -------------------------- | ||
209 | |||
210 | What: remove EXPORT_SYMBOL(kernel_thread) | 196 | What: remove EXPORT_SYMBOL(kernel_thread) |
211 | When: August 2006 | 197 | When: August 2006 |
212 | Files: arch/*/kernel/*_ksyms.c | 198 | Files: 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 | |||
294 | Why: The support code for the old firmware hurts code readability/maintainability | 280 | Why: 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. |
297 | Who: Michael Buesch <mb@bu3sch.de> | 283 | Who: 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 | ||
432 | What: iwlwifi 50XX module parameters | 418 | What: iwlwifi 50XX module parameters |
433 | When: 2.6.40 | 419 | When: 3.0 |
434 | Why: The "..50" modules parameters were used to configure 5000 series and | 420 | Why: 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 | ||
443 | What: iwl4965 alias support | 429 | What: iwl4965 alias support |
444 | When: 2.6.40 | 430 | When: 3.0 |
445 | Why: Internal alias support has been present in module-init-tools for some | 431 | Why: 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 | ||
477 | What: DMA_xxBIT_MASK macros | ||
478 | When: Jun 2011 | ||
479 | Why: DMA_xxBIT_MASK macros were replaced with DMA_BIT_MASK() macros. | ||
480 | Who: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp> | ||
481 | |||
482 | ---------------------------- | ||
483 | |||
484 | What: iwlwifi disable_hw_scan module parameters | 463 | What: iwlwifi disable_hw_scan module parameters |
485 | When: 2.6.40 | 464 | When: 3.0 |
486 | Why: Hareware scan is the prefer method for iwlwifi devices for | 465 | Why: 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 | ||
494 | What: access to nfsd auth cache through sys_nfsservctl or '.' files | ||
495 | in the 'nfsd' filesystem. | ||
496 | When: 2.6.40 | ||
497 | Why: 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. | ||
500 | Who: NeilBrown <neilb@suse.de> | ||
501 | |||
502 | ---------------------------- | ||
503 | |||
504 | What: Legacy, non-standard chassis intrusion detection interface. | 473 | What: Legacy, non-standard chassis intrusion detection interface. |
505 | When: June 2011 | 474 | When: June 2011 |
506 | Why: The adm9240, w83792d and w83793 hardware monitoring drivers have | 475 | Why: 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 | ||
521 | What: noswapaccount kernel command line parameter | ||
522 | When: 2.6.40 | ||
523 | Why: 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 (). | ||
533 | Who: Michal Hocko <mhocko@suse.cz> | ||
534 | |||
535 | ---------------------------- | ||
536 | |||
537 | What: ipt_addrtype match include file | 490 | What: ipt_addrtype match include file |
538 | When: 2012 | 491 | When: 2012 |
539 | Why: superseded by xt_addrtype | 492 | Why: superseded by xt_addrtype |
@@ -552,7 +505,7 @@ Who: Jean Delvare <khali@linux-fr.org> | |||
552 | ---------------------------- | 505 | ---------------------------- |
553 | 506 | ||
554 | What: Support for UVCIOC_CTRL_ADD in the uvcvideo driver | 507 | What: Support for UVCIOC_CTRL_ADD in the uvcvideo driver |
555 | When: 2.6.42 | 508 | When: 3.2 |
556 | Why: The information passed to the driver by this ioctl is now queried | 509 | Why: The information passed to the driver by this ioctl is now queried |
557 | dynamically from the device. | 510 | dynamically from the device. |
558 | Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> | 511 | Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> |
@@ -560,7 +513,7 @@ Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> | |||
560 | ---------------------------- | 513 | ---------------------------- |
561 | 514 | ||
562 | What: Support for UVCIOC_CTRL_MAP_OLD in the uvcvideo driver | 515 | What: Support for UVCIOC_CTRL_MAP_OLD in the uvcvideo driver |
563 | When: 2.6.42 | 516 | When: 3.2 |
564 | Why: Used only by applications compiled against older driver versions. | 517 | Why: 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. |
566 | Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> | 519 | Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> |
@@ -568,7 +521,7 @@ Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> | |||
568 | ---------------------------- | 521 | ---------------------------- |
569 | 522 | ||
570 | What: Support for UVCIOC_CTRL_GET and UVCIOC_CTRL_SET in the uvcvideo driver | 523 | What: Support for UVCIOC_CTRL_GET and UVCIOC_CTRL_SET in the uvcvideo driver |
571 | When: 2.6.42 | 524 | When: 3.2 |
572 | Why: Superseded by the UVCIOC_CTRL_QUERY ioctl. | 525 | Why: Superseded by the UVCIOC_CTRL_QUERY ioctl. |
573 | Who: Laurent Pinchart <laurent.pinchart@ideasonboard.com> | 526 | Who: 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 | |||
595 | Who: Hans Verkuil <hans.verkuil@cisco.com> | 548 | Who: Hans Verkuil <hans.verkuil@cisco.com> |
596 | 549 | ||
597 | ---------------------------- | 550 | ---------------------------- |
551 | |||
552 | What: g_file_storage driver | ||
553 | When: 3.8 | ||
554 | Why: This driver has been superseded by g_mass_storage. | ||
555 | Who: 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 | |||
80 | truncate: yes (see below) | 80 | truncate: yes (see below) |
81 | setattr: yes | 81 | setattr: yes |
82 | permission: no (may not block if called in rcu-walk mode) | 82 | permission: no (may not block if called in rcu-walk mode) |
83 | check_acl: no | 83 | get_acl: no |
84 | getattr: no | 84 | getattr: no |
85 | setxattr: yes | 85 | setxattr: yes |
86 | getxattr: no | 86 | getxattr: no |
@@ -338,21 +338,21 @@ fl_release_private: maybe no | |||
338 | 338 | ||
339 | ----------------------- lock_manager_operations --------------------------- | 339 | ----------------------- lock_manager_operations --------------------------- |
340 | prototypes: | 340 | prototypes: |
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 | ||
348 | locking rules: | 348 | locking rules: |
349 | file_lock_lock may block | 349 | file_lock_lock may block |
350 | fl_compare_owner: yes no | 350 | lm_compare_owner: yes no |
351 | fl_notify: yes no | 351 | lm_notify: yes no |
352 | fl_grant: no no | 352 | lm_grant: no no |
353 | fl_release_private: maybe no | 353 | lm_release_private: maybe no |
354 | fl_break: yes no | 354 | lm_break: yes no |
355 | fl_change yes no | 355 | lm_change yes no |
356 | 356 | ||
357 | --------------------------- buffer_head ----------------------------------- | 357 | --------------------------- buffer_head ----------------------------------- |
358 | prototypes: | 358 | prototypes: |
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, | |
77 | Note that there is no debugfs_create_x64(). | 77 | struct dentry *parent, u64 *value); |
78 | 78 | ||
79 | These functions are useful as long as the developer knows the size of the | 79 | These functions are useful as long as the developer knows the size of the |
80 | value to be exported. Some types can have different widths on different | 80 | value 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 | ||
150 | bh (*) ext3 associates buffer heads to data pages to | ||
151 | nobh (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 | |||
159 | Specification | 150 | Specification |
160 | ============= | 151 | ============= |
161 | Ext3 shares all disk implementation with the ext2 filesystem, and adds | 152 | Ext3 shares all disk implementation with the ext2 filesystem, and adds |
@@ -227,5 +218,5 @@ kernel source: <file:fs/ext3/> | |||
227 | programs: http://e2fsprogs.sourceforge.net/ | 218 | programs: http://e2fsprogs.sourceforge.net/ |
228 | http://ext2resize.sourceforge.net | 219 | http://ext2resize.sourceforge.net |
229 | 220 | ||
230 | useful links: http://www.ibm.com/developerworks/library/l-fs7.html | 221 | useful 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 | ||
78 | 2. Features | 78 | 2. 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 | ||
275 | bh (*) ext4 associates buffer heads to data pages to | ||
276 | nobh (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 | |||
283 | stripe=n Number of filesystem blocks that mballoc will try | 275 | stripe=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 | |||
69 | implementation: | 59 | implementation: |
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 | ||
75 | The table below, taken from the NFSv4.1 document, lists | 66 | The table below, taken from the NFSv4.1 document, lists |
76 | the operations that are mandatory to implement (REQ), optional | 67 | the 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 | |
101 | NS | BACKCHANNEL_CTL | REQ | | Section 18.33 | | 92 | NS | BACKCHANNEL_CTL | REQ | | Section 18.33 | |
102 | NS | BIND_CONN_TO_SESSION | REQ | | Section 18.34 | | 93 | I | 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 | | |||
111 | NS | DESTROY_CLIENTID | REQ | | Section 18.50 | | 102 | NS | DESTROY_CLIENTID | REQ | | Section 18.50 | |
112 | I | DESTROY_SESSION | REQ | | Section 18.37 | | 103 | I | DESTROY_SESSION | REQ | | Section 18.37 | |
113 | I | EXCHANGE_ID | REQ | | Section 18.35 | | 104 | I | EXCHANGE_ID | REQ | | Section 18.35 | |
114 | NS | FREE_STATEID | REQ | | Section 18.38 | | 105 | I | FREE_STATEID | REQ | | Section 18.38 | |
115 | | GETATTR | REQ | | Section 18.7 | | 106 | | GETATTR | REQ | | Section 18.7 | |
116 | P | GETDEVICEINFO | OPT | pNFS (REQ) | Section 18.40 | | 107 | P | GETDEVICEINFO | OPT | pNFS (REQ) | Section 18.40 | |
117 | P | GETDEVICELIST | OPT | pNFS (OPT) | Section 18.41 | | 108 | P | 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 | |
148 | NS | SECINFO_NO_NAME | REC | pNFS files | Section 18.45, | | 139 | I | SECINFO_NO_NAME | REC | pNFS files | Section 18.45, | |
149 | | | | layout (REQ) | Section 13.12 | | 140 | | | | layout (REQ) | Section 13.12 | |
150 | I | SEQUENCE | REQ | | Section 18.46 | | 141 | I | 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 | |
154 | NS | SET_SSV | REQ | | Section 18.47 | | 145 | NS | SET_SSV | REQ | | Section 18.47 | |
155 | NS | TEST_STATEID | REQ | | Section 18.48 | | 146 | I | TEST_STATEID | REQ | | Section 18.48 | |
156 | | VERIFY | REQ | | Section 18.31 | | 147 | | VERIFY | REQ | | Section 18.31 | |
157 | NS*| WANT_DELEGATION | OPT | FDELG (OPT) | Section 18.49 | | 148 | NS*| 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: | |||
206 | SEQUENCE: | 197 | SEQUENCE: |
207 | * no support for dynamic slot table renegotiation (optional) | 198 | * no support for dynamic slot table renegotiation (optional) |
208 | 199 | ||
209 | nfsv4.1 COMPOUND rules: | ||
210 | The 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 | |||
215 | Nonstandard compound limitations: | 200 | Nonstandard 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 | |||
208 | See 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 |
411 | argument; instead of passing IPERM_FLAG_RCU we add MAY_NOT_BLOCK into mask. | 411 | argument; 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 |
413 | non-NULL to be used for that inode, put it into ->i_op->check_acl. | 413 | has been taken to VFS and filesystems need to provide a non-NULL ->i_op->get_acl |
414 | to 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 | ||
4 | Squashfs is a compressed read-only filesystem for Linux. | 4 | Squashfs is a compressed read-only filesystem for Linux. |
5 | It uses zlib/lzo compression to compress files, inodes and directories. | 5 | It uses zlib/lzo/xz compression to compress files, inodes and directories. |
6 | Inodes in the system are very small and all blocks are packed to minimise | 6 | Inodes in the system are very small and all blocks are packed to minimise |
7 | data overhead. Block sizes greater than 4K are supported up to a maximum | 7 | data overhead. Block sizes greater than 4K are supported up to a maximum |
8 | of 1Mbytes (default block size 128K). | 8 | of 1Mbytes (default block size 128K). |
@@ -55,6 +55,8 @@ create populated squashfs filesystems. This and other squashfs utilities | |||
55 | can be obtained from http://www.squashfs.org. Usage instructions can be | 55 | can be obtained from http://www.squashfs.org. Usage instructions can be |
56 | obtained from this site also. | 56 | obtained from this site also. |
57 | 57 | ||
58 | The squashfs-tools development tree is now located on kernel.org | ||
59 | git://git.kernel.org/pub/scm/fs/squashfs/squashfs-tools.git | ||
58 | 60 | ||
59 | 3. SQUASHFS FILESYSTEM DESIGN | 61 | 3. 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. | |||
76 | These chips are 'Super I/O chips', supporting floppy disks, infrared ports, | 76 | These chips are 'Super I/O chips', supporting floppy disks, infrared ports, |
77 | joysticks and other miscellaneous stuff. For hardware monitoring, they | 77 | joysticks and other miscellaneous stuff. For hardware monitoring, they |
78 | include an 'environment controller' with 3 temperature sensors, 3 fan | 78 | include an 'environment controller' with 3 temperature sensors, 3 fan |
79 | rotation speed sensors, 8 voltage sensors, and associated alarms. | 79 | rotation speed sensors, 8 voltage sensors, associated alarms, and chassis |
80 | intrusion detection. | ||
80 | 81 | ||
81 | The IT8712F and IT8716F additionally feature VID inputs, used to report | 82 | The IT8712F and IT8716F additionally feature VID inputs, used to report |
82 | the Vcore voltage of the processor. The early IT8712F have 5 VID pins, | 83 | the 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 | ||
16 | Author: Frodo Looijaard <frodol@dds.nl> | 16 | Authors: Frodo Looijaard <frodol@dds.nl> |
17 | Jean Delvare <khali@linux-fr.org> | ||
17 | 18 | ||
18 | Description | 19 | Description |
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 @@ | |||
1 | Kernel driver sch5636 | ||
2 | ===================== | ||
3 | |||
4 | Supported chips: | ||
5 | * SMSC SCH5636 | ||
6 | Prefix: 'sch5636' | ||
7 | Addresses scanned: none, address read from Super I/O config space | ||
8 | |||
9 | Author: Hans de Goede <hdegoede@redhat.com> | ||
10 | |||
11 | |||
12 | Description | ||
13 | ----------- | ||
14 | |||
15 | SMSC SCH5636 Super I/O chips include an embedded microcontroller for | ||
16 | hardware monitoring solutions, allowing motherboard manufacturers to create | ||
17 | their own custom hwmon solution based upon the SCH5636. | ||
18 | |||
19 | Currently the sch5636 driver only supports the Fujitsu Theseus SCH5636 based | ||
20 | hwmon solution. The sch5636 driver runs a sanity check on loading to ensure | ||
21 | it is dealing with a Fujitsu Theseus and not with another custom SCH5636 based | ||
22 | hwmon solution. | ||
23 | |||
24 | The Fujitsu Theseus can monitor up to 5 voltages, 8 fans and 16 | ||
25 | temperatures. Note that the driver detects how many fan headers / | ||
26 | temperature sensors are actually implemented on the motherboard, so you will | ||
27 | likely see fewer temperature and fan inputs. | ||
28 | |||
29 | An application note describing the Theseus' registers, as well as an | ||
30 | application note describing the protocol for communicating with the | ||
31 | microcontroller 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 | ||
113 | VI. Settting Parameters | 113 | VI. 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> |
302 | 0xAE all linux/kvm.h Kernel-based Virtual Machine | 302 | 0xAE all linux/kvm.h Kernel-based Virtual Machine |
303 | <mailto:kvm@vger.kernel.org> | 303 | <mailto:kvm@vger.kernel.org> |
304 | 0xAF 00-1F linux/fsl_hypervisor.h Freescale hypervisor | ||
304 | 0xB0 all RATIO devices in development: | 305 | 0xB0 all RATIO devices in development: |
305 | <mailto:vgo@ratio.de> | 306 | <mailto:vgo@ratio.de> |
306 | 0xB1 00-1F PPPoX <mailto:mostrows@styx.uwaterloo.ca> | 307 | 0xB1 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 |
508 | 2. Install the new kernel | 508 | 2. 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 | |||
11 | fork. So if you have any comments or updates of this file, please try | 11 | fork. So if you have any comments or updates of this file, please try |
12 | to update the original English file first. | 12 | to update the original English file first. |
13 | 13 | ||
14 | Last Updated: 2007/10/24 | 14 | Last Updated: 2011/06/09 |
15 | |||
15 | ================================== | 16 | ================================== |
16 | これは、 | 17 | これは、 |
17 | linux-2.6.23/Documentation/SubmittingPatches の和訳 | 18 | linux-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: | |||
97 | http://savannah.nongnu.org/projects/quilt | 99 | http://savannah.nongnu.org/projects/quilt |
98 | 100 | ||
99 | Andrew Morton's patch scripts: | 101 | Andrew Morton's patch scripts: |
100 | http://userweb.kernel.org/~akpm/stuff/tpp.txt | 102 | http://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 | |||
115 | 3) パッチの分割 | 133 | 3) パッチの分割 |
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 の再転送モード) |
213 | EMAIL: <trivial@kernel.org> | ||
214 | 231 | ||
215 | 7) MIME やリンクや圧縮ファイルや添付ファイルではなくプレインテキストのみ | 232 | 7) 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 ---- | ||
239 | Content-Type: text/plain; charset=us-ascii; format=flowed | ||
240 | ---- message header ---- | ||
241 | 問題は、「 format=flowed 」が付いた電子メールを特定の受信側の電子メール | ||
242 | クライアントがタブをスペースに置き換えるというような変更をすることです。 | ||
243 | したがって送られてきたパッチは壊れているように見えるでしょう。 | ||
244 | |||
245 | これを修正するには、mozilla の defaults/pref/mailnews.js ファイルを | ||
246 | 以下のように修正します。 | ||
247 | pref("mailnews.send_plaintext_flowed", false); // RFC 2646======= | ||
248 | pref("mailnews.display.disable_format_flowed_support", true); | ||
249 | 255 | ||
250 | 8) 電子メールのサイズ | 256 | 8) 電子メールのサイズ |
251 | 257 | ||
252 | パッチを Linus へ送るときは常に #7 の手順に従ってください。 | 258 | パッチを Linus へ送るときは常に #7 の手順に従ってください。 |
253 | 259 | ||
254 | 大きなパッチはメーリングリストやメンテナにとって不親切です。パッチが | 260 | 大きなパッチはメーリングリストやメンテナにとって不親切です。パッチが |
255 | 未圧縮で 40KB を超えるようであるなら、インターネット上のアクセス可能な | 261 | 未圧縮で 300KB を超えるようであるなら、インターネット上のアクセス可能な |
256 | サーバに保存し、保存場所を示す URL を伝えるほうが適切です。 | 262 | サーバに保存し、保存場所を示す URL を伝えるほうが適切です。 |
257 | 263 | ||
258 | 9) カーネルバージョンの明記 | 264 | 9) カーネルバージョンの明記 |
@@ -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 | ||
343 | 13) いつ Acked-by: を使うのか | 349 | あなたがサブシステムまたはブランチのメンテナであれば、受け取ったパッチを自身の |
350 | ツリーにマージするために、わずかに変更が必要となる場合があります。なぜなら | ||
351 | あなたのツリーの中のコードと投稿者のツリーの中のコードは同一ではないためです。 | ||
352 | もし、あなたが厳密に上記ルール(c)にこだわるのであれば、投稿者に再度差分を | ||
353 | とるよう依頼すべきです。しかし、これは時間とエネルギーを非生産的に浪費する | ||
354 | ことになります。ルール(b)はあなたにコードを修正する権利を与えてくれます。 | ||
355 | しかし、投稿者のコードを修正し、その修正によるバグを投稿者に押し付けてしまう | ||
356 | ことはとても失礼なことです。この問題を解決するために、末尾の投稿者の | ||
357 | Signed-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 | |||
393 | 13) いつ Acked-by: と Cc: を使うのか | ||
344 | 394 | ||
345 | 「 Signed-off-by: 」タグはその署名者がパッチの開発に関わっていたことやパッチ | 395 | 「 Signed-off-by: 」タグはその署名者がパッチの開発に関わっていたことやパッチ |
346 | の伝播パスにいたことを示しています。 | 396 | の伝播パスにいたことを示しています。 |
@@ -354,7 +404,7 @@ Linus や LKML への大量の電子メールのために、サブジェクト | |||
354 | 404 | ||
355 | Acked-by: は Signed-off-by: のように公式なタグではありません。それはメンテナが | 405 | Acked-by: は Signed-off-by: のように公式なタグではありません。それはメンテナが |
356 | 少なくともパッチをレビューし、同意を示しているという記録です。そのような | 406 | 少なくともパッチをレビューし、同意を示しているという記録です。そのような |
357 | ことからパッチ統合者がメンテナの「うん、良いと思うよ」という発言を | 407 | ことからパッチマージ人メンテナの「うん、良いと思うよ」という発言を |
358 | Acked-by: へ置き換えることがあります。 | 408 | Acked-by: へ置き換えることがあります。 |
359 | 409 | ||
360 | Acked-by: が必ずしもパッチ全体の承認を示しているわけではありません。例えば、 | 410 | Acked-by: が必ずしもパッチ全体の承認を示しているわけではありません。例えば、 |
@@ -364,7 +414,62 @@ Acked-by: が必ずしもパッチ全体の承認を示しているわけでは | |||
364 | この点は、ご自分で判断してください。(その Acked-by: が)疑わしい場合は、 | 414 | この点は、ご自分で判断してください。(その Acked-by: が)疑わしい場合は、 |
365 | メーリングリストアーカイブの中の大元の議論を参照すべきです。 | 415 | メーリングリストアーカイブの中の大元の議論を参照すべきです。 |
366 | 416 | ||
367 | 14) 標準的なパッチのフォーマット | 417 | パッチにコメントする機会を持っていたが、その時にコメントしなかった人がいれば、 |
418 | その人を指す「Cc:」タグを任意で追加してもかまいません。これは指定された人からの | ||
419 | 明確なアクションなしに付与できる唯一のタグです。 | ||
420 | このタグはパッチに関心があると思われる人達がそのパッチの議論に含まれていたこと | ||
421 | を明文化します。 | ||
422 | |||
423 | 14) Reported-by と Tested-by: と Reviewed-by: の利用 | ||
424 | |||
425 | 他の誰かによって報告された問題を修正するパッチであれば、問題報告者という寄与を | ||
426 | クレジットするために、Reported-by: タグを追加することを検討してください。 | ||
427 | こまめにバグ報告者をクレジットしていくことで、うまくいけばその人たちが将来再び | ||
428 | コミュニティの力となってくれるでしょう。 | ||
429 | ただし、報告者の許可無くこのタグを追加しないように注意してください。特に、 | ||
430 | 問題が公の場で報告されていなかったのであれば。 | ||
431 | |||
432 | Tested-by: タグはタグで指定された人によって(ある環境下で)パッチのテストに成功 | ||
433 | していることを示します。このタグはメンテナにテストが実施済みであることを | ||
434 | 知らせ、将来の関連パッチのテスト協力者を見つける方法を提供し、テスト実施者に | ||
435 | 対するクレジットを保証します。 | ||
436 | |||
437 | Reviewed-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 | |||
464 | Reviewd-by タグはそのパッチがカーネルに対して適切な修正であって、深刻な技術的 | ||
465 | 問題を残していないという意見の宣言です。興味のあるレビューアは誰でも(レビュー | ||
466 | 作業を終えたら)パッチに対して Reviewed-by タグを提示できます。このタグは | ||
467 | レビューアの寄与をクレジットする働き、レビューの進捗の度合いをメンテナに | ||
468 | 知らせる働きを持ちます。そのパッチの領域に詳しく、そして、しっかりとした | ||
469 | レビューを実施したレビューアによって提供される時、Reviewed-by: タグがあなたの | ||
470 | パッチをカーネルにマージする可能性を高めるでしょう。 | ||
471 | |||
472 | 15) 標準的なパッチのフォーマット | ||
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 で |
410 | google で検索したがるでしょう。 | 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 | ||
580 | 16) 「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 | |||
600 | diffstat の結果を生成するために「 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 | ||
554 | Linus Torvalds's mail on the canonical patch format: | 715 | Linus 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 | |||
718 | Andi 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 | |||
802 | is not sufficient this sometimes needs to be explicit. | 802 | is 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 | ||
808 | The above assignment instructs kbuild to descend down in the | 808 | The above assignment instructs kbuild to descend down in the |
@@ -812,12 +812,12 @@ To support the clean infrastructure in the Makefiles that builds the | |||
812 | final bootimage there is an optional target named archclean: | 812 | final 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 | ||
819 | When "make clean" is executed, make will descend down in arch/i386/boot, | 819 | When "make clean" is executed, make will descend down in arch/x86/boot, |
820 | and clean as usual. The Makefile located in arch/i386/boot/ may use | 820 | and clean as usual. The Makefile located in arch/x86/boot/ may use |
821 | the subdir- trick to descend further down. | 821 | the subdir- trick to descend further down. |
822 | 822 | ||
823 | Note 1: arch/$(ARCH)/Makefile cannot use "subdir-", because that file is | 823 | Note 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 | |||
66 | RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h | 66 | RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h |
67 | SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h | 67 | SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h |
68 | HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c | 68 | HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c |
69 | APM_BIOS_MAGIC 0x4101 apm_user arch/i386/kernel/apm.c | 69 | APM_BIOS_MAGIC 0x4101 apm_user arch/x86/kernel/apm_32.c |
70 | CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h | 70 | CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h |
71 | DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c | 71 | DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c |
72 | DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c | 72 | DL_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 | ||
12 | The ideal MCA adapter detection is done through the use of the | 12 | The ideal MCA adapter detection is done through the use of the |
13 | Programmable Option Select registers. Generic functions for doing | 13 | Programmable Option Select registers. Generic functions for doing |
14 | this have been added in include/linux/mca.h and arch/i386/kernel/mca.c. | 14 | this have been added in include/linux/mca.h and arch/x86/kernel/mca_32.c. |
15 | Everything needed to detect adapters and read (and write) configuration | 15 | Everything needed to detect adapters and read (and write) configuration |
16 | information is there. A number of MCA-specific drivers already use | 16 | information is there. A number of MCA-specific drivers already use |
17 | this. The typical probe code looks like the following: | 17 | this. The typical probe code looks like the following: |
@@ -81,7 +81,7 @@ more people use shared IRQs on PCI machines. | |||
81 | In general, an interrupt must be acknowledged not only at the ICU (which | 81 | In general, an interrupt must be acknowledged not only at the ICU (which |
82 | is done automagically by the kernel), but at the device level. In | 82 | is done automagically by the kernel), but at the device level. In |
83 | particular, IRQ 0 must be reset after a timer interrupt (now done in | 83 | particular, IRQ 0 must be reset after a timer interrupt (now done in |
84 | arch/i386/kernel/time.c) or the first timer interrupt hangs the system. | 84 | arch/x86/kernel/time.c) or the first timer interrupt hangs the system. |
85 | There were also problems with the 1.3.x floppy drivers, but that seems | 85 | There were also problems with the 1.3.x floppy drivers, but that seems |
86 | to have been fixed. | 86 | to 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 | ||
69 | arch/i386/kernel/process.c has examples of both polling and | 69 | arch/x86/kernel/process.c has examples of both polling and |
70 | sleeping idle functions. | 70 | sleeping 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 | ||
556 | Then install "arch/i386/boot/zImage" as your standard kernel, run lilo if | 556 | Then install "arch/x86/boot/zImage" as your standard kernel, run lilo if |
557 | appropriate, and reboot. | 557 | appropriate, 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) |
89 | d) Run "make zImage" or whatever target you prefer. | 89 | d) Run "make zImage" or whatever target you prefer. |
90 | e) mv /usr/src/linux/arch/i386/boot/zImage to /boot. | 90 | e) mv /usr/src/linux/arch/x86/boot/zImage to /boot. |
91 | f) Add new config for this kernel into /etc/lilo.conf, run "lilo" | 91 | f) 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. |
93 | g) Reboot using this kernel | 93 | g) 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 | ||
522 | shm_rmid_forced: | ||
523 | |||
524 | Linux lets you set resource limits, including how much memory one | ||
525 | process can consume, via setrlimit(2). Unfortunately, shared memory | ||
526 | segments are allowed to exist without association with any process, and | ||
527 | thus might not be counted against any resource limits. If enabled, | ||
528 | shared memory segments are automatically destroyed when their attach | ||
529 | count becomes zero after a detach or a process termination. It will | ||
530 | also destroy segments that were created, but never attached to, on exit | ||
531 | from the process. The only use left for IPC_RMID is to immediately | ||
532 | destroy an unattached segment. Of course, this breaks the way things are | ||
533 | defined, so some applications might stop working. Note that this | ||
534 | feature will do you no good unless you also configure your resource | ||
535 | limits (in particular, RLIMIT_AS and RLIMIT_NPROC). Most systems don't | ||
536 | need this. | ||
537 | |||
538 | Note that if you change this from 0 to 1, already created segments | ||
539 | without users and with a dead originative process will be destroyed. | ||
540 | |||
541 | ============================================================== | ||
542 | |||
521 | softlockup_thresh: | 543 | softlockup_thresh: |
522 | 544 | ||
523 | This value can be used to lower the softlockup tolerance threshold. The | 545 | This 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 | |||
210 | transfers are fully scheduled, so the main issue is likely to be how | 210 | transfers are fully scheduled, so the main issue is likely to be how |
211 | to trigger "high bandwidth" modes. | 211 | to trigger "high bandwidth" modes. |
212 | 212 | ||
213 | TBD: More than standard 80% periodic bandwidth allocation is possible | ||
214 | through 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 | 1 | Chinese translated version of Documentation/email-clients.txt |
2 | 2 | ||
3 | If you have any comment or update to the content, please contact the | 3 | If you have any comment or update to the content, please contact the |
4 | original document maintainer directly. However, if you have a problem | 4 | original document maintainer directly. However, if you have a problem |
@@ -8,203 +8,203 @@ or if there is a problem with the translation. | |||
8 | 8 | ||
9 | Chinese maintainer: Harry Wei <harryxiyou@gmail.com> | 9 | Chinese maintainer: Harry Wei <harryxiyou@gmail.com> |
10 | --------------------------------------------------------------------- | 10 | --------------------------------------------------------------------- |
11 | Documentation/email-clients.txt ???涓?????? | 11 | Documentation/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 | ||
26 | Linux???跺????????℃?? | 26 | Linux邮件客端信 |
27 | ====================================================================== | 27 | ====================================================================== |
28 | 28 | ||
29 | ?????????? | 29 | 普通配 |
30 | ---------------------------------------------------------------------- | 30 | ---------------------------------------------------------------------- |
31 | Linux?????歌ˉ涓???????杩????浠惰?????浜ょ??锛????濂芥??琛ヤ??浣?涓洪??浠朵????????宓?????????????浜?缁存?よ?? | 31 | Linux内核补丁是通过邮件被提交的,最好把补丁作为邮件体的内嵌文本。有些维护者 |
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??浣????????浜??????????????????????棰???? | 43 | 如你UTF-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 | 说: |
64 | TUI = ユ??????虹???????ㄦ???? | 64 | TUI = 以为础户口 |
65 | GUI = ??惧舰??????ㄦ???? | 65 | GUI = 图界户口 |
66 | 66 | ||
67 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 67 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
68 | Alpine (TUI) | 68 | Alpine (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 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
80 | Evolution (GUI) | 80 | Evolution (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 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
93 | Kmail (GUI) | 93 | Kmail (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 | 当从GPG中取7位码会使他们的复。 |
111 | 111 | ||
112 | 濡????浣????瑕?浠ラ??浠剁??褰㈠????????琛ヤ??锛???d??灏卞?抽????瑰?婚??浠讹????跺?????涓?灞???э??绐????"Suggest automatic | 112 | 如果你非要以附件的形式发送补丁,那么就右键点击附件,然后选中属性,突出"Suggest automatic |
113 | display"锛??????????舵?村???璁╄?????????? | 113 | display",这件容读者看。 |
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 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
122 | Lotus Notes (GUI) | 122 | Lotus Notes (GUI) |
123 | 123 | ||
124 | 涓?瑕?浣?????? | 124 | 不使它 |
125 | 125 | ||
126 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 126 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
127 | Mutt (TUI) | 127 | Mutt (TUI) |
128 | 128 | ||
129 | ??Linux????浜??浣??mutt瀹㈡?风??锛????ヨ?????????瀹??????????????? | 129 | 多Linux人员使mutt客,以证明它工的非常漂亮。 |
130 | 130 | ||
131 | Mutt涓????甯?缂?杈????锛????浠ヤ??绠′??浣跨?ㄤ??涔?缂?杈???ㄩ?戒??搴?璇ュ甫????????ㄦ??琛????澶у????扮??杈???ㄩ?藉甫??? | 131 | Mutt不自带编辑器,所以不管你使用什么编辑器都不应该带有自动断行。大多数编辑器都带有 |
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 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
150 | Pine (TUI) | 150 | Pine (TUI) |
151 | 151 | ||
152 | Pine杩?????????????????锛?浣????杩????板???璇???淇?澶?浜???? | 152 | Pine过一些格删减问题但这些现应被修了 |
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 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
162 | Sylpheed (GUI) | 162 | Sylpheed (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 | - ?????????娣诲??????灏??浼?g??????????? | 169 | - 地中就不会的显示名 |
170 | 170 | ||
171 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 171 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
172 | Thunderbird (GUI) | 172 | Thunderbird (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 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
195 | TkRat (GUI) | 195 | TkRat (GUI) |
196 | 196 | ||
197 | ???浠ヤ???????浣??"Insert file..."????????????杈????? | 197 | 以使它使"Insert file..."者外部辑器 |
198 | 198 | ||
199 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 199 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
200 | Gmail (Web GUI) | 200 | Gmail (Web GUI) |
201 | 201 | ||
202 | 涓??浣?????????琛????? | 202 | 不要使它送丁 |
203 | 203 | ||
204 | Gmail?椤??风???????ㄥ?版????〃?????┖??笺?? | 204 | Gmail客自动地转换空格。 |
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 | |||
66 | RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h | 66 | RISCOM8_MAGIC 0x0907 riscom_port drivers/char/riscom8.h |
67 | SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h | 67 | SPECIALIX_MAGIC 0x0907 specialix_port drivers/char/specialix_io8.h |
68 | HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c | 68 | HDLC_MAGIC 0x239e n_hdlc drivers/char/n_hdlc.c |
69 | APM_BIOS_MAGIC 0x4101 apm_user arch/i386/kernel/apm.c | 69 | APM_BIOS_MAGIC 0x4101 apm_user arch/x86/kernel/apm_32.c |
70 | CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h | 70 | CYCLADES_MAGIC 0x4359 cyclades_port include/linux/cyclades.h |
71 | DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c | 71 | DB_MAGIC 0x4442 fc_info drivers/net/iph5526_novram.c |
72 | DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c | 72 | DL_MAGIC 0x444d fc_info drivers/net/iph5526_novram.c |