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<
refmeta><
refentrytitle>gdmdynamic</
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>gdmdynamic</
primary></
indexterm><
indexterm><
primary>
10139N/AGDM GDM Dynamic Server Management</
primary></
indexterm>
10139N/A<
refnamediv id="gdmdynamic-1-name"><
refname>gdmdynamic</
refname><
refpurpose>
10139N/AGDM GDM Dynamic Server Management</
refpurpose></
refnamediv>
10139N/A<
refsynopsisdiv id="gdmdynamic-1-synp"><
title>&synp-tt;</
title>
10139N/A<
cmdsynopsis><
command>&cmd;</
command>
10139N/A<
arg choice="opt"><
option>a <
replaceable>display</
replaceable></
option> | <
option>b <
replaceable>display</
replaceable></
option> | <
option>d <
replaceable>display</
replaceable></
option> | <
option>l <
replaceable>pattern</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>r <
replaceable>display</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>s <
replaceable>int</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>t <
replaceable>int</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>v <
replaceable>int</
replaceable></
option></
arg>
10139N/A<
refsect1 id="gdmdynamic-1-desc"><
title>&desc-tt;</
title>
10139N/A<
para>&cmd;<
command></
command> allows the management of displays in a dynamic
10139N/Afashion. It is typically used in environments where it is not possible to list
10139N/Athe possible displays in the GDM configuration files. The
10139N/A<
command>&cmd;</
command> command can be used to create a new display on a
10139N/Aparticular display number, run all newly created displays, or remove a display.
10139N/AThe <
command>&cmd;</
command> can also be used to list all attached displays, or
10139N/Aonly attached displays that match a pattern.</
para>
10139N/AThis program is designed to manage multiple simultaneous requests and
10139N/Aworks to avoid flooding the daemon with requests. If the socket connection
10139N/Ais busy, it will sleep and retry a certain number of times that can be tuned
10139N/Awith the <
option>s</
option> and <
option>t</
option> options.</
para>
10139N/A<
refsect1 id="gdmdynamic-1-opts"><
title>&opts-tt;</
title>
10139N/A<
para>The following options are supported:</
para>
10139N/A<
variablelist termlength="narrow">
10139N/A<
varlistentry><
term><
option>a <
replaceable>display</
replaceable></
option></
term><
listitem><
para>
10139N/AAdd a new display configuration, leaving it in the DISPLAY_CONFIG state. The display will
10139N/Anot actually be started until the display is released by calling <
command>&cmd;</
command>
10139N/Aagain with the <
option>r</
option> option.</
para>
10139N/A<
varlistentry><
term><
option>b</
option></
term><
listitem><
para>
10139N/ABackground mode. Fork child to do the work and return immediately.
10139N/A<
varlistentry><
term><
option>d <
replaceable>display</
replaceable></
option></
term><
listitem><
para>
10139N/ADelete a display, killing the X server and purging the display
10139N/A<
varlistentry><
term><
option>l <
replaceable>pattern</
replaceable></
option></
term><
listitem><
para>
10139N/AList displays via the ATTACHED_SERVERS
10139N/A<
citerefentry><
refentrytitle>gdmflexiserver</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
10139N/Acommand. Without a pattern, all attached displays are lsited. With a pattern, all
10139N/Aattached displays match using glob characters '*', '?' and '[]'.</
para>
10139N/A<
varlistentry><
term><
option>r <
replaceable>display</
replaceable></
option></
term><
listitem><
para>
10139N/ARelease (run) the specified <
replaceable>display</
replaceable> waiting in the DISPLAY_CONFIG state.
10139N/A<
varlistentry><
term><
option>s <
replaceable>int</
replaceable></
option></
term><
listitem><
para>
10139N/AIf the daemon socket is busy, <
command>&cmd;</
command> will sleep an amount of time between
10139N/Aretries. A random number of seconds 0-5 is added to the <
replaceable>int</
replaceable>
10139N/Avalue to help ensure that multiple calls to gdmdynamic do not all try to restart
10139N/Aat the same time. A value of zero causes the sleep time to be 1 second.
10139N/ADefault value is 8 seconds.</
para>
10139N/A<
varlistentry><
term><
option>t <
replaceable>int</
replaceable></
option></
term><
listitem><
para>
10139N/AIf the daemon socket is busy, <
command>&cmd;</
command> will retry to open the connection the
10139N/Aspecified numer of times. Default value is 15.</
para>
10139N/A<
varlistentry><
term><
option>v</
option></
term><
listitem><
para>
10139N/AVerbose mode. Print diagnostic messages about each message sent to GDM.
10139N/A<
refsect1 id="gdmdynamic-1-exam"><
title>&exam-tt;</
title>
10139N/A<
title>Adding display 2 using the [server-Standard] display configuration defined in the GDM configuration file.</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; -a "2=Standard"</
userinput></
screen></
para>
10139N/A<
title>Adding display 3 providing the command to use.</
title>
10139N/A<
title>Release display 3.</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; -r 3</
userinput></
screen></
para>
10139N/A<
title>Deleting display 3.</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; -d 3</
userinput></
screen></
para>
10139N/A<
title>List all displays via the ATTACHED_SERVERS command</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; -l</
userinput></
screen></
para>
10139N/A<
title>List all displays via the ATTACHED_SERVERS command using a pattern to match</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; -l "Xorg*"</
userinput></
screen></
para>
10139N/A<
refsect1 id="gdmdynamic-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 GDM Dynamic Server Management</
para>
10139N/A<
refsect1 id="gdmdynamic-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="gdmdynamic-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>gdmflexiserver</
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="gdmdynamic-1-note"><
title>¬e-tt;</
title>
10139N/A<
para>Written by Brian Cameron, Sun Microsystems Inc., 2006.</
para>