1. Computers
  2. Display Drivers
  3. Graphics Cards
  4. Memory
  5. Motherboards
  6. Processors
  7. Software
  8. Storage
  9. Operating Systems


Facebook RSS Twitter Twitter Google Plus


Phoronix Test Suite

OpenBenchmarking.org

Wiring Up GL_ARB_debug_output For Valve

Valve

Published on 23 February 2013 10:58 AM EST
Written by Michael Larabel in Valve
3 Comments

One of the requests that Valve has long had for Intel and the open-source Linux graphics drivers in general has been supporting GL_ARB_debug_output, an OpenGL extension that assists game/application developers in debugging and optimizing their code. Fortunately, support for this extension is finally being pursued aggressively within Mesa.

The request by Valve for a better GL_ARB_debug_output implementation for Mesa dates back to last July.

Following Intel and Valve collaborating about Linux GPU drivers, Intel made some driver hacks to expose some debugging/performance information hidden behind an environment variable but didn't toy around with the GL_ARB_debug_output extension. Intel's Eric Anholt is now finally getting to properly supporting this OpenGL debug extension.

Per the Khronos specification on GL_ARB_debug_output, here's some of the important parts:
This extension allows the GL to notify applications when various events occur that may be useful during application development and debugging.
...
These events are represented in the form of enumerable messages with a human-readable string representation. Examples of debug events include incorrect use of the GL, warnings of undefined behavior, and performance warnings.
...
The type of the message roughly identifies the nature of the event that caused the message. Examples include errors, performance warnings, or warnings about undefined behavior.
...
Each message is also assigned to a severity level that denotes roughly how "important" that message is in comparison to other messages across all sources and types. For example, notification of a GL error would likely have a higher severity than a performance warning due to redundant state changes.
...
Messages are communicated to the application through an application- defined callback function that is called by the GL implementation on each debug message. The motivation for the callback routine is to free application developers from actively having to query whether a GL error, or any other debuggable event has happened after each call to a GL function. With a callback, developers can keep their code free of debug checks, and only have to react to messages as they occur. In situations where using a callback is not possible, a message log is also provided that stores copies of recent messages until they are actively queried. To control the volume of debug output, messages can be disabled either individually by ID, or entire groups of messages can be turned off based on combination of source and type.
Anholt shared on Friday evening that he has an initial GL_ARB_debug_output implementation for Mesa. Right now this work consists of fourteen patches against core Mesa.

Among the items hooked into reporting for this debug output extension is the Intel WARN_ONCE macro and the perf_debug() function (formerly the fallback_debug() function), which means any of the previously exposed Intel driver performance information is now reported to this new extension. There was also extra checks added for stalling on mapping a buffer object and shader errors and warnings.

With this work coming from Intel's Open-Source Technology Center, obviously it was designed and hooked up primarily for the i965 DRI driver (though the infrastructure and core functionality in Mesa itself) but other Mesa/Gallium3D drivers will be able to build their support atop these patches. The patch series begins here on the mailing list.

About The Author
Michael Larabel is the principal author of Phoronix.com and founded the web-site in 2004 with a focus on enriching the Linux hardware experience and being the largest web-site devoted to Linux hardware reviews, particularly for products relevant to Linux gamers and enthusiasts but also commonly reviewing servers/workstations and embedded Linux devices. Michael has written more than 10,000 articles covering the state of Linux hardware support, Linux performance, graphics hardware drivers, and other topics. Michael is also the lead developer of the Phoronix Test Suite, Phoromatic, and OpenBenchmarking.org automated testing software. He can be followed via and or contacted via .
Latest Linux Hardware Reviews
  1. 13-Way Low-End GPU Comparison With AMD's AM1 Athlon
  2. ASUS AM1I-A: A Mini-ITX Board For Socketed Kabini APUs
  3. Mini-Box M350: A Simple, Affordable Mini-ITX Case
  4. Overclocking The AMD AM1 Athlon & Sempron APUs
Latest Linux Articles
  1. How Much Video RAM Is Needed For Catalyst R3 Graphics?
  2. Ubuntu 12.04 LTS vs. 14.04 LTS Cloud Benchmarks
  3. Ubuntu 12.04.4 vs. 13.10 vs. 14.04 LTS Desktop Benchmarks
  4. AMD OpenCL Performance With AM1 Kabini APUs
Latest Linux News
  1. ReactOS Working On A Community Windows OS
  2. Borderlands Is Being Considered For Linux
  3. Mesa 10.0 & 10.1 Stable Get Updated
  4. Getting Hit By The Variable Performance Of The Public Cloud
  5. Git 2.0 Test Releases Begin With Many Changes
  6. Wine 1.7.17 Works On Its Task Scheduler, C Run-Time
  7. The Improv ARM Board Still Isn't Shipping; Riding A Dead Horse?
  8. Debian To Maintain 6.0 Squeeze As An LTS Release
  9. Wasteland 2 Is Finally Released For Linux Gamers
  10. FreeBSD Advances For ARM, Bhyve, Clang
  11. Ubuntu 14.04 LTS "Trusty Tahr" Officially Released
  12. Ubuntu 12.04 LTS vs. 14.04 LTS Server Benchmarks
Latest Forum Discussions
  1. Updated and Optimized Ubuntu Free Graphics Drivers
  2. Catalyst 14.3 Beta
  3. Suggestions about how to make a Radeon HD 7790 work decently?
  4. The GNOME Foundation Is Running Short On Money
  5. Radeon 8000M problematic on Linux?
  6. Linux Kernel Developers Fed Up With Ridiculous Bugs In Systemd
  7. After Jack Keane, RuseSoft will briing Ankh 3 to Linux through Desura
  8. Suspected PHP Proxy Issue