|
|
1.1 root 1: % run this through LaTeX with the appropriate wrapper
2:
3: \chapter {UNIX Implementation}\label{unixvt}
4: The Virtual Terminal (VT) standard is the OSI terminal service.
5: Included in the release is an implementation of VT that is roughly comparable
6: to an average \pgm{telnet} implementation.
7:
8: The implementation included runs only on Berkeley \unix/.
9:
10: \section {Implementation}\label{unixvt:code}
11: If you have access to the source tree for this release,
12: the directory \file{vt/} contains the code for the responder and initiator.
13:
14: \subsection {The Initiator}
15: There is currently one initiator which uses VT: \man vt(1c).
16: Supported is the VT TELNET profile from the NIST OSI Implementors Workshop
17: Agreements.
18:
19: The \pgm{vt} program is an interactive VT initiator
20: which prompts the user for commands.
21: Command mode is entered by typing an escape character
22: (``\verb"^]"'' by default).
23:
24: \subsubsection {Commands}
25: Here are the commands to \pgm{vt}:
26: \begin{describe}
27: \item[ayt]
28: Sends an ``are you there'' message to the remote login server.
29:
30: \item[break]
31: Flushes data queued in both directions and interrupts the remote process.
32:
33: \item[close]
34: Terminates the association with the terminal service.
35:
36: \item[escape]
37: Set the ``escape character'' used to enter command mode.
38: Control characters may be specified as ``\verb"^"'' followed by a single
39: letter (e.g., ``control-X'' is ``\verb"^X"'').
40:
41: \item[help {\tt [command]}]
42: Prints help information.
43: For detailed information, try ``\verb*"help ?"''.
44:
45: \item[open {\tt host user [account]}]
46: Associates with the temrinal service.
47:
48: \item[quit]
49: Terminates the association with the terminal service and exits.
50:
51: \item[set {\tt variable value}]
52: Displays or changes variables.
53: For detailed information, try ``\verb*"set ?"''.
54:
55: \item[status]
56: Shows the current status.
57:
58: \item[suspend]
59: Suspends \pgm{vt}.
60: This works only if the program was invoked under a shell with job control
61: (e.g., \pgm{csh}).
62: \end{describe}
63:
64: \subsubsection {Variables}
65: Here are the variables which effect \pgm{vt}'s behavior.
66: \begin{describe}
67: \item[crmod]
68: This enables the mapping of CR characters received from the
69: remote host into CR-LF pairs.
70: This does not affect those characters typed by the user,
71: only those received.
72: Boolean (values: {\bf on\/} or {\bf off\/}).
73:
74: \item[debug]
75: This enables voluminous output during file transfers,
76: among other things. Boolean.
77:
78: \item[echo]
79: Determines whether echoing is done locally or remotely.
80: Values: \verb"local", \verb"remote".
81:
82: \item[escape]
83: Sets the escape character.
84: Value: any single character or ``\verb"^"'' followed by a character.
85:
86: \item[options]
87: Determines if option processing is shown.
88: Boolean.
89:
90: \item[repetoire]
91: Determines which character set (repetoire) shall be used.
92: Values: \verb"ascii", \verb"transparent" (binary).
93:
94: \item[tracelevel]
95: This enables the tracing of VT.
96: Values: \verb"none", \verb"exceptions", \verb"notice", \verb"pdus",
97: \verb"trace", and \verb"debug".
98:
99: \item[tracefile]
100: This defines the file where tracing information is appended.
101: Values: any filename, or \verb"-" for the diagnostic output.
102:
103: \item[verbose]
104: This enables printing of informative diagnostics during operation. Boolean.
105:
106: \item[{\em xyz\/}sapfile]
107: This defines the file where {\em xyz\/}PDU tracing information is appended.
108: Values: any filename, or \verb"-" for the diagnostic output.
109:
110: \item[{\em xyz\/}saplevel]
111: This enables tracing of the {\em xyz\/} module.\\
112: Values: \verb"none", \verb"exceptions", \verb"notice", \verb"pdus",
113: \verb"trace", and \verb"debug".
114: \end{describe}
115:
116: \subsubsection {Options}
117: Here are the command line options:
118: \begin{describe}
119: \item[-B]
120: Do not negotiate use of the VT BREAK functional unit.
121:
122: \item[-D]
123: Use the VT asynchronous DEFAULT profile rather than the TELNET profile.
124:
125: \item[-F {\em logfile}]
126: Sets the logging file to be used.
127:
128: \item[-g]
129: Use only the G0 character set for the {\it ascii\/} repetoire (graphics only).
130:
131: \item[-f]
132: Inhibits reading of the user's \file{\$HOME/.vtrc} file on startup.
133: \end{describe}
134:
135: \subsection {The Responder}
136: The \man vtd(8c) program implements the terminal service.
137: Supported is the VT TELNET profile from the NIST OSI Implementors Workshop
138: Agreements.
139:
140: \subsubsection {Options}
141: Here are the command line options:
142: \begin{describe}
143: \item[-F {\em logfile}]
144: Sets the logging file to be used.
145:
146: \item[-d {\em level}]
147: Sets the debug level from \verb"0" (none) to \verb"7" (verbose).
148: \end{describe}
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.