# MSI

## NAME

msi - Message Signaled Interrupt

## SYNOPSIS

Messaged Signaled Interrupts are used in modern PCI as well as
some ARM GIC controllers. MSI objects allow a privileged userspace
process to allocate a range of MSIs and associated IRQ vectors for
use with device drivers to allocate [`interrupt`](https://fuchsia.dev/docs/reference/kernel_objects/interrupts) objects.

## DESCRIPTION

The most common use for an MSI object is to allocate a range of MSIs
to provide to a PCI device's Message Signaled Interrupt Capability.
Subsequently, the platform or PCI bus driver may use this object to
allocate [`interrupt`](https://fuchsia.dev/docs/reference/kernel_objects/interrupts) objects corresponding to those MSIs for use
in downstream device drivers.

## SYSCALLS

- [`zx_msi_allocate()`](https://fuchsia.dev/reference/syscalls/msi_allocate) - allocate a range of message-signaled interrupts
- [`zx_msi_create()`](https://fuchsia.dev/reference/syscalls/msi_create) - create a message-signaled interrupt object

[](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/reference/kernel_objects/msi.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/reference/kernel_objects/msi.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/reference/kernel_objects/msi.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/reference/kernel_objects/msi.md "Edit the source code of this page")