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