README.md

GraphicsFuzz

GraphicsFuzz is a testing framework for shader compilers

GraphicsFuzz provides tools to automatically find and simplify bugs in graphics shader compilers. It operates on GLSL shaders, and uses glslangValidator and spirv-tools to additionally target SPIR-V.

Tools

• glsl-reduce: a stand-alone GLSL shader reducer
• glsl-fuzz: a family of tools for testing GLSL shader compilers using randomized metamorphic testing

glsl-reduce

• Introduction: my shader is being weird, now what?
• glsl-reduce walkthrough
• glsl-reduce manual

glsl-fuzz

• How it works (high-level): metamorphic testing using glsl-fuzz
• glsl-fuzz walkthrough
• glsl-generate manual
• glsl-reduce manual (for reducing fuzzed shaders)

Get the GraphicsFuzz tools

• Pre-built binaries are available on the GitHub releases page
• Developer documentation with build instructions

Contribute

• Contributing (requires Google CLA)
• License (Apache 2.0)
• Developer documentation

Further reading

GraphicsFuzz blog posts:

• 17 January 2018: Samsung Galaxy S8 (ARM, Qualcomm)
• 22 January 2018: Nvidia Shield TV, Tablet (Nvidia)
• 25 January 2018: Google Pixel Phone 1, 2 (Qualcomm)
• 5 February 2018: Google Nexus Player (Imagination Technologies)
• 15 February 2018: Huawei Honor 9, 9 lite, 10 (ARM)
• 22 February 2018: Apple iPhone 6, 7, 8, X (Apple, Imagination Technologies)
• 12 March 2018: Samsung Galaxy S6, S7 (ARM, Qualcomm)
• 22 May 2018: Samsung Galaxy S9 (ARM, Qualcomm)

Academic research project blog posts:

• 30 November 2016: Intro
• 1 December 2016: AMD
• 7 December 2016: Apple
• 12 December 2016: ARM
• 15 December 2016: Imagination Technologies
• 20 December 2016: Intel
• 25 January 2017: Nvidia
• 1 February 2017: Qualcomm

Academic publications:

• OOPSLA 2017: Automated Testing of Graphics Shader Compilers
• Metamorphic Testing Workshop at ICSE 2016: Metamorphic Testing for (Graphics) Compilers

This is not an officially supported Google product.