Skip to content

Halt and Catch Fire is a collection of Vulkan programs to hang or crash the GPU. Used for testing the Graphics Flight Recorder (gfr) debug layer.

License

Notifications You must be signed in to change notification settings

googlestadia/halt_and_catch_fire

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Synopsis

The Halt And Catch Fire project is a collection Vulkan programs designed to crash or hang the GPU.

These programs are used to tools such as Graphics Flight Recorder to ensure they can effectively detect known classes of defects. Do to the nature of these programs their specific behaviour may differ depending on the specific GPU, driver or OS. Not all programs will crash

This is not an officially supported Google product.

Building

Building on Windows

Run cmake:

> cmake -Bbuild -DCMAKE_GENERATOR_PLATFORM=x64 -H.

Open the solution: build\halt_and_catch_fire.sln

Programs should be run from the build directory, as shaders (*.spv) are loaded from the workind directory.

Building on Linux

$ cmake -Bbuild -H.
$ cd build
$ make

Targets

crash_copy

Attempts to crash by performing a DMA copy using unmapped memory (a use-after-free bug).

crash_shader

Attempts to crash by dispatching a compute shader that writes to unmapped memory (a use-after-free bug).

hang_infinite_loop

Hangs the GPU by running a compute shader with a long running time (a not-quite inifinite loop).

hang_multi_queue

Hangs the GPU by running a compute shader with a long running time on multiple queues (a not-quite inifinite loop).

hang_host_event

Causes a hang by submitting work that waits on an un-set event.

hang_semaphore

Causes a hang by submitting with a binary wait semaphore that's never signaled.

hang_semaphore

Causes a hang by submitting with a binary wait semaphore that's never signaled.

Running a program.

Copy the requires shader and execuatble to the same folder.

hang_host_event requries read_write_shader.comp.spv hang_semaphore requries read_write_shader.comp.spv invalid_local_array_access requires invalid_index.comp.spv

A few command line options are available:

Choose which queue to execute on (for samples that use a single queue):

`--queue [graphics/compute/transfer]

Not all queue types will be available on all devices.

Execute work from a secondary command buffer, if appropriate:

`--secondary

Add debug names and labels:

`--debug_utils

About

Halt and Catch Fire is a collection of Vulkan programs to hang or crash the GPU. Used for testing the Graphics Flight Recorder (gfr) debug layer.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published