Drawterm to your terminal
D1361174253
Amycroftiv
#This memo describes how to setup your standalone terminal to accept
#[drawterm] and cpu(1) connections.
#
#INSTANT CPU SERVER FROM LIVE CD
#
#This assumes DHCP internet service. Change the ip/ipconfig line if
#needed.
#
#! term% ip/ipconfig
#! term% auth/factotum
#! term% echo 'key proto=p9sk1 dom=livecd user=glenda !password=password' >/mnt/factotum/ctl
#! term% aux/listen1 -t tcp!*!17010 /bin/cpu -R &
#
#This shortcut works on any Plan 9 system that isn't already running
#a standard authserver + keyfs. It works because starting listen1
#with the -t flag keeps the factotum available in the namespace of
#the cpu listener for direct authentication. Drawterm from another OS
#will connect as usual. CPU from Plan 9 requires an auth server to
#validate the key.
#
#(There seems to be a "direct auth" trick drawterm does that CPU(1)
#does not. It would be nice if CPU(1) also could connect without an
#authserver with this setup.)
#
#SETTING UP WITH KEYFS AND AUTHSRV
#
#Keyfs(4) is the process managing the users' key database. Create a
#new key database as $home/lib/keys.
#! term% touch  $home/lib/keys
#
#Start keyfs(4). It will ask you the password which is used to
#encrypt the key database file ($home/lib/keys).
#! term% auth/keyfs  -p  $home/lib/keys
#! Password: keyfilepassword
#! 0 keys read
#! term%
#
#Add a user to the key database
#! term% auth/changeuser  -p  glenda
#! Password: loginpassword
#! Confirm password: loginpassword
#! assign Inferno/POP secret? (y/n) n
#! Expiration date (YYYYMMDD or never)[return = never]:
#! 1 keys read
#! Post id:
#! User's full name:
#! Department #:
#! User's email address:
#! Sponsor's email address:
#! changeuser: can't open /adm/keys.who
#
#The last line is just a warning. You can ignore it.
#
#Now populate the factotum(4) with the hostowner information.
#! term% echo 'key user=glenda dom=drawterm.test proto=p9sk1 !password=loginpassword' > /mnt/factotum/ctl
#
#Start the authentication server on the "ticket" port.
#! term% aux/listen1 -t 'tcp!*!ticket' /bin/auth/authsrv &
#
#Start the cpu service listener on the "ncpu" port.
#! term% service=cpu aux/listen1 'tcp!*!ncpu' /bin/cpu -R &
#
#Then connect to your terminal using drawterm.
#! $ drawterm  -a  ip.of.the.term  -c  ip.of.the.term
#
#Once you've finished the above sequence, the key database should be
#created correctly. So if you reboot your terminal, you don't need to
#repeat the whole thing again. In short, it should be enough to do
#the following:
#! term% auth/keyfs -p $home/lib/keys # you can add this command to your profile
#! Password: keyfilepassword
#! 1 keys read
#! term% echo 'key user=glenda dom=drawterm.test proto=p9sk1 !password=loginpassword' > /mnt/factotum/ctl
#! term% aux/listen1 -t 'tcp!*!ticket' /bin/auth/authsrv &
#! term% service=cpu aux/listen1 'tcp!*!ncpu' /bin/cpu -R &
#
#ANCIENT DRAWTERM VERSIONS
#
#If you need access from really old versions of drawterm that don't
#support 9p2000 change the aux/listen1 call to listen on port "cpu"
#and call cpu with the -O arg. Note that '-O' refers to the capital
#letter O and not a zero.
#
#! term% service=cpu aux/listen1 'tcp!*!cpu' /bin/cpu -O &
#
#SEE ALSO
#
#To setup a proper cpu/auth server see: [Configuring a standalone CPU
#server].
#
#See the [drawterm] page for links to download source and binaries
#for various architectures.
#