summaryrefslogtreecommitdiffstats
path: root/docs/envvars.html
diff options
context:
space:
mode:
authorBrian Paul <[email protected]>2011-03-24 11:39:21 -0600
committerBrian Paul <[email protected]>2011-03-24 11:39:23 -0600
commit82dd62fb22c8f88d62e3c77666c6805a2ac6ecd3 (patch)
treed1aed1089b9ffb2173719e6f5ac155d630116c10 /docs/envvars.html
parent4c75d5ae63c356ac9b6d23009ccc9af6205dbb4a (diff)
mesa: new MESA_EXTENSION_MAX_YEAR env var
If set to year X, only report extensions up to that year. This is a work-around for games that try to copy the extensions string to a fixed size buffer and overflow. If a game was released in year X, setting MESA_EXTENSION_MAX_YEAR to that year will likely fix the problem.
Diffstat (limited to 'docs/envvars.html')
-rw-r--r--docs/envvars.html9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/envvars.html b/docs/envvars.html
index c8be8437176..986d2f8eb35 100644
--- a/docs/envvars.html
+++ b/docs/envvars.html
@@ -49,6 +49,15 @@ Setting this variable automatically sets the MESA_TEX_PROG variable as well.
<li>MESA_EXTENSION_OVERRIDE - can be used to enable/disable extensions.
A value such as "GL_EXT_foo -GL_EXT_bar" will enable the GL_EXT_foo extension
and disable the GL_EXT_bar extension.
+<li>MESA_EXTENSION_MAX_YEAR - The GL_EXTENSIONS string returned by Mesa is sorted
+by extension year.
+If this variable is set to year X, only extensions defined on or before year
+X will be reported.
+This is to work-around a bug in some games where the extension string is
+copied into a fixed-size buffer without truncating.
+If the extension string is too long, the buffer overrun can cause the game
+to crash.
+This is a work-around for that.
<li>MESA_GLSL - <a href="shading.html#envvars">shading language compiler options</a>
</ul>