aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/00-INDEX8
-rw-r--r--Documentation/feature-removal-schedule.txt20
-rw-r--r--Documentation/laptops/00-INDEX10
-rw-r--r--Documentation/laptops/acer-wmi.txt202
-rw-r--r--Documentation/laptops/sony-laptop.txt (renamed from Documentation/sony-laptop.txt)1
-rw-r--r--Documentation/laptops/sonypi.txt (renamed from Documentation/sonypi.txt)0
-rw-r--r--Documentation/laptops/thinkpad-acpi.txt (renamed from Documentation/thinkpad-acpi.txt)0
-rw-r--r--Documentation/sysctl/kernel.txt29
8 files changed, 254 insertions, 16 deletions
diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX
index 6e9c4050a41b..8d556707bb68 100644
--- a/Documentation/00-INDEX
+++ b/Documentation/00-INDEX
@@ -227,6 +227,8 @@ kref.txt
227 - docs on adding reference counters (krefs) to kernel objects. 227 - docs on adding reference counters (krefs) to kernel objects.
228laptop-mode.txt 228laptop-mode.txt
229 - how to conserve battery power using laptop-mode. 229 - how to conserve battery power using laptop-mode.
230laptops/
231 - directory with laptop related info and laptop driver documentation.
230ldm.txt 232ldm.txt
231 - a brief description of LDM (Windows Dynamic Disks). 233 - a brief description of LDM (Windows Dynamic Disks).
232leds-class.txt 234leds-class.txt
@@ -351,10 +353,6 @@ sh/
351 - directory with info on porting Linux to a new architecture. 353 - directory with info on porting Linux to a new architecture.
352smart-config.txt 354smart-config.txt
353 - description of the Smart Config makefile feature. 355 - description of the Smart Config makefile feature.
354sony-laptop.txt
355 - Sony Notebook Control Driver (SNC) Readme.
356sonypi.txt
357 - info on Linux Sony Programmable I/O Device support.
358sound/ 356sound/
359 - directory with info on sound card support. 357 - directory with info on sound card support.
360sparc/ 358sparc/
@@ -385,8 +383,6 @@ sysrq.txt
385 - info on the magic SysRq key. 383 - info on the magic SysRq key.
386telephony/ 384telephony/
387 - directory with info on telephony (e.g. voice over IP) support. 385 - directory with info on telephony (e.g. voice over IP) support.
388thinkpad-acpi.txt
389 - information on the (IBM and Lenovo) ThinkPad ACPI Extras driver.
390time_interpolators.txt 386time_interpolators.txt
391 - info on time interpolators. 387 - info on time interpolators.
392tipar.txt 388tipar.txt
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt
index ce9503c892b5..4d3aa519eadf 100644
--- a/Documentation/feature-removal-schedule.txt
+++ b/Documentation/feature-removal-schedule.txt
@@ -111,15 +111,6 @@ Who: Christoph Hellwig <hch@lst.de>
111 111
112--------------------------- 112---------------------------
113 113
114What: CONFIG_FORCED_INLINING
115When: June 2006
116Why: Config option is there to see if gcc is good enough. (in january
117 2006). If it is, the behavior should just be the default. If it's not,
118 the option should just go away entirely.
119Who: Arjan van de Ven
120
121---------------------------
122
123What: eepro100 network driver 114What: eepro100 network driver
124When: January 2007 115When: January 2007
125Why: replaced by the e100 driver 116Why: replaced by the e100 driver
@@ -304,3 +295,14 @@ Why: The support code for the old firmware hurts code readability/maintainabilit
304 and slightly hurts runtime performance. Bugfixes for the old firmware 295 and slightly hurts runtime performance. Bugfixes for the old firmware
305 are not provided by Broadcom anymore. 296 are not provided by Broadcom anymore.
306Who: Michael Buesch <mb@bu3sch.de> 297Who: Michael Buesch <mb@bu3sch.de>
298
299---------------------------
300
301What: Solaris/SunOS syscall and binary support on Sparc
302When: 2.6.26
303Why: Largely unmaintained and almost entirely unused. File system
304 layering used to divert library and dynamic linker searches to
305 /usr/gnemul is extremely buggy and unfixable. Making it work
306 is largely pointless as without a lot of work only the most
307 trivial of Solaris binaries can work with the emulation code.
308Who: David S. Miller <davem@davemloft.net>
diff --git a/Documentation/laptops/00-INDEX b/Documentation/laptops/00-INDEX
new file mode 100644
index 000000000000..729c2c062e10
--- /dev/null
+++ b/Documentation/laptops/00-INDEX
@@ -0,0 +1,10 @@
100-INDEX
2 - This file
3acer-wmi.txt
4 - information on the Acer Laptop WMI Extras driver.
5sony-laptop.txt
6 - Sony Notebook Control Driver (SNC) Readme.
7sonypi.txt
8 - info on Linux Sony Programmable I/O Device support.
9thinkpad-acpi.txt
10 - information on the (IBM and Lenovo) ThinkPad ACPI Extras driver.
diff --git a/Documentation/laptops/acer-wmi.txt b/Documentation/laptops/acer-wmi.txt
new file mode 100644
index 000000000000..b06696329cff
--- /dev/null
+++ b/Documentation/laptops/acer-wmi.txt
@@ -0,0 +1,202 @@
1Acer Laptop WMI Extras Driver
2http://code.google.com/p/aceracpi
3Version 0.1
49th February 2008
5
6Copyright 2007-2008 Carlos Corbacho <carlos@strangeworlds.co.uk>
7
8acer-wmi is a driver to allow you to control various parts of your Acer laptop
9hardware under Linux which are exposed via ACPI-WMI.
10
11This driver completely replaces the old out-of-tree acer_acpi, which I am
12currently maintaining for bug fixes only on pre-2.6.25 kernels. All development
13work is now focused solely on acer-wmi.
14
15Disclaimer
16**********
17
18Acer and Wistron have provided nothing towards the development acer_acpi or
19acer-wmi. All information we have has been through the efforts of the developers
20and the users to discover as much as possible about the hardware.
21
22As such, I do warn that this could break your hardware - this is extremely
23unlikely of course, but please bear this in mind.
24
25Background
26**********
27
28acer-wmi is derived from acer_acpi, originally developed by Mark
29Smith in 2005, then taken over by Carlos Corbacho in 2007, in order to activate
30the wireless LAN card under a 64-bit version of Linux, as acerhk[1] (the
31previous solution to the problem) relied on making 32 bit BIOS calls which are
32not possible in kernel space from a 64 bit OS.
33
34[1] acerhk: http://www.cakey.de/acerhk/
35
36Supported Hardware
37******************
38
39Please see the website for the current list of known working hardare:
40
41http://code.google.com/p/aceracpi/wiki/SupportedHardware
42
43If your laptop is not listed, or listed as unknown, and works with acer-wmi,
44please contact me with a copy of the DSDT.
45
46If your Acer laptop doesn't work with acer-wmi, I would also like to see the
47DSDT.
48
49To send me the DSDT, as root/sudo:
50
51cat /sys/firmware/acpi/DSDT > dsdt
52
53And send me the resulting 'dsdt' file.
54
55Usage
56*****
57
58On Acer laptops, acer-wmi should already be autoloaded based on DMI matching.
59For non-Acer laptops, until WMI based autoloading support is added, you will
60need to manually load acer-wmi.
61
62acer-wmi creates /sys/devices/platform/acer-wmi, and fills it with various
63files whose usage is detailed below, which enables you to control some of the
64following (varies between models):
65
66* the wireless LAN card radio
67* inbuilt Bluetooth adapter
68* inbuilt 3G card
69* mail LED of your laptop
70* brightness of the LCD panel
71
72Wireless
73********
74
75With regards to wireless, all acer-wmi does is enable the radio on the card. It
76is not responsible for the wireless LED - once the radio is enabled, this is
77down to the wireless driver for your card. So the behaviour of the wireless LED,
78once you enable the radio, will depend on your hardware and driver combination.
79
80e.g. With the BCM4318 on the Acer Aspire 5020 series:
81
82ndiswrapper: Light blinks on when transmitting
83bcm43xx/b43: Solid light, blinks off when transmitting
84
85Wireless radio control is unconditionally enabled - all Acer laptops that support
86acer-wmi come with built-in wireless. However, should you feel so inclined to
87ever wish to remove the card, or swap it out at some point, please get in touch
88with me, as we may well be able to gain some data on wireless card detection.
89
90To read the status of the wireless radio (0=off, 1=on):
91cat /sys/devices/platform/acer-wmi/wireless
92
93To enable the wireless radio:
94echo 1 > /sys/devices/platform/acer-wmi/wireless
95
96To disable the wireless radio:
97echo 0 > /sys/devices/platform/acer-wmi/wireless
98
99To set the state of the wireless radio when loading acer-wmi, pass:
100wireless=X (where X is 0 or 1)
101
102Bluetooth
103*********
104
105For bluetooth, this is an internal USB dongle, so once enabled, you will get
106a USB device connection event, and a new USB device appears. When you disable
107bluetooth, you get the reverse - a USB device disconnect event, followed by the
108device disappearing again.
109
110Bluetooth is autodetected by acer-wmi, so if you do not have a bluetooth module
111installed in your laptop, this file won't exist (please be aware that it is
112quite common for Acer not to fit bluetooth to their laptops - so just because
113you have a bluetooth button on the laptop, doesn't mean that bluetooth is
114installed).
115
116For the adventurously minded - if you want to buy an internal bluetooth
117module off the internet that is compatible with your laptop and fit it, then
118it will work just fine with acer-wmi.
119
120To read the status of the bluetooth module (0=off, 1=on):
121cat /sys/devices/platform/acer-wmi/wireless
122
123To enable the bluetooth module:
124echo 1 > /sys/devices/platform/acer-wmi/bluetooth
125
126To disable the bluetooth module:
127echo 0 > /sys/devices/platform/acer-wmi/bluetooth
128
129To set the state of the bluetooth module when loading acer-wmi, pass:
130bluetooth=X (where X is 0 or 1)
131
1323G
133**
134
1353G is currently not autodetected, so the 'threeg' file is always created under
136sysfs. So far, no-one in possession of an Acer laptop with 3G built-in appears to
137have tried Linux, or reported back, so we don't have any information on this.
138
139If you have an Acer laptop that does have a 3G card in, please contact me so we
140can properly detect these, and find out a bit more about them.
141
142To read the status of the 3G card (0=off, 1=on):
143cat /sys/devices/platform/acer-wmi/threeg
144
145To enable the 3G card:
146echo 1 > /sys/devices/platform/acer-wmi/threeg
147
148To disable the 3G card:
149echo 0 > /sys/devices/platform/acer-wmi/threeg
150
151To set the state of the 3G card when loading acer-wmi, pass:
152threeg=X (where X is 0 or 1)
153
154Mail LED
155********
156
157This can be found in most older Acer laptops supported by acer-wmi, and many
158newer ones - it is built into the 'mail' button, and blinks when active.
159
160On newer (WMID) laptops though, we have no way of detecting the mail LED. If
161your laptop identifies itself in dmesg as a WMID model, then please try loading
162acer_acpi with:
163
164force_series=2490
165
166This will use a known alternative method of reading/ writing the mail LED. If
167it works, please report back to me with the DMI data from your laptop so this
168can be added to acer-wmi.
169
170The LED is exposed through the LED subsystem, and can be found in:
171
172/sys/devices/platform/acer-wmi/leds/acer-mail:green/
173
174The mail LED is autodetected, so if you don't have one, the LED device won't
175be registered.
176
177If you have a mail LED that is not green, please report this to me.
178
179Backlight
180*********
181
182The backlight brightness control is available on all acer-wmi supported
183hardware. The maximum brightness level is usually 15, but on some newer laptops
184it's 10 (this is again autodetected).
185
186The backlight is exposed through the backlight subsystem, and can be found in:
187
188/sys/devices/platform/acer-wmi/backlight/acer-wmi/
189
190Credits
191*******
192
193Olaf Tauber, who did the real hard work when he developed acerhk
194http://www.informatik.hu-berlin.de/~tauber/acerhk
195All the authors of laptop ACPI modules in the kernel, whose work
196was an inspiration in the early days of acer_acpi
197Mathieu Segaud, who solved the problem with having to modprobe the driver
198twice in acer_acpi 0.2.
199Jim Ramsay, who added support for the WMID interface
200Mark Smith, who started the original acer_acpi
201
202And the many people who have used both acer_acpi and acer-wmi.
diff --git a/Documentation/sony-laptop.txt b/Documentation/laptops/sony-laptop.txt
index 7a5c1a81905c..8b2bc1572d98 100644
--- a/Documentation/sony-laptop.txt
+++ b/Documentation/laptops/sony-laptop.txt
@@ -114,4 +114,3 @@ Bugs/Limitations:
114 sonypi driver (through /dev/sonypi) does not try to use the 114 sonypi driver (through /dev/sonypi) does not try to use the
115 sony-laptop driver. In the future, spicctrl could try sonypi first, 115 sony-laptop driver. In the future, spicctrl could try sonypi first,
116 and if it isn't present, try sony-laptop instead. 116 and if it isn't present, try sony-laptop instead.
117
diff --git a/Documentation/sonypi.txt b/Documentation/laptops/sonypi.txt
index 4857acfc50f1..4857acfc50f1 100644
--- a/Documentation/sonypi.txt
+++ b/Documentation/laptops/sonypi.txt
diff --git a/Documentation/thinkpad-acpi.txt b/Documentation/laptops/thinkpad-acpi.txt
index 6c2477754a2a..6c2477754a2a 100644
--- a/Documentation/thinkpad-acpi.txt
+++ b/Documentation/laptops/thinkpad-acpi.txt
diff --git a/Documentation/sysctl/kernel.txt b/Documentation/sysctl/kernel.txt
index 8984a5396271..dc8801d4e944 100644
--- a/Documentation/sysctl/kernel.txt
+++ b/Documentation/sysctl/kernel.txt
@@ -41,6 +41,7 @@ show up in /proc/sys/kernel:
41- pid_max 41- pid_max
42- powersave-nap [ PPC only ] 42- powersave-nap [ PPC only ]
43- printk 43- printk
44- randomize_va_space
44- real-root-dev ==> Documentation/initrd.txt 45- real-root-dev ==> Documentation/initrd.txt
45- reboot-cmd [ SPARC only ] 46- reboot-cmd [ SPARC only ]
46- rtsig-max 47- rtsig-max
@@ -280,6 +281,34 @@ send before ratelimiting kicks in.
280 281
281============================================================== 282==============================================================
282 283
284randomize-va-space:
285
286This option can be used to select the type of process address
287space randomization that is used in the system, for architectures
288that support this feature.
289
2900 - Turn the process address space randomization off by default.
291
2921 - Make the addresses of mmap base, stack and VDSO page randomized.
293 This, among other things, implies that shared libraries will be
294 loaded to random addresses. Also for PIE-linked binaries, the location
295 of code start is randomized.
296
297 With heap randomization, the situation is a little bit more
298 complicated.
299 There a few legacy applications out there (such as some ancient
300 versions of libc.so.5 from 1996) that assume that brk area starts
301 just after the end of the code+bss. These applications break when
302 start of the brk area is randomized. There are however no known
303 non-legacy applications that would be broken this way, so for most
304 systems it is safe to choose full randomization. However there is
305 a CONFIG_COMPAT_BRK option for systems with ancient and/or broken
306 binaries, that makes heap non-randomized, but keeps all other
307 parts of process address space randomized if randomize_va_space
308 sysctl is turned on.
309
310==============================================================
311
283reboot-cmd: (Sparc only) 312reboot-cmd: (Sparc only)
284 313
285??? This seems to be a way to give an argument to the Sparc 314??? This seems to be a way to give an argument to the Sparc