<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
              "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
<refentry id="glXGetClientString">
    <refmeta>
        <refmetainfo>
            <copyright>
                <year>1991-2006</year>
                <holder>Silicon Graphics, Inc.</holder>
            </copyright>
        </refmetainfo>
        <refentrytitle>glXGetClientString</refentrytitle>
        <manvolnum>3G</manvolnum>
    </refmeta>
    <refnamediv>
        <refname>glXGetClientString</refname>
        <refpurpose>return a string describing the client</refpurpose>
    </refnamediv>
    <refsynopsisdiv><title>C Specification</title>
        <funcsynopsis>
            <funcprototype>
                <funcdef>const char * <function>glXGetClientString</function></funcdef>
                <paramdef>Display * <parameter>dpy</parameter></paramdef>
                <paramdef>int <parameter>name</parameter></paramdef>
            </funcprototype>
        </funcsynopsis>
    </refsynopsisdiv>
    <!-- eqn: ignoring delim $$ -->
    <refsect1 id="parameters"><title>Parameters</title>
        <variablelist>
        <varlistentry>
            <term><parameter>dpy</parameter></term>
            <listitem>
                <para>
                    Specifies the connection to the X server.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><parameter>name</parameter></term>
            <listitem>
                <para>
                    Specifies which string is returned.
                    The symbolic constants <constant>GLX_VENDOR</constant>, <constant>GLX_VERSION</constant>,
                    and <constant>GLX_EXTENSIONS</constant> are accepted.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsect1>
    <refsect1 id="description"><title>Description</title>
        <para>
            <function>glXGetClientString</function> returns a string
            describing some aspect of the client library. The possible values for <parameter>name</parameter> 
            are <constant>GLX_VENDOR</constant>, <constant>GLX_VERSION</constant>, and
            <constant>GLX_EXTENSIONS</constant>. If <parameter>name</parameter>  
            is not set to one of these values, <function>glXGetClientString</function> returns <constant>NULL</constant>. 
            The format and contents of the vendor string is implementation dependent.
        </para>
        <para>
            The extensions string is null-terminated and contains a
            space-separated list of  extension names. (The extension names never
            contain spaces.)  
            If there are no extensions to GLX, then the empty string is returned. 
        </para>
        <para>
            The version string is laid out as follows:
        </para>
        <para>
            &lt;major_version.minor_version&gt;&lt;space&gt;&lt;vendor-specific info&gt;
        </para>
        <para>
            Both the major and minor portions of the version number are of arbitrary 
            length.  The vendor-specific information is optional.  However, if it is 
            present, the format and contents are implementation specific.
        </para>
    </refsect1>
    <refsect1 id="notes"><title>Notes</title>
        <para>
            <function>glXGetClientString</function> is available only if the GLX version is 1.1 or greater.
        </para>
        <para>
            If the GLX version is 1.1 or 1.0, the GL version must be 1.0.
            If the GLX version is 1.2, then the GL version must be 1.1.
            If the GLX version is 1.3, then the GL version must be 1.2.
        </para>
        <para>
            <function>glXGetClientString</function> only returns information about GLX extensions supported by the client. 
            Call <citerefentry><refentrytitle>glGetString</refentrytitle></citerefentry> to get a list of GL extensions supported by the server.
        </para>
    </refsect1>
    <refsect1 id="seealso"><title>See Also</title>
        <para>
            <citerefentry><refentrytitle>glXQueryVersion</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glXQueryExtensionsString</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glXQueryServerString</refentrytitle></citerefentry>
        </para>
    </refsect1>
    <refsect1 id="Copyright"><title>Copyright</title>
        <para>
            Copyright <trademark class="copyright"></trademark> 1991-2006
            Silicon Graphics, Inc. This document is licensed under the SGI
            Free Software B License. For details, see
            <ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
        </para>
    </refsect1>
</refentry>
