1*d83cc019SAndroid Build Coastguard Worker============= 2*d83cc019SAndroid Build Coastguard Workerintel_aubdump 3*d83cc019SAndroid Build Coastguard Worker============= 4*d83cc019SAndroid Build Coastguard Worker 5*d83cc019SAndroid Build Coastguard Worker----------------------------------------------------- 6*d83cc019SAndroid Build Coastguard WorkerLaunch an application and capture rendering to an AUB 7*d83cc019SAndroid Build Coastguard Worker----------------------------------------------------- 8*d83cc019SAndroid Build Coastguard Worker.. include:: defs.rst 9*d83cc019SAndroid Build Coastguard Worker:Author: IGT Developers <[email protected]> 10*d83cc019SAndroid Build Coastguard Worker:Date: 2016-03-01 11*d83cc019SAndroid Build Coastguard Worker:Version: |PACKAGE_STRING| 12*d83cc019SAndroid Build Coastguard Worker:Copyright: 2015-2016 Intel Corporation 13*d83cc019SAndroid Build Coastguard Worker:Manual section: |MANUAL_SECTION| 14*d83cc019SAndroid Build Coastguard Worker:Manual group: |MANUAL_GROUP| 15*d83cc019SAndroid Build Coastguard Worker 16*d83cc019SAndroid Build Coastguard WorkerSYNOPSIS 17*d83cc019SAndroid Build Coastguard Worker======== 18*d83cc019SAndroid Build Coastguard Worker 19*d83cc019SAndroid Build Coastguard Worker**intel_aubdump** [*OPTIONS*] -- *COMMAND* [*ARGUMENTS*] 20*d83cc019SAndroid Build Coastguard Worker 21*d83cc019SAndroid Build Coastguard WorkerDESCRIPTION 22*d83cc019SAndroid Build Coastguard Worker=========== 23*d83cc019SAndroid Build Coastguard Worker 24*d83cc019SAndroid Build Coastguard WorkerRun COMMAND with ARGUMENTS and dump an AUB file that captures buffer contents 25*d83cc019SAndroid Build Coastguard Workerand execution of the i915 GEM application. 26*d83cc019SAndroid Build Coastguard Worker 27*d83cc019SAndroid Build Coastguard WorkerOPTIONS 28*d83cc019SAndroid Build Coastguard Worker======= 29*d83cc019SAndroid Build Coastguard Worker 30*d83cc019SAndroid Build Coastguard Worker-v 31*d83cc019SAndroid Build Coastguard Worker Enable verbose mode. 32*d83cc019SAndroid Build Coastguard Worker 33*d83cc019SAndroid Build Coastguard Worker--help 34*d83cc019SAndroid Build Coastguard Worker Output a usage message and exit. 35*d83cc019SAndroid Build Coastguard Worker 36*d83cc019SAndroid Build Coastguard Worker-o FILE, --output=FILE 37*d83cc019SAndroid Build Coastguard Worker Write the trace output to the file FILE. Default is COMMAND.aub. 38*d83cc019SAndroid Build Coastguard Worker 39*d83cc019SAndroid Build Coastguard Worker--device=ID 40*d83cc019SAndroid Build Coastguard Worker Override the PCI ID of the drm device. This is useful for getting an aub 41*d83cc019SAndroid Build Coastguard Worker dump for a different generation of GPU. In this mode **intel_aubdump** will 42*d83cc019SAndroid Build Coastguard Worker intercept but not forward the execbuffer2 ioctl, as that would typically 43*d83cc019SAndroid Build Coastguard Worker cause a GPU hang. 44*d83cc019SAndroid Build Coastguard Worker 45*d83cc019SAndroid Build Coastguard WorkerEXAMPLES 46*d83cc019SAndroid Build Coastguard Worker======== 47*d83cc019SAndroid Build Coastguard Worker 48*d83cc019SAndroid Build Coastguard Workerintel_aubdump -v --output=stuff.aub -- glxgears -geometry 500x500 49*d83cc019SAndroid Build Coastguard Worker Launches glxgears with its -geometry option and enables aub dumping with 50*d83cc019SAndroid Build Coastguard Worker the -v and --output=stuff.aub options. 51*d83cc019SAndroid Build Coastguard Worker 52*d83cc019SAndroid Build Coastguard WorkerREPORTING BUGS 53*d83cc019SAndroid Build Coastguard Worker============== 54*d83cc019SAndroid Build Coastguard Worker 55*d83cc019SAndroid Build Coastguard WorkerReport bugs to https://bugs.freedesktop.org. 56