ckuker.nr

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

  \\v(d$px)      SET DIAL PBX-EXCHANGE value
  \\v(date)      date as 8 Feb 1999
  \\v(day)       day of week (English 3-letter abbreviation)
  \\v(dialcount) current value of DIAL retry counter
  \\v(dialnumber)phone number most recently dialed
  \\v(dialresult)most recent dial result message or code from modem
  \\v(dialstatus)return code from DIAL command (0 = OK, 22 = BUSY, etc)
  \\v(dialsuffix)current SET DIAL SUFFIX value
  \\v(dialtype)  code for type of call most recently placed
  \\v(directory) current/default directory
  \\v(download)  current download directory if any
  \\v(editor)    your preferred editor
  \\v(editfile)  file most recently edited
  \\v(editopts)  options for editor
  \\v(errno)     current "errno" (system error number) value
  \\v(errstring) error message string associated with errno
  \\v(escape)    decimal ASCII value of CONNECT-mode escape character
  \\v(evaluate)  result of most recent EVALUATE command
  \\v(exitstatus)current EXIT status (0 = good, nonzero = something failed)
  \\v(filename)  name of file currently being transferred
  \\v(filenumber)number of file currently being transferred (1 = first, etc)
  \\v(filespec)  filespec given in most recent SEND/RECEIVE/GET command
  \\v(fsize)     size of file most recently transferred
  \\v(ftype)     SET FILE TYPE value (text, binary)
  \\v(herald)    C-Kermit's program herald
  \\v(home)      home directory
  \\v(host)      computer host name (comuter where C-Kermit is running)
  \\v(hwparity)  SET PARITY HARDWARE setting (if any)
  \\v(input)     current INPUT buffer contents
  \\v(inchar)    character most recently INPUT
  \\v(incount)   how many characters arrived during last INPUT
  \\v(inidir)    directory where initialization file was found
  \\v(inmatch)   [M]INPUT material that matched given \\fpattern().
  \\v(instatus)  status of most recent INPUT command
  \\v(intime)    how long it took most recent INPUT to succeed (msec)
  \\v(inwait)    most recent [M]INPUT time limit
  \\v(ipaddress) IP address of C-Kermit's computer if known
  \\v(kbchar)    keyboard character that interrupted PAUSE, INPUT, etc.
  \\v(line)      current communications device, set by LINE or HOST
  \\v(local)     0 if in remote mode, 1 if in local mode
  \\v(lockdir)   UUCP lockfile directory on this platform
  \\v(lockpid)   Process ID found in lockfile when port is in use
  \\v(maclevel)  Current macro stack level
  \\v(macro)     name of currently executing macro, if any
  \\v(math_e)    Floating-point constant e
  \\v(math_pi)   Floating-point constant pi
  \\v(math_precision) Floating point number precision (digits)
  \\v(minput)    Result of most recent MINPUT command
  \\v(model)     Computer hardware model if known
  \\v(modem)     Current modem type or "none"
  \\v(m_aa_off)  Modem command to turn autoanswer off
  \\v(m_aa_on)   Modem command to turn autoanswer on
  \\v(m_xxxxx)   (many other modem commands)
  \\v(m_sig_xx)  Value of modem signal xx
  \\v(name)      Name by which C-Kermit was called (kermit, wermit, etc)
  \\v(ndate)     Current date as 19930208 (yyyymmdd)
  \\v(nday)      Numeric day of week (0 = Sunday)
  \\v(newline)   System-independent newline character or sequence
  \\v(ntime)     Current local time in seconds since midnight (noon = 43200)
  \\v(osname)    Operating System name
  \\v(osrelease) Operating System release
  \\v(osversion) Operating System version
  \\v(packetlen) Current SET RECEIVE PACKET-LENGTH value
  \\v(parity)    Current parity setting
  \\v(pexitstat) Exit status of most recently forked process
  \\v(pid)       C-Kermit's process ID
  \\v(platform)  Specific machine and/or operating system
  \\v(printer)   Current SET PRINTER value or "(default)"
  \\v(program)   Name of this program ("C-Kermit")
  \\v(protocol)  Currently selected file transfer protocol
  \\v(p_8bit)    Current 8th-bit prefix (Kermit protocol)
  \\v(p_ctl)     Current control-character prefix (Kermit protocol)
  \\v(p_rpt)     Current repeat-count prefix (Kermit protocol)
  \\v(query)     Result of most recent REMOTE QUERY command
  \\v(return)    Most recent RETURN value
  \\v(rows)      Number of rows on the terminal screen
  \\v(sendlist)  Number of entries in SEND-LIST
  \\v(serial)    Serial port settings in 8N1 format
  \\v(speed)     Current serial device speed, if known, or "unknown"
  \\v(startup)   Current directory when C-Kermit was started
  \\v(status)    0 or 1 (SUCCESS or FAILURE of previous command)
  \\v(sysid)     Code for platform ID of C-Kermit's computer (U1=UNIX)
  \\v(system)    UNIX (name of operating system family)
  \\v(terminal)  Terminal type
  \\v(test)      C-Kermit test version, if any (e.g. Beta.10)
  \\v(textdir)   Where C-Kermit thinks its text files are
  \\v(tfsize)    Total size of file group most recently transferred
  \\v(tftime)    Transfer time of most recent file group
  \\v(time)      Time as 13:45:23 (hh:mm:ss, 24-hour format)
  \\v(tmpdir)    Temporary directory
  \\v(trigger)   Most recent string to trigger return from CONNECT
  \\v(ttyfd)     File descriptor of current communication device
  \\v(ty_xx)     Used internally by TYPE
  \\v(userid)    User ID of person running C-Kermit
  \\v(version)   Numeric version of Kermit, e.g. 501190.
  \\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 /dev/tty01 -b 19200 -c -r -n
.sp
.fi
makes a 19200-bps direct connection out through /dev/tty01, 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 /dev/cua -b 2400 -c -r -n
.ll
.in
.fi
.SH FILES
.nf
.ta 16
$HOME/.kermrc	Standard C-Kermit initialization commands.
$HOME/.mykermrc	Your personal C-Kermit customization file.
$HOME/.kdd	Your personal dialing directory.
$HOME/.ksd	Your personal services directory.
.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.
.fi
.PP
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
To make
.IR "personalized customizations" ,
copy the file
ckermod.ini
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
ckermit.kdd.
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
ckermit.ksd.
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