The GDM package provides quite a few different commands.
The gdm command is really just a script which runs the gdm-binary, passing along any options. Before launching gdm-binary, the gdm wrapper script will source the /etc/profile file to set the standard system environment variables. In order to better support internationalization, it will also set the LC_MESSAGES environment variable to LANG if neither LC_MESSAGES or LC_ALL are set. If you really need to set some additional environment before launching GDM, you can do so in this file.
gdm and gdm-binary Command Line Options
Gives a brief overview of the command line options.
If this option is specified, then gdm does not fork into the background when run. You can use just a single dash with this option to preserve compatibility with XDM.
Tell the daemon that it should not run anything on the console. This means that none of the local servers from the [servers] section will be run, and the console will not be used for communicating errors to the user. An empty [servers] section automatically implies this option.
When clearing the environment internally, preserve all variables starting with LD_. This is mostly for debugging purposes.
Print the version of the GDM daemon.
If started with this option, gdm will init, but only start the first local display and then wait for a GO message in the fifo protocol. No greeter will be shown until the GO message is sent. Also flexiserver requests will be denied and XDMCP will not be started until GO is given. This is useful for initialization scripts which wish to start X early, but where you don't yet want the user to start logging in. So the script would send the GO to the fifo once it is ready and GDM will then continue. This functionality was added in version 188.8.131.52.
The gdmgreeter and gdmlogin are two different login programs, either can be used by GDM. gdmgreeter is themeable with GDM themes while gdmlogin is themable with GTK+ themes. These programs are normally executed by the GDM daemon. Both programs support standard GNOME options.
The gdmchooser is the XDMCP chooser application. The gdmchooser is normally executed by the GDM daemon. It supports the following options for XDM compatibility. This program supports standard GNOME options.
gdmchooser Command Line Options
Socket for XDM communication.
Client address to return in response to XDM. This option is for running gdmchooser with XDM, and is not used within GDM.
Connection type to return in response to XDM. This option is for running gdmchooser with XDM, and is not used within GDM.
gdmconfig is a wrapper script for running gdmsetup for binary name compatibility. gdmconfig is installed to the <sbin>/ directory.
gdmsetup runs a graphical program for modifying the GDM configuration file, gdm.conf. Normally on systems that support the PAM userhelper, this is setup such that when you run gdmsetup as an ordinary user, it will first ask you for your root password before starting. Otherwise, this program may only be run as root. This program supports standard GNOME options.
The gdmXnestchooser command automatically gets the correct display number, sets up access, and runs Xnest with -indirect localhost. This way you get an XDMCP chooser provided by your machine. You can also supply as an argument the hostname whose chooser should be displayed, so gdmXnestchooser somehost will run the XDMCP chooser from host somehost inside an Xnest session. You can make this command do a direct query instead by passing the -d option as well. In addition to the following options, this program also supports standard GNOME options.
gdmXnest is a symbolic link to gdmXnestchooser and is the same as using the --no-query and --no-gdm-check options with gdmXnestchooser. It is useful for running Xnest without actually connecting somewhere. It will print out the display setting on standard output that you can use to connect to this server. This is useful mostly for developers who perhaps wish to test their apps running on a completely separate server.
gdmXnestchooser and gdmXnest Command Line Options
Xnest command line, default is "Xnest"
Extra options for Xnest, default is no options.
Just run Xnest, no query (no chooser)
Do direct query instead of indirect (chooser)
Run broadcast instead of indirect (chooser)
Run in background
Don't check for running GDM
The gdmflexiserver command which runs flexible (on demand) X servers.
gdmflexiserver lets a user log in once and then quits. This is, for example useful if you are logged in as user A, and user B wants to log in quickly but user A does not wish to log out. The X server takes care of the virtual terminal switching so it works transparently. There is also a flexi server as an Xnest, that is an X server in a window. This is requested by running gdmflexiserver.
If there is more than one server defined with flexible=true, then the user is given a dialog with those choices upon running gdmflexiserver
The gdmflexiserver command option provides a way to send arbitrary commands to GDM and can be used to debug problems or in scripts, although gdmflexiserver does require X to be running.
In addition to the following options, gdmflexiserver also supports standard GNOME options.
gdmflexichooser Command Line Options
Send the specified protocol command to gdm
Do not lock current screen
Authenticate before running --command
Allows the user to select an image that will be used as the user's photo by GDM's face browser, if enabled by GDM. The selected file is stored as ~/.face. This program accepts standard GNOME options.
gdmthemetester takes two parameters. The first parameter specifies the environment and the second parameter specifies the path name or the name of a theme to view. This is a tool for viewing a theme outside of GDM. It is useful for testing or viewing themes. gdmthemetester requires that the system support gdmXnest. Note that themes can display differently depending on the theme's "Show mode". gdmthemetester allows viewing the themes in different modes via the environment option. Valid environment values and their meanings follow:
console - In console mode. console-timed - In console non-flexi mode. flexi - In flexi mode. xdmcp - In remote (XDMCP) mode. remote-flexi - In remote (XDMCP) & flexi mode.
gdm-restart stops and restarts GDM by sending the GDM daemon a HUP signal. This command will immediately terminate all sessions and log out users currently logged in with GDM. gdm-restart is installed to the <sbin>/ directory.
gdm-safe-restart stops and restarts GDM by sending the GDM daemon a USR1 signal. GDM will be restarted as soon as all users log out. gdm-safe-restart is installed to the <sbin>/ directory.
gdm-stop stops GDM by sending the GDM daemon a TERM signal. gdm-stop is installed to the <sbin>/ directory.