kermit(1C) kermit(1C)NAME kermit - Kermit file transfer SYNOPSIS kermit [option...] [file...] DESCRIPTION kermit is a file transfer program that allows files to be moved between machines of many different operating systems and architectures. This manual page describes version 4C of the program. Arguments are optional. If kermit is executed without argu- ments, it will enter command mode. Otherwise, kermit will read the arguments off the command line and interpret them. The following notation is used in command descriptions: fn An A/UX file specification, possibly containing either of the metacharacters ``*'', which matches all character strings, or ``?'', which matches any single character. fn1 An A/UX file specification which may not contain * or ?. rfn A remote file specification in the remote system's own syntax, which may denote a single file or a group of files. rfn1 A remote file specification which should denote only a single file. n A decimal number between 0 and 94. c A decimal number between 0 and 127 representing the value of an ASCII character. cc A decimal number between 0 and 31, or else ex- actly 127, representing the value of an ASCII control character. [ ] Any field in brackets is optional. {x,y ,z} Alternatives are listed in braces. kermit command line options may specify either actions or settings. If kermit is invoked with a command line that specifies no actions, then it will issue a prompt and begin interactive dialog. Action options specify either protocol transactions or terminal connection. April, 1990 1
kermit(1C) kermit(1C)FLAG OPTIONS -s fn Send the specified file or files. If fn contains metacharacters, the A/UX shell expands it into a list. If fn is -, then kermit sends from standard input, which must come from a file: kermit -s - < foo.bar or a parallel process: ls -l | kermit -s - You cannot use this mechanism to send terminal type in. If you want to send a file whose name is -, you can precede it with a path name, as in kermit -s ./- -r Receive a file or files. Wait passively for files to arrive. -k Receive (passively) a file or files, sending them to standard output. This option can be used in several ways: kermit -k displays the incoming files on your screen; to be used only in ``local mode'' (see below). kermit -k > fn1 sends the incoming file or files to the named file, fn1. If more than one file arrives, all are con- catenated together into the single file fn1. kermit -k | command pipes the incoming data (single or multiple files) to the indicated command, as in kermit -k | sort > sorted.stuff -a fn1 If you have specified a file transfer option, you may specify an alternate name for a single file with the -a option. For example, kermit -s foo -a bar sends the file foo telling the receiver that its 2 April, 1990
kermit(1C) kermit(1C)name is bar. If more than one file arrives or is sent, only the first file is affected by the -a op- tion: kermit -ra baz stores the first incoming file under the name baz. -x Begin server operation. May be used in either local or remote mode. Before proceeding, a few words about remote and local opera- tion are necessary. kermit is ``local'' if it is running on a personal computer or workstation that you are using directly, or if it is running on a multiuser system and transferring files over an external communication line, not your job's controlling terminal or console. kermit is re- mote if it is running on a multiuser system and transferring files over its own controlling terminal's communication line, connected to your personal computer or workstation. If you are running kermit on a personal computer, it is in local mode by default, with the ``back port'' designated for file transfer and terminal connection. If you are running kermit on a multiuser (timesharing) system, it is in remote mode unless you explicitly point it at an external line for file transfer or terminal connection. The following command sets kermit's ``mode'': -l dev Line; specify a terminal line to use for file transfer and terminal connection, as in kermit -l /dev/ttyi5 When an external line is being used, you might also need some additional options for successful communi- cation with the remote system: -b n Baud; specify the baud rate for the line given in the -l option, as in kermit -l /dev/ttyi5 -b 9600 This option should always be included with the -l option, since the speed of an external line is not necessarily what you expect. -p x Parity; e, o, m, s, n (even, odd, mark, space, or none). If parity is other than none, then the 8th- bit prefixing mechanism will be used for transfer- ring 8-bit binary data, provided the opposite kermit agrees. The default parity is none. April, 1990 3
kermit(1C) kermit(1C)-t Specifies half duplex, line turnaround with XON as the handshake character. The following commands may be used only with a kermit which is local, either by default or else because the -l option has been specified. -g rfn Actively request a remote server to send the named file or files; rfn is a file specification in the remote host's own syntax. If fn happens to contain any special shell characters, like *, these must be quoted, as in kermit -g x\*.\? -f Send a ``finish'' command to a remote server. -c Establish a terminal connection over the specified or default communication line, before any protocol transaction takes place. Get back to the local sys- tem by typing the escape character (normally CONTROL-Backslash) followed by the letter c. -n Like -c, but after a protocol transaction takes place; -c and -n may both be used in the same com- mand. The use of -n and -c is illustrated below. On a timesharing system, the -l and -b options will also have to be included with the -r, -k, or -s options if the other kermit is on a remote system. If kermit is in local mode, the screen (standard output) is continuously updated to show the progress of the file tranfser. A dot is printed for every four data packets, other packets are shown by type (for example, S for Send- Init), T is printed when there's a timeout, and % for each retransmission. In addition, you may type (to standard in- put) certain ``interrupt'' commands during file transfer: CONTROL-F Interrupt the current file, and go on to the next (if any). CONTROL-B Interrupt the entire batch of files, terminate the transaction. CONTROL-R Resend the current packet CONTROL-A Display a status report for the current transac- tion. 4 April, 1990
kermit(1C) kermit(1C)These interrupt characters differ from the ones used in oth- er kermit implementations to avoid conflict with A/UX shell interrupt characters. With System III and System V imple- mentations of the UNIX system, interrupt commands must be preceded by the escape character (e.g. CONTROL-\). Several other command-line options are provided: -i Specifies that files should be sent or received ex- actly ``as is'' with no conversions. This option is necessary for transmitting binary files. It may also be used to slightly boost efficiency in UNIX- to-UNIX transfers of text files by eliminating car- riage return-linefeed/newline conversion. -w Write-Protect; avoid filename collisions for incom- ing files. -q Quiet; suppress screen update during file transfer, for instance to allow a file transfer to proceed in the background. -d Debug; record debugging information in the file debug.log in the current directory. Use this option if you believe the program is misbehaving, and show the resulting log to your local kermit maintainer. -h Help; display a brief synopsis of the command line options. The command line may contain no more than one protocol ac- tion option. INTERACTIVE OPERATION kermit's interactive command prompt is C-Kermit> In response to this prompt, you may type any valid command. kermit executes the command and then prompts you for another command. The process continues until you instruct the pro- gram to terminate. Commands begin with a keyword, normally an English verb, such as ``send''. You may omit trailing characters from any keyword, so long as you specify sufficient characters to distinguish it from any other keyword valid in that field. Certain commonly-used keywords (such as ``send'', ``re- ceive'', ``connect'') have special nonunique abbreviations (``s''for send, (``r''for receive, (``c''for connect). April, 1990 5
kermit(1C) kermit(1C)Certain characters have special functions in interactive commands: ? Question mark, typed at any point in a command, will produce a message explaining what is possible or ex- pected at that point. Depending on the context, the message may be a brief phrase, a menu of keywords, or a list of files. ESC The ESCAPE or ALTMODE key; request completion of the current keyword or filename, or insertion of a de- fault value. The result will be a beep if the re- quested operation fails. DEL The DELETE or RUBOUT key; delete the previous char- acter from the command. You may also use BS (, CONTROL-H) for this function. ^W CONTROL-W; erase the rightmost word from the command line. ^U CONTROL-U; erase the entire command. ^R CONTROL-R; redisplay the current command. SP Space; Delimits fields (keywords, filenames, numbers) within a command. HT (Horizontal Tab) may also be used for this purpose. CR Carriage return; enters the command for execution. LF linefeed or FF (formfeed) may also be used for this purpose. \ Backslash; enter any of the above characters into the command, literally. To enter a backslash, type two backslashes in a row (\\). A single backslash immediately preceding a carriage return allows you to continue the command on the next line. You may type the editing characters (DEL, ^W, etc.) repeat- edly, to delete all the way back to the prompt. No action will be performed until the command is entered by typing carriage return, linefeed, or formfeed. If you make any mistakes, you will receive an informative error message and a new prompt; make liberal use of ? and ESC to feel your way through the commands. One important command is help; you should use it the first time you run kermit. Interactive kermit accepts commands from files as well as from the keyboard. When you enter interactive mode, kermit looks for the file .kermrc in your home or current directory (first it looks in the home directory, then in the current 6 April, 1990
kermit(1C) kermit(1C)one) and executes any commands it finds there. These com- mands must be in interactive format, not A/UX command-line format. A ``take'' command is also provided for use at any time during an interactive session. Command files may be nested to any reasonable depth. Here is a brief list of kermit interactive commands: ! Execute an A/UX shell command. bye Terminate and logout a remote kermit server. close Close a log file. connect Establish a terminal connection to a remote system. cwd Change working directory. dial Dial a telephone number. directory Display a directory listing. echo Display arguments literally. exit Exit from the program, closing any open logs. finish Instruct a remote kermit server to exit, but not log out. get Get files from a remote kermit server. help Display a help message for a given com- mand. log Open a log file - debugging, packet, session, transaction. quit Same as ``exit''. receive Passively wait for files to arrive. remote Issue file management commands to a re- mote kermit server. script Execute a login script with a remote system. send Send files. April, 1990 7
kermit(1C) kermit(1C)server Begin server operation. set Set various parameters. show Display values of ``set'' parameters. space Display current disk space usage. statistics Display statistics about most recent transaction. take Execute commands from a file. The ``set'' parameters are: block-check Level of packet error detection. delay How long to wait before sending first packet. duplex Specify which side echoes during ``con- nect''. escape-character Character to prefix ``escape commands'' during connect. file Set various file parameters. flow-control Communication line full-duplex flow control. handshake Communication line half-duplex tur- naround character. line Communication line device name. modem-dialer Type of modem-dialer on communication line. parity Communication line character parity. prompt Change the kermit program's prompt. receive Set various parameters for inbound packets. send Set various parameters for outbound packets. speed Communication line speed. 8 April, 1990
kermit(1C) kermit(1C)The ``remote'' commands are: cwd Change remote working directory. delete Delete remote files. directory Display a listing of remote file names. help Request help from a remote server. host Issue a command to the remote host in its own command language. space Display current disk space usage on re- mote system. type Display a remote file on your screen. who Display who's logged in, or get infor- mation about a user. FILES /usr/bin/kermit $HOME/.kermrc kermit initialization commands ./.kermrc more kermit initialization commands SEE ALSO cu(1C), uucp(1C). Kermit User's Guide, Frank da Cruz and Bill Catchings, Columbia University, 6th Edition. DIAGNOSTICS The diagnostics produced by kermit itself are intended to be self-explanatory. BUGS See recent issues of the Info-Kermit digest (on ARPANET or Usenet), or the file ckuker.bwr, for a list of bugs. April, 1990 9