From d65b84fa77b518de73ae57584d0dc0d3a3441082 Mon Sep 17 00:00:00 2001 From: Murray Stokely Date: Thu, 24 May 2001 03:42:45 +0000 Subject: [PATCH] Add a section on installing and using XDM. Submitted by: Seth Kingsley --- en_US.ISO8859-1/books/handbook/authors.ent | 4 +- .../books/handbook/x11/chapter.sgml | 219 +++++++++++++++++- en_US.ISO8859-1/share/sgml/authors.ent | 4 +- en_US.ISO_8859-1/books/handbook/authors.ent | 4 +- .../books/handbook/x11/chapter.sgml | 219 +++++++++++++++++- 5 files changed, 443 insertions(+), 7 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/authors.ent b/en_US.ISO8859-1/books/handbook/authors.ent index ef65a4185f..67a99e5425 100644 --- a/en_US.ISO8859-1/books/handbook/authors.ent +++ b/en_US.ISO8859-1/books/handbook/authors.ent @@ -13,7 +13,7 @@ builds for the other languages, and we will poke fun of you in public. - $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/authors.ent,v 1.158 2001/05/02 01:26:05 murray Exp $ + $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/authors.ent,v 1.159 2001/05/18 22:49:53 pirzyk Exp $ --> abial@FreeBSD.org"> @@ -524,6 +524,8 @@ semenu@FreeBSD.org"> +seth.kingsley@windriver.com"> + sf@FreeBSD.org"> shafeeq@FreeBSD.org"> diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.sgml b/en_US.ISO8859-1/books/handbook/x11/chapter.sgml index 03aef28e75..8a55b857a0 100644 --- a/en_US.ISO8859-1/books/handbook/x11/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/x11/chapter.sgml @@ -1,7 +1,7 @@ @@ -12,7 +12,8 @@ url="http://www.wccdrom.com/titles/freebsd/bsdcomp_bkx.phtml">The Complete FreeBSD, and remains copyright of him. Modifications for the handbook made by &a.jim;. The section on - fonts in XFree86 was contributed by &a.murray;. + fonts in XFree86 was contributed by &a.murray; and the section on + XDM was contributed by &a.sethk;. Synopsis @@ -1386,6 +1387,220 @@ For further configuration, refer to /usr/X11R6/lib/X11/doc/README.Config. + + + The X Display Manager + + Overview + 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 (see section + ), 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 password + combination. + + You may 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, signalling 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. + + + + Using XDM + The XDM daemon program is located in + /usr/X11R6/bin/xdm. You can run this + program at any time as root and it will start managing the X + display on the local machine. If you want XDM to run in the + background 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: + + +ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure + + + By default this entry is disabled, and in order to enable it you + will need to change field 5 from off to + on and then 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 virtual terminal. + + + + Configuring XDM + The XDM configuration directory is located in + /usr/X11R6/lib/X11/xdm. In this directory + you will see several files used to change the behavior and + appearence of XDM. Typically you will find these files: + + + + + + File + Description + + + + + + Xaccess + Client authorization ruleset. + + + + Xresources + Default X resource values. + + + + Xservers + List of remote and local displays to manage. + + + + Xsession + Default session script for logins. + + + + Xsetup_* + + + + + xdm-config + Global configuration for all displays running on + this machine. + + + + xdm-errors + Errors generated by the server program. + + + + xdm-pid + The process ID of the currently running XDM. + + + + + + Also in this directory are a few scripts and programs used + to setup the desktop when XDM is running. In the next few + sections I will briefly describe the purpose of each of these + files. 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 if you are planning to design your own look and feel for + the XDM screens. + + + Xaccess + The protocol for connecting to XDM controlled displays is + called the X Display Manager Connection Protocol (XDMCP). This + file is basically just a ruleset for controlling XDMCP + connections from remote machines. By default, it allows any + client to connect, but you will see this will not matter + because the default xdm-config file does not listen for remote + connections. + + + + Xresources + This is an application-defaults file for the display + chooser and the login screens. This is where you can customize + the appearence of the login program. The format is identical + to the app-defaults file described in the XFree86 + 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 ~/.xsessionrc that + overrides this script. + + + + Xsetup_* + These files contain scripts that 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 file contains settings in the form of app-defaults + that are applicable to every display that this installation + manages. + + + + xdm-errors + This file 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 + In order for other clients to connect to your display + server, you will need to edit the access control rules, and + enable the connection listener. By default these are set to + conservative values, which is a good descision security-wise. To + get XDM to listen for connections first comment out a line in + the xdm-config file: + + +! 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 a + #. After this, you may need to put more strict + access controls in place. Look at the example entries in + Xaccess file, and refer to the &man.xdm.1; + manual page. + + abial@FreeBSD.org"> @@ -524,6 +524,8 @@ semenu@FreeBSD.org"> +seth.kingsley@windriver.com"> + sf@FreeBSD.org"> shafeeq@FreeBSD.org"> diff --git a/en_US.ISO_8859-1/books/handbook/authors.ent b/en_US.ISO_8859-1/books/handbook/authors.ent index ef65a4185f..67a99e5425 100644 --- a/en_US.ISO_8859-1/books/handbook/authors.ent +++ b/en_US.ISO_8859-1/books/handbook/authors.ent @@ -13,7 +13,7 @@ builds for the other languages, and we will poke fun of you in public. - $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/authors.ent,v 1.158 2001/05/02 01:26:05 murray Exp $ + $FreeBSD: doc/en_US.ISO_8859-1/books/handbook/authors.ent,v 1.159 2001/05/18 22:49:53 pirzyk Exp $ --> abial@FreeBSD.org"> @@ -524,6 +524,8 @@ semenu@FreeBSD.org"> +seth.kingsley@windriver.com"> + sf@FreeBSD.org"> shafeeq@FreeBSD.org"> diff --git a/en_US.ISO_8859-1/books/handbook/x11/chapter.sgml b/en_US.ISO_8859-1/books/handbook/x11/chapter.sgml index 03aef28e75..8a55b857a0 100644 --- a/en_US.ISO_8859-1/books/handbook/x11/chapter.sgml +++ b/en_US.ISO_8859-1/books/handbook/x11/chapter.sgml @@ -1,7 +1,7 @@ @@ -12,7 +12,8 @@ url="http://www.wccdrom.com/titles/freebsd/bsdcomp_bkx.phtml">The Complete FreeBSD, and remains copyright of him. Modifications for the handbook made by &a.jim;. The section on - fonts in XFree86 was contributed by &a.murray;. + fonts in XFree86 was contributed by &a.murray; and the section on + XDM was contributed by &a.sethk;. Synopsis @@ -1386,6 +1387,220 @@ For further configuration, refer to /usr/X11R6/lib/X11/doc/README.Config. + + + The X Display Manager + + Overview + 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 (see section + ), 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 password + combination. + + You may 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, signalling 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. + + + + Using XDM + The XDM daemon program is located in + /usr/X11R6/bin/xdm. You can run this + program at any time as root and it will start managing the X + display on the local machine. If you want XDM to run in the + background 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: + + +ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure + + + By default this entry is disabled, and in order to enable it you + will need to change field 5 from off to + on and then 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 virtual terminal. + + + + Configuring XDM + The XDM configuration directory is located in + /usr/X11R6/lib/X11/xdm. In this directory + you will see several files used to change the behavior and + appearence of XDM. Typically you will find these files: + + + + + + File + Description + + + + + + Xaccess + Client authorization ruleset. + + + + Xresources + Default X resource values. + + + + Xservers + List of remote and local displays to manage. + + + + Xsession + Default session script for logins. + + + + Xsetup_* + + + + + xdm-config + Global configuration for all displays running on + this machine. + + + + xdm-errors + Errors generated by the server program. + + + + xdm-pid + The process ID of the currently running XDM. + + + + + + Also in this directory are a few scripts and programs used + to setup the desktop when XDM is running. In the next few + sections I will briefly describe the purpose of each of these + files. 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 if you are planning to design your own look and feel for + the XDM screens. + + + Xaccess + The protocol for connecting to XDM controlled displays is + called the X Display Manager Connection Protocol (XDMCP). This + file is basically just a ruleset for controlling XDMCP + connections from remote machines. By default, it allows any + client to connect, but you will see this will not matter + because the default xdm-config file does not listen for remote + connections. + + + + Xresources + This is an application-defaults file for the display + chooser and the login screens. This is where you can customize + the appearence of the login program. The format is identical + to the app-defaults file described in the XFree86 + 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 ~/.xsessionrc that + overrides this script. + + + + Xsetup_* + These files contain scripts that 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 file contains settings in the form of app-defaults + that are applicable to every display that this installation + manages. + + + + xdm-errors + This file 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 + In order for other clients to connect to your display + server, you will need to edit the access control rules, and + enable the connection listener. By default these are set to + conservative values, which is a good descision security-wise. To + get XDM to listen for connections first comment out a line in + the xdm-config file: + + +! 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 a + #. After this, you may need to put more strict + access controls in place. Look at the example entries in + Xaccess file, and refer to the &man.xdm.1; + manual page. + +