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