This file is indexed.

/usr/share/doc/sdm-terminal/README is in sdm-terminal 0.4.1-4.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
this is a Secure Display Manager.

essentially, sdm runs zenity on the X-terminal, and connects
to a server via ssh.  it can also do automatic passwordless
logins with ssh keys.

Copyright 2003-2007 Vagrant Cascadian <vagrant@freegeek.org>.
Licensed under the terms of the GNU General Public License,
version 2 or any later version.

a basic overview:

sdm has two main packages.

the first package, sdm, is installed on a server.  it contains
the sdm-session script, which is called remotely by the
sdm-login script.

it's essential to have /etc/ssh/sshd_config configured with:

X11Forwarding yes

the second package, sdm-terminal, is installed on the
"terminal" or in the chrooted directory of the terminal(if
terminals are "diskless" terminals).  it contains
/usr/sbin/sdm, which should be run from the terminal's
/etc/inittab, like so:

sdm:2345:respawn:/usr/sbin/sdm vt7 -br

this would cause sdm to run (and respawn when it dies) when
entering runlevel 2, 3, 4 or 5, on virtual terminal 7, with 
a black background.

sdm calls another script, /usr/sbin/sdm-login.  this script 
gathers information about the user login, password or key, 
server to login to, etc.  some of this information may come 
from /etc/sdm/sdm.config or /etc/sdm/sdm.config.$hostname, or 
the getLoginInfo script, which usually uses zenity.

sdm-login the attempts to ssh to the server with X11Forwarding 
enabled, running the sdm-session program, which will source 
/etc/X11/Xsession.

also note that on the terminal, there must be a valid key in
/root/.ssh/known_hosts for any servers you wish to log into,
otherwise sdm will hang asking if you want to connect.

sdm-ssh-askpass is a re-write of ssh-askpass using
zenity. if the SSH_ASKPASS variable is set, ssh tries to get
any passwords using this program (unless run from a
terminal...) having sdm-ssh-askpass means we don't need to
depend on any of the other ssh-askpass programs, and is
graphically consistant with the login screen.  it's also
possible to have a totally graphical login using SSH_ASKPASS.