diff options
author | Paul Mackerras <paulus@samba.org> | 2006-02-23 22:05:47 -0500 |
---|---|---|
committer | Paul Mackerras <paulus@samba.org> | 2006-02-23 22:05:47 -0500 |
commit | a00428f5b149e36b8225b2a0812742a6dfb07b8c (patch) | |
tree | a78869cd67cf78a0eb091fb0ea5d397734bd6738 /Documentation | |
parent | 774fee58c465ea1c7e9775e347ec307bcf2deeb3 (diff) | |
parent | fb5c594c2acc441f0d2d8f457484a0e0e9285db3 (diff) |
Merge ../powerpc-merge
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/cpu-hotplug.txt | 27 | ||||
-rw-r--r-- | Documentation/feature-removal-schedule.txt | 9 | ||||
-rw-r--r-- | Documentation/filesystems/tmpfs.txt | 21 | ||||
-rw-r--r-- | Documentation/filesystems/v9fs.txt | 16 | ||||
-rw-r--r-- | Documentation/fujitsu/frv/kernel-ABI.txt | 234 | ||||
-rw-r--r-- | Documentation/hwmon/w83627hf | 4 | ||||
-rw-r--r-- | Documentation/kernel-parameters.txt | 5 | ||||
-rw-r--r-- | Documentation/kprobes.txt | 81 | ||||
-rw-r--r-- | Documentation/mips/AU1xxx_IDE.README | 6 | ||||
-rw-r--r-- | Documentation/scsi/ChangeLog.megaraid_sas | 23 | ||||
-rw-r--r-- | Documentation/sysctl/kernel.txt | 10 |
11 files changed, 378 insertions, 58 deletions
diff --git a/Documentation/cpu-hotplug.txt b/Documentation/cpu-hotplug.txt index 08c5d04f3086..57a09f99ecb0 100644 --- a/Documentation/cpu-hotplug.txt +++ b/Documentation/cpu-hotplug.txt | |||
@@ -11,6 +11,8 @@ | |||
11 | Joel Schopp <jschopp@austin.ibm.com> | 11 | Joel Schopp <jschopp@austin.ibm.com> |
12 | ia64/x86_64: | 12 | ia64/x86_64: |
13 | Ashok Raj <ashok.raj@intel.com> | 13 | Ashok Raj <ashok.raj@intel.com> |
14 | s390: | ||
15 | Heiko Carstens <heiko.carstens@de.ibm.com> | ||
14 | 16 | ||
15 | Authors: Ashok Raj <ashok.raj@intel.com> | 17 | Authors: Ashok Raj <ashok.raj@intel.com> |
16 | Lots of feedback: Nathan Lynch <nathanl@austin.ibm.com>, | 18 | Lots of feedback: Nathan Lynch <nathanl@austin.ibm.com>, |
@@ -44,9 +46,28 @@ maxcpus=n Restrict boot time cpus to n. Say if you have 4 cpus, using | |||
44 | maxcpus=2 will only boot 2. You can choose to bring the | 46 | maxcpus=2 will only boot 2. You can choose to bring the |
45 | other cpus later online, read FAQ's for more info. | 47 | other cpus later online, read FAQ's for more info. |
46 | 48 | ||
47 | additional_cpus=n [x86_64 only] use this to limit hotpluggable cpus. | 49 | additional_cpus*=n Use this to limit hotpluggable cpus. This option sets |
48 | This option sets | 50 | cpu_possible_map = cpu_present_map + additional_cpus |
49 | cpu_possible_map = cpu_present_map + additional_cpus | 51 | |
52 | (*) Option valid only for following architectures | ||
53 | - x86_64, ia64, s390 | ||
54 | |||
55 | ia64 and x86_64 use the number of disabled local apics in ACPI tables MADT | ||
56 | to determine the number of potentially hot-pluggable cpus. The implementation | ||
57 | should only rely on this to count the #of cpus, but *MUST* not rely on the | ||
58 | apicid values in those tables for disabled apics. In the event BIOS doesnt | ||
59 | mark such hot-pluggable cpus as disabled entries, one could use this | ||
60 | parameter "additional_cpus=x" to represent those cpus in the cpu_possible_map. | ||
61 | |||
62 | s390 uses the number of cpus it detects at IPL time to also the number of bits | ||
63 | in cpu_possible_map. If it is desired to add additional cpus at a later time | ||
64 | the number should be specified using this option or the possible_cpus option. | ||
65 | |||
66 | possible_cpus=n [s390 only] use this to set hotpluggable cpus. | ||
67 | This option sets possible_cpus bits in | ||
68 | cpu_possible_map. Thus keeping the numbers of bits set | ||
69 | constant even if the machine gets rebooted. | ||
70 | This option overrides additional_cpus. | ||
50 | 71 | ||
51 | CPU maps and such | 72 | CPU maps and such |
52 | ----------------- | 73 | ----------------- |
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt index b730d765b525..be5ae600f533 100644 --- a/Documentation/feature-removal-schedule.txt +++ b/Documentation/feature-removal-schedule.txt | |||
@@ -171,3 +171,12 @@ Why: The ISA interface is faster and should be always available. The I2C | |||
171 | probing is also known to cause trouble in at least one case (see | 171 | probing is also known to cause trouble in at least one case (see |
172 | bug #5889.) | 172 | bug #5889.) |
173 | Who: Jean Delvare <khali@linux-fr.org> | 173 | Who: Jean Delvare <khali@linux-fr.org> |
174 | |||
175 | --------------------------- | ||
176 | |||
177 | What: mount/umount uevents | ||
178 | When: February 2007 | ||
179 | Why: These events are not correct, and do not properly let userspace know | ||
180 | when a file system has been mounted or unmounted. Userspace should | ||
181 | poll the /proc/mounts file instead to detect this properly. | ||
182 | Who: Greg Kroah-Hartman <gregkh@suse.de> | ||
diff --git a/Documentation/filesystems/tmpfs.txt b/Documentation/filesystems/tmpfs.txt index dbe4d87d2615..8a155418c705 100644 --- a/Documentation/filesystems/tmpfs.txt +++ b/Documentation/filesystems/tmpfs.txt | |||
@@ -79,15 +79,18 @@ that instance in a system with many cpus making intensive use of it. | |||
79 | 79 | ||
80 | 80 | ||
81 | tmpfs has a mount option to set the NUMA memory allocation policy for | 81 | tmpfs has a mount option to set the NUMA memory allocation policy for |
82 | all files in that instance: | 82 | all files in that instance (if CONFIG_NUMA is enabled) - which can be |
83 | mpol=interleave prefers to allocate memory from each node in turn | 83 | adjusted on the fly via 'mount -o remount ...' |
84 | mpol=default prefers to allocate memory from the local node | ||
85 | mpol=bind prefers to allocate from mpol_nodelist | ||
86 | mpol=preferred prefers to allocate from first node in mpol_nodelist | ||
87 | 84 | ||
88 | The following mount option is used in conjunction with mpol=interleave, | 85 | mpol=default prefers to allocate memory from the local node |
89 | mpol=bind or mpol=preferred: | 86 | mpol=prefer:Node prefers to allocate memory from the given Node |
90 | mpol_nodelist: nodelist suitable for parsing with nodelist_parse. | 87 | mpol=bind:NodeList allocates memory only from nodes in NodeList |
88 | mpol=interleave prefers to allocate from each node in turn | ||
89 | mpol=interleave:NodeList allocates from each node of NodeList in turn | ||
90 | |||
91 | NodeList format is a comma-separated list of decimal numbers and ranges, | ||
92 | a range being two hyphen-separated decimal numbers, the smallest and | ||
93 | largest node numbers in the range. For example, mpol=bind:0-3,5,7,9-15 | ||
91 | 94 | ||
92 | 95 | ||
93 | To specify the initial root directory you can use the following mount | 96 | To specify the initial root directory you can use the following mount |
@@ -109,4 +112,4 @@ RAM/SWAP in 10240 inodes and it is only accessible by root. | |||
109 | Author: | 112 | Author: |
110 | Christoph Rohland <cr@sap.com>, 1.12.01 | 113 | Christoph Rohland <cr@sap.com>, 1.12.01 |
111 | Updated: | 114 | Updated: |
112 | Hugh Dickins <hugh@veritas.com>, 13 March 2005 | 115 | Hugh Dickins <hugh@veritas.com>, 19 February 2006 |
diff --git a/Documentation/filesystems/v9fs.txt b/Documentation/filesystems/v9fs.txt index 4e92feb6b507..24c7a9c41f0d 100644 --- a/Documentation/filesystems/v9fs.txt +++ b/Documentation/filesystems/v9fs.txt | |||
@@ -57,8 +57,6 @@ OPTIONS | |||
57 | 57 | ||
58 | port=n port to connect to on the remote server | 58 | port=n port to connect to on the remote server |
59 | 59 | ||
60 | timeout=n request timeouts (in ms) (default 60000ms) | ||
61 | |||
62 | noextend force legacy mode (no 9P2000.u semantics) | 60 | noextend force legacy mode (no 9P2000.u semantics) |
63 | 61 | ||
64 | uid attempt to mount as a particular uid | 62 | uid attempt to mount as a particular uid |
@@ -74,10 +72,16 @@ OPTIONS | |||
74 | RESOURCES | 72 | RESOURCES |
75 | ========= | 73 | ========= |
76 | 74 | ||
77 | The Linux version of the 9P server, along with some client-side utilities | 75 | The Linux version of the 9P server is now maintained under the npfs project |
78 | can be found at http://v9fs.sf.net (along with a CVS repository of the | 76 | on sourceforge (http://sourceforge.net/projects/npfs). |
79 | development branch of this module). There are user and developer mailing | 77 | |
80 | lists here, as well as a bug-tracker. | 78 | There are user and developer mailing lists available through the v9fs project |
79 | on sourceforge (http://sourceforge.net/projects/v9fs). | ||
80 | |||
81 | News and other information is maintained on SWiK (http://swik.net/v9fs). | ||
82 | |||
83 | Bug reports may be issued through the kernel.org bugzilla | ||
84 | (http://bugzilla.kernel.org) | ||
81 | 85 | ||
82 | For more information on the Plan 9 Operating System check out | 86 | For more information on the Plan 9 Operating System check out |
83 | http://plan9.bell-labs.com/plan9 | 87 | http://plan9.bell-labs.com/plan9 |
diff --git a/Documentation/fujitsu/frv/kernel-ABI.txt b/Documentation/fujitsu/frv/kernel-ABI.txt new file mode 100644 index 000000000000..0ed9b0a779bc --- /dev/null +++ b/Documentation/fujitsu/frv/kernel-ABI.txt | |||
@@ -0,0 +1,234 @@ | |||
1 | ================================= | ||
2 | INTERNAL KERNEL ABI FOR FR-V ARCH | ||
3 | ================================= | ||
4 | |||
5 | The internal FRV kernel ABI is not quite the same as the userspace ABI. A number of the registers | ||
6 | are used for special purposed, and the ABI is not consistent between modules vs core, and MMU vs | ||
7 | no-MMU. | ||
8 | |||
9 | This partly stems from the fact that FRV CPUs do not have a separate supervisor stack pointer, and | ||
10 | most of them do not have any scratch registers, thus requiring at least one general purpose | ||
11 | register to be clobbered in such an event. Also, within the kernel core, it is possible to simply | ||
12 | jump or call directly between functions using a relative offset. This cannot be extended to modules | ||
13 | for the displacement is likely to be too far. Thus in modules the address of a function to call | ||
14 | must be calculated in a register and then used, requiring two extra instructions. | ||
15 | |||
16 | This document has the following sections: | ||
17 | |||
18 | (*) System call register ABI | ||
19 | (*) CPU operating modes | ||
20 | (*) Internal kernel-mode register ABI | ||
21 | (*) Internal debug-mode register ABI | ||
22 | (*) Virtual interrupt handling | ||
23 | |||
24 | |||
25 | ======================== | ||
26 | SYSTEM CALL REGISTER ABI | ||
27 | ======================== | ||
28 | |||
29 | When a system call is made, the following registers are effective: | ||
30 | |||
31 | REGISTERS CALL RETURN | ||
32 | =============== ======================= ======================= | ||
33 | GR7 System call number Preserved | ||
34 | GR8 Syscall arg #1 Return value | ||
35 | GR9-GR13 Syscall arg #2-6 Preserved | ||
36 | |||
37 | |||
38 | =================== | ||
39 | CPU OPERATING MODES | ||
40 | =================== | ||
41 | |||
42 | The FR-V CPU has three basic operating modes. In order of increasing capability: | ||
43 | |||
44 | (1) User mode. | ||
45 | |||
46 | Basic userspace running mode. | ||
47 | |||
48 | (2) Kernel mode. | ||
49 | |||
50 | Normal kernel mode. There are many additional control registers available that may be | ||
51 | accessed in this mode, in addition to all the stuff available to user mode. This has two | ||
52 | submodes: | ||
53 | |||
54 | (a) Exceptions enabled (PSR.T == 1). | ||
55 | |||
56 | Exceptions will invoke the appropriate normal kernel mode handler. On entry to the | ||
57 | handler, the PSR.T bit will be cleared. | ||
58 | |||
59 | (b) Exceptions disabled (PSR.T == 0). | ||
60 | |||
61 | No exceptions or interrupts may happen. Any mandatory exceptions will cause the CPU to | ||
62 | halt unless the CPU is told to jump into debug mode instead. | ||
63 | |||
64 | (3) Debug mode. | ||
65 | |||
66 | No exceptions may happen in this mode. Memory protection and management exceptions will be | ||
67 | flagged for later consideration, but the exception handler won't be invoked. Debugging traps | ||
68 | such as hardware breakpoints and watchpoints will be ignored. This mode is entered only by | ||
69 | debugging events obtained from the other two modes. | ||
70 | |||
71 | All kernel mode registers may be accessed, plus a few extra debugging specific registers. | ||
72 | |||
73 | |||
74 | ================================= | ||
75 | INTERNAL KERNEL-MODE REGISTER ABI | ||
76 | ================================= | ||
77 | |||
78 | There are a number of permanent register assignments that are set up by entry.S in the exception | ||
79 | prologue. Note that there is a complete set of exception prologues for each of user->kernel | ||
80 | transition and kernel->kernel transition. There are also user->debug and kernel->debug mode | ||
81 | transition prologues. | ||
82 | |||
83 | |||
84 | REGISTER FLAVOUR USE | ||
85 | =============== ======= ==================================================== | ||
86 | GR1 Supervisor stack pointer | ||
87 | GR15 Current thread info pointer | ||
88 | GR16 GP-Rel base register for small data | ||
89 | GR28 Current exception frame pointer (__frame) | ||
90 | GR29 Current task pointer (current) | ||
91 | GR30 Destroyed by kernel mode entry | ||
92 | GR31 NOMMU Destroyed by debug mode entry | ||
93 | GR31 MMU Destroyed by TLB miss kernel mode entry | ||
94 | CCR.ICC2 Virtual interrupt disablement tracking | ||
95 | CCCR.CC3 Cleared by exception prologue (atomic op emulation) | ||
96 | SCR0 MMU See mmu-layout.txt. | ||
97 | SCR1 MMU See mmu-layout.txt. | ||
98 | SCR2 MMU Save for EAR0 (destroyed by icache insns in debug mode) | ||
99 | SCR3 MMU Save for GR31 during debug exceptions | ||
100 | DAMR/IAMR NOMMU Fixed memory protection layout. | ||
101 | DAMR/IAMR MMU See mmu-layout.txt. | ||
102 | |||
103 | |||
104 | Certain registers are also used or modified across function calls: | ||
105 | |||
106 | REGISTER CALL RETURN | ||
107 | =============== =============================== =============================== | ||
108 | GR0 Fixed Zero - | ||
109 | GR2 Function call frame pointer | ||
110 | GR3 Special Preserved | ||
111 | GR3-GR7 - Clobbered | ||
112 | GR8 Function call arg #1 Return value (or clobbered) | ||
113 | GR9 Function call arg #2 Return value MSW (or clobbered) | ||
114 | GR10-GR13 Function call arg #3-#6 Clobbered | ||
115 | GR14 - Clobbered | ||
116 | GR15-GR16 Special Preserved | ||
117 | GR17-GR27 - Preserved | ||
118 | GR28-GR31 Special Only accessed explicitly | ||
119 | LR Return address after CALL Clobbered | ||
120 | CCR/CCCR - Mostly Clobbered | ||
121 | |||
122 | |||
123 | ================================ | ||
124 | INTERNAL DEBUG-MODE REGISTER ABI | ||
125 | ================================ | ||
126 | |||
127 | This is the same as the kernel-mode register ABI for functions calls. The difference is that in | ||
128 | debug-mode there's a different stack and a different exception frame. Almost all the global | ||
129 | registers from kernel-mode (including the stack pointer) may be changed. | ||
130 | |||
131 | REGISTER FLAVOUR USE | ||
132 | =============== ======= ==================================================== | ||
133 | GR1 Debug stack pointer | ||
134 | GR16 GP-Rel base register for small data | ||
135 | GR31 Current debug exception frame pointer (__debug_frame) | ||
136 | SCR3 MMU Saved value of GR31 | ||
137 | |||
138 | |||
139 | Note that debug mode is able to interfere with the kernel's emulated atomic ops, so it must be | ||
140 | exceedingly careful not to do any that would interact with the main kernel in this regard. Hence | ||
141 | the debug mode code (gdbstub) is almost completely self-contained. The only external code used is | ||
142 | the sprintf family of functions. | ||
143 | |||
144 | Futhermore, break.S is so complicated because single-step mode does not switch off on entry to an | ||
145 | exception. That means unless manually disabled, single-stepping will blithely go on stepping into | ||
146 | things like interrupts. See gdbstub.txt for more information. | ||
147 | |||
148 | |||
149 | ========================== | ||
150 | VIRTUAL INTERRUPT HANDLING | ||
151 | ========================== | ||
152 | |||
153 | Because accesses to the PSR is so slow, and to disable interrupts we have to access it twice (once | ||
154 | to read and once to write), we don't actually disable interrupts at all if we don't have to. What | ||
155 | we do instead is use the ICC2 condition code flags to note virtual disablement, such that if we | ||
156 | then do take an interrupt, we note the flag, really disable interrupts, set another flag and resume | ||
157 | execution at the point the interrupt happened. Setting condition flags as a side effect of an | ||
158 | arithmetic or logical instruction is really fast. This use of the ICC2 only occurs within the | ||
159 | kernel - it does not affect userspace. | ||
160 | |||
161 | The flags we use are: | ||
162 | |||
163 | (*) CCR.ICC2.Z [Zero flag] | ||
164 | |||
165 | Set to virtually disable interrupts, clear when interrupts are virtually enabled. Can be | ||
166 | modified by logical instructions without affecting the Carry flag. | ||
167 | |||
168 | (*) CCR.ICC2.C [Carry flag] | ||
169 | |||
170 | Clear to indicate hardware interrupts are really disabled, set otherwise. | ||
171 | |||
172 | |||
173 | What happens is this: | ||
174 | |||
175 | (1) Normal kernel-mode operation. | ||
176 | |||
177 | ICC2.Z is 0, ICC2.C is 1. | ||
178 | |||
179 | (2) An interrupt occurs. The exception prologue examines ICC2.Z and determines that nothing needs | ||
180 | doing. This is done simply with an unlikely BEQ instruction. | ||
181 | |||
182 | (3) The interrupts are disabled (local_irq_disable) | ||
183 | |||
184 | ICC2.Z is set to 1. | ||
185 | |||
186 | (4) If interrupts were then re-enabled (local_irq_enable): | ||
187 | |||
188 | ICC2.Z would be set to 0. | ||
189 | |||
190 | A TIHI #2 instruction (trap #2 if condition HI - Z==0 && C==0) would be used to trap if | ||
191 | interrupts were now virtually enabled, but physically disabled - which they're not, so the | ||
192 | trap isn't taken. The kernel would then be back to state (1). | ||
193 | |||
194 | (5) An interrupt occurs. The exception prologue examines ICC2.Z and determines that the interrupt | ||
195 | shouldn't actually have happened. It jumps aside, and there disabled interrupts by setting | ||
196 | PSR.PIL to 14 and then it clears ICC2.C. | ||
197 | |||
198 | (6) If interrupts were then saved and disabled again (local_irq_save): | ||
199 | |||
200 | ICC2.Z would be shifted into the save variable and masked off (giving a 1). | ||
201 | |||
202 | ICC2.Z would then be set to 1 (thus unchanged), and ICC2.C would be unaffected (ie: 0). | ||
203 | |||
204 | (7) If interrupts were then restored from state (6) (local_irq_restore): | ||
205 | |||
206 | ICC2.Z would be set to indicate the result of XOR'ing the saved value (ie: 1) with 1, which | ||
207 | gives a result of 0 - thus leaving ICC2.Z set. | ||
208 | |||
209 | ICC2.C would remain unaffected (ie: 0). | ||
210 | |||
211 | A TIHI #2 instruction would be used to again assay the current state, but this would do | ||
212 | nothing as Z==1. | ||
213 | |||
214 | (8) If interrupts were then enabled (local_irq_enable): | ||
215 | |||
216 | ICC2.Z would be cleared. ICC2.C would be left unaffected. Both flags would now be 0. | ||
217 | |||
218 | A TIHI #2 instruction again issued to assay the current state would then trap as both Z==0 | ||
219 | [interrupts virtually enabled] and C==0 [interrupts really disabled] would then be true. | ||
220 | |||
221 | (9) The trap #2 handler would simply enable hardware interrupts (set PSR.PIL to 0), set ICC2.C to | ||
222 | 1 and return. | ||
223 | |||
224 | (10) Immediately upon returning, the pending interrupt would be taken. | ||
225 | |||
226 | (11) The interrupt handler would take the path of actually processing the interrupt (ICC2.Z is | ||
227 | clear, BEQ fails as per step (2)). | ||
228 | |||
229 | (12) The interrupt handler would then set ICC2.C to 1 since hardware interrupts are definitely | ||
230 | enabled - or else the kernel wouldn't be here. | ||
231 | |||
232 | (13) On return from the interrupt handler, things would be back to state (1). | ||
233 | |||
234 | This trap (#2) is only available in kernel mode. In user mode it will result in SIGILL. | ||
diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf index 5d23776e9907..bbeaba680443 100644 --- a/Documentation/hwmon/w83627hf +++ b/Documentation/hwmon/w83627hf | |||
@@ -36,6 +36,10 @@ Module Parameters | |||
36 | (default is 1) | 36 | (default is 1) |
37 | Use 'init=0' to bypass initializing the chip. | 37 | Use 'init=0' to bypass initializing the chip. |
38 | Try this if your computer crashes when you load the module. | 38 | Try this if your computer crashes when you load the module. |
39 | * reset: int | ||
40 | (default is 0) | ||
41 | The driver used to reset the chip on load, but does no more. Use | ||
42 | 'reset=1' to restore the old behavior. Report if you need to do this. | ||
39 | 43 | ||
40 | Description | 44 | Description |
41 | ----------- | 45 | ----------- |
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index 84370363da80..b874771385cd 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt | |||
@@ -1133,6 +1133,8 @@ running once the system is up. | |||
1133 | Mechanism 1. | 1133 | Mechanism 1. |
1134 | conf2 [IA-32] Force use of PCI Configuration | 1134 | conf2 [IA-32] Force use of PCI Configuration |
1135 | Mechanism 2. | 1135 | Mechanism 2. |
1136 | nommconf [IA-32,X86_64] Disable use of MMCONFIG for PCI | ||
1137 | Configuration | ||
1136 | nosort [IA-32] Don't sort PCI devices according to | 1138 | nosort [IA-32] Don't sort PCI devices according to |
1137 | order given by the PCI BIOS. This sorting is | 1139 | order given by the PCI BIOS. This sorting is |
1138 | done to get a device order compatible with | 1140 | done to get a device order compatible with |
@@ -1636,6 +1638,9 @@ running once the system is up. | |||
1636 | Format: | 1638 | Format: |
1637 | <irq>,<irq_mask>,<io>,<full_duplex>,<do_sound>,<lockup_hack>[,<irq2>[,<irq3>[,<irq4>]]] | 1639 | <irq>,<irq_mask>,<io>,<full_duplex>,<do_sound>,<lockup_hack>[,<irq2>[,<irq3>[,<irq4>]]] |
1638 | 1640 | ||
1641 | norandmaps Don't use address space randomization | ||
1642 | Equivalent to echo 0 > /proc/sys/kernel/randomize_va_space | ||
1643 | |||
1639 | 1644 | ||
1640 | ______________________________________________________________________ | 1645 | ______________________________________________________________________ |
1641 | Changelog: | 1646 | Changelog: |
diff --git a/Documentation/kprobes.txt b/Documentation/kprobes.txt index 0ea5a0c6e827..2c3b1eae4280 100644 --- a/Documentation/kprobes.txt +++ b/Documentation/kprobes.txt | |||
@@ -136,17 +136,20 @@ Kprobes, jprobes, and return probes are implemented on the following | |||
136 | architectures: | 136 | architectures: |
137 | 137 | ||
138 | - i386 | 138 | - i386 |
139 | - x86_64 (AMD-64, E64MT) | 139 | - x86_64 (AMD-64, EM64T) |
140 | - ppc64 | 140 | - ppc64 |
141 | - ia64 (Support for probes on certain instruction types is still in progress.) | 141 | - ia64 (Does not support probes on instruction slot1.) |
142 | - sparc64 (Return probes not yet implemented.) | 142 | - sparc64 (Return probes not yet implemented.) |
143 | 143 | ||
144 | 3. Configuring Kprobes | 144 | 3. Configuring Kprobes |
145 | 145 | ||
146 | When configuring the kernel using make menuconfig/xconfig/oldconfig, | 146 | When configuring the kernel using make menuconfig/xconfig/oldconfig, |
147 | ensure that CONFIG_KPROBES is set to "y". Under "Kernel hacking", | 147 | ensure that CONFIG_KPROBES is set to "y". Under "Instrumentation |
148 | look for "Kprobes". You may have to enable "Kernel debugging" | 148 | Support", look for "Kprobes". |
149 | (CONFIG_DEBUG_KERNEL) before you can enable Kprobes. | 149 | |
150 | So that you can load and unload Kprobes-based instrumentation modules, | ||
151 | make sure "Loadable module support" (CONFIG_MODULES) and "Module | ||
152 | unloading" (CONFIG_MODULE_UNLOAD) are set to "y". | ||
150 | 153 | ||
151 | You may also want to ensure that CONFIG_KALLSYMS and perhaps even | 154 | You may also want to ensure that CONFIG_KALLSYMS and perhaps even |
152 | CONFIG_KALLSYMS_ALL are set to "y", since kallsyms_lookup_name() | 155 | CONFIG_KALLSYMS_ALL are set to "y", since kallsyms_lookup_name() |
@@ -262,18 +265,18 @@ at any time after the probe has been registered. | |||
262 | 265 | ||
263 | 5. Kprobes Features and Limitations | 266 | 5. Kprobes Features and Limitations |
264 | 267 | ||
265 | As of Linux v2.6.12, Kprobes allows multiple probes at the same | 268 | Kprobes allows multiple probes at the same address. Currently, |
266 | address. Currently, however, there cannot be multiple jprobes on | 269 | however, there cannot be multiple jprobes on the same function at |
267 | the same function at the same time. | 270 | the same time. |
268 | 271 | ||
269 | In general, you can install a probe anywhere in the kernel. | 272 | In general, you can install a probe anywhere in the kernel. |
270 | In particular, you can probe interrupt handlers. Known exceptions | 273 | In particular, you can probe interrupt handlers. Known exceptions |
271 | are discussed in this section. | 274 | are discussed in this section. |
272 | 275 | ||
273 | For obvious reasons, it's a bad idea to install a probe in | 276 | The register_*probe functions will return -EINVAL if you attempt |
274 | the code that implements Kprobes (mostly kernel/kprobes.c and | 277 | to install a probe in the code that implements Kprobes (mostly |
275 | arch/*/kernel/kprobes.c). A patch in the v2.6.13 timeframe instructs | 278 | kernel/kprobes.c and arch/*/kernel/kprobes.c, but also functions such |
276 | Kprobes to reject such requests. | 279 | as do_page_fault and notifier_call_chain). |
277 | 280 | ||
278 | If you install a probe in an inline-able function, Kprobes makes | 281 | If you install a probe in an inline-able function, Kprobes makes |
279 | no attempt to chase down all inline instances of the function and | 282 | no attempt to chase down all inline instances of the function and |
@@ -290,18 +293,14 @@ from the accidental ones. Don't drink and probe. | |||
290 | 293 | ||
291 | Kprobes makes no attempt to prevent probe handlers from stepping on | 294 | Kprobes makes no attempt to prevent probe handlers from stepping on |
292 | each other -- e.g., probing printk() and then calling printk() from a | 295 | each other -- e.g., probing printk() and then calling printk() from a |
293 | probe handler. As of Linux v2.6.12, if a probe handler hits a probe, | 296 | probe handler. If a probe handler hits a probe, that second probe's |
294 | that second probe's handlers won't be run in that instance. | 297 | handlers won't be run in that instance, and the kprobe.nmissed member |
295 | 298 | of the second probe will be incremented. | |
296 | In Linux v2.6.12 and previous versions, Kprobes' data structures are | 299 | |
297 | protected by a single lock that is held during probe registration and | 300 | As of Linux v2.6.15-rc1, multiple handlers (or multiple instances of |
298 | unregistration and while handlers are run. Thus, no two handlers | 301 | the same handler) may run concurrently on different CPUs. |
299 | can run simultaneously. To improve scalability on SMP systems, | 302 | |
300 | this restriction will probably be removed soon, in which case | 303 | Kprobes does not use mutexes or allocate memory except during |
301 | multiple handlers (or multiple instances of the same handler) may | ||
302 | run concurrently on different CPUs. Code your handlers accordingly. | ||
303 | |||
304 | Kprobes does not use semaphores or allocate memory except during | ||
305 | registration and unregistration. | 304 | registration and unregistration. |
306 | 305 | ||
307 | Probe handlers are run with preemption disabled. Depending on the | 306 | Probe handlers are run with preemption disabled. Depending on the |
@@ -316,11 +315,18 @@ address instead of the real return address for kretprobed functions. | |||
316 | (As far as we can tell, __builtin_return_address() is used only | 315 | (As far as we can tell, __builtin_return_address() is used only |
317 | for instrumentation and error reporting.) | 316 | for instrumentation and error reporting.) |
318 | 317 | ||
319 | If the number of times a function is called does not match the | 318 | If the number of times a function is called does not match the number |
320 | number of times it returns, registering a return probe on that | 319 | of times it returns, registering a return probe on that function may |
321 | function may produce undesirable results. We have the do_exit() | 320 | produce undesirable results. We have the do_exit() case covered. |
322 | and do_execve() cases covered. do_fork() is not an issue. We're | 321 | do_execve() and do_fork() are not an issue. We're unaware of other |
323 | unaware of other specific cases where this could be a problem. | 322 | specific cases where this could be a problem. |
323 | |||
324 | If, upon entry to or exit from a function, the CPU is running on | ||
325 | a stack other than that of the current task, registering a return | ||
326 | probe on that function may produce undesirable results. For this | ||
327 | reason, Kprobes doesn't support return probes (or kprobes or jprobes) | ||
328 | on the x86_64 version of __switch_to(); the registration functions | ||
329 | return -EINVAL. | ||
324 | 330 | ||
325 | 6. Probe Overhead | 331 | 6. Probe Overhead |
326 | 332 | ||
@@ -347,14 +353,12 @@ k = 0.77 usec; j = 1.31; r = 1.26; kr = 1.45; jr = 1.99 | |||
347 | 353 | ||
348 | 7. TODO | 354 | 7. TODO |
349 | 355 | ||
350 | a. SystemTap (http://sourceware.org/systemtap): Work in progress | 356 | a. SystemTap (http://sourceware.org/systemtap): Provides a simplified |
351 | to provide a simplified programming interface for probe-based | 357 | programming interface for probe-based instrumentation. Try it out. |
352 | instrumentation. | 358 | b. Kernel return probes for sparc64. |
353 | b. Improved SMP scalability: Currently, work is in progress to handle | 359 | c. Support for other architectures. |
354 | multiple kprobes in parallel. | 360 | d. User-space probes. |
355 | c. Kernel return probes for sparc64. | 361 | e. Watchpoint probes (which fire on data references). |
356 | d. Support for other architectures. | ||
357 | e. User-space probes. | ||
358 | 362 | ||
359 | 8. Kprobes Example | 363 | 8. Kprobes Example |
360 | 364 | ||
@@ -411,8 +415,7 @@ int init_module(void) | |||
411 | printk("Couldn't find %s to plant kprobe\n", "do_fork"); | 415 | printk("Couldn't find %s to plant kprobe\n", "do_fork"); |
412 | return -1; | 416 | return -1; |
413 | } | 417 | } |
414 | ret = register_kprobe(&kp); | 418 | if ((ret = register_kprobe(&kp) < 0)) { |
415 | if (ret < 0) { | ||
416 | printk("register_kprobe failed, returned %d\n", ret); | 419 | printk("register_kprobe failed, returned %d\n", ret); |
417 | return -1; | 420 | return -1; |
418 | } | 421 | } |
diff --git a/Documentation/mips/AU1xxx_IDE.README b/Documentation/mips/AU1xxx_IDE.README index a7e4c4ea3560..afb31c141d9d 100644 --- a/Documentation/mips/AU1xxx_IDE.README +++ b/Documentation/mips/AU1xxx_IDE.README | |||
@@ -95,11 +95,13 @@ CONFIG_BLK_DEV_IDEDMA_PCI=y | |||
95 | CONFIG_IDEDMA_PCI_AUTO=y | 95 | CONFIG_IDEDMA_PCI_AUTO=y |
96 | CONFIG_BLK_DEV_IDE_AU1XXX=y | 96 | CONFIG_BLK_DEV_IDE_AU1XXX=y |
97 | CONFIG_BLK_DEV_IDE_AU1XXX_MDMA2_DBDMA=y | 97 | CONFIG_BLK_DEV_IDE_AU1XXX_MDMA2_DBDMA=y |
98 | CONFIG_BLK_DEV_IDE_AU1XXX_BURSTABLE_ON=y | ||
99 | CONFIG_BLK_DEV_IDE_AU1XXX_SEQTS_PER_RQ=128 | 98 | CONFIG_BLK_DEV_IDE_AU1XXX_SEQTS_PER_RQ=128 |
100 | CONFIG_BLK_DEV_IDEDMA=y | 99 | CONFIG_BLK_DEV_IDEDMA=y |
101 | CONFIG_IDEDMA_AUTO=y | 100 | CONFIG_IDEDMA_AUTO=y |
102 | 101 | ||
102 | Also define 'IDE_AU1XXX_BURSTMODE' in 'drivers/ide/mips/au1xxx-ide.c' to enable | ||
103 | the burst support on DBDMA controller. | ||
104 | |||
103 | If the used system need the USB support enable the following kernel configs for | 105 | If the used system need the USB support enable the following kernel configs for |
104 | high IDE to USB throughput. | 106 | high IDE to USB throughput. |
105 | 107 | ||
@@ -115,6 +117,8 @@ CONFIG_BLK_DEV_IDE_AU1XXX_SEQTS_PER_RQ=128 | |||
115 | CONFIG_BLK_DEV_IDEDMA=y | 117 | CONFIG_BLK_DEV_IDEDMA=y |
116 | CONFIG_IDEDMA_AUTO=y | 118 | CONFIG_IDEDMA_AUTO=y |
117 | 119 | ||
120 | Also undefine 'IDE_AU1XXX_BURSTMODE' in 'drivers/ide/mips/au1xxx-ide.c' to | ||
121 | disable the burst support on DBDMA controller. | ||
118 | 122 | ||
119 | ADD NEW HARD DISC TO WHITE OR BLACK LIST | 123 | ADD NEW HARD DISC TO WHITE OR BLACK LIST |
120 | ---------------------------------------- | 124 | ---------------------------------------- |
diff --git a/Documentation/scsi/ChangeLog.megaraid_sas b/Documentation/scsi/ChangeLog.megaraid_sas index f8c16cbf56ba..2dafa63bd370 100644 --- a/Documentation/scsi/ChangeLog.megaraid_sas +++ b/Documentation/scsi/ChangeLog.megaraid_sas | |||
@@ -1,3 +1,26 @@ | |||
1 | 1 Release Date : Wed Feb 03 14:31:44 PST 2006 - Sumant Patro <Sumant.Patro@lsil.com> | ||
2 | 2 Current Version : 00.00.02.04 | ||
3 | 3 Older Version : 00.00.02.04 | ||
4 | |||
5 | i. Support for 1078 type (ppc IOP) controller, device id : 0x60 added. | ||
6 | During initialization, depending on the device id, the template members | ||
7 | are initialized with function pointers specific to the ppc or | ||
8 | xscale controllers. | ||
9 | |||
10 | -Sumant Patro <Sumant.Patro@lsil.com> | ||
11 | |||
12 | 1 Release Date : Fri Feb 03 14:16:25 PST 2006 - Sumant Patro | ||
13 | <Sumant.Patro@lsil.com> | ||
14 | 2 Current Version : 00.00.02.04 | ||
15 | 3 Older Version : 00.00.02.02 | ||
16 | i. Register 16 byte CDB capability with scsi midlayer | ||
17 | |||
18 | "Ths patch properly registers the 16 byte command length capability of the | ||
19 | megaraid_sas controlled hardware with the scsi midlayer. All megaraid_sas | ||
20 | hardware supports 16 byte CDB's." | ||
21 | |||
22 | -Joshua Giles <joshua_giles@dell.com> | ||
23 | |||
1 | 1 Release Date : Mon Jan 23 14:09:01 PST 2006 - Sumant Patro <Sumant.Patro@lsil.com> | 24 | 1 Release Date : Mon Jan 23 14:09:01 PST 2006 - Sumant Patro <Sumant.Patro@lsil.com> |
2 | 2 Current Version : 00.00.02.02 | 25 | 2 Current Version : 00.00.02.02 |
3 | 3 Older Version : 00.00.02.01 | 26 | 3 Older Version : 00.00.02.01 |
diff --git a/Documentation/sysctl/kernel.txt b/Documentation/sysctl/kernel.txt index 9f11d36a8c10..b0c7ab93dcb9 100644 --- a/Documentation/sysctl/kernel.txt +++ b/Documentation/sysctl/kernel.txt | |||
@@ -16,6 +16,7 @@ before actually making adjustments. | |||
16 | 16 | ||
17 | Currently, these files might (depending on your configuration) | 17 | Currently, these files might (depending on your configuration) |
18 | show up in /proc/sys/kernel: | 18 | show up in /proc/sys/kernel: |
19 | - acpi_video_flags | ||
19 | - acct | 20 | - acct |
20 | - core_pattern | 21 | - core_pattern |
21 | - core_uses_pid | 22 | - core_uses_pid |
@@ -57,6 +58,15 @@ show up in /proc/sys/kernel: | |||
57 | 58 | ||
58 | ============================================================== | 59 | ============================================================== |
59 | 60 | ||
61 | acpi_video_flags: | ||
62 | |||
63 | flags | ||
64 | |||
65 | See Doc*/kernel/power/video.txt, it allows mode of video boot to be | ||
66 | set during run time. | ||
67 | |||
68 | ============================================================== | ||
69 | |||
60 | acct: | 70 | acct: |
61 | 71 | ||
62 | highwater lowwater frequency | 72 | highwater lowwater frequency |