1 | .\" $Id: dm.8,v 1.1 1999-10-14 22:18:55 kcr Exp $ |
---|
2 | .TH DM 8 "30 April 1994" |
---|
3 | .ds ]W MIT Project Athena |
---|
4 | .SH NAME |
---|
5 | dm \- X display manager |
---|
6 | .SH SYNOPSIS |
---|
7 | dm \fIconfigfile logintty\fR [-noconsole] \fIconsoletty\fR |
---|
8 | .SH DESCRIPTION |
---|
9 | |
---|
10 | \fIDm\fR is intended to be run by \fIinit\fR to startup the X server, |
---|
11 | the X console, and X login. It will read out of the specified config |
---|
12 | file the command lines for these three processes. |
---|
13 | .PP |
---|
14 | This file consists of lines containing the program name, whitespace, |
---|
15 | and the commandline for the program. The program names recognized are |
---|
16 | \fBdm\fB, \fBX\fR, \fBconsole\fR, \fBlogin\fR, and \fBttylogin\fR. |
---|
17 | Everything from a hash mark to the end-of-line will be ignored as a |
---|
18 | comment. \fIDm\fR recognizes one command line option from this file, |
---|
19 | -display. If it is not specified, \fIdm\fR will default to :0. |
---|
20 | .PP |
---|
21 | The X server will be started first, using the SIGUSR1 handshake |
---|
22 | present in X11R4. \fIDm\fR will keep a connection open to prevent the |
---|
23 | X server from inadvertently resetting should the user at some point |
---|
24 | have closed all X connections temporarily. Next the console will be |
---|
25 | started, reading from the master side of the pseudo-tty specified as |
---|
26 | the \fIlogintty\fR. If \fIlogintty\fR is already in use, another |
---|
27 | pseudo-tty will be chosen. Then the login will be started, with stdin |
---|
28 | set to \fI/dev/null\fR and stdout and stderr set to \fIlogintty\fR. |
---|
29 | The display manager then waits for a change in the status of its |
---|
30 | children or a signal to arrive. If the display manager encounters |
---|
31 | errors while starting up, it will initiate a console login. |
---|
32 | .PP |
---|
33 | If the console exits, another one will be started. If the X server or |
---|
34 | xlogin exit, the display manager will clean up and exit. This |
---|
35 | includes a call to \fIal_acct_revert(3)\fR to clean up the user's login |
---|
36 | session if necessary. If xlogin exits with status 2, it is requesting |
---|
37 | that a raw console login be started. If the display manager receives |
---|
38 | SIGFPE, it will kill its children and sleep forever (this is a way to |
---|
39 | shutdown the display during updates). |
---|
40 | .PP |
---|
41 | If the \fB-noconsole\fR switch is given, it will not redirect system |
---|
42 | console output to the console process. This is necessary if more than |
---|
43 | one display manager is running on a machine. |
---|
44 | .SH FILES |
---|
45 | /etc/utmp, /usr/adm/wtmp, /etc/passwd, /etc/ptmp, /etc/X*.hosts, |
---|
46 | /var/athena/X*.pid, /var/athena/console.pid, /var/athena/dm.pid, /dev/mouse, |
---|
47 | /dev/cons, /var/athena/console.log, /dev/console |
---|
48 | |
---|
49 | .SH "SEE ALSO" |
---|
50 | Xserver(1), console(8), xlogin(8), config_console(1), init(8), |
---|
51 | al_acct_revert(3) |
---|
52 | |
---|
53 | .SH AUTHOR |
---|
54 | Mark Rosenstein, MIT Project Athena |
---|
55 | .br |
---|
56 | Copyright (c) 1990 Massachusetts Institute of Technology |
---|
57 | |
---|
58 | .SH BUGS |
---|
59 | Sometimes the console does not revert back to the real console when a |
---|
60 | console login is requested. |
---|
61 | |
---|
62 | Sometimes it is necessary to press SHIFT, CONTROL, and/or META before |
---|
63 | keys work normally when a console login is requested. |
---|