doc.me

通讯程序源码

.\" format this thru tbl and the me macro package.
.po 1.0i				\" 1 inch page offset
.ps 10					\" 10 point type
.nh					\" no hyphenation
.ll 6.5i				\" line length (8.5in -1.0in, -1.0in)
.nr sf 3				\" section font is bold
.nr tf 1				\" title font is roman
.\" this macro is used to change the proportional font to 12 pitch
.\" some folks may need ".cs CW" in lieu of ".cs R 22"
.de CS
.cs R 22
..
.\" and this one puts things back
.de Cs
.cs R
..
.tp
.sp 7
.CS
.(l C
PPPPPP    CCCC    OOOO    MM   MM   MM   MM
P    P   C       O    O   M M M M   M M M M
PPPPPP   C       O    O   M  M  M   M  M  M
P        C       O    O   M     M   M     M
P         CCCC    OOOO    M     M   M     M
.)l
.Cs
.sp 7
.ce 11
Pcomm Reference Manual
.sp
version 2.0
.sp 3
 written by
.sp
Emmet P. Gray
.cc A
...!uunet!uiucuxc!fthood!egray
Acc .
fthood![e-mail]
.ce 0
.sp 6
Pcomm is a public domain telecommunication program for Unix that is
designed to operate similarly to the MSDOS program, ProComm.  ProComm (TM)
is copyrighted by Datastorm Technologies, Inc.  This is a completely new
program and contains no ProComm source code.  This is not a Datastorm
product.
.bp
.oh ''Pcomm Reference Manual'Page %'
.eh 'Page %'Pcomm Reference Manual''
.pn 1
.ep
.bp
.sh 1 INTRODUCTION 
.(x
\*($n INTRODUCTION
.)x
.lp
Pcomm is a public domain, menu driven, telecommunication program
designed to provide the same \*(lqease of use\*(rq as similar programs
available in MSDOS.  Some of its features are:
.br
.in +0.5i
.(b L
\(bu Large dialing directory
\(bu Full scripting feature
\(bu Automatic redial feature
\(bu Six built-in file transfer protocols
\(bu External file transfer program support
\(bu Data logging (log of the terminal session)
\(bu Printer logging
\(bu Screen dump to a file
\(bu Shell escapes to Unix
\(bu Help screen
\(bu Keyboard macros
\(bu User customization
\(bu Administrative logging of phone calls
\(bu Optional modem configuration per dialing directory entry
\(bu Administrative limits on long distance access
.)b
.in
.lp
Pcomm does not emulate any particular terminal.  Whatever terminal
you're on, is what the remote system \*(lqsees\*(rq.
.sh 2 Abbreviations
.(x
  \*($n Abbreviations
.)x
.lp
Pcomm uses the notation \*(lq^A-X\*(rq to mean control-A followed by the
letter X. The dash (\-) in the notation is just for clarity; it is not
included in the actual command sequence.  Also, there is no distinction
between upper and lower case letters.
.lp
The following abbreviations appear in Pcomm:
.br
.in +0.5i
.(b L
.TS
l l.
<CR>	carriage return key (sometimes labeled Enter)
<ESC>	escape key
<SPACE>	space bar
<DEL>	del key
<up>	up arrow key
<down>	down arrow key
LF	line feed character (control-J)
CR	carriage return character (control-M)
.TE
.)b
.in
.sh 2 Requirements
.(x
  \*($n Requirements
.)x
.lp
Pcomm will not run on terminals with a screen size of less than 80
columns by 24 lines or on terminals that lack cursor movement
capabilities.  For terminals without arrow keys, use the letter
\*(lqU\*(rq in place of \*(lqup arrow\*(rq and the letter \*(lqN\*(rq in
place of \*(lqdown arrow\*(rq (the letter \*(lqD\*(rq would have been a
more obvious choice, but, unfortunately, it is used elsewhere).
.sh 2 "Support files"
.(x
  \*($n Support files
.)x
.lp
Pcomm uses four support files, namely:
.br
.in +0.5i
.(b L
.TS
l l.
pcomm\^.\^dial_dir	the dialing directory
pcomm\^.\^extrnl	the external file transfer programs
pcomm\^.\^modem	the modem/TTY database
pcomm\^.\^param	the start-up default parameters
.TE
.)b
.in
.lp
There is a default directory (typically \*(lq/usr/local/lib/pcomm\*(rq)
where the \*(lqstandard\*(rq support files live.  Since the average user
won't have write permission on these files, it's assumed that they will
copy one or more of these standard files to their own directories and
edit them to suit their needs.
.lp
Pcomm can use the environmental variable \*(lqPCOMM\*(rq to search for
these \*(lqprivate\*(rq support files.  If used, the variable must
contain the path to the directory containing the files.  You can
\*(lqmix and match\*(rq the use of standard and private support files.
For example, the pcomm\^.\^modem file is rarely changed by the user so there
would be no need to copy that file to the private directory.
.lp
Pcomm also uses normal Unix shell scripts to perform the \*(lqchat\*(rq
sequences necessary to automatically log a user onto a system.
.lp
The following directories are searched to find the support files and the
shell scripts:
.br
.in +0.5i
.(b L
1) directory given with the \*(lq\-d\*(rq option
2) directory in the PCOMM environmental variable
3) the current working directory
4) the default directory (compiled into Pcomm)
.)b
.in
.bp
.\"					force "chapter" heading to odd page
.if e \{
.ep
.bp\}
.sh 1 "RUNNING PCOMM"
.\"					put a blank line in the index
.(x
 
.)x _
.(x
\*($n RUNNING PCOMM
.)x
.lp
Pcomm has the following command line syntax.
.sp
.in +0.5i
.(b L
pcomm [\-d directory] [\-f system name] [\-a auxiliary file]
.br
.ti +\w'pcomm 'u
[-e|o|n] [-w word length] [-b baud rate] [-p phone number]
.)b
.in
.lp
The \*(lq\-d\*(rq option allows you to specify an additional path to be
used when searching for the Pcomm support files.  This option is often
useful for \*(lqborrowing\*(rq someone else's dialing directory.
.lp
The \*(lq\-f\*(rq option is used to specify automatic dialing of an entry
in the dialing directory.  The name field in the dialing directory
(described later) is checked against the string given on the command
line.  If a match is found, that entry is automatically dialed.  The
match does not consider upper and lower case differences.
.lp
The \*(lq\-a\*(rq option is used to specify a script file to be
\*(lqplayed\*(rq prior to dialing, to specify the TTY to be use, or to
specify the modem to be used.  This feature can be used to customize
Pcomm options or perform unattended operations.
.lp
The remaining options are used to set the parity, data bits, baud rate,
and telephone number from the command line.
.br
.in +0.5i
.(b L
.TS
l l.
\-e	Set the parity to even
\-o	Set the parity to odd
\-n	Set the parity to none
\-w	Set the word length (number of data bits)
\-b	Set the baud rate
\-p	Dial this number
.TE
.)b
.in
.sh 2 "Hot key"
.(x
  \*($n Hot key
.)x
.lp
Pcomm uses a \*(lqhot key\*(rq to precede each command.  (The value of
the hot key is a user tunable parameter, but for the purpose of this
document we'll assume the hot key is defined as control-A).
.lp
The hot key is used to put Pcomm in the command mode.  For example, to
get the help screen, you type control-A (to get to the command mode)
then the number 0 (to display the help screen).  When a command is
completed, Pcomm returns to the terminal mode.
.lp
.ft I
NOTE:\ \ While in the command mode, the communication with the remote
system is temporarily suspended.
.ft
.sh 2 "Status line"
.(x
  \*($n Status line
.)x
.lp
Whenever Pcomm is in the command mode (or is not currently connected to
a remote) a status line is displayed at the bottom of the screen.  A
typical status line might look like this:
.br
.if n .po 0				\" table may be more than 6.5in wide
.if n .ll 8.5i
.CS
.(b L
.TS
box center;
l|l|l|l|l|l|l|l.
^A-0 HELP 	No TTY 	FDX 	1200 E71 	LOG OFF 	PTR OFF 	CR  	CR  
.TE
.)b
.Cs
.if n .po 1.0i
.if n .ll 6.5i
.lp
The eight fields of the status line are:
.br
.in +0.5i
.(b L
\(bu help screen command (or a temporary message)
\(bu name of the TTY device in use
\(bu duplex mode (FDX = full duplex, HDX = half duplex)
\(bu current connection settings (not necessarily DTE speed)
\(bu status of data logging option
\(bu status of printer logging option
\(bu incoming CR translation
\(bu outgoing CR translation
.)b
.in
.lp
.ft I
NOTE:\ \ If the DTE (Data Terminal Equipment) interface speed is locked,
the status line will show the \*(lqconnected\*(rq speed rather than the
speed of the serial port.
.ft
.sh 2 "Help screen"
.(x
  \*($n Help screen
.)x
.lp
The help screen gives a brief review of all the available commands.  To
access the help screen type ^A and \*(lq0\*(rq (zero).  The typical help
screen will look like this:
.br
.if n .po 0				\" table may be more than 6.5in wide
.if n .ll 8.5i
.CS
.(b L
.TS
box center;
c s s
c c c
l l l.
.sp
P C O M M    H E L P
.sp
_
.sp
Major Functions	Utility Functions	File Functions
.sp
 Dialing Directory. ^A-D	Program Info .... ^A-I	Send Files .... ^A-<up>
 Auto Redial ...... ^A-R	Setup Screen .... ^A-S	Receive Files . ^A-<down>
 Keyboard Macros .. ^A-M	Change Directory. ^A-B	Pass Thru Mode. ^A-T
 Line Settings .... ^A-P	Clear Screen .... ^A-C	Directory ..... ^A-F
 Exit Pcomm ....... ^A-X	Toggle Duplex ... ^A-E	Screen Dump ... ^A-G
 Unix Gateway ..... ^A-4	Hang Up Phone ... ^A-H	Start Data Log. ^A-1
 Command Files .... ^A-5	Printer On/Off .. ^A-L	Toggle Log .... ^A-2
	Toggle CR-CR/LF . ^A-3
	Break Key ....... ^A-7
.sp
.T&
c s s.
Press any key to continue
.TE
.)b
.Cs
.if n .po 1.0i
.if n .ll 6.5i
.sh 2 "Exit Pcomm"
.(x
  \*($n Exit Pcomm
.)x
.lp
To exit Pcomm, you type ^A and \*(lqx\*(rq to access the exit window.
.br
.in +0.5i
.CS
.(b L
.TS
box;
l.
   Exit
.sp
.\"                           spaces out to here
   Exit to Unix? (y/n): _     
.sp
.TE
.)b
.Cs
.in
.lp
To exit, you press the letter \*(lqy\*(rq (carriage return not required).
.bp
.if e \{
.ep
.bp\}
.sh 1 "SETUP SCREENS"
.(x
 
.)x _
.(x
\*($n SETUP SCREENS
.)x
.lp
Pcomm allows you to change many of the default parameters.  The setup
screen is accessed by typing ^A and \*(lqs\*(rq.  The following screen
shows the sub-menu choices:
.br
.CS
.(b L
.(c
------------------------- Setup Menu ----------------------------
.sp
                      1) TTY Setup
                      2) Modem Setup
                      3) Terminal Setup
                      4) General Setup
                      5) ASCII Transfer Setup
                      6) External Protocol Setup
                      S) Save setup to disk
.sp
-----------------------------------------------------------------
OPTION ==> _                                  Press <ESC> to exit
.)c
.)b
.Cs
.lp
To select one of the sub-menu choices, you type the number (or letter)
at the \*(lqOPTION ==>\*(rq prompt.  To exit from a sub-menu and return
to this setup menu screen, you press the escape key.
.lp
Changes made affect the current Pcomm session only.  To make the changes
become the default, you select the \*(lqs\*(rq option.
.sh 2 Prompting
.(x
  \*($n Prompting
.)x
.lp
There are several different types of prompts used in the setup screens.
The prompts use the bottom two lines on the display for user input and
to give more information on what is being asked.  Pcomm will beep at any
illegal input.  The escape key <ESC> will abort any prompt.  The prompt
types are:
.sp
.in +0.5i
\(bu Character prompt.  Asks you to input a single character.
.br
.in +\w'\(bu 'u
.ti -\w'\(bu 'u
\(bu String prompt.  Asks you to input a word or group of characters.
.in 0.5i
.br
\(bu Numeric prompt.  Asks you for a number.
.br
.in +\w'\(bu 'u
.ti -\w'\(bu 'u
\(bu Menu prompt.  Shows a selection and allows you to choose the
current selection by pressing the carriage return or change the
selection by pressing the space bar.
.in 0
.sh 2 "TTY setup"
.(x
  \*($n TTY setup
.)x
.lp
The TTY setup allows you to assign the serial ports that Pcomm is
allowed to use, and what is attached to each port.  A typical TTY setup
screen might look like this:
.br
.CS
.(b L
.(c
-------------------------- TTY Setup ----------------------------
.sp
            TTY name        Modem name     Locked speed
.sp
            1) tty10        HAYES               0
            2) tty11        HAYES               0
            3) tty12        DIRECT              0
            4) tty13        TELEBIT             38400
            5) tty13        TELEBIT_V.32        38400
            6) tty13        TELEBIT_PEP         38400
            7)                                  0
            8)                                  0
            9)                                  0
           10)                                  0
.sp
            A) Add a TTY entry                   
            D) Delete a TTY entry                
.sp
-----------------------------------------------------------------
OPTION ==> _                                Press <ESC> to return
.)c
.)b
.Cs
.lp
You may edit an entry by typing the entry number at the prompt.  To add
an entry, you type \*(lqA\*(rq at the prompt, etc.
.lp
The TTY setup fields are:
.ba +0.5i
.lp
1) TTY name.  This is the name of the serial port that Pcomm will be
allowed to use.  Notice that the path component of the name,
\*(lq/dev/\*(rq is not used.
.lp
2) Modem name.  This a key word that is used later to link the modem
database with the TTY database.  The name could be any combination of
letters or numbers (both upper and lower case).
.lp
.ft I
NOTE:\ \ All hard-wired ports (ports without modems attached) \fBmust\fP
use the word \*(lqDIRECT\*(rq for the modem name.
.ft R
.lp
3) Locked speed.  Normally Pcomm will use the baud rate in the dialing
directory when talking to the modem.  If the locked speed is non-zero,
then the baud rate specified is the only one that will ever be use.  The
baud rate is selected from a \*(lqmenu prompt\*(rq.  See Appendix C for
more information about the use of this feature.
.lp
.ft I
NOTE:\ \ It is often best to put the fastest modem/TTYs at the end of the
TTY database.
.ft
.ba
.sh 2 "Modem setup"
.(x
  \*($n Modem setup
.)x
.lp
The modem setup contains the commands to make the modem dial, hang up
the phone, etc.  A typical modem setup screen might look like this:
.br
.CS
.(b L
.(c
-------------------------- Modem Setup --------------------------