xref: /freebsd/usr.sbin/acpi/einj/einj.8 (revision 81bab70dc6205032e58d15a87ccc8549f900316d)
1.\"
2.\" Copyright (c) 2025 Netflix, Inc.
3.\"
4.\" SPDX-License-Identifier: BSD-2-Clause
5.Dd December 17, 2025
6.Dt EINJ 8
7.Os
8.Sh NAME
9.Nm einj
10.Nd ACPI Platform Error Interface error injection
11.Sh SYNOPSIS
12.Nm
13.Cm list
14.Nm
15.Cm inject
16.Op Fl a Ar address
17.Op Fl C Ar APIC ID
18.Oo Fl P Ar device
19.Sm off
20.Cm pci Oo Ar domain \&: Oc Ar bus \&: Ar slot \&: Ar function
21.Sm on
22.Oc
23.Ar type
24.Sh DESCRIPTION
25The
26.Nm
27utility provides a command line interface to the ACPI Platform Error Interface
28.Pq APEI
29error injection facility provided by
30.Xr acpi_einj 4 .
31.Pp
32The
33.Cm list
34command outputs the set of platform errors that can be injected on the
35current host.
36.Pp
37The
38.Cm inject
39command injects a single platform error.
40The
41.Ar type
42argument specifies the type of error to inject,
43for example
44.Dq mem.cor
45to inject a correctable memory error.
46Vendor-specific errors are not supported.
47.Pp
48The
49.Ar address
50argument sets a specific address to use with memory errors.
51.Pp
52The
53.Ar APIC ID
54argument sets a physical processor ID for processor errors.
55.Pp
56The
57.Ar device
58argument sets the target for PCI device errors.
59The argument must follow the format
60.Sm off
61.Cm pci Oo Ar domain \&: Oc Ar bus \&: Ar slot \&: Ar function
62.Sm on .
63.Sh EXAMPLES
64Inject a fatal uncorrectable memory error for the physical address 0x12345678:
65.Pp
66.Dl einj inject -a 0x12345678 mem.fatal
67.Sh SEE ALSO
68.Xr acpi_einj 4
69.Sh HISTORY
70The
71.Nm
72utility first appeared in
73.Fx 16.0 .
74