minicom.1

小型通讯程序的C语言源程序的C语言源程序库

.\" This file Copyright 1992,93 Michael K. Johnson ([e-mail])
.\" It may be distributed under the GNU Public License, version 2, or
.\" any higher version.  See section COPYING of the GNU Public license
.\" for conditions under which this file may be redistributed.
.TH MINICOM 1 "9 Oct 1993" "Cohesive Systems" "Linux Programmer's Manual"
.SH NAME
minicom \- friendly serial communication program
.SH SYNOPSIS
.B minicom
.RI "[-soml] [-c on|off] [-a on|off]"
.br
.in 15
.RI "[-t term] [" configuration ]
.SH DESCRIPTION
.B minicom
is a communication program which somewhat resembles the shareware
program TELIX but is free with source code and runs under most unices.
Features include dialing directory with auto-redial, support for
UUCP-style lock files on serial devices, a seperate script language
interpreter, capture to file, multiple users with individual
configurations, and more.
.SH COMMAND-LINE
.TP 0.5i
.B -s
.BR S etup.
This is allowed for root only. When this option is used,
minicom does 
.I not 
initialize, but puts you directly into the
configuration menu. This is very handy if minicom refuses to start up
because your system has changed, or for the first time you run
minicom. For most systems, reasonable defaults are already compiled in.
.TP 0.5i
.B -o
Do not initialize. Minicom will skip the initialization code.  This
option is handy if you quitted from minicom without resetting, and
then want to restart a session. It is potentially dangerous though: no
check for lock files etc. is made, so a normal user could interfere
with things like uucp... Maybe this will be taken out later. For now
it is assumed, that users who are given access to a modem are
responsible enough for their actions.
.TP 0.5i
.B -m
Override command-key with the Meta or ALT key. This can also be
configured in one of minicom's menus, but if you use different
terminals all the time, of which some don't have a Meta or ALT key,
it's handy to set the default command key to Ctrl-A and use this option
when you have a keyboard supporting Meta or ALT keys.
.TP 0.5i
.B -l
.BR L iteral
translation of characters with the high bit set. With this flag on,
minicom will not try to translate the IBM line characters to ASCII,
but passes them straight trough. Many PC-unix clones will display
them correctly without translation (Linux in a special mode, Coherent
and Minix).
.TP 0.5i
.B -a
.BR A ttribute
usage. Some terminals, notably televideo's, have a rotten attribute
handling (serial instead of parallel). By default, minicom uses '-a
on', but if you are using such a terminal you can (must!)  supply the
option '-a off'. The trailing 'on' or 'off' is needed.
.TP 0.5i
.B -t
.BR T erminal
type. With this flag, you can override the environment TERM variable.
This is handy for use in the MINICOM environment variable; one can create
a special termcap entry for use with minicom on the console, that
initializes the screen to raw mode so that in conjunction with the -l
flag, the IBM line characters are displayed untranslated.
.TP 0.5i
.B -c
.BR C olor
usage. Some terminals (such as the Linux console) support color with
the standard ANSI escape sequences. Because there is apparently no
termcap support for color, these escape sequences are hard-coded into
minicom. Therefore this option is off by default.  You can turn it on
with '-c on'. This, and the '-m' option, are good candidates to put
into the MINICOM environment variable.
.PP
.RS 0.5i
When
.B minicom
starts, it first searches the MINICOM environment variable for
command-line arguments, which can be over-ridden on the command line.
Thus, if you have done
.PP
.RS 0.5i
.PD 0
MINICOM='-m -c on'
.PP
export MINICOM
.PP
.PD 1
.PP
.RE
or the equivalent, and start minicom, minicom will assume that your
terminal
.I has 
a Meta or <ALT> key and that color is supported.  If you then log in
from a terminal without color support, and you have set MINICOM in your
startup (.profile or equivalent) file, and don't want to re-set your
environment variable, you can type 'minicom -c off' and run without
color support for that session.
.RE
.TP 0.5i
.B configuration
The
.I configuration
argument is more interesting. Normally, minicom gets its defaults from
a file called "minirc.dfl". If you however give an argument to
minicom, it will try to get its defaults from a file called
"minirc.\fIconfiguration\fR\|".  So it is possible to create multiple
configuration files, for different ports, different users etc. Most
sensible is to use device names, such as tty1, tty64, sio2 etc. If a
user creates his own configuration file, it will show up in his home
directory as '.minirc.dfl'.
.SH USE
Minicom is windows-based. To popup a window with the function you
want, press Control-A (from now on, we will use C-A to mean
Control-A), and then the function key (a-z or A-Z). By pressing C-A
first and then 'z', a help screen comes up with a short summary of all
commands. This escape key can be altered when minicom is configured
(-s option or C-A O), but we'll stick to Control-A for now.
.PP
.PD 0
For every menu the next keys can be used:
.TP 0.75i
.B UP
arrow-up or 'k'
.TP 0.75i
.B DOWN
arrow-down or 'j'
.TP 0.75i
.B LEFT
arrow-left or 'h'
.TP 0.75i
.B RIGHT
arrow-right or 'l'
.TP 0.75i
.B CHOOSE
Enter
.TP 0.75i
.B CANCEL
ESCape.
.PD 1
.PP
The screen is divided into two portions: the upper 24 lines are the
terminal-emulator screen. In this window, ANSI or VT100 escape
sequences are interpreted. If MINIX emulation is chosen, this window
will be 25 lines long (if possible).  If there is a line left at the
bottom, a status line is placed there.  If this is not possible the
status line will be showed every time you press C-A.
.PP
.PD 0
Possible commands are listed next, in alphabetical order.
.TP 0.5i
.B C-A
Pressing C-A a second time will just send a C-A to the remote system.
If you have changed your "escape character" to something other than
C-A, this works analogously for that character.
.TP 0.5i
.B A
Toggle 'Add Linefeed' on/off. If it is on, a linefeed is added before
every carriage return displayed on the screen.
.TP 0.5i
.B B
Gives you a scroll back buffer. You can scroll up with \fBu\fP, down with
\fBd\fP, a page up with \fBb\fP, a page down with \fBf\fP, and if you have them
the \fBarrow\fP and \fBpage up/page down\fP keys can also be used.
.TP 0.5i
.B C
Clears the screen.
.TP 0.5i
.B D
Dial a number, or go to the dialing directory.
.TP 0.5i
.B E
Toggle local echo on and off (if your version of minicom supports it).
.TP 0.5i
.B F
A break signal is sent to the modem.
.TP 0.5i
.B G
Run script (Go). Runs a login script.
.TP 0.5i
.B H
Hangup.
.TP 0.5i
.B I
Toggle the type of escape sequence that the cursor keys send between
normal and applications mode. (See also the comment about the status
line below).
.TP 0.5i
.B J
Jump to a shell. On return, the whole screen will be redrawn.
.TP 0.5i
.B K
Clears the screen, runs kermit and redraws the screen upon return.
.TP 0.5i
.B L
Turn Capture file on off. If turned on, all output sent to the screen
will be captured in the file too.
.TP 0.5i
.B M
Sends the modem initialization string.
.TP 0.5i
.B O
Configure minicom. Puts you in the configuration menu.
.TP 0.5i
.B P
Communication Parameters. Allows you to change the baudrate, parity and
number of bits.
.TP 0.5i
.B Q
Exit minicom without resetting the modem.
.TP 0.5i
.B R
Recieve files. Choose from various protocols (external).
.TP 0.5i
.B S
Send files. Ditto.
.TP 0.5i
.B T
Choose Terminal emulation: Minix-Ansi(color)-vt100.
.TP 0.5i
.B W
Toggle linewrap on/off.
.TP 0.5i
.B X
Exit minicom, reset modem.
.TP 0.5i
.B Z
Pop up the help screen.
.PD 1
.SH "DIALING DIRECTORY"
By pressing C-A D the program asks:
.PP
.RS 0.5i
"Number to dial: (enter for dialing directory) " _
.RE
.PP
You can now directly enter a number to dial, or press <enter>.  If you
enter the phone (not dialing directory) number to dial, it will be
dialed, and if you press <enter> then the dialing directory will be
drawn.  You can add, delete or edit entries.  By choosing "dial" the
phone number of the highlighted entry will be dialed. While the modem
is dialing, you can press any key to cancel dialing. Your dialing
directory will be saved into a the file ".dialdir" in your home
directory.  You can scroll up and down with the arrow keys, but you
can also scroll complete pages by pressing the PageUp or PageDown key.
If you don't have those, use Control-B (Backward) and Control-F
(Forward).
.PP
The "edit" menu speaks for itself, but I will discuss it briefly here.
.PD 0
.TP 1.0i
.B A - Name
The name for this entry
.TP 1.0i
.B B - Number
and its telephone number.
.TP 1.0i
.B C - Dial string #