PCI: Update "pci=resource_alignment" documentation
authorMathias Koehrer <mathias.koehrer@etas.com>
Tue, 9 Aug 2016 08:33:31 +0000 (10:33 +0200)
committerBjorn Helgaas <bhelgaas@google.com>
Tue, 9 Aug 2016 16:59:15 +0000 (11:59 -0500)
commit8b078c603249239f597dc395ac182667c8e0af9c
tree2e739d947afb3ec057c06083821aaf55510d72a1
parent29b4817d4018df78086157ea3a55c1d9424a7cfc
PCI: Update "pci=resource_alignment" documentation

Some uio based PCI drivers, e.g., uio_cif, do not work if the assigned PCI
memory resources are not page aligned.  By using the kernel option
"pci=resource_alignment=<align>@<bus>:<slot>.<func>" it is possible to
request page alignment for memory resources of devices.

However, this is cumbersome when using several devices, and the
bus/slot/func addresses may change if devices are added to or removed from
the system.

Extend the "pci=resource_alignment" option so we can specify the relevant
devices via PCI vendor, device, subvendor, and subdevice IDs.  The
specification of the devices via IDs is indicated by a leading string
"pci:" as argument to "pci=resource_alignment".

The format of the specification is
  pci:<vendor>:<device>[:<subvendor>:<subdevice>]

Examples:
  pci=resource_alignment=4096@pci:8086:9c22:103c:198f
  pci=resource_alignment=pci:8086:9c22       # defaults to PAGE_SIZE align

[bhelgaas: changelog, use actual vendor/device IDs in examples]
Signed-off-by: Mathias Koehrer <mathias.koehrer@etas.com>
Signed-off-by: Bjorn Helgaas <bhelgaas@google.com>
Documentation/kernel-parameters.txt