void-packages/srcpkgs/drawterm/files/drawterm.1

124 lines
3.3 KiB
Groff

.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH DRAWTERM 1 "October 16, 2008"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
drawterm \- connect to Plan 9 CPU servers from other operating systems
.SH SYNOPSIS
.B drawterm
.RB [ \-d ]\|
.RB [ -a
.IR authserver ]
.RB [ -c
.IR cpuserver ]
.RB [ -e
.IR encription_hash_algs ]
.RB [ -k
.IR keyspec ]
.RB [ -s
.IR secstoreserver ]
.RB [ -u
.IR username ]
.RB [ -C
.I command args
.IR ... ]
.br
.SH DESCRIPTION
\fBdrawterm\fP is not a Plan 9 program.
It is a program that users of non-Plan 9 systems can use to establish
graphical
.BR cpu (1)
connections with Plan 9 CPU servers. Just as a real Plan 9 terminal does, a
\fBdrawterm\fP 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
.I /mnt/term
and starts a shell.
Typically, either explicitly or via the profile, one uses the shell to start
.BR rio (1).
.PP
By default, drawterm uses the CPU server \fB$cpu\fP or \fIcpu\fP, and the
authentication server \fB$auth\fP or \fIauth\fP,
.SH OPTIONS
This program follows the syntax of the cpu(1) Plan 9 command.
A summary of options is included below.
.TP
.B \-h
Show summary of options.
.TP
.B \-a
Specifies the authentication server to use. If not present uses the
.B $auth
environment variable, if present, or tries with a host name of
.BR auth .
.TP
.B \-c
Specifies the cpu server to use. If not present uses the
.B $cpu
environment variable, if present, or tries with a host name of
.BR cpu .
.TP
.B \-u
Specifies the username to authenticate with. If not present uses the
.B $USER
environment variable, if present, or asks interactively for an username.
.TP
.B \-s
Specifies the secstore server to use.
.TP
.B \-C
Specifies a command to be executed remotely.
.TP
.BR \-e , \-k
Allow for selecting the hash algorithm and keys used, they have the same
meaning as in \fBcpu\fP(1).
.SH SOURCE
In Plan 9 distributions, \fI/sys/src/cmd/unix/drawterm\fP.
.SH DIAGNOSTICS
Drawterm prints most diagnostics in its own window.
.SH BUGS
Although at first \fBdrawterm\fP 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 \fBdrawterm\fP.
The illusion can be improved by delicate adjustments in
\fI/usr/$user/lib/profile\fP.
Should import latest /dev/draw to allow resize of window
Should copy 9term code and make console window a real 9term window instead.
Should implement /dev/label.
.SH SEE ALSO
.BR cpu (1),
.BR rio (1)
in the Plan 9 documentation
.SH AUTHOR
drawterm was written by Russ Cox <rsc@swtch.com>.
.PP
This manual page was written by Russ Cox <rsc@swtch.com>, with modifications
by Martín Ferrari <tincho@debian.org> for the Debian project.