.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.3 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "lsgpu" "1" "2025-03-27" "igt-gpu-tools 2.2" "General Commands Manual"
.SH Name
lsgpu \- List and inspect GPUs by scanning the PCI bus, DRM, and sysfs
.\" SPDX-License-Identifier: MIT
.
.SH SYNOPSIS
.sp
\fBlsgpu\fP [\fIOPTIONS\fP]
.SH DESCRIPTION
.sp
\fBlsgpu\fP is part of the \fBigt\-gpu\-tools\fP suite, and it is designed to assist in GPU enumeration and debugging. \fBlsgpu\fP  is a command\-line tool for listing and inspecting GPUs available on the system. It scans the PCI bus, DRM subsystem, and sysfs to gather information about detected GPU devices and their properties.
.sp
By default, \fBlsgpu\fP displays a list of GPUs along with basic details. The tool supports additional options to print detailed properties and sysfs attributes, apply filters to select specific devices, and verify access permissions to GPU nodes.
.sp
Filtering can be performed using the \-d or \-\-device option, allowing users to match GPUs based on vendor, PCI attributes, or other criteria. When a filter is applied, only the first matching device is displayed.
.sp
Additionally, \fBlsgpu\fP attempts to open the corresponding DRM device nodes (/dev/dri/cardX, /dev/dri/renderDX) to check for access permissions. It follows the IGT variable search order for selecting the target device:
.INDENT 0.0
.IP 1. 3
The \fB\-\-device\fP option, if provided
.IP 2. 3
The \fBIGT_DEVICE\fP environment variable, if set
.IP 3. 3
The \fB\&.igtrc\fP configuration file (Common::Device setting), if neither of the above is specified
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
Show help text.
.TP
.B  \-n\fP,\fB  \-\-numeric
Print vendor/device as hex
.TP
.B  \-c\fP,\fB  \-\-codename
Print codename instead pretty device name
.TP
.B  \-s\fP,\fB  \-\-print\-simple
Print simple (legacy) device details
.TP
.B  \-p\fP,\fB  \-\-print\-details
Print devices with details
.TP
.B  \-P\fP,\fB  \-\-pci\-scan
Print PCI GPU devices
.TP
.B  \-v\fP,\fB  \-\-list\-vendors
List recognized vendors
.TP
.B  \-l\fP,\fB  \-\-list\-filter\-types
List registered device filters types
.TP
.BI \-d\fP,\fB  \-\-device \ <filter>
Apply a device filter (e.g. \(aqpci:vendor=Intel,device=discrete,card=0\(aq). Can be used multiple times.
.TP
.B  \-V\fP,\fB  \-\-version
Print version information and exit
.UNINDENT
.SS Default print mode options
.sp
These options are only valid when using the default printout mode:
.INDENT 0.0
.TP
.B  \-\-drm
Default: Print DRM filters for each device
.TP
.B  \-\-sysfs
Print sysfs filters for each device
.TP
.B  \-\-pci
Print PCI filters for each device
.UNINDENT
.SH REPORTING BUGS
.sp
Report bugs on fd.o GitLab: \%<https://\:gitlab\:.freedesktop\:.org/\:drm/\:igt-gpu-tools/\:-/\:issues>
.SH Author
IGT Developers <igt-dev@lists.freedesktop.org>
.SH Copyright
2009,2011,2012,2016,2018,2019,2020,2023,2024,2025 Intel Corporation
.\" End of generated man page.