User Commands                                       gdmdynamic(1)



NAME
     gdmdynamic - GDM GDM Dynamic Server Management

SYNOPSIS
     gdmdynamic [-a display  -b display  -d display   -l  pat-
     tern] [-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 confi-
     guration  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 connection 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  DISPLAYCONFIG  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   ATACHEDSERVERS
                     gdmflexiserver(1),  command.  Without a pat-
                     tern,  all  attached  displays  are  lsited.
                     With  a pattern, all attached displays match
                     using glob characters '*', '?' and '[]'.






SunOS 5.11           Last change: 1 Sep 2004                    1






User Commands                                       gdmdynamic(1)



     -r display      Release (run) the specified display  waiting
                     in the DISPLAYCONFIG 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 speci-
                     fied 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  ATACHEDSERVERS  com-
     mand

     example% gdmdynamic -l

     Example 6: List all displays via the  ATACHEDSERVERS  com-
     mand using a pattern to match



SunOS 5.11           Last change: 1 Sep 2004                    2






User Commands                                       gdmdynamic(1)



     example% gdmdynamic -l "Xorg*"

FILES
     The following files are used by this application:

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



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE 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           Last change: 1 Sep 2004                    3