From owner-svn-doc-all@FreeBSD.ORG Fri May 2 19:10:09 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 265D9C74; Fri, 2 May 2014 19:10:09 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id ECFFD1FEF; Fri, 2 May 2014 19:10:08 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s42JA8K2005715; Fri, 2 May 2014 19:10:08 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s42JA8aL005714; Fri, 2 May 2014 19:10:08 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405021910.s42JA8aL005714@svn.freebsd.org> From: Dru Lavigne Date: Fri, 2 May 2014 19:10:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44742 - head/en_US.ISO8859-1/books/handbook/x11 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 May 2014 19:10:09 -0000 Author: dru Date: Fri May 2 19:10:08 2014 New Revision: 44742 URL: http://svnweb.freebsd.org/changeset/doc/44742 Log: Editorial review of XDM section. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Fri May 2 17:55:14 2014 (r44741) +++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Fri May 2 19:10:08 2014 (r44742) @@ -804,91 +804,66 @@ dbus_enable="YES" - - The X Display Manager - - - Overview + X Display Manager - The X Display Manager (XDM) - is an optional part of the X Window System that is used for - login session management. This is useful for several types - of situations, including minimal X Terminals, - desktops, and large network display servers. Since the X - Window System is network and protocol independent, there are - a wide variety of possible configurations for running X - clients and servers on different machines connected by a - network. XDM provides a graphical - interface for choosing which display server to connect to, - and entering authorization information such as a login and + &xorg; provides an X Display + Manager, XDM, which can be used for + login session management. XDM provides a graphical + interface for choosing which display server to connect to + and for entering authorization information such as a login and password combination. - Think of XDM as providing the - same functionality to the user as the &man.getty.8; utility - (see for details). That is, it - performs system logins to the display being connected to and - then runs a session manager on behalf of the user (usually an - X window manager). XDM then waits - for this program to exit, signaling that the user is done and - should be logged out of the display. At this point, - XDM can display the login and - display chooser screens for the next user to login. - + This section demonstrates how to configure the X Display + Manager on &os;. Some desktop environments provide their own + graphical login manager. Refer to for instructions on how to + configure the GNOME Display Manager and for instructions on how to configure + the KDE Display Manager. - Using XDM + Configuring <application>XDM</application> - To start using XDM, install - the x11/xdm port (it is not installed by - default in recent versions of - &xorg;). The - XDM daemon program may then be - found in /usr/local/bin/xdm. This - program can be run at any time as root and it will start - managing the X display on the local machine. If - XDM is to be run every time the - machine boots up, a convenient way to do this is by adding an - entry to /etc/ttys. For more information - about the format and usage of this file, see . There is a line in the default - /etc/ttys file for running the - XDM daemon on a virtual - terminal: + To install XDM, use the + x11/xdm package or port. Once installed, + XDM can be configured to run when the + machine boots up by editing this + entry in /etc/ttys: ttyv8 "/usr/local/bin/xdm -nodaemon" xterm off secure - By default this entry is disabled; in order to enable it - change field 5 from off to - on and restart &man.init.8; using the - directions in . The first field, - the name of the terminal this program will manage, is - ttyv8. This means that - XDM will start running on the 9th + Change the off to + on and save the edit. The + ttyv8 in this entry indicates that + XDM will run on the ninth virtual terminal. - - - - Configuring XDM The XDM configuration directory - is located in /usr/local/lib/X11/xdm. In - this directory there are several files used to change the - behavior and appearance of XDM. - Typically these files will be found: + is located in /usr/local/lib/X11/xdm. + This directory contains several files used to change the + behavior and appearance of XDM, as + well as a few scripts and programs used to set up the desktop + when XDM is running. summarizes the function of + each of these files. The exact syntax and usage of these + files is described in &man.xdm.1;. + + + XDM Configuration Files - @@ -900,29 +875,54 @@ dbus_enable="YES" Xaccess - Client authorization ruleset. + The protocol for connecting to + XDM is called the X Display + Manager Connection Protocol (XDMCP) + This file is a client authorization ruleset for + controlling XDMCP connections from + remote machines. By default, this file does not allow + any remote clients to connect. Xresources - Default X resource values. + This file controls the look and feel of the + XDM display chooser and + login screens. The default configuration is a simple + rectangular login window with the hostname of the + machine displayed at the top in a large font and + Login: and Password: + prompts below. The format of this file is identical + to the app-defaults file described in the + &xorg; + documentation. Xservers - List of remote and local displays to - manage. + The list of local and remote displays the chooser + should provide as login choices. Xsession - Default session script for logins. + Default session script for logins which is run by + XDM after a user has logged + in. Normally each user will have a customized session + script in ~/.xsession that + overrides this script Xsetup_* - Script to launch applications before the login - interface. + Script to automatically launch applications + before displaying the chooser or login interfaces. + There is a script for each display being used, named + Xsetup_*, where + * is the local display number. + Typically these scripts run one or two programs in the + background such as + xconsole. @@ -933,137 +933,47 @@ dbus_enable="YES" xdm-errors - Errors generated by the server program. + Contains errors generated by the server program. + If a display that XDM is + trying to start hangs, look at this file for error + messages. These messages are also written to the + user's ~/.xsession-errors file on + a per-session basis. xdm-pid - The process ID of the currently running - XDM. + The running process ID of + XDM. - - - Also in this directory are a few scripts and programs - used to set up the desktop when XDM - is running. The purpose of each of these files will be - briefly described. The exact syntax and usage of all of these - files is described in &man.xdm.1;. - - The default configuration is a simple rectangular login - window with the hostname of the machine displayed at the top - in a large font and Login: and - Password: prompts below. This is a good - starting point for changing the look and feel of - XDM screens. - - - Xaccess - - The protocol for connecting to - XDM-controlled displays is - called the X Display Manager Connection Protocol (XDMCP). - This file is a ruleset for controlling XDMCP connections - from remote machines. It is ignored unless the - xdm-config is changed to listen for - remote connections. By default, it does not allow any - clients to connect. - - - - Xresources - - This is an application-defaults file for the display - chooser and login screens. In it, the appearance - of the login program can be modified. The format is - identical to the app-defaults file described in the - &xorg; documentation. - - - - Xservers - - This is a list of the remote displays the chooser should - provide as choices. - - - - Xsession - - This is the default session script for - XDM to run after a user has - logged in. Normally each user will have a customized - session script in ~/.xsession that - overrides this script. - - - - Xsetup_* - - These will be run automatically before displaying the - chooser or login interfaces. There is a script for each - display being used, named Xsetup_ - followed by the local display number (for instance - Xsetup_0). Typically these scripts - will run one or two programs in the background such as - xconsole. - - - - xdm-config - - This contains settings in the form of app-defaults - that are applicable to every display that this installation - manages. - - - - xdm-errors - - This contains the output of the X servers that - XDM is trying to run. If a - display that XDM is trying to - start hangs for some reason, this is a good place to look - for error messages. These messages are also written to the - user's ~/.xsession-errors file on a - per-session basis. - +
- Running a Network Display Server + Configuring Remote Access - In order for other clients to connect to the display - server, you must edit the access control rules and enable - the connection listener. By default these are set to - conservative values. To make XDM - listen for connections, first comment out a line in the - xdm-config file: + By default, only users on the same system can login using + XDM. To enable users on + other systems to connect to the display + server, edit the access control rules and enable + the connection listener. + + To configure XDM to + listen for any remote connection, comment out the + DisplayManager.requestPort line in + /usr/local/lib/X11/xdm/xdm-config by + putting a ! in front of it: ! SECURITY: do not listen for XDMCP or Chooser requests ! Comment out this line if you want to manage X terminals with xdm DisplayManager.requestPort: 0 - and then restart XDM. - Remember that comments in app-defaults files begin with a - ! character, not the usual #. - More strict access controls may be desired — look at the - example entries in Xaccess, and refer to - the &man.xdm.1; manual page for further information. - - - - Replacements for XDM - - Several replacements for the default - XDM program exist. One of them, - KDM (bundled with - KDE) is described later in this - chapter. The KDM display manager - offers many visual improvements and cosmetic frills, as well - as the functionality to allow users to choose their window - manager of choice at login time. + Save the edits and restart XDM. + To restrict remote access, look at the + example entries in /usr/local/lib/X11/xdm/Xaccess and refer to + &man.xdm.1; for further information.