harvey/sys/man/8/drawterm

.TH DRAWTERM 8
.SH NAME
drawterm \- connect to Plan 9 CPU servers from other operating systems
.SH SYNOPSIS
.B drawterm
[
.B -a
.I authaddr
]
[
.B -c
.I cpuaddr
]
[
.B -d
depth
]
[
.B -r
root
]
[
.B -nm
]
.SH DESCRIPTION
.I Drawterm
is
.I not
a Plan 9 program.
It is a program that users of non-Plan 9 systems can use
to establish graphical 
.IR cpu (1)
connections with Plan 9 CPU servers.
Just as a real Plan 9 terminal does, 
.I drawterm
serves its local name space
as well as some devices (the keyboard, mouse, and screen)
to a remote CPU server, which mounts this name space
on 
.B /mnt/term
and starts a shell.
Typically, either explicitly or via the profile, one uses the shell
to start
.IR rio (1).
.PP
By default, 
drawterm
uses the CPU server
.B CPUSERV
and the authentication server
.BR AUTHSERV .
The 
.B -a
and
.B -c
options specify alternate servers.
(Edit the source to set appropriate local values  for the variables
.B AUTHSERV
and
.BR CPUSERV ).
.PP
On Windows systems, the file system served by the
terminal (and mounted on
.BR /mnt/term )
is the tree rooted at
.BR c:/ .
The
.B -r
option specifies a different file system root.
In Windows, the depth of the virtual screen
provided by
drawterm
matches the depth of the actual screen.
To present a screen with a different depth, use the
.B -d
option.
Both options do nothing on non-Windows systems.
.PP
The 
.B -n
option causes 
drawterm to prompt for authentication via
.IR netkey -style
challenge/response rather than using
the password-based protocol typically used
by terminals.
.PP
By default, drawterm queues mouse events to
guard against lost events due to network latency.
The
.B -m
option turns this behavior off.
.PP
Drawterm has been ported to
Digital Unix,
Irix,
Linux,
Solaris,
and
Windows.
Binaries are kept in
.BR /sys/src/cmd/unix/drawterm/bin .
.SH SOURCE
.B /sys/src/cmd/unix/drawterm
.SH DIAGNOSTICS
The Unix versions of drawterm print diagnostics
to standard error.
The Windows version displays message boxes.
.SH "SEE ALSO
.IR cpu (1),
.IR rio (1)
.SH BUGS
Although at first
.I drawterm
may seem like a Plan 9 terminal, in fact it is just a way to provide a CPU server
with some terminal devices.
The difference is important because one cannot run terminal-resident programs
when using
.IR drawterm .
The illusion can be improved by delicate adjustments in
.BR /usr/$user/lib/profile .
.PP
It would be nice to be able to change the default servers
without recompiling.