4
4
.\" It may be distributed under the GNU Public License, version 2, or
5
5
.\" any higher version. See section COPYING of the GNU Public license
6
6
.\" for conditions under which this file may be redistributed.
7
.TH MINICOM 1 "$Date: 2003/04/26 07:31:06 $" "User's Manual"
7
.TH MINICOM 1 "$Date: 2005/11/06 19:22:07 $" "User's Manual" "Version 2.1"
9
9
minicom \- friendly serial communication program
12
.RI "[-somMlwz8] [-c on|off] [-S script] [-d entry]"
12
.RI "[\-somMlwz8] [\-c on|off] [\-S script] [\-d entry]"
15
.RI "[-a on|off] [-t term] [-p pty] [-C capturefile] [" configuration ]
15
.RI "[\-a on|off] [\-t term] [\-p pty] [\-C capturefile] [" configuration ]
18
18
is a communication program which somewhat resembles the shareware
19
19
program TELIX but is free with source code and runs under most unices.
20
20
Features include dialing directory with auto-redial, support for
21
UUCP-style lock files on serial devices, a seperate script language
21
UUCP-style lock files on serial devices, a separate script language
22
22
interpreter, capture to file, multiple users with individual
23
23
configurations, and more.
28
28
Root edits the system-wide defaults in /etc/minirc.dfl with this option.
29
29
When it is used, minicom does
51
51
assumes that your Meta key sends the ESC prefix, not the other variant
52
52
that sets the highest bit of the character.
55
Same as -m, but assumes that your Meta key sets the 8th bit of the
55
Same as \-m, but assumes that your Meta key sets the 8th bit of the
56
56
character high (sends 128 + character code).
59
59
Use terminal status line. This only works on terminals that support it
60
60
and that have the relevant information in their \fItermcap\fP or
61
61
\fIterminfo\fP database entry.
65
65
translation of characters with the high bit set. With this flag on,
66
minicom will not try to translate the IBM line characters to ASCII,
67
but passes them straight trough. Many PC-unix clones will display
68
them correctly without translation (Linux in a special mode, Coherent
66
minicom will try to translate the IBM line characters to ASCII. Many PC-unix
67
clones will display charachter correctly without translation (Linux in a
68
special mode, Coherent and Sco).
72
71
Ditto but assume screen uses an ISO8859 character set.
75
74
Turns linewrap on at startup by default.
79
usage. Some terminals, notably televideo's, have a rotten attribute
80
handling (serial instead of parallel). By default, minicom uses '-a
78
usage. Some terminals, notably Televideo's, have rotten attribute
79
handling (serial instead of parallel). By default, minicom uses '\-a
81
80
on', but if you are using such a terminal you can (must!) supply the
82
option '-a off'. The trailing 'on' or 'off' is needed.
81
option '\-a off'. The trailing 'on' or 'off' is needed.
86
85
type. With this flag, you can override the environment TERM variable.
87
86
This is handy for use in the MINICOM environment variable; one can create
88
87
a special termcap entry for use with minicom on the console, that
89
initializes the screen to raw mode so that in conjunction with the -l
88
initializes the screen to raw mode so that in conjunction with the \-l
90
89
flag, the IBM line characters are displayed untranslated.
94
93
usage. Some terminals (such as the Linux console) support color with
95
94
the standard ANSI escape sequences. Because there is apparently no
96
95
termcap support for color, these escape sequences are hard-coded into
97
96
minicom. Therefore this option is off by default. You can turn it on
98
with '-c on'. This, and the '-m' option, are good candidates to put
97
with '\-c on'. This, and the '\-m' option, are good candidates to put
99
98
into the MINICOM environment variable.
103
102
Run the named script at startup. So far, passing username and password
104
to a startup script is not supported. If you also use the -d option to
105
start dialing at startup, the -S script will be run BEFORE dialing the
106
entries specified with -d.
103
to a startup script is not supported. If you also use the \-d option to
104
start dialing at startup, the \-S script will be run BEFORE dialing the
105
entries specified with \-d.
110
109
an entry from the dialing directory on startup. You can specify an
111
110
index number, but also a substring of the name of the entry. If you
115
114
entry specified after all other program initialization procedures are
121
to use. This overrrides the terminal port defined in the configuration
120
to use. This overrides the terminal port defined in the configuration
122
121
files, but only if it is a pseudo tty. The filename supplied must be of
123
122
the form (/dev/)tty[p-z/][0-f], (/dev/)pts[p-z/][0-f] or
124
123
(/dev/)pty[p-z/][0-f]. For example, /dev/ttyp1, pts/0 or /dev/ptyp2.
128
127
Open capture file at startup.
131
130
Disable the display of the online time in the status bar.
134
'8bit clean' and 'continuous' mode. '8bit clean' means Minicom let
133
7bit mode for terminals which aren't 8bit capable. 8bit is default if the
134
environment is configured for this via LANG or LC_ALL, 7bit otherwise.
135
137
8bit characters pass through without any modification. 'Continuous'
136
138
means no locate/attribute control sequences are inserted without
137
139
real change of locate/attribute. This mode is to display 8bit
504
508
establishes, minicom goes 'online'. If the server closes the socket, minicom
505
509
switches to 'offline' again.
507
.B *B - Lock file location
511
.B B - Lock file location
508
512
On most systems This should be /usr/spool/uucp. Linux systems use
509
513
/var/lock. If this directory does not exist,
510
514
minicom will not attempt to use lockfiles.
512
.B *C - Callin program
516
.B C - Callin program
513
517
If you have a uugetty or something on your serial port, it could be
514
518
that you want a program to be run to switch the modem cq. port into
515
519
dialin/dialout mode. This is the program to get into dialin mode.
517
.B *D - Callout program
521
.B D - Callout program
518
522
And this to get into dialout mode.
520
524
.B E - Bps/Par/Bits
622
624
.B F - Background Color (menu)
623
625
indicates the background color to use for
624
626
all the configuration windows in minicom. Note that minicom will not allow
625
you to set forground and background colors to the same value.
627
you to set foreground and background colors to the same value.
627
629
.B G - Foreground Color (term)
628
630
indicates the foreground color to use in the terminal window.
630
632
.B H - Background Color (term)
631
633
indicates the background color to use in
632
the terminal window. Note that minicom will not allow you to set forground
634
the terminal window. Note that minicom will not allow you to set foreground
633
635
and background colors to the same value.
635
637
.B I - Foreground Color (stat)
638
640
.B J - Background Color (stat)
639
641
indicates the color to use in for the
640
642
status bar. Note that minicom will allow you to set the status bar's
641
forground and background colors to the same value. This will effectively
642
make the status bar invisible but if these are your intensions, please
643
foreground and background colors to the same value. This will effectively
644
make the status bar invisible but if these are your intentions, please
645
647
.B K - History buffer size
742
744
.B "Save setup as.."
743
745
Save the parameters under a special name. Whenever Minicom is started
744
746
with this name as an argument, it will use these parameters. This
745
option is of course priviliged to root.
747
option is of course privileged to root.
748
750
Escape from this menu without saving. This can also be done with ESC.
750
752
.B "Exit from minicom"
751
Only root will see this menu entry, if he/she started minicom with the '-s'
753
Only root will see this menu entry, if he/she started minicom with the '\-s'
752
754
option. This way, it is possible to change the configuration without
753
755
actually running minicom.
764
766
the remote system's termcap initialization strings (is).
767
Minicom has now support for local languages. This means you can change most
769
Minicom has support for local languages. This means you can change most
768
770
of the English messages and other strings to another language by setting
769
the environment variable LANG. On September 2001 the supported languages
770
are Brazilian Portuguese, Finnish, Japanese, French, Polish, Czech, Russian
772
Turkish is under construction.
774
.SH "SECURITY ISSUES"
775
Since Minicom is run setuid root on some computers, you probably want to
776
restrict access to it. This is possible by using a configuration file
777
in the same directory as the default files, called "minicom.users".
778
The syntax of this file is as following:
781
<username> <configuration> [configuration...]
784
To allow user 'miquels' to use the default configuration, enter the
785
following line into "minicom.users":
791
If you want users to be able to use more than the default
792
configurations, just add the names of those configurations behind the
793
user name. If no configuration is given behind the username, minicom
794
assumes that the user has access to all configurations.
771
the environment variable LANG.
797
If minicom is hung, kill it with SIGTERM . (This means kill -15, or
774
If minicom is hung, kill it with SIGTERM . (This means kill \-15, or
798
775
since sigterm is default, just plain "kill <minicompid>". This will
799
776
cause a graceful exit of minicom, doing resets and everything.
800
You may kill minicom from a script with the command "! killall -9 minicom"
801
without hanging up the line. Without the -9 parameter, minicom first
777
You may kill minicom from a script with the command "! killall \-9 minicom"
778
without hanging up the line. Without the \-9 parameter, minicom first
802
779
hangs up before exiting.
804
781
Since a lot of escape sequences begin with ESC (Arrow up is ESC [ A),