home | help 
DRAWTERM(1)		     General Commands Manual		     DRAWTERM(1)

NAME
     drawterm  - connection to cpu, fs, and auth servers

SYNOPSIS
     drawterm [ -GBO ] [ -h host ] [ -u user ] [ -a authserver ] [ -s secstore ]
     [	-e  'crypt hash' ] [ -k keypattern ] [ -p ] [ -t timeout ] [ -r root ] [
     -g geometry ] [ -c cmd ...]

DESCRIPTION
     Drawterm is a client for connecting venerable systems to  Plan  9	systems.
     The standard behavior with no options provided is to begin a graphical ses-
     sion  which  will	prompt	for  a cpu server, auth server, and password. If
     $USER is not set, drawterm will prompt for a username as well.

     The goal of drawterm is to provide an abstraction layer from the client op-
     erating system to the desired Plan 9 system. Client-side devices  that  can
     be  represented  as  filesystems  will be and are served from the namespace
     drawterm operates in. Generally, this means that drawterm	behaves  like  a
     Plan  9 kernel and will attempt to reconstruct a Plan 9 terminal-like expe-
     rience from a non-Plan 9 system.

     The options are:

     -G     Start drawterm in text-only mode (no graphics).

     -B     Disable kbdfs.

     -O     Use the old cpu(1) to connect to the cpu server rather than rcpu(1).

     -h host
	    Connect to host for cpu.

     -u user
	    Remote user id.

     -a authserver
	    Connect to authserver for auth.

     -s secstore
	    Sets the address of the secstore(8) server. If the -s option is  ab-
	    sent,  secstore(1)	will  attempt to dial tcp!$auth!secstore (or the
	    otherwise specified auth server).

     -e 'crypt hash'
	    Specifies the 'crypt  hash'  for  the  connection.	The  default  is
	    'rc4_256  sha1'.  Usage of no encryption can be specified by 'clear'
	    as per ssl(3).Notethatthisoptionisdeprecatedandonlyrelevanttotheout-
	    dated cpu(1) protocol.

     -k keypattern
	    Use keypattern to select a key to authenticate to  the  remote  side
	    (see auth(2)).

     -p     Protect  the  connection  against  connection resets by establishing
	    aan(8) tunnel.

     -t timeout
	    Set the timeout for aan(8) to a value in  seconds  (default  is  one
	    day).

     -r root
	    Specifies the root directory on the client. The default is /root and
	    all further paths are relative thereto.

     -c cmd ...
	    The  command  to run can be passed with -c cmd ..., otherwise an in-
	    teractive shell is started. The user's profile  is	run  before  the
	    command  with  $service set to cpu to allow further customization of
	    the environment (see rc(1) for more information).

ENVIRONMENT VARIABLES
     USER   Unless otherwise specified, the user stored in $USER is used for au-
	    thentication.

     PASS   If $PASS is set, no password will be prompted for in  authentication
	    and the contents of $PASS will be used instead.

     cpu    Unless  otherwise  specified, the address stored in $cpu is used for
	    the rcpu(1) connection (if set).

     auth   Unless otherwise specified, the address stored in $auth is used  for
	    the rcpu(1) connection (if set).

SERVICES
     A	number of services are provided in drawterm. The exact functionality and
     availability of certain features may be dependent on your platform  or  ar-
     chitecture:

     /mnt/term
	    A  mount  of the client machine's root filesystem as well as certain
	    virtual filesystems to present Plan 9 devices  and	interfaces  that
	    are not available on non-Plan 9 systems. On Windows this is a direc-
	    tory  containing  the available lettered disks (C:, A:, etc.). Addi-
	    tionally, there is always a /mnt/term/root folder which is a copy of
	    the client machine's namespace with no virtual  filesystems  present
	    as to avoid conflicting names (such as with Linux's /root).

     #b     Assuming the -B flag is not set, /dev/kbd will be provided for kbdfs
	    (see kbd(3)).

     #i     Assuming  the  -G flag is not set, various drawing device files will
	    be provided in /dev (see draw(3)).

     #m     Assuming the -G flag is not set, files  for  controlling  the  mouse
	    will provided in /dev (see mouse(3)).

     #c     A number of console device files giving access to the console screen
	    and  miscellaneous information are provided and mounted in /dev (see
	    cons(3)).

     #I     The network filesystem is served and bound over /net, providing  the
	    interface to Internet Protocol stacks (see ip(3)).

     #A     An	audio  device  filesystem is served, if possible, as a one-level
	    directory in /dev (see audio(3)).  Note that this device, if  unable
	    to be served, will not cause a panic in drawterm.

EXAMPLES
     Make  a  headless rcpu session connecting to 10.30.167.25 using plan9.post-
     nix.us as the auth server with aan(8) enabled:

	    drawterm -G -h 10.30.167.25 -a plan9.postnix.us -p

     Make a session using cpu rather than rcpu to tenshi.postnix.us;  this  com-
     mand is the same for connecting to a Plan 9 4th edition system:

	    drawterm -O -h tenshi.postnix.us

SOURCE
     https://git.9front.org/plan9front/drawterm/HEAD/info.html

SEE ALSO
     rc(1), cpu(1), rcpu(1), con(1), import(4), exportfs(4), tlssrv(8), aan(8)

BUGS
     Drawterm is not a Plan 9 program.

HISTORY
     Drawterm was originally developed by Russ Cox (rsc) for Plan 9 4th edition.
     This original version is still usable on Plan 9 and its forks which use the
     p9sk1 and older authsrv(6) protocols.  https://swtch.com/drawterm/

     The 9front project has forked drawterm to incorporate features from 9front,
     most importantly dp9ik authentication support (see authsrv(6)) and the TLS-
     based rcpu(1) protocol.

								     DRAWTERM(1)
home | help