doc.me

通讯程序源码

 File name\&: main.c 
 File size\&: 4420
 Error check method\&: CRC
 Est transfer time\&: 0:00:50
 Block count\&: 5
 Percent complete\&: 11.2%
 Bytes transferred\&: 640
 Errors this block\&: 0
 Total error count\&: 0
 Last message\&: NONE
.sp
.T&
c.
Press <ESC> to abort
.TE
.)b
.Cs
.in
.lp
As the transfer progresses, the \*(lqblock count\*(rq, \*(lqpercent
complete\*(rq, and \*(lqbytes transferred\*(rq fields will be
continuously updated.  If errors occur the \*(lqerrors this block\*(rq
and \*(lqtotal error count\*(rq fields will be updated and the \*(lqlast
message\*(rq field will contain a message about the error.
.lp
At the end of the transfer, Pcomm will beep and return to the terminal
mode.  If an error occurred and the transfer was aborted, you will be
prompted to acknowledge the error by pressing a key before returning to
the terminal mode.
.sh 2 "Receive files"
.(x
  \*($n Receive files
.)x
.lp
To receive a file (or group of files) from a remote system, you'll have
to first instruct the remote system, then type ^A-\*(lqdown arrow\*(rq.
Receiving a file is basically the same as sending a file.
.lp
.ft I
NOTE:\ \ Some systems do not pad the end of the file with control-Z's and
therefore files might grow in length when received.
.ft
.sh 2 "Pass thru mode"
.(x
  \*($n Pass thru mode
.)x
.lp
The pass through mode is used when you have two or more machines in a
communications daisy chain.  The following diagram shows an example of
this type of arrangement:
.br
.in +0.5i
.(b L
.TS
|c|c|c|c|c|.
_		_		_
IBM PC 		Unix 		IBM PC 
running 	<---- 	running 	<---- 	running 
ProComm 	---->	Pcomm 	---->	RBBS 
_		_		_
.TE
.)b
.in
.lp
If a file is to be transferred from the last machine to the first
machine, the middle machine must appear completely transparent.  The
middle machine must \*(lqforward the data\*(rq without altering it in
any way.  The pass through mode \*(lqexpires\*(rq after a designated
period of inactivity, after which the user is returned to the terminal
mode.
.lp
To access the pass through mode, you type ^A-T.  The following screen
will appear:
.br
.CS
.(b L
.TS
box center;
l.
   Pass Thru Mode
.sp
.\"                                                           spaces out to here
   Enter the expiration time (5-60 sec) : _                   
.sp
.TE
.)b
.Cs
.lp
.ft I
NOTE:\ \ While in the pass through mode, no Pcomm command to the middle
machine will be honored.  Therefore, the \fBonly\fP way to exit this
mode is to not type anything on the keyboard until the expiration period
has elapsed.
.sp
NOTE:\ \ The baud rates to and from the middle machine need not be the
same, however the slowest speed determines the overall speed of the
transfer (the weakest link in the chain).
.ft R
.sh 2 Directory
.(x
  \*($n Directory
.)x
.lp
To obtain a listing of a directory on the local system while still
running Pcomm, you type ^A-F.  The following screen will appear:
.br
.CS
.(b L
.TS
box center;
l.
   List Directory
.sp
.\"                                                           spaces out to here
   Current directory: /usr/egray                              
   File spec (wildcards allowed): _ 
.sp
.TE
.)b
.Cs
.lp
Abbreviations known to the shell are valid.  Output is sent through a
\*(lqmore\*(rq like program.
.lp
.ft I
NOTE:\ \ Since we're really doing a popen() to the \*(lqls\*(rq command,
additional command line options are also valid.
.ft
.sh 2 "Screen dump"
.(x
  \*($n Screen dump
.)x
.lp
To dump the contents of the current screen (minus any windows showing)
you type ^A-G.  The contents of the screen are written to the file
specified in the general setup for this purpose.  If the file already
exists, the screen contents are appended to the file.  The message
\*(lqscreen dump\*(rq will briefly appear in the status line.
.lp
.ft I
NOTE:\ \ The screen contents are subject to the available VCS (video
command sequence) emulation, so an exact representation is not
guaranteed.
.ft
.sh 2 "Start data logging"
.(x
  \*($n Start data logging
.)x
.lp
To start the data logging, or change the file used for data logging, you
type ^A-1.  The following screen will appear:
.br
.CS
.(b L
.TS
box center;
l.
   Start Data Logging
.sp
.\"                                                           spaces out to here
   Default log file: pcomm.log                                
   New log file: _
.sp
.TE
.)b
.Cs
.lp
To keep the default file, just press a carriage return at the prompt,
otherwise, enter a new file name.  If the file already exits, the new
data is appended to the file.
.lp
The status of the logging is shown in the status line.
.lp
.sh 2 "Toggle logging"
.(x
  \*($n Toggle logging
.)x
.lp
To temporarily suspend data logging or to start it again without being
prompted for the file name, you type ^A-2.
.bp
.if e \{
.ep
.bp\}
.sh 1 "DIALING WINDOW"
.(x
 
.)x _
.(x
\*($n DIALING WINDOW
.)x
.lp
While Pcomm is dialing another system, a screen similar to the following
is shown:
.sp
.if n .po 0				\" table may be wider than 6.5in
.if n .ll 8.5i
.CS
.(b L
.TS
box center;
c
n.
.sp
D I A L I N G      W I N D O W
.sp
_
.sp
.\"                                   spaces out to here
System name\&: C Board                
Pass number\&: 1
Elapse time this try\&: 4
Time at start of dial\&: 14:53:36
Time at start of this try\&: 14:53:36
Connect delay time\&: 35
Redial delay time\&: 5
Auxiliary\&:
Result of last try\&:
.T&
c.
.sp
 <SPACE>: Recycle    <DEL>: Remove from queue    E: Change delays  
.sp
Press <ESC> to abort
.TE
.)b
.Cs
.if n .po 1.0i
.if n .ll 6.5i
.lp
Items in the window are continuously updated to show the progress of the
dialing attempt.
.lp
The options available during the dialing window are:
.ba +0.5i
.lp
SPACE) Press the space bar to stop the dialing of the current entry and
go on to the next entry in the queue.  If there is only one entry in the
queue, that number is redialed.
.lp
DEL) Press the DEL key to remove the current number from the queue.
.lp
E) Press the letter \*(lqE\*(rq to change the connect delay time, or the
redial delay time (the pause between dialing attempts).  You will be
prompted to save the changes to disk.
.lp
.CS
.(b L
.TS
box center;
l.
   Change Delay Times
.sp
.\"                                        spaces out to here
   Current connect delay time: 35          
   Current redial delay time: 5
.sp
   New connect delay: _
   New redial delay:
.sp
.TE
.)b
.Cs
.ft I
NOTE:\ \ While the DEL and E options are being processed, the dialing is
temporarily suspended.
.ft
.ba
.bp
.if e \{
.ep
.bp\}
.sh 1 "SCRIPT COMMANDS"
.(x
 
.)x _
.(x
\*($n SCRIPT COMMANDS
.)x
.lp
Pcomm doesn't have a built-in script language, instead it uses Unix
shell scripts (Bourne shell, C shell, Korn shell, etc) to perform the
necessary \*(lqchat\*(rq sequences to log a user on to a remote system.
.lp
Since shell scripts are run \*(lqoutside\*(rq of Pcomm, the
\*(lqpcomm_cmd\*(rq program is used to transmit command sequences to
Pcomm.  For example, a script can contain a line such as \*(lqpcomm_cmd
data_log on\*(rq to turn on the data logging feature.
.lp
Shell scripts specified in the dialing directory are run \fBafter\fP the
connection to the remote system, while script specified on the command
line (with the \-a option) are run \fBbefore\fP the connection is made.
You can make a shell script work under both situations by using the
\*(lqpcomm_cmd is connected\*(rq command.  See the third example in
section 8.4.
.lp
You may hit the <ESC> key at any time to abort an auto-login script
before it has completed.
.lp
.ft B
WARNING:\ \ Any file that has a \*(lqclear text\*(rq (un-encrypted)
version of your password is a significant security threat.  You should
remove the read permission to all others.
.ft
.lp
In order to assist in the creation of auto-login scripts, the following
external programs have been provided.
.sh 2 "Pcomm_cmd command"
.(x
  \*($n Pcomm_cmd command
.)x
.lp
Pcomm_cmd is an external Pcomm support program.  It is used from inside
shell scripts to access Pcomm commands, such as \*(lqpcomm_cmd send
xmodem junk\*(rq for sending the file \*(lqjunk\*(rq to the remote using
the xmodem file transfer protocol.
.lp
The following command line options are supported.
.in +1.0i
.sp
.ti -0.5i
SET BAUD [ 300 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 ]
.br
Set the baud rate for the current connection.  This feature is for use
with the DIAL MANUAL command, since the baud rate information in the
dialing directory entries overrides this value. 
.sp
.ti -0.5i
SET PARITY [ EVEN | ODD | NONE ]
.br
Set the parity for the current connection.  For use with the DIAL MANUAL
command.
.sp
.ti -0.5i
SET DATA_BITS [ 7 | 8 ]
.br
The number of data bits (word length) used for the current connection.
For use with the DIAL MANUAL command.
.sp
.ti -0.5i
SET STOP_BITS [ 1 | 2 ]
.br
The number of stop bits for the current connection.  For use with the
DIAL MANUAL command.
.sp
.ti -0.5i
SET DUPLEX [ HALF | FULL ]
.br
Set the duplex mode (local echo).  The HALF option is used if the remote
system does not echo characters as they are typed.
.sp
.ti -0.5i
SET AUX filename
.br
Use the argument as the auxiliary file associated with the current
connection.  Since chaining of scripts is not supported, this feature
would only be used to set the TTY or modem.
.sp
.ti -0.5i
SET HOT_KEY [1-256]
.br
Change the decimal value of the \*(lqhot key\*(rq to this value.
.sp
.ti -0.5i
SET ASCII_HOT string
.br
Change the ASCII representation of the hot key to the given argument.  The
length of the string must be no more than 4 characters wide.
.sp
.ti -0.5i
SET FLOW_CTRL [ XON/XOFF | NONE ]
.br
Set the flow control between the local and remote systems to either XON/XOFF
or NONE.
.sp
.ti -0.5i
SET CR_IN [ CR | CR/LF ]
.br
Translate in-comming carriage returns carriage return followed by a line
feed, or pass the carriage return through unchanged.
.sp
.ti -0.5i
SET CR_OUT [ CR | CR/LF ]
.br
Translate out-going carriage returns to CR or CR/LF.
.sp
.ti -0.5i
SET LOGFILE filename
.br
Change the name of the default log file.  For use with the DATA_LOG command.
.sp
.ti -0.5i
SET DUMPFILE filename
.br
Change the name of the screen dump file.  For use with the SCREEN_DUMP 
command.
.sp
.ti -0.5i
SET STRIP [ YES | NO ]
.br
Should the in-comming data be stripped to 7 bits?
.sp
.ti -0.5i
SET LOCAL_ECHO [ YES | NO ]
.br
Should data be shown on the screen during ASCII uploads?
.sp
.ti -0.5i
SET EXPAND [ YES | NO ]
.br
Should blank lines be \*(lqexpanded\*(rq to a line with a single space?
For use only during ASCII uploads.
.sp
.ti -0.5i
SET CR_DELAY [ 0 | 100 | 150 ]
.br
Set the delay for the carriage returns for ASCII uploads.
.sp
.ti -0.5i
SET PACE [ YES | NO ]
.br
Should the entire upload be artificially slowed down?  For use during ASCII
uploads.
.sp
.ti -0.5i
SET CR_UP [ NONE | ADD_LF | STRIP ]
.br
Controls the translation of carriage returns during ASCII uploads.
.sp
.ti -0.5i
SET LF_UP [ NONE | ADD_CR | STRIP ]
.br
Controls the translation of line feeds during ASCII uploads.
.sp
.ti -0.5i
SET TIMER [5-150]
.br
Controls the timer (in seconds) that detects the end of an ASCII download.
.sp
.ti -0.5i
SET CR_DN [ NONE | ADD_LF | STRIP ]
.br
Controls the translation of carriage returns during ASCII downloads.
.sp
.ti -0.5i
SET LF_DN [ NONE | ADD_CR | STRIP ]
.br
Controls the translation of line feeds during ASCII downloads.
.sp
.ti -0.5i
QUERY TTY_NAME
.br
Returns the name of the current TTY in use or NONE.
.sp
.ti -0.5i
QUERY MODEM_NAME
.br
Returns the name of the current modem in use or NONE.
.sp
.ti -0.5i
IF CONNECTED
.br
Returns a 1 if Pcomm is currently connected to a remote, otherwise a 0.
.sp
.ti -0.5i
IF LOG_STATUS
.br
Returns a 1 if the data logging feature is turned on, otherwise 0.
.sp
.ti -0.5i
IF PRINTER_STATUS
.br
Returns a 1 if the printer is turned on, otherwise 0.
.sp
.ti -0.5i
DIAL [ MANUAL phone_number ] entry_number
.br
Dial an entry from the dialing directory.  The MANUAL option is used to
optionally dial a phone number without the use of the dialing directory.
DIAL returns after 1 attempt.  A return code of 1 means a connection
was made.
.sp
.ti -0.5i
REDIAL entry_number
.br
Similar to the DIAL command, but 10 attempts are made.
.sp
.ti -0.5i
EXIT
.br
Hang up the phone and exit from Pcomm.
.sp
.ti -0.5i
CLEAR_SCREEN
.br
Clear the screen.
.sp
.ti -0.5i