summaryrefslogtreecommitdiff
path: root/man/intel_aubdump.man
blob: a77947e7f38ee0992d152f62298051d400d9f4fc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
.\" shorthand for double quote that works everywhere.
.ds q \N'34'
.TH intel_aubdump __appmansuffix__ __xorgversion__
.SH NAME
intel_aubdump \- Launch an application and capture rendering to an AUB file
.SH SYNOPSIS
.B intel_aubdump [\fIOPTION\fR]... \fI--\fR \fICOMMAND\fR [\fIARGUMENTS\fR]
.SH DESCRIPTION
.PP
Run
.IR COMMAND
with
.IR ARGUMENTS
and dump an AUB file that captures buffer
contents and execution of the i915 GEM application.
.TP
.B \-v
Enable verbose mode.
.TP
.B \-\^\-help
Output a usage message and exit.
.TP
.BI \-o " FILE" "\fR,\fP \-\^\-output=" FILE
Write the trace output to the file
.IR FILE .
Default is 
.IR COMMAND .aub.
.TP
.BI \-\^\-device= ID
Override the PCI ID of the drm device. This is useful for getting an
aub dump for a different generation of GPU. In this mode intel_aubdump
will intercept but not forward the execbuffer2 ioctl, as that would
typically cause a GPU hang.
.SH EXAMPLES
.TP
intel_aubdump -v --output=stuff.aub -- glxgears -geometry 500x500
Launches glxgears with its -geometry option and enables aub dumping
with the -v and --output=stuff.aub options.