fgl_glxgears(1) display info about a GLX extension and OpenGL renderer


fgl_glxgears [-display display] [-loop frames] [-info] [-fbo]
fgl_glxgears [-help]



is a modified version of the original glxgears(1) demo, which demonstrates the usage of pixel buffers (pbuffers) with an ATI graphics board and a patched version of libGL.so.

The three gear wheels are rendered to a pbuffer or frame buffer object instead of to a window. The result is texture mapped on the four faces of a cube. Using the arrow keys, you can change the position relative to the gears.


Without an option, fgl_glxgears prints a brief adapter info. To get a more verbose output, you should make use of the following command line options:

-display display

Use this option to specify the display, where the output should be redirected. Use the DISPLAY environment variable to get the default host, display number and screen (default).

-loop frames

Exit the application after the defined number of frames.


Print GLX information (vendor etc.) to stdout. This cannot be used with -fbo option.


Use GL_EXT_framebuffer_object instead of GLX_SGIX_pbuffer.


Print a short summary of options and their usage.


The following diagnostics may be issued:

fglX11AllocateManagedSurface: __FGLTexMgrCreateObject failed!!
FGLTexMgr: open of shared memory object failed (..)
__FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!!

You don't have POSIX shared memory enabled on your system. Please refer to your kernel documentation and mount(8) for information about how to enable POSIX shared memory support.

FGLTexMgr: open of shared memory object failed (Permission denied)

The file /dev/shm/ATISHM00 already exists and you simply lack permission to overwrite it or the directory has bad permissions. Fix the one or the other.

Error: couldn't get fbconfig

This error occurs if there is a problem with ATI's version of libGL.so. Maybe the diversion does not work properly or you did overwrite this library with the one derived from DRI or you have conflicting versions installed. Try updatedb(1), locate(1) and dpkg-divert(1). See also the following warning.

fglrx: libGL version undetermined - OpenGL module is using glapi fallback

See above.

libGL error: XF86DRIQueryDirectRenderingCapable returned false

Ensure you are loading the correct modules for your AGP chipset before you load the fglrx(4x) kernel module. To determine which modules you'll need, check lspci | grep -i agp.

libGL error: failed to open DRM: Operation not permitted
libGL error: reverting to (slow) indirect rendering

You probably simply miss the permission to open a DRM device. Check Section "DRI" of your xorg.conf(5x).



To get the default host, display number and screen.


Set this variable to verbose to print more diagnostic messages, e.g. if the DRI driver fails to load. This could be useful if you observe problems with your 3D acceleration. Any error message printed should be (hopefully) self-explanatory.


Daniel Leidert <[email protected]>



Copyright © 2005-2006 Daniel Leidert

See the file /usr/share/doc/fglrx_man/COPYING for license and warranty information.