gdmdynamic(1)							   User Commands						     gdmdynamic(1)

NAME

       gdmdynamic - GDM GDM Dynamic Server Management

SYNOPSIS

       gdmdynamic [-a display | -b display | -d display | -l pattern] [-r display] [-s int] [-t int] [-v int]

DESCRIPTION

       gdmdynamic  allows  the management of displays in a dynamic fashion.  It is typically used in environments where it is not possible to list
       the possible displays in the GDM configuration files.  The gdmdynamic command can be used to create a new display on a  particular  display
       number,	run  all  newly  created  displays,  or  remove a display.  The gdmdynamic can also be used to list all attached displays, or only
       attached displays that match a pattern.

       This program is designed to manage multiple simultaneous requests and works to avoid flooding the daemon with requests.	If the socket con-
       nection is busy, it will sleep and retry a certain number of times that can be tuned with the -s and -t options.

OPTIONS

       The following options are supported:

       -a display      Add  a  new  display configuration, leaving it in the DISPLAY_CONFIG state.  The display will not actually be started until
		       the display is released by calling gdmdynamic again with the -r option.

       -b	       Background mode.  Fork child to do the work and return immediately.

       -d display      Delete a display, killing the X server and purging the display configuration.

       -l pattern      List displays via the ATTACHED_SERVERS gdmflexiserver(1), command.  Without a pattern, all attached  displays  are  lsited.
		       With a pattern, all attached displays match using glob characters '*', '?' and '[]'.

       -r display      Release (run) the specified display waiting in the DISPLAY_CONFIG state.

       -s int	       If  the	daemon socket is busy, gdmdynamic will sleep an amount of time between retries.  A random number of seconds 0-5 is
		       added to the int value to help ensure that multiple calls to gdmdynamic do not all try to restart  at  the  same  time.	 A
		       value of zero causes the sleep time to be 1 second.  Default value is 8 seconds.

       -t int	       If the daemon socket is busy, gdmdynamic will retry to open the connection the specified number of times.  Default value is
		       15.

       -v	       Verbose mode.  Print diagnostic messages about each message sent to GDM.

EXAMPLES

       Example 1: Adding display 2 using the [server-Standard] display configuration defined in the GDM configuration file.

       example% gdmdynamic -a "2=Standard"

       Example 2: Adding display 3 providing the command to use.

       example% gdmdynamic -a "3=/usr/X11R6/bin/X -dev /dev/fb2"

       Example 3: Release display 3.

       example% gdmdynamic -r 3

       Example 4: Deleting display 3.

       example% gdmdynamic -d 3

       Example 5: List all displays via the ATTACHED_SERVERS command

       example% gdmdynamic -l

       Example 6: List all displays via the ATTACHED_SERVERS command using a pattern to match

       example% gdmdynamic -l "Xorg*"

FILES

       The following files are used by this application:

       /usr/bin/gdmdynamic     Executable for GDM Dynamic Server Management

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-display-mgr	   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Volatile			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       Latest version of the GNOME Desktop User Guide for your platform.

       gdmXnestchooser(1), gdmflexiserver(1), gdmphotosetup(1), gdmthemetester(1), gdm(1m), gdm-restart(1m), gdmsetup(1m),  attributes(5),  gnome-
       std-options(5)

NOTES

       Written by Brian Cameron, Sun Microsystems Inc., 2006.

SunOS 5.11							    1 Sep 2004							     gdmdynamic(1)