10139N/A<!
DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
10139N/A<!
ENTITY suncopy "Copyright (c) 2004,2006 Sun Microsystems, Inc. All Rights Reserved.">
10139N/A<
refentry id="gdmflexiserver-1">
10139N/A<
refmeta><
refentrytitle>gdmflexiserver</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A<
refmiscinfo class="date">1 Sep 2004</
refmiscinfo>
10139N/A<
refmiscinfo class="sectdesc">&man1;</
refmiscinfo>
10139N/A<
refmiscinfo class="software">&release;</
refmiscinfo>
10139N/A<
refmiscinfo class="arch">generic</
refmiscinfo>
10139N/A<
refmiscinfo class="copyright">&suncopy;</
refmiscinfo>
10139N/A<
indexterm><
primary>gdmflexiserver</
primary></
indexterm><
indexterm><
primary>
10139N/Aruns flexible (on demand) X servers</
primary></
indexterm>
10139N/A<
refnamediv id="gdmflexiserver-1-name"><
refname>gdmflexiserver</
refname><
refpurpose>
10139N/Aruns flexible (on demand) X servers</
refpurpose></
refnamediv>
10139N/A<
refsynopsisdiv id="gdmflexiserver-1-synp"><
title>&synp-tt;</
title>
10139N/A<
cmdsynopsis><
command>&cmd;</
command><
arg choice="opt"><
option>-authenticate
10139N/A</
option></
arg><
arg choice="opt"><
option>-command=<
replaceable>command</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-debug</
option></
arg><
arg choice="opt"><
option>
10139N/A-monte-carlo-pi</
option></
arg><
arg choice="opt"><
option>-no-lock</
option></
arg>
10139N/A<
arg choice="opt"><
option>-xnest</
option></
arg><
arg choice="opt"><
option role="nodash"><
replaceable>
10139N/Agnome-std-options</
replaceable></
option></
arg>
10139N/A<
refsect1 id="gdmflexiserver-1-desc"><
title>&desc-tt;</
title>
10139N/A<
para><
command>&cmd;</
command> runs flexible (on demand) X servers. <
command>&cmd;</
command>
10139N/Aallows a user to log in once and then quits. This is useful if you are logged
10139N/Ain as user A, and user B wants to log in quickly but user A does not wish
10139N/Ato log out. The X server ensures that the virtual terminal switching works
10139N/A<
para>You can use <
command>&cmd;</
command> to run a flexi-server as an Xnest,
10139N/Athat is, an X server in a window. If more than one server is defined with <
literal>
10139N/Aflexible=true</
literal>, a dialog is displayed that lists all available flexible
10139N/A<
refsect1 id="gdmflexiserver-1-opts"><
title>&opts-tt;</
title>
10139N/A<
para>The following options are supported:</
para>
10139N/A<
variablelist termlength="medium">
10139N/A<
varlistentry><
term><
option>a</
option>, <
option>-authenticate</
option></
term><
listitem><
para>
10139N/AAuthenticate before running <
option>-command</
option>.</
para>
10139N/A<
varlistentry><
term><
option>c</
option>, <
option>-command=<
replaceable>command</
replaceable></
option></
term>
10139N/A<
listitem><
para>Send the specified protocol command to GDM.</
para>
10139N/A<
varlistentry><
term><
option>d</
option>, <
option>-debug</
option></
term><
listitem><
para>Debugging
10139N/A<
varlistentry><
term><
option>-monte-carlo-pi</
option></
term><
listitem></
listitem>
10139N/A<
varlistentry><
term><
option>l</
option>, <
option>-no-lock</
option></
term><
listitem><
para>Do not
10139N/A<
varlistentry><
term><
option>n</
option>, <
option>-xnest</
option></
term><
listitem><
para>Xnest mode.</
para>
10139N/A<
varlistentry><
term><
option role="nodash"><
replaceable>gnome-std-options</
replaceable></
option></
term>
10139N/A<
listitem><
para>Standard options available for use with most GNOME applications.
10139N/ASee <
citerefentry><
refentrytitle>gnome-std-options</
refentrytitle><
manvolnum>
10139N/A5</
manvolnum></
citerefentry> for more information.</
para>
10139N/A<
refsect1 id="gdmflexiserver-1-exde"><
title>&exde-tt;</
title>
10139N/A<
para><
command>&cmd;</
command> accepts the following commands with the <
option>
10139N/A-command</
option> option:</
para>
10139N/A<
listitem><
para><
command>ADD_DYNAMIC_DISPLAY</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>ALL_SERVERS</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>ATTACHED_SERVERS</
command></
para></
listitem>
10139N/A<
listitem><
para>AUTH_LOCAL</
para></
listitem>
10139N/A<
listitem><
para><
command>CLOSE</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>FLEXI_XNEST</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>FLEXI_XSERVER</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>GET_CONFIG</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>GET_CONFIG_FILE</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>GET_CUSTOM_CONFIG_FILE</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>GET_SERVER_DETAILS</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>GET_SERVER_LIST</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>GREETERPIDS</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>QUERY_LOGOUT_ACTION</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>QUERY_VT</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>RELEASE_DYNAMIC_DISPLAYS</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>SERVER_BUSY</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>SET_LOGOUT_ACTION</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>SET_SAFE_LOGOUT_ACTION</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>SET_VT</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>UPDATE_CONFIG</
command></
para></
listitem>
10139N/A<
listitem><
para><
command>VERSION</
command></
para></
listitem>
10139N/A<
para>Each command is described in detail in the following sections.</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-ADD_DYNAMIC_DISPLAYS">
10139N/A<
title>ADD_DYNAMIC_DISPLAYS</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>
10139N/ACreate a new server definition that will run on the specified display
10139N/Aleaving it in DISPLAY_CONFIG state.
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.8.0.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>display
10139N/A</
replaceable>=<
replaceable>server</
replaceable>, where <
replaceable>server</
replaceable>
10139N/Ais either a configuration named in the GDM configuration or a literal command name.</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>2</
term><
listitem><
para>Existing display</
para>
10139N/A<
varlistentry><
term>3</
term><
listitem><
para>No server string</
para>
10139N/A<
varlistentry><
term>4</
term><
listitem><
para>Display startup failure</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-ALL_SERVERS">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>List all displays, including
10139N/Aconsole, remote, Xnest. This can be useful to figure out if the server you
10139N/Aare on is managed by the <
literal>gdm</
literal> daemon, by seeing whether
10139N/Ait is in the list. It is also somewhat like the 'w' command but for graphical
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.4.2.96</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>server</
replaceable>;<
replaceable>server</
replaceable>;...
10139N/A<
listitem><
para><
replaceable>server</
replaceable> is <
replaceable>display
10139N/A</
replaceable>,<
replaceable>logged-in-user</
replaceable></
para>
10139N/A<
listitem><
para><
replaceable>logged-in-user</
replaceable> can be empty if
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-ATTACHED_SERVERS">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>List all attached displays,
10139N/ADoes not list XDMCP and Xnest non-attached displays. THis command used to be
10139N/Anamed CONSOLE_SERVERS, which is still recognized for backwards compatibility.
10139N/AThe optional pattern argument is supported as of version 2.8.0.0.
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.2.4.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>pattern</
replaceable> (Optional)</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>server</
replaceable>;<
replaceable>server</
replaceable>;...
10139N/A<
listitem><
para><
replaceable>server</
replaceable> is <
replaceable>display
10139N/A</
replaceable>,<
replaceable>logged-in-user</
replaceable>,<
replaceable>vt-or-xnest-display
10139N/A<
listitem><
para><
replaceable>logged-in-user</
replaceable> can be empty if
10139N/A<
listitem><
para><
replaceable>vt</
replaceable> can be -1 if not known or not
10139N/Asupported. For example, on non-Linux.</
para>
10139N/A<
listitem><
para>If the display is an Xnest display and is a console display
10139N/A(that is, an Xnest inside another console display), the display is listed.
10139N/AInstead of <
replaceable>vt</
replaceable>, lists the parent display in standard
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-AUTH_LOCAL">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Set up this connection
10139N/Aas authenticated for FLEXI_SERVER. All full-blown (non-Xnest) servers can
10139N/Abe started only from users logged in locally. Here, GDM assumes only users
10139N/Alogged in from GDM. Users must pass the xauth MIT-MAGIC-COOKIE-1 that they
10139N/Awere passed before the connection is authenticated.</
para>
10139N/A<
para>Note: The AUTH LOCAL command requires the <
option>-authenticate</
option>
10139N/Aoption, although only FLEXI_XSERVER uses this currently.</
para>
10139N/A<
para>Note: Since 2.6.0.6 you can also use a global
10139N/A<
replaceable>ServAuthDir</
replaceable>/.cookie, which works for all
10139N/Aauthentication except for SET_LOGOUT_ACTION, QUERY_LOGOUT_ACTION, and
10139N/ASET_SAFE_LOGOUT_ACTION which require a logged in display.</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.2.4.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>xauth-cookie
10139N/A</
replaceable>, in hex form with no 0x prefix</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-CLOSE">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Close sockets connection</
para>
11904N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.2.4.0
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem><
para>None</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-FLEXI_XNEST">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Start a new flexible
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.3.90.4</
para>
10139N/A<
para>Note: Supported on older versions from 2.2.4.0, later 2.2.4.2, but since
10139N/A2.3.90.4 you must supply four arguments or ERROR 100 will be returned. This
10139N/Awill start Xnest using the XAUTHORITY file supplied and with the same uid
10139N/Aas the owner of that file (and the same as you supply). You must also supply
10139N/Athe cookie as the third argument for this display, to prove that you indeed
10139N/Aare this user. Also, this file must be readable ONLY by this user, that is,
10139N/Ahave a mode of 0600. If all of these conditions are not met, ERROR 100 is
10139N/A<
para>Note: The cookie should be the MIT-MAGIC-COOKIE-1, the first one that
10139N/AGDM can find in the XAUTHORITY file for this display. If that is not what
10139N/Ayou use, you should generate one first. The cookie should be in hex form.
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>display-to-run-on
10139N/A</
replaceable> <
replaceable>uid-of-requesting-user</
replaceable> <
replaceable>
10139N/Axauth-cookie-for-the-display</
replaceable> <
replaceable>xauth-file</
replaceable></
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>display</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>No more flexi servers</
para>
10139N/A<
varlistentry><
term>2</
term><
listitem><
para>Startup errors</
para>
10139N/A<
varlistentry><
term>3</
term><
listitem><
para>X failed</
para>
10139N/A<
varlistentry><
term>4</
term><
listitem><
para>X too busy</
para>
10139N/A<
varlistentry><
term>5</
term><
listitem><
para>Xnest can't connect</
para>
10139N/A<
varlistentry><
term>6</
term><
listitem><
para>No server binary</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-FLEXI_XSERVER">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Start a new X flexible
10139N/Aserver. Only supported on connection that passed AUTH_LOCAL.</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.2.4.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>xserver-type
10139N/A<
para>If no argument specified, starts the standard x server.</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>display</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>No more flexi servers</
para>
10139N/A<
varlistentry><
term>2</
term><
listitem><
para>Startup errors</
para>
10139N/A<
varlistentry><
term>3</
term><
listitem><
para>X failed</
para>
10139N/A<
varlistentry><
term>4</
term><
listitem><
para>X too busy</
para>
10139N/A<
varlistentry><
term>6</
term><
listitem><
para>No server binary</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-GET_CONFIG">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Get configuration value
10139N/Afor the specified key. Useful so that other applications can request
10139N/Aconfiguration information from GDM. Any key defined as GDM_KEY_* in
gdm.h 10139N/Ais supported. Starting with version 2.13.0.2 translated keys (such as
10139N/AGET_CONFIG. Also starting with version 2.13.0.2 it is no longer necessary
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.6.0.9</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>key</
replaceable></
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>value</
replaceable></
para></
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>50</
term><
listitem><
para>Unsupported key</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-GET_CONFIG_FILE">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Get config file location
10139N/Aused by the daemon. If the GDM daemon was started with the --config option, it
10139N/Awill return the value passed in via the argument.</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.8.0.2</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>full-path-to-config-file</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-GET_CUSTOM_CONFIG_FILE">
10139N/A<
title>GET_CUSTOM_CONFIG_FILE</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Get custom config file
10139N/Alocation being used by the daemon</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.14.0.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>full-path-to-config-file</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>File not found</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-GET_SERVER_DETAILS">
10139N/A<
title>GET_SERVER_DETAILS</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Get detail information
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.13.0.4</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>server</
replaceable>
10139N/A<
replaceable>key</
replaceable></
para>
10139N/A<
para>Valid key values include:</
para>
10139N/A<
listitem><
para>NAME: Returns the server name</
para>
10139N/A<
listitem><
para>COMMAND: Returns the server command</
para>
10139N/A<
listitem><
para>FLEXIBLE: Returns "true" if flexible, "false" otherwise</
para>
10139N/A<
listitem><
para>CHOOSABLE: Returns "true" if choosable, "false" otherwise</
para>
10139N/A<
listitem><
para>HANDLED: Returns "true" if handled, "false" otherwise</
para>
10139N/A<
listitem><
para>CHOOSER: Returns "true" if chooser, "false" otherwise</
para>
10139N/A<
listitem><
para>PRIORITY: Returns process priority</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>value</
replaceable></
para></
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>Server not found</
para>
10139N/A<
varlistentry><
term>2</
term><
listitem><
para>Key not valid</
para>
10139N/A<
varlistentry><
term>50</
term><
listitem><
para>Unsupported key</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-GET_SERVER_LIST">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Get a list of the
10139N/Aserver sections defined in the configuration file</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.13.0.4</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>full-path-to-config-file</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>No servers found</
para>
10139N/A<
varlistentry><
term>50</
term><
listitem><
para>Unsupported key</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-GREETERPIDS">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>List all greeter pids
10139N/Aso that one can send HUP to them to re-read config. Only the root user can
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.3.90.2</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>pid</
replaceable>;<
replaceable>pid</
replaceable>;...
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-QUERY_LOGOUT_ACTION">
10139N/A<
title>QUERY_LOGOUT_ACTION</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Query which logout
10139N/Aactions are possible. Only supported on connection that passed AUTH_LOCAL.
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.5.90.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>action</
replaceable>;<
replaceable>action</
replaceable>;...
10139N/A<
para><
replaceable>action</
replaceable> is <
literal>HALT</
literal>, <
literal>
10139N/AREBOOT</
literal>, or <
literal>SUSPEND</
literal>. An empty list can also be
10139N/Areturned if no action is possible. A '!' is appended to an action if it was
10139N/Aalready set with <
literal>SET_LOGOUT_ACTION</
literal> or <
literal>SET_SAFE_LOGOUT_ACTION
10139N/A</
literal>. Note that <
literal>SET_LOGOUT_ACTION</
literal> has precedence
10139N/Aover <
literal>SET_SAFE_LOGOUT_ACTION</
literal>.</
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-QUERY_VT">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Ask the daemon about
10139N/Athe current virtual terminal. This is useful for logins that do not own <
filename>
10139N/Acurrently, otherwise will get ERROR 8. This is also the way to query whether
10139N/AVT support is available in the daemon. Only supported on connection that passed
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.5.90.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>vt-number</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>8</
term><
listitem><
para>Virtual terminals not supported
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-RELEASE_DYNAMIC_DISPLAYS">
10139N/A<
title>RELEASE_DYNAMIC_DISPLAYS</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>
10139N/ARelease dynamic displays currently in DISPLAY_CONFIG state.
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.8.0.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>display</
replaceable></
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>vt-number</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>Bad display number</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-REMOVE_DYNAMIC_DISPLAYS">
10139N/A<
title>REMOVE_DYNAMIC_DISPLAYS</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>
10139N/ARemove a dynamic display, killing the session and purging the display
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.8.0.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>display</
replaceable></
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>display</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>1</
term><
listitem><
para>Bad display number</
para>
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-SERVER_BUSY">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Returns true if half or
10139N/Amore of the daemon's sockets are busy, false otherwise. Used by slave programs
10139N/Awhich want to ensure they do not overwhelm the sever.</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.13.0.8</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>OK <
replaceable>true</
replaceable> | <
replaceable>false</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-SET_LOGOUT_ACTION">
10139N/A<
title>SET_LOGOUT_ACTION</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Tell the daemon to
10139N/Ahalt, reboot, or suspend after slave process exits. Only supported on connection
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.5.90.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>action</
replaceable></
para>
10139N/A<
para><
replaceable>action</
replaceable> is one of the following:</
para>
10139N/A<
listitem><
para>NONE: Set exit action to 'none'</
para>
10139N/A<
listitem><
para>HALT: Set exit action to 'halt'</
para>
10139N/A<
listitem><
para>REBOOT: Set exit action to 'reboot'</
para>
10139N/A<
listitem><
para>SUSPEND: Set exit action to 'suspend'</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>7</
term><
listitem><
para>Unknown logout action, or not
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-SET_SAFE_LOGOUT_ACTION">
10139N/A<
title>SET_SAFE_LOGOUT_ACTION</
title>
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Tell the daemon to
10139N/Ahalt, reboot, or suspend after all users log out. If only one person logs
10139N/Aout, this is the same as SET_LOGOUT_ACTION. Note that SET_LOGOUT_ACTION has
10139N/Aprecendence over SET_SAFE_LOGOUT_ACTION if set to something other than NONE.
10139N/AIf no user is logged in, the action takes effect immediately. Only supported
10139N/Aon connection that passed AUTH_LOCAL.</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.5.90.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>action</
replaceable></
para>
10139N/A<
para><
replaceable>action</
replaceable> is one of the following:</
para>
10139N/A<
listitem><
para>NONE: Set exit action to 'none'</
para>
10139N/A<
listitem><
para>HALT: Set exit action to 'halt'</
para>
10139N/A<
listitem><
para>REBOOT: Set exit action to 'reboot'</
para>
10139N/A<
listitem><
para>SUSPEND: Set exit action to 'suspend'</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>7</
term><
listitem><
para>Unknown logout action, or not
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-SET_VT">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Change to the specified
10139N/Avirtual terminal. This is useful for logins that do not own <
filename>/
dev/
console 10139N/A</
filename> but are still console logins. Only supported on Linux currently,
10139N/Aotherwise will get ERROR 8. Only supported on connection that passed AUTH_LOCAL.
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.5.90.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>vt</
replaceable></
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>8</
term><
listitem><
para>Virtual terminals not supported
10139N/A<
varlistentry><
term>9</
term><
listitem><
para>Invalid virtual terminal number
10139N/A<
varlistentry><
term>100</
term><
listitem><
para>Not authenticated</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-UPDATE_CONFIG">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Tell the daemon to
10139N/Aupdate the configuration of the specified key. Any user can request
10139N/Athat values are re-read but the daemon will only do so if the file has
10139N/Abeen modified since GDM first read the file. Only users who can change
10139N/Athe GDM configuration file (normally writable only by the root user) can
10139N/Aactually modify the GDM configuration. This command is useful to cause
10139N/Athe GDM to update itself to recognize a change made to the GDM
10139N/Aconfiguration file by the root user.</
para>
10139N/A<
para>Supported with limited keys since 2.3.90.2. Starting with version 2.13.0.0, all GDM keys are supported except
10139N/A<
para>GDM also supports the following psuedokeys:</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para><
replaceable>key</
replaceable>
10139N/A<
para><
replaceable>key</
replaceable> is
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>0</
term><
listitem><
para>Not implemented</
para>
10139N/A<
varlistentry><
term>50</
term><
listitem><
para>Unsupported key</
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect2 id="gdmflexiserver-1-exde-VERSION">
10139N/A<
varlistentry><
term>Description:</
term><
listitem><
para>Query GDM version</
para>
10139N/A<
varlistentry><
term>Supported since:</
term><
listitem><
para>2.2.4.0</
para>
10139N/A<
varlistentry><
term>Arguments:</
term><
listitem><
para>None</
para>
10139N/A<
varlistentry><
term>Answers:</
term><
listitem>
10139N/A<
listitem><
para>GDM <
replaceable>gdm-version</
replaceable></
para>
10139N/A<
listitem><
para>ERROR <
replaceable>error-number</
replaceable> <
replaceable>
10139N/Aerror-description</
replaceable></
para>
10139N/A<
varlistentry><
term>200</
term><
listitem><
para>Too many messages</
para>
10139N/A<
varlistentry><
term>999</
term><
listitem><
para>Unknown error</
para>
10139N/A<
refsect1 id="gdmflexiserver-1-exam"><
title>&exam-tt;</
title>
10139N/A<
title>To See Console GDM Version</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; <
option>-command</
option>=VERSION
10139N/A<
computeroutput>GDM 2.6.0.2</
computeroutput></
screen></
para>
10139N/A<
title>To See All Servers</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; <
option>-command</
option>=ALL_SERVERS
10139N/A<
computeroutput>OK :0,username</
computeroutput></
screen></
para>
10139N/A<
title>To See Console Servers</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; <
option>-command</
option>=ATTACHED_SERVERS
10139N/A<
computeroutput>OK :0,username,-1</
computeroutput></
screen></
para>
10139N/A<
refsect1 id="gdmflexiserver-1-file"><
title>&file-tt;</
title>
10139N/A<
para>The following files are used by this application:</
para>
10139N/A<
variablelist termlength="medium">
10139N/A<
varlistentry><
term><
filename>/
usr/
bin/&cmd;</
filename></
term><
listitem><
para>
10139N/AExecutable for flexible (on demand) X servers</
para>
10139N/A<
refsect1 id="gdmflexiserver-1-attr"><
title>&attr-tt;</
title>
10139N/A<
para>See <
olink targetdocent="REFMAN5" localinfo="attributes-5"><
citerefentry>
10139N/A<
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry></
olink>
10139N/Afor descriptions of the following attributes:</
para>
10139N/A<
tgroup cols="2" colsep="1" rowsep="1"><
colspec colname="COLSPEC0" colwidth="1*">
10139N/A<
colspec colname="COLSPEC1" colwidth="1*">
10139N/A<
row><
entry align="center" valign="middle">ATTRIBUTE TYPE</
entry><
entry align="center" 10139N/Avalign="middle">ATTRIBUTE VALUE</
entry></
row>
10139N/A<
row><
entry><
para>Availability</
para></
entry><
entry><
para>SUNWgnome-display-mgr
10139N/A<
row><
entry colname="COLSPEC0"><
para>Interface stability</
para></
entry><
entry 10139N/Acolname="COLSPEC1"><
para>Volatile</
para></
entry></
row>
10139N/A<
refsect1 id="gdmflexiserver-1-also"><
title>&also-tt;</
title>
10139N/A<!--Reference to another man page--> 10139N/A<!--Reference to a Help manual--> 10139N/A<
para>Latest version of the <
citetitle>GNOME Desktop User Guide</
citetitle>
10139N/A<
citerefentry><
refentrytitle>gdmXnestchooser</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gdmdynamic</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gdmphotosetup</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gdmthemetester</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gdm</
refentrytitle><
manvolnum>1m</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gdm-restart</
refentrytitle><
manvolnum>1m</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gdmsetup</
refentrytitle><
manvolnum>1m</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
10139N/A<
citerefentry><
refentrytitle>gnome-std-options</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>
10139N/A<
refsect1 id="gdmflexiserver-1-note"><
title>¬e-tt;</
title>
10139N/A<
para>Original man page written by Martin K. Petersen <mkp@mkp.net>, George
10139N/ALebl <jirka@5z.com>. Copyright (c) 1998, 1999 by Martin K. Petersen. Copyright
10139N/A(c) 2001, 2003, 2004 by George Lebl. Copyright (c) 2003 by Red Hat, Inc.</
para>
10139N/A<
para>Updated by Brian Cameron, Sun Microsystems Inc., 2004, 2006.</
para>