# Посібник з менеджера дисплїв середовища Gnome

0.0
2007-01

GDM - менеджер дисплеїв GNOME, графічна програма входу у сеанс.

Martin
K.
Petersen

    mkp@mkp.net

George
Lebl

    jirka@5z.com

Brian
Cameron

    Brian.Cameron@Sun.COM

Bill
Haneman

    Bill.Haneman@Sun.COM

1998
1999
Martin K. Petersen
2001
2003
2004
George Lebl
2003
Red Hat, Inc.
2003
2004
Sun Microsystems, Inc.
2004, 2006
Максим Дзюманенко (mvd@mylinux.ua)

Дозволяється копіювати, розповсюджувати та/або змінювати цей документ на умовах ліцензії GNU Free Documentation License (GFDL), версії 1.1 або будь-якої старшої версії, що опублікована Free Software Foundation без інваріантних розділів, тексту титульної сторінки, та тексту фінальної сторінки. Копію GFDL можна знайти за адресою або у файлі COPYING-DOCS, що постачається з цією довідкою.

Ця довідка є частиною збірки документації з GNOME, що постачається на умовах ліцензії GFDL. Якщо ви бажаєте розповсюджувати цю довідку окремо від збірки, можете це зробити додавши до довідки копію ліцензії, як описано у пункті 6 ліцензії.

Більшість назв, що використовуються компаніями для розповсюдження їх продуктів та послуг є торговими марками. Якщо такі назви зустрічаються у документації з GNOME та учасникам проекту документування GNOME відомо, що вони є торговими марками, тоді ці назви пишуться великими літерами або починаються з великої літери.

ДОКУМЕНТ ТА ЗМІНЕНІ ВЕРСІЇ ЦЬОГО ДОКУМЕНТУ ПОСТАЧАЮТЬСЯ НА УМОВАХ ВІЛЬНОЇ ЛІЦЕНЗІЇ ДЛЯ ДОКУМЕНТАЦІЇ GNU З ПОДАЛЬШИМ РОЗУМІННЯМ ЩО:

1. ДОКУМЕНТ НАДАЄТЬСЯ "ЯК Є", БЕЗ БУДЬ-ЯКИХ ГАРАНТІЇ, ЯВНИХ ЧИ НЕЯВНИХ, ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ГАРАНТІЙ ЩО ЦЕЙ ДОКУМЕНТ ЧИ ЗМІНЕНА ВЕРСІЯ ДОКУМЕНТА ВІЛЬНІ ВІД ДЕФЕКТІВ, ПРИДАТНІ ДО ПРОДАЖУ, ВІДПОВІДАЮТЬ ПЕВНІЙ МЕТІ АБО НЕ ПОРУШУЮТЬ ЧИЇСЬ ПРАВА. ВЕСЬ РИЗИК ЗА ЯКІСТЬ, ТОЧНІСТЬ, ТА ЧИННІСТЬ ЦЬОГО ДОКУМЕНТУ АБО ЙОГО ЗМІНЕНИХ ВЕРСІЙ ЛЕЖИТЬ НА ВАС. ЯКЩО БУДЬ-ЯКИЙ ДОКУМЕНТ ЧИ ЗМІНЕНА ВЕРСІЯ БУДУТЬ ВИЗНАНІ ДЕФЕКТНИМИ У БУДЬ-ЯКОМУ ВІДНОШЕННІ, ВИ (НЕ ПОЧАТКОВИЙ УКЛАДАЧ, АВТОР АБО БУДЬ-ЯКИЙ СПІВАВТОР) БЕРЕТЕ НА СЕБЕ ВИТРАТИ ЗА БУДЬ-ЯКЕ НЕОБХІДНЕ ОБСЛУГОВУВАННЯ, РЕМОНТ ЧИ ВИПРАВЛЕННЯ. ЦЯ ВІДМОВА ВІД ГАРАНТІЙ СКЛАДАЄ ВАЖЛИВУ ЧАСТИНУ ЦІЄЇ ЛІЦЕНЗІЇ. НЕ ДОПУСКАЄТЬСЯ ВИКОРИСТАННЯ ЦЬОГО ДОКУМЕНТУ АБО ЙОГО ЗМІНЕНОЇ ВЕРСІЇ БЕЗ ПРИЙНЯТТЯ ЦІЄЇ ВІДМОВИ; ТА

2. НІ ЗА ЯКИХ ОБСТАВИН ТА ЗА БУДЬ-ЯКОГО ЗАКОНОДАВСТВА, ЧИ ТО ГРОМАДЯНСЬКОЇ ВІДПОВІДАЛЬНОСТІ (ВКЛЮЧАЮЧИ ХАЛАТНІСТЬ), ДОГОВОРУ, ЧИ ЧОГОСЬ ІНШОГО, АВТОР, ПОЧАТКОВИЙ УКЛАДАЧ, БУДЬ-ЯКИЙ СПІВАВТОР, АБО ДИСТРИБ'ЮТОР ДОКУМЕНТУ ЧИ ЗМІНЕНОЇ ВЕРСІЇ ДОКУМЕНТУ, АБО БУДЬ-ЯКИЙ ПОСТАЧАЛЬНИК БУДЬ-ЯКОЇ З ЦИХ СТОРІН, НЕ НЕСЕ ВІДПОВІДАЛЬНІСТЬ ПЕРЕД БУДЬ-ЯКОЮ ОСОБОЮ ЗА БУДЬ-ЯКІ ПРЯМІ, НЕПРЯМІ, ОСОБЛИВІ, ВИПАДКОВІ, АБО ІСТОТНІ ЗБИТКИ БУДЬ-ЯКОГО ХАРАКТЕРУ ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ЗБИТКАМИ ВІД ВТРАТИ ПРЕСТИЖУ, ЗУПИНКИ РОБОТИ, ЗБОЇВ АБО НЕСПРАВНОСТЕЙ КОМП'ЮТЕРА, АБО БУДЬ-ЯКІ ІНШІ ЗБИТКИ АБО ВТРАТИ ЩО ВИНИКЛИ БЕЗВІДНОСНО АБО ВНАСЛІДОК ВИКОРИСТАННЯ ЦЬОГО ДОКУМЕНТУ ТА ЗМІНЕНИХ ВЕРСІЙ ЦЬОГО ДОКУМЕНТУ, НАВІТЬ ЯКЩО ЦІ СТОРОНИ, МОЖЛИВО, БУЛИ ПРОІНФОРМОВАНІ ПРО МОЖЛИВІСТЬ ТАКИХ ЗБИТКІВ.

This manual describes version 2.17.7 of the GNOME Display Manager. It was last updated on 02/12/2007.

## Терміни та домовленості використані у цьому посібнику

This manual describes version 2.17.7 of the GNOME Display Manager. It was last updated on 02/12/2007.

Селектор - програма, що використовується для керування дисплеєм віддаленого вузла з локального дисплея (`gdmchooser`).

Конфігуратор - програма налаштовування (`gdmsetup`).

GDM - менеджер дисплеїв середовища Gnome (Gnome Display Manager). Назва використовується при посиланні на програмний пакет взагалі. Іноді відомий як GDM2.

gdm - програма-сервер менеджеру дисплею середовища Gnome (`gdm`).

Програма привітання - графічне вікно входу (`gdmlogin` або `gdmgreeter`).

GTK+ програма привітання - стандартне вікно входу (`gdmlogin`).

PAM - механізм модульної автентифікації

Програма привітання з темами - вікно входу з підтримкою тем (`gdmlogin`).

XDMCP - протокол керування дисплеєм X

Шляхи, що починаються з кутових дужок є відносними до префіксу встановлення пакету. Наприклад, `<share>/pixmaps/` перетворюється у `<share>/pixmaps`, якщо GDM був зібрано з `<share>/pixmaps`. Зазвичай, GDM встановлено з `--sysconfigdir=<etc>/X11`, таким чином посилання на шлях `<etc>/gdm/PreSession` перетворюється у `<etc>/gdm/PreSession`. Зауважте, для сумісності з іншими системами рекомендовано, щоб значення prefix було `/usr`, а значення sysconfdir було `<etc>/X11`.

## Огляд

### Введення

GDM - менеджер дисплею для GNOME, у якому реалізовано більшість функцій, що вимагаються для керування локальними та віддаленими дисплеями. GDM створено "з чистого аркуша" та він не містить оригінального коду XDM / X Consortium.

Подальшу інформацію про GDM шукайте на сторінці проекту GDM. Надсилайте повідомлення про будь-які помилки чи вдосконалення з категорією "gdm" на сайт bugzilla.gnome.org. Також можна надсилати повідомлення до списку розсилки

    gdm-list@gnome.org

, де обговорюються питання пов'язані з програмою GDM.

### Стабільність інтерфейсу

The key/value pairs defined in the GDM configuration files and the location of these files are considered "stable" interfaces and should only change in ways that are backwards compatible. Note that this includes functionality like the GDM scripts (Init, PreSession, PostSession, PostLogin, XKeepsCrashing, etc.); directory locations (ServAuthDir, PidFile, etc.), system applications (SoundProgram), etc. Some configuration values depend on OS interfaces may need to be modified to work on a given OS. Typical examples are HaltCommand, RebootCommand, CustomCommands, SuspendCommand, StandardXServer, Xnest, SoundProgram, and the "command" value for each "server-foo".

Note: distributions often change the default values of keys to support their platform. Command-line interfaces for GDM programs installed to `<bin>` and `<sbin>` are considered stable. Refer to your distribution documentation to see if there are any distribution-specific changes to these GDM interfaces and what support exists for them.

As of the GDM 2.15 development series, some one-dash arguments are no longer supported. This includes the "-xdmaddress", "-clientaddress", and "-connectionType" arguments used by `gdmchooser`. These arguments have been changed to now use two dashes.

If issues are discovered that break compatibility, please file a bug with an "urgent" priority.

### Сервер GDM

The GDM daemon is responsible for managing displays on the system. This includes authenticating users, starting the user session, and terminating the user session. GDM is configurable and the ways it can be configured are described in the "Configuring GDM" section of this document. The `Init`, `PostLogin`, `PreSession`, and `PostSession` scripts discussed below are discussed in this "Configuring GDM section".

The GDM daemon supports a UNIX domain socket protocol which can be used to control aspects of its behavior and to query information. This protocol is described in the "Controlling GDM" section of this document.

GDM can be asked to manage a display a number of ways. Local displays are always managed when GDM starts and will be restarted when a user's session is finished. Displays can be requested via XDMCP, flexible displays can be requested by running the `gdmflexiserver` command. Displays that are started on request are not restarted on session exit. GDM also provides the `gdmdynamic` command to allow easier management of displays on a multi-user server. These display types are discussed further in the next section.

When the GDM daemon is asked to manage a display, it will fork an X server process, then run the `Init` script as the root user, and start the login GUI dialog as a slave process on the display. GDM can be configured to use either `gdmgreeter` (the default) or `gdmlogin` as the GUI dialog program. The `gdmlogin` program supports accessibility while the `gdmgreeter` program supports greater themeability. The GUI dialog is run as the unpriviledged "gdm" user/group which is described in the "Security" section below. The GUI dialog communicates with the daemon via a sockets protocol and via standard input/output. The slave, for example passes the username and password information to the GDM daemon via standard input/output so the daemon can handle the actual authentication.

The login GUI dialog screen allows the user to select which session they wish to start and which language they wish to use. Sessions are defined by files that end in the .desktop extension and more information about these files can be found in the "Configuration" section. The user enters their name and password and if these successfully authenticate, GDM will start the requested session for the user. It is possible to configure GDM to avoid the authentication process by turning on the Automatic or Timed Login features in the GDM configuration. The login GUI can also be configured to provide additional features to the user, such as the Face Browser; the ability to halt, restart, or suspend the system; and/or edit the login configuration (after entering the root password).

GDM, by default, will use Pluggable Authentication Modules (PAM) for authentication, but can also support regular crypt and shadow passwords on legacy systems. After authenticating a user, the daemon runs the `PostLogin` script as root, and forks a slave process to start the requested session. This slave process runs the `PreSession` script as root, sets up the user's environment, and starts the requested session. GDM keeps track of the user's default session and language in the user's `~/.dmrc` and will use these defaults if the user did not pick a session or language in the login GUI. On Solaris, GDM (since version 2.8.0.3) uses the SDTLOGIN interface after user authentication to tell the X server to be restarted as the user instead of as root for added security. When the user's session exits, the GDM daemon will run the `PostSession` script as root.

Note that, by default, GDM uses the "gdm" service name for normal login and the "gdm-autologin" service name for automatic login. The `PamStack` configuration option can be used to specify a different service name. For example, if "foo" is specified, then GDM will use the "foo" service name for normal login and "foo-autologin" for automatic login.

For those looking at the code, the gdm_verify_user function in `daemon/verify-pam.c` is used for normal login and the gdm_verify_setup_user function is used for automatic login.

### Різні типи дисплеїв

GDM supports three different display types: static (local) displays, flexible (on-demand) displays, and XDMCP (remote) displays. The "X Server Definitions" and the "Local Static X Display Configuration" subsections of the "Configuration" section explains how these various types of displays are defined in the GDM configuration file.

Локальні статичні дисплеї завжди запускаються службою, якщо вони завершуються або вмирають, вони перезапускаються. GDM може запускати їх стільки, скільки буде потрібно. GDM також може керувати серверами, на яких він не керує власне самим процесом входу, це дозволяє використовувати GDM при створенні X-терміналів.

Flexible, or on demand displays, are started via the socket protocol with the `gdmflexiserver` command. This feature is only available to users logged in on the console and will display a new login screen. If a flexible display has previously been started on the console, running `gdmflexiserver` again will display a menu allowing users to switch back to a previous session or start a new flexible session. The `gdmflexiserver` locks the current session before starting a new flexible display, so the user's password must be entered before returning to an existing session. The `gdmflexiserver` command can also be used to launch nested `Xnest` display. These are launched in a window in the user's current session. Nested displays can be started even if not logged into the console and are started by running the `gdmflexiserver -n` command. Flexible displays are not restarted when the user session ends. Flexible displays require virtual terminal (VT) support in the kernel, and will not be available if not supported (such as on Solaris). Nested displays require that the X server supports Xnest.

Останній тип дисплеїв - віддалені XDMCP дисплеї, які описані у наступному розділі. Якщо цей параметр увімкнено, віддалені вузли можуть з'єднуватись з GDM та показувати вікно входу. Для цього типу сеансів є відмінності, наприклад, у меню Дії не показуються пункти, які дозволяють вимикати, перезавантажувати, або налаштовувати GDM.

Displays started via the `gdmdynamic` command are treated as local displays, so they are restarted automatically on when the session exits. This command is intended to more effectively manage the displays on a multi-user server (many displays connected to a single server).

### XDMCP

The GDM daemon can be configured to listen for and manage X Display Manage Protocol (XDMCP) requests from remote displays. By default XDMCP support is turned off, but can be enabled if desired. If GDM is built with TCP Wrapper support, then the daemon will only grant access to hosts specified in the GDM service section in the TCP Wrappers configuration file.

GDM включає декілька заходів, які роблять його більш стійким до атак типу відмова у обслуговуванні на службу XDMCP. Можна налаштувати значну кількість параметрів протоколу, час очікування з'єднання, тощо. Проте, типові значення підійдуть для більшості систем. Не змінюйте їх, якщо не розумієте їх вплив на систему.

GDM прослуховує UDP порт 177 та відповідає не запити QUERY та BROADCAST_QUERY надсилаючи пакет WILLING ініціатору з'єднання.

GDM можна налаштувати на обробку INDIRECT запитів та відображення селектора вузлів на віддаленому дисплеї. GDM запам'ятовує вибір користувача та пересилає наступні запити вибраному менеджеру. GDM також підтримує розширення до протоколу, яке змушує забути про перенаправлення одразу після успішного з'єднання користувача. Це розширення підтримується якщо з обох сторін сервери GDM. Розширення прозоре і ігнорується XDM та іншими серверами, що підтримують XDMCP.

Refer to the "Security" section for information about security concerns when using XDMCP.

### Безпечне віддалене з'єднання через SSH

As explained in the "Security" section, XDMCP does not use any kind of encryption and as such is inherently insecure. As XDMCP uses UDP as a network transport layer, it is not possible to simply secure it through an SSH tunnel.

To remedy this problem, gdm can be configured at compilation-time with the option --enable-secureremote, in which case gdm proposes as a built-in session a session called "Secure Remote Connection". Starting such a session allows the user to enter the name or the address of the host on which to connect; provided the said host runs an SSH server, the user then gets connected to the server on which the default X session is started and displayed on the local host.

Using this session allows a much more secure network connection and only necessitates to have an SSH server running on the remote host.

### Програма привітання на GTK+

Програма привітання на GTK+ - типовий графічний інтерфейс користувача. Вікно привітання містить меню, необов'язковий переглядач портретів, необов'язкову емблему та текстове поле. Програма привітання має повну підтримку допоміжних технологій та має використовуватись у випадках, якщо потрібна така підтримка.

Текстове поле використовується для вводу імен користувачів, паролів, парольних фраз тощо. `gdmlogin` контролюється основним сервером та не має певного стану. Сервер контролює вікно привітання використовуючи простий протокол, він може запитати у програми привітання текстовий рядок в виводом копії рядка або без виводу. Подібним чином, сервер може змінити етикетку над текстовим полем, щоб її вміст відповідав значенню, яке система автентифікації очікує від користувача.

Панель меню вгорі вікна привітання дозволяє користувачу вибрати тип сеансу/робочого середовища, вибрати відповідну локалізацію/мову та зупинити/перезавантажити/призупинити комп'ютер, налаштувати GDM (якщо користувач знає пароль адміністратора (root)), змінити тему GTK+, або запустити селектор XDMCP.

Вікно привітання може відображати портрет у вікні входу. Зображення повинно бути у форматі, зрозумілому для бібліотеки gdk-pixbuf (GIF, JPG, PNG, TIFF, XPM та можливо іншому), та має бути доступним для читання користувачу gdm. Докладнішу інформацію дивіться у описі параметра `Logo` у розділі опису конфігураційного файлу.

### Програма привітання з темами

The Themed Greeter is a greeter interface that takes up the whole screen and is very themable. Themes can be selected and new themes can be installed by the configuration application or by setting the `GraphicalTheme` configuration key. The Themed Greeter is much like the GTK+ Greeter in that it is controlled by the underlying daemon, is stateless, and is controlled by the daemon using the same simple protocol.

Зовнішній вигляд вікна привітання залежить від теми, тому елементи інтерфейсу можуть відрізнятись. Єдиний елемент який завжди присутній - це текстове поле, яке описане у розділі Програма привітання на GTK+. Тема вожу включати кнопки вибору локалі/мови, зупинення/перезапуску/призупинення комп'ютера, налаштовування GDM (якщо користувач знає пароль адміністратора (root)), чи запуску селектора XDMCP.

Ви завжди можете вивести меню з наявними діями натиснувши на клавішу F10. Це може знадобитись, якщо тема не містить деяких кнопок, але ви бажаєте виконати певну дію, що дозволена конфігурацією.

### Переглядач портретів GDM

GDM supports a face browser which will display a list of users who can login and an icon for each user. This feature can be used with the GTK+ Greeter if the `Browser` configuration option is set to "true". This feature can be used with the Themed Greeter if using a GDM theme which includes a "userlist" item type is defined, such as "happygnome-list"

By default, the face browser is disabled since revealing usernames on the login screen is not appropriate on many systems for security reasons. Also GDM requires some setup to specify which users should be visible. Setup can be done on the "Users" tab in `gdmsetup`. This feature is most practical to use on a system with a smaller number of users.

Зображення можуть бути встановлені глобально адміністратором, або братись з домашніх каталогів користувачів. Якщо вони встановлені глобально, вони мають знаходитись у каталозі `<share>/pixmaps/faces/` (шлях до каталогу можна змінити використовуючи конфігураційну змінну `GlobalFaceDir`) та назва файлу повинна відповідати імені користувача, з необов'язковим суфіксом `.png`. Значки програм з глобального каталогу мають бути доступні для читання користувачу GDM. Проте, програма сервера передає зображення програмі привітання та таким права на читання потрібні не не користувачу "gdm", а root.

Users may run the `gdmphotosetup` command to configure the image to use for their userid. This program properly scales the file down if it is larger than the `MaxIconWidth` or `MaxIconHeight` configuration options and places the icon in a file called `~/.face`. Although `gdmphotosetup` scales user images automatically, this does not guarantee that user images are properly scaled since a user may create their `~/.face` file by hand.

GDM will first look for the user's face image in `~/.face`. If not found, it will try `~/.face.icon`. If still not found, it will use the value defined for "face/picture=" in the `~/.gnome2/gdm` file. Lastly, it will try `~/.gnome2/photo` and `~/.gnome/photo` which are deprecated and supported for backwards compatibility.

If a user has no defined face image, GDM will use the "stock_person" icon defined in the current GTK+ theme. If no such image is defined, it will fallback to the image specified in the `DefaultFace` configuration option, normally `<share>/pixmaps/nobody.png`.

Please note that loading and scaling face icons located in user home directories can be a very time-consuming task. Since it not practical to load images over NIS or NFS, GDM does not attempt to load face images from remote home directories. Furthermore, GDM will give up loading face images after 5 seconds of activity and will only display the users whose pictures it has gotten so far. The `Include` configuration option can be used to specify a set of users who should appear on the face browser. As long as the users to include is of a reasonable size, there should not be a problem with GDM being unable to access the face images. To work around such problems, it is recommended to place face images in the directory specified by the `GlobalFaceDir` configuration option.

To control the users who get displayed in the face browser, there are a number of configuration options that can be used. If the `IncludeAll` option is set to true, then the password file will be scanned and all users will be displayed. If `IncludeAll` option is set to false, then the `Include` option should contain a list of users separated by commas. Only the users specified will be displayed. Any user listed in the `Exclude` option and users whose UID's is lower than `MinimalUID` will be filtered out regardless of the `IncludeAll` setting. `IncludeAll` is not recommended for systems where the passwords are loaded over a network (such as when NIS is used), since it can be very slow to load more than a small number of users over the network..

Якщо ввімкнено перегляд портретів, потенційному зловмиснику виставляється на показ список дійсних імен користувачів. Це погана ідея, якщо ви не знаєте хто може отримати доступ до екрану входу. Особливо це стосується випадку, коли використовується XDMCP (зазвичай вимкнено).

### Реєстрація подій

GDM використовує syslog для реєстрації помилок або стану. Також він може реєструвати налагоджувальну інформацію, що можна використовувати при аналізі проблем з GDM, якщо він неправильно працює. Реєстрацію налагоджувальної інформації можна увімкнути у конфігураційному файлі.

Інформація отримана з різних X серверів зберігається у реєстраційному каталозі GDM. Зазвичай це `<var>/log/gdm/`, але його можна змінити. Інформацію про сеанс можна знайти у файлі з назвою `<display>.log`. Чотири попередні версії зберігаються у файлах з назвою, до якої додаються суфікси від `.1` до `.4`. Інформація про нові сеанси замінює інформацію про старіші сеанси. Ви можете скористатись цими файлами, щоб переглянути інформацію від X-сервера при його запуску.

Інформація від сеансів користувача направляється у файл `~/.xsession-errors` перед запуском сценарію `PreSession`. Тому немає потреби перенаправляти її знову у сценарії встановлення сеансу. Якщо сеанс користувача тривав менше за 10 секунд, GDM вважає, що сеанс завершився аварійно та дозволяє користувачу переглянути цей файл у вікні, до того як повернутись до віна входу. Таким чином користувач може переглянути помилки під час останнього сеансу та виправити їх.

Можна позбутись виводу повідомлення про малу тривалість сеансу, якщо вернути код результату 66 із сценарію `Xsession` або двійкового файлу сеансу (типовий сценарій `Xsession` передає цей код назад). Це корисно, якщо у вас є особливий тип входу у сеанс, для якого тривалість сеансу менша за 10 секунд не є помилкою, або якщо ваш сеанс вже налаштований для відображення повідомлення про помилку, та повідомлення від gdm буде зайвим і буде збивати з пантелику.

The session output is piped through the GDM daemon and so the `~/.xsession-errors` file is capped at about 200 kilobytes by GDM to prevent a possible denial of service attack on the session. An app could perhaps on reading some wrong data print out warnings or errors on the stderr or stdout. This could perhaps fill up the user's home directory who would then have to log out and log back in to clear this. This could be especially nasty if quotas are set. GDM also correctly traps the XFSZ signal and stops writing the file, which would lead to killed sessions if the file was redirected in the old fashioned way from the script.

Зауважте, у деяких дистрибутивах перевизначають перенаправлення `~/.xsession-errors` та роблять перенаправлення у своєму власному сценарії Xsession (визначається конфігураційною змінною `BaseXsession`). Це означає, що GDM не зможе перехоплювати вивід та обмежувати цей файлу. Також ви втрачаєте інформацію, яка виводиться сценарієм `PreSession`, що може ускладнити налагодження та пошук помилки, бо частина інформації не буде виведена. Докладнішу інформацію дивіться у описі конфігураційного параметра `BaseXsession`, особливо спосіб обробки інформації від декількох менеджерів дисплеїв у одному сценарії.

Зверніть увагу, якщо сеанс є аварійним, або якщо GDM з деяких причин не може відкрити цей файл, тоді створюється запасний файл у каталозі `/tmp` з назвою `/tmp/xses-<user>.XXXXXX`, де `XXXXXX` - деякі випадкові символи.

Якщо у вашій системі використовуються квоти, краще буде видаляти `~/.xsession-errors` у сценарії `PostSession`. Тоді цей реєстраційний файл не буде без необхідності залишатись.

### Доступ до файлів

Взагалі, GDM дуже неохочій відносно зчитування/запису файлів користувачів (таких як `~/.dmrc`, `~/.face`, `~/.xsession-errors`, та `~/.Xauthority` files). Наприклад, він відмовляється обробляти будь-який тип файлів, крім звичайних файлів. Посилання, сокети та пристрої ігноруються. Значення параметру `RelaxPermissions` вказує чи повинен GDM сприймати файли, до яких є доступ на запис з боку групи їх власника, чи інших осіб. Зазвичай вони ігноруються.

Всі операції над файлами користувача виконуються з ефективним ідентифікатором користувача який відповідає власнику цих файлів. Якщо перевірка безпечності файлу `.Xauthority` завершується невдало, створюються аварійні cookie у каталозі що визначається `UserAuthFBDir` (типово це `/tmp`).

Зрештою, системний адміністратор може вказати максимальний розмір файлу, який оброблятиме GDM. Якщо ввімкнено переглядач портретів, то можна вказати максимальний розмір файлу зображення. На великих системах, з міркувань швидкодії, рекомендується вимкнути переглядач портретів. Перегляд домашніх каталогів користувачів, зміна масштабу та відображення портретів може зайняти значний час.

### Швидкодія GDM

To speed performance it is possible to build GDM so that it will preload libraries when GDM first displays a greeter program. This has been shown to speed first time login since these libraries can be loaded into memory while the user types in their username and password.

To use this feature, configure GDM with the `--with-prefetch` option. This will cause GDM to install the `gdmprefetch` program to the `libexecdir` directory, install the `gdmprefetchlist` to the `<etc>/gdm` directory, and set the `PreFetchProgram` configuration variable so that the `gdmprefetch` program is called with the default `gdmprefetchlist` file. The default `gdmprefetchlist` file was optimized for a GNOME desktop running on Solaris, so may need fine-tuning on other systems. Alternative prefetchlist files can be contributed to the "gdm" category in bugzilla.gnome.org, so that they can be included in future GDM releases.

## Безпека

### PAM

GDM uses PAM for login authentication, though if your machine does not support PAM you can build GDM to work with the password database and the crypt library function.

PAM stands for Pluggable Authentication Module, and is used by most programs that request authentication on your computer. It allows the administrator to configure different authentication behavior for different programs.

Some GDM features (like turning on automatic login) may require that you update your PAM configuration. PAM configuration has different, but similar, interfaces on different operating systems, so check your pam.d or pam.conf man page for details. Be sure that you read the PAM documentation (e.g. pam.d/pam.conf man page) and are comfortable with the security implications of any changes you intend to make to your configuration.

If there is no entry for GDM in your system's PAM configuration file, then features like automatic login may not work. Not having an entry will cause GDM to use default behavior, conservative settings are recommended and probably shipped with your distribution.

If you wish to make GDM work with other types of authentication mechanisms (such as a SmartCard), then you should implement this by using a PAM service module for the desired authentication type rather than by trying to modify the GDM code directly. Refer to the PAM documentation on your system. This issue has been discussed on the

    gdm-list@gnome.org

mail list, so you can refer to the list archives for more information.

### Користувач GDM

For security reasons a dedicated user and group id are required for proper operation! The need to be able to write Xauth files is why user "nobody" is not appropriate for gdm.

Зазвичай GDM сервер запускається від імені адміністратора (root). Але GDM також має призначені ідентифікатори користувача (uid) та групи (gid), якими він користується для запуску графічного інтерфейсу, тобто `gdmgreeter` та `gdmlogin`. Вона налаштовуються у параметрах `User` та `Group` у файлі конфігурації GDM. Користувач та група мають існувати перед запуском "make install". Зазвичай користувач та група GDM називається "gdm".

This userid is used to run the GDM GUI programs required for login. All functionality that requires root authority is done by the GDM daemon process. This design ensures that if the GUI programs are somehow exploited, only the dedicated user privileges are available.

слід зауважити, що користувач та група GDM мають деякі привілеї, які іноді можуть становити загрозу безпеці. По-перше, вони мають доступ до каталогу авторизації X-сервера. Також GDM повинен мати право на читання та запис ключів Xauth у `<var>/lib/gdm`. Власником цього каталогу має бути root:gdm, а права доступу 1770. Ці права призначаються каталогу при виконанні "make install". Служба GDM буде встановлювати цьому каталогу правильні права, якщо вони відрізняються.

The danger is that someone who gains the GDM user/group privileges can then connect to any session. So you should not, under any circumstances, make this some user/group which may be easy to get access to, such as the user `nobody`. Users who gain access to the "gdm" user could also modify the Xauth keys causing Denial-Of-Service attacks. Also if a person gains the ability to run programs as the user "gdm", it would be possible to snoop on running GDM processes, including usernames and passwords as they are being typed in.

Distributions and system administrators using GDM are expected to setup the dedicated user properly. It is recommended that this userid be configured to disallow login and to not have a default shell. Distributions and system administrators should set up the filesystem to ensure that the GDM user does not have read or write access to sensitive files.

### Схема аутентифікації X-серверів

Каталог авторизації сервера (`ServAuthDir`) використовується для зберігання окрім файлів авторизації X сервера, також для випадкових внутрішніх даних, але схема назв насправді є пережитком минулого. Сервер GDM примусово призначає власником цього каталогу `root.gdm` з правами 1770. Таким чином, лише адміністратор(root) та група GDM має доступ на запис до цього каталогу, але група GDM не може видалити з цього каталогу файли, власником яких є root, такі як файли авторизації X сервера.

Типово GDM не довіряє каталогу авторизації сервера та при створенні файлів поводиться з ним таким самим чином, як з тимчасовим каталогом. Таким чином, якщо хтось зламає GDM, він не зможе використати атаки типу атак монтування шляхом створення посилань у каталозі. Подібним чином каталог реєстрації X сервера також обробляється безпечно, але власником цього каталогу має бути адміністратор (root), також лише він повинен мати можливість запису.

GDM підтримує лише систему автентифікації MIT-MAGIC-COOKIE-1. Зазвичай від інших схем користі не набагато більше, тому до сих пір не було вжито зусиль для їх реалізації. При використанні XDMCP слід бути особливо обережним, тому що cookie передаються по мережі у незмінному вигляді. Якщо можливе прослуховування лінії зв'язку, тоді нападник може просто отримати ваш пароль під час реєстрації, незалежно від схеми автентифікації. Якщо прослуховування можливе але небажане, тоді використовуйте ssh для тунелювання X з'єднань, замість використання XDMCP. Ви можете розглядати XDMCP як графічний telnet, який має ті ж самі властивості безпеки.

З одного боку, генератор випадкових чисел GDM дуже слабкий, та GDM виконує надзвичайні заходи для отримання справді випадкових 128-бітних чисел, при можливості використовує апаратний генератор випадкових чисел, додає поточний час (у мікросекундах), 20-байтний масив псевдовипадкових чисел, ідентифікаторів процесів, плюс іншу випадкову інформацію (можливо використовуючи `/dev/audio` або `/dev/mem`, якщо апаратний генератор відсутній) для створення великого буферу, а потім бере MD5 хеш-суму від нього. Зрозуміло, вся ця робота не має сенсу, якщо ви передаєте отриманий таким чином cookie через відкриту мережі або зберігаєте його у каталозі на томі NFS (дивіться конфігураційний параметр `UserAuthDir`). Тому будьте обережні з використанням віддалених X-дисплеїв.

### Firewall Security

Хоча GDM намагається ввести в оману потенційних нападників, рекомендується блокувати XDMCP (UDP порт 177) на вашому брандмауері, якщо він вам не потрібен. GDM протидіє DoS атакам (атаки типу відмови у обслуговуванні), але X протоколу властиві успадковані вади безпеки, тому його слід використовувати у контрольованому оточенні. Також кожне віддалене з'єднання споживає багато ресурсів, тому набагато простіше викликати відмову обслуговування XDMCP сервера, ніж, скажімо, у веб-сервера.

Також буде розумно блокувати на брандмауері всі порти X сервера (TCP порт 6000 + номер дисплею). Зауважте, що різні частини GDM використовують дисплеї з номером 20 та більше (наприклад, при запуску серверів за вимогою).

X is not a very safe protocol for leaving on the net, and XDMCP is even less safe.

### Безпека GDM при використанні з NFS

Зауважте, трафік NFS насправді прямує по дроту, та може прослуховуватись. При доступі до файлів авторизації X-сервера (`~/.Xauthority`), GDM намагатиметься відкрити його від імені адміністратора (root). Якщо це не вдасться, він вважатиме, що має справу із підключеним томом NFS та автоматично буде використовувати змінну `UserAuthFBDir`, яка зазвичай має значення `/tmp`. Цю поведінку можна змінити, встановивши значення false змінній `NeverPlaceCookiesOnNFS` у розділі `[security]`.

### Безпека XDCMP

Even though your display is protected by cookies, XEvents and thus keystrokes typed when entering passwords will still go over the wire in clear text. It is trivial to capture these.

Головним чином XDMCP використовується для тонких клієнтів у лабораторних умовах. Цім тонким клієнтам для доступу до сервера необхідна лише мережа, та, здається, найкращою політикою безпеки буде тримати їх у окремій мережі, до якої неможливо отримати доступ із зовнішнього світу, а зв'язок є лише з сервером. Єдиною точкою доступу до зовнішнього світу повинен бути сервер.

The above sections "X Server Authentication Scheme" and "Firewall Security" also contain important information about using XDMCP securely. The next section also discusses how to set up XDMCP access control.

To workaround the inherent insecurity of XDMCP, gdm proposes a default built-in session that uses SSH to encrypt the remote connection. See the section "Securing remote connection through SSH" above.

### Контроль доступу XDMCP

Контроль доступу XDMCP виконується за допомогою обгорток TCP (TCP wrappers). GDM може бути зібрано без обгорток TCP, тому слід перевірити чи ваш GDM це підтримує.

У файлах `<etc>/hosts.allow` та `<etc>hosts.deny` слід використовувати сервер з назвою `gdm`. Наприклад, щоб заборонити доступ комп'ютерам з `.evil.domain` додайте

    gdm: .evil.domain

у файл `<etc>/hosts.deny`. Також можна додати

    gdm: .your.domain

у файл `<etc>/hosts.allow`, якщо ви вимикаєте усі служби з усіх вузлів. Докладнішу інформацію дивіться у man-сторінці hosts.allow(5).

## Support for ConsoleKit

GDM includes support for publishing user login information with the user and login session accounting framework known as ConsoleKit. ConsoleKit is able to keep track of all the users currently logged in. In this respect, it can be used as a replacement for the utmp or utmpx files that are available on most Unix-like operating systems.

When GDM is about to create a new login process for a user it will call a privileged method of ConsoleKit in order to open a new session for this user. At this time GDM also provides ConsoleKit with information about this user session such as: the user ID, the X11 Display name that will be associated with the session, the host-name from which the session originates (useful in the case of an XDMCP session), whether or not this session is local, etc. As the entity that initiates the user process, GDM is in a unique position know and to be trusted to provide these bits of information about the user session. The use of this privileged method is restricted by the use of D-Bus system message bus security policy.

In the case where a user with an existing session and has authenticated at GDM and requests to resume that existing session GDM calls a privileged method of ConsoleKit to unlock that session. The exact details of what happens when the session receives this unlock signal is undefined and session-specific. However, most sessions will unlock a screensaver in response.

When the user chooses to log out, or if GDM or the session quit unexpectedly the user session will be unregistered from ConsoleKit.

If support for ConsoleKit is not desired it can be disabled at build time using the --with-console-kit=no option when running configure.

## Using gdmsetup To Configure GDM

The `gdmsetup` application can be used to configure GDM. If you believe running root-owned GUI's causes security risk, then you would want to always edit the files by hand and not use `gdmsetup`. Editing the files by hand is explained in the "Configuration" section of this document. Note that `gdmsetup` does not support changing of all configuration variables, so it may be necessary to edit the files by hand for some configurations.

The `gdmsetup` program has five tabs: Local, Remote, Accessibility, Security, and Users, described below. In parenthesis is information about which GDM configuration key is affected by each GUI choice. Refer to the "Configuration" section of this manual and the comments in the <share>/gdm/defaults.conf file for additional details about each key.

### Local Tab

The Local tab is used for controlling the appearance of GDM for local/static displays (non-XDMCP remote connections). The choices available in this tab depend on the setting of the "Style" combobox. This combobox is used to determine whether the "Plain" or "Themed" greeter GUI is used. The differences between these greeter programs are explained in the "Overview" section of this document.

If the "Style" choice is "Plain", then GDM will use the `gdmlogin` program as the GUI (daemon/Greeter). When this choice is selected, `gdmsetup` allows the user to select whether the background is an image or solid color (greeter/BackgroundType). If image is selected, there is a file selection button to pick the image file (greeter/BackgroundImage) and a checkbox to scale the image to fit the screen (greeter/BackgroundImageScaleToFit). If solid color is selected, there is a button available to allow the color selection (greeter/BackgroundColor). Also, the user may select the logo image that appears in gdmlogin (greeter/Logo).

If the "Style" choice is "Plain with face browser", then the `gdmlogin` program is used as the GUI (daemon/Greeter) and the face browser is turned on (greeter/Browser). The Face Browser is explained in the Overview section. Otherwise, the choices are the same as when the "Style" choice is "Plain". Additional setup in the Users tab may be necessary to choose which users appear in the Face Browser.

If the "Style" choice is "Themed", then the `gdmgreeter` program is used as the GUI (daemon/Greeter). When this choice is selected, `gdmsetup` allows the user to select the theme to be used (greeter/GraphicalTheme). Note that the checkbox to the left of the theme's name must be checked for a theme to be selected. Clicking on the theme, but not selecting the checkbox will highlight the theme and the "Remove" button can be used to delete the theme. Information about the theme's author and copyright are shown for the highlighted theme. The "Add" button can be used to add new themes to the system. To turn on the Face Browser, a theme which includes a Face Browser must be selected, such as happygnome-list. The "Background color" displayed when GDM starts (and if the theme has transparent elements) can also be selected (greeter/GraphicalThemedColor). The "Theme" combo box may be set to "Random from selected" if you want a random theme to be used for each login (greeter/GraphicalThemeRand and greeter/GraphicalThemes). To use random themes, select each theme that you wish to be used. By default this combobox is set to "Selected only", so that only a single theme can be selected and be used.

Regardless of the "Style" choice, the user may also select whether the Actions menu is visible (greeter/SystemMenu), whether the Actions menu includes the choice to start `gdmsetup` (greeter/ConfigAvailable), and whether the Action menu includes the choice to start `gdmchooser` to run a remote XDMCP login session (greeter/ChooserButton). Note that the root password must be entered to start `gdmsetup` from the login screen if it is enabled. Also the Welcome message displayed for local sessions may be selected (greeter/DefaultWelcome and greeter/Welcome). The Welcome message can contain the character sequences described in the "Text Node" section of the "Themed Greeter" section of this manual.

### Remote Tab

The Remote tab controls the appearance of the GDM for users logging in via XDMCP. By default XDMCP is disabled, and users should be comfortable with the XDMCP-related sections of the Security section of this document before enabling it. This tab includes a "Style" combobox which can be used to turn on XDMCP and control the appearance of GDM for remote users (gui/RemoteGreeter and xdmcp/Enable). This combobox may be set to "Remote login disabled" or "Same as Local". If the Local tab is set to "Plain" or "Plain with Face Browser", then the user may also select "Themed". If the Local tab is set to "Themed", then the user may also select "Plain" or "Plain with face browser". It is recommended that the "Plain" GUI be used for remote connections since it is more lightweight and tends to have better performance across a network.

If Remote login is enabled, then the user can specify the remote Welcome Message to be displayed (greeter/DefaultRemoteWelcome and greeter/RemoteWelcome). This welcome message is separate from the Local welcome message and can have a different value. The Welcome message can contain the character sequences described in the "Text Node" section of the "Themed Greeter" section of this manual.

If the "Style" choice is "Same as Local" and the local selection is "Plain" or "Plain with face browser", then the user may select whether background images should be displayed for remote logins (greeter/BackgroundRemoteOnlyColor).

If the "Style" choice is enabled and set to a different value than the Local tab, then the user has the same configuration choices as found on the Local tab except that the System Menu choices are not available since this is never available for remote logins for security purposes.

If Remote login is enabled, there is a "Configure XDMCP" button which displays a dialog allowing the user to set XDMCP configuration, including whether indirect requests are honored (xdmcp/HonorIndirect), UDP port (xdmcp/Port), maximum pending requests (xdmcp/MaxPending), maximum pending indirect requests (xmdcp/MaxPendingIndirect), maximum remote sessions (xdmcp/MaxSessions), maximum wait time (xdmcp/MaxWait), maximum indirect wait time (xdmcp/MaxWaitIndirect), displays per host (xdmcp/DisplaysPerHost), and ping interval (xdmcp/PingIntervalSeconds). The default settings are standard settings and should only be changed by someone who understands the ramifications of the change.

### Accessibility Tab

The Accessibility tab is used to turn on Accessibility features in GDM. "Enable accessible login" (daemon/AddGtkModules and daemon/GtkModulesList) turns on GDM's gesture listeners which are explained in the "Accessibility" section of this document. There is also a checkbox to allow users to change the theme when using the Plain greeter (gui/AllowGtkThemeChange). This feature allows GDM users to switch the theme to the HighContrast or LowContrast themes if needed. The user may also select whether GDM should play a sound when the login screen is ready, when login is successful and when login has failed. File chooser buttons are used to select the sound file to be played, and the "Play" button can be used to sample the sound.

### Security Tab

The Security tab allows the user to turn on Automatic and Timed login, which user is logged in via an automatic or timed login, and the timed login delay (daemon/AutomaticLoginEnable, daemon/AutomaticLogin, daemon/TimedLoginEnable, daemon/TimedLogin, and daemon/TimedLoginDelay). If automatic login is turned on, then the specified user will immediately log in on reboot without GDM asking for username/password. If the user logs out of their session, GDM will start and ask for username and password to log back in. If TimedLogin is turned on, then GDM will log in to the specified user after a specified number of seconds. The user may enable Timed Login for remote (XDMCP) connections by checking the "Allow remote timed logins" checkbox.

On this tab, the user may select whether the system administrator user can log in, and whether the system administrator user can log in via remote (XDMCP) connections (security/AllowRoot and security/AllowRemoteRoot). The user may turn on GDM debug (debug/Enable) which causes debug messages to be sent to the system log. Debug should only be used when diagnosing a problem and not be left on when not needed. The "Deny TCP connections to Xserver" choice will disable X forwarding if selected (security/DisallowTCP). A login retry delay (security/RetryDelay) can be set to cause GDM to wait a number of seconds after a failed login.

The "Configure X Server" button can be used to specify how GDM manages each display. The "Servers" combobox shows what server definitions are available (Standard, Terminal, and Chooser by default). Refer to the "X Server Definitions" section of the "Configuration" section for more information about how to create new Server Definitions.

For any server type, the user may modify the "Server Name" (server/name), the "Command" (server/command) to be used to launch the Xserver, whether the server type will "Launch" (server/chooser) the greeter or chooser GUI after starting the Xserver, whether GDM handles this type (normally only set to false when logging into a Terminal session type), and whether the session type supports "Flexible" (server/flexible) sessions.

The "Servers To Start" section shows what server type is displayed for each display on the machine. Users may click on the "Add/Modify" button to add a new display to the list or to modify a selected display. This simply corresponds each physical display with the Server Definition to be used for managing that display. The "Remove" button may be used to remove a display from the list.

### Users Tab

The Users tab controls which users appear in the Face Browser. If the "Include all users from /etc/password" checkbox is selected, then all users (with a userid above greeter/MinimalUID and not in the Exclude list) are displayed. If this checkbox is not selected, then users must be added to the "Include" list. Users in the "Exclude" list are never displayed. The "Add" and "Remove" buttons are used to add a new user to the list or remove a selected user from the list. The "Apply User Changes" button must be pressed after the "Include" and "Exclude" lists have been modified. The left and right arrow buttons between the "Include" and "Exclude" lists can be used to move a selected user from one list to the other.

## Налаштовування

GDM has powerful configuration management. System configuration is stored in `<share>/gdm/defaults.conf` and the intention is that this file can be stored on a shared filesystem so that sysadmins can have a single file to modify to control configuration for multiple machines. Also GDM distributions may patch this file on update to improve usability, improve security, etc. Configuration may be customized for a specific machine by editing the `<etc>/gdm/custom.conf` file to include an override for a specific key. Those parameters in the "gui", "greeter" sections, and the security/PamStack key may be customized per-display by specifying them in a file named `<etc>/gdm/custom.conf<display num>`. For example, configuration overrides for display ":103" would be stored in the file `<etc>/gdm/custom.conf:0`. Per-display configuration is supported in GDM 2.14.6 and later.

The `gdmsetup` is a GUI program you can use to edit the GDM configuration. This program may also be launched directly from the login screen if the greeter/ConfigAvailable key is set to "true" Not all keys in the GDM configuration file are supported in the GUI, so you may need to edit the configuration files by hand to edit these keys. If you believe running root-owned GUI's causes security risk, then you would want to always edit the files by hand. This program does not support setting per-display configuration, so per-display configuration files must be set up by hand.

Distributions should edit the `<share>/gdm/defaults.conf` file to establish the default values so these are preserved as defaults and not modified by users modifying their personal configuration file `<etc>/gdm/custom.conf`.

If you want to change configuration by hand, edit the `<etc>/gdm/custom.conf` file and make sure the keyname=value pair you want is included in the appropriate section. For example, to change the "Greeter" key in the "daemon" section, make sure the daemon section of the `<etc>/gdm/custom.conf` file has the value like in this example.

    [daemon]
    Greeter=/usr/lib/gdmgreeter

The configuration files (especially the `<share>/gdm/defaults.conf` and `<etc>/gdm/custom.conf` files) contain useful comments and examples, so read them for more information about changing your configuration. GDM considers lines that start with the "#" character a comment, and these lines will be ignored by GDM. Some keys in the `<share>/gdm/defaults.conf` are commented out while others are set. Commented out values show the default value.

The `<share>/gdm/defaults.conf` file contains the default configuration choices for GDM, and should not be modified by the user. The `<etc>/gdm/custom.conf` file is where users may specify their custom configuration choices. Configuration options specified in the `<etc>/gdm/custom.conf` file override the values in the main `<share>/gdm/defaults.conf` file. Running the `gdmsetup` command will cause the `<etc>/gdm/custom.conf` to be modified with the user's configuration choices and will cause any running GDM GUI programs to automatically update. Previous to version 2.13.0.4 GDM only supported the `<etc>/gdm/gdm.conf` file, so if using an older version of GDM just edit that file directly.

The location of the configuration files may be controlled via the `--with-defaults-conf` and `--with-custom-conf` configuration options. The GDM daemon --config option may also be used to specify the configuration file location. The GDM daemon must be restarted to change the configuration file being used.

`<share>/gdm/factory-defaults.conf` - конфігураційний файл, що постачається із службою. Він може знадобитись щоб побачити зміни у файлі `<share>/gdm/defaults.conf` .

Інші конфігураційні файли GDM типово розташовані у каталозі `<etc>/gdm/` та його підкаталогах. Проте, розташування усіх конфігураційних файлів можна вказати у конфігураційному файлі GDM, тож системний адміністратор може розташувати ці файли будь-де.

Перелік вмісту конфігураційного каталогу:

    locale.alias
    Xsession
    XKeepsCrashing
    modules/
    Init/
    PostLogin/
    PreSession/
    PostSession/

`locale.alias` - файл, який схожий на системний файл псевдонімів локалізацій, але насправді вони відрізняються. У ньому перелічені доступні у вашій системі мови. Підтримка кожної мови перевіряється, перш ніж показати її користувачу у списку.

`Xsession` is a script which sets up a user session and then executes the user's choice of session. Note that the session script is typically started via the `desktop` file associated with the session the user has picked. Some sessions may start the user's session via a different mechanism than the `Xsession` script, so please check the appropriate `desktop` before assuming a session startup issue is being caused by this file.

`XKeepsCrashing` - сценарій, який запускається коли X-сервер аварійно завершується декілька разів. Типовий сценарій працює у більшості дистрибутивів Linux. Він може запустити програму налаштовування X-Window, за умови, що особа за консоллю знає пароль адміністратора (root).

Модулі спеціальних можливостей знаходяться у каталозі `modules/`, їх розглянемо окремо. Читайте самі файли, у них міститься відповідна документація. Типова конфігурація знаходиться, що у своїй назві містять `factory`. Ці файли не читаються, вони існують лише для того, щоб ви завжди мали могли повернути типову конфігурацію.

Наявні сеанси відповідають специфікації freedesktop.org та визначається `.desktop`-файлами у каталозі `<etc>/X11/sessions/`. З них також отримує загальну інформацію про конфігурацію і менеджер KDM. Далі читається каталог `<share>/gdm/BuiltInSessions/`, у ньому шукаються специфічні для GDM вбудовані сеанси (у KDM це жорстко закодовано на момент написання). Зрештою читається каталог `<share>/xsessions/` (який повинен бути `/usr/share/xsessions/`, якщо ви бажаєте сумісності з KDM), де можуть встановлюватись власні файли сеансів з пакетів графічного середовища. Каталоги у `<etc>` повинні бути зарезервованими для конфігурації. Цей підхід спрощує керування пакетами системи для встановлення менеджерів вікон без необхідності редагування файлів системним адміністратором. Щоб змінити шлях дивіться параметр конфігурації `SessionDesktopDir`. Раніше GDM зберігав свої вбудовані сенси у `<etc>/dm/Sessions/`, але це не рекомендовано починаючи з версії 2.5.90.0. Зауважте, до версії 2.4.4.2 читався лише каталог `<etc>/dm/Sessions/`.

Сеанси можна вимкнути (якщо вони встановлені у `<share>/xsessions/`), якщо додати ідентичні за назвою `.desktop`-файли до одного раніше згаданих каталогів, (наприклад `<etc>/X11/sessions`) та вказати `Hidden=true` у цьому файлі.

### Каталоги сценаріїв

У цьому розділі описуються каталоги `Init`, `PostLogin`, `PreSession` та `PostSession`, котрі дуже подібні один до одного.

When the X server has been successfully started, GDM will try to run the script called `Init/<displayname>`. I.e. `Init/:0` for the first local display. If this file is not found, GDM will attempt to to run `Init/<hostname>`. I.e. `Init/somehost`. If this still is not found, GDM will try `Init/XDMCP` for all XDMCP logins or `Init/Flexi` for all on demand flexible displays. If none of the above were found, GDM will run `Init/Default`. The script will be run as root and GDM blocks until it terminates. Use the `Init/*` script for applications that are supposed to run alongside with the GDM login window. xconsole for instance. Commands to set the background etc. go in this file too.

Системний адміністратор може вказати, чи потрібно завершувати запущені у сценарії Init програми перед початком вибраного користувачем сеансу. Це контролюється параметром `KillInitClients`.

Після успішної аутентифікації користувача, GDM намагається виконати сценарій з каталогу `PostLogin` таким самим чином як і у каталозі `Init`. Це робиться до будь-якого встановлення сеансу, тому у цьому сценарії, при необхідності, можна визначити домашній каталог (але, якщо можливо, бажано використовувати для цього модуль `pam_mount`). У цьому сценарії доступні змінні `$USER` та `$DISPLAY`, та він також запускається з правами адміністратора (root). Сценарій повинен повернути 0 при успішному виконанні, у іншому випадку користувачу не буде дозволено увійти. Проте при запуску аварійного сеансу це не так.

Коли GDM налаштує сеанс користувача, він запускає сценарій з каталогу `PreSession`, знову ж таки тим самим чином, як і у каталозі `Init`. Цей сценарій можна використовувати для встановлення локального сеансу або налаштовування обліку. Змінна оточення `$USER` містить ім'я користувача, що пройшов автентифікацію, значення змінної `$DISPLAY` дорівнює значенню поточного дисплею. При успішному виконанні сценарій повинен повернути 0. Будь-яке інше значення призведе до завершення поточного процесу реєстрації у системі. Проте, при запуску аварійного сеансу це не так. Тут встановлено змінну оточення `$X_SERVERS` у значення підробленого згенерованого фай'лу X-сервера для використання з програмою обліку sessreg.

Після цього запускається основний сценарій `Xsession`, якому у першому аргументі передається вибраний виконуваний файл сеансу. Він запускається з правами користувача. Наявні виконувані файли сеансів беруться з рядка `Exec=` у `.desktop` файлах з каталогів вказаних у `SessionDesktopDir`. Зазвичай цей шлях такий: `<etc>/X11/sessions/:<etc>/dm/Sessions:/usr/share/xsessions/`. Використовується перший знайдений файл. Вподобання користувача або вибираються або з цих сеансів, або GDM шукає їх у файлі `~/.dmrc`.

This script should really load the user's profile and generally do all the voodoo that is needed to launch a session. Since many systems reset the language selections done by GDM, GDM will also set the `$GDM_LANG` variable to the selected language. You can use this to reset the language environmental variables after you run the user's profile. If the user elected to use the system language, then `$GDM_LANG` is not set.

Коли користувач завершує сеанс, знову виконується сценарій з `PostSession`. Всі дії такі самі як і у `Init`, `PostLogin` та `PreSession`. Знову ж таки сценарій запускається з правами адміністратора (root), допоміжний процес сервера блокується. Змінна оточення `$USER` містить ім'я користувача, який завершує сеанс, змінна оточення `$DISPLAY` буде встановлена у значення дисплею, але зверніть увагу, що X-сервер для цього дисплею може бути вже завершений, тому не слід намагатись отримати до нього доступ. Тут встановлена змінна оточення `$X_SERVERS`, вона має значення фальшивого згенерованого файлу x-сервера для використання з програмою обліку sessreg.

Зверніть увагу, сценарій `PostSession` запускається навіть якщо дисплей завершився аварійно через помилку вводу/виводу або щось подібне. Тому, не гарантується, що X-програми працюватимуть при його виконанні.

З винятком сценарію `Xsession` в усіх цих сценаріях визначена змінна оточення `$RUNNING_UNDER_GDM` встановлена у `yes`, тому ви можете використовувати ці сценарії з іншими менеджерами дисплеїв. У сценарії `Xsession` завжди визначена змінна `$GDMSESSION`, її значення - назва файлу сеансу користувача (без частини зі шляхом та без розширення `.desktop`). Додатково також визначено змінну `$DESKTOP_SESSION`. Вона має те ж саме значення, фактично воно буде також встановлюватись у майбутніх версіях менеджеру дисплеїв KDM.

Жоден з `Init`, `PostLogin`, `PreSession` чи `PostSession` сценаріїв не є необхідним, та може бути пропущений. Але вимагається сценарій `Xsession`, та хоча б один файл сеансу `.desktop`.

### Конфігураційний файл - `defaults.conf` та `custom.conf`

GDM uses two configuration files: `<share>/gdm/defaults.conf` and `<etc>/gdm/custom.conf`. The `<share>/gdm/defaults.conf` file contains the default configuration choices for GDM, and should not be modified by the user. The `<etc>/gdm/custom.conf` file is where users may specify their custom configuration choices. Configuration options specified in the `<etc>/gdm/custom.conf` file override the values in the `<share>/gdm/defaults.conf` file. If a configuration option is not defined in either file, GDM will default to the value described in the comments in the `<share>/gdm/defaults.conf` file.

Running the `gdmsetup` command will cause the `<etc>/gdm/custom.conf` to be modified with the user's configuration choices.

Previous to GDM 2.13.0.4 only the `<etc>/gdm/gdm.conf` existed. If upgrading to the new version of GDM, install will check to see if your `<etc>/gdm/gdm.conf` file is different than your `<etc>/gdm/factory-gdm.conf` file. If so, your `<etc>/gdm/gdm.conf` file will be automatically copied to `<etc>/gdm/custom.conf` to preserve any configuration changes.

The location of the configuration files may be controlled via the `--with-defaults-conf` and `--with-custom-conf` configuration options. The GDM daemon --config option may instead be used to specify the configuration file location. The GDM daemon must be restarted to change the configuration file being used.

Обидва конфігураційні файли поділяється на розділи, кожен з яких містить змінні, які визначають поведінку окремих частин пакету GDM. Додаткову інформацію про конфігураційні параметри можна отримати з коментарів у файлі `<share>/gdm/defaults.conf`.

`<share>/gdm/defaults.conf` та `<etc>/gdm/custom.conf` має синтаксис конфігураційних файлів у стилі `.ini`. Ключові слова у прямокутних дужках визначають розділи, рядки перед знаком дорівнює (=) є змінними, а дані після знаку тотожності є їх значеннями. Порожні рядки або рядки, що починаються зі знаку (#) ігноруються. Графічна програма налаштовування намагається зберігати як коментарі (рядки зі знаком діез), так і загальну структуру файлу, тому ви можете змінювати файл як за допомогою графічної програми, так і за допомогою текстового редактора.

#### Конфігурація сервера

##### [daemon]

AddGtkModules

      AddGtkModules=false

  Якщо має значення true, це дозволяє запускати `gdmgreeter` чи `gdmlogin` з додатковими модулями Gtk+. Це корисно якщо необхідні додаткові властивості, наприклад підтримку спеціальних можливостей. Зверніть увагу, для мінімізації загроз безпеці повинні використовуватись лише "довірені" модулі.

  If true, then the registry daemon `at-spi-registryd` will be launched by `gdmgreeter` or `gdmlogin` starting with version GDM 2.17.

  Зазвичай використовується для підтримки спеціальних можливостей. Модулі, які завантажуються, визначаються параметром `GtkModulesList`.

AlwaysRestartServer

      AlwaysRestartServer=false

  Якщо має значення true, то gdm ніколи не намагатиметься повторно використати існуючі X-сервери шляхом їх повторної ініціалізації. Наявні серверні процеси будуть знищуватись та будуть запускатись нові. Зазвичай, повторна ініціалізація більш гарний шлях, але якщо зростає обсяг пам'яті, яку використовує X-сервер, то цей шлях більш безпечний. На Solaris значення завжди true, та цей параметр ігнорується.'

AlwaysLoginCurrentSession

      AlwaysLoginCurrentSession=true

  If true, then when the user logs in and already has an existing session, then they are connected to that session rather than starting a new session. This only works for sessions running on VTs (Virtual Terminals) started with gdmflexiserver, and not with XDMCP. Note that VTs are not supported on all operating systems.

AutomaticLoginEnable

      AutomaticLoginEnable=false

  Чи починати автоматично сеанс при першому завантаженні від імені користувача, що вказаний у змінній AutomaticLogin. Пароль не буде запитано. Ця функція використовується на робочих станціях з єдиним користувачем, коли безпека локальної консолі не має особливого значення. Також може використовуватись для публічних терміналів, хоча дивіться параметр `TimedLogin`.

AutomaticLogin

      AutomaticLogin=

  Після першого запуску починається сеанс цього користувача. Для цього необхідно щоб ім'я було ім'ям дійсного користувача, та щоб параметр AutomaticLoginEnable мав значення true. Проте, автоматичний вхід адміністратора ("root") недопустимий, та gdm не буде автоматично починати сеанс адміністратора, навіть якщо ви так вкажете.

  У значенні цього параметра допустимі такі макроси:

  &percnt;&percnt;— the `&percnt;' character

  &percnt;d — назва дсплею

  &percnt;h — назва вузла дисплею

  Або ж, якщо значення параметра закінчується вертикальною рискою | (символ каналу). Тоді параметр вважається назвою програми, що виконується та виводиться ім'я користувача у стандартний потік виводу. Якщо програма повертає порожній рядок або неправильне ім'я користувача, автоматичний вхід не виконується. Ця можливість використовується, коли декілька віддалених терміналів використовуються як Інтернет-термінали, з автоматичною реєстрацією на кожному дисплеї заданого користувача.

BaseXsession

      BaseXsession=<etc>/gdm/Xsession

  Це - основний файл X-сеансу. При реєстрації користувача, у першому аргументі сценарію передається вибраний виконуваний файл сеансу. Вибраний сеанс буде значенням з рядка `Exec=` у `.desktop` файлі сеансу.

  Якщо ви бажаєте використовувати один сценарій для усіх менеджерів дисплеїв, та бажаєте, щоб деякі сценарії запускались лише при використанні GDM, тоді слід перевіряти наявність змінної оточення `GDMSESSION`. Її значення завжди дорівнює назві файлу `.desktop` (без розширення), що використовується для поточного сеансу, та встановлюється лише для GDM сеансів. Раніше деякі сценарії перевіряли змінну `GDM_LANG`, але вона встановлюється лише якщо користувач обирає несистемну мову.

  Цей сценарій має подбати про виконання "login" для користувача та має включати файл `<etc>/profile` та інші подібні файли. Стандартний сценарій, що постачається з GDM включає файли у такому порядку: `<etc>/profile`, потім `~/.profile` потім `<etc>/xprofile` та зрештою `~/.xprofile`. Зауважте, у різних дистрибутивах порядок може відрізнятись. Іноді особисті параметри користувача встановлюються у `~/.bash_profile`, але це неправильно.

Chooser

      Chooser=<bin>/gdmchooser

  Повний шлях та назва програми вибору, за якими можуть йти аргументи.

Configurator

      Configurator=<bin>/gdmsetup --disable-sound --disable-crash-dialog

  Шлях до програми налаштовування. Якщо параметр програми привітання `ConfigAvailable` встановлено у true, тоді ця програма запускається коли хтось обирає Налаштовування з меню Дії. Звичайно GDM спершу запитає пароль користувача root. Ця функція недоступна на віддалених дисплеях.

ConsoleCannotHandle

      ConsoleCannotHandle=am,ar,az,bn,el,fa,gu,hi,ja,ko,ml,mr,pa,ta,zh

  Ці мови не можуть оброблятись консоллю через проблеми з шрифтами. Тут мається на увазі текстова консоль, а не X Window. Використовується лише коли є повідомлення про помилки та неможливо запустити систему X.

ConsoleNotify

      ConsoleNotify=true

  Якщо встановлено значення false, то gdm не відображатиме повідомлення про помилки на консолі.

DefaultPath

      DefaultPath=типовийшлях (значення визначається при configure)

  Specifies the path which will be set in the user's session. This value will be overridden with the value from `/etc/default/login` if it contains "ROOT=<pathname>". If the `/etc/default/login` file exists, but contains no value for ROOT, the value as defined in the GDM configuration will be be used.

DefaultSession

      DefaultSession=gnome.desktop

  Сеанс, що використовується коли користувач у списку сеансів вибрав 'Останній' і не має збережених уподобань. Зауважте, сеанс 'Останній' не відображається, дивіться ключ `ShowLastSession`.

DisplayInitDir

      DisplayInitDir=<etc>/gdm/Init

  Каталог, що містить сценарій ініціалізації дисплею. Докладніше про це дивіться у розділі ``Каталоги сценаріїв''.

DisplayLastLogin

      DisplayLastLogin=true

  Якщо має значення true, то перед запитом паролю користувачу виводиться інформація про останній сеанс.

  Це для відповідності GDM до CSC-STD-002-85, хоча наразі це суто теоретично. Хтось має прочитати цю специфікацію та переконатись що відповідність є (так само як і у інших місцях GDM). Докладніше про це дивіться `http://www.radium.ncsc.mil/tpep/library/rainbow/CSC-STD-002-85.html`.

DoubleLoginWarning

      DoubleLoginWarning=true

  Якщо має значення true, GDM буде попереджувати користувача, якщо він вже увійшов у сеанс з іншого віртуального терміналу. На системах, де GDM підтримує перевірку віртуальних терміналів X, GDM дозволить користувачу замість входу у сеанс перемкнутись на попередній віртуальний термінал з сеансом.

DynamicXServers

      DynamicXServers=false

  Якщо має значення true, служба GDM буде обробляти запити керування дисплеями через сокет `/tmp/.gdm_socket`. Відповідними командами можна створювати, запускати та видаляти дисплеї. Команда `gdmdynamic` - зручний метод надсилання таких повідомлень.

FailsafeXServer

      FailsafeXServer=

  Командний рядок X у разі неможливості запуску звичайного X-сервера. Має бути невеликим сценарієм, що запускає відповідний сервер з низькою роздільною здатністю, який напевно працюватиме. Він випробовується перед запуском сценарію `XKeepsCrashing`.

FirstVT

      FirstVT=7

  На системах де GDM підтримує автоматичне призначення віртуальних терміналів (VT), це перший віртуальний термінал, який буде випробуваний. Зазвичай, на віртуальних терміналах з молодшими номерами запускаються текстові консолі. Також дивіться `VTAllocation`.

FlexibleXServers

      FlexibleXServers=5

  Максимальна допустима кількість гнучких серверів. Це сервери, які можуть запускатись використовуючи сокет `/tmp/.gdm_socket`. Це використовується як для повноцінних гнучких серверів, так і для серверів Xnest.

FlexiReapDelayMinutes

      FlexiReapDelayMinutes=5

  Скільки хвилин неактивності має минути у екрані входу, щоб гнучкий сервер став be reaped. Це матиме ефект лише до входу користувача у сеанс. Також це не впливає на гнучкі сервери Xnest. Для вимикання цієї функції встановіть значення у 0. Функцію додано починаючи з версії 2.5.90.0.

Greeter

      Greeter=<bin>/gdmlogin

  Повний шлях та назва файлу програми привітання, а також необов'язкові аргументи. Ця програма привітання використовується для всіх серверів за винятком віддалених серверів XDMCP. Також дивіться `RemoteGreeter`

Group

      Group=gdm

  Назва групи, від імені якої запускаються `gdmlogin`, `gdmgreeter` `gdmchooser` та внутрішні аварійні діалогові вікна GTK+. Також дивіться параметр `User`. Цей користувач матиме доступ до усіх файлів авторизації X-сервера, та, можливо, до інших внутрішніх даних GDM, тому він не повинен бути таким користувачем як nobody, а цілком окремим користувачем. До цієї групи належить `ServAuthDir`. Власник та права доступу `ServAuthDir` мають бути `root.gdm` та 1770.

GtkModulesList

      GtkModulesList=module-1:module-2:...

  Список модулів Gtk+, що розділені комою, які `gdmgreeter` чи `gdmlogin` будуть викликати якщо параметр `AddGtkModules` має значення true. Формат такий самий як у стандартному інтерфейсі модулів Gtk+.

HaltCommand

      HaltCommand=<sbin>/shutdown -h now

  Повний шлях та аргументи команди, яка виконується коли користувач вибирає "Вимкнути комп'ютер" у меню Дії. Це може бути розділений символом ';' список команд, які будуть випробуватись по черзі. Якщо значення відсутнє, команда вимикання недоступна. Зауважте, типове значення цього параметра не порожнє, тому для заборони вимикання комп'ютера потрібно явно призначити параметру порожнє значення.

KillInitClients

      KillInitClients=true

  Визначає чи GDM має знищувати (командою kill) X-клієнтів, які запущені у сценаріях ініціалізації при вході користувач у сеанс.

LogDir

      LogDir=<var>/log/gdm

  Каталог, що містить файли журналів для окремих дисплеїв. Типово має таке саме значення як і параметр ServAuthDir.

PidFile

      PidFile=<var>/run/gdm.pid

  Назва файлу, що містить ідентифікатор процесу `gdm`.

PreFetchProgram

      PreFetchProgram=command

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

PostLoginScriptDir

      PostLoginScriptDir=<etc>/gdm/PostLogin

  Каталог, що містить сценарії, які запускаються після входу користувача, але до будь-якого встановлення сеансу. Докладніше про це дивіться у розділі ``Каталоги сценаріїв''.

PostSessionScriptDir

      PostSessionScriptDir=<etc>/gdm/PostSession

  Каталог, що містить сценарії, які запускаються після виходу користувача з сеансу. Докладніше про це дивіться у розділі ``Каталоги сценаріїв''.

PreSessionScriptDir

      PreSessionScriptDir=<etc>/gdm/PreSession

  Каталог, що містить сценарії, які запускаються перед входом користувача у сеансу. Докладніше про це дивіться у розділі ``Каталоги сценаріїв''.

RebootCommand

      RebootCommand=<sbin>/shutdown -r now

  Повний шлях та необов'язкові аргументи програми, що буде виконуватись коли користувач вибирає у меню Діє пункт "Перезавантажити". Це може бути список розділених символом ';' команд, які будуть випробуватись по черзі. Якщо значення відсутнє, команда перезапуску недоступна. Зауважте, що типове значення не є порожнім, тож щоб вимкнути можливість перезавантаження слід явно встановити порожнє значення.

RemoteGreeter

      RemoteGreeter=<bin>/gdmlogin

  Повний шлях та назва файлу програми привітання та її необов'язкові аргументи. Використовується для усіх віддалених сенсів XDMCP. Тут бажано вказати менш вибагливу до ресурсів програму привітання, якщо основною програмою привітання використовується програма привітання з темами. Також дивіться ключ `Greeter`.

RootPath

      RootPath=типовийшлях (значення визначається при configure)

  Specifies the path which will be set in the root's session and the {Init,PostLogin,PreSession,PostSession} scripts executed by GDM. This value will be overridden with the value from `/etc/default/login` if it contains "SUROOT=<pathname>". If the `/etc/default/login` file exists, but contains no value for SUROOT, the value as defined in the GDM configuration will be used.

ServAuthDir

      ServAuthDir=<var>/gdm

  Каталог містить файли X-аутентифікації для окремих дисплеїв. Має належати `root.gdm` з правами 1770, де `gdm` - група GDM, яка визначена параметром `Group`. Тобто власником має бути root, група `gdm` повинна мати права на запис, для каталогу має бути встановлено sticky-біт, та інші не повинні мати прав доступу до каталогу. Таким чином користувач gdm не зможе видалити у цьому каталозі файли, що створені root, однак зможе створювати власні файли. GDM намагатиметься змінити права доступу, якщо при першому запуску права будуть відрізнятись від вказаних вище. Каталог також використовується для інших приватних файлів, які зберігає служба. Інші користувачі не повинні мати змогу увійти в цей каталог та читати чи писати у файли у ньому. Будь-хто, хто може читати цей каталог, може з'єднатись з будь-яким дисплеєм на цьому комп'ютері.

SessionDesktopDir

      SessionDesktopDir=<etc>/X11/sessions/:<etc>/dm/Sessions/:<share>/xsessions/

  Каталог, що містить файли `.desktop`, які представляють доступні сеанси на цій системі. Починаючи з 2.4.4.2, він розглядається як змінна типу PATH та використовується перший знайдений файл.

SoundProgram

      SoundProgram=<bin>/play (або <bin>/audioplay на Solaris)

  Програма, що використовується для відтворення звуку. Наразі використовується для відтворення звуку при вході у сеанс, дивіться ключ `SoundOnLoginFile`. Підтримується з 2.5.90.0.

StandardXServer

      StandardXServer=/каталог/до/X (значення, що визначається у конфігураційному файлі)

  Повний шлях та необов'язкові аргументи команди запуску стандартного X-сервера. Використовується коли gdm не може знайти ніяке інше визначення, та використовується як типовий та аварійний варіант у кількох випадках. Має запускати якийсь X-сервер.

SuspendCommand

      SuspendCommand=

  Повний шлях та необов'язкові аргументи команди, що виконується коли користувач вибирає Призупинити комп'ютер з меню Дії. Якщо значення відсутнє, команда призупинки недоступна. Зауважте, що типове значення цього параметра не є порожнім, тому для заборони можливості перезапуску треба явно встановити порожнє значення.

TimedLoginEnable

      TimedLoginEnable=false

  Чи має запускатись сеанс користувача, вказаного у параметрі `TimedLogin`, після певної кількості секунд (у параметрі `TimedLoginDelay`) відсутності активності у вікні входу. Використовується для терміналів загального доступу або навіть у домашньому використанні. Якщо користувач використовує клавіатуру або переглядає меню, відлік часу скидається на `TimedLoginDelay` або 30 секунд, в залежності від того яке значення більше. Якщо користувач не ввів ім'я а просто натиснув на клавішу ENTER, тоді GDM вважає що користувач бажає негайно увійти з іменем користувача відкладеного входу. Зауважте, при цьому не запитується пароль, тож будьте обережні, хоча при використанні PAM можна налаштувати запит паролю перш, ніж дозволити вхід.

TimedLogin

      TimedLogin=

  Користувач, сеанс якого запускається після вказаного інтервалу неактивності. Ним не може бути "root", у будь-якому разі gdm відмовлятиметься запускати таким способом сеанс root. Підтримуються такі самі функції як і для `AutomaticLogin`. Використовуються такі самі керуючи символи та канали до програм.

TimedLoginDelay

      TimedLoginDelay=30

  Delay in seconds before the `TimedLogin` user will be logged in. It must be greater then or equal to 10.

User

      User=gdm

  Ім'я користувача, від імені якого запускаються `gdmlogin`, `gdmgreeter`, `gdmchooser` та внутрішні аварійні діалогові вікна GTK+. Також дивіться параметр `Group`. Цей користувач матиме доступ до усіх файлів авторизації X-сервера, та, можливо, до інших внутрішніх даних GDM, тому він не повинен бути таким користувачем як nobody, а цілком окремим користувачем.

UserAuthDir

      UserAuthDir=

  Каталог, де має зберігатись файл `.Xauthority`. Якщо нічого не вказано, використовується домашній каталог користувача. Тильда розпізнається як домашній каталог, тому можна вказати щось подібне: `~/authdir/`.

  Якщо ви не використовуєте тильду, тоді назва створюваного файлу буде випадковою, подібна до `UserAuthFBDir`. Таким чином користувачі матимуть однаковий каталог аутентифікації. Наприклад, якщо домашній каталог користувача на NFS, ви можете встановити значення цього параметра `/tmp`, щоб файли cookie не передавались через мережу. Користувачі повинні мати право запису у цьому каталозі, та для цього каталогу має бути виставлений sticky-біт, як для каталогу `/tmp`.

  Normally if this is the user's home directory GDM will still refuse to put cookies there if it thinks it is NFS (by testing root-squashing). This can be changed by setting `NeverPlaceCookiesOnNFS` in the `[security]` section to false.

UserAuthFBDir

      UserAuthFBDir=/tmp

  Якщо GDM не вдається оновити файл `.Xauthority` для користувача, аварійний файл створюється у цьому каталозі.

UserAuthFile

      UserAuthFile=.Xauthority

  Назва файлу, що використовується для зберігання файлів cookie користувачів.

VTAllocation

      VTAllocation=true

  На системах, де GDM підтримує автоматичне призначення віртуальних терміналів (VT) (наразі лише у Linux), ви можете змусити GDM додавати аргумент vt до команди запуску X-сервера. Таким чином можна уникнути стану змагання, який виникає коли кожен X-сервер робить власний запит на керування віртуальним терміналом. Також дивіться `FirstVT`.

XKeepsCrashing

      XKeepsCrashing=<etc>/gdm/XKeepsCrashing

  Сценарій, що запускається у випадку багаторазового аварійного завершення X-сервера. Використовується для запуску програми налаштовування X-сервера, або чогось іншого, що має створити працездатну конфігурацію X-сервера. Як приклад, дивіться сценарій, який постачається з дистрибутивом. Сценарій `XKeepsCrashing`, що надається, перевірявся на Red Hat, але може працювати і для інших систем. Ваш системний інтегратор має оновити цей сценарій для вашої системи.

  Якщо встановлено значення `FailsafeXServer`, його буде випробувано першим. Використовується лише як резерв, якщо сервер продовжує аварійно завершуватись.

Xnest

      Xnest=<bin>/X11/Xnest (/usr/openwin/bin/Xnest на Solaris)

  Повний шлях та необов'язкові аргументи команди запуску Xnest. Використовується для гнучких серверів Xnest. Таким чином користувач може запустити нові екрани входу у вкладених вікнах. Звичайно, у системі має бути встановлено Xnest з пакету X-сервера.

#### Параметри безпеки

##### [security]

AllowRoot

      AllowRoot=true

  Чи дозволяти користувачу root (адміністратору) входити через GDM. Значення false забороняє такий вхід.

  На системах, що підтримуються PAM, цей параметр не такий корисний, тому що те саме можна зробити за допомогою PAM, або навіть більше. Проте, він досі діє, тому на системах з підтримкою PAM, можливо, слід встановити значення true.

AllowRemoteRoot

      AllowRemoteRoot=false

  Чи дозволяти користувачу root (адміністратору) входити віддалено через GDM. Якщо треба вимкнути такий тип входу, встановіть значення false. Віддаленим входом є будь-який вхід через XDMCP.

  На системах, що підтримуються PAM, цей параметр не такий корисний, тому що те саме можна зробити за допомогою PAM, та навіть більше.

  This value will be overridden and set to false if the `/etc/default/login` file exists and contains "CONSOLE=/dev/login", and set to true if the `/etc/default/login` file exists and contains any other value or no value for CONSOLE.

AllowRemoteAutoLogin

      AllowRemoteAutoLogin=false

  Дозволити відкладений віддалений вхід. Тобто, віддалені з'єднання через XDMCP будуть мати можливість входу користувача, вказаного у "TimedLogin", при певному часі неактивності вікна входу, так само як і для користувачів на локальній консолі.

  Зауважте, це може зробити систему дуже вразливою, тому початково вимкнено.

CheckDirOwner

      CheckDirOwner=true

  Типово, GDM перевіряє власників домашніх каталогів перед записом до них, це запобігає порушенню безпеки у разі помилок встановлення. Проте у деяких випадках власником домашніх каталогів буде інший користувач, тоді необхідно увімкнути цей параметр. Також слід встановити значення ключа `RelaxPermissions` принаймні у значення 1, бо за цим сценарієм домашні каталоги швидше за все доступні групі для запису. Підтримується з 2.6.0.4.

SupportAutomount

      SupportAutomount=false

  By default GDM checks the ownership of the home directories before writing to them, this prevents security issues in case of bad setup. However, when home directories are managed by automounter, they are often not mounted before they are accessed. This option works around subtleties of Linux automounter.

DisallowTCP

      DisallowTCP=true

  Якщо встановлено, тоді завжди додається `-nolisten tcp` до команди запуску X-сервера, таким чином вимикаються TCP-з'єднання. Використовується якщо ви не збираєтесь використовувати віддалені з'єднання, тому що X-протокол потенційно може бути небезпечним, навіть якщо не відомо про існуючі проблеми з безпекою.

NeverPlaceCookiesOnNFS

      NeverPlaceCookiesOnNFS=true

  Normally if this is true (which is by default), GDM will not place cookies into the user's home directory if this directory is on NFS. Well, GDM will consider any filesystem with root-squashing an NFS filesystem. Sometimes however the remote file system can have root squashing and be safe (perhaps by using encryption). In this case set this to 'false'. Note that this option appeared in version 2.4.4.4 and is ignored in previous versions.

PasswordRequired

      PasswordRequired=false

  If true, this will cause PAM_DISALLOW_NULL_AUTHTOK to be passed as a flag to pam_authenticate and pam_acct_mgmt, disallowing NULL password. This setting will only take effect if PAM is being used by GDM. This value will be overridden with the value from `/etc/default/login` if it contains "PASSREQ=[YES|NO]". If the `/etc/default/login` file exists, but contains no value for PASSREQ, the value as defined in the GDM configuration will be used.

RelaxPermissions

      RelaxPermissions=0

  Типово, GDM ігнорує файли та каталоги доступні для запису іншим користувачам, окрім власника.

  Зміна значення RelaxPermissions робить можливим зміну цієї поведінки:

  0 - Параноїдальний режим. Допускаються лише файли та каталоги, власником яких є користувач.

  1 - Допускаються файли та каталоги доступні для запису групі.

  2 - Допускаються файли та каталоги доступні для запису іншим користувачам.

RetryDelay

      RetryDelay=1

  Кількість секунд, які GDM має зачекати після невдалої спроби входу перед повторною активацією поля входу.

UserMaxFile

      UserMaxFile=65536

  GDM не буде читати/записувати файли більші за розміром за це число (у байтах).

  Окрім перевірки розміру GDM дуже прискіпливий відносно доступу до файлів у каталогах. Він не розв'язує символічні посилання, та може, в залежності від параметрів, не сприймати файли та каталоги, що доступні для запису іншим користувачам від власника. Докладнішу інформацію дивіться у параметрі `RelaxPermissions`і.

#### Підтримка XDCMP

##### [xdmcp]

DisplaysPerHost

      DisplaysPerHost=1

  Щоб атакуючі не змогли наводнити запитами чергу очікування, GDM допускає одне з'єднання з одного віддаленого комп'ютера. Якщо ви бажаєте надавати дисплей комп'ютерам з більш ніж одним екраном, відповідно слід збільшити значення `DisplaysPerHost`.

  Зауважте, що кількість з'єднань з локального комп'ютера не обмежується. Цим число обмежується лише кількість з'єднань з віддалених комп'ютерів.

Enable

      Enable=false

  Встановлення значення у true вмикає підтримку XDMCP, що дозволяє керувати GDM віддаленими дисплеями/X-терміналами.

  `gdm` очікує запити на UDP-порту 177. Докладніше дивіться у параметрі Port.

  Якщо GDM скомпільовано з бібліотекою tcp_wrapper, доступ з віддалених дисплеїв може контролюватись цією бібліотекою. Назва служби - `gdm`

  До файлу `<etc>/hosts.allow` слід додати

      gdm:.my.domain

  , в залежності від конфігурації бібліотеки TCP Wrappers. Докладнішу інформацію дивіться у man-сторінці hosts.allow(5).

  Зауважте, що XDMCP не є безпечним протоколом, тому якщо ви не використовуєте UDP-порт 177, його краще заблокувати на вашому брандмауері.

EnableProxy

      EnableProxy=false

  При встановленні значення true вмикається підтримка запуску сеансів XDMCP на локальному проксі X-сервері. Таким чином можна збільшити продуктивність сеансів XDMCP, особливо у мережах з великою затримкою, бо багато операцій X-протоколу можуть завершуватись без передачі по мережі.

  Проте зауважте, у цьому режимі значно збільшується навантаження на сервер сеансів XDMCP

  Докладніше про налаштовування цієї функції дивіться у описі параметрів `FlexiProxy` та `FlexiProxyDisconnect`.

HonorIndirect

      HonorIndirect=true

  Дозволяє XDMCP INDIRECT вибір (тобто віддалене виконання `gdmchooser`) для X-терміналів, як не мають власної програми перегляду дисплеїв.

MaxPending

      MaxPending=4

  Для запобігання атакам типу "відмова у доступі", GDM має фіксований розмір черги очікуючих з'єднань. Одночасно можуть бути запущені лише MaxPending дисплеїв.

  Зауважте, що цей параметр *не* обмежує кількість віддалених дисплеїв, якими можна керувати. Обмежується лише кількість дисплеїв які одночасно ініціюють з'єднання.

MaxPendingIndirect

      MaxPendingIndirect=4

  Одночасно GDM надає лише `MaxPendingIndirect` дисплеїв з програмою вибору вузла. При отриманні більшої кількості запитів від різних вузлів, старші з них забуваються.

MaxSessions

      MaxSessions=16

  Визначає максимальну кількість одночасних з'єднань з віддаленими дисплеями. Тобто загальну кількість віддалених дисплеїв які використовуються на вашому вузлі.

MaxWait

      MaxWait=30

  Коли GDM готовий керувати дисплеєм, йому надсилається пакет ACCEPT який містить унікальний ідентифікатор сеансу, що використовується у майбутніх пакетах XDMCP.

  Потім GDM зберігає ідентифікатор сеансу у черзі, очікуючи відповіді від дисплея пакетом MANAGE.

  Якщо відповідь не надійшла протягом MaxWait секунд, GDM вважає дисплей мертвим та стирає його з черги очікування звільняючи слот для іншого дисплею.

MaxWaitIndirect

      MaxWaitIndirect=30

  Параметр MaxWaitIndirect визначає максимальну кількість секунд між часом, коли користувач вибрав вузол та наступним непрямим запитом до вузла. При перевищенні інтервалу очікування, інформація про вибраний вузол забувається та слот непрямого запиту звільняється. Інформація може відкинутись раніше, якщо вузлів, що намагаються надіслати непрямі запити більше за `MaxPendingIndirect`.

Port

      Port=177

  Номер UDP-порта, на якому `gdm` очікуватиме XDMCP-запитів. Не змінюйте його, якщо ви не знаєте що робите.

PingIntervalSeconds

      PingIntervalSeconds=15

  Інтервал у секундах між ping-запитами до X-сервера. Якщо X-сервер не повернув відповідь до наступного ping-запиту, з'єднання розривається та сеанс завершується. Це - комбінація XDM PingInterval та PingTimeout, але у секундах.

  Зауважте, що GDM у минулому мав ключ конфігурації `PingInterval`, який вказував час у хвилинах. Для більшості застосувань XDMCP не потрібно, щоб значення цього параметра було менше за одну хвилину, проте затримка більша за 15 секунд означатиме, що термінал вимкнений або перезавантажений, та вам слід завершити сеанс.

ProxyReconnect

      FlexiProxyReconnect=

  Встановлення значення параметра вмикає експериментальну підтримку міграції сеансів XDMCP. Це дозволяє користувачам від'єднуватись від їх сеансів та пізніше приєднуватись до того самого сеансу, можливо з іншого терміналу.

  Для використання цієї функції потрібен вкладений X-сервер з підтримкою від'єднання від батьківського X-сервера та з'єднання з іншим сервером. Наразі, цю функцію у деякому ступені підтримує розподілений багатоекранний X-сервер (Distributed Multihead X - DMX), а інші проекти, такі як NoMachine NX зайняті її реалізацією.

  Значенням цього параметра слід встановити шлях до команди, яка обробляє повторне з'єднання XDMCP-проксі до іншого дисплею. Приклад реалізації постачається з DMX.

ProxyXServer

      ProxyXServer=

  Рядок з командою X-сервера для XDMCP-проксі. Можна вказати будь-який вкладений X-сервер, такий як Xnest, Xephr чи Xdmx.

Willing

      Willing=<etc>/gdm/Xwilling

  Коли сервер надсилає пакет WILLING у відповідь на QUERY, він надсилає рядок з поточним статусом цього сервера. Типовим повідомленням є системний ідентифікатор, але можна створити власний сценарій, який відображатиме власне повідомлення. Якщо цей сценарій не існує або цей ключ порожній - надсилається типове повідомлення. Якщо цей сценарій успішно виконується та виводить деякий текст, надсилається перший рядок цього тексту (та лише перший рядок). Він запускається максимум раз на 3 секунди для запобігання можливим атакам типу "відмова у доступі" шляхом затоплення його запитами QUERY.

#### Загальні параметри графічного інтерфейсу

##### [gui]

AllowGtkThemeChange

      AllowGtkThemeChange=true

  Чи дозволяти зміну теми GTK+ (віджет) з програми привітання. Наразі це стосується лише стандартної програми привітання, а графічна програма привітання поки не має такої можливості. Тема застосовується до екрану доки її не буде змінено та буде стосуватись усіх інших вікон GDM. Підтримується з 2.5.90.2.

Gtkrc

      GtkRC=

  Шлях до `gtkrc`, що читається коли GDM виводить вікно. Зараз, натомість використовуйте ключ `GtkTheme` для встановлення теми.

GtkTheme

      GtkTheme=Default

  Назва встановленої теми. Вона використовується у програмі привітання, програмі вибору, та усіх інших графічних вікнах GDM. Підтримується з 2.5.90.2.

GtkThemesToAllow

      GtkThemesToAllow=all

  Список розділених комою допустимих тем. Це мають бути назви встановлених у стандартному місці тем GTK+. Також можна вказати 'all', щоб дозволити усі встановлені теми. Це відноситься до ключа `AllowGtkThemeChange`. Підтримується з 2.5.90.2.

MaxIconWidth

      MaxIconWidth=128

  Визначає максимальну ширину значка (у точках) при перегляді портретів. Більші за розміром значку будуть змінювати масштаб. Це також впливає на значки програми вибору XDMCP.

MaxIconHeight

      MaxIconHeight=128

  Визначає максимальну висоту значка (у точках) у переглядачі портретів. Більші за розміром значку будуть змінювати масштаб. Це також впливає на значки програми вибору XDMCP.

#### Конфігурація програми привітання

##### [greeter]

BackgroundColor

      BackgroundColor=#76848F

  Якщо BackgroundType дорівнює 2, тоді цей колір використовується для тла програми привітання. Він також використовується як задній план прозорих зображень на тлі, якщо встановлено параметр BackgroundRemoteOnlyColor та це віддалений дисплей. Впливає лише на програму привітання на GTK+.

BackgroundProgramInitialDelay

      BackgroundProgramInitialDelay=30

  Програма на тлі запускатиметься після вказаної кількості секунд неактивності.

RestartBackgroundProgram

      RestartBackgroundProgram=true

  Чи перезапускати програму на тлі при її завершенні, після вказаного нижче інтервалу часу. Цей параметр може використовуватись якщо ви хочете запускати програму збереження екрану, коли користувач не користується комп'ютером.

BackgroundProgramRestartDelay

      BackgroundProgramRestartDelay=30

  Програма на тлі буде перезапускатись після неактивності протягом вказаної кількості секунд.

BackgroundImage

      BackgroundImage=somefile.png

  Якщо BackgroundType дорівнює 1, тоді цей файл відображається як тло програми привітання. Впливає лише на програму привітання на GTK+.

BackgroundProgram

      BackgroundProgram=<bin>/xeyes

  Якщо значення встановлено, ця команда буде запускатись на тлі під час відображення вікна входу. Зауважте, що не усі програми запускаються таким чином, тому що для GDM зазвичай не встановлено домашній каталог. Можна встановити домашній каталог для користувача GDM, якщо ви бажаєте запускати програми які цього вимагають. Цей параметр впливає лише на програму привітання на GTK+.

BackgroundRemoteOnlyColor

      BackgroundRemoteOnlyColor=true

  На віддалених дисплеях встановлюється лише колір тла. Це зменшує навантаження на мережу. Також не запускається визначена у `BackgroundProgram` програма. Цей параметр впливає лише на програму привітання на GTK+.

BackgroundScaleToFit

      BackgroundScaleToFit=true

  Змінювати масштаб зображення до меж екрану. Цей параметр впливає лише на програму привітання на GTK+.

BackgroundType

      BackgroundType=2

  Тип тла. 0 - немає, 1 - зображення, 2 - колір, 3 - зображення. Цей параметр впливає лише на програму привітання на GTK+.

Browser

      Browser=true

  При значенні true вмикається переглядач портретів. Докладніше про переглядач портретів дивіться у розділі ``Програма привітання на GTK+''. Цей параметр впливає лише на програму привітання на GTK+ . При використанні програми привітання з підтримкою тем, переглядач портретів вмикається вибором теми, яка включає переглядач портретів

ChooserButton

      ChooserButton=true

  Якщо має значення true, до меню Дії додається кнопка, якою перезапускається поточний сервер з програмою вибору. Для цього не обов'язково вмикати XDMCP на локальному комп'ютері.

ConfigAvailable

      ConfigAvailable=false

  Якщо має значення true, це дозволяє запускати програму налаштовування з програми привітання. Зауважте, перед запуском програми налаштовування користувач має ввести пароль root. Дивіться параметр `Configurator` у розділі daemon.

DefaultFace

      DefaultFace=<share>/pixmaps/nophoto.png

  If a user has no defined face image, GDM will use the "stock_person" icon defined in the current GTK+ theme. If no such image is defined, the image specified by `DefaultFace` will be used. The image must be in a gdk-pixbuf supported format and the file must be readable to the GDM user.

Include

      Include=

  Список розділених комою користувачів, які включаються у переглядач портретів та у список для вибору в `gdmsetup` користувача для автоматичного входу у сеанс. Також дивіться `Exclude`, `IncludeAll`, та `MinimalUID`.

Exclude

      Exclude=bin,daemon,adm,lp,sync,shutdown,halt,mail,...

  Список розділених комою користувачів, які виключаються з переглядача портретів та зі списку для вибору в `gdmsetup` користувача для автоматичного входу у сеанс. Виключені користувачі все-таки можуть увійти, але мають ввести своє ім'я. Також дивіться `Include`, `IncludeAll`, та `MinimalUID`.

IncludeAll

      IncludeAll=false

  Типово, порожній список включених користувачів означає - не відображати користувачів. Але при встановленні значення IncludeAll у true, буде скануватись файл паролів та будуть відображатись усі користувач окрім користувачів, виключених у параметрі Exclude, та користувачів чий ідентифікатор менший за MinimalUID. Сканування файл паролі може сповільнити систему з великою кількістю користувачів, тому цю властивість не слід використовувати у таких середовищах. Також дивіться `Include`, `Exclude`, та `MinimalUID`.

GlobalFaceDir

      GlobalFaceDir=<share>/pixmaps/faces/

  Системний каталог файлів портретів. Системний адміністратор може помістити сюди значки користувачів не зачіпаючи їх домашніх каталогів. Портрети іменуються за обліковими записами їх користувачів.

  Наприклад, `<GlobalFaceDir>/johndoe` містить портрет користувача ``johndoe''. Не слід вказувати розширення файлу.

  Зображення портретів мають бути у підтримуваному gdk-pixbuf форматі та доступні для читання користувачу GDM.

  Власний файл користувача завжди має перевагу над встановленим системним адміністратором.

GraphicalTheme

      GraphicalTheme=circles

  Графічна тема, яку використовує програма привітання з підтримкою тем. Параметр має посилатись на каталог у каталозі тем, що встановлений у `GraphicalThemeDir`.

GraphicalThemes

      GraphicalThemes=circles

  Графічні теми, які використовує програма привітання з підтримкою тем, у режимі випадкової зміни тем. Теми у списку розділюються знаком "/:". Каталог з темами визначається параметром `GraphicalThemeDir`. Використовується лише якщо `GraphicalThemeRand` має значення true.

GraphicalThemeRand

      GraphicalThemeRand=false

  Чи буде графічна програма привітання у режимі з однією темою або у режимі випадкової зміни теми. У режимі з однією темою використовуються теми, що перелічені у `GraphicalTheme`. У режимі з випадковою зміною тем використовуються теми, перелічені у `GraphicalThemes`. Якщо параметр має значення false - використовується режим з однією темою, якщо значення дорівнює true - використовується режим з випадковою зміною тем.

GraphicalThemeDir

      GraphicalThemeDir=<share>/gdm/themes/

  Каталог де встановлено теми програми привітання з темами.

GraphicalThemedColor

      GraphicalThemedColor=#76848F

  Використовувати цей колір як тло програми привітання з підтримкою тем. Впливає лише на програму привітання на GTK+.

InfoMsgFile

      InfoMsgFile=/шлях/до/файлу

  Якщо цей параметр вказаний та /шлях/до/файлу вказує на існуючий та доступний для читання файл (наприклад, <etc>/infomsg.txt), перед допуском користувача до входу у модальному діалоговому вікні відобразиться вміст цього файлу. Параметр впливає як на стандартну програму привітання, так і програму привітання з підтримкою тем.

InfoMsgFont

      InfoMsgFont=шрифт

  Якщо цей параметр вказаний та використовується параметр InfoMsgFile (дивіться вище), тут вказується шрифт для відображення вмісту текстового файлу, вказаного у InfoMsgFile. Наприклад, для вказівки шрифту без зарубок можна вказати Sans 24. Параметр впливає як на стандартну програму привітання, так і програму привітання з підтримкою тем.

LocaleFile

      LocaleFile=<etc>/gdm/locale.alias

  Файл у подібному до GNU locale форматі з записами для усіх підтримуваних системою мов. Опис формату можна знайти вище або у коментарях у цьому файлі.

LockPosition

      LockPosition=true

  Якщо має значення true - позицію вікна входу у графічній програм привітання GTK+ Greeter буде неможливо змінити, навіть якщо увімкнено заголовок вікна.

Logo

      Logo=<share>/pixmaps/gnome-logo-large.png

  Image file to display in the logo box. The file must be in a gdk-pixbuf supported format and it must be readable by the GDM user. If no file is specified the logo feature is disabled. This only affects the GTK+ Greeter.

ChooserButtonLogo

      ChooserButtonLogo=<share>/pixmaps/gnome-logo-large.png

  Image file to display in the file chooser button in `gdmsetup`. This key is modified by `gdmsetup` and should not be manually modified by the user. This only affects the Login Window Preferences (`gdmsetup`).

MinimalUID

      MinimalUID=100

  Мінімальній ідентифікатор користувача, який GDM вважає користувачем. Усі користувачі з меншими ідентифікаторами не включаються у переглядач портретів. Також дивіться параметри `Include`, `Exclude`, та `IncludeAll`.

PositionX

      PositionX=200

  Горизонтальна позиція вікна входу стандартної (GTK+) програми привітання.

PositionY

      PositionY=100

  Вертикальна позиція вікна входу стандартної (GTK+) програми привітання.

Quiver

      Quiver=true

  Визначає чи `gdmlogin` слід трясти екран при вводі неправильного паролю/імені користувач. Це впливає лише на стандартну (GTK+)програму привітання.

DefaultRemoteWelcome

      DefaultRemoteWelcome=true

  має значення true, тоді для параметра `RemoteWelcome` використовується значення "Welcome to %n". Це повідомлення виводиться користувачу у перекладі відповідною мовою. Якщо значення параметра false - використовується параметр `RemoteWelcome`. У рядку можуть використовуватись ті ж самі спеціальні символи, що описані у розділі "Текстовий вузол" глави "Привітання з підтримкою тем". Там пояснюється значення символа "%n".

RemoteWelcome

      RemoteWelcome=Welcome to &percnt;n

  Визначає текст, який відображається біля значка привітання віддаленого сеансу XDMCP. Тут діють такі самі розширення, як і у рядку `Welcome`. У рядку можуть використовуватись ті ж самі спеціальні символи, що описані у розділі "Текстовий вузол" глави "Привітання з підтримкою тем".

RunBackgroundProgramAlways

      RunBackgroundProgramAlways=false

  Якщо має значення true, тоді завжди запускається програма на тлі, у іншому випадку програма запускається лише коли `BackgroundType` має значення 0 (None). Параметр впливає лише на стандартну програму привітання на GTK+.

SetPosition

      SetPosition=true

  Якщо має значення true - позиція вікна входу у програмі привітання на GTK+ визначається значеннями `PositionX` / `PositionY`.

ShowGnomeFailsafeSession

      ShowGnomeFailsafeSession=true

  Чи відображає програма привітання у списку сеансів аварійний сеанс Gnome.

ShowLastSession

      ShowLastSession=true

  Чи показувати 'Останній' сеанс у списку сеансів. Якщо цей параметри вимкнений, тоді GDM працює у так званому 'switchdesk' режимі, який відомий користувачам Red Hat. Тобто, користувачі не можуть вибрати останній сеанс, відбувається вхід у типовий сеанс (дивіться `DefaultSession`), доки не буде вибрано інший тип сеансу для цього конкретного сеансу. Тому, якщо цей параметр вимкнено, збереження останнього сеансу не відбувається.

ShowXtermFailsafeSession

      ShowXtermFailsafeSession=true

  Чи відображає програма привітання у списку сеансів аварійний сеанс Xterm.

SoundOnLogin

      SoundOnLogin=true

  Якщо має значення true, програма привітання подає звуковий сигнал, при готовності до входу у сеанс. Також дивіться ключ `SoundOnLoginFile.`

SoundOnLoginSuccess

      SoundOnLoginSuccess=true

  Якщо має значення true, програма привітання подає звуковий сигнал після успішного входу у сеанс. Також дивіться ключ `SoundOnLoginSuccessFile`.

SoundOnLoginFailure

      SoundOnLoginFailure=true

  Якщо має значення true, програма привітання подає звуковий сигнал після невдалої спроби входу у сеанс. Також дивіться ключ `SoundOnLoginFailureFile`.

SoundOnLoginFile

      SoundOnLoginFile=/path/to/sound.wav

  Файл, який буде відтворюватись при готовності програми привітання до входу у сеанс. Файл відтворюється через певну програму відтворення звуку (типово `/usr/bin/play`). Також дивіться параметри `SoundOnLogin` та `SoundProgram`. Підтримується з 2.5.90.0.

SoundOnLoginSuccessFile

      SoundOnLoginSuccessFile=/path/to/sound.wav

  Файл, який буде відтворюватись після успішного входу у сеанс. Файл відтворюється через певну програму відтворення звуку (типово `/usr/bin/play`). Також дивіться параметри `SoundOnLoginSuccess` та `SoundProgram`.

SoundOnLoginFailureFile

      SoundOnLoginFailureFile=/path/to/sound.wav

  Файл, який буде відтворюватись після невдалої спроби входу у сеанс. Файл відтворюється через певну програму відтворення звуку (типово `/usr/bin/play`). Також дивіться параметри `SoundOnLoginFailure` та `SoundProgram`.

SystemMenu

      SystemMenu=true

  Чи вмикати меню Дії (яке ще іноді називають системним меню). Якщо меню вимкнено, тоді не буде доступна одна жодна з дій. Ці дії включають Вимкнути, Перезавантажити, Налаштувати, програма вибору XDMCP та таке інше. Усі ці дії можна вимикати вибірково. Дії Вимкнути, Перезапустити та Призупинити можна вимкнути встановивши порожнє значення у відповідному параметрі. Зауважте, що меню дії відображається при вході з локального терміналу, тому що воно може містити небезпеку, або бути небажаним при вході з віддаленого терміналу, тому не слід турбуватись, що віддалені користувачі матимуть привілеї консольних користувачів.

  Зауважте, якщо параметри вимкнено, жодна з цих дій не буде доступна, навіть якщо графічна програма привітання помилково відображає їх. Також зауважте, що іноді графічна тема може не відображати усі доступні дії у вигляді кнопок, тоді слід натиснути F10, щоб з'явилось системне меню.

TitleBar

      TitleBar=true

  Чи відображати заголовок вікна привітання. Впливає лише на програму привітання на GTK+.

Use24Clock

      Use24Clock=auto

  Чи використовувати 24-годинний формат годинника. У деяких локалях не підтримується 12-годинний формат (наприклад у Finnish, тобто `fi_FI`). У таких локалях цей параметр на на що не впливає.

  Можливі значення "auto" (типово), "true", та "false". Якщо має значення "auto" або значення відсутнє, формат часу вибирається відповідно до параметрів локалі. Параметри локалі залежать від мови, яка використовується. Таким чином вони змінюються змінною LANGUAGE (розширення GNU), LANG, LC_MESSAGES чи LC_ALL у оточенні запуску GDM. Пріоритет перегляду змінних можна знайти у довіднику з вашої системної бібліотеки C.

UseCirclesInEntry

      UseCirclesInEntry=false

  У полі вводу пароля використовувати кола, замість зірочок. Проте може не підтримуватись в усіх шрифтах.

UseInvisibleInEntry

      UseInvisibleInEntry=false

  Не показувати візуальний зворотний зв'язок у полі паролю. Це стандартна поведінка у консолі та xdm. Встановлення цього параметра скасовує параметр `UseCirclesInEntry`.

DefaultWelcome

      DefaultWelcome=true

  Якщо має значення true, у якості повідомлення привітання використовується "Ласкаво просимо". Це значення перекладається мовою користувача. Якщо поле має значення false, для рядка привітання використовується значення параметра `Welcome`.

Welcome

      Welcome=Welcome

  Визначає текст, що відображається слідом за емблемою у стандартній програмі привітання. Підтримуються наступні керуючи символи:

  &percnt;&percnt;— the `&percnt;' character

  &percnt;d — назва вузла дисплею

  &percnt;h — повна назва домену

  &percnt;m — машина (тиb процесора)

  &percnt;n — назва вузла (тобто, назва вузла без .domain)

  &percnt;r — випуск (версія OS)

  &percnt;s — назва системи (тобто ОС)

  Рядок використовується для локальної консолі. Для віддалених сеансів XDMCP використовується `RemoteWelcome`.

  У програмі привітання з темами розташування цього тексту залежить від теми. Якщо у темі не використовується вбудований рядок привітання, цей рядок може не відображатись взагалі.

XineramaScreen

      XineramaScreen=0

  Якщо активне розширення Xinerama, вікно входу виводиться у центрі фізичного екрану (0 - для першого екрану, 1 - для другого...).

#### Параметри селектора XDCMP

##### [chooser]

AllowAdd

      AllowAdd=true

  Якщо має значення true, користувачу дозволено додавати довільні вузли до селектора. Таким чином користувач може з'єднатись з будь-яким вузлом, який відповідає на запити XDMCP від селектора.

Broadcast

      Broadcast=true

  Якщо має значення true, селектор створює широкомовні запити до локальної мережі та прослуховує відповіді. Таким чином селектор завжди показує доступні у мережі менеджери сеансів. Якщо слід додати деякі вузли, які не є локальними для цієї мережі, або не бажаєте використовувати широкомовні запити, можете вказати вузли у параметрі `Hosts`.

Multicast

      Multicast=true

  Якщо має значення true та увімкнено IPv6, селектор буде надсилати multicast-запити у локальну мережу та слухати відповідь від вузлів, які входять у multicast-групу. Якщо ви не бажаєте надсилати групові запити. можна вказати адресу IPv6 у параметрі `Hosts` . Вузол відповідатиме, якщо він прослуховує запити XDMCP та на ньому увімкнено підтримку IPv6.

MulticastAddr

      MulticastAddr=ff02::1

  У цьому параметрі вказується Link-local адреса Multicast.

DefaultHostImage

      DefaultHostImage=<share>/pixmaps/nohost.png

  File name for the default host icon. This image will be displayed if no icon is specified for a given host. The file must be in a gdk-pixbuf supported format and it must be readable for the GDM user.

HostImageDir

      HostImageDir=<share>/hosts

  Каталог для файлів значків до комп'ютерів. Системний адміністратор може покласти сюди значки до віддалених вузлів, і вони будуть відображатись у `gdmchooser`.

  Назва файлу має відповідати повній доменній назві (FQDN) вузла. Значки мають зберігатись у форматі, який підтримується gdk-pixbuf та мають бути доступні для читання користувачу GDM.

Hosts

      Hosts=host1,host2

  Вузли які мають бути у списку програми вибору вузлів. Вузли відображаються у списку лише якщо вони відповідають на запити. Для цього надсилаються широкомовні запити (якщо встановлено `Broadcast`), тому не слід вказувати вузли локальної мережі. Це корисно, якщо конфігурація мережі не дозволяє дістатись до усіх вузлів пакетами широкомовних запитів.

ScanTime

      ScanTime=4

  Визначає скільки секунд програма вибору вузлів буде очікувати відповідь на BROADCAST_QUERY. Насправді це лише час очікування відповіді. Але вузли будуть додаватись, якщо від них буде отримано відповідь після цього періоду.

#### Налаштовування налагодження

##### [debug]

Enable

      Enable=false

  Setting to true sends debug ouput to the syslog. This can be useful for tracking down problems with GDM. This output tends to be verbose so should not be turned on for general use.

Жести

      Gestures=false

  Setting to true sends debug ouput concerning the accessibility gesture listeners to the syslog. This can be useful for tracking down problems with them not working properly. This output tends to be verbose so should not be turned on for general use.

#### Custom Commands

You can create up to 10 different commands. Gaps between command numbers are allowed and their relative positioning within the section and with respect to each other is not important as long as they conform to the permitted range of [0-9].

##### [customcommand]

CustomCommand[0-9]

      CustomCommand[0-9]=

  Full path and arguments to command to be executed when user selects `n-th` "Custom Command" from the Actions menu. This can be a ';' separated list of commands to try. If the value is empty or missing, then the custom command is not available. By default this value is not enabled, so to enable "Custom Command" it must be set to a nonempty value. [0-9] represents the `CustomCommand` suffix and can be an integer between 0 and 9.

CustomCommandIsPersistent[0-9]

      CustomCommandIsPersistent[0-9]=

  Specifies if `n-th` "Custom Command" will appear outside the login manager, for example on the desktop through the Log Out/Shut Down dialogs. If not specified the default value is "false". This option is only valid if corresponding `CustomCommand` is defined. [0-9] represents `CustomCommand` suffix and can be an integer between 0 and 9.

CustomCommandLabel[0-9]

      CustomCommandLabel[0-9]=

  Specifies the stock label that will be displayed on the `n-th` "Custom Command" buttons and menu items. If not specified the default value is "Custom_[0-9]". This option is only valid if corresponding `CustomCommand` is defined. [0-9] represents `CustomCommand` suffix and can be an integer between 0 and 9. This option can't contain any semicolon characters (i.e. ";").

CustomCommandLRLabel[0-9]

      CustomCommandLRLabel[0-9]=

  Specifies the stock label that will be displayed on the `n-th` "Custom Command" list items and radio buttons. If not specified the default value is "Execute custom command _[0-9]". This option is only valid if corresponding `CustomCommand` is defined. [0-9] represents `CustomCommand` suffix and can be an integer between 0 and 9.

CustomCommandNoRestart[0-9]

      CustomCommandNoRestart[0-9]=

  Specifies if gdm will be stopped/restarted once `n-th` "Custom Command" has been executed. If not specified the default value is "false". This option is only valid if corresponding `CustomCommand` is defined. [0-9] represents `CustomCommand` suffix and can be an integer between 0 and 9. In addition when corresponding `CustomCommandIsPersistent` is set to true, setting CustomCommandNoRestart to false will place corresponding `CustomCommand` in the Shut Down dialog set of actions, setting it to true will place corresponding `CustomCommand` in the Log Out dialog set of actions.

CustomCommandText[0-9]

      CustomCommandText[0-9]=

  Specifies the message that will be displayed on the warning dialog box once `n-th` "Custom Command" button/menu item/radio button/list item has been activated. If not specified the default value is "Are you sure?". This option is only valid if corresponding `CustomCommand` is defined. [0-9] represents `CustomCommand` suffix and can be an integer between 0 and 9.

CustomCommandTooltip[0-9]

      CustomCommandTooltip[0-9]=

  Specifies the message that will be displayed on tooltips for `n-th` "Custom Command" entries. If not specified the default value is "Execute custom command [0-9]". This option is only valid if corresponding `CustomCommand` is defined. [0-9] represents `CustomCommand` suffix and can be an integer between 0 and 9.

#### X Server Definitions

Щоб встановити X-сервери, слід вказати GDM інформацію про встановлені X-сервери. Можна створити довільну кількість різних визначень, кожна повинна мати унікальну назву. Назва `Standard` є обов'язковою. Якщо ви не вказали цей сервер, GDM беруться типові значення сервера 'Standard' та шлях вказаний у `daemon/StandardXServer`. Якщо не визначені інші сервери, використовується `Standard`.

Servers are defined by sections named `server-` followed by the identifier of this server. This should be a simple ASCII string with no spaces. The GUI configuration program allows users to edit the servers defined in the GDM configuration files but currently does not allow adding or deleting entries. Like normal configuration options, `server-` sections in the `<etc>/gdm/custom.conf` file override values in the `<share>/gdm/defaults.conf` file. In other words, if a `server-Standard` section is defined in `<etc>/gdm/custom.conf`, then that will be used and the section in the `<share>/gdm/defaults.conf` file will be ignored.

##### [server-Standard]

name

      name=Standard server

  Назва, яка відображається користувачу.

command

      command=/шлях/до/X

  Повний шлях та назва виконуваного файлу X-сервера та інші потрібні аргументи команди.

flexible

      flexible=true

  Означає, що сервер є у списку доступних для запуску гнучкого сервера, сервера на вимогу.

handled

      handled=true

  Означає, що GDM має виводити вікно запрошення до входу на цьому сервері. Якщо значення false, тоді GDM просто запускає цей сервер та очікує завершення. Це корисно для запуску X-терміналів через GDM. Також звичайно можна додати до командного рядка сервера `-terminate`, щоб сервер завершувався після завершення кожного сеансу. У іншому випадку керування над породженим процесом ніколи не повернеться до GDM та, наприклад, не працюватиме м'який перезапуск, бо GDM вважатиме, що сеанс триває весь час активності сервера.

chooser

      chooser=false

  Означає, що GDM замість вікна входу має запустити селектор вузлів та дозволити користувачу обрати сервер на який увійти.

#### Конфігурація локального статичного X-сервера

Статичні X-сервери - це сервери, які завжди керуються GDM. Наприклад, якщо сервер будь-коли завершується, він перезапускається. Можна мати будь-яку кількість статичних серверів, хоча зазвичай кожен з них підключений до реального дисплею . Наприклад, якщо в комп'ютері є два дисплеї (скажімо дисплей ":0" та дисплей ":1"), тоді у цьому розділі можна вказати, що для кожного екрану має використовуватись окремий екран входу. Кожен ключ у розділі `[servers]` відповідає номеру дисплея, на якому запускається сервер. Наприклад, зазвичай є лише один ключ, це `0`, який відповідає дисплею `:0`.

The GUI configuration program allows users to edit the static display configuration defined in the GDM configuration files and allows the user to add or delete entries. Like normal configuration options, the `[servers]` section in the `<etc>/gdm/custom.conf` file overrides values in the `<share>/gdm/defaults.conf` file.

##### [servers]

<номер дисплею>

      0=Standard

  Control section for local displays. Each line indicates the local display number and the command that needs to be run to start the X server(s).

  The command can either be a path to an X executable, or a name of one of the server definitions. This can be followed by some arguments that should be passed to the X server when executed. The gdm daemon doesn't enforce the numbers to be in order or for them to be "packed". They keyword "inactive" can be used instead of a command to specify that the display should be not managed. This can be used in the `<etc>/gdm/custom.conf` to turn off a display that is defined in the `<share>/gdm/defaults.conf` file.

  GDM will splice "`-auth <ServAuthDir>/:n.Xauth :n`", where n is the display number. Inside the command line before all other arguments before running the X server.

  On some systems it is necessary for GDM to know on which virtual consoles to run the X server. In this case, (if running XFree86) add "vt7" to the command line, for example, to run on virtual console 7. However on Linux and FreeBSD this is normally done automatically if the `VTAllocation` key is set.

  Normally you do not need to add a `-nolisten tcp` flag as this is added automatically for local X servers when the `DisallowTCP` option is set.

priority

      priority=0

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

### Параметри специфічні для користувача

There are some per user configuration settings that control how GDM behaves. GDM is picky about the file ownership and permissions of the user files it will access, and will ignore files if they are not owned by the user or files that have group/world write permission. It will also ignore the user if the user's $HOME directory is not owned by the user or if the user's $HOME directory has group/world write permission. files must also be smaller than the `UserMaxFile` value as defined in the GDM configuration. If it seems that GDM is not properly accessing user configuration settings, the problem is most likely caused by one of these checks failing.

First there is the `~/.dmrc` file. In theory this file should be shared between GDM and KDM, so users only have to configure things once. This is a standard `.ini` style configuration file. It has one section called `[Desktop]` which has two keys: `Session` and `Language`.

The `Session` key specifies the basename of the session `.desktop` file that the user wishes to normally use (without the `.desktop` extension, in other words). The `Language` key specifies the language that the user wishes to use by default. If either of these keys is missing, the system default is used. The file would normally look as follows:

    [Desktop]
    Session=gnome
    Language=cs_CZ.UTF-8

Normally GDM will write this file when the user logs in for the first time, and rewrite it if the user chooses to change their default values on a subsequent login.

If the GDM Face Browser is turned, then the file `$HOME/.face` is accessed. This file should be a standard image that GTK+ can read, such as PNG or JPEG. It also must be smaller than the `MaxIconWidth` and `MaxIconHeight` values defined in the GDM configuration or it will be ignored. Users can run the `gdmphotosetup` program to specify a face image and it will copy the file to the `$HOME/.face` location and scale it so its longest dimension is not larger than the `MaxIconWidth` or `MaxIconHeight` values. `gdmphotosetup` takes care to not change the aspect ratio of the image.

Face images can also be placed in the global face directory, which is specified by the `GlobalFaceDir` configuration option ( normally `<share>/pixmaps/faces/`) and the filename should be the name of the user, optionally with a `.png`, `.jpg`, etc. appended.

## Керування сервером GDM

Ви можете керувати поведінкою запущеної служби GDM. Можна або давати певні команди, або спілкуватися з GDM через unix-сокет чи протокол FIFO.

### Команди

To stop GDM, you can either send the TERM signal to the main daemon or run the `gdm-stop` command which is in the `<sbin>/` directory. To restart GDM, you can either send the HUP signal to the main daemon or run the `gdm-restart` command which is also in the `<sbin>/` directory. To restart GDM but only after all the users have logged out, you can either send the USR1 signal to the main daemon or run the `gdm-safe-restart` command which is in the `<sbin>/` directory as well.

The `gdmflexiserver` command can be used to start new flexible (on demand) displays if your system supports virtual terminals. This command will normally lock the current session with a screensaver so that the user can safely walk away from the computer and let someone else log in. If more that two flexible displays have started `gdmflexiserver` will display a pop-up dialog allowing the user to select which session to continue. The user will normally have to enter a password to return to the session. On session exit the system will return to the previous virtual terminal. Run `gdmflexiserver --help` to get a listing of possible options.

### Протокол роботи з FIFO

GDM також має канал FIFO з назвою `.gdmfifo` у каталозі `ServAuthDir` (зазвичай `<var>/gdm/.gdmfifo`). Користуватись цим протоколом може лише root, і він здебільшого використовується для внутрішнього обміну GDM. Це дуже простий протокол. Ви надсилаєте команди через echo по одній команді на рядок. Він може використовуватись, щоб змусити GDM виконати перезавантаження, призупинення комп'ютера чи перезапустити усі X-сервери одразу коли буде можливість (це корисно для програми налаштовування X-сервера).

Повна та оновлена документація з команд та їх використання міститься у програмному коді GDM у файлі `daemon/gdm.h`. Шукайте визначення, що починаються з `GDM_SOP_`. Команди, яким у аргументі слід вказувати pid дочірнього процесу, - це команди які справді використовуються для внутрішнього зв'язку дочірнього процесу з головним процесом. Такі команди не слід використовувати.

### Протокол роботи з сокетом

GDM provides a unix domain socket for communication at `/tmp/.gdm_socket`. Using this you can check if GDM is running, the version of the daemon, the current displays that are running and who is logged in on them, and if GDM supports it on your operating system, also the virtual terminals of all the console logins. The `gdmflexiserver` command uses this protocol, for example, to launch flexible (on-demand) displays.

gdmflexiserver приймає наступні команди у командному рядку --command:

    ADD_DYNAMIC_DISPLAY
    ALL_SERVERS
    ATTACHED_SERVERS
    AUTH_LOCAL
    CLOSE
    FLEXI_XNEST
    FLEXI_XNEST_USER
    FLEXI_XSERVER
    FLEXI_XSERVER_USER
    GET_CONFIG
    GET_CONFIG_FILE
    GET_CUSTOM_CONFIG_FILE
    GET_SERVER_LIST
    GET_SERVER_DETAILS
    GREETERPIDS
    QUERY_LOGOUT_ACTION
    QUERY_VT
    RELEASE_DYNAMIC_DISPLAYS
    REMOVE_DYNAMIC_DISPLAY
    SERVER_BUSY
    SET_LOGOUT_ACTION
    SET_SAFE_LOGOUT_ACTION
    SET_VT
    UPDATE_CONFIG
    VERSION

Вони докладніше описані нижче, включено з аргументами, форматом відповідей, та кодами результату.

#### ADD_DYNAMIC_DISPLAY

    ADD_DYNAMIC_DISPLAY: Create a new server definition that will
                         run on the specified display leaving, it
                         in DISPLAY_CONFIG state.
    Supported since: 2.8.0.0
    Arguments: <display to run on>=<server>
      Where <server> is either a configuration named in the
      GDM configuration or a literal command name.
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         2 = Existing display
         3 = No server string
         4 = Display startup failure
         100 = Not authenticated
         200 = Dynamic Displays not allowed
         999 = Unknown error

#### ALL_SERVERS

    ALL_SERVERS: List all displays, including console, remote, xnest.
                 This can, for example, be useful to figure out if
                 the display you are on is managed by the gdm daemon,
                 by seeing if it is in the list.  It is also somewhat
                 like the 'w' command but for graphical sessions.
    Supported since: 2.4.2.96
    Arguments: None
    Answers:
      OK <server>;<server>;...

      <server> is <display>,<logged in user>

      <logged in user> can be empty in case no one logged in yet

      ERROR <err number> <english error description>
         0 = Not implemented
         200 = Too many messages
         999 = Unknown error

#### ATTACHED_SERVERS

    ATTACHED_SERVERS: List all attached displays.  Doesn't list XDMCP
                      and xnest non-attached displays.
    Note:             This command used to be named CONSOLE_SERVERS,
                      which is still recognized for backwards
                      compatibility. The optional pattern argument
                      is supported as of version 2.8.0.0.
    Supported since: 2.2.4.0
    Arguments: <pattern> (optional)
      With no argument, all attached displays are returned. The optional
      <pattern> is a string that may contain glob characters '*', '?', and
      '[]'. Only displays that match the pattern will be returned.
    Answers:
      OK <server>;<server>;...

      <server> is <display>,<logged in user>,<vt or xnest display>

      <logged in user> can be empty in case no one logged
      in yet, and <vt> can be -1 if it's not known or not
      supported (on non-Linux for example).  If the display is an
      xnest display and is a console one (that is, it is an xnest
      inside another console display) it is listed and instead of
      vt, it lists the parent display in standard form.

      ERROR <err number> <english error description>
         0 = Not implemented
         200 = Too many messages
         999 = Unknown error

#### AUTH_LOCAL

    AUTH_LOCAL: Автентифікація з'єднання для FLEXI_SERVER
                оскільки усі повноцінні (не-Xnest)
                сервери можуть запускати лише користувачі які увійшли
                локально, тому тут GDM допускає лише користувачів, які
                увійшли з GDM.  Вони мають пройти xauth
                MIT-MAGIC-COOKIE-1, які вони отримали перед автентифікацією
                з'єднання.Примітка:   Команда AUTH LOCAL має обов'язковий параметр
                --authenticate, хоча він поки-що використовується
                лише для FLEXI XSERVER.
    Примітка:   З версії 2.6.0.6 також можна використовувати глобальний
                <ServAuthDir>/.cookie, що працює для усіх типів
                автентифікації за винятком SET_LOGOUT_ACTION та
                QUERY_LOGOUT_ACTION і SET_SAFE_LOGOUT_ACTION
                коли вимагається вхід на дисплей.
    Підтримується з: 2.2.4.0
    Аргументи:  <xauth cookie>
      <xauth cookie> у шістнадцятковому форматі без префікса 0x
    Відповідь:
      OK
      ERROR <номер помилки> <опис помилки англійською>
         0 = Не реалізовано
         100 = Немає автентифікації
         200 = Надто багато повідомлень
         999 = Невідома помилка

#### CLOSE

    CLOSE: Close sockets connection
    Supported since: 2.2.4.0
    Arguments: None
    Answers: None

#### FLEXI_XNEST

    FLEXI_XNEXT: Start a new flexible Xnest display.
    Note:        Supported on older version from 2.2.4.0, later
                 2.2.4.2, but since 2.3.90.4 you must supply 4
                 arguments or ERROR 100 will be returned.  This
                 will start Xnest using the XAUTHORITY file
                 supplied and as the uid same as the owner of
                 that file (and same as you supply).  You must
                 also supply the cookie as the third argument
                 for this display, to prove that you indeed are
                 this user.  Also this file must be readable
                 ONLY by this user, that is have a mode of 0600.
                 If this all is not met, ERROR 100 is returned.
    Note:        The cookie should be the MIT-MAGIC-COOKIE-1,
                 the first one GDM can find in the XAUTHORITY
                 file for this display.  If that's not what you
                 use you should generate one first.  The cookie
                 should be in hex form.
    Supported since: 2.3.90.4
    Arguments: <display to run on> <uid of requesting user>
               <xauth cookie for the display> <xauth file>
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = No more flexi servers
         2 = Startup errors
         3 = X failed
         4 = X too busy
         5 = Xnest can't connect
         6 = No server binary
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### FLEXI_XNEST_USER

    FLEXI_XNEST_USER: Start a new flexible Xnest display and
                      initialize the greeter with the given username.
    Note:             This is a variant of the FLEXI_XNEST command.
    Note:             The cookie should be the MIT-MAGIC-COOKIE-1,
                      the first one GDM can find in the XAUTHORITY
                      file for this display.  If that's not what you
                      use you should generate one first.  The cookie
                      should be in hex form.
    Supported since:  2.17.7
    Arguments: <username> <display to run on> <uid of requesting user>
               <xauth cookie for the display> <xauth file>
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = No more flexi servers
         2 = Startup errors
         3 = X failed
         4 = X too busy
         5 = Xnest can't connect
         6 = No server binary
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### FLEXI_XSERVER

    FLEXI_XSERVER: Start a new X flexible display.  Only supported on
                   connection that passed AUTH_LOCAL
    Supported since: 2.2.4.0
    Arguments: <xserver type>
      If no arguments, starts the standard X server
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = No more flexi servers
         2 = Startup errors
         3 = X failed
         4 = X too busy
         6 = No server binary
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### FLEXI_XSERVER_USER

    FLEXI_XSERVER_USER: Start a new X flexible display and initialize the
                        greeter with the given username.  Only supported on
                        connection that passed AUTH_LOCAL
    Supported since:    2.17.7
    Arguments: <username> <xserver type>
      If no server type specified, starts the standard X server
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = No more flexi servers
         2 = Startup errors
         3 = X failed
         4 = X too busy
         6 = No server binary
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### GET_CONFIG

    GET_CONFIG:  Get configuration value for key.  Useful so
                 that other applications can request configuration
                 information from GDM.  Any key defined as GDM_KEY_*
                 in gdm.h is supported.  Starting with version 2.13.0.2
                 translated keys (such as "greeter/GdmWelcome[cs]" are
                 supported via GET_CONFIG.  Also starting with version
                 2.13.0.2 it is no longer necessary to include the
                 default value (i.e. you can use key "greeter/IncludeAll"
                 instead of having to use "greeter/IncludeAll=false".
    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

#### GET_CONFIG_FILE

    GET_CONFIG_FILE:  Get config file location being used by
                      the daemon.  If the GDM daemon was started
                      with the --config option, it will return
                      the value passed in via the argument.
    Supported since: 2.8.0.2
    Arguments: None
    Answers:
      OK <full path to GDM configuration file>
      ERROR <err number> <english error description>
         0 = Not implemented
         200 = Too many messages
         999 = Unknown error

#### GET_CUSTOM_CONFIG_FILE

    GET_CUSTOM_CONFIG_FILE:  Get custom config file location being
                            used by the daemon.
    Supported since: 2.14.0.0
    Arguments: None
    Answers:
      OK <full path to GDM custom configuration file>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = File not found
         200 = Too many messages
         999 = Unknown error

#### GET_SERVER_DETAILS

    GET_SERVER_DETAILS:  Отримати від сервера інформацію про вказаний сервер.
    Підтримується з: 2.13.0.4
    Аргументи: <server> <key>
      Значення ключів:
        NAME      - повернути назву сервера
        COMMAND   - повернути команду сервера
        FLEXIBLE  - Повернути "true" якщо сервер гнучкий,"
                     інакше "false\n    CHOOSABLE - Повернути "true" якщо choosable,
                    інакше  "false"
        HANDLED   - Повернути "true" якщо handled,
                    інакше "false"
        CHOOSER   - Повернути "true" якщо chooser,
                    інакше  "false"
        PRIORITY  - Повернути пріоритет процесу
    Відповідь:
      OK <значення>
      ERROR <код помилки> <опис помилки англійською>
         0 = Не реалізовано
         1 = Сервер не існує
         2 = Ключ недійсний
         50 = Непідтримуваний ключ
         200 = Надто багато повідомлень
         999 = Невідома помилка

#### GET_SERVER_LIST

    GET_SERVER_LIST:  Get a list of the server sections from
                      the configuration file.
    Supported since: 2.13.0.4
    Arguments: None
    Answers:
      OK <value>;<value>;...
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = No servers found
         200 = Too many messages
         999 = Unknown error

#### GREETERPIDS

    GREETERPIDS: List all greeter pids so that one can send HUP
                 to them for config rereading.  Of course one
                 must be root to do that.
    Supported since: 2.3.90.2
    Arguments: None
    Answers:
      OK <pid>;<pid>;...
      ERROR <err number> <english error description>
         0 = Not implemented
         200 = Too many messages
         999 = Unknown error

#### QUERY_LOGOUT_ACTION

    QUERY_LOGOUT_ACTION: Query which logout actions are possible
                         Only supported on connections that passed
                         AUTH_LOCAL.
    Supported since: 2.5.90.0
    Answers:
      OK <action>;<action>;...
         Where action is one of HALT, REBOOT, SUSPEND or CUSTOM_CMD[0-9].
         An empty list can also be returned if no action is possible.
         A '!' is appended to an action if it was already set with
         SET_LOGOUT_ACTION or SET_SAFE_LOGOUT_ACTION.  Note that
         SET_LOGOUT_ACTION has precedence over
         SET_SAFE_LOGOUT_ACTION.
      ERROR <err number> <english error description>
         0 = Not implemented
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### QUERY_CUSTOM_CMD_LABELS

     QUERY_CUSTOM_CMD_LABELS: Query labels belonging to exported custom
                              commands Only supported on connections that
                              passed AUTH_LOCAL.
     Supported since: 2.5.90.0
     Answers:
       OK <label1>;<label2>;...
          Where labelX is one of the labels belonging to CUSTOM_CMDX
          (where X in [0,GDM_CUSTOM_COMMAND_MAX)).  An empty list can
          also be returned if none of the custom commands are exported
          outside login manager (no CustomCommandIsPersistent options
          are set to true).
       ERROR <err number> <english error description>
          0 = Not implemented
          100 = Not authenticated
          200 = Too many messages
          999 = Unknown error

#### QUERY_CUSTOM_CMD_NO_RESTART_STATUS

    QUERY_CUSTOM_CMD_NO_RESTART_STATUS: Query NoRestart config options
                                        for each of custom commands Only
                                        supported on connections that
                                        passed AUTH_LOCAL.
    Supported since: 2.5.90.0
    Answers:
      OK <status>
         Where each bit of the status represents NoRestart value for
         each of the custom commands.
         bit on (1):  NoRestart = true,
         bit off (0): NoRestart = false.
      ERROR <err number> <english error description>
         0 = Not implemented
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### QUERY_VT

    QUERY_VT:  Ask the daemon about which VT we are currently on.
               This is useful for logins which don't own
               /dev/console but are still console logins.  Only
               supported on Linux currently, other places will
               just get ERROR 8.  This is also the way to query
               if VT support is available in the daemon in the
               first place.  Only supported on connections that
               passed AUTH_LOCAL.
    Supported since: 2.5.90.0
    Arguments: None
    Answers:
      OK <vt number>
      ERROR <err number> <english error description>
         0 = Not implemented
         8 = Virtual terminals not supported
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### RELEASE_DYNAMIC_DISPLAYS

    RELEASE_DYNAMIC_DISPLAYS: Release dynamic displays currently in
                              DISPLAY_CONFIG state
    Supported since: 2.8.0.0
    Arguments: <display to release>
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = Bad display number
         100 = Not authenticated
         200 = Dynamic Displays not allowed
         999 = Unknown error

#### REMOVE_DYNAMIC_DISPLAY

    REMOVE_DYNAMIC_DISPLAY: Remove a dynamic display, killing the server
                            and purging the display configuration
    Supported since: 2.8.0.0
    Arguments: <display to remove>
    Answers:
      OK <display>
      ERROR <err number> <english error description>
         0 = Not implemented
         1 = Bad display number
         100 = Not authenticated
         200 = Dynamic Displays not allowed
         999 = Unknown error

#### SERVER_BUSY

    SERVER_BUSY:  Returns true if half or more of the daemon's sockets
                  are busy, false otherwise.  Used by slave programs
                  which want to ensure they do not overwhelm the
                  sever.
    Supported since: 2.13.0.8
    Arguments: None
    Answers:
      OK <value>
      ERROR <err number> <english error description>
         0 = Not implemented
         200 = Too many messages
         999 = Unknown error

#### SET_LOGOUT_ACTION

    SET_LOGOUT_ACTION: Tell the daemon to halt/restart/suspend after
                       slave process exits.  Only supported on
                       connections that passed AUTH_LOCAL.
    Supported since: 2.5.90.0
    Arguments: <action>
      NONE               Set exit action to 'none'
      HALT               Set exit action to 'halt'
      REBOOT             Set exit action to 'reboot'
      SUSPEND            Set exit action to 'suspend'
      CUSTOM_CMD[0-9]    Set exit action to 'custom command [0-9]'
    Answers:
      OK
      ERROR <err number> <english error description>
         0 = Not implemented
         7 = Unknown logout action, or not available
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### SET_SAFE_LOGOUT_ACTION

    SET_SAFE_LOGOUT_ACTION:  Tell the daemon to halt/restart/suspend
                             after everybody logs out.  If only one
                             person logs out, then this is obviously
                             the same as the SET_LOGOUT_ACTION.  Note
                             that SET_LOGOUT_ACTION has precedence
                             over SET_SAFE_LOGOUT_ACTION if it is set
                             to something other then NONE.  If no one
                             is logged in, then the action takes effect
                             effect immediately.  Only supported on
                             connections that passed AUTH_LOCAL.
    Supported since: 2.5.90.0
    Arguments: <action>
      NONE               Set exit action to 'none'
      HALT               Set exit action to 'halt'
      REBOOT             Set exit action to 'reboot'
      SUSPEND            Set exit action to 'suspend'
      CUSTOM_CMD[0-9]    Set exit action to 'custom command [0-9]'
    Answers:
      OK
      ERROR <err number> <english error description>
         0 = Not implemented
         7 = Unknown logout action, or not available
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### SET_VT

    SET_VT:  Change to the specified virtual terminal.
             This is useful for logins which don't own /dev/console
             but are still console logins.  Only supported on Linux
             currently, other places will just get ERROR 8.
             Only supported on connections that passed AUTH_LOCAL.
    Supported since: 2.5.90.0
    Arguments: <vt>
    Answers:
      OK
      ERROR <err number> <english error description>
         0 = Not implemented
         8 = Virtual terminals not supported
         9 = Invalid virtual terminal number
         100 = Not authenticated
         200 = Too many messages
         999 = Unknown error

#### UPDATE_CONFIG

    UPDATE_CONFIG: Tell the daemon to re-read a key from the
                   GDM configuration file.   Any user can request
                   that values are re-read but the daemon will
                   only do so if the file has been modified
                   since GDM first read the file.  Only users
                   who can change the GDM configuration file
                   (normally writable only by the root user) can
                   actually modify the GDM configuration.  This
                   command is useful to cause the GDM to update
                   itself to recognize a change made to the GDM
                   configuration file by the root user.

                   Starting with version 2.13.0.0, all GDM keys are
                   supported except for the following:

                          daemon/PidFile
                          daemon/ConsoleNotify
                          daemon/User
                          daemon/Group
                          daemon/LogDir
                          daemon/ServAuthDir
                          daemon/UserAuthDir
                          daemon/UserAuthFile
                          daemon/UserAuthFBDir

                   GDM also supports the following Psuedokeys:

                   xdmcp/PARAMETERS (2.3.90.2) updates the following:
                          xdmcp/MaxPending
                          xdmcp/MaxSessions
                          xdmcp/MaxWait
                          xdmcp/DisplaysPerHost
                          xdmcp/HonorIndirect
                          xdmcp/MaxPendingIndirect
                          xdmcp/MaxWaitIndirect
                          xdmcp/PingIntervalSeconds (only affects new connections)

                    xservers/PARAMETERS (2.13.0.4) updates the following:
                          all [server-foo] sections.

                    Supported keys for previous versions of GDM:

                          security/AllowRoot (2.3.90.2)
                          security/AllowRemoteRoot (2.3.90.2)
                          security/AllowRemoteAutoLogin (2.3.90.2)
                          security/RetryDelay (2.3.90.2)
                          security/DisallowTCP (2.4.2.0)
                          daemon/Greeter (2.3.90.2)
                          daemon/RemoteGreeter (2.3.90.2)
                          xdmcp/Enable (2.3.90.2)
                          xdmcp/Port (2.3.90.2)
                          daemon/TimedLogin (2.3.90.3)
                          daemon/TimedLoginEnable (2.3.90.3)
                          daemon/TimedLoginDelay (2.3.90.3)
                          greeter/SystemMenu (2.3.90.3)
                          greeter/ConfigAvailable (2.3.90.3)
                          greeter/ChooserButton (2.4.2.0)
                          greeter/SoundOnLoginFile (2.5.90.0)
                          daemon/AddGtkModules (2.5.90.0)
                          daemon/GtkModulesList (2.5.90.0)
    Supported since: 2.3.90.2
    Arguments: <key>
      <key> is just the base part of the key such as
      "security/AllowRemoteRoot"
    Answers:
      OK
      ERROR <err number> <english error description>
         0 = Not implemented
         50 = Unsupported key
         200 = Too many messages
         999 = Unknown error

#### VERSION

    VERSION: Query GDM version
    Supported since: 2.2.4.0
    Arguments: None
    Answers:
      GDM <gdm version>
      ERROR <err number> <english error description>
         200 = Too many messages
         999 = Unknown error

## Команди GDM

### Команди користувача GDM

The GDM package provides the following different commands in `bindir` intended to be used by the end-user:

#### `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 computer. 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 command also supports standard GNOME options.

##### `gdmXnestchooser` Command Line Options

-x, --xnest=РЯДОК

  Командна Xnest, типово "Xnest"

-o, --xnest-extra-options=ПАРАМЕТРИ

  Додаткові параметри для Xnest, типово параметрів немає.

-n, --no-query

  Просто запустити Xnest, без запиту (без програми привітання)

-d, --direct

  Виконати прямий запит, замість непрямого (селектор)

-B, --broadcast

  Запустити у широкомовному режимі, замість непрямого запиту (селектор)

-b, --background

  Запустити у фоновому режимі

--no-gdm-check

  Не перевіряти, чи запущений GDM

#### `gdmflexichooser` Command Line Options

The `gdmflexiserver` command provides three features. It can be used to run flexible (on demand) X displays, to run a flexible display via Xnest, and to send commands to the GDM daemon process.

Starting a flexible X display will normally lock the current session with a screensaver and will redisplay the GDM login screen so a second user can log in. This feature is only available on systems that support virtual terminals and have them enabled. This feature is 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. If there is more than one running display defined with flexible=true, then the user is shown a dialog that displays the currently running sessions. The user can then pick which session to continue and will normally have to enter the password to unlock the screen.

Flexible displays started via Xnest works on systems that do not support virtual terminals. This option starts a flexible display in a window in the current session. This does not lock the current session, so is not as secure as a flexible server started via virtual terminals.

The `gdmflexiserver --command` option provides a way to send commands to the GDM daemon and can be used to debug problems or to change the GDM configuration.

In addition to the following options, `gdmflexiserver` also supports standard GNOME options.

##### `gdmflexichooser` Command Line Options

-c, --command=COMMAND

  Відіслати вказану протокольну команду до серверу GDM

-n, --xnest

  Start a flexible X display in Xnest mode

-l, --no-lock

  Не блокувати поточний екран

-d, --debug

  Turns on debugging output which gets sent to syslog. Same as turning on debug in the configuration file.

-a, --authenticate

  Автентифікація перед запуском --command

-s, --startnew

  Запустити гнучкий дисплей без відображення діалогу, що запитує у користувача продовження поточного сеансу.

#### `gdmdynamic` Command Line Options

The `gdmdynamic` command which creates, runs, and removes displays (X servers) on demand.

`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 configuration 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` command 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 sockets connection is busy, it will sleep and retry a certain number of times that can be tuned with the -s and -t options.

##### `gdmdynamic` Command Line Options

  Можна використовувати один з наступних параметрів на екземпляр:

-a display=сервер

  Add a new display configuration, leaving it in the DISPLAY_CONFIG state. For example, `"-a 2=StandardServerTwo"` `"-a 3=/usr/X11R6/bin/X -dev /dev/fb2"`

  The display will not actually be started until the display is released by calling `gdmdynamic` again with the -r option.

-r

  Звільнити (запустити) усі дисплеї, що очікують стан DISPLAY_CONFIG.

-d display

  Видалити дисплей, знищити X-сервер та стерти конфігурацію дисплея. Наприклад, "-d 3".

-l [шаблон]

  List displays via the ATTACHED_SERVERS `gdmflexiserver` command. Without a pattern lists all attached displays. With a pattern will match using glob characters '*', '?', and '[]'. For example: `"-l Standard*"` `"-l *Xorg*"`

  До вказаного вище може додаватись цей параметр:

-v

  Докладний режим. Виводяться діагностичні повідомлення про кожну команду. надіслану до GDM.

-b

  Фоновий режим. Створити дочірній процес негайно повернутись.

-t СПРОБ

  Якщо сокет служби зайнятий, `gdmdynamic` буде намагатись відкрити з'єднання з вказану у СПРОБ кількість раз. Типове значення 15.

-s ПАУЗА

  Якщо сокет служби зайнятий, `gdmdynamic` буде призупинятися на час очікування між спробами. До вказаного числа ПАУЗА випадково додається 0-5 секунд, щоб кілька екземплярів gdmdynamic не намагались перезапуститись одночасно. Якщо значення ПАУЗА дорівнює нулю, період призупинення встановлюється 1 секунда. Типове значення 8 секунд.

#### `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 command 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 Root User Commands

The GDM package provides the following different commands in `sbindir` intended to be used by the root user:

#### `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 script.

##### `gdm` and `gdm-binary` Command Line Options

--help

  Виводить коротку довідку з переліком параметрів командного рядка.

--nodaemon

  If this option is specified, then GDM does not fork into the background when run. You can also use a single-dash version, "-nodaemon" for compatibility with other display managers.

--no-console

  Вказує службі не запускати нічого у консолі. Це означає, що не буде запускатись жоден з локальних серверів, вказаних в розділі `[servers]`, та консоль не буде використовуватись для виводу помилок. Цей параметр автоматично вмикається, якщо розділ `[servers]` порожній.

--config=CONFIGFILE

  Визначає альтернативний конфігураційний файл.

--preserve-ld-vars

  При внутрішньому очищенні оточення, зберігаються усі змінні, що починаються з LD_. Це задля спрощення налагодження.

--version

  Вивести версію сервера GDM.

--wait-for-go

  Якщо вказано цей параметр, gdm виконає ініціалізацію, але запустить лише перший локальний дисплей та буде чекати повідомлення GO через протокол fifo. Програма привітання не виводиться, доки не буде отримано повідомлення GO. Також до надходження цього повідомлення заборонені запити гнучких серверів та не запускається XDMCP. Ця функція використовується у сценаріях для раннього запуску X, але коли поки-що небажано надавати можливість входу у сеанс. Коли сценарій готовий розпочати сеанс, він надсилає GO та GDM продовжує роботу. Цю функцію додано у версії 2.5.90.0.

#### `gdmsetup` Command Line Options

`gdmsetup` runs a graphical application for modifying the GDM configuration file. 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 application may only be run as root. This application supports standard GNOME options.

#### `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-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-stop` Command Line Options

`gdm-stop` stops GDM by sending the GDM daemon a TERM signal.

### Внутрішні команди GDM

The GDM package provides the following different commands in `libexecdir` intended to be used by the gdm daemon process.

#### `gdmchooser` and `gdmlogin` Command Line Options

The `gdmgreeter` and `gdmlogin` are two different login applications, either can be used by GDM. `gdmgreeter` is themeable with GDM themes while `gdmlogin` is themable with GTK+ themes. These applications are normally executed by the GDM daemon. Both commands 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 command supports standard GNOME options and is found in support standard GNOME options.

##### `gdmchooser` Command Line Options

--xdmaddress=SOCKET

  Сокет для зв'язку з XDM.

--clientaddress=АДРЕСА

  Адреса клієнта для повернення на запит XDM. Цей параметр використовується для запуску gdmchooser з XDM, та не використовується з GDM.

--connectionType=TYPE

  Тип з'єднання для повернення на запит XDM. Цей параметр використовується для запуску gdmchooser з XDM, та не використовується з GDM.

#### `gdm-ssh-session`

`gdm-ssh-session` зазвичай запускається службою GDM коли встановлюється віддалене безпечне з'єднання через ssh. Програма не приймає ніяких параметрів.

## Програма привітання з темами

У цьому розділі описується створення тем для програми привітання з підтримкою тем. Приклади, включно з знімками екранів, дивіться у стандартних встановлених темах та темах з веб-сайту тем.

### Огляд тем

Тема GDM складається з XML файлу який відповідає специфікації у gui/greeter/greeter.dtd. Файли теми зберігаються у каталозі `<share>/gdm/themes/<theme_name>`. Зазвичай каталог знаходиться у `/usr/share`. Каталог теми має містити файл з назвою `GdmGreeterTheme.desktop` з форматом подібним до інших файлів типу .desktop та має виглядати таким чином:

    [GdmGreeterTheme]
    Encoding=UTF-8
    Greeter=circles.xml
    Name=Circles
    Description=Theme with blue circles
    Author=Bond, James Bond
    Copyright=(c) 2002 Bond, James Bond
    Screenshot=screenshot.png

Назва, опис, автор та авторські права можна перекладати як і у інших файлах типу `.desktop`. Усі файли вказані файли мають у каталозі з темами. Файл, на який вказує поле Screenshot повинен бутизнімком екрану теми з розмірами 200x150 (він може бути відсутній, але якщо він є - це краще для користувача). У полі Greeter вказується файл XML, який містить опис теми. Опис буде згаданий далі.

Once you have theme ready and installed you can test it with the installed `gdmthemetester` script. This script assumes that the X server supports Xnest. This command takes two arguments, first the environment that should be used. This is one of console, console-timed, flexi, remote-flexi, xdmcp. Where console is a standard console login, console-timed is a console login with a timed login going on, flexi is for any local flexible display, remote-flexi is for flexi displays that are not local (such as an Xnest flexiserver run from a remote display) and xdmcp is for remote XDMCP connections. The second argument is the theme name. So for example to test how things look in the XDMCP mode with the circles theme you would run:

    gdmthemetester xdmcp circles

Перевірте тему в усіх варіантах оточення, та перевірте вигляд попередження про натискання caps lock. Також було б добре зробити знімок екрану, просто зробіть знімок екрану вікна Xnest. це можна зробити у GNOME, якщо передати фоку вводу вікну Xnest та натиснути Alt-PrintScreen.

Once you have all this done, then make a tarball that contains the directory name (so that you could just untar it in the `<share>/gdm/themes` directory). And this is the tarball you distribute and people can install from the graphical configuration application. You can do this with the commands:

    cd <share>/gdm/themes
    tar czvf <theme_name>.tar.gz <theme_name>/

### Докладний опис XML формату тем

#### greeter tag

The GDM theme format is specified in XML format contained within a <greeter> tag. You may specify a GTK+ theme to be used with this theme by using the gtk-theme element in the greeter tag as in the following example.

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE greeter SYSTEM "greeter.dtd">
    <greeter gtk-theme="Crux">
    [...]
    </greeter>

Contained within the greeter tag can be the nodes described in the next sections of this document. Some of these nodes are containers (box nodes, rect item nodes) which can be used to organize how to display the nodes that the user sees and interacts with (such as button, pixmap and entry item nodes).

#### Box Nodes

Box nodes are container nodes for item nodes. Box nodes are specified as follows:

    <box orientation="alignment" min-width="num"
    xpadding="num" ypadding="num" spacing="num"
    homogeneous="bool">

Where "num" means number and bool means either "true" or "false" The alignment value can be either "horizontal" or "vertical". If you leave any property off it will default to zero or "false" in case of "homogeneous" and "vertical" for the orientation.

Якщо контейнер є однорідним, тоді дочірні елементи займають однаковий простір.

"min-width" вказує величину у точках. Також є відповідна властивість "min-height".

#### Вузли Fixed

Fixed is a container that has its children scattered about laid out with precise coordinates. The size of this container is the biggest rectangle that contains all the children. Fixed has no extra properties and so you just use:

    <fixed>

Then you put other items with proper position nodes inside this.

Вузол "toplevel" подібний до вузла fixed.

#### Вузли елементів

Тема GDM, що створена вказуванням ієрархії вузлів елемента та контейнера. Вузли елементів можуть мати наступні значення "type":

button

  A button field. This field uses a GTK+ button. It is also possible to make a "rect" item act like a button by setting its button element to true. However it is better to use GTK+ buttons in GDM themes since these are accessible to users with disabilities. Also, GTK+ buttons can be themed. This feature is supported in GDM 2.14.6 and later.

entry

  Поле вводу тексту.

label

  Текстова позначка. Мусить мати вузол "text" для вказування тексту.

list

  A face browser widget. Only useful if the face browser is enabled via the configuration.

pixmap

  Растрове зображення у форматі, який підтримує gdk-pixbuf. Наприклад, PNG, JPEG, Tiff, etc...)

rect

  Прямокутник.

svg

  Зображення у форматі векторної графіки.

For example:

    <item type="label">

Items can specify ID values which gives them a specific look and feel or formatting. Furthermore you can customize the login process by adding custom widgets with custom id's for some items (currently only the list item)

Елементи вузлів можуть мати такі значення ідентифікаторів:

user-pw-entry

  Поле вводу для ідентифікатора користувача та паролю. Це поле використовується для відповіді на запити PAM/GDM (Ім'я користувача, пароль, тощо..).

List items by default display as lists, but the combo="true" attribute can be used to specify combo box style (combo style supported since GDM 2.16.2). Some predefined lists may be included in a theme by using the following id values. Customized lists may also be defined, which are explained below.

session

  A list of available sessions, which allows the user to pick the session to use. Supported since GDM 2.16.2.

language

  A list of available languages, which allows the user to pick the language to use. Supported since GDM 2.16.2.

userlist

  A Face Browser list, so that users can pick their username by clicking on this instead of typing. This obviously exposes the usernames to viewers of the login screen, and is not recommended for users who feel that this reduces security. The face browser does not support combo box style.

userlist-rect

  This id can be specified for the <rect> object containing the userlist and if the userlist is empty then this rectangle will not be shown. This allows the theme to define something like an area with a different color and/or alpha to surround the userlist, but only if there are users to display. Supported since 2.16.2.

Окрім того, можна мати довільний ідентифікатор (рекомендується, щоб вони починались з 'custom', щоб не конфліктувати з наступними доповненими версіями цієї специфікації) та запитувати у користувача додаткову інформацію. Дивіться розділ 'Власні віджети'

Елементи позначок можуть мати такі ідентифікатори:

clock

  Label that displays the date and time.

pam-prompt

  Label that displays the PAM prompt. This is the prompt that PAM uses to ask for username, password, etc...

pam-error

  Label that displayst PAM/GDM error messages. Such as when user can't log in.

pam-error-logo

  An image that will be displayed only when a pam-error message is being displayed. This is useful for displaying an "Attention" icon, for example. This feature is supported in GDM 2.14.6 and later.

pam-message

  Label that displays the PAM message. These are messages that PAM/GDM gives about state of the account, help about the prompts and other information.

timed-label

  Позначка, що відображає інформацію про вхід у сеанс.

прямокутники можуть мати такі значення ідентифікаторів:

caps-lock-warning

  Відображає значок, який показує чи нажата клавіша CAPS LOCK.

If an item is of type rect, the item can be a button. Buttons must also include a "button" value as follows:

    <item type="rect" id="disconnect_button" button="true">.

Possible values for button ids are as follows.

chooser_button

  Запускає програму вибору XDMCP.

config_button

  Запускає програму налаштовування GDM.

custom_cmd_button[0-9]

  Runs the `n-th` custom command.

disconnect_button

  Відключає від віддаленого сеансу.

language_button

  Відображає діалогове вікно вибору мови.

halt_button

  Зупиняє (вимикає) систему.

reboot_button

  Перезапуск системи.

session_button

  Виводить список доступних сеансів.

suspend_button

  Призупиняє систему.

system_button

  Perform halt/restart/suspend/etc. options (if allowed by GDM configuration). Also allows user to run configurator if user enters root password (again if allowed by GDM configuration). This is usually now labeled Actions, and referred to as the Actions menu.

#### Вузол позиції

Each item can specify its position and size via the "pos" node. For example:

    <pos x="0" y="4" width="100%" height="100%"/>

Обидві позиції та розмір може бути вказаний у відсотках та елемент буде займати вказаний відсоток розміру поточного контейнера. Елементи, не укладені у контейнер, займаються вказаний відсоток екрану.

Для x та y, також можна вказати від'ємне значення розташування, що буде означати відлік від правого чи нижнього боку. Але це стосується лише абсолютних координат. Якщо вказано від'ємне значення відсотків, відлік все одно буде з того самого боку.

The position also specifies the anchor of the item, this can be "n" "ne" "e" "se" "s" "sw" "w" and "nw" or "center" which stand for the different edges/corners or "center" for center. For example:

    <pos x="10%" y="50%" anchor="w" width="80%" height="95"/>

Якщо елемент містить контейнер, можна вказати ширину та висоту "box", що означає, що вони вважаються шириною та висотою контейнера, тобто елементи у контейнері плюс відступи.

Якщо елемент містить зображення SVG, ви можете вказати ширину та висоту "scale", що означає, що масштаб зображення SVG буде змінено, щоб воно пристосувалось до запитаної області.

Можна вказати властивості "expand" значення "true" чи false. Якщо вказано true, тоді дочірній елемент буде розширено наскільки це можливо (тобто він займатиме більше простору, якщо він є).

There are two extra properties you can specify (as of 2.4.4.3) for labels (and labels only). The first is "max-width" which will specify the maximum width of the label in pixels. And the second is "max-screen-percent-width" which specifies the maximum percentage of the screen width that the label can occupy. By default no label will occupy more then 90% of the screen by width. An example may be:

    <item type="label">
    <pos x="10%" max-screen-percent-width="50%"/>

#### Вузол Show

Вузли типу Some можуть відображатись у кількох режимах, як при віддаленому режимі. Декілька значень можна вказати та вони мають розділятись комами. Можливі значення:

`console` - консольний режим.

`console-fixed` - консольний не-гнучкий режим.

`console-flexi` - консольний та гнучкий режим.

`flexi` - гнучкий режим.

`remote` - віддалений режим.

`remote-flexi` - віддалений та гнучкий режим.

For example:

    <show modes="flexi,remote"/>

Також ви можете вказати значення "type", щоб позначити, що певні елементи мають відображатись якщо type має значення true. Допустимі значення:

`chooser`, if ChooserButton is set to "true" in the GDM configuration.

`config`, if ConfigAvailable is set to "true" in the GDM configuration.

`custom_cmd[0-9]`, if `n-th` CustomCommand is specified in the GDM configuration.

`halt`, if HaltDaemon is specified in the GDM configuration.

`reboot`, if RebootCommand is specified in the GDM configuration.

`suspend`, if SuspendCommand is specified in the GDM configuration.

`system`, if SystemMenu is specified in the GDM configuration.

`timed`, if TimedLoginEnabled is set to "true" in the GDM configuration.

For example:

    <show modes="console" type="system"/>

Note that if SystemMenu is off then the halt, restart, suspend, chooser and config choices will not be shown, so this is a global toggle for them all. See some of the standard themes for how the show modes are used.

#### Вузли Normal/Active/Prelight

В залежності від типу вузла (за винятком списку користувачів - дивіться вузол Color нижче), можна вказати його колір, шрифт, або зображення у наступних тегах:

`normal` - звичайний стан.

`active` - стан, коли елемент має фокус вводу.

`prelight` - коли миша знаходиться над елементом.

When item is "rect" (alpha can be omitted and defaults to 0.0):

    <normal color="#ffffff" alpha="0.0">

When item is "label"

    <normal color="#ffffff" font="Sans 14"/>

When the item type is "pixmap" or "SVG", then the normal, active, and prelight tags specify the images to use as follows:

    <normal file="picture.png" tint="#dddddd"/>

Зауважте, що відносні назви шляхів мають бути у тому самому каталозі, що й `.xml` файл теми у `<share>/gdm/themes/<theme_name>`.

Note that alternative image file can be specified using the altfile[n] property. GDM will use the last valid image filename specified. For example:

    <normal file="picture.png" altfile1="distribution-blah-image.png" altfile2="distribution-foo-image.png"/>

If `distribution-foo-image.png` is a valid image filename it will be used. Otherwise distribution-blah-image.png will be used if valid. This feature supported since 2.16.3.

#### Значок перегляду портретів/вузли кольорів позначки

Якщо тип елемента - список користувачів, тоді колір тла для значка та позначки можуть визначатись окремо таким тегом:

    <color iconcolor="#dddddd" labelcolor="#ffffff"/>

#### Текстовий вузол

Text tags are used by labels. They can be used to display localized text as follows (if the "xml:lang" attribute is omitted, the C locale is assumed):

    <text xml:lang="fr">Option</text>

You can include pango markup in the text nodes for labels, however you must encode it. So for example to have the label of "foo<sup>bar</sup>", you must type:

    <text>"foo<sup>bar</sup>"</text>

Текстові вузли можуть містити наступні спеціальні послідовності символів:

%% - A literal % character

%c - час годинника. Лише позначки з ідентифікатором "clock" будуть оновлюватись кожну секунду. Інші позначки будуть містити статичне значення часу.

%d - назва дисплею (змінна оточення DISPLAY)

%h - назва вузла (вивід gethostname)

%m - назва машини (вивід uname.machine)

%n - Node name (uname.nodename output)

%o - назва домену (вивід getdomainname)

%r - назва випуску (вивід uname.release)

%s - назва системи (вивід uname.sysname)

%t - поточне значення затримки для входу із затримкою з конфігураційного файл (0 - якщо вимкнено), за яким йде слово "seconds", якщо значення більше ніж 1 або слово "second" якщо значення дорівнює 1. Ця символьна послідовність призначена для внутрішнього використання всередині для відображення повідомлень типу "позначка часу", що автоматично оновлюються кожної секунди.

%u - ім'я користувача для входу із затримкою з конфігураційного файлу (порожнє, якщо вимкнено) Ця символьна послідовність призначена для внутрішнього використання всередині для відображення повідомлень типу "позначка часу", що автоматично оновлюються кожної секунди.

\n - переведення каретки

_ - An underscore causes the following character to be underlined. If it precedes a % character sequence, the string that replaces the character sequence is underlined.

#### Stock

Деякі загальні локалізовані позначки можна вказувати через теги з набору. Якщо вказано тег "stock", тоді тег "text" ігнорується. Слід використовувати позначки з набору позначок, замість призначення перекладеного значення у тему. При цьому прискорюється час завантаження та краще відбувається переклад. Можливі значення:

`cancel`, _("_Cancel"

`caps-lock-warning`, _("Caps Lock key is on."

`chooser`, _("Remote Login via _XDMCP"

`config`, _("_Configure"

`custom_cmd[0-9]`, _("Custom_[0-9]"

`disconnect`, _("D_isconnect"

`halt`, _("Shut _Down"

`language`, _("_Language"

`ok`, _("_OK"

`quit`, _("_Quit"

`reboot`, _("_Restart"

`session`, _("_Session"

`startover`, _("_Start Over"

`suspend`, _("Sus_pend"

`system`, _("_Actions" (Formerly "S_ystem"

`timed-label`, _("User %u will login in %t"

`username-label`, _("Username:"

`welcome-label`, _("Welcome to %n"

For example:

    <stock type="welcome-label">

#### Власні віджети

Currently there is one item which is customizable and this is the list item. If you need to ask the user extra things, such as to pick from a list of places to log into, or set of custom login sessions you can setup the list item and add listitem children that describe the choices. Each listitem must have an id and a text child. The choice will be recorded in the file `<ServAuthDir>/<display>.GreeterInfo` as `<list id>=<listitem id>`.

For example suppose we are on display :0, `ServAuthDir` is `<var>/lib/gdm` and we have the following in the theme:

    <item type="list" id="custom-config">
    <pos anchor="nw" x="1" y="1" height="200" width="100">
    <listitem id="foo">
    <text>Foo</text>
    </listitem>
    <listitem id="bar">
    <text>Bar</text>
    </listitem>
    </item>

Then if the user chooses 'Foo' then `<var>/lib/gdm/:0.GreeterInfo` will contain:

    custom-config=foo

## Спеціальні можливості

GDM supports "Accessible Login" to allow users to log in to their desktop session even if they cannot easily use the screen, mouse, or keyboard in the usual way. Only the "Standard Greeter" supports accessibility, so use this login GUI for accessibility support. This is done by specifying the "Standard Greeter" in the "Local" tab for the console display and specifying the "Standard Greeter" in the "Remote" tab for remote displays. Or you can modify the `Greeter` configuration option by hand to be `gdmlogin`.

The Standard Greeter supports the ability to launch assistive technologies at login time via configurable "gestures" from the standard keyboard, pointing device, or switch device attached to the USB or PS/2 mouse port. Also the user can change the visual appearance of the login UI before logging in, for instance to use a higher-contrast color scheme for better visibility.

### Налаштовування спеціальних можливостей

In order to enable Accessible Login, the system administrator must make some changes to the default login configuration by manually modifying three human-readable configuration files, stored in the GDM configuration, AccessKeyMouseEvents and AccessDwellMouseEvents.

In order to allow users to change the color and contrast scheme of the login dialog, make sure the `AllowThemeChange` parameter in the GDM configuration is set to "true".

To restrict user changes to the visual appearance to a subset of available themes, the `GtkThemesToAllow` parameter in the GDM configuration can be set to a list of acceptable themes separated by commas. For example:

    GtkThemesToAllow=HighContrast,HighContrastInverse

To enable the use of assistive technologies such as the Onscreen Keyboard, Screen Reader, or Magnifier, the `AddGtkModules` parameter in the GDM configuration must be uncommented and set to "true". Also the `GtkModulesList` parameter must be uncommented and set as follows:

    GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener

The use of assistive technologies and the atk-bridge module requires the registry daemon, `at-spi-registryd`, to be running. This is handled by the GDM GUI starting with version 2.17.

System administrators may wish to load only the minimum subset of these modules which is required to support their user base. Depending on the end-user needs, not all of the above GtkModules may need to be loaded. If your end-users need the integrated Screen Reader and Magnifier, you must include "gail" and "atk-bridge". If your end-users will be using a pointing device without buttons or switches, include "dwellmouselistener". If some of your users will use pointing devices with switches, alternative physical keyboards, or switch/button devices, include "keymouselistener". Including all four is suitable for most system configurations. The Onscreen Keyboard can operate without gail and atk-bridge, but with a reduced feature set; for optimum accessibility we recommend including both gail and atk-bridge.

Once "keymouselistener" and/or "dwellmouselistener" have been added to the GtkModules loaded by GDM, you can assign end-user actions with the launching of specific assistive technologies. These gesture associations are contained in files AccessKeyMouseEvents and AccessDwellMouseEvents, respectively. Both files are located in the <etc>/gdm/modules directory. The gesture format is described in the two configuration files.

The AccessKeyMouseEvents file controls the keymouselistener Gesture Listener and is used to define key-press, mouse button, or XInput device sequences that can be used to launch applications needed for accessibility. In order to reduce the likelihood of unintentional launch, these "gestures" may be associated with multiple switch presses and/or minimum durations. Note that the XKB extension is needed for key gestures to work, so you may need to add +xkb to your Xserver command line for gestures to work properly.

The DwellKeyMouseEvents file controls the dwellmouselistner and supports gestures that involve only motion of a pointing device such as the system mouse of an alternative pointing device such as a head pointer or trackball may also be defined. All gestures are specified by the same syntax; that is, there is no distinction between a "core mouse" gesture and motion from an alternate input device.

Motion gestures are defined as "crossing events" into and out of the login dialog window. If the "dwellmouselistener" GtkModule is loaded, alternative pointing devices are temporarily "latched" to the core pointer, such that motion from alternative devices results in movement of the onscreen pointer.

Для використання служби промови тексту під час входу (наприклад, при використанні програми читання екрану в режимі speech) на деяких операційних системах, GDM user must be made a member of the "audio" group

Currently GDM does not remember what accessible technology programs have been started when switching applications. So if the user switches between the login program and the chooser, for example, then it is necessary for the user to redo the gesture. Users may need to also set up their default session so that the assistive technologies required are started automatically (or have appropriate key-bindings defined to start them) after the user session has started.

There are some issues that cause users to have problems getting the gesture listeners to work. It is recommended that people use GDM version 2.8.0.5 or later for best results. Some X servers have a bug which causes detectable autorepeat to fail when XEVIE is enabled (which happens when atk-bridge is included as a GTK Module). This bug causes key gestures with a duration greater than 0 to always fail. A workaround is to simply redefine all key gestures so they have zero length duration. Some versions of GOK and gnopernicus will not launch unless the "gdm" user has a writable home directory. If you see an hourglass cursor when you complete a gesture but the program does not start, then you are likely having this problem. It should be considered a bug for AT programs to require having a writable home directory, so please file a bug with the AT program if you encounter this problem. Also note that some input devices require X server configuration before GDM will recognize them.

### Налаштовування звуку спеціальних пожливостей

By default, GDM requires a media application such as "sox" to be present to play sounds for successful or failed login. GDM defaults the location of this application to `<bin>/play` (or `<bin>/audioplay` on Solaris. This can be changed via the SoundProgram GDM configuration option. Typically most text-to-speech programs (such as ORCA or Gnopernicus) use a separate mechanism to play audio.

## Спеціальні функції Solaris

### Налаштовування Solaris

On Solaris, the following configuration is recommended. This turns on IPv6 and also turns on PreFetch for performance benefit.

    ./autogen.sh --prefix=/usr --sysconfdir=/etc/X11 --localstatedir=/var
       --libexecdir=/usr/lib --enable-ipv6=yes --with-at-bindir=/usr/sfw/bin
       --with-prefetch --with-post-path=/usr/openwin/bin

Configuring GDM with the "--with-post-path=/usr/openwin/bin" on Solaris is recommended for access to programs like Xnest.

### Solaris /etc/logindevperm

GDM supports /etc/logindevperm, but only on Solaris 10 and higher. Refer to the logindevperm.4 man page for more information.

To make /etc/logindevperm functionality work on Solaris 9 or earlier you would have to hack the GDM PreSession and PostSession script to chmod the device permissions directly. In other words, if /etc/logindevperm had a listing like this:

    /dev/console    0600    /dev/sound/*            # звукові пристрої

The PreSession script would need to be modified to chown /dev/console to the user:group who is logging into the console and ensure whatever permissions is specified in /etc/logindevperm (0600 for the line above). Then in the PostSession script chmod the device back to root:root and ensure 0600 this time (do not use the value in the /etc/logindevperm file). Linux uses a different mechanism for managing device permissions, so this extra scripting is not needed.

### Автоматичний вхід на Solaris

Automatic login does not work on Solaris because PAM is not configured to support this feature by default. Automatic login is a GDM feature that is not enabled by default, so you would only notice this problem if you try to make use of it. Turning this feature on causes your computer to login to a specified username on startup without asking for username and password. This is an insecure way to set up your computer.

If using Solaris 10 or lower, then you need to compile the pam_allow.c code provided with the GDM release and install it to /usr/lib/security (or provide the full path in /etc/pam.conf) and ensure it is owned by uid 0 and not group or world writable.

The following are reasonable pam.conf values for turning on automatic login in GDM. Make sure to read the PAM documentation (e.g. pam.d/pam.conf man page) and be comfortable with the security implications of any changes you intend to make to your configuration.

           gdm-autologin auth  required    pam_unix_cred.so.1
           gdm-autologin auth  sufficient  pam_allow.so.1
           gdm-autologin account  sufficient  pam_allow.so.1
           gdm-autologin session  sufficient  pam_allow.so.1
           gdm-autologin password  sufficient  pam_allow.so.1

The above setup will cause no lastlog entry to be generated. If a lastlog entry is desired, then use the following for session:

           gdm-autologin session required pam_unix_session.so.1

### Інші особливості Solaris

GDM підтримує деякі специфічні властивості Solaris:

GDM supports Solaris Auditing if running on Solaris 10 or higher. GDM should not be used if auditing is needed and running Solaris 9 or older.

GDM supports a security feature which causes the X server to run as the user instead of as the root user. GDM must be using PAM for this feature to be enabled, which is the normal case for Solaris. This second feature has the side-effect of causing the X server to always restart between sessions, which disables the AlwaysRestartServer configuration option.

Solaris supports the `/etc/default/login` interface, which affects the `DefaultPath`, `RootPath`, `PasswordRequired`, and `AllowRemoteRoot` options as described in the "Configuration" section.

## Приклади конфігурацій

У цій секції наведені приклади конфігурацій, які корисні у різних випадках.

### Термінальна лабораторія з одним сервером

Suppose you want to make a lab full of X terminals that all connect to one server machine. So let's call one X terminal `xterminal` and let's call the server machine `appserver`. You install GDM on both.

On `appserver` you enable XDMCP, so you have

    [xdmcp]
    Enable=true

If you want no local screens here, you can then make the `[servers]` section empty.

On the `xterminal` you disable XDMCP (you don't want anyone to connect to the xterminal really). You will add a server type perhaps called `Terminal` as follows:

    [server-Terminal]
    name=Terminal server
    command=/path/to/X -terminate
    flexible=false
    handled=false

This definition should in fact be included in the standard configuration file. Notice that we made the `handled` key false since we don't want GDM to handle this server localy. Also note that we have not yet added the `-query` argument, you can add that here, or in the `[servers]` section. We'll define our local servers as follows:

    [servers]
    0=Terminal -query appserver

This will run a direct XDMCP query to the server named `appserver`.

### Термінальна лабораторія з двома або кількома серверами

Скажімо ви хочете створити лабораторію з X-терміналами, які з'єднані з кількома серверами. Тож створимо їх `appserverone` та `appservertwo`. Знову назвемо наш сервер X-терміналів `xterminal`. Параметри на обох серверах такі ж як і у випадку з одним сервером. Не слід явно вмикати непрямі запити до сервера, бо на X-терміналах локально запускається селектор вузлів.

So on the `xterminal` you again disable XDMCP. You will add a server type perhaps called `Chooser` as follows:

    [server-Chooser]
    name=Chooser server
    command=/path/to/X
    flexible=false
    chooser=true

And again this definition should in fact be included in the standard configuration file. Notice that we made the `chooser` key true here. This will run the XDMCP chooser for this server, and when the user chooses a host GDM will run a query for that host. Then we will define our local servers as follows:

    [servers]
    0=Chooser

The XDMCP chooser on the X terminal will normally give a broadcast query to see which servers exist on the network. If the two servers are not reachable by a broadcast query, you must add them by hand to the configuration file. So in the `[chooser]` section you would have:

    Hosts=appserverone,appservertwo

and any other servers you wish the users to be able to connect to.

Sometimes you may want to run the chooser on the server side however. Then what you want to do is to run a configuration similar to the previous section about the one server configuration with XDMCP indirect queries enabled on `appserver` and on the X terminals you'd have

    [servers]
    0=Terminal -indirect appserver

This way for example you only have to maintain one `Hosts` entry. However as a disadvantage then, the `appserver` must then always be available. So it's not good for situations where you want to have several servers and not all of them have to be on all the time. You could also have one of the X terminals handle indirect XDMCP queries and serve up the chooser to the other X terminals.

### Defining Custom Commands

Suppose you want to add a custom command to the GDM menu that will give you the oportunity to boot into other operating system such as Windoze. Jsut add the following options into the `[customcommand]` section of the GDM configuration file.

              [customcommand]
              CustomCommand0=/sbin/rebootwindoze;/usr/local/sbin/rebootwindoze
              CustomCommandLabel0=_Windoze
              CustomCommandLRLabel0=Reboot into _Windoze
              CustomCommandText0=Are you sure you want to restart the computer into Windoze?
              CustomCommandTooltip0=Restarts the computer into Windoze
              CustomCommandIsPersistent0=true

CustomCommand0 specifies two commands separated by a semicolon: `/sbin/rebootwindoze` and `/usr/local/sbin/rebootwindoze`. GDM will use the first valid command in the list. This allows different commands for different operating systems to be included.

Note, that besides being able to customise this option to reboot into different operating systems you can also use it to define your own custom behaviours that you wish to run from the GDM menu. Suppose you want to give users the oportunity to run system update scripts from the login screen. Add the following options into the `[customcommand]` section of your GDM configuration file.

              [customcommand]
              CustomCommand0=/sbin/updatesystem;/usr/local/sbin/updatesystem
              CustomCommandLabel0=_Update Me
              CustomCommandLRLabel0=Update the system
              CustomCommandText0=Are you sure you want to update the system software?
              CustomCommandTooltip0=Updates the system
              CustomCommandNoRestart0=true

Both custom commands could be defined as follows.

              [customcommand]
              CustomCommand0=/sbin/rebootwindoze;/usr/local/sbin/rebootwindoze
              CustomCommandLabel0=_Windoze
              CustomCommandLRLabel0=Reboot into _Windoze
              CustomCommandText0=Are you sure you want to restart the computer into Windoze?
              CustomCommandTooltip0=Restarts the computer into Windoze
              CustomCommandIsPersistent0=true

              CustomCommand1=/sbin/updatesystem;/usr/local/sbin/updatesystem
              CustomCommandLabel1=_Update Me
              CustomCommandLRLabel1=Update the system
              CustomCommandText1=Are you sure you want to update the system software?
              CustomCommandTooltip1=Updates the system
              CustomCommandNoRestart1=true

There can be up to 10 custom commands numbered 0-9.

              [customcommand]
              CustomCommand0=/sbin/rebootwindoze;/usr/local/sbin/rebootwindoze
              CustomCommandLabel0=_Windoze
              CustomCommandLRLabel0=Reboot into _Windoze
              CustomCommandText0=Are you sure you want to restart the computer into Windoze?
              CustomCommandTooltip0=Restarts the computer into Windoze
              CustomCommandIsPersistent0=true

              CustomCommand1=/sbin/updatesystem;/usr/local/sbin/updatesystem
              CustomCommandLabel1=_Update Me
              CustomCommandLRLabel1=Update the system
              CustomCommandText1=Are you sure you want to update the system software?
              CustomCommandTooltip1=Updates the system
              CustomCommandNoRestart1=true

              CustomCommand3=/sbin/do_something
              .
              .
              .

              CustomCommand4=/sbin/do_something_else
              .
              .
              .

## Усунення проблем

This section discusses helpful tips for getting GDM working. In general, if you have a problem using GDM, you can submit a bug to the "gdm" category in bugzilla.gnome.org or send an email to the

    gdm-list@gnome.org

mail list.

If GDM is failing to work properly, it is always a good idea to include debug information. Use the `gdmsetup` command to turn on debug ("Enable debug messages to system log" checkbox in the "Security" tab), then use GDM to the point where it fails, and include the GDM output sent to your system log (`<var>/log/messages` or `<var>/adm/messages` depending on your operating system). Since the system log can be large, please only include the GDM debug information and do not sent the entire file. If you do not see any GDM syslog output, you may need to configure syslog (see syslog.3c man page).

You should not leave debug on after collecting data. It will clutter your syslog and slow system performance.

### GDM не запускається

There are a many problems that can cause GDM to fail to start, but this section will discuss a few common problems and how to approach tracking down a problem with GDM starting. Some problems will cause GDM to respond with an error message or dialog when it tries to start, but it can be difficult to track down problems when GDM fails silently.

First make sure that the Xserver is configured properly. The GDM configuration file contains a command in the [server-Standard] section that is used for starting the Xserver. Verify that this command works on your system. Running this command from the console should start the Xserver. If it fails, then the problem is likely with your Xserver configuration. Refer to your Xserver error log for an idea of what the problem may be. The problem may also be that your Xserver requires different command-line options. If so, then modify the Xserver command in the GDM configuration file so that it is correct for your system.

Another common problem is that the GDM greeter program is having trouble starting. This can happen, for example, if GDM cannot find a needed library or other resource. Try starting the Xserver and a terminal program, set the shell environment variable DOING_GDM_DEVELOPMENT=1 and run `<lib>/gdmlogin` or `<lib>/gdmgreeter`. Any error messages echoed to the terminal will likely highlight the problem. Also, turning on debug and checking the output sent to the system log will often highlight the problem.

Also make sure that the `/tmp` directory has reasonable ownership and permissions, and that the machine's file system is not full. These problems will cause GDM to fail to start.

### GDM не може отримати доступ до параметрів користувача

GDM saves user settings, such as your default session and default language, in the `~/.dmrc`. Other files, such as the user's `~/.Xauthority` file will also affect login. GDM, by default, is strict about how it tries to access files in the user's home directory, and will ignore the file if they do not conform to certain rules. You can use the `RelaxPermissions` configuration option to make GDM less strict about how it accesses files in the user's home directory, or correct the permissions issues that cause GDM to ignore the file. This is discussed in detail described in the "File Access" section of the "Overview".

## Ліцензія

Ця програма є вільним програмним забезпеченням; ви можете розповсюджувати її ат/чи змінювати на умовах ліцензії GNU General Public License яка опублікована Free Software Foundation; версії 2 цієї ліцензії, або (за вашим бажанням) будь-якої більш пізньої версії.

Ця програма поширюється з надією, що буде корисною, але БЕЗ БУДЬ_ЯКИХ ГАРАНТІЙ; навіть без неявної гарантії ПРИДАТНОСТІ ДО ПРОДАЖУ або ВІДПОВІДНОСТІ ПЕВНІЙ МЕТІ. Докладніше про це дивіться у GNU General Public License.

Копія GNU General Public License включається як додаток до Довідки користувача GNOME. Також можна отримати копію GNU General Public License від Free Software Foundation відвідавши їх веб-сайт або написавши за адресою

     Free Software Foundation, Inc. 59 Temple Place - Suite 330 Boston, MA02111-1307USA