sys/man/8/drawterm

   1 .TH DRAWTERM 8
   2 .SH NAME
   3 drawterm \- connect to Plan 9 CPU servers from other operating systems
   4 .SH SYNOPSIS
   5 .B drawterm
   6 [
   7 .B -d
   8 ]
   9 [
  10 .B -a
  11 .I authaddr
  12 ]
  13 [
  14 .B -c
  15 .I cpuaddr
  16 ]
  17 [
  18 .B -e
  19 .I encryption-hash-algs
  20 ]
  21 [
  22 .B -k
  23 .I keypattern
  24 ]
  25 [
  26 .B -s
  27 .I secstoreaddr
  28 ]
  29 [
  30 .B -u
  31 .I user
  32 ]
  33 [
  34 .B -C
  35 .I cmd args ...
  36 ]
  37 .SH DESCRIPTION
  38 .I Drawterm
  39 is
  40 .I not
  41 a Plan 9 program.
  42 It is a program that users of non-Plan 9 systems can use
  43 to establish graphical
  44 .IR cpu (1)
  45 connections with Plan 9 CPU servers.
  46 Just as a real Plan 9 terminal does,
  47 .I drawterm
  48 serves its local name space
  49 as well as some devices (the keyboard, mouse, and screen)
  50 to a remote CPU server, which mounts this name space
  51 on
  52 .B /mnt/term
  53 and starts a shell.
  54 Typically, either explicitly or via the profile, one uses the shell
  55 to start
  56 .IR rio (1).
  57 .PP
  58 By default,
  59 drawterm
  60 uses the CPU server
  61 .B $cpu
  62 or
  63 .BR cpu .
  64 and the authentication server
  65 .B $auth
  66 or
  67 .BR auth .
  68 The
  69 .BR -a ,
  70 .BR -c ,
  71 and
  72 .B -s
  73 options specify alternate authentication, CPU and
  74 .I secstore
  75 servers,
  76 respectively.
  77 (Edit the source to set appropriate local defaults.)
  78 .PP
  79 .I Cmd
  80 is a command to be executed remotely.
  81 Options
  82 .LR e ,
  83 .LR k ,
  84 and
  85 .L u
  86 have the same meaning as in
  87 .IR cpu (1).
  88 .PP
  89 Drawterm has been ported to
  90 FreeBSD,
  91 Irix,
  92 Linux,
  93 NetBSD,
  94 and
  95 Windows.
  96 Binaries can be downloaded from
  97 .BR http://swtch.com/drawterm/ .
  98 .SH SOURCE
  99 .B /sys/src/cmd/unix/drawterm
 100 .SH DIAGNOSTICS
 101 Drawterm prints most diagnostics in its own window.
 102 .SH "SEE ALSO
 103 .IR cpu (1),
 104 .IR rio (1)
 105 .SH BUGS
 106 Although at first
 107 .I drawterm
 108 may seem like a Plan 9 terminal, in fact it is just a way to provide a CPU server
 109 with some terminal devices.
 110 The difference is important because one cannot run terminal-resident programs
 111 when using
 112 .IR drawterm .
 113 The illusion can be improved by delicate adjustments in
 114 .BR /usr/$user/lib/profile .
 115 .PP
 116 It would be nice to be able to change the default servers
 117 without recompiling.