add/re-enable at_wini debug output
[minix3.git] / man / man1 / term.1
blob4ec1ce3055404b6076ee6cbcac9cf6808b7b23fe
1 .TH TERM 1
2 .SH NAME
3 term \- turn PC into a dumb terminal [IBM]
4 .SH SYNOPSIS
5 .in +.5i
6 .ti -.5i
7 \fBterm\fR [\fIbaudrate\fR]\fR [\fIparity\fR] [\fIbits_per_character\fR]
8 [\fB\-\fIdial_string\fR] [\fB\-c\fIkcmd\fR] [\fIdevice\fR]\fR
9 .in -.5i
10 .br
11 .de FL
12 .TP
13 \\fB\\$1\\fR
14 \\$2
16 .de EX
17 .TP 20
18 \\fB\\$1\\fR
19 # \\$2
21 .SH EXAMPLES
22 .EX "term 2400" "Talk to modem at 2400 baud"
23 .EX "term 1200 7 even" "1200 baud, 7 bits/char, even parity"
24 .EX "term 8 9600 /dev/tty01" "9600 baud, 8 bits/char, no parity, use tty01"
25 .EX "term -atdt12345 /dev/tty01" "Start with a command to dial out"
26 .EX "term -cH'echo Hello World!' ..." "Bind a shell command to the 'H' key"
27 .SH DESCRIPTION
28 .PP
29 \fITerm\fR allows 
30 \s-1MINIX 3\s-1
31 to talk to a terminal or modem over RS232 
32 port 1.  The program first sets the baudrate, parity and character length, 
33 and then forks.
34 The parent sits in a loop copying from \fIstdin\fR (usually the console's
35 keyboard), to the terminal or modem (\fI/dev/tty00\fR).  
36 The child sits in a loop
37 copying from the terminal or modem (\fI/dev/tty00\fR) to standard output.  
38 Thus when
39 RS232 port 1 is connected to a modem, every keystroke typed on the keyboard
40 is sent to the modem, and every character arriving from the modem is displayed.
41 Standard input and output may be redirected, to provide a primitive file
42 transfer program, with no checking.  Any argument that starts with
43 .B \-at
44 is sent out to the modem, usually to dial out.  \fITerm\fP accepts
45 several commands that are formed by typing the escape character, CTRL-],
46 and a letter.  Type CTRL-]? to see a list of commands.  The subshell command
47 is very important, it allows you to type in a ZMODEM command to transfer
48 data.  Do not quit \fIterm\fR to do this, or your modem line will be reset!
49 \fITerm\fP keeps the modem line open on file descriptor 9 while running the
50 subshell, so you can type
51 .PP
52 .in +.5i
53 <&9 >&9
54 .in -.5i
55 .PP
56 at the end of your ZMODEM command to connect it to the modem.  With
57 .BI \-c kcmd
58 arguments you can bind shell commands to keys.  The character just after
59 .BR \-c
60 is the key to use, the rest of the characters form the command to bind to the
61 key.  This command also has the modem open on file descriptor 9.
62 .LP
63 Important note: to use \fIterm\fR, it is essential that 
64 \fI/etc/ttytab\fR is configured so
65 that there is no login session started on the modem line.
66 If there is, both the login session and
67 term will try to read from the modem, and nothing will work.
68 .SH "SEE ALSO"
69 .BR rz (1),
70 .BR sz (1).