diff options
| author | Thomas Gleixner <tglx@linutronix.de> | 2009-03-23 09:50:03 -0400 |
|---|---|---|
| committer | Thomas Gleixner <tglx@linutronix.de> | 2009-03-23 16:20:20 -0400 |
| commit | 80c5520811d3805adcb15c570ea5e2d489fa5d0b (patch) | |
| tree | ae797a7f4af39f80e77526533d06ac23b439f0ab /Documentation | |
| parent | b3e3b302cf6dc8d60b67f0e84d1fa5648889c038 (diff) | |
| parent | 8c083f081d0014057901c68a0a3e0f8ca7ac8d23 (diff) | |
Merge branch 'cpus4096' into irq/threaded
Conflicts:
arch/parisc/kernel/irq.c
kernel/irq/handle.c
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/cputopology.txt | 6 | ||||
| -rw-r--r-- | Documentation/kernel-parameters.txt | 7 | ||||
| -rw-r--r-- | Documentation/x86/boot.txt | 18 | ||||
| -rw-r--r-- | Documentation/x86/earlyprintk.txt | 101 |
4 files changed, 121 insertions, 11 deletions
diff --git a/Documentation/cputopology.txt b/Documentation/cputopology.txt index 45932ec21ce..b41f3e58aef 100644 --- a/Documentation/cputopology.txt +++ b/Documentation/cputopology.txt | |||
| @@ -18,11 +18,11 @@ For an architecture to support this feature, it must define some of | |||
| 18 | these macros in include/asm-XXX/topology.h: | 18 | these macros in include/asm-XXX/topology.h: |
| 19 | #define topology_physical_package_id(cpu) | 19 | #define topology_physical_package_id(cpu) |
| 20 | #define topology_core_id(cpu) | 20 | #define topology_core_id(cpu) |
| 21 | #define topology_thread_siblings(cpu) | 21 | #define topology_thread_cpumask(cpu) |
| 22 | #define topology_core_siblings(cpu) | 22 | #define topology_core_cpumask(cpu) |
| 23 | 23 | ||
| 24 | The type of **_id is int. | 24 | The type of **_id is int. |
| 25 | The type of siblings is cpumask_t. | 25 | The type of siblings is (const) struct cpumask *. |
| 26 | 26 | ||
| 27 | To be consistent on all architectures, include/linux/topology.h | 27 | To be consistent on all architectures, include/linux/topology.h |
| 28 | provides default definitions for any of the above macros that are | 28 | provides default definitions for any of the above macros that are |
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index 54f21a5c262..28de395fa09 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt | |||
| @@ -1310,8 +1310,13 @@ and is between 256 and 4096 characters. It is defined in the file | |||
| 1310 | 1310 | ||
| 1311 | memtest= [KNL,X86] Enable memtest | 1311 | memtest= [KNL,X86] Enable memtest |
| 1312 | Format: <integer> | 1312 | Format: <integer> |
| 1313 | range: 0,4 : pattern number | ||
| 1314 | default : 0 <disable> | 1313 | default : 0 <disable> |
| 1314 | Specifies the number of memtest passes to be | ||
| 1315 | performed. Each pass selects another test | ||
| 1316 | pattern from a given set of patterns. Memtest | ||
| 1317 | fills the memory with this pattern, validates | ||
| 1318 | memory contents and reserves bad memory | ||
| 1319 | regions that are detected. | ||
| 1315 | 1320 | ||
| 1316 | meye.*= [HW] Set MotionEye Camera parameters | 1321 | meye.*= [HW] Set MotionEye Camera parameters |
| 1317 | See Documentation/video4linux/meye.txt. | 1322 | See Documentation/video4linux/meye.txt. |
diff --git a/Documentation/x86/boot.txt b/Documentation/x86/boot.txt index 7b4596ac412..e0203662f9e 100644 --- a/Documentation/x86/boot.txt +++ b/Documentation/x86/boot.txt | |||
| @@ -158,7 +158,7 @@ Offset Proto Name Meaning | |||
| 158 | 0202/4 2.00+ header Magic signature "HdrS" | 158 | 0202/4 2.00+ header Magic signature "HdrS" |
| 159 | 0206/2 2.00+ version Boot protocol version supported | 159 | 0206/2 2.00+ version Boot protocol version supported |
| 160 | 0208/4 2.00+ realmode_swtch Boot loader hook (see below) | 160 | 0208/4 2.00+ realmode_swtch Boot loader hook (see below) |
| 161 | 020C/2 2.00+ start_sys The load-low segment (0x1000) (obsolete) | 161 | 020C/2 2.00+ start_sys_seg The load-low segment (0x1000) (obsolete) |
| 162 | 020E/2 2.00+ kernel_version Pointer to kernel version string | 162 | 020E/2 2.00+ kernel_version Pointer to kernel version string |
| 163 | 0210/1 2.00+ type_of_loader Boot loader identifier | 163 | 0210/1 2.00+ type_of_loader Boot loader identifier |
| 164 | 0211/1 2.00+ loadflags Boot protocol option flags | 164 | 0211/1 2.00+ loadflags Boot protocol option flags |
| @@ -170,10 +170,11 @@ Offset Proto Name Meaning | |||
| 170 | 0224/2 2.01+ heap_end_ptr Free memory after setup end | 170 | 0224/2 2.01+ heap_end_ptr Free memory after setup end |
| 171 | 0226/2 N/A pad1 Unused | 171 | 0226/2 N/A pad1 Unused |
| 172 | 0228/4 2.02+ cmd_line_ptr 32-bit pointer to the kernel command line | 172 | 0228/4 2.02+ cmd_line_ptr 32-bit pointer to the kernel command line |
| 173 | 022C/4 2.03+ initrd_addr_max Highest legal initrd address | 173 | 022C/4 2.03+ ramdisk_max Highest legal initrd address |
| 174 | 0230/4 2.05+ kernel_alignment Physical addr alignment required for kernel | 174 | 0230/4 2.05+ kernel_alignment Physical addr alignment required for kernel |
| 175 | 0234/1 2.05+ relocatable_kernel Whether kernel is relocatable or not | 175 | 0234/1 2.05+ relocatable_kernel Whether kernel is relocatable or not |
| 176 | 0235/3 N/A pad2 Unused | 176 | 0235/1 N/A pad2 Unused |
| 177 | 0236/2 N/A pad3 Unused | ||
| 177 | 0238/4 2.06+ cmdline_size Maximum size of the kernel command line | 178 | 0238/4 2.06+ cmdline_size Maximum size of the kernel command line |
| 178 | 023C/4 2.07+ hardware_subarch Hardware subarchitecture | 179 | 023C/4 2.07+ hardware_subarch Hardware subarchitecture |
| 179 | 0240/8 2.07+ hardware_subarch_data Subarchitecture-specific data | 180 | 0240/8 2.07+ hardware_subarch_data Subarchitecture-specific data |
| @@ -299,14 +300,14 @@ Protocol: 2.00+ | |||
| 299 | e.g. 0x0204 for version 2.04, and 0x0a11 for a hypothetical version | 300 | e.g. 0x0204 for version 2.04, and 0x0a11 for a hypothetical version |
| 300 | 10.17. | 301 | 10.17. |
| 301 | 302 | ||
| 302 | Field name: readmode_swtch | 303 | Field name: realmode_swtch |
| 303 | Type: modify (optional) | 304 | Type: modify (optional) |
| 304 | Offset/size: 0x208/4 | 305 | Offset/size: 0x208/4 |
| 305 | Protocol: 2.00+ | 306 | Protocol: 2.00+ |
| 306 | 307 | ||
| 307 | Boot loader hook (see ADVANCED BOOT LOADER HOOKS below.) | 308 | Boot loader hook (see ADVANCED BOOT LOADER HOOKS below.) |
| 308 | 309 | ||
| 309 | Field name: start_sys | 310 | Field name: start_sys_seg |
| 310 | Type: read | 311 | Type: read |
| 311 | Offset/size: 0x20c/2 | 312 | Offset/size: 0x20c/2 |
| 312 | Protocol: 2.00+ | 313 | Protocol: 2.00+ |
| @@ -468,7 +469,7 @@ Protocol: 2.02+ | |||
| 468 | zero, the kernel will assume that your boot loader does not support | 469 | zero, the kernel will assume that your boot loader does not support |
| 469 | the 2.02+ protocol. | 470 | the 2.02+ protocol. |
| 470 | 471 | ||
| 471 | Field name: initrd_addr_max | 472 | Field name: ramdisk_max |
| 472 | Type: read | 473 | Type: read |
| 473 | Offset/size: 0x22c/4 | 474 | Offset/size: 0x22c/4 |
| 474 | Protocol: 2.03+ | 475 | Protocol: 2.03+ |
| @@ -542,7 +543,10 @@ Protocol: 2.08+ | |||
| 542 | 543 | ||
| 543 | The payload may be compressed. The format of both the compressed and | 544 | The payload may be compressed. The format of both the compressed and |
| 544 | uncompressed data should be determined using the standard magic | 545 | uncompressed data should be determined using the standard magic |
| 545 | numbers. Currently only gzip compressed ELF is used. | 546 | numbers. The currently supported compression formats are gzip |
| 547 | (magic numbers 1F 8B or 1F 9E), bzip2 (magic number 42 5A) and LZMA | ||
| 548 | (magic number 5D 00). The uncompressed payload is currently always ELF | ||
| 549 | (magic number 7F 45 4C 46). | ||
| 546 | 550 | ||
| 547 | Field name: payload_length | 551 | Field name: payload_length |
| 548 | Type: read | 552 | Type: read |
diff --git a/Documentation/x86/earlyprintk.txt b/Documentation/x86/earlyprintk.txt new file mode 100644 index 00000000000..607b1a01606 --- /dev/null +++ b/Documentation/x86/earlyprintk.txt | |||
| @@ -0,0 +1,101 @@ | |||
| 1 | |||
| 2 | Mini-HOWTO for using the earlyprintk=dbgp boot option with a | ||
| 3 | USB2 Debug port key and a debug cable, on x86 systems. | ||
| 4 | |||
| 5 | You need two computers, the 'USB debug key' special gadget and | ||
| 6 | and two USB cables, connected like this: | ||
| 7 | |||
| 8 | [host/target] <-------> [USB debug key] <-------> [client/console] | ||
| 9 | |||
| 10 | 1. There are three specific hardware requirements: | ||
| 11 | |||
| 12 | a.) Host/target system needs to have USB debug port capability. | ||
| 13 | |||
| 14 | You can check this capability by looking at a 'Debug port' bit in | ||
| 15 | the lspci -vvv output: | ||
| 16 | |||
| 17 | # lspci -vvv | ||
| 18 | ... | ||
| 19 | 00:1d.7 USB Controller: Intel Corporation 82801H (ICH8 Family) USB2 EHCI Controller #1 (rev 03) (prog-if 20 [EHCI]) | ||
| 20 | Subsystem: Lenovo ThinkPad T61 | ||
| 21 | Control: I/O- Mem+ BusMaster+ SpecCycle- MemWINV- VGASnoop- ParErr- Stepping- SERR+ FastB2B- DisINTx- | ||
| 22 | Status: Cap+ 66MHz- UDF- FastB2B+ ParErr- DEVSEL=medium >TAbort- <TAbort- <MAbort- >SERR- <PERR- INTx- | ||
| 23 | Latency: 0 | ||
| 24 | Interrupt: pin D routed to IRQ 19 | ||
| 25 | Region 0: Memory at fe227000 (32-bit, non-prefetchable) [size=1K] | ||
| 26 | Capabilities: [50] Power Management version 2 | ||
| 27 | Flags: PMEClk- DSI- D1- D2- AuxCurrent=375mA PME(D0+,D1-,D2-,D3hot+,D3cold+) | ||
| 28 | Status: D0 PME-Enable- DSel=0 DScale=0 PME+ | ||
| 29 | Capabilities: [58] Debug port: BAR=1 offset=00a0 | ||
| 30 | ^^^^^^^^^^^ <==================== [ HERE ] | ||
| 31 | Kernel driver in use: ehci_hcd | ||
| 32 | Kernel modules: ehci-hcd | ||
| 33 | ... | ||
| 34 | |||
| 35 | ( If your system does not list a debug port capability then you probably | ||
| 36 | wont be able to use the USB debug key. ) | ||
| 37 | |||
| 38 | b.) You also need a Netchip USB debug cable/key: | ||
| 39 | |||
| 40 | http://www.plxtech.com/products/NET2000/NET20DC/default.asp | ||
| 41 | |||
| 42 | This is a small blue plastic connector with two USB connections, | ||
| 43 | it draws power from its USB connections. | ||
| 44 | |||
| 45 | c.) Thirdly, you need a second client/console system with a regular USB port. | ||
| 46 | |||
| 47 | 2. Software requirements: | ||
| 48 | |||
| 49 | a.) On the host/target system: | ||
| 50 | |||
| 51 | You need to enable the following kernel config option: | ||
| 52 | |||
| 53 | CONFIG_EARLY_PRINTK_DBGP=y | ||
| 54 | |||
| 55 | And you need to add the boot command line: "earlyprintk=dbgp". | ||
| 56 | (If you are using Grub, append it to the 'kernel' line in | ||
| 57 | /etc/grub.conf) | ||
| 58 | |||
| 59 | NOTE: normally earlyprintk console gets turned off once the | ||
| 60 | regular console is alive - use "earlyprintk=dbgp,keep" to keep | ||
| 61 | this channel open beyond early bootup. This can be useful for | ||
| 62 | debugging crashes under Xorg, etc. | ||
| 63 | |||
| 64 | b.) On the client/console system: | ||
| 65 | |||
| 66 | You should enable the following kernel config option: | ||
| 67 | |||
| 68 | CONFIG_USB_SERIAL_DEBUG=y | ||
| 69 | |||
| 70 | On the next bootup with the modified kernel you should | ||
| 71 | get a /dev/ttyUSBx device(s). | ||
| 72 | |||
| 73 | Now this channel of kernel messages is ready to be used: start | ||
| 74 | your favorite terminal emulator (minicom, etc.) and set | ||
| 75 | it up to use /dev/ttyUSB0 - or use a raw 'cat /dev/ttyUSBx' to | ||
| 76 | see the raw output. | ||
| 77 | |||
| 78 | c.) On Nvidia Southbridge based systems: the kernel will try to probe | ||
| 79 | and find out which port has debug device connected. | ||
| 80 | |||
| 81 | 3. Testing that it works fine: | ||
| 82 | |||
| 83 | You can test the output by using earlyprintk=dbgp,keep and provoking | ||
| 84 | kernel messages on the host/target system. You can provoke a harmless | ||
| 85 | kernel message by for example doing: | ||
| 86 | |||
| 87 | echo h > /proc/sysrq-trigger | ||
| 88 | |||
| 89 | On the host/target system you should see this help line in "dmesg" output: | ||
| 90 | |||
| 91 | SysRq : HELP : loglevel(0-9) reBoot Crashdump terminate-all-tasks(E) memory-full-oom-kill(F) kill-all-tasks(I) saK show-backtrace-all-active-cpus(L) show-memory-usage(M) nice-all-RT-tasks(N) powerOff show-registers(P) show-all-timers(Q) unRaw Sync show-task-states(T) Unmount show-blocked-tasks(W) dump-ftrace-buffer(Z) | ||
| 92 | |||
| 93 | On the client/console system do: | ||
| 94 | |||
| 95 | cat /dev/ttyUSB0 | ||
| 96 | |||
| 97 | And you should see the help line above displayed shortly after you've | ||
| 98 | provoked it on the host system. | ||
| 99 | |||
| 100 | If it does not work then please ask about it on the linux-kernel@vger.kernel.org | ||
| 101 | mailing list or contact the x86 maintainers. | ||
