Merge branch 'linus' into smp/hotplug

min_vecs argument set to this limit, and the PCI core will return -ENOSPC

if it can't meet the minimum number of vectors.

The flags argument should normally be set to 0, but can be used to pass the

PCI_IRQ_NOMSI and PCI_IRQ_NOMSIX flag in case a device claims to support

MSI or MSI-X, but the support is broken, or to pass PCI_IRQ_NOLEGACY in

case the device does not support legacy interrupt lines.

By default this function will spread the interrupts around the available

CPUs, but this feature can be disabled by passing the PCI_IRQ_NOAFFINITY

flag.

The flags argument is used to specify which type of interrupt can be used

by the device and the driver (PCI_IRQ_LEGACY, PCI_IRQ_MSI, PCI_IRQ_MSIX).

A convenient short-hand (PCI_IRQ_ALL_TYPES) is also available to ask for

any possible kind of interrupt.  If the PCI_IRQ_AFFINITY flag is set,

pci_alloc_irq_vectors() will spread the interrupts around the available CPUs.

To get the Linux IRQ numbers passed to request_irq() and free_irq() and the

vectors, use the following function:

capped to the supported limit, so there is no need to query the number of

vectors supported beforehand:

	nvec = pci_alloc_irq_vectors(pdev, 1, nvec, 0);

	nvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_ALL_TYPES)

	if (nvec < 0)

		goto out_err;

number to pci_alloc_irq_vectors() function as both 'min_vecs' and

'max_vecs' parameters:

	ret = pci_alloc_irq_vectors(pdev, nvec, nvec, 0);

	ret = pci_alloc_irq_vectors(pdev, nvec, nvec, PCI_IRQ_ALL_TYPES);

	if (ret < 0)

		goto out_err;

the single MSI mode for a device.  It could be done by passing two 1s as

'min_vecs' and 'max_vecs':

	ret = pci_alloc_irq_vectors(pdev, 1, 1, 0);

	ret = pci_alloc_irq_vectors(pdev, 1, 1, PCI_IRQ_ALL_TYPES);

	if (ret < 0)

		goto out_err;

Some devices might not support using legacy line interrupts, in which case

the PCI_IRQ_NOLEGACY flag can be used to fail the request if the platform

can't provide MSI or MSI-X interrupts:

the driver can specify that only MSI or MSI-X is acceptable:

	nvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_NOLEGACY);

	nvec = pci_alloc_irq_vectors(pdev, 1, nvec, PCI_IRQ_MSI | PCI_IRQ_MSIX);

	if (nvec < 0)

		goto out_err;

| ARM            | Cortex-A57      | #832075         | ARM64_ERRATUM_832075    |

| ARM            | Cortex-A57      | #852523         | N/A                     |

| ARM            | Cortex-A57      | #834220         | ARM64_ERRATUM_834220    |

| ARM            | Cortex-A72      | #853709         | N/A                     |

| ARM            | MMU-500         | #841119,#826419 | N/A                     |

|                |                 |                 |                         |

| Cavium         | ThunderX ITS    | #22375, #24313  | CAVIUM_ERRATUM_22375    |

This file allows to turn off the disk entropy contribution. Default

value of this file is '1'(on).

dax (RO)

--------

This file indicates whether the device supports Direct Access (DAX),

used by CPU-addressable storage to bypass the pagecache.  It shows '1'

if true, '0' if not.

discard_granularity (RO)

-----------------------

This shows the size of internal allocation of the device in bytes, if

-------------------

This is the hardware sector size of the device, in bytes.

io_poll (RW)

------------

When read, this file shows the total number of block IO polls and how

many returned success.  Writing '0' to this file will disable polling

for this device.  Writing any non-zero value will enable this feature.

iostats (RW)

-------------

This file is used to control (on/off) the iostats accounting of the

setting from "write back" to "write through", since that will also

eliminate cache flushes issued by the kernel.

write_same_max_bytes (RO)

-------------------------

This is the number of bytes the device can write in a single write-same

command.  A value of '0' means write-same is not supported by this

device.

Jens Axboe <jens.axboe@oracle.com>, February 2009

todo_include_todos = False

primary_domain = 'C'

highlight_language = 'C'

highlight_language = 'guess'

# -- Options for HTML output ----------------------------------------------

- interrupts: Interrupt number for McPDM

- interrupt-parent: The parent interrupt controller

- ti,hwmods: Name of the hwmod associated to the McPDM

- clocks:  phandle for the pdmclk provider, likely <&twl6040>

- clock-names: Must be "pdmclk"

Example:

	interrupt-parent = <&gic>;

	ti,hwmods = "mcpdm";

};

In board DTS file the pdmclk needs to be added:

&mcpdm {

	clocks = <&twl6040>;

	clock-names = "pdmclk";

	status = "okay";

};