Documentation/arch/x86/usb-legacy-support.rst

Source file repositories/reference/linux-study-clean/Documentation/arch/x86/usb-legacy-support.rst

File Facts

System: Linux kernel
Corpus path: Documentation/arch/x86/usb-legacy-support.rst
Extension: .rst
Size: 1485 bytes
Lines: 42
Domain: Support Tooling And Documentation
Bucket: Documentation
Inferred role: Support Tooling And Documentation: documentation
Status: atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

No C-style include directives detected by the generator.

Detected Declarations

No top-level syscall, struct, function, initcall, or export declaration detected by the generator.

Annotated Snippet

.. SPDX-License-Identifier: GPL-2.0

==================
USB Legacy support
==================

:Author: Vojtech Pavlik <vojtech@suse.cz>, January 2004


Also known as "USB Keyboard" or "USB Mouse support" in the BIOS Setup is a
feature that allows one to use the USB mouse and keyboard as if they were
their classic PS/2 counterparts.  This means one can use an USB keyboard to
type in LILO for example.

It has several drawbacks, though:

1) On some machines, the emulated PS/2 mouse takes over even when no USB
   mouse is present and a real PS/2 mouse is present.  In that case the extra
   features (wheel, extra buttons, touchpad mode) of the real PS/2 mouse may
   not be available.

2) If AMD64 64-bit mode is enabled, again system crashes often happen,
   because the SMM BIOS isn't expecting the CPU to be in 64-bit mode.  The
   BIOS manufacturers only test with Windows, and Windows doesn't do 64-bit
   yet.

Solutions:

Problem 1)
  can be solved by loading the USB drivers prior to loading the
  PS/2 mouse driver. Since the PS/2 mouse driver is in 2.6 compiled into
  the kernel unconditionally, this means the USB drivers need to be
  compiled-in, too.

Problem 2)
  is usually fixed by a BIOS update. Check the board
  manufacturers web site. If an update is not available, disable USB
  Legacy support in the BIOS. If this alone doesn't help, try also adding
  idle=poll on the kernel command line. The BIOS may be entering the SMM
  on the HLT instruction as well.

Annotation

Atlas domain: Support Tooling And Documentation / Documentation.
Implementation status: atlas-only.

Implementation Notes

This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.