1
0

drawterm 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124
  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 -a
  8. .I authaddr
  9. ]
  10. [
  11. .B -c
  12. .I cpuaddr
  13. ]
  14. [
  15. .B -d
  16. depth
  17. ]
  18. [
  19. .B -r
  20. root
  21. ]
  22. [
  23. .B -nm
  24. ]
  25. .SH DESCRIPTION
  26. .I Drawterm
  27. is
  28. .I not
  29. a Plan 9 program.
  30. It is a program that users of non-Plan 9 systems can use
  31. to establish graphical
  32. .IR cpu (1)
  33. connections with Plan 9 CPU servers.
  34. Just as a real Plan 9 terminal does,
  35. .I drawterm
  36. serves its local name space
  37. as well as some devices (the keyboard, mouse, and screen)
  38. to a remote CPU server, which mounts this name space
  39. on
  40. .B /mnt/term
  41. and starts a shell.
  42. Typically, either explicitly or via the profile, one uses the shell
  43. to start
  44. .IR rio (1).
  45. .PP
  46. By default,
  47. drawterm
  48. uses the CPU server
  49. .B CPUSERV
  50. and the authentication server
  51. .BR AUTHSERV .
  52. The
  53. .B -a
  54. and
  55. .B -c
  56. options specify alternate servers.
  57. (Edit the source to set appropriate local values for the variables
  58. .B AUTHSERV
  59. and
  60. .BR CPUSERV ).
  61. .PP
  62. On Windows systems, the file system served by the
  63. terminal (and mounted on
  64. .BR /mnt/term )
  65. is the tree rooted at
  66. .BR c:/ .
  67. The
  68. .B -r
  69. option specifies a different file system root.
  70. In Windows, the depth of the virtual screen
  71. provided by
  72. drawterm
  73. matches the depth of the actual screen.
  74. To present a screen with a different depth, use the
  75. .B -d
  76. option.
  77. Both options do nothing on non-Windows systems.
  78. .PP
  79. The
  80. .B -n
  81. option causes
  82. drawterm to prompt for authentication via
  83. .IR netkey -style
  84. challenge/response rather than using
  85. the password-based protocol typically used
  86. by terminals.
  87. .PP
  88. By default, drawterm queues mouse events to
  89. guard against lost events due to network latency.
  90. The
  91. .B -m
  92. option turns this behavior off.
  93. .PP
  94. Drawterm has been ported to
  95. Digital Unix,
  96. Irix,
  97. Linux,
  98. Solaris,
  99. and
  100. Windows.
  101. Binaries are kept in
  102. .BR /sys/src/cmd/unix/drawterm/bin .
  103. .SH SOURCE
  104. .B /sys/src/cmd/unix/drawterm
  105. .SH DIAGNOSTICS
  106. The Unix versions of drawterm print diagnostics
  107. to standard error.
  108. The Windows version displays message boxes.
  109. .SH "SEE ALSO
  110. .IR cpu (1),
  111. .IR rio (1)
  112. .SH BUGS
  113. Although at first
  114. .I drawterm
  115. may seem like a Plan 9 terminal, in fact it is just a way to provide a CPU server
  116. with some terminal devices.
  117. The difference is important because one cannot run terminal-resident programs
  118. when using
  119. .IR drawterm .
  120. The illusion can be improved by delicate adjustments in
  121. .BR /usr/$user/lib/profile .
  122. .PP
  123. It would be nice to be able to change the default servers
  124. without recompiling.