minix/commands/term/term.1

   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
  15 ..
  16 .de EX
  17 .TP 20
  18 \\fB\\$1\\fR
  19 # \\$2
  20 ..
  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).