/etc/gdm/gdm.conf

back

1. GDM System Defaults Configuration file.
3. This file should not be updated by hand. Since GDM 2.13.0.4, configuration
4. choices in the GDM System Configuration file (/etc/gdm/gdm.conf) will
5. override the default values specified in this file.
7. If you were using an older version of GDM, your system may have the the older
8. gdm.conf configuration file on the system. If so, then this file is used
9. instead of the GDM Custom Configuration file for backwards support. If you
10. make changes to the GDM Custom Configuration file and they seem to not be
11. taking effect, this is likely the problem. Consider migrating your
12. configuration to the new configuration file and removing the gdm.conf file.
14. You can use the gdmsetup program to graphically edit the gdm.conf-custom
15. file. Note that gdmsetup does not support every option in this file, just
16. the most common ones that users want to change. If you feel that gdmsetup
17. should support additional configuration options, please file a bug report at
18. http://bugzilla.gnome.org/.
20. If you hand-edit the GDM configuration, you should run the following command
21. to get the GDM daemon to recognize the change. Any running GDM GUI programs
22. will also be notified to update with the new configuration.
24. gdmflexiserver --command="UPDATE_CONFIG <configuration key>"
26. e.g, the "Enable" key in the "[debug]" section would be "debug/Enable".
28. You can also run invoke-rc.d gdm reload or invoke-rc.d gdm restart
29. to cause GDM to restart and re-read the new configuration settings.
30. You can also restart GDM by sending a HUP or USR1 signal to the
31. daemon. HUP behaves like restart and causes any user session
32. started by GDM to exit immediately while USR1 behaves like
33. reload and will wait until all users log out before
34. restarting GDM.
36. For full reference documentation see the GNOME help browser under
37. GNOME|System category. You can also find the docs in HTML form on
38. http://www.gnome.org/projects/gdm/
40. NOTE: Some values are commented out, but show their default values. Lines
41. that begin with "#" are considered comments.
43. Have fun!

[daemon]

1. Automatic login, if true the first attached screen will automatically logged
2. in as user as set with AutomaticLogin key.

AutomaticLoginEnable=false AutomaticLogin=

1. Timed login, useful for kiosks. Log in a certain user after a certain amount
2. of time.

TimedLoginEnable=false TimedLogin= TimedLoginDelay=30

1. The GDM configuration program that is run from the login screen, you should
2. probably leave this alone.
3. Configurator=/usr/sbin/gdmsetup --disable-sound --disable-crash-dialog

1. The chooser program. Must output the chosen host on stdout, probably you
2. should leave this alone.
3. Chooser=/usr/lib/gdm/gdmchooser

1. The greeter for attached (non-xdmcp) logins. Change gdmlogin to gdmgreeter
2. to get the new graphical greeter.

Greeter=/usr/lib/gdm/gdmgreeter

1. The greeter for xdmcp logins, usually you want a less graphically intensive
2. greeter here so it's better to leave this with gdmlogin
3. RemoteGreeter=/usr/lib/gdm/gdmlogin

1. Launch the greeter with an additional list of colon separated GTK+ modules.
2. This is useful for enabling additional feature support e.g. GNOME
3. accessibility framework. Only "trusted" modules should be allowed to minimize
4. security holes
5. AddGtkModules=false
6. By default, these are the accessibility modules.
7. GtkModulesList=gail:atk-bridge:/usr/lib/gtk-2.0/modules/libdwellmouselistener:/usr/lib/gtk-2.0/modules/libkeymouselistener

1. Default path to set. The profile scripts will likely override this value.

DefaultPath=/usr/local/bin:/usr/bin:/bin:/usr/bin/X11:/usr/games

1. Default path for root. The profile scripts will likely override this value.

RootPath=/usr/local/bin:/usr/local/sbin:/sbin:/usr/sbin:/bin:/usr/bin:/usr/bin/X11:/usr/games

1. If you are having trouble with using a single server for a long time and want
2. GDM to kill/restart the server, turn this on. On Solaris, this value is
3. always true and this configuration setting is ignored.
4. AlwaysRestartServer=

1. User and group used for running GDM GUI applications. By default this is set
2. to user "gdm" and group "gdm". This user/group should have very limited
3. permissions and access to only the gdm directories and files.

User=gdm Group=gdm

1. To try to kill all clients started at greeter time or in the Init script.
2. does not always work, only if those clients have a window of their own.
3. KillInitClients=true

LogDir=/var/log/gdm

1. Note that a post login script is run before a PreSession script. It is run
2. after the login is successful and before any setup is run on behalf of the
3. user.

PostLoginScriptDir=/etc/gdm/PostLogin/ PreSessionScriptDir=/etc/gdm/PreSession/ PostSessionScriptDir=/etc/gdm/PostSession/ DisplayInitDir=/etc/gdm/Init

1. Distributions: If you have some script that runs an X server in say VGA
2. mode, allowing a login, could you please send it to me?

FailsafeXServer=/etc/gdm/failsafeXServer

1. if X keeps crashing on us we run this script. The default one does a bunch
2. of cool stuff to figure out what to tell the user and such and can run an X
3. configuration program.

XKeepsCrashing=/etc/gdm/XKeepsCrashing

1. System command support.
3. Reboot, Halt and suspend commands, you can add different commands separated
4. by a semicolon. GDM will use the first one it can find.

RebootCommand=/sbin/shutdown -r now "Rebooted via gdm." HaltCommand=/sbin/shutdown -h now "Shut Down via gdm." SuspendCommand=/usr/sbin/pm-suspend HibernateCommand=/usr/sbin/pm-hibernate

1. The following options specify how GDM system commands are supported.
3. Specify which actions are displayed in the greeter. Valid values are HALT,
4. REBOOT, HIBERNATE, SUSPEND, and CUSTOM_CMD separated by semicolons.

SystemCommandsInMenu=HALT;REBOOT;HIBERNATE;SUSPEND;CUSTOM_CMD

1. Specify which actions are supported by QUERY_LOGOUT_ACTION, SET_LOGOUT_ACTION
2. and SET_SAFE_LOGOUT_ACTION. Valid values are HALT, REBOOT, HIBERNATE, SUSPEND, and
3. CUSTOM_CMD separated by semicolons.

AllowLogoutActions=HALT;REBOOT;HIBERNATE;SUSPEND;CUSTOM_CMD

1. This feature is only functional if GDM is compiled with RBAC (Role Based
2. Access Control) support.
3. Specify the RBAC key used to determine if the user has permission to use
4. the action via QUERY_LOGOUT_ACTION, SET_LOGOUT_ACTION and
5. SET_SAFE_LOGOUT_ACTION. The GDM GUI will only display the action if the
6. "gdm" user has RBAC permissions to use the action. RBAC keys for multiple
7. actions can be specified by separating them by semicolons. The format for
8. each is "Action:RBAC key". If an action is not specified, it is assumed
9. all users have permission for this action. For example:
10. HALT:key.for.halt,REBOOT:key.for.reboot,[...]

RBACSystemCommandKeys=

1. Probably should not touch the below this is the standard setup.

ServAuthDir=/var/lib/gdm

1. This is our standard startup script. A bit different from a normal X
2. session, but it shares a lot of stuff with that. See the provided default
3. for more information.

BaseXsession=/etc/gdm/Xsession

1. This is a directory where .desktop files describing the sessions live. It is
2. really a PATH style variable since 2.4.4.2 to allow actual interoperability
3. with KDM.

SessionDesktopDir=/usr/share/gdm/BuiltInSessions/:/usr/share/xsessions/:/var/lib/menu-xdg/xsessions/:/etc/dm/Sessions/

1. This is the default .desktop session. One of the ones in SessionDesktopDir

DefaultSession=default.desktop

1. Better leave this blank and HOME will be used. You can use syntax ~/ below
2. to indicate home directory of the user. You can also set this to something
3. like /tmp if you don't want the authorizations to be in home directories.
4. This is useful if you have NFS mounted home directories. Note that if this
5. is the home directory the UserAuthFBDir will still be used in case the home
6. directory is NFS, see security/NeverPlaceCookiesOnNFS to override this
7. behavior.

UserAuthDir=

1. Fallback directory for writing authorization file if user's home directory
2. is not writable.

UserAuthFBDir=/tmp UserAuthFile=.Xauthority

1. The X server to use if we can't figure out what else to run.

StandardXServer=/usr/bin/X

1. The maximum number of flexible X servers to run.
2. FlexibleXServers=5
3. And after how many minutes should we reap the flexible server if there is no
4. activity and no one logged on. Set to 0 to turn off the reaping. Does not
5. affect nested flexiservers.
6. FlexiReapDelayMinutes=5

1. The X nest command.
2. Examples of valid commands (assuming installed to /usr/X11/bin:
3. Xorg Xnest: /usr/X11/bin/Xnest -audit 0 -name Xnest
4. Xsun Xnest: /usr/openwin/bin/Xnest -audit 0 -name Xnest -pn
5. Xephyr: /usr/X11/bin/Xephyr -audit 0

Xnest=/usr/share/gdm/gdmXnestWrapper -br -audit 0

1. Xsun Xnest does not support font paths (passed into Xnest -fp argument)
2. that include the ":unscaled" suffix after a path name. Setting this to
3. false will strip any ":unscaled" suffix from the font path. If not
4. using this Xnest, the value should be true.

XnestUnscaledFontPath=true

1. Automatic VT allocation. Right now only works on Linux. This way we force
2. X to use specific vts. Turn VTAllocation to false if this is causing
3. problems.

FirstVT=7 VTAllocation=true

1. Should double login be treated with a warning (and possibility to change VT's
2. on Linux and FreeBSD systems for console logins)
3. DoubleLoginWarning=true
4. Should a second login always resume the current session and switch VT's on
5. Linux and FreeBSD systems for console logins
6. AlwaysLoginCurrentSession=true

1. If true then the last login information is printed to the user before being
2. prompted for password. While this gives away some info on what users are on
3. a system, it on the other hand should give the user an idea of when they
4. logged in and if it doesn't seem kosher to them, they can just abort the
5. login and contact the sysadmin (avoids running malicious startup scripts).
6. DisplayLastLogin=false

1. Program used to play sounds. Should not require any 'daemon' or anything
2. like that as it will be run when no one is logged in yet.

SoundProgram=/usr/lib/gdmplay

1. These are the languages that the console cannot handle because of font
2. issues. Here we mean the text console, not X. This is only used when there
3. are errors to report and we cannot start X.
4. This is the default:
5. ConsoleCannotHandle=am,ar,az,bn,el,fa,gu,hi,ja,ko,ml,mr,pa,ta,zh

1. This determines whether GDM will honor requests DYNAMIC requests from the
2. gdmdynamic command.
3. DynamicXServers=false

1. This determines whether GDM will send notifications to the console.
2. ConsoleNotify=true

1. How long gdm should wait before it assumes a started Xserver is defunct and
2. kills it. 10 seconds should be long enough for X, but Xgl may need 20 or 25.

GdmXserverTimeout=10

[security]

1. Allow root to login. It makes sense to turn this off for kiosk use, when
2. you want to minimize the possibility of break in.

AllowRoot=false

1. Allow login as root via XDMCP. This value will be overridden and set to
2. false if the /etc/default/login file exists and contains
3. "CONSOLE=/dev/login", and set to true if the /etc/default/login file exists
4. and contains any other value or no value for CONSOLE.

AllowRemoteRoot=false

1. This will allow remote timed login.

AllowRemoteAutoLogin=false

1. 0 is the most restrictive, 1 allows group write permissions, 2 allows all
2. write permissions.

RelaxPermissions=1

1. Check if directories are owned by logon user. Set to false, if you have, for
2. example, home directories owned by some other user.

CheckDirOwner=true

1. If your HOME is managed by automounter, set to true

SupportAutomount=false

1. Number of seconds to wait after a failed login
2. RetryDelay=1
3. Maximum size of a file we wish to read. This makes it hard for a user to DoS
4. us by using a large file.
5. UserMaxFile=65536
6. If true this will basically append -nolisten tcp to every X command line, a
7. good default to have (why is this a "negative" setting? because if it is
8. false, you could still not allow it by setting command line of any particular
9. server). It's probably better to ship with this on since most users will not
10. need this and it's more of a security risk then anything else.
11. Note: Anytime we find a -query or -indirect on the command line we do not add
12. a "-nolisten tcp", as then the query just wouldn't work, so this setting only
13. affects truly attached sessions.

DisallowTCP=true

1. By default never place cookies if we "detect" NFS. We detect NFS by
2. detecting "root-squashing". It seems bad practice to place cookies on things
3. that go over the network by default and thus we do not do it by default.
4. Sometimes you can however use safe remote filesystems where this is OK and
5. you may want to have the cookie in your home directory.
6. NeverPlaceCookiesOnNFS=true
7. Will cause PAM_DISALLOW_NULL_AUTHTOK to be passed as a flag to
8. pam_authenticate and pam_acct_mgmt, disallowing NULL password. This setting
9. will only take effect if PAM is being used by GDM. This value will be
10. overridden with the value from /etc/default/login if it contains
11. "PASSREQ=[YES|NO]"
12. PasswordRequired=false
13. Specifies the PAM Stack to use, "gdm" by default.

PamStack=gdm

1. GDM allows configuration of how ut_line is set when it does utmp/wtmp and
2. audit processing. If VT is being used, then ut_line will be set to the
3. device associated with the VT. If the console is attached and has a device
4. name specified in the [servers] section, then this value will be used.
5. Otherwise the value is defaulted to the value specified in UtmpLineAttached
6. for attached displays and UtmpLineRemote for remote displays. The value
7. can be left empty which means that ut_line will be set to an empty value
8. (if not VT and no value specified in the [servers] section. The values
9. can contain "%d" which is translated to the DISPLAY value or %h which
10. is translated to the hostname. The values for both keys must begin with
11. "/dev/".

UtmpLineAttached=/dev/console UtmpLineRemote=

1. If true and the specified UtmpLineAttached or UtmpLineRemote does not exist,
2. then create a pseudo-device filename that will be touched when the utmp
3. record is updated. Creating such a psuedo-device ensures that programs
4. that stat the utmp device associated with ut_line such as finger, last,
5. etc. work in a reasonable way.

UtmpPseudoDevice=false

1. XDMCP is the protocol that allows remote login. If you want to log into GDM
2. remotely (I'd never turn this on on open network, use ssh for such remote
3. usage). You can then run X with -query <thishost> to log in, or
4. -indirect <thishost> to run a chooser. Look for the 'Terminal' server type
5. at the bottom of this config file.

[xdmcp]

1. Distributions: Ship with this off. It is never a safe thing to leave out on
2. the net. Setting up /etc/hosts.allow and /etc/hosts.deny to only allow local
3. access is another alternative but not the safest. Firewalling port 177 is
4. the safest if you wish to have xdmcp on. Read the manual for more notes on
5. the security of XDMCP.

Enable=false

1. Honor indirect queries, we run a chooser for these, and then redirect the
2. user to the chosen host. Otherwise we just log the user in locally.
3. HonorIndirect=true
4. Maximum pending requests.
5. MaxPending=4
6. MaxPendingIndirect=4
7. Maximum open XDMCP sessions at any point in time.
8. MaxSessions=16
9. Maximum wait times.
10. MaxWait=15
11. MaxWaitIndirect=15
12. How many times can a person log in from a single host. Usually better to
13. keep low to fend off DoS attacks by running many logins from a single host.
14. This is now set at 2 since if the server crashes then GDM doesn't know for
15. some time and wouldn't allow another session.
16. DisplaysPerHost=2
17. The number of seconds after which a non-responsive session is logged off.
18. Better keep this low.
19. PingIntervalSeconds=15
20. The port. 177 is the standard port so better keep it that way.
21. Port=177
22. Willing script, none is shipped and by default we'll send hostname system id.
23. But if you supply something here, the output of this script will be sent as
24. status of this host so that the chooser can display it. You could for
25. example send load, or mail details for some user, or some such.
26. Willing=/etc/gdm/Xwilling

[gui]

1. The specific gtkrc file we use. It should be the full path to the gtkrc that
2. we need. Unless you need a specific gtkrc that doesn't correspond to a
3. specific theme, then just use the GtkTheme key.
4. GtkRC=/usr/share/themes/Default/gtk-2.0/gtkrc

1. The GTK+ theme to use for the GUI.

GtkTheme=Human

1. If to allow changing the GTK+ (widget) theme from the greeter. Currently
2. this only affects the standard greeter as the graphical greeter does not yet
3. have this ability.
4. AllowGtkThemeChange=true
5. Comma separated list of themes to allow. These must be the names of the
6. themes installed in the standard locations for gtk themes. You can also
7. specify 'all' to allow all installed themes. These should be just the
8. basenames of the themes such as 'Thinice' or 'LowContrast'.
9. GtkThemesToAllow=all

1. Maximum size of an icon, larger icons are scaled down.
2. MaxIconWidth=128
3. MaxIconHeight=128

[greeter]

1. The following options for setting titlebar and setting window position are
2. only useful for the standard login (gdmlogin) and are not used by the
3. themed login (gdmgreeter).
5. The standard login has a title bar that the user can move.
6. TitleBar=true
7. Don't allow user to move the standard login window. Only makes sense if
8. TitleBar is on.
9. LockPosition=false
10. Set a position for the standard login window rather then just centering the
11. window. If you enter negative values for the position it is taken as an
12. offset from the right or bottom edge.
13. SetPosition=false
14. PositionX=0
15. PositionY=0

1. Enable the Face browser. Note that the Browser key is only used by the
2. standard login (gdmlogin) program. The Face Browser is enabled in
3. the Graphical greeter by selecting a theme that includes the Face
4. Browser, such as happygnome-list. The other configuration values that
5. affect the Face Browser (MinimalUID, DefaultFace, Include, Exclude,
6. IncludeAll, GlobalFaceDir) are used by both the Standard and Themed
7. greeter.

Browser=true

1. The default picture in the browser.
2. DefaultFace=/usr/share/pixmaps/nobody.png
3. User ID's less than the MinimalUID value will not be included in the face
4. browser or in the gdmselection list for Automatic/Timed login. They will not
5. be displayed regardless of the settings for Include and Exclude.

MinimalUID=1000

1. Users listed in Include will be included in the face browser and in the
2. gdmsetup selection list for Automatic/Timed login. Users should be separated
3. by commas.
4. Include=
5. Users listed in Exclude are excluded from the face browser and from the
6. gdmsetup selection list for Automatic/Timed login. Excluded users will still
7. be able to log in, but will have to type their username. Users should be
8. separated by commas.

Exclude=nobody

1. By default, an empty include list means display no users. By setting
2. IncludeAll to true, the password file will be scanned and all users will be
3. displayed except users excluded via the Exclude setting and user ID's less
4. than MinimalUID. Scanning the password file can be slow on systems with
5. large numbers of users and this feature should not be used in such
6. environments. The setting of IncludeAll does nothing if Include is set to a
7. non-empty value.

IncludeAll=true

1. If user or user.png exists in this dir it will be used as his picture.
2. GlobalFaceDir=/usr/share/pixmaps/faces/

1. File which contains the locale we show to the user. Likely you want to use
2. the one shipped with GDM and edit it. It is not a standard locale.alias
3. file, although GDM will be able to read a standard locale.alias file as well.

LocaleFile=/etc/gdm/locale.conf

1. Logo shown in the standard greeter.

Logo=/usr/share/pixmaps/gdmDebianLogo.xpm

1. Logo shown on file chooser button in gdmsetup (do not modify this value).
2. ChooserButtonLogo=/usr/share/pixmaps/gdm-foot-logo.png
3. The standard greeter should shake if a user entered the wrong username or
4. password. Kind of cool looking
5. Quiver=true

1. The Actions menu (formerly system menu) is shown in the greeter, this is the
2. menu that contains reboot, shutdown, suspend, config and chooser. None of
3. these is available if this is off. They can be turned off individually
4. however.
5. SystemMenu=true
6. Configuration is available from the system menu of the greeter.

ConfigAvailable=false

1. Should the chooser button be shown. If this is shown, GDM can drop into
2. chooser mode which will run the xdmcp chooser locally and allow the user to
3. connect to some remote host. Local XDMCP does not need to be enabled,
4. however.
5. ChooserButton=true

1. Welcome is for all console logins and RemoteWelcome is for remote logins
2. (through XDMCP).
3. DefaultWelcome and DefaultRemoteWelcome set the string for Welcome to
4. "Welcome" and for DefaultWelcome to "Welcome to %n", and properly translate
5. the message to the appropriate language. Note that %n gets translated to the
6. hostname of the machine. These default values can be overridden by setting
7. DefaultWelcome and/or DefaultRemoteWelcome to false, and setting the Welcome
8. and DefaultWelcome values as desired. Just make sure the strings are in
9. utf-8 Note to distributors, if you wish to have a different Welcome string
10. and wish to have this translated you can have entries such as
11. "Welcome[cs]=Vitejte na %n".

DefaultWelcome=true DefaultRemoteWelcome=true

1. Welcome=Welcome
2. RemoteWelcome=Welcome to %n

1. Xinerama screen we use to display the greeter on. Not for true multihead,
2. currently only works for Xinerama.
3. XineramaScreen=0
4. Background settings for the standard greeter:
5. Type can be 0=None, 1=Image & Color, 2=Color, 3=Image
6. BackgroundType=2
7. BackgroundImage=
8. BackgroundScaleToFit=true
9. The Standard greeter (gdmlogin) uses BackgroundColor as the background
10. color, while the themed greeter (gdmgreeter) uses GraphicalThemedColor
11. as the background color.

BackgroundColor=#dab082 GraphicalThemedColor=#dab082

1. XDMCP session should only get a color, this is the sanest setting since you
2. don't want to take up too much bandwidth
3. BackgroundRemoteOnlyColor=true

1. Program to run to draw the background in the standard greeter. Perhaps
2. something like an xscreensaver hack or some such.
3. BackgroundProgram=
4. If this is true then the background program is run always, otherwise it is
5. only run when the BackgroundType is 0 (None).
6. RunBackgroundProgramAlways=false
7. Delay before starting background program
8. BackgroundProgramInitialDelay=30
9. Should the background program be restarted if it is exited.
10. RestartBackgroundProgram=true
11. Delay before restarting background program
12. BackgroundProgramRestartDelay=30

1. Show the Failsafe sessions. These are much MUCH nicer (focus for xterm for
2. example) and more failsafe then those supplied by scripts so distros should
3. use this rather then just running an xterm from a script.
4. ShowGnomeFailsafeSession=true
5. ShowXtermFailsafeSession=true
6. Normally there is a session type called 'Last' that is shown which refers to
7. the last session the user used. If off, we will be in 'switchdesk' mode
8. where the session saving stuff is disabled in GDM
9. ShowLastSession=true
10. Always use 24 hour clock no matter what the locale.
11. Use24Clock=auto
12. Do not show any visible feedback in the password field. This is standard for
13. instance in console, xdm and ssh.
14. UseInvisibleInEntry=false

1. These two keys are for the themed greeter (gdmgreeter). Circles is the
2. standard shipped theme. If you want GDM to select a random theme from a
3. list then provide a list that is delimited by /: to the GraphicalThemes
4. key and set GraphicalThemeRand to true. Otherwise use GraphicalTheme
5. and specify just one theme.

GraphicalTheme=Human

1. GraphicalThemes=bijou/:blueswirl/:circles/:debblue-list/:debblue/:ayo/:debian-dawn/:debian-greeter/:debian/:glassfoot/:hantzley/:happygnome/:industrial/:crystal/:linsta

GraphicalThemeDir=/usr/share/gdm/themes/ GraphicalThemeRand=false

1. If InfoMsgFile points to a file, the greeter will display the contents of the
2. file in a modal dialog box before the user is allowed to log in.
3. InfoMsgFile=
4. If InfoMsgFile is present then InfoMsgFont can be used to specify the font to
5. be used when displaying the contents of the file.
6. InfoMsgFont=Sans 24

1. If SoundOnLogin is true, then the greeter will beep when login is ready for
2. user input. If SoundOnLogin is a file and the greeter finds the 'play'
3. executable (see daemon/SoundProgram) it will play that file instead of just
4. beeping.
5. SoundOnLogin=true

SoundOnLoginFile=/usr/share/sounds/question.wav

1. If SoundOnLoginSuccess, then the greeter will play a sound (as above) when a
2. user successfully logs in.
3. SoundOnLoginSuccess=false
4. SoundOnLoginSuccessFile=
5. If SoundOnLoginFailure, then the greeter will play a sound (as above) when a
6. user fails to log in.
7. SoundOnLoginFailure=false
8. SoundOnLoginFailureFile=

1. Specifies a program to be called by the greeter/login program when the
2. initial screen is displayed. The purpose is to provide a hook where files
3. used after login can be preloaded to speed performance for the user. The
4. program will only be called once only, the first time a greeter is displayed.
5. The gdmprefetch command may be used. This utility will load any libraries
6. passed in on the command line, or if the argument starts with a "@"
7. character, it will process the file assuming it is an ASCII file containing a
8. list of libraries, one per line, and load each library in the file.

PreFetchProgram=/usr/lib/gdm/gdmprefetch @/etc/gdm/gdmprefetchlist

1. The chooser is what's displayed when a user wants an indirect XDMCP session,
2. or selects Run XDMCP chooser from the system menu

[chooser]

1. Default image for hosts.
2. DefaultHostImg=/usr/share/pixmaps/nohost.png
3. Directory with host images, they are named by the hosts: host or host.png.

HostImageDir=/usr/share/hosts/

1. Time we scan for hosts (well only the time we tell the user we are scanning
2. actually, we continue to listen even after this has expired).
3. ScanTime=4
4. A comma separated lists of hosts to automatically add (if they answer to a
5. query of course). You can use this to reach hosts that broadcast cannot
6. reach.

Hosts=

1. Broadcast a query to get all hosts on the current network that answer.

Broadcast=true

1. Set it to true if you want to send a multicast query to hosts.

Multicast=false

1. It is an IPv6 multicast address.It is hardcoded here and will be replaced
2. when officially registered xdmcp multicast address of TBD will be available.
3. Multicast_Addr=ff02::1
4. Allow adding random hosts to the list by typing in their names.
5. AllowAdd=true

[debug]

1. This will cause GDM to send debugging information to the system log, which
2. will create a LOT of output. It is not recommended to turn this on for
3. normal use, but it can be useful to determine the cause when GDM is not
4. working properly.

Enable=false

1. This will enable debug messages for accessibilty gesture listeners into the
2. syslog. This includes output about key events, mouse button events, and
3. pointer motion events. This is useful for figuring out the cause of why the
4. gesture listeners may not be working, but is too verbose for general debug.

Gestures=false

1. Attached DISPLAY Configuration

[servers]

1. This section defines which attached DISPLAYS should be started by GDM by
2. default. You can add as many DISPLAYS as desired and they will always be
3. started. The key for each entry must be a unique number that cooresponds to
4. the DISPLAY number to start the X server. For a typical single-display
5. machine, there will only be one entry "0" for DISPLAY ":0". The first word
6. in the value corresponds to an X server definition in the "X Server
7. Definitions" section of the configuration file. For example, the entry:
9. 0=Standard
11. Means that DISPLAY ":0" will start an X server as defined in the
12. [server-Standard] section.
14. The optional device argument is used to specify the device that is associated
15. with the DISPLAY. When using Virtual Terminals (VT), this value is ignored
16. and GDM will use the correct device name associated with the VT. If not
17. using VT, then GDM will use the value specified by this optional argument.
18. If the device argument is not defined, then GDM will use the default setting
19. for attached displays defined in the UtmpLineAttached configuration option.
20. For the main display (typically DISPLAY ":0"), "/dev/console" is a reasonable
21. value. For other displays it is probably best to not include this argument
22. unless you know the specific device associated with the DISPLAY. The device
23. value can contain "%d" which is translated to the DISPLAY value or %h which
24. is translated to the hostname.

0=Standard device=/dev/console

1. Example of how to set up DISPLAY :1 to also use Standard.
2. 1=Standard

1. If you wish to run the XDMCP chooser on the local display use the following
2. line
3. 0=Chooser

1. X Server Definitions
3. Note: Is your X server not listening to TCP requests? Refer to the
4. security/DisallowTCP setting!

[server-Standard] name=Standard server command=/usr/bin/X -br -audit 0 flexible=true

1. Indicates that the X server should be started at a different process
2. priority. Values can be any integer value accepted by the setpriority C
3. library function (normally between -20 and 20) with 0 being the default. For
4. highly interactive applications, -5 yields good responsiveness. The default
5. value is 0 and the setpriority function is not called if the value is 0.

1. priority=0

1. To use this server type you should add -query host or -indirect host to the
2. command line.

[server-Terminal] name=Terminal server

1. Add -terminate to make things behave more nicely

command=/usr/bin/X -br -audit 0 -terminate

1. Make this not appear in the flexible servers (we need extra params anyway,
2. and terminate would be bad for xdmcp choosing). You can make a terminal
3. server flexible, but not with an indirect query. If you need flexible
4. indirect query server, then you must get rid of the -terminate and the only
5. way to kill the flexible server will then be by Ctrl-Alt-Backspace.

flexible=false

1. Do not handle this X server for attached displays.

handled=false

1. To use this server type you should add -query host or -indirect host to the
2. command line.

[server-Chooser] name=Chooser server command=/usr/bin/X -br -audit 0

1. Make this not appear in the flexible servers for now, but if you wish to
2. allow a chooser server then make this true. This is the only way to make a
3. flexible chooser server that behaves nicely.

flexible=false

1. Run the chooser instead of the greeter. When the user chooses a machine they
2. will get this same server but run with "-terminate -query hostname".

chooser=true

[customcommand]

1. This section allows you specify up to 10 custom commands. Each of the
2. commands can be defined by the seven parameters listed below. In each of the
3. descriptions of the parameters N can take on any values between 0 and 9,
4. i.e. CustomCommand0=,CustomCommand1=,...,CustomCommand9=. The numbers
5. can have gaps as long as they fit within predefined set of 10, and their
6. placement order within this section and with respect to each other is
7. not important.
9. CustomCommandN, CustomCommandTextN, CustomCommandLabelN,
10. CustomCommandLRLabelN, CustomCommandTooltipN, CustomCommandIsPersistentN
11. and CustomCommandNoRestartN should all be defined for a given integer N,
12. where N can be a number from 0-9 (if not the default values will be
13. assigned except CustomCommandN for which no default exists).

1. Custom command to run. Multiple commands may be specified separated by
2. semicolons. GDM will use the first valid command. Examples:
3. /sbin/bootwindoze;/usr/bin/bootwindoze, or
4. /sbin/runupdate;/usr/local/sbin/runupdate
6. CustomCommandN=

1. Custom command dialog message that will appear on all warning dialogs.
2. This will vary depending on what you want to do. Examples:
3. Are you sure you want to restart system into Windoze?, or
4. Are you sure you want do do this?
5. CustomCommandTextN=

1. Custom command label that will appear as stock label on buttons/menu items.
2. This option can't contain any semicolon characters (i.e. ";").
3. Examples:
4. _Windoze, or
5. _Update Me
6. CustomCommandLabelN=

1. Custom command label that will appear as stock label on radio buttons/list
2. items. The underscore indicates the mnemonic used with this item. Examples:
3. Restart into _Windoze
4. Perform system _Update
5. CustomCommandLRLabelN=

1. Custom command tooltip. Examples
2. Restarts the computer into Windoze
3. Updates the computer software to the most recent version(s)
4. CustomCommandTooltipN=

1. Custom command persistence option. Setting it to true will allow this
2. command to appear outside the login manager, e.g. on the desktop through
3. Log Out/Shut Down dialogs. The default value is false.
4. CustomCommandIsPersistentN=

1. Custom command gdm/system restart option. Setting it to true will not
2. restart gdm after command execution. The default commands (reboot, shut
3. down) all reboot the system by default which is why the default setting
4. is true.
5. In addition when corresponding CustomCommandIsPersistentN option is set to
6. true, setting CustomCommandNoRestartN to false will place CustomCommandN
7. in the Shut Down dialog set of actions, setting it to true will place
8. CustomCommandN in the Log Out dialog set of actions.
9. CustomCommandNoRestartN=
11. Example layout for more than one command:
12. CustomCommand0=
13. CustomCommandText0=
14. CustomCommandLabel0=
15. CustomCommandLRLabel0=
16. CustomCommandTooltip0=
17. CustomCommandIsPersistent0=
18. CustomCommandNoRestart0=