aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2012-10-05 14:09:16 -0400
committerLinus Torvalds <torvalds@linux-foundation.org>2012-10-05 14:09:16 -0400
commit11126c611e10abb18b6f1ed0300c0548c3906b54 (patch)
tree246227ad730c1e68f5a9c03db57cd4592abe7687 /Documentation
parent67966e088b0c7dc926f4ce19565ebf208e18d058 (diff)
parent33e2a4227ddff7c18921ac175fae3ab0e3ff8a76 (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/CodingStyle10
-rw-r--r--Documentation/aoe/aoe.txt58
-rw-r--r--Documentation/aoe/mkdevs.sh41
-rw-r--r--Documentation/aoe/mkshelf.sh28
-rw-r--r--Documentation/aoe/status.sh3
-rw-r--r--Documentation/devicetree/bindings/crypto/fsl-sec4.txt51
-rw-r--r--Documentation/devicetree/bindings/rtc/snvs-rtc.txt1
-rw-r--r--Documentation/printk-formats.txt1
-rw-r--r--Documentation/rtc.txt5
-rw-r--r--Documentation/sysctl/kernel.txt2
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
457For files in net/ and drivers/net/ the preferred style for long (multi-line)
458comments 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
457It's also important to comment data, whether they are basic types or derived 467It's also important to comment data, whether they are basic types or derived
458types. To this end, use just one data declaration per line (no commas for 468types. To this end, use just one data declaration per line (no commas for
459multiple data declarations). This leaves you room for a small comment on each 469multiple 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 @@
1The EtherDrive (R) HOWTO for users of 2.6 kernels is found at ... 1ATA over Ethernet is a network protocol that provides simple access to
2block 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! 6The 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
10It has many tips and hints! Please see, especially, recommended
11tunings for virtual memory:
12
13 http://support.coraid.com/support/linux/EtherDrive-2.6-HOWTO-5.html#ss5.19
6 14
7The aoetools are userland programs that are designed to work with this 15The aoetools are userland programs that are designed to work with this
8driver. The aoetools are on sourceforge. 16driver. 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
41USING DEVICE NODES 41USING 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
3n_shelves=${n_shelves:-10}
4n_partitions=${n_partitions:-16}
5
6if 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
10fi
11dir=$1
12
13MAJOR=152
14
15echo "Creating AoE devnode files in $dir ..."
16
17set -e
18
19mkdir -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
24rm -f $dir/err
25mknod -m 0400 $dir/err c $MAJOR 2
26rm -f $dir/discover
27mknod -m 0200 $dir/discover c $MAJOR 3
28rm -f $dir/interfaces
29mknod -m 0200 $dir/interfaces c $MAJOR 4
30rm -f $dir/revalidate
31mknod -m 0200 $dir/revalidate c $MAJOR 5
32rm -f $dir/flush
33mknod -m 0200 $dir/flush c $MAJOR 6
34
35export n_partitions
36mkshelf=`echo $0 | sed 's!mkdevs!mkshelf!'`
37i=0
38while test $i -lt $n_shelves; do
39 sh -xc "sh $mkshelf $dir $i"
40 i=`expr $i + 1`
41done
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
3if 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
7fi
8n_partitions=${n_partitions:-16}
9dir=$1
10shelf=$2
11nslots=16
12maxslot=`echo $nslots 1 - p | dc`
13MAJOR=152
14
15set -e
16
17minor=`echo $nslots \* $shelf \* $n_partitions | bc`
18endp=`echo $n_partitions - 1 | bc`
19for 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
28done
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
4set -e 7set -e
5format="%8s\t%8s\t%8s\n" 8format="%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
14NOTE: the SEC 4 is also known as Freescale's Cryptographic Accelerator 15NOTE: 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=====================================================================
345Secure 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
360EXAMPLE
361 sec_mon_rtc_lp@314000 {
362 compatible = "fsl,sec-v4.0-mon-rtc-lp";
363 reg = <0x34 0x58>;
364 };
365
366=====================================================================
322FULL EXAMPLE 367FULL 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
126The RTC Class framework supports a wide variety of RTCs, ranging from those 127The 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