ckuker.cpp

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

  /NOT-AFTER:	Send files modified not after given date-time
  /NOT-BEFORE:	Send files modified not before given date-time
  /PATHNAMES:	Specifiy how to send pathnames
  /PRINT:	Send files to be printed
  /PROTOCOL:	Send files using given protocol
  /QUIET	Don't display file-transfer progress
  /RECOVER	Recover interrupted transfer from point of failure
  /RECURSIVE	Send a directory tree
  /RENAME-TO:	Rename files as specified after successfully sending
  /SMALLER-THAN:	Send files smaller than given size
  /STARTING-AT:	Send file starting at given byte number
  /SUBJECT:	Subject for SEND /MAIL
  /TEXT	Send in text mode
.sp
GET and RECEIVE Command switches:
  /AS-NAME:	Store incoming file under given name
  /BINARY	Receive in binary mode if transfer mode not specified
  /COMMAND:	Send incoming file data to given command
  /EXCEPT:      Don't accept incoming files whose names match
  /FILENAMES:	How to treat incoming file names
  /FILTER:	Filter program for incoming file data
  /MOVE-TO:	Where to move a file after succussful receipt.
  /PATHNAMES:	How to treat incoming path names
  /PROTOCOL:	Protocol to use for receiving (RECEIVE only)
  /RENAME-TO:   New name for file after succussful receipt.
  /QUIET:	Suppress file-transfer display
  /TEXT	Receive in text mode if transfer mode not specified
.sp
Switches only for GET:
  /DELETE	Tells server to delete each file after successful transmission
  /RECOVER	Resume interrupted file transfer from point of failure
  /RECURSIVE	Tells server to send a directory tree
.sp
File Management:
* CD	Change Directory.
* PWD	Display current working directory.
  COPY	Copy a file.
* DELETE	Delete a file or files.
* DIRECTORY	Display a directory listing.
  EDIT	Edit a file.
  MKDIR	Create a directory.
  PRINT	Print a local file on a local printer.
  PURGE	Remove backup files.
  RENAME	Change the name of a local file.
  RMDIR	Remove a directory.
  SET PRINTER	Choose printer device.
  SPACE	Display current disk space usage.
  SHOW CHARACTER-SETS Display character-set translation info.
  TRANSLATE	Translate a local file's character set.
  TYPE	Display a file on the screen
  TYPE /PAGE	Display a file on the screen, pausing after each screenful.
  XLATE	Synonym for TRANSLATE.
.sp
Client/Server operation:
  BYE	Terminate a remote Kermit server and log out its job.
  DISABLE	Disallow access to selected features during server operation:
  E-PACKET	Send an Error packet.
  ENABLE	Allow access to selected features during server operation.
  FINISH	Instruct a remote Kermit server to exit, but not log out.
  G	Special abbreviation for GET.
  GET	Get files from a remote Kermit server.
  QUERY	(Same as REMOTE QUERY)
  RETRIEVE	Like GET but server deletes files after.
  REMOTE xxx	Command for server, can be redirected with > or |.
  REMOTE ASSIGN	(RASG) Assign a variable
  REMOTE CD	(RCD) Tell remote Kermit server to change its directory.
  REMOTE COPY	(RCOPY) Tell server to copy a file.
  REMOTE DELETE	(RDEL) Tell server to delete a file.
  REMOTE DIR	(RDIR) Ask server for a directory listing.
  REMOTE EXIT	(REXIT) Ask the server program to exit.
  REMOTE HELP	(RHELP) Ask server to send a help message.
  REMOTE HOST	(RHOST) Ask server to ask its host to execute a command.
  REMOTE KERMIT	(RKER) Send an interactive Kermit command to the server.
  REMOTE LOGIN	Authenticate yourself to a remote Kermit server.
  REMOTE LOGOUT	Log out from a Kermit server previously LOGIN'd to.
  REMOTE MKDIR	(RMKDIR) Tell the server to create a directory.
  REMOTE PRINT	(RPRINT) Print a local file on the server's printer.
  REMOTE PWD	(RPWD) Ask server to reveal its current (working) directory.
  REMOTE QUERY	(RQUERY) Get value of a variable.
  REMOTE RENAME	(RRENAME) Tell server to rename a file.
  REMOTE RMDIR	(RRMDIR) Tell server to remove a directory.
  REMOTE SET	(RSET) Send a SET command to a remote server.
  REMOTE SPACE	(RSPACE) Ask server how much disk space it has left.
  REMOTE TYPE	(RTYPE) Ask server to display a file on your screen.
  REMOTE WHO	(RWHO) Ask server for a "who" or "finger" listing.
  SERVER	Enter server mode - be a Kermit server.
  SET SERVER	Set parameters for server operation.
  SHOW SERVER	Show SET SERVER, ENABLE/DISABLE items.
.sp
Script programming:
  ASK	Prompt the user, store user's reply in a variable.
  ASKQ	Like ASK, but, but doesn't echo (useful for passwords).
  ASSERT	Evaluate condition and set SUCCESS/FAILURE accordingly.
  ASSIGN	Assign an evaluated string to a variable or macro.
  CLEAR	Clear communication device input buffer or other item.
  CLOSE	Close the connection, or a log or other file.
  DECLARE	Declare an array.
  DECREMENT	Subtract one (or other number) from a variable.
  DEFINE	Define a variable or macro.
  DO	Execute a macro ("DO" can be omitted).
  ECHO	Display text on the screen.
  ELSE	Used with IF.
  END	A command file or macro.
  EVALUATE	an arithmetic expression.
  FAIL	Set FAILURE.
  FOPEN	Open a local file
  FREAD	Read from a file opened with FOPEN
  FWRITE	Write to an FOPEN'd file
  FSEEK	Seeks to given position in FOPEN'd file
  FCLOSE	Close an FOPEN'd file
  FOR	Execute commands repeatedly in a counted loop.
  FORWARD	GOTO in the forward direction only.
  GETC	Issue a prompt, get one character from keyboard.
  GETOK	Ask question, get Yes or No answer, set SUCCESS or FAILURE.
  GOTO	Go to a labeled command in a command file or macro.
  IF	Conditionally execute the following command.
  INCREMENT	Add one (or other number) to a variable.
  INPUT	Match characters from another computer against a given text.
  LOCAL	Declare local variables in a macro
  MINPUT	Like INPUT, but allows several match strings.
  MSLEEP	Sleep for given number of milliseconds.
  OPEN	Open a local file for reading or writing.
  OUTPUT	Send text to another computer.
  O	Special abbreviation for OUTPUT.
  PAUSE	Do nothing for a given number of seconds.
  READ	Read a line from a local file into a variable.
  REINPUT	Reexamine text previously received from another computer.
  RETURN	Return from a user-defined function.
  SCREEN	Screen operations - clear, position cursor, etc.
  SCRIPT	Execute a UUCP-style login script.
  SET ALARM	Set a timer to be used with IF ALARM; SHOW ALARM shows it.
  SET CASE	Treatment of alphabetic case in string comparisons.
  SET COMMAND	QUOTING turns on/off interpretation of backslash notation.
  SET COUNT	For counted loops.
  SET INPUT	Control behavior of INPUT command.
  SET MACRO	Control aspects of macro execution.
  SET TAKE	Control aspects of TAKE file execution.
  SHIFT	Shift macro arguments left the given number of places.
  SHOW ARGUMENTS Display arguments to current macro.
  SHOW ARRAYS	Display information about active arrays.
  SHOW COUNT	Display current COUNT value.
  SHOW FUNCTIONS List names of available \\f() functions.
  SHOW GLOBALS	List defined global variables \\%a..\\%z.
  SHOW MACROS	List one or more macro definitions.
  SHOW SCRIPTS	Show script-related settings.
  SHOW VARIABLES Display values all \\v() variables.
  SLEEP	Sleep for given number of seconds.
  SORT	Sort an array (many options).
  STATUS	Show SUCCESS or FAILURE of previous command.
  STOP	Stop executing macro or command file, return to prompt.
  SUCCEED	Set SUCCESS.
  SWITCH	Execute selected command(s) based on value of variable.
  TAKE	Execute commands from a file.
  UNDEFINE	Undefine a variable
  WAIT	Wait for the specified modem signals.
  WHILE	Execute commands repeatedly while a condition is true.
  WRITE	Write material to a local file.
  WRITE-LINE	Write a line (record) to a local file.
  WRITELN	Synonym for WRITE-LINE.
  XECHO	Like ECHO but no CRLF at end.
  XIF	Extended IF command.
.ll
.in
.fi
.SH "BUILT-IN VARIABLES"
Built-in variables are referred to by \\v(name), can be used in any command,
usually used in script programming.  They cannot be changed.  Type SHOW
VARIABLES for a current list.
.nf
.sp
  \\v(argc)      number of arguments in current macro
  \\v(args)      number of program command-line arguments
  \\v(blockcheck)current SET BLOCK-CHECK type
  \\v(browser)   current Web browser
  \\v(browsopts) current Web browser options
  \\v(browsurl)  most recent Web browser site (URL)
  \\v(byteorder) hardware byte order
  \\v(charset)   current file character-set
  \\v(cmdbufsize)size of command buffer
  \\v(cmdfile)   name of current command file, if any
  \\v(cmdlevel)  current command level
  \\v(cmdsource) where command are currently coming from, macro, file, etc.
  \\v(cols)      number of screen columns
  \\v(connection)connection type: serial, tcp/ip, etc.
  \\v(count)     current COUNT value
  \\v(cps)       speed of most recent file transfer in chars per second
  \\v(cpu)       CPU type C-Kermit was built for
  \\v(crc16)     16-bit CRC of most recent file transfer
  \\v(ctty)      device name of controlling terminal
  \\v(d$ac)      SET DIAL AREA-CODE value
  \\v(d$cc)      SET DIAL COUNTRY-CODE value
  \\v(d$ip)      SET DIAL INTL-PREFIX value
  \\v(d$lc)      SET DIAL LD-PREFIX value
  \\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.