mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-12-27 11:06:41 -05:00
docs: driver-api: fix spelling of "buses".
Replace incorrect plural form "busses" with "buses" in multiple documentation files under "Documentation/driver-api". Signed-off-by: Marneni PoornaChandu <Poornachandumarneni@gmail.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net> Message-ID: <20250917220430.5815-1-Poornachandumarneni@gmail.com>
This commit is contained in:
committed by
Jonathan Corbet
parent
4eb018bd15
commit
395107a7c9
@@ -16,7 +16,7 @@ Bus-Independent Device Accesses
|
||||
Introduction
|
||||
============
|
||||
|
||||
Linux provides an API which abstracts performing IO across all busses
|
||||
Linux provides an API which abstracts performing IO across all buses
|
||||
and devices, allowing device drivers to be written independently of bus
|
||||
type.
|
||||
|
||||
@@ -71,7 +71,7 @@ can be compiler optimised, you can use __readb() and friends to
|
||||
indicate the relaxed ordering. Use this with care.
|
||||
|
||||
While the basic functions are defined to be synchronous with respect to
|
||||
each other and ordered with respect to each other the busses the devices
|
||||
each other and ordered with respect to each other the buses the devices
|
||||
sit on may themselves have asynchronicity. In particular many authors
|
||||
are burned by the fact that PCI bus writes are posted asynchronously. A
|
||||
driver author must issue a read from the same device to ensure that
|
||||
|
||||
@@ -22,7 +22,7 @@ uniformity across the different bus types.
|
||||
|
||||
The current driver model provides a common, uniform data model for describing
|
||||
a bus and the devices that can appear under the bus. The unified bus
|
||||
model includes a set of common attributes which all busses carry, and a set
|
||||
model includes a set of common attributes which all buses carry, and a set
|
||||
of common callbacks, such as device discovery during bus probing, bus
|
||||
shutdown, bus power management, etc.
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ Platform Devices and Drivers
|
||||
|
||||
See <linux/platform_device.h> for the driver model interface to the
|
||||
platform bus: platform_device, and platform_driver. This pseudo-bus
|
||||
is used to connect devices on busses with minimal infrastructure,
|
||||
is used to connect devices on buses with minimal infrastructure,
|
||||
like those used to integrate peripherals on many system-on-chip
|
||||
processors, or some "legacy" PC interconnects; as opposed to large
|
||||
formally specified ones like PCI or USB.
|
||||
|
||||
@@ -8,9 +8,9 @@ This document groups random notes about porting EISA drivers to the
|
||||
new EISA/sysfs API.
|
||||
|
||||
Starting from version 2.5.59, the EISA bus is almost given the same
|
||||
status as other much more mainstream busses such as PCI or USB. This
|
||||
status as other much more mainstream buses such as PCI or USB. This
|
||||
has been possible through sysfs, which defines a nice enough set of
|
||||
abstractions to manage busses, devices and drivers.
|
||||
abstractions to manage buses, devices and drivers.
|
||||
|
||||
Although the new API is quite simple to use, converting existing
|
||||
drivers to the new infrastructure is not an easy task (mostly because
|
||||
@@ -205,7 +205,7 @@ Random notes
|
||||
Converting an EISA driver to the new API mostly involves *deleting*
|
||||
code (since probing is now in the core EISA code). Unfortunately, most
|
||||
drivers share their probing routine between ISA, and EISA. Special
|
||||
care must be taken when ripping out the EISA code, so other busses
|
||||
care must be taken when ripping out the EISA code, so other buses
|
||||
won't suffer from these surgical strikes...
|
||||
|
||||
You *must not* expect any EISA device to be detected when returning
|
||||
|
||||
@@ -165,8 +165,8 @@ The first thing attached to an HDR command is the HDR mode. There are currently
|
||||
for more details):
|
||||
|
||||
* HDR-DDR: Double Data Rate mode
|
||||
* HDR-TSP: Ternary Symbol Pure. Only usable on busses with no I2C devices
|
||||
* HDR-TSL: Ternary Symbol Legacy. Usable on busses with I2C devices
|
||||
* HDR-TSP: Ternary Symbol Pure. Only usable on buses with no I2C devices
|
||||
* HDR-TSL: Ternary Symbol Legacy. Usable on buses with I2C devices
|
||||
|
||||
When sending an HDR command, the whole bus has to enter HDR mode, which is done
|
||||
using a broadcast CCC command.
|
||||
|
||||
@@ -617,12 +617,12 @@ Note that the address you give here is the I2C address, not the IPMI
|
||||
address. So if you want your MC address to be 0x60, you put 0x30
|
||||
here. See the I2C driver info for more details.
|
||||
|
||||
Command bridging to other IPMB busses through this interface does not
|
||||
Command bridging to other IPMB buses through this interface does not
|
||||
work. The receive message queue is not implemented, by design. There
|
||||
is only one receive message queue on a BMC, and that is meant for the
|
||||
host drivers, not something on the IPMB bus.
|
||||
|
||||
A BMC may have multiple IPMB busses, which bus your device sits on
|
||||
A BMC may have multiple IPMB buses, which bus your device sits on
|
||||
depends on how the system is wired. You can fetch the channels with
|
||||
"ipmitool channel info <n>" where <n> is the channel, with the
|
||||
channels being 0-7 and try the IPMB channels.
|
||||
|
||||
@@ -12,7 +12,7 @@ CSI-2 receiver in an SoC.
|
||||
Bus types
|
||||
---------
|
||||
|
||||
The following busses are the most common. This section discusses these two only.
|
||||
The following buses are the most common. This section discusses these two only.
|
||||
|
||||
MIPI CSI-2
|
||||
^^^^^^^^^^
|
||||
@@ -36,7 +36,7 @@ Transmitter drivers
|
||||
|
||||
Transmitter drivers generally need to provide the receiver drivers with the
|
||||
configuration of the transmitter. What is required depends on the type of the
|
||||
bus. These are common for both busses.
|
||||
bus. These are common for both buses.
|
||||
|
||||
Media bus pixel code
|
||||
^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
@@ -230,7 +230,7 @@ LIBNVDIMM/LIBNDCTL: Bus
|
||||
A bus has a 1:1 relationship with an NFIT. The current expectation for
|
||||
ACPI based systems is that there is only ever one platform-global NFIT.
|
||||
That said, it is trivial to register multiple NFITs, the specification
|
||||
does not preclude it. The infrastructure supports multiple busses and
|
||||
does not preclude it. The infrastructure supports multiple buses and
|
||||
we use this capability to test multiple NFIT configurations in the unit
|
||||
test.
|
||||
|
||||
|
||||
@@ -255,7 +255,7 @@ get registered: a child can never be registered, probed or resumed before
|
||||
its parent; and can't be removed or suspended after that parent.
|
||||
|
||||
The policy is that the device hierarchy should match hardware bus topology.
|
||||
[Or at least the control bus, for devices which use multiple busses.]
|
||||
[Or at least the control bus, for devices which use multiple buses.]
|
||||
In particular, this means that a device registration may fail if the parent of
|
||||
the device is suspending (i.e. has been chosen by the PM core as the next
|
||||
device to suspend) or has already suspended, as well as after all of the other
|
||||
@@ -493,7 +493,7 @@ states, like S3).
|
||||
|
||||
Drivers must also be prepared to notice that the device has been removed
|
||||
while the system was powered down, whenever that's physically possible.
|
||||
PCMCIA, MMC, USB, Firewire, SCSI, and even IDE are common examples of busses
|
||||
PCMCIA, MMC, USB, Firewire, SCSI, and even IDE are common examples of buses
|
||||
where common Linux platforms will see such removal. Details of how drivers
|
||||
will notice and handle such removals are currently bus-specific, and often
|
||||
involve a separate thread.
|
||||
|
||||
@@ -18,7 +18,7 @@ optical drives, test equipment, and medical devices) to a host computer.
|
||||
|
||||
Although the old parallel (fast/wide/ultra) SCSI bus has largely fallen
|
||||
out of use, the SCSI command set is more widely used than ever to
|
||||
communicate with devices over a number of different busses.
|
||||
communicate with devices over a number of different buses.
|
||||
|
||||
The `SCSI protocol <https://www.t10.org/scsi-3.htm>`__ is a big-endian
|
||||
peer-to-peer packet based protocol. SCSI commands are 6, 10, 12, or 16
|
||||
@@ -286,7 +286,7 @@ Parallel SCSI (SPI) transport class
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The file drivers/scsi/scsi_transport_spi.c defines transport
|
||||
attributes for traditional (fast/wide/ultra) SCSI busses.
|
||||
attributes for traditional (fast/wide/ultra) SCSI buses.
|
||||
|
||||
.. kernel-doc:: drivers/scsi/scsi_transport_spi.c
|
||||
:export:
|
||||
|
||||
@@ -13,7 +13,7 @@ additional chipselect line is usually active-low (nCS); four signals are
|
||||
normally used for each peripheral, plus sometimes an interrupt.
|
||||
|
||||
The SPI bus facilities listed here provide a generalized interface to
|
||||
declare SPI busses and devices, manage them according to the standard
|
||||
declare SPI buses and devices, manage them according to the standard
|
||||
Linux driver model, and perform input/output operations. At this time,
|
||||
only "master" side interfaces are supported, where Linux talks to SPI
|
||||
peripherals and does not implement such a peripheral itself. (Interfaces
|
||||
|
||||
@@ -5,7 +5,7 @@ Linux Hotplugging
|
||||
=================
|
||||
|
||||
|
||||
In hotpluggable busses like USB (and Cardbus PCI), end-users plug devices
|
||||
In hotpluggable buses like USB (and Cardbus PCI), end-users plug devices
|
||||
into the bus with power on. In most cases, users expect the devices to become
|
||||
immediately usable. That means the system must do many things, including:
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@ structure, with the host as the root (the system's master), hubs as
|
||||
interior nodes, and peripherals as leaves (and slaves). Modern PCs
|
||||
support several such trees of USB devices, usually
|
||||
a few USB 3.0 (5 GBit/s) or USB 3.1 (10 GBit/s) and some legacy
|
||||
USB 2.0 (480 MBit/s) busses just in case.
|
||||
USB 2.0 (480 MBit/s) buses just in case.
|
||||
|
||||
That master/slave asymmetry was designed-in for a number of reasons, one
|
||||
being ease of use. It is not physically possible to mistake upstream and
|
||||
@@ -42,7 +42,7 @@ two. One is intended for *general-purpose* drivers (exposed through
|
||||
driver frameworks), and the other is for drivers that are *part of the
|
||||
core*. Such core drivers include the *hub* driver (which manages trees
|
||||
of USB devices) and several different kinds of *host controller
|
||||
drivers*, which control individual busses.
|
||||
drivers*, which control individual buses.
|
||||
|
||||
The device model seen by USB drivers is relatively complex.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user