diff options
author | Linus Torvalds <torvalds@linux-foundation.org> | 2012-10-05 14:09:16 -0400 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2012-10-05 14:09:16 -0400 |
commit | 11126c611e10abb18b6f1ed0300c0548c3906b54 (patch) | |
tree | 246227ad730c1e68f5a9c03db57cd4592abe7687 /Documentation | |
parent | 67966e088b0c7dc926f4ce19565ebf208e18d058 (diff) | |
parent | 33e2a4227ddff7c18921ac175fae3ab0e3ff8a76 (diff) |
Merge branch 'akpm' (Andrew's patch-bomb)
Merge misc patches from Andrew Morton:
"The MM tree is rather stuck while I wait to find out what the heck is
happening with sched/numa. Probably I'll need to route around all the
code which was added to -next, sigh.
So this is "everything else", or at least most of it - other small
bits are still awaiting resolutions of various kinds."
* emailed patches from Andrew Morton <akpm@linux-foundation.org>: (180 commits)
lib/decompress.c add __init to decompress_method and data
kernel/resource.c: fix stack overflow in __reserve_region_with_split()
omfs: convert to use beXX_add_cpu()
taskstats: cgroupstats_user_cmd() may leak on error
aoe: update aoe-internal version number to 50
aoe: update documentation to better reflect aoe-plus-udev usage
aoe: remove unused code
aoe: make dynamic block minor numbers the default
aoe: update and specify AoE address guards and error messages
aoe: retain static block device numbers for backwards compatibility
aoe: support more AoE addresses with dynamic block device minor numbers
aoe: update documentation with new URL and VM settings reference
aoe: update copyright year in touched files
aoe: update internal version number to 49
aoe: remove unused code and add cosmetic improvements
aoe: increase net_device reference count while using it
aoe: associate frames with the AoE storage target
aoe: disallow unsupported AoE minor addresses
aoe: do revalidation steps in order
aoe: failover remote interface based on aoe_deadsecs parameter
...
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/CodingStyle | 10 | ||||
-rw-r--r-- | Documentation/aoe/aoe.txt | 58 | ||||
-rw-r--r-- | Documentation/aoe/mkdevs.sh | 41 | ||||
-rw-r--r-- | Documentation/aoe/mkshelf.sh | 28 | ||||
-rw-r--r-- | Documentation/aoe/status.sh | 3 | ||||
-rw-r--r-- | Documentation/devicetree/bindings/crypto/fsl-sec4.txt | 51 | ||||
-rw-r--r-- | Documentation/devicetree/bindings/rtc/snvs-rtc.txt | 1 | ||||
-rw-r--r-- | Documentation/printk-formats.txt | 1 | ||||
-rw-r--r-- | Documentation/rtc.txt | 5 | ||||
-rw-r--r-- | Documentation/sysctl/kernel.txt | 2 |
10 files changed, 109 insertions, 91 deletions
diff --git a/Documentation/CodingStyle b/Documentation/CodingStyle index cb9258b8fd35..495e5ba1634c 100644 --- a/Documentation/CodingStyle +++ b/Documentation/CodingStyle | |||
@@ -454,6 +454,16 @@ The preferred style for long (multi-line) comments is: | |||
454 | * with beginning and ending almost-blank lines. | 454 | * with beginning and ending almost-blank lines. |
455 | */ | 455 | */ |
456 | 456 | ||
457 | For files in net/ and drivers/net/ the preferred style for long (multi-line) | ||
458 | comments is a little different. | ||
459 | |||
460 | /* The preferred comment style for files in net/ and drivers/net | ||
461 | * looks like this. | ||
462 | * | ||
463 | * It is nearly the same as the generally preferred comment style, | ||
464 | * but there is no initial almost-blank line. | ||
465 | */ | ||
466 | |||
457 | It's also important to comment data, whether they are basic types or derived | 467 | It's also important to comment data, whether they are basic types or derived |
458 | types. To this end, use just one data declaration per line (no commas for | 468 | types. To this end, use just one data declaration per line (no commas for |
459 | multiple data declarations). This leaves you room for a small comment on each | 469 | multiple data declarations). This leaves you room for a small comment on each |
diff --git a/Documentation/aoe/aoe.txt b/Documentation/aoe/aoe.txt index 5f5aa16047ff..bfc9cb19abcd 100644 --- a/Documentation/aoe/aoe.txt +++ b/Documentation/aoe/aoe.txt | |||
@@ -1,8 +1,16 @@ | |||
1 | The EtherDrive (R) HOWTO for users of 2.6 kernels is found at ... | 1 | ATA over Ethernet is a network protocol that provides simple access to |
2 | block storage on the LAN. | ||
2 | 3 | ||
3 | http://www.coraid.com/SUPPORT/EtherDrive-HBA | 4 | http://support.coraid.com/documents/AoEr11.txt |
4 | 5 | ||
5 | It has many tips and hints! | 6 | The EtherDrive (R) HOWTO for 2.6 and 3.x kernels is found at ... |
7 | |||
8 | http://support.coraid.com/support/linux/EtherDrive-2.6-HOWTO.html | ||
9 | |||
10 | It has many tips and hints! Please see, especially, recommended | ||
11 | tunings for virtual memory: | ||
12 | |||
13 | http://support.coraid.com/support/linux/EtherDrive-2.6-HOWTO-5.html#ss5.19 | ||
6 | 14 | ||
7 | The aoetools are userland programs that are designed to work with this | 15 | The aoetools are userland programs that are designed to work with this |
8 | driver. The aoetools are on sourceforge. | 16 | driver. The aoetools are on sourceforge. |
@@ -23,20 +31,12 @@ CREATING DEVICE NODES | |||
23 | There is a udev-install.sh script that shows how to install these | 31 | There is a udev-install.sh script that shows how to install these |
24 | rules on your system. | 32 | rules on your system. |
25 | 33 | ||
26 | If you are not using udev, two scripts are provided in | ||
27 | Documentation/aoe as examples of static device node creation for | ||
28 | using the aoe driver. | ||
29 | |||
30 | rm -rf /dev/etherd | ||
31 | sh Documentation/aoe/mkdevs.sh /dev/etherd | ||
32 | |||
33 | ... or to make just one shelf's worth of block device nodes ... | ||
34 | |||
35 | sh Documentation/aoe/mkshelf.sh /dev/etherd 0 | ||
36 | |||
37 | There is also an autoload script that shows how to edit | 34 | There is also an autoload script that shows how to edit |
38 | /etc/modprobe.d/aoe.conf to ensure that the aoe module is loaded when | 35 | /etc/modprobe.d/aoe.conf to ensure that the aoe module is loaded when |
39 | necessary. | 36 | necessary. Preloading the aoe module is preferable to autoloading, |
37 | however, because AoE discovery takes a few seconds. It can be | ||
38 | confusing when an AoE device is not present the first time the a | ||
39 | command is run but appears a second later. | ||
40 | 40 | ||
41 | USING DEVICE NODES | 41 | USING DEVICE NODES |
42 | 42 | ||
@@ -51,9 +51,9 @@ USING DEVICE NODES | |||
51 | "echo > /dev/etherd/discover" tells the driver to find out what AoE | 51 | "echo > /dev/etherd/discover" tells the driver to find out what AoE |
52 | devices are available. | 52 | devices are available. |
53 | 53 | ||
54 | These character devices may disappear and be replaced by sysfs | 54 | In the future these character devices may disappear and be replaced |
55 | counterparts. Using the commands in aoetools insulates users from | 55 | by sysfs counterparts. Using the commands in aoetools insulates |
56 | these implementation details. | 56 | users from these implementation details. |
57 | 57 | ||
58 | The block devices are named like this: | 58 | The block devices are named like this: |
59 | 59 | ||
@@ -76,8 +76,8 @@ USING SYSFS | |||
76 | The netif attribute is the network interface on the localhost | 76 | The netif attribute is the network interface on the localhost |
77 | through which we are communicating with the remote AoE device. | 77 | through which we are communicating with the remote AoE device. |
78 | 78 | ||
79 | There is a script in this directory that formats this information | 79 | There is a script in this directory that formats this information in |
80 | in a convenient way. Users with aoetools can use the aoe-stat | 80 | a convenient way. Users with aoetools should use the aoe-stat |
81 | command. | 81 | command. |
82 | 82 | ||
83 | root@makki root# sh Documentation/aoe/status.sh | 83 | root@makki root# sh Documentation/aoe/status.sh |
@@ -121,3 +121,21 @@ DRIVER OPTIONS | |||
121 | usage example for the module parameter. | 121 | usage example for the module parameter. |
122 | 122 | ||
123 | modprobe aoe_iflist="eth1 eth3" | 123 | modprobe aoe_iflist="eth1 eth3" |
124 | |||
125 | The aoe_deadsecs module parameter determines the maximum number of | ||
126 | seconds that the driver will wait for an AoE device to provide a | ||
127 | response to an AoE command. After aoe_deadsecs seconds have | ||
128 | elapsed, the AoE device will be marked as "down". | ||
129 | |||
130 | The aoe_maxout module parameter has a default of 128. This is the | ||
131 | maximum number of unresponded packets that will be sent to an AoE | ||
132 | target at one time. | ||
133 | |||
134 | The aoe_dyndevs module parameter defaults to 1, meaning that the | ||
135 | driver will assign a block device minor number to a discovered AoE | ||
136 | target based on the order of its discovery. With dynamic minor | ||
137 | device numbers in use, a greater range of AoE shelf and slot | ||
138 | addresses can be supported. Users with udev will never have to | ||
139 | think about minor numbers. Using aoe_dyndevs=0 allows device nodes | ||
140 | to be pre-created using a static minor-number scheme with the | ||
141 | aoe-mkshelf script in the aoetools. | ||
diff --git a/Documentation/aoe/mkdevs.sh b/Documentation/aoe/mkdevs.sh deleted file mode 100644 index 44c0ab702432..000000000000 --- a/Documentation/aoe/mkdevs.sh +++ /dev/null | |||
@@ -1,41 +0,0 @@ | |||
1 | #!/bin/sh | ||
2 | |||
3 | n_shelves=${n_shelves:-10} | ||
4 | n_partitions=${n_partitions:-16} | ||
5 | |||
6 | if test "$#" != "1"; then | ||
7 | echo "Usage: sh `basename $0` {dir}" 1>&2 | ||
8 | echo " n_partitions=16 sh `basename $0` {dir}" 1>&2 | ||
9 | exit 1 | ||
10 | fi | ||
11 | dir=$1 | ||
12 | |||
13 | MAJOR=152 | ||
14 | |||
15 | echo "Creating AoE devnode files in $dir ..." | ||
16 | |||
17 | set -e | ||
18 | |||
19 | mkdir -p $dir | ||
20 | |||
21 | # (Status info is in sysfs. See status.sh.) | ||
22 | # rm -f $dir/stat | ||
23 | # mknod -m 0400 $dir/stat c $MAJOR 1 | ||
24 | rm -f $dir/err | ||
25 | mknod -m 0400 $dir/err c $MAJOR 2 | ||
26 | rm -f $dir/discover | ||
27 | mknod -m 0200 $dir/discover c $MAJOR 3 | ||
28 | rm -f $dir/interfaces | ||
29 | mknod -m 0200 $dir/interfaces c $MAJOR 4 | ||
30 | rm -f $dir/revalidate | ||
31 | mknod -m 0200 $dir/revalidate c $MAJOR 5 | ||
32 | rm -f $dir/flush | ||
33 | mknod -m 0200 $dir/flush c $MAJOR 6 | ||
34 | |||
35 | export n_partitions | ||
36 | mkshelf=`echo $0 | sed 's!mkdevs!mkshelf!'` | ||
37 | i=0 | ||
38 | while test $i -lt $n_shelves; do | ||
39 | sh -xc "sh $mkshelf $dir $i" | ||
40 | i=`expr $i + 1` | ||
41 | done | ||
diff --git a/Documentation/aoe/mkshelf.sh b/Documentation/aoe/mkshelf.sh deleted file mode 100644 index 32615814271c..000000000000 --- a/Documentation/aoe/mkshelf.sh +++ /dev/null | |||
@@ -1,28 +0,0 @@ | |||
1 | #! /bin/sh | ||
2 | |||
3 | if test "$#" != "2"; then | ||
4 | echo "Usage: sh `basename $0` {dir} {shelfaddress}" 1>&2 | ||
5 | echo " n_partitions=16 sh `basename $0` {dir} {shelfaddress}" 1>&2 | ||
6 | exit 1 | ||
7 | fi | ||
8 | n_partitions=${n_partitions:-16} | ||
9 | dir=$1 | ||
10 | shelf=$2 | ||
11 | nslots=16 | ||
12 | maxslot=`echo $nslots 1 - p | dc` | ||
13 | MAJOR=152 | ||
14 | |||
15 | set -e | ||
16 | |||
17 | minor=`echo $nslots \* $shelf \* $n_partitions | bc` | ||
18 | endp=`echo $n_partitions - 1 | bc` | ||
19 | for slot in `seq 0 $maxslot`; do | ||
20 | for part in `seq 0 $endp`; do | ||
21 | name=e$shelf.$slot | ||
22 | test "$part" != "0" && name=${name}p$part | ||
23 | rm -f $dir/$name | ||
24 | mknod -m 0660 $dir/$name b $MAJOR $minor | ||
25 | |||
26 | minor=`expr $minor + 1` | ||
27 | done | ||
28 | done | ||
diff --git a/Documentation/aoe/status.sh b/Documentation/aoe/status.sh index 751f3be514b8..eeec7baae57a 100644 --- a/Documentation/aoe/status.sh +++ b/Documentation/aoe/status.sh | |||
@@ -1,5 +1,8 @@ | |||
1 | #! /bin/sh | 1 | #! /bin/sh |
2 | # collate and present sysfs information about AoE storage | 2 | # collate and present sysfs information about AoE storage |
3 | # | ||
4 | # A more complete version of this script is aoe-stat, in the | ||
5 | # aoetools. | ||
3 | 6 | ||
4 | set -e | 7 | set -e |
5 | format="%8s\t%8s\t%8s\n" | 8 | format="%8s\t%8s\t%8s\n" |
diff --git a/Documentation/devicetree/bindings/crypto/fsl-sec4.txt b/Documentation/devicetree/bindings/crypto/fsl-sec4.txt index bf57ecd5d73a..bd7ce120bc13 100644 --- a/Documentation/devicetree/bindings/crypto/fsl-sec4.txt +++ b/Documentation/devicetree/bindings/crypto/fsl-sec4.txt | |||
@@ -9,6 +9,7 @@ Copyright (C) 2008-2011 Freescale Semiconductor Inc. | |||
9 | -Run Time Integrity Check (RTIC) Node | 9 | -Run Time Integrity Check (RTIC) Node |
10 | -Run Time Integrity Check (RTIC) Memory Node | 10 | -Run Time Integrity Check (RTIC) Memory Node |
11 | -Secure Non-Volatile Storage (SNVS) Node | 11 | -Secure Non-Volatile Storage (SNVS) Node |
12 | -Secure Non-Volatile Storage (SNVS) Low Power (LP) RTC Node | ||
12 | -Full Example | 13 | -Full Example |
13 | 14 | ||
14 | NOTE: the SEC 4 is also known as Freescale's Cryptographic Accelerator | 15 | NOTE: the SEC 4 is also known as Freescale's Cryptographic Accelerator |
@@ -294,6 +295,27 @@ Secure Non-Volatile Storage (SNVS) Node | |||
294 | address and length of the SEC4 configuration | 295 | address and length of the SEC4 configuration |
295 | registers. | 296 | registers. |
296 | 297 | ||
298 | - #address-cells | ||
299 | Usage: required | ||
300 | Value type: <u32> | ||
301 | Definition: A standard property. Defines the number of cells | ||
302 | for representing physical addresses in child nodes. Must | ||
303 | have a value of 1. | ||
304 | |||
305 | - #size-cells | ||
306 | Usage: required | ||
307 | Value type: <u32> | ||
308 | Definition: A standard property. Defines the number of cells | ||
309 | for representing the size of physical addresses in | ||
310 | child nodes. Must have a value of 1. | ||
311 | |||
312 | - ranges | ||
313 | Usage: required | ||
314 | Value type: <prop-encoded-array> | ||
315 | Definition: A standard property. Specifies the physical address | ||
316 | range of the SNVS register space. A triplet that includes | ||
317 | the child address, parent address, & length. | ||
318 | |||
297 | - interrupts | 319 | - interrupts |
298 | Usage: required | 320 | Usage: required |
299 | Value type: <prop_encoded-array> | 321 | Value type: <prop_encoded-array> |
@@ -314,11 +336,34 @@ EXAMPLE | |||
314 | sec_mon@314000 { | 336 | sec_mon@314000 { |
315 | compatible = "fsl,sec-v4.0-mon"; | 337 | compatible = "fsl,sec-v4.0-mon"; |
316 | reg = <0x314000 0x1000>; | 338 | reg = <0x314000 0x1000>; |
339 | ranges = <0 0x314000 0x1000>; | ||
317 | interrupt-parent = <&mpic>; | 340 | interrupt-parent = <&mpic>; |
318 | interrupts = <93 2>; | 341 | interrupts = <93 2>; |
319 | }; | 342 | }; |
320 | 343 | ||
321 | ===================================================================== | 344 | ===================================================================== |
345 | Secure Non-Volatile Storage (SNVS) Low Power (LP) RTC Node | ||
346 | |||
347 | A SNVS child node that defines SNVS LP RTC. | ||
348 | |||
349 | - compatible | ||
350 | Usage: required | ||
351 | Value type: <string> | ||
352 | Definition: Must include "fsl,sec-v4.0-mon-rtc-lp". | ||
353 | |||
354 | - reg | ||
355 | Usage: required | ||
356 | Value type: <prop-encoded-array> | ||
357 | Definition: A standard property. Specifies the physical | ||
358 | address and length of the SNVS LP configuration registers. | ||
359 | |||
360 | EXAMPLE | ||
361 | sec_mon_rtc_lp@314000 { | ||
362 | compatible = "fsl,sec-v4.0-mon-rtc-lp"; | ||
363 | reg = <0x34 0x58>; | ||
364 | }; | ||
365 | |||
366 | ===================================================================== | ||
322 | FULL EXAMPLE | 367 | FULL EXAMPLE |
323 | 368 | ||
324 | crypto: crypto@300000 { | 369 | crypto: crypto@300000 { |
@@ -390,8 +435,14 @@ FULL EXAMPLE | |||
390 | sec_mon: sec_mon@314000 { | 435 | sec_mon: sec_mon@314000 { |
391 | compatible = "fsl,sec-v4.0-mon"; | 436 | compatible = "fsl,sec-v4.0-mon"; |
392 | reg = <0x314000 0x1000>; | 437 | reg = <0x314000 0x1000>; |
438 | ranges = <0 0x314000 0x1000>; | ||
393 | interrupt-parent = <&mpic>; | 439 | interrupt-parent = <&mpic>; |
394 | interrupts = <93 2>; | 440 | interrupts = <93 2>; |
441 | |||
442 | sec_mon_rtc_lp@34 { | ||
443 | compatible = "fsl,sec-v4.0-mon-rtc-lp"; | ||
444 | reg = <0x34 0x58>; | ||
445 | }; | ||
395 | }; | 446 | }; |
396 | 447 | ||
397 | ===================================================================== | 448 | ===================================================================== |
diff --git a/Documentation/devicetree/bindings/rtc/snvs-rtc.txt b/Documentation/devicetree/bindings/rtc/snvs-rtc.txt new file mode 100644 index 000000000000..fb61ed77ada3 --- /dev/null +++ b/Documentation/devicetree/bindings/rtc/snvs-rtc.txt | |||
@@ -0,0 +1 @@ | |||
See Documentation/devicetree/bindings/crypto/fsl-sec4.txt for details. | |||
diff --git a/Documentation/printk-formats.txt b/Documentation/printk-formats.txt index 7561d7ed8e11..8ffb274367c7 100644 --- a/Documentation/printk-formats.txt +++ b/Documentation/printk-formats.txt | |||
@@ -69,6 +69,7 @@ MAC/FDDI addresses: | |||
69 | %pMR 05:04:03:02:01:00 | 69 | %pMR 05:04:03:02:01:00 |
70 | %pMF 00-01-02-03-04-05 | 70 | %pMF 00-01-02-03-04-05 |
71 | %pm 000102030405 | 71 | %pm 000102030405 |
72 | %pmR 050403020100 | ||
72 | 73 | ||
73 | For printing 6-byte MAC/FDDI addresses in hex notation. The 'M' and 'm' | 74 | For printing 6-byte MAC/FDDI addresses in hex notation. The 'M' and 'm' |
74 | specifiers result in a printed address with ('M') or without ('m') byte | 75 | specifiers result in a printed address with ('M') or without ('m') byte |
diff --git a/Documentation/rtc.txt b/Documentation/rtc.txt index 250160469d83..32aa4002de4a 100644 --- a/Documentation/rtc.txt +++ b/Documentation/rtc.txt | |||
@@ -119,8 +119,9 @@ three different userspace interfaces: | |||
119 | * /sys/class/rtc/rtcN ... sysfs attributes support readonly | 119 | * /sys/class/rtc/rtcN ... sysfs attributes support readonly |
120 | access to some RTC attributes. | 120 | access to some RTC attributes. |
121 | 121 | ||
122 | * /proc/driver/rtc ... the first RTC (rtc0) may expose itself | 122 | * /proc/driver/rtc ... the system clock RTC may expose itself |
123 | using a procfs interface. More information is (currently) shown | 123 | using a procfs interface. If there is no RTC for the system clock, |
124 | rtc0 is used by default. More information is (currently) shown | ||
124 | here than through sysfs. | 125 | here than through sysfs. |
125 | 126 | ||
126 | The RTC Class framework supports a wide variety of RTCs, ranging from those | 127 | The RTC Class framework supports a wide variety of RTCs, ranging from those |
diff --git a/Documentation/sysctl/kernel.txt b/Documentation/sysctl/kernel.txt index 6d78841fd416..2907ba6c3607 100644 --- a/Documentation/sysctl/kernel.txt +++ b/Documentation/sysctl/kernel.txt | |||
@@ -181,6 +181,8 @@ core_pattern is used to specify a core dumpfile pattern name. | |||
181 | %p pid | 181 | %p pid |
182 | %u uid | 182 | %u uid |
183 | %g gid | 183 | %g gid |
184 | %d dump mode, matches PR_SET_DUMPABLE and | ||
185 | /proc/sys/fs/suid_dumpable | ||
184 | %s signal number | 186 | %s signal number |
185 | %t UNIX time of dump | 187 | %t UNIX time of dump |
186 | %h hostname | 188 | %h hostname |