kermit man page on HP-UX

Printed from http://www.polarhome.com/service/man/?qf=kermit&af=0&tf=2&of=HP-UX

kermit(1)							     kermit(1)

NAME
       kermit  -  C-Kermit  8.0 communications software for serial and network
       connections: modem dialing, file transfer and management, terminal con‐
       nections,  character-set	 translation,  numeric	and  alpha paging, and
       script programming

SYNOPSIS
       [command-file] [options]...

DESCRIPTION
       Kermit is a family of  file  transfer,  management,  and	 communication
       software programs from the Kermit Project at Columbia University avail‐
       able for most computers and operating systems.  The version  of	Kermit
       for  Hewlett-Packard  HP-UX,  called  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  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 Gen‐
       eral AOS/VS, Stratus VOS, OS-9, QNX, Plan 9, the Commodore  Amiga,  and
       elsewhere.  Together, C-Kermit, Kermit 95, MS-DOS Kermit, and IBM Main‐
       frame Kermit offer a consistent and nearly universal approach to inter-
       computer communications.

       C-Kermit	 8.0  is  Copyright (C) 1985, 2001 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 com‐
       mand (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 redistribution).

       C-Kermit 8.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 by Frank da Cruz and
       Christine M. Gianone, Digital Press, Second Edition, 1997;  see	REFER‐
       ENCES at the end of this manpage.  This manpage 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
       time  as	 the Third Edition of the book is ready.  Hints, tips, limita‐
       tions, restrictions are listed in  (general  C-Kermit)  and  (UNIX-spe‐
       cific);	see the section below.	Please consult all of these references
       before reporting problems or asking for technical support.

       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  Univer‐
       sity  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.

MODES OF OPERATION
       C-Kermit can be used in two "modes": remote and local.  In 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 Ker‐
       mit program on your desktop computer.

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

       C-Kermit	 also  has two types of commands: the familiar UNIX-style com‐
       mand-line options, and an interactive dialog with a prompt.   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.

       give  you access to dialing, script programming, character-set transla‐
       tion, and, in general, detailed control and display, as well as automa‐
       tion,  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.

STARTING C-KERMIT
       You can start C-Kermit by typing or just if your PATH includes possibly
       followed by command-line options.  If there are no "action options"  on
       the command line (explained below), C-Kermit starts in interactive com‐
       mand 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,
       before it executes any other commands, unless you have included the  `'
       (uppercase) command-line option, which means to skip the initialization
       file, or you have included the ` filename' option to specify an	alter‐
       native initialization file.

FILE TRANSFER
       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  PARITY,
	    DUPLEX, and FLOW-CONTROL.

	 ·  Give the CONNECT command.

	 ·  Log in to the remote computer.

	 ·  Start  Kermit on the remote computer, give it any desired SET com‐
	    mands 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 a file or file group, give the remote Kermit  a	SEND  command,
	    following  by  a  filename	or  "wildcard" file specification, for
	    example:

	    To 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)  com‐
	    puter.   If	 your local computer is running C-Kermit, type Ctrl-\c
	    (Control-backslash followed by the letter 'c') (on	NeXT  worksta‐
	    tions,  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  Ker‐
	    mit 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 files.

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

	 ·  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  nec‐
	    essary)  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:	 in  which  all commands are given to the client and passed on
       automatically to the server, and (and upload), in which the remote Ker‐
       mit initiates file transfers automatically through your terminal emula‐
       tor.

       The file transfer protocol defaults in C-Kermit 8.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 Chap‐
       ter 12 of the manual,

       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 8.0 does), a new "streaming" form  of  the
       Kermit protocol is used automatically to give ftp-like speeds (the lim‐
       iting factor being the overhead from the remote Telnet or Rlogin server
       and/or PTY driver).

OTHER FEATURES
       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, charac‐
       ter-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

GETTING HELP
       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:

       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)  manpage.	 Finally,  you can use the SUPPORT command for
       instructions on obtaining technical support.

ENTERING COMMANDS
       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 buf‐
	      fer).
	      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
	      filename.
	      ? gives help about the current field.

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

BACKSLASH NOTATION
       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])
	      :			       compact	substring  notation, all vari‐
				       ables, like \:(a[3:12])
	      d (or D)		       a decimal (base 10) number (1 to 3 dig‐
				       its, 0..255) such as \d27
	      o (or O)		       an  octal  (base 8) number (1 to 3 dig‐
				       its, 0..377) such as \o33
	      x (or X)		       a hexadecimal (base 16) number (2  dig‐
				       its, 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 for a bell, for carriage return, for linefeed.
       For example, to have C-Kermit send a BELL to your screen, type:

COMMAND LIST
       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
	 CHMOD			     Change  permissions  of the given file(s)
				     to the given code, which must be an octal
				     number such as 664 or 775
	 PWD			     Print Working Directory.
	 GREP			     Search  through  the  given file or files
				     for the given character  string  or  pat‐
				     tern.
	 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  com‐
				     mand.
       * 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.
	 RUN			     Run a program or system command.
	 SET COMMAND		     Command-related   parameters:   bytesize,
				     recall buffer size.
	 SET PROMPT		     The C-Kermit programs'  interactive  com‐
				     mand 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
				     with.
	 SHOW VERSIONS		     Show  version numbers of each source mod‐
				     ule.
	 SUPPORT		     Find out how to get technical support.
	 SUSPEND		     Suspend Kermit (use only  if  shell  sup‐
				     ports job control!).
       * SHOW			     Display values of SET parameters.
       * TAKE			     Execute commands from a file.
	 VERSION		     Display the C-Kermit program version num‐
				     ber.
	 Z			     Synonym for SUSPEND.
       * Ctrl-C			     Interrupt a C-Kermit command in progress.
	 Ctrl-Z			     Synonym for SUSPEND.
	 ; or #			     Introduce a full-line  or	trailing  com‐
				     ment.
	 ! 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
				     rules.
	 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
				     again.
	 LOG CONNECTIONS	     Keep a record of each connection.
	 REDIRECT		     Redirect  standard i/o of command to com‐
				     munication connection.
	 PIPE			     Make a  connection	 through  an  external
				     command or program.
	 SET CARRIER		     Treatment	of carrier on terminal connec‐
				     tions.
       * SET DIAL		     Parameters related to modem dialing.
       * SET FLOW		     Communication line	 flow  control:	 AUTO,
				     RTS/CTS, XON/XOFF, etc.
       * SET HOST		     Specify   remote  network	host  name  or
				     address.
       * 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
				     communications.
       * SET SPEED		     Serial communication device speed,	 e.g.,
				     2400, 9600, 57600.
	 SET SERIAL		     Set serial communications data size, par‐
				     ity, 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 ...,  CON‐
				     NECT.
	 RLOGIN			     Makes   an	 RLOGIN	 connection  (requires
				     privilege).
	 TELOPT			     Send   a	TELNET	 option	   negotiation
				     (advanced).
	 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  key‐
				     board and screen.
       * SET DUPLEX		     Specify which side echoes during CONNECT.
	 SET ESCAPE		     Prefix  for "escape commands" during CON‐
				     NECT.
	 SET KEY		     Key redefinitions in CONNECT mode.
	 SET TERMINAL		     Terminal  connection   items:   bytesize,
				     character-set, echo, etc.
	 SHOW ESCAPE		     Display current CONNECT-mode escape char‐
				     acter.
	 SHOW KEY		     Display keycode  and  assigned  value  or
				     macro.
	 SHOW TERMINAL		     Display SET TERMINAL items.
       * Ctrl-\			     CONNECT-mode  escape  character, followed
				     by another character:
						 C  to	return	to   C-Kermit>
						 prompt.
						 B to send BREAK signal.
						 ? to see other options.

   File Transfer
	 ADD SEND-LIST		     Add  a  file  specification  to the SEND-
				     LIST.
	 ADD BINARY-PATTERNS	     Add a pattern to the binary file  pattern
				     list.
	 ADD TEXT-PATTERNS	     Add  a  pattern  to the text file pattern
				     list.
	 ASSOCIATE		     A	file  character-set  with  a  transfer
				     character-set.
	 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
				     successful.
	 MMOVE			     Multiple  MOVE - accepts a list of files,
				     separated by spaces.
	 MAIL			     SEND a file to other Kermit, to be deliv‐
				     ered 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 file(s).
	 MGET			     Like GET but accepts a list of files.
	 REGET			     Continue a	 incomplete  download  from  a
				     server.
	 G			     Special abbreviation for GET.
	 FAST			     Shortcut for fast file-transfer settings.
	 CAUTIOUS		     Shortcut  for  medium  file-transfer set‐
				     tings.
	 ROBUST			     Shortcut for  conservative	 file-transfer
				     settings.
	 SET ATTRIB		     Control transmission of file attributes.
       * 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
				     packet.
	 SET DESTINATION	     DISK,  PRINTER,  or  SCREEN  for incoming
				     files.
       * SET FILE		     Transfer mode (type), character-set, col‐
				     lision 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,
				     etc.
	 SET HANDSHAKE		     Communication   line  half-duplex	packet
				     turnaround character.
	 SET LANGUAGE		     Enable  language-specific	 character-set
				     translations.
	 PATTERNS		     Turn      off	filename-pattern-based
				     text/binary mode switching.
	 SET SESSION-LOG	     File  type	 for  session  log,  text   or
				     binary.
	 SET TRANSFER		     File  transfer parameters: character-set,
				     display, etc.
	 SET TRANSMIT		     Control aspects of TRANSMIT command  exe‐
				     cution.
	 SET UNKNOWN		     Specify  handling	of  unknown  character
				     sets.
       * 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
				     pattern(s).
	 /FILTER:		     Pass file contents through	 given	filter
				     program.
	 /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 date-
				     time.
	 /NOT-BEFORE:		     Send  files  modified  not	 before	 given
				     date-time.
	 /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  success‐
				     fully 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 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 successful
				     receipt.
	 /PATHNAMES:		     How to treat incoming path names.
	 /PROTOCOL:		     Protocol to use  for  receiving  (RECEIVE
				     only).
	 /RENAME-TO:		     New   name	  for  file  after  successful
				     receipt.
	 /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.
	 /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 ROOT		     Set the root for file access to the given
				     directory and disable  access  to	system
				     and shell commands and external programs.
	 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 dur‐
				     ing 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	 list‐
				     ing.
	 REMOTE EXIT		     (REXIT) Ask the server program to exit.
	 REMOTE HELP		     (RHELP)  Ask  server  to send a help mes‐
				     sage.
	 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 direc‐
				     tory.
	 REMOTE SET		     Send a SET command to a remote server.
	 REMOTE SPACE		     Ask server how much  disk	space  it  has
				     left.
	 REMOTE TYPE		     Ask  server  to  display  a  file on your
				     screen.
	 REMOTE WHO		     Ask server for a "who" or "finger"	 list‐
				     ing.
	 SERVER			     Be a Kermit server.
	 SET SERVER		     Parameters for server operation.
	 SHOW SERVER		     Show SET SERVER, ENABLE/DISABLE items.

   Script programming
	 ASK			     Prompt  the user, store user's reply in a
				     variable.
	 ASKQ			     Like ASK, but does not echo  (useful  for
				     passwords).
	 ASSERT			     Evaluate  condition and set SUCCESS/FAIL‐
				     URE 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  com‐
				     mand.
	 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
				     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 cur‐
				     sor, 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 num‐
				     ber 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  com‐
				     mand.
	 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 con‐
				     dition 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
       Built-in variables are referred to by \v(name), can be used in any com‐
       mand,  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
	 \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
				     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 trans‐
				     ferred (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-Ker‐
				     mit 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
	 \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	 (ker‐
				     mit, 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  mid‐
				     night (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(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 pro‐
				     tocol)
	 \v(query)		     Result of most recent REMOTE  QUERY  com‐
				     mand
	 \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
				     started
	 \v(status)		     0 or 1 (SUCCESS or	 FAILURE  of  previous
				     command)
	 \v(sysid)		     Code  for	platform ID of C-Kermit's com‐
				     puter (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(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
				     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 trans‐
				     fer.
	 \v(xprogram)		     C-Kermit
	 \v(xversion)		     Same as \v(version)

BUILT-IN FUNCTIONS
       Builtin functions are invoked as \Fname(args), can be used in any  com‐
       mand, 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,

COMMAND LINE OPTIONS
       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.

	      [filename] arg] arg]...

       Where:

	      filename is the name of a command file to execute,

	      is an option requiring an argument,

	      an option with no argument.

   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 wild‐
				     cards)
	 -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

   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  net‐
				     work 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			     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 direc‐
				     tory 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,
				     SET TRANSFER MODE MANUAL.

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

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

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

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

       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
       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:

FILES
       Your personal C-Kermit customization file.

       Your personal dialing directory.

       Your personal services directory.

       Overview of HP-UX C-Kermit, please read

       Copyright, permissions, disclaimer

       System-wide initialization file

       Sample customization file

       Sample dialing directory

       Sample services directory

       Updates to "Using C-Kermit" 2nd Ed

       C-Kermit "beware" file - hints & tips

       UNIX-specific beware file

       Other plain-text documentation

       Macros from "Using C-Kermit"

       Ditto

       Alpha pager script

       UUCP lockfiles

       To  make	 copy  the  file file to your home directory, make any desired
       changes, and rename it to

       You may also create a personalized like the sample one in Your  person‐
       alized dialing directory should be stored in your home directory as and
       your personal network directory as See Chapters 5 and 6 of for details.

       And you may also create a personalized like the sample one in Your per‐
       sonalized services directory should be stored in your home directory as
       See Chapter 7 of for instructions.

       The demonstration files illustrate C-Kermit's script  programming  con‐
       structs; 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:

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

REFERENCES
       Frank da Cruz and Christine M. Gianone,
	      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 Digi‐
	      tal Press books.)	 Also available in a German edition from  Ver‐
	      lag Heinze Heise, Hannover.

       Frank da Cruz,
	      Digital  Press  / Butterworth-Heinemann, Woburn, MA, USA (1987).
	      ISBN 0-932376-88-6.  The Kermit file transfer protocol  specifi‐
	      cation.

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

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

DIAGNOSTICS
       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.

BUGS
       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 Visit for details about tech support.

CONTACTS
       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
	      USA

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

				HP-UX C-Kermit			     kermit(1)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net