diff options
author | Brian Cameron <Brian.Cameron@Sun.Com> | 2005-03-11 00:15:06 +0000 |
---|---|---|
committer | Brian Cameron <bcameron@src.gnome.org> | 2005-03-11 00:15:06 +0000 |
commit | 7be01d72274e1363569fdbfb3c6b33bda6412c21 (patch) | |
tree | 3fcfaeff0ae44bae9b85153f821e7a9e31ffe40d /docs | |
parent | 5a6d64f455c79660dfdd2265cb8568bcef5e2745 (diff) | |
download | gdm-7be01d72274e1363569fdbfb3c6b33bda6412c21.tar.gz |
Changed default face directory to EXPANDED_DATADIR/pixmaps/faces since
Thu Mar 10 17:50:00 2005 Brian Cameron <Brian.Cameron@Sun.Com>
* daemon/gdm.h, config/gdm.conf.in: Changed default face
directory to EXPANDED_DATADIR/pixmaps/faces since putting
the faces subdirectory in pixmaps simply makes more
sense.
* Makefile.am, acconfig.h, configure.in, gdmsetup-security.in,
daemon/Makefile.am, daemon/gdm.h, daemon/gdm.in, daemon/slave.c,
gui/Makefile.am, gui/gdmsetup.c, gui/greeter/Makefile.am,
gui/greeter/greeter.c: Changed the way GDM files are installed.
Now all programs intended to be run by root are in
EXPANDED_SBINDIR (gdm/gdm-binary/gdmsetup), all programs
that are not intended to be run by end-users are in
EXPANDED_LIBEXEC (gdmchooser/gdmgreeter/gdmlogin). Removed
gdmconfig wrapper script and gdm Xnest symlink since they
only serve to clutter the filesystem. I announced this
change in the 2.6.0.8 release notes and will be bumping
the next release to 2.6 because of this change and the
change to the default face directory.
* configure.in, gui/faces/*: Add default faces. Images
provided by Jaap A. Haitsma. Refer to bugzilla bug
#149838.
* gui/gdmphotosetup.c: Now browser will look in the system
face directory first, in EXPANDED_DATADIR/pixmaps if the
default face directory does not exist.
* config/Makefile.am: Changed name of Default to Init since
that follows the naming standard used by the other scripts.
Fixes bug 118278.
* docs/C/gdm.xml: Updated docs with information about
the changes in today's commits.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/C/gdm.xml | 418 |
1 files changed, 221 insertions, 197 deletions
diff --git a/docs/C/gdm.xml b/docs/C/gdm.xml index a495d2a4..6b01a8fb 100644 --- a/docs/C/gdm.xml +++ b/docs/C/gdm.xml @@ -451,7 +451,7 @@ Optionally the greeter can provide a face browser containing icons for all the users on a system. The icons can be installed globally by the sysadmin or in the users' home directories. If installed globally - they should be in the <filename><share>/faces/</filename> + they should be in the <filename><share>/pixmaps/faces/</filename> directory (though this can be configured with the <filename>GlobalFaceDir</filename> configuration option) and the filename should be the name of the user, @@ -2304,7 +2304,7 @@ XKeepsCrashing <varlistentry> <term>GlobalFaceDir</term> <listitem> - <synopsis>GlobalFaceDir=<share>/faces/</synopsis> + <synopsis>GlobalFaceDir=<share>/pixmaps/faces/</synopsis> <para> Systemwide directory for face files. The sysadmin can place icons for users here without touching their homedirs. Faces are @@ -3029,7 +3029,7 @@ Language=cs_CZ.UTF-8 <para> Face images can also be placed in the global face directory, which is - normally <filename><share>/faces/</filename> + normally <filename><share>/pixmaps/faces/</filename> (though this can be configured with the <filename>GlobalFaceDir</filename> configuration option) and the filename should be the name of the user, optionally with a @@ -3128,6 +3128,7 @@ FLEXI_XSERVER FLEXI_XNEST CONSOLE_SERVERS ALL_SERVERS +GET_CONFIG UPDATE_CONFIG GREETERPIDS QUERY_LOGOUT_ACTION @@ -3296,6 +3297,25 @@ Answers: </screen> </sect3> + <sect3 id="getconfig"> + <title>GET_CONFIG</title> + <screen> +GET_CONFIG: Get configuration value for key. Useful so + that other programs can request configuration + information from GDM. Any key defined as GDM_KEY_* + in gdm.h is supported. +Supported since: 2.6.0.9 +Arguments: <key> +Answers: + OK <value> + ERROR <err number> <english error description> + 0 = Not implemented + 50 = Unsupported key + 200 = Too many messages + 999 = Unknown error + </screen> + </sect3> + <sect3 id="updateconfig"> <title>UPDATE_CONFIG</title> <screen> @@ -3498,185 +3518,14 @@ Supported since: 2.2.4.0 </sect2> </sect1> - <sect1 id="binaries"> - <title>GDM Commands</title> + <sect1 id="bindir_binaries"> + <title>GDM Commands in EXPANDED_BINDIR</title> <para> - The GDM package provides quite a few different commands. + The GDM package provides the following different commands in + EXPANDED_BINDIR intended to be used by the end-user: </para> - <sect2 id="gdmcommandline"> - <title><filename>gdm</filename> and <filename>gdm-binary</filename> - Command Line Options</title> - - <para> - The <filename>gdm</filename> command is really just a script which - runs the <filename>gdm-binary</filename>, passing along any options. - Before launching gdm-binary, the gdm wrapper script will source the - <filename>/etc/profile</filename> 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. - </para> - - <variablelist> - <title><filename>gdm</filename> and <filename>gdm-binary</filename> - Command Line Options</title> - - <varlistentry> - <term>--help</term> - <listitem> - <para> - Gives a brief overview of the command line options. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>-nodaemon</term> - <listitem> - <para> - 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. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>--no-console</term> - <listitem> - <para> - Tell the daemon that it should not run anything on the console. - This means that none of the local servers from the - <filename>[servers]</filename> section will be run, and the - console will not be used for communicating errors to the user. - An empty <filename>[servers]</filename> section automatically - implies this option. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>--preserve-ld-vars</term> - <listitem> - <para> - When clearing the environment internally, preserve all variables - starting with LD_. This is mostly for debugging purposes. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>--version</term> - <listitem> - <para> - Print the version of the GDM daemon. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>--wait-for-go</term> - <listitem> - <para> - 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. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - - <sect2 id="gdmgreeterlogincommandline"> - <title><filename>gdmchooser</filename> and <filename>gdmlogin</filename> - Command Line Options</title> - - <para> - The <filename>gdmgreeter</filename> and <filename>gdmlogin</filename> - are two different login programs, either can be used by GDM. - <filename>gdmgreeter</filename> is themeable with GDM themes while - <filename>gdmlogin</filename> is themable with GTK+ themes. These - programs are normally executed by the GDM daemon. Both programs - support standard GNOME options. - </para> - </sect2> - - <sect2 id="gdmchoosercommandline"> - <title><filename>gdmchooser</filename> Command Line Options</title> - - <para> - The <filename>gdmchooser</filename> is the XDMCP chooser application. - The <filename>gdmchooser</filename> is normally executed by the GDM - daemon. It supports the following options for XDM compatibility. - This program supports standard GNOME options. - </para> - - <variablelist> - <title><filename>gdmchooser</filename> Command Line Options</title> - - <varlistentry> - <term>-xdmaddress=SOCKET</term> - <listitem> - <para> - Socket for XDM communication. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>--clientaddress=ADDRESS</term> - <listitem> - <para> - Client address to return in response to XDM. This option is for - running gdmchooser with XDM, and is not used within GDM. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>-connectionType=TYPE</term> - <listitem> - <para> - Connection type to return in response to XDM. This option is for - running gdmchooser with XDM, and is not used within GDM. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect2> - - <sect2 id="gdmsetupcommandline"> - <title><filename>gdmconfig</filename> and - <filename>gdmsetup</filename> Command Line Options</title> - - <para> - <filename>gdmconfig</filename> is a wrapper script for running - <filename>gdmsetup</filename> for binary name compatibility. - <filename>gdmconfig</filename> is installed to the - <filename><sbin>/</filename> directory. - </para> - - <para> - 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 - <filename>gdmsetup</filename> 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. - </para> - </sect2> - <sect2 id="gdmxnestchoosercommandline"> <title><filename>gdmXnestchooser</filename> and <filename>gdmXnest</filename> Command Line Options</title> @@ -3695,20 +3544,8 @@ Supported since: 2.2.4.0 options. </para> - <para> - <filename>gdmXnest</filename> is a symbolic link to - <filename>gdmXnestchooser</filename> and is the same as using the - --no-query and --no-gdm-check options with - <filename>gdmXnestchooser</filename>. It is useful for running - <filename>Xnest</filename> 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. - </para> - <variablelist> - <title><filename>gdmXnestchooser</filename> and - <filename>gdmXnest</filename> Command Line Options</title> + <title><filename>gdmXnestchooser</filename> Command Line Options</title> <varlistentry> <term>-x, --xnest=STRING</term> @@ -3897,6 +3734,129 @@ remote-flexi - In remote (XDMCP) & flexi mode. </screen> </para> </sect2> + </sect1> + + <sect1 id="sbindir_binaries"> + <title>GDM Commands in EXPANDED_SBINDIR</title> + + <para> + The GDM package provides the following different commands in + EXPANDED_SBINDIR intended to be used by the root user: + </para> + + <sect2 id="gdmcommandline"> + <title><filename>gdm</filename> and <filename>gdm-binary</filename> + Command Line Options</title> + + <para> + The <filename>gdm</filename> command is really just a script which + runs the <filename>gdm-binary</filename>, passing along any options. + Before launching gdm-binary, the gdm wrapper script will source the + <filename>/etc/profile</filename> 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 script. + </para> + + <variablelist> + <title><filename>gdm</filename> and <filename>gdm-binary</filename> + Command Line Options</title> + + <varlistentry> + <term>--help</term> + <listitem> + <para> + Gives a brief overview of the command line options. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>-nodaemon</term> + <listitem> + <para> + 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. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--no-console</term> + <listitem> + <para> + Tell the daemon that it should not run anything on the console. + This means that none of the local servers from the + <filename>[servers]</filename> section will be run, and the + console will not be used for communicating errors to the user. + An empty <filename>[servers]</filename> section automatically + implies this option. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--preserve-ld-vars</term> + <listitem> + <para> + When clearing the environment internally, preserve all variables + starting with LD_. This is mostly for debugging purposes. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--version</term> + <listitem> + <para> + Print the version of the GDM daemon. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--wait-for-go</term> + <listitem> + <para> + 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. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="gdmsetupcommandline"> + <title><filename>gdmconfig</filename> and + <filename>gdmsetup</filename> Command Line Options</title> + + <para> + <filename>gdmconfig</filename> is a wrapper script for running + <filename>gdmsetup</filename> for binary name compatibility. + <filename>gdmconfig</filename> is installed to the + <filename><sbin>/</filename> directory. + </para> + + <para> + 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 + <filename>gdmsetup</filename> 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. + </para> + </sect2> <sect2 id="gdmrestartcommandline"> <title><filename>gdm-restart</filename> Command Line Options</title> @@ -3905,8 +3865,6 @@ remote-flexi - In remote (XDMCP) & flexi mode. <filename>gdm-restart</filename> 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. - <filename>gdm-restart</filename> is installed to the - <filename><sbin>/</filename> directory. </para> </sect2> @@ -3916,8 +3874,7 @@ remote-flexi - In remote (XDMCP) & flexi mode. <para> <filename>gdm-safe-restart</filename> stops and restarts GDM by sending the GDM daemon a USR1 signal. GDM will be restarted as soon - as all users log out. <filename>gdm-safe-restart</filename> is - installed to the <filename><sbin>/</filename> directory. + as all users log out. </para> </sect2> @@ -3926,12 +3883,79 @@ remote-flexi - In remote (XDMCP) & flexi mode. <para> <filename>gdm-stop</filename> stops GDM by sending the GDM daemon - a TERM signal. <filename>gdm-stop</filename> is installed to the - <filename><sbin>/</filename> directory. + a TERM signal. </para> </sect2> </sect1> + <sect1 id="sbindir_binaries"> + <title>GDM Commands in EXPANDED_LIBEXECDIR</title> + + <para> + The GDM package provides the following different commands in + EXPANDED_LIBEXECDIR intended to be used by the gdm daemon process. + </para> + + <sect2 id="gdmgreeterlogincommandline"> + <title><filename>gdmchooser</filename> and <filename>gdmlogin</filename> + Command Line Options</title> + + <para> + The <filename>gdmgreeter</filename> and <filename>gdmlogin</filename> + are two different login programs, either can be used by GDM. + <filename>gdmgreeter</filename> is themeable with GDM themes while + <filename>gdmlogin</filename> is themable with GTK+ themes. These + programs are normally executed by the GDM daemon. Both programs + support standard GNOME options. + </para> + </sect2> + + <sect2 id="gdmchoosercommandline"> + <title><filename>gdmchooser</filename> Command Line Options</title> + + <para> + The <filename>gdmchooser</filename> is the XDMCP chooser application. + The <filename>gdmchooser</filename> is normally executed by the GDM + daemon. It supports the following options for XDM compatibility. + This program supports standard GNOME options and is found in + support standard GNOME options. + </para> + + <variablelist> + <title><filename>gdmchooser</filename> Command Line Options</title> + + <varlistentry> + <term>-xdmaddress=SOCKET</term> + <listitem> + <para> + Socket for XDM communication. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--clientaddress=ADDRESS</term> + <listitem> + <para> + Client address to return in response to XDM. This option is for + running gdmchooser with XDM, and is not used within GDM. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>-connectionType=TYPE</term> + <listitem> + <para> + Connection type to return in response to XDM. This option is for + running gdmchooser with XDM, and is not used within GDM. + </para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + </sect1> + <!-- ============= Theme manual ============================= --> <sect1 id="thememanual"> |