einj(8)

einj8

Acpi platform error interface error injection

Usage

einj list

einj inject [-a address] [-C APIC ID] [-P device pci [domain:] bus:slot:function] type

Overview

The einj utility provides a command line interface to the ACPI Platform Error Interface (APEI) error injection facility provided by acpi_einj(4).

The list command outputs the set of platform errors that can be injected on the current host.

The inject command injects a single platform error. The type argument specifies the type of error to inject, for example “mem.cor” to inject a correctable memory error. Vendor-specific errors are not supported.

The address argument sets a specific address to use with memory errors.

The APIC ID argument sets a physical processor ID for processor errors.

The device argument sets the target for PCI device errors. The argument must follow the format pci[domain:]bus:slot:function

Examples

Inject a fatal uncorrectable memory error for the physical address 0x12345678:

einj inject -a 0x12345678 mem.fatal

History

The einj utility first appeared in FreeBSD 16.0.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.