Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Apropos / Subsearch:
optional field

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      kermit - C-Kermit 7.0 communications software for serial and network
      connections: modem dialing, file transfer and management, terminal
      connection, character-set translation, numeric and alpha paging, and
      script programming.

      kermit [command-file] [options...]

      Kermit is a family of file transfer, management, and communication
      software programs from the Kermit Project at Columbia University
      available for most computers and operating systems.  The version of
      Kermit for Hewlett-Packard HP-UX, called C-Kermit, supports both
      serial connections (direct or dialed) and TCP/IP connections.

      C-Kermit can be thought of as a user-friendly and powerful alternative
      to cu, tip, uucp, ftp, telnet, rlogin, expect, and even your shell; a
      single package for both network and serial communications, offering
      automation, convenience, and language features not found in the other
      packages, and having a great deal in common with its cousins, C-Kermit
      on other UNIX platforms, Kermit 95 for Windows 95, Windows 98, Windows
      NT and 2000, and OS/2; MS-DOS Kermit for PCs with DOS and Windows 3.x,
      and IBM Mainframe Kermit-370 for VM/CMS, MVS/TSO, and CICS.  C-Kermit
      itself also runs on Digital VMS, Data General AOS/VS, Stratus VOS,
      OS-9, QNX, Plan 9, the Commodore Amiga, and elsewhere.  Together, C-
      Kermit, Kermit 95, MS-DOS Kermit, and IBM Mainframe Kermit offer a
      consistent and nearly universal approach to inter-computer

      C-Kermit 7.0 is Copyright (C) 1985, 2000 by the Trustees of Columbia
      University in the City of New York.  For use and redistribution
      rights, see the C-Kermit COPYING.TXT file or give the C-Kermit
      COPYRIGHT command (summary: no license is required for own use; no
      license is required for distribution with Open Source operating
      systems; a license is required for certain other forms of

      C-Kermit 7.0 is included with HP-UX by Hewlett-Packard in partnership
      with the Kermit Project at Columbia University.

      C-Kermit 6.0 is thoroughly documented in the book Using C-Kermit by
      Frank da Cruz and Christine M. Gianone, Digital Press, Second Edition,
      1997; see REFERENCES at the end of this manual page.  This manual page
      is not a substitute for the book.	 If you are a serious user of C-
      Kermit, particularly if you plan to write C-Kermit script programs,
      you should purchase the manual.  Book sales are the primary source of
      funding for the nonprofit Kermit Project.

      Any new features added since the most recent edition of the book was
      published are documented in the online file ckermit2.upd until such

 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      time as the Third Edition of the book is ready.  Hints, tips,
      limitations, restrictions are listed in ckcker.txt (general C-Kermit)
      and ckuker.bwr (UNIX-specific); see FILES below.	Please consult all
      of these references before reporting problems or asking for technical

      Kermit software is available for hundreds of different computers and
      operating systems from Columbia University.  For best file-transfer
      results, please use C-Kermit in conjunction with real Columbia
      University Kermit software on other computers, such as Kermit 95 for
      Windows 95 and NT or MS-DOS Kermit for DOS 3.x or Windows.  See
      CONTACTS below.

      C-Kermit can be used in two "modes": remote and local.  In remote
      mode, you connect to the HP-UX system from a desktop computer and
      transfer files between your desktop computer and HP-UX C-Kermit.	In
      that case, connection establishment (dialing, TELNET connection, etc.)
      is handled by the Kermit program on your desktop computer.

      In local mode, C-Kermit establishes a connection to another computer
      by direct serial connection, by dialing a modem, or by making a
      network connection.  When used in local mode, C-Kermit gives you a
      terminal connection to the remote computer, using your actual
      terminal, emulator, or UNIX workstation terminal window or console
      driver for specific terminal emulation.

      C-Kermit also has two types of commands: the familiar UNIX-style
      command-line options, and an interactive dialog with a prompt.
      Command-line options give you access to a small but useful subset of
      C-Kermit's features for terminal connection and file transfer, plus
      the ability to pipe files into or out of Kermit for transfer.

      Interactive commands give you access to dialing, script programming,
      character-set translation, and, in general, detailed control and
      display, as well as automation, of all C-Kermit's features.
      Interactive commands can also be collected into command files or
      macros.  C-Kermit's command and script language is portable to many
      and diverse platforms.

      You can start C-Kermit by typing /usr/bin/kermit, or just kermit if
      your PATH includes /usr/bin, possibly followed by command-line
      options.	If there are no "action options" on the command line
      (explained below), C-Kermit starts in interactive command mode; you
      will see a greeting message and then the "C-Kermit>" prompt.  If you
      do include action options on the command line, C-Kermit takes the
      indicated actions and then exits directly back to UNIX.  Either way,
      C-Kermit executes the commands in its initialization file,
      /usr/share/lib/kermit/ckermit.ini, before it executes any other
      commands, unless you have included the `-Y' (uppercase) command-line

 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      option, which means to skip the initialization file, or you have
      included the `-y	filename' option to specify an alternative
      initialization file.

      Here is the most common scenario for Kermit file transfer.  Many other
      methods are possible, most of them more convenient, but this basic
      method should work in all cases.

	   +  Start Kermit on your local computer and establish a connection
	      to the remote computer.  If C-Kermit is on your local
	      computer, use the sequence SET MODEM TYPE modem-name, SET LINE
	      device-name, SET SPEED bits-per-second, and DIAL phone-number
	      if you are dialing; SET LINE and SPEED for direct connections;
	      SET NETWORK network-type and SET HOST host-name-or-address for
	      network connections.

	   +  SET any other necessary communication parameters, such as

	   +  Give the CONNECT command.

	   +  Log in to the remote computer.

	   +  Start Kermit on the remote computer, give it any desired SET
	      commands for file-, communication-, or protocol-related
	      parameters.  If you will be transferring binary files, give
	      the command SET FILE TYPE BINARY to the Kermit program that
	      will be sending them.

	   +  To download a file or file group, give the remote Kermit a
	      SEND command, following by a filename or "wildcard" file
	      specification, for example:

		     send oofa.txt	   #  (send one file)
		     send oofa.*	   #  (send a group of files)

	      To upload a file or files, give the remote Kermit a RECEIVE
	      command.	The sending Kermit will tell the receiving Kermit
	      the name (and other attributes) of each file.

	   +  Escape back to the Kermit program on your local (desktop)
	      computer.	 If your local computer is running C-Kermit, type
	      Ctrl-\c (Control-backslash followed by the letter 'c') (on
	      NeXT workstations, use Ctrl-] c).	 If MS-DOS or Kermit 95, use
	      Alt-x (hold down the Alt key, press 'x').	 Now you should see
	      your local Kermit program's prompt.

	   +  If you will be transferring binary files, give the command SET
	      FILE TYPE BINARY to the Kermit program that is sending the

 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	   +  If you are downloading files, tell the local Kermit program to
	      RECEIVE.	If you are uploading, give your local Kermit program
	      a SEND command, specifying a filename or wildcard file
	      specification.  In other words, tell the remote Kermit program
	      what to do first, SEND or RECEIVE, then escape back to the
	      local Kermit and give it the opposite command, RECEIVE or

	   +  When the transfer is complete, give a CONNECT command.  Now
	      you are talking to Kermit on the remote computer again.  Type
	      EXIT to get back to the command prompt on the remote computer.
	      When you are finished using the remote computer, log out and
	      then (if necessary) escape back to Kermit on your local
	      computer.	 Then you can make another connection or EXIT from
	      the local Kermit program.

      Note that other methods can be used to simplify the file-transfer
      process: client/server operation, in which all commands are given to
      the client and passed on automatically to the server, and autodownload
      (and upload), in which the remote Kermit initiates file transfers
      automatically through your terminal emulator.

      The file transfer protocol defaults in C-Kermit 7.0, unlike those for
      earlier releases, favor speed over robustness, on the assumption that
      connections in these times are usually reliable (over TCP/IP and/or
      error-correcting modems with hardware flow control).  If you
      experience file transfer failures, use the CAUTIOUS or ROBUST commands
      to choose more conservative (and therefore slower) protocol settings.
      For fine tuning of performance, you can choose specific packet
      lengths, window sizes, and control-character prefixing strategies as
      explained in Chapter 12 of the manual, Using C-Kermit.

      If you are accessing a remote host where C-Kermit resides via Telnet
      or other connection that is guaranteed reliable from end to end, and
      both Kermits support it (C-Kermit 7.0 does), a new "streaming" form of
      the Kermit protocol is used automatically to give ftp-like speeds (the
      limiting factor being the overhead from the remote Telnet or Rlogin
      server and/or PTY driver).

      C-Kermit includes features too numerous to be explained in a man page.
      For further information about connection establishment, modem dialing,
      networks, terminal connection, key mapping, logging, file transfer
      options and features, troubleshooting, client/server operation,
      character-set translation during terminal connection and file
      transfer, "raw" up- and downloading of files, macro construction,
      script programming, convenience features, and shortcuts, plus numerous
      tables, examples, and illustrations, please consult Using C-Kermit.


 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      C-Kermit has extensive built-in help.  You can find out what commands
      exist by typing ?	 at the C-Kermit> prompt.  You can type HELP at the
      C-Kermit> prompt for "getting-started" message, or HELP followed by
      the name of a particular command for information about that command,
      for example:

	   help send
	   help set file

      You can type ? anywhere within a command to get brief help about the
      current command field.  You can also type the INTRO command to get a
      brief introduction to C-Kermit, and the MANUAL command to access this
      (or another) manual page.	 Finally, you can use the SUPPORT command
      for instructions on obtaining technical support.

      You can use upper or lower case for interactive-mode commands, but
      remember that UNIX filenames are case-sensitive.	You can abbreviate
      commands as long as the abbreviation matches only one possibility.
      While typing a command, you can use the following editing characters:

	   Delete, Backspace, or Rubout erases the rightmost character.
	   Ctrl-W erases the rightmost "word".
	   Ctrl-U erases the current command line.
	   Ctrl-R redisplays the current command.
	   Ctrl-P recalls a previous command (scrolls back in command
	   Ctrl-N scrolls forward in a scrolled-back command buffer.
	   Ctrl-C cancels the current command.
	   Tab, Esc, or Ctrl-I tries to complete the current keyword or
	   ? gives help about the current field.

      To enter the command and make it execute, press the Return or Enter

      Within an interactive command, the \ character (backslash) is a prefix
      used to enter special quantities, including ordinary characters that
      would otherwise be illegal.  At the end of a line, \ or - (dash) makes
      the next line a continuation of the current line.	 Other than that,
      the character following the \ identifies what the special quantity is:

	   %			    A user-defined simple (scalar) variable
				    such as \%a or \%1
	   &			    an array reference such as \&a[3]
	   $			    an environment variable such as \$(TERM)
	   v (or V)		    a built-in variable such as \v(time)
	   f (or F)		    a function such as \Fsubstring(\%a,3,2)
	   s (or S)		    compact substring notation, macronames,
				    like \s(foo[3:12])

 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	   :			    compact substring notation, all
				    variables, like \:(a[3:12])
	   d (or D)		    a decimal (base 10) number (1 to 3
				    digits, 0..255) such as \d27
	   o (or O)		    an octal (base 8) number (1 to 3 digits,
				    0..377) such as \o33
	   x (or X)		    a hexadecimal (base 16) number (2
				    digits, 00..ff) like \x1b
	   \			    the backslash character itself
	   b (or B)		    the BREAK signal (OUTPUT command only)
	   l (or L)		    a Long BREAK signal (OUTPUT only)
	   n (or N)		    a NUL (0) character (OUTPUT only)
	   a decimal digit	    a 1-, 2-, or 3-digit decimal number,
				    such as \27
	   {}			    used for grouping, e.g. \{27}123
	   anything else:	    following character taken literally.

      Note that numbers turn into the character with that binary code (0-
      255), so you can use \7 for a bell, \13 for carriage return, \10 for
      linefeed.	 For example, to have C-Kermit send a BELL to your screen,

	   echo \7

      The commands most commonly used, and important for beginners to know,
      are marked with "*":

    Program Management:
	BACK			    Return to previous directory.
	BROWSE			    Invoke Web browser.
      * CD			    Change Directory
	PWD			    Print Working Directory.
	CHECK			    See if the given feature is configured.
	CLOSE			    Close a connection or a log or other
				    local file.
	COMMENT			    Introduce a full-line comment.
	COPYRIGHT		    Display copyright notice.
	DATE			    Display date and time.
      * EXIT			    Leave the program, return to UNIX.
      * HELP			    Display a help message for a given
      * INTRO			    Print a brief introduction to C-Kermit.
	KERMIT			    Give command-line options at the prompt.
	LOG			    Open a log file -- debugging, packet,
				    session, transaction.
	PUSH			    Invoke local system's interactive
				    command interpreter.
	QUIT			    Synonym for EXIT.
	REDO			    Re-execute a previous command.

 Hewlett-Packard Company	    - 6 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	RUN			    Run a program or system command.
	SET COMMAND		    Command-related parameters: bytesize,
				    recall buffer size.
	SET PROMPT		    The C-Kermit programs' interactive
				    command prompt.
	SET EXIT		    Items related to C-Kermit's action upon
				    exit or SET LINE/HOST.
	SHOW EXIT		    Display SET EXIT parameters.
	SHOW FEATURES		    Show features that C-Kermit was built
	SHOW VERSIONS		    Show version numbers of each source
	SUPPORT			    Find out how to get technical support.
	SUSPEND			    Suspend Kermit (use only if shell
				    supports job control!).
      * SHOW			    Display values of SET parameters.
      * TAKE			    Execute commands from a file.
	VERSION			    Display the C-Kermit program version
	Z			    Synonym for SUSPEND.
      * Ctrl-C			    Interrupt a C-Kermit command in
	Ctrl-Z			    Synonym for SUSPEND.
	; or #			    Introduce a full-line or trailing
	! or @			    Synonym for RUN.
	<			    Synonym for REDIRECT.

    Connection Establishment and Release:
      * DIAL			    Dial a telephone number.
	PDIAL			    Partially dial a telephone number.
      * LOOKUP			    Lookup a phone number, test dialing
	ANSWER			    Wait for a phone call and answer it when
				    it comes.
      * HANGUP			    Hang up the phone or network connection.
	EIGHTBIT		    Shortcut to set all i/o to 8 bits.
	PAD			    Command for X.25 PAD (SunOS / Solaris /
				    VOS only).
	PING			    Check status of remote TCP/IP host.
	REDIAL			    Dial the most recently DIALed number
	LOG CONNECTIONS		    Keep a record of each connection.
	REDIRECT		    Redirect standard i/o of command to
				    communication connection.
	PIPE			    Make a connection through an external
				    command or program.
	SET CARRIER		    Treatment of carrier on terminal
      * SET DIAL		    Parameters related to modem dialing.

 Hewlett-Packard Company	    - 7 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      * SET FLOW		    Communication line flow control: AUTO,
				    RTS/CTS, XON/XOFF, etc.
      * SET HOST		    Specify remote network host name or
      * SET LINE		    Specify serial communication device
				    name, like /dev/cul0p0.
	SET PORT		    Synonym for SET LINE.
      * SET MODEM TYPE		    Specify type of modem on SET LINE
				    device, like USR.
      * SET NETWORK		    Network type, X.25 (SunOS / Solaris /
				    VOS only) or TCP/IP.
	SET TCP			    Specify TCP protocol options (advanced).
	SET TELNET		    Specify TELNET protocol options.
	SET X.25		    Specify X.25 connection parameters
				    (SunOS / Solaris / VOS only).
	SET PAD			    X.25 X.3 PAD parameters (SunOS / Solaris
				    / VOS only).
      * SET PARITY		    Character parity (none, even, etc.) for
      * SET SPEED		    Serial communication device speed, e.g.
				    2400, 9600, 57600.
	SET SERIAL		    Set serial communications data size,
				    parity, stop bits.
	SET STOP-BITS		    Set serial communications stop bits.
	SHOW COMM		    Display all communications settings.
	SHOW CONN		    Display info about current connection.
	SHOW DIAL		    Display SET DIAL values.
	SHOW MODEM		    Display modem type, signals, etc.
	SHOW NETWORK		    Display network-related items.
      * TELNET			    = SET NETWORK TCP/IP, SET HOST ...,
	RLOGIN			    Makes an RLOGIN connection (requires
	TELOPT			    Send a TELNET option negotiation
	CLOSE			    Close the current connection.

    Terminal Connection:
      * C			    Special abbreviation for CONNECT.
      * CONNECT			    Establish a terminal connection to a
				    remote computer.
	LOG SESSION		    Record terminal session.
	SET COMMAND		    Bytesize between C-Kermit and your
				    keyboard and screen.
      * SET DUPLEX		    Specify which side echoes during
	SET ESCAPE		    Prefix for "escape commands" during
	SET KEY			    Key redefinitions in CONNECT mode.
	SET TERMINAL		    Terminal connection items: bytesize,
				    character-set, echo, etc.

 Hewlett-Packard Company	    - 8 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	SHOW ESCAPE		    Display current CONNECT-mode escape
	SHOW KEY		    Display keycode and assigned value or
      * Ctrl-\			    CONNECT-mode escape character, followed
				    by another character:
					      C to return to C-Kermit>
					      B to send BREAK signal.
					      ? to see other options.

    File Transfer:
	ADD SEND-LIST		    Add a file specification to the SEND-
	ADD BINARY-PATTERNS	    Add a pattern to the binary file pattern
	ADD TEXT-PATTERNS	    Add a pattern to the text file pattern
	ASSOCIATE		    A file character-set with a transfer
	LOG SESSION		    Download a file with no error checking.
      * SEND			    Send a file or files.
	MSEND			    Multiple SEND - accepts a list of files,
				    separated by spaces.
	MOVE			    SEND and then delete source file(s) if
	MMOVE			    Multiple MOVE - accepts a list of files,
				    separated by spaces.
	MAIL			    SEND a file to other Kermit, to be
				    delivered as e-mail.
	RESEND			    Continue a incomplete SEND.
	PSEND			    Send part of a file.
      * RECEIVE			    Passively wait for files to arrive from
				    other Kermit.
      * R			    Special abbreviation for RECEIVE.
      * S			    Special abbreviation for SEND.
	GET			    Ask server to send the specified
	MGET			    Like GET but accepts a list of files.
	REGET			    Continue a incomplete download from a
	G			    Special abbreviation for GET.
	FAST			    Shortcut for fast file-transfer
	CAUTIOUS		    Shortcut for medium file-transfer
	ROBUST			    Shortcut for conservative file-transfer
	SET ATTRIB		    Control transmission of file attributes.

 Hewlett-Packard Company	    - 9 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      * SET BLOCK		    Choose error-checking level, 1, 2, or 3.
	SET BUFFERS		    Size of send and receive packet buffers.
	SET PREFIX		    Which control characters to "unprefix"
				    during file transfer.
	SET DELAY		    How long to wait before sending first
      * SET FILE		    Transfer mode (type), character-set,
				    collision action, etc.
      * SET RECEIVE		    Parameters for inbound packets: packet-
				    length, etc.
	SET REPEAT		    Repeat-count compression parameters.
	SET RETRY		    Packet retransmission limit.
	SET SEND		    Parameters for outbound packets: length,
	SET HANDSHAKE		    Communication line half-duplex packet
				    turnaround character.
	SET LANGUAGE		    Enable language-specific character-set
	PATTERNS		    Turn off filename-pattern-based
				    text/binary mode switching.
	SET SESSION-LOG		    File type for session log, text or
	SET TRANSFER		    File transfer parameters: character-set,
				    display, etc.
	SET TRANSMIT		    Control aspects of TRANSMIT command
	SET UNKNOWN		    Specify handling of unknown character
      * SET WINDOW		    File transfer packet window size, 1-31.
	SHOW ATTRIB		    Display SET ATTRIBUTE values.
	SHOW CONTROL		    Display control-character prefixing map.
      * SHOW FILE		    Display file-related settings.
	SHOW PROTOCOL		    Display protocol-related settings.
	SHOW LANGUAGE		    Display language-related settings.
	SHOW TRANSMIT		    Display SET TRANSMIT values.
      * STATISTICS		    Display statistics about most recent
				    file transfer.
	TRANSMIT		    Send a file with no error checking.
	XMIT			    Synonym for TRANSMIT.

    SEND Command switches:
	/AS-NAME:		    Name to send file under.
	/AFTER:			    Send files modified after date-time.
	/BEFORE:		    Send files modified before date-time.
	/BINARY			    Send in binary mode.
	/COMMAND		    Send from standard output of a command.
	/DELETE			    Delete file after successfully sending.
	/EXCEPT:		    Don't send files whose names match given

 Hewlett-Packard Company	   - 10 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	/FILTER:		    Pass file contents through given filter
	/FILENAMES:		    Specify how to send filenames.
	/LARGER-THAN:		    Send files larger than given size.
	/LIST:			    Send files whose names are listed in
				    given file.
	/MAIL:			    Send file(s) as e-mail to given address.
	/MOVE-TO:		    Move source file to given directory
				    after successfully sending.
	/NOT-AFTER:		    Send files modified not after given
	/NOT-BEFORE:		    Send files modified not before given
	/PATHNAMES:		    Specify 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.

    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
	/EXCEPT:		    Don't accept incoming files whose names
	/FILENAMES:		    How to treat incoming file names.
	/FILTER:		    Filter program for incoming file data.
	/MOVE-TO:		    Where to move a file after successful
	/PATHNAMES:		    How to treat incoming path names.
	/PROTOCOL:		    Protocol to use for receiving (RECEIVE
	/RENAME-TO:		    New name for file after successful
	/QUIET:			    Suppress file-transfer display.
	/TEXT			    Receive in text mode if transfer mode
				    not specified.

    Switches only for GET:
	/DELETE			    Tells server to delete each file after
				    successful transmission.

 Hewlett-Packard Company	   - 11 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	/RECOVER		    Resume interrupted file transfer from
				    point of failure.
	/RECURSIVE		    Tells server to send a directory tree.

    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.

    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
	REMOTE EXIT		    (REXIT) Ask the server program to exit.
	REMOTE HELP		    (RHELP) Ask server to send a help

 Hewlett-Packard Company	   - 12 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	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
	REMOTE LOGOUT		    Log out from a Kermit server previously
				    LOGIN'd to.
	REMOTE MKDIR		    (RMKDIR) Tell the server to create a
	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
	REMOTE SET		    Send a SET command to a remote server.
	REMOTE SPACE		    Ask server how much disk space it has
	REMOTE TYPE		    Ask server to display a file on your
	REMOTE WHO		    Ask server for a "who" or "finger"
	SERVER			    Be a Kermit server.
	SET SERVER		    Parameters for server operation.

    Script programming:
	ASK			    Prompt the user, store user's reply in a
	ASKQ			    Like ASK, but does not echo (useful for
	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
	DECLARE			    Declare an array.
	DECREMENT		    Subtract one (or other number) from a
	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.

 Hewlett-Packard Company	   - 13 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	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
	FORWARD			    GOTO in the forward direction only.
	GETC			    Issue a prompt, get one character from
	GETOK			    Ask question, get Yes or No answer, set
	GOTO			    Go to a labeled command in a command
				    file or macro.
	IF			    Conditionally execute the following
	INCREMENT		    Add one (or other number) to a variable.
	INPUT			    Match characters from another computer
				    against a given text.
	LOCAL			    Declares local variables in a macro.
	MINPUT			    Like INPUT, but allows several match
	MSLEEP			    Sleep for given number of milliseconds.
	OPEN			    Open a local file for reading or
	OUTPUT			    Send text to another computer.
	O			    Special abbreviation for OUTPUT.
	PAUSE			    Do nothing for a given number of
	READ			    Read a line from a local file into a
	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
	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.

 Hewlett-Packard Company	   - 14 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	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
	STOP			    Stop executing macro or command file,
				    return to prompt.
	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.

      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.

	\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

 Hewlett-Packard Company	   - 15 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	\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 1993
	\v(day)			    Day of week
	\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
	\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)
	\v(errstring)		    Error message string associated with
	\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 (computer 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
	\v(inidir)		    Directory where initialization file was

 Hewlett-Packard Company	   - 16 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	\v(inmatch)		    [M]INPUT material that matched given
	\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
	\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
	\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
	\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
	\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
	\v(pid)			    C-Kermit's process ID
	\v(platform)		    Specific machine and/or operating system
	\v(program)		    Name of this program ("C-Kermit")
	\v(protocol)		    Currently selected file transfer
	\v(p_8bit)		    Current 8th-bit prefix (Kermit protocol)

 Hewlett-Packard Company	   - 17 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	\v(p_ctl)		    Current control-character prefix (Kermit
	\v(p_rpt)		    Current repeat-count prefix (Kermit
	\v(query)		    Result of most recent REMOTE QUERY
	\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 speed, if known, or "unknown"
	\v(startup)		    Current directory when C-Kermit was
	\v(status)		    0 or 1 (SUCCESS or FAILURE of previous
	\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.
	\v(textdir)		    Where C-Kermit thinks its text files are
	\v(tfsize)		    Total size of file group most recently
	\v(time)		    Time as 13:45:23 (hh:mm:ss)
	\v(tmpdir)		    Temporary directory
	\v(trigger)		    Most recent string to trigger return
				    from CONNECT
	\v(ttyfd)		    File descriptor of current communication
	\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
	\v(xprogram)		    C-Kermit
	\v(xversion)		    Same as \v(version)

      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, for example, help function basename.

      C-Kermit accepts commands (or "options") on the command line, in the
      time-honored UNIX style.	Alphabetic case is significant.	 All options

 Hewlett-Packard Company	   - 18 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      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.

	   kermit [filename] [-x arg [-x arg]...[-yyy]...]]

	   filename is the name of a command file to execute,

	   -x is an option requiring an argument,

	   -y an option with no argument.

	-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
	-G files		    like -g but sends file to standard
	-a name			    alternate file name, used with -s, -r,
	-c			    connect (before file transfer), used
				    with -l or -j
	-n			    connect (after file transfer), used with
				    -l or -j

	-l line			    communication line device (to make a
				    serial connection)
	-l n			    open file descriptor of communication
	-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

 Hewlett-Packard Company	   - 19 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

	-8			    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
	-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, do not
				    backup old file
	-D n			    delay n seconds before sending a file
	-V			    "manual mode" = SET FILE PATTERNS OFF,

	-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, do not exit, after action command
	-C "cmds"		    Interactive-mode commands, comma-
	-z			    Force foreground operation
	-B			    Force background (batch) operation
	-h			    print command-line option help screen
	=			    Ignore all text that follows
	--			    Same as =

      Remote-mode example (C-Kermit is on the far end):

	   kermit -v 4 -i -s oofa.bin

      sends file oofa.bin in binary mode (-i) using a window size of 4 (-v

      Local-mode example (C-Kermit makes the connection):

	   kermit -l /dev/tty0p0 -b 19200 -c -r -n

      makes a 19200-bps direct connection out through /dev/tty0p0, 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

 Hewlett-Packard Company	   - 20 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      CONNECTs back (-n) so you can finish up and log out.

      For dialing out, you must specify a modem type, and you might have to
      use a different device name:

	   kermit -m hayes -l /dev/cul0p0 -b 2400 -c -r -n

      $HOME/.mykermrc					Your personal C-
							Kermit customization
      $HOME/.kdd					Your personal
							dialing directory.
      $HOME/.ksd					Your personal
							services directory.
      /usr/share/lib/kermit/READ.ME			Overview of HP-UX
							C-Kermit, please
      /usr/share/lib/kermit/COPYING.TXT			Copyright,
      /usr/share/lib/kermit/ckermit.ini			System-wide
							initialization file
      /usr/share/lib/kermit/ckermod.ini			Sample customization
      /usr/share/lib/kermit/ckermit.kdd			Sample dialing
      /usr/share/lib/kermit/ckermit.ksd			Sample services
      /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
      /usr/share/lib/kermit/ck*.txt			Other plain-text
      /usr/share/lib/kermit/ckedemo.ksc			Macros from "Using
      /usr/share/lib/kermit/ckevt.ksc			Ditto
      /usr/share/lib/kermit/ckepager.ksc		Alpha pager script
      /var/spool/locks/LCK..*				UUCP lockfiles

      To make personalized customizations, copy the file
      /usr/share/lib/kermit/ckermod.ini file to your home directory, make
      any desired changes, and rename it to .mykermrc.

      You may also create a personalized dialing directory like the sample
      one in /usr/share/lib/kermit/ckermit.kdd.	 Your personalized dialing
      directory should be stored in your home directory as .kdd and your
      personal network directory as .knd.  See Chapters 5 and 6 of Using C-

 Hewlett-Packard Company	   - 21 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      Kermit for details.

      And you may also create a personalized services directory like the
      sample one in /usr/share/lib/kermit/ckermit.ksd.	Your personalized
      services directory should be stored in your home directory as .ksd.
      See Chapter 7 of Using C-Kermit for instructions.

      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.

      Frank da Cruz, Columbia University, with contributions from hundreds
      of other volunteer programmers all over the world.  See
      Acknowledgements in Using C-Kermit.

      Frank da Cruz and Christine M. Gianone,
	   Using C-Kermit, Second Edition, 1997, 622 pages, Digital Press /
	   Butterworth-Heinemann, 225 Wildwood Street, Woburn, MA 01801,
	   USA.	 ISBN 1-55558-164-1.  (In the USA, call +1 800 366-2665 to
	   order Digital Press books.)	Also available in a German edition
	   from Verlag Heinze Heise, Hannover.

      Frank da Cruz,
	   Kermit, A File Transfer Protocol, Digital Press / Butterworth-
	   Heinemann, Woburn, MA, USA (1987).  ISBN 0-932376-88-6.  The
	   Kermit file transfer protocol specification.

      Christine M. Gianone,
	   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.

      Kermit News,
	   Issues 4 (1990) and 5 (1993), Columbia University, for detailed
	   discussions of Kermit file transfer performance.

      The diagnostics produced by 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.

      See the comp.protocols.kermit.* newsgroups on Usenet for discussion,
      or the files, ckcker.bwr and ckuker.bwr, for a list of bugs, hints,
      tips. etc.  Report bugs via e-mail to kermit-support@columbia.edu.

 Hewlett-Packard Company	   - 22 -   HP-UX Release 11i: November 2000

 kermit(1)							   kermit(1)
			       HP-UX C-Kermit

      Visit http://www.columbia.edu/kermit/support.html for details about
      tech support.

      For more information about Kermit software and documentation, visit
      the Kermit Web site:


      Or write to:

	   The Kermit Project
	   Columbia University
	   612 West 115th Street
	   New York, NY	 10025-7221

      Or send e-mail to kermit@columbia.edu.  Or call +1 212 854-3703.	Or
      fax +1 212 663-8202.

 Hewlett-Packard Company	   - 23 -   HP-UX Release 11i: November 2000