ckuker.cpp

C-Kermit源码。是使用串口/Modem和网络通讯的程序

  \\v(window)    Current window size (SET WINDOW value)
  \\v(xferstatus)Status of most recent file transfer
  \\v(xfermsg)   Error message, if any, terminating most recent transfer
  \\v(xfer_xxx)  Various statistics from last file transfer.
  \\v(xprogram)  C-Kermit
  \\v(xversion)  Same as \\v(version)
.fi
.SH "BUILT-IN FUNCTIONS"
Builtin functions are invoked as \\Fname(args), can be used in any command,
and are usually used in script programs.  Type SHOW FUNCTIONS for a current
list.  Type "help function <name>" for a description of the arguments and
return value, e.g. "help function basename".
.SH "COMMAND LINE OPTIONS"
.PP
C-Kermit accepts commands (or "options") on the command line, in the
time-honored UNIX style.  Alphabetic case is significant.  All options
are optional.  If one or more action options are included, Kermit exits
immediately after executing the command-line options, otherwise it enters
interactive command mode.
.nf
.ll 80
.sp
  kermit [filename] [-x arg [-x arg]...[-yyy]..]]
.sp
where:
.sp
  filename is the name of a command file to execute,
  -x is an option requiring an argument,
  -y an option with no argument.
.ta 15
.sp
Actions:
  -s files	send files
  -s -	send files from stdin
  -r	receive files
  -k	receive files to stdout
  -x	enter server mode
  -O	like -x but exits after one transaction
  -f	finish remote server
  -g files	get remote files from server (quote wildcards)
  -G files	like -g but sends file to standard output
  -a name	alternate file name, used with -s, -r, -g
  -c	connect (before file transfer), used with -l or -j
  -n	connect (after file transfer), used with -l or -j
.sp
Settings:
  -l line	communication line device (to make a serial connection)
  -l n	open file descriptor of communication device
  -j host	TCP/IP network host name (to make a network connection)
  -J host	Connect like TELNET, exit when connection closes
  -l n	open file descriptor of TCP/IP connection (n = number)
  -X	X.25 network address
  -Z	open file descriptor of X.25 connection
  -o n	X.25 closed user group call info
  -u	X.25 reverse-charge call
  -q	quiet during file transfer
  -I    connection is reliable (e.g. TCP or X.25)
  -8	connection is 8-bit clean
  -0    100% transparency in CONNECT mode (and no escaping back)
  -i	transfer files in binary mode
  -T	transfer files in text mode
  -P    send/accept literal path (file) names
  -V	= SET FILE PATTERNS OFF and SET XFER MODE MANUAL
  -b bps	serial line speed, e.g. 1200
  -m name	modem type, e.g. hayes
  -p x	parity, x = e,o,m,s, or n
  -t	half duplex, xon handshake
  -e n	receive packet-length
  -v n	window size
  -L    used with -s to select recursive directory transfer
  -Q	Quick file-transfer settings
  -w	write over files of same name, don't backup old file
  -D n	delay n seconds before sending a file
  -V    "manual mode" = SET FILE PATTERNS OFF, SET TRANSFER MODE MANUAL.
.sp
Other:
  -y name	alternate init file name
  -Y	Skip init file
  -R	Advise C-Kermit it will be used only in remote mode
  -d	log debug info to file debug.log
  -S	Stay, don't exit, after action command
  -C "cmds"	Interactive-mode commands, comma-separated
  -z	Force foreground operation
  -B	Force background (batch) operation
  -h	print command-line option help screen
  =	Ignore all text that follows but assign them to \\%1..\\%9
  --    Same as =
.sp
.fi
.SH "COMMAND LINE EXAMPLES"
.PP
Remote-mode example (C-Kermit is on the far end):
.nf
.sp
  kermit -v 4 -i -s oofa.bin
.sp
.fi
sends file oofa.bin in binary mode (-i) using a window size of 4 (-v 4).
.sp
Local-mode example (C-Kermit makes the connection):
.nf
.sp
  kermit -l HARDWIRE -b 19200 -c -r -n
.sp
.fi
makes a 19200-bps direct connection out through HARDWIRE, CONNECTs (-c)
so you can log in and, presumably start a remote Kermit program and tell it to
send a file, then it RECEIVEs the file (-r), then it CONNECTs back (-n) so you
can finish up and log out.
.sp
For dialing out, you must specify a modem type, and you might have to use a
different device name:
.nf
.sp
  kermit -m hayes -l DIALOUT -b 2400 -c -r -n
.ll
.in
.fi
.SH FILES
.nf
.ta 16
#ifndef HPUX10
$HOME/.kermrc	Standard C-Kermit initialization commands.
#endif /* HPUX10 */
$HOME/.mykermrc	Your personal C-Kermit customization file.
$HOME/.kdd	Your personal dialing directory.
$HOME/.ksd	Your personal services directory.
#ifdef HPUX10
.sp
/usr/share/lib/kermit/READ.ME      Overview of HP-UX C-Kermit, please read
/usr/share/lib/kermit/COPYING.TXT  Copyright, permissions, disclaimer
/usr/share/lib/kermit/ckermit.ini  System-wide initialization file
/usr/share/lib/kermit/ckermod.ini  Sample customization file
/usr/share/lib/kermit/ckermit.kdd  Sample dialing directory
/usr/share/lib/kermit/ckermit.ksd  Sample services directory
/usr/share/lib/kermit/ckermit2.txt Updates to "Using C-Kermit" 2nd Ed
/usr/share/lib/kermit/ckcbwr.txt   C-Kermit "beware" file - hints & tips
/usr/share/lib/kermit/ckubwr.txt   UNIX-specific beware file
/usr/share/lib/kermit/ck*.txt      Other plain-text documentation
/usr/share/lib/kermit/ckedemo.ksc  Macros from "Using C-Kermit"
/usr/share/lib/kermit/ckevt.ksc    Ditto
/usr/share/lib/kermit/ckepage.ksc  Alpha pager script
/var/spool/locks/LCK..*            UUCP lockfiles
#else
.fi
.PP
The following should be in a publicly accessible plain-text documentation area,
such as usr/local/lib/kermit, /usr/local/doc, or /usr/share/lib/kermit, or
available via an information server such as gopher, or by ftp from Columbia:
.nf
.ta 16
.sp
COPYING.TXT     Copyright, permissions, disclaimer.
ckaaaa.hlp      Explanation of C-Kermit files.
ckermit.ini     Standard initialization file.
ckermod.ini	Sample C-Kermit customization file.
ckermit.kdd	Sample dialing directory.
ckermit.ksd	Sample services directory.
ckermit2.txt	Supplement to "Using C-Kermit" 2nd Ed.
ckcbwr.txt	C-Kermit "beware" file - hints & tips.
ckubwr.txt	UNIX-specific beware file.
ck*.txt		Other plain-text documentation.
ckedemo.ksc     Demonstration macros from "Using C-Kermit".
ckevt.ksc       Ditto.
ckepage.ksc     Alpha pager script.
#endif
.fi
.PP
#ifndef HPUX10
If C-Kermit has not been installed on your system with the system-wide
initialization file feature, then the ckermit.ini file should be copied to
your home (login) directory and renamed to
.IR ".kermrc" .
You should not modify this file.
.sp
#endif
To make
.IR "personalized customizations" ,
copy the file
#ifdef HPUX10
/usr/share/lib/kermit/ckermod.ini
#else
ckermod.ini
#endif
file to your home directory, make any desired changes, and rename it to
.IR ".mykermrc" .
.sp
You may also create a personalized
.IR "dialing directory"
like the sample one in
#ifdef HPUX10
/usr/share/lib/kermit/ckermit.kdd.
#else
ckermit.kdd.
#endif
Your personalized dialing directory
should be stored in your home directory as
.IR ".kdd"
and your personal network directory as
.IR ".knd" .
See Chapters 5 and 6 of
.IR "Using C-Kermit"
for details.
.sp
And you may also create a personalized
.IR "services directory"
like the sample one in
#ifdef HPUX10
/usr/share/lib/kermit/ckermit.ksd.
#else
ckermit.ksd.
#endif
Your personalized services directory should be stored in your home directory as
.IR ".ksd" .
See Chapter 7 of
.I "Using C-Kermit"
for instructions.
.sp
The demonstration files illustrate C-Kermit's script programming constructs;
they are discussed in chapters 17-19 of the book.  You can run them by typing
the appropriate TAKE command at the C-Kermit> prompt, for example:
"take /usr/share/lib/kermit/ckedemo.ini".
.PD
.SH AUTHORS
Frank da Cruz, Columbia University, with contributions from hundreds of
other volunteer programmers all over the world.  See Acknowledgements in
.IR "Using C-Kermit".
.SH REFERENCES
.TP
Frank da Cruz and Christine M. Gianone,
.IR "Using C-Kermit",
Second Edition, 1997, 622 pages,
Digital Press / Butterworth-Heinemann, 313 Washington Street,
Newton, MA 02158-1626, USA.
ISBN 1-55558-164-1.  (In the USA, call [phone] to order Digital Press
books.)  Also available in a German edition from Verlag Heinze Heise,
Hannover.
.sp
.TP
Frank da Cruz,
.IR "Kermit, A File Transfer Protocol",
Digital Press / Butterworth-Heinemann, Woburn, MA, USA (1987).
ISBN 0-932376-88-6.  The Kermit file transfer protocol specification.
.TP
Christine M. Gianone,
.IR "Using MS-DOS Kermit",
Digital Press / Butterworth-Heinemann, Woburn, MA, USA (1992).
ISBN 1-5558-082-3.  Also available in a German edition from Heise, and a
French edition from Heinz Schiefer & Cie, Versailles.
.TP
.IR "Kermit News",
Issues 4 (1990) and 5 (1993), Columbia University,
for detailed discussions of Kermit file transfer performance.
.SH DIAGNOSTICS
The diagnostics produced by
.I C-Kermit
itself are intended to be self-explanatory.  In addition, every command
returns a SUCCESS or FAILURE status that can be tested by IF FAILURE or
IF SUCCESS.  In addition, the program itself returns an exit status code of
0 upon successful operation or nonzero if any of various operations failed.
.SH BUGS
See the comp.protocols.kermit.* newsgroups on Usenet for discussion, or the
files ckcbwr.txt and ckubwr.txt, for a list of bugs, hints, tips. etc.  Report
bugs via e-mail to [e-mail].  Visit
http://www.columbia.edu/kermit/support.html for details about tech support.
.SH CONTACTS
For more information about Kermit software and documentation, visit the
Kermit Web site:
.nf
.sp
  http://www.columbia.edu/kermit/
.sp
.fi
Or write to:
.nf
.sp
  The Kermit Project
  Columbia University
  612 West 115th Street
  New York NY  10025-7799
  USA
.sp
.fi
Or send e-mail to [e-mail].
Or call [phone].  Or fax [phone].
.br