GDM Commands

The GDM package provides quite a few different commands.

gdm and gdm-binary Command Line Options

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

--help

Gives a brief overview of the command line options.

-nodaemon

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.

--no-console

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.

--preserve-ld-vars

When clearing the environment internally, preserve all variables starting with LD_. This is mostly for debugging purposes.

--version

Print the version of the GDM daemon.

--wait-for-go

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 2.5.90.0.

gdmchooser and gdmlogin Command Line Options

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.

gdmchooser Command Line 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

-xdmaddress=SOCKET

Socket for XDM communication.

--clientaddress=ADDRESS

Client address to return in response to XDM. This option is for running gdmchooser with XDM, and is not used within GDM.

-connectionType=TYPE

Connection type to return in response to XDM. This option is for running gdmchooser with XDM, and is not used within GDM.

gdmconfig and gdmsetup Command Line Options

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.

gdmXnestchooser and gdmXnest Command Line 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

-x, --xnest=STRING

Xnest command line, default is "Xnest"

-o, --xnest-extra-options=OPTIONS

Extra options for Xnest, default is no options.

-n, --no-query

Just run Xnest, no query (no chooser)

-d, --direct

Do direct query instead of indirect (chooser)

-B, --broadcast

Run broadcast instead of indirect (chooser)

-b, --background

Run in background

--no-gdm-check

Don't check for running GDM

gdmflexichooser Command Line Options

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

-c, --command=COMMAND

Send the specified protocol command to gdm

-n, --xnest

Xnest mode

-l, --no-lock

Do not lock current screen

-d, --debug

Debugging output

-a, --authenticate

Authenticate before running --command

gdmphotosetup Command Line Options

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 Command Line 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 Command Line Options

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 Command Line Options

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 Command Line Options

gdm-stop stops GDM by sending the GDM daemon a TERM signal. gdm-stop is installed to the <sbin>/ directory.