.TH KERMIT 1C LOCAL .SH NAMEkermit \- kermit file transfer.SH SYNOPSIS.B kermit[ option ...] [file ...].SH DESCRIPTION.I Kermitis a file transfer program that allows files to be movedbetween machines of many different operating systems and architectures.This man page describes version 4C of the program..PPArguments are optional. If.I Kermitis executed without arguments, it will enter command mode. Otherwise,.I kermitwill read the arguments off the command line and interpret them..RE 1.PPThe following notation is used in command descriptions:.RE 1.TP 8.I fnA Unix file specification, possibly containing either of the "wildcard"characters '*' or '?' ('*' matches all character strings, '?' matchesany single character)..TP.I fn1A Unix file specification which may not contain '*' or '?'..TP.I rfnA remote file specification in the remote system's own syntax, which maydenote a single file or a group of files..TP.I rfn1A remote file specification which should denote only a single file..TP.I nA decimal number between 0 and 94..TP.I cA decimal number between 0 and 127 representing the value of an ASCIIcharacter..TP.I ccA decimal number between 0 and 31, or else exactly 127, representing thevalue of an ASCII control character..TP.B [ ]Any field in square braces is optional..TP{\fIx,y,z\fR}Alternatives are listed in curly braces..RE 1.PP.I Kermitcommand line options may specify either actions or settings.  If.I Kermitis invoked with a command line that specifies no actions, then it willissue a prompt and begin interactive dialog.  Action options specifyeither protocol transactions or terminal connection..RE.SS COMMAND LINE OPTIONS.TP 8.BI \-s " fn"Send the specified file or files. If.I fncontains wildcard (meta) characters, the Unix shell expands it into alist.  If.I fnis '-' then.I Kermitsends from standard input, which must come from a file:  .sp 0.6v            kermit -s - < foo.bar.sp 0.6vor a parallel process:  .sp 0.6v            ls -l | kermit -s -.IPYou cannot use this mechanism to send terminal typein.  If you want tosend a file whose name is "-" you can precede it with a path name, as in.sp 0.6v            kermit -s ./-.TP.B \-rReceive a file or files.  Wait passively for files to arrive..TP.B \-kReceive (passively) a file or files, sending them to standard output.This option can be used in several ways:.sp 0.6v        kermit -k.IPDisplays the incoming files on your screen; to be used only in "localmode" (see below)..sp 0.6v        kermit -k > fn1.IPSends the incoming file or files to the named file,.I fn1.If more thanone file arrives, all are concatenated together into the single file.I fn1..sp 0.6v        kermit -k | command.IPPipes the incoming data (single or multiple files) to the indicatedcommand, as in.sp 0.6v        kermit -k | sort > sorted.stuff.TP.BI \-a " fn1"If you have specified a file transfer option, you may specify analternate name for a single file with the.B -aoption.  For example,.sp 0.6v        kermit -s foo -a bar.IPsends the file foo telling the receiver that its name is bar.  If morethan one file arrives or is sent, only the first file is affected by the.B \-aoption:  .sp 0.6v        kermit -ra baz.IPstores the first incoming file under the name baz..TP.B \-xBegin server operation.  May be used in either local or remote mode..RE 1.PPBefore proceeding, a few words about remote and local operation are  necessary..I Kermitis "local" if it is running on a PC or workstation that you are usingdirectly, or if it is running on a multiuser system and transferringfiles over an external communication line \(em not your job's controllingterminal or console..I Kermitis remote if it is running on a multiuser system and transferring filesover its own controlling terminal's communication line, connected toyour PC or workstation..PPIf you are running .I Kermiton a PC, it is in local mode by default, with the "back port" designatedfor file transfer and terminal connection.  If you are running.I Kermiton a multiuser (timesharing) system, it is in remote mode unless youexplicitly point it at an external line for file transfer or terminalconnection.  The following command sets.IR Kermit 's"mode":.RE 1.TP 8.BI \-l " dev"Line \(em Specify a terminal line to use for file transfer and terminalconnection, as in.sp 0.6v            kermit -l /dev/ttyi5.RE 1.PPWhen an external line is being used, you might also need some additionaloptions for successful communication with the remote system:.TP.BI \-b " n"Baud \(em Specify the baud rate for the line given in the.B \-l option, as in.sp 0.6v            kermit -l /dev/ttyi5 -b 9600.IPThis option should always be included with the.B  \-loption, since the speed of an external line is not necessarily what youexpect..TP.BI \-p " x"Parity \(em.BR e ,.BR o ,.BR m ,.BR s ,.B  n(even, odd, mark, space, or none).  If parity is other than none, thenthe 8th-bit prefixing mechanism will be used for transferring 8-bitbinary data, provided the opposite.I Kermitagrees. The default parity is none..TP.B \-tSpecifies half duplex, line turnaround with XON as the handshakecharacter..RE 1.PPThe following commands may be used only with a .I Kermitwhich is local \(em either by default or else because the.B  \-loption has been specified..TP 8.BI \-g " rfn"Actively request a remote server to send the named file or files;.I rfnis a file specification in the remote host's own syntax.  If.I fnhappens to contain any special shell characters, like '*', these must bequoted, as in.sp 0.6v            kermit -g x\\*.\\?.TP.B \-fSend a 'finish' command to a remote server..TP.B \-cEstablish a terminal connection over the specified or defaultcommunication line, before any protocol transaction takes place.  Getback to the local system by typing the escape character (normallyControl-Backslash) followed by the letter 'c'..TP.B \-nLike.B \-c,but after a protocol transaction takes place;.B \-cand.B \-nmay both be used in the same command.  The use of.B \-nand.B \-cis illustrated below..RE 1.PPOn a timesharing system, the.B \-land .B \-boptions will also have to be included with the.BR \-r ,.BR \-k ,or.B \-soptions if the other .I Kermitis on a remote system..PPIf .I kermitis in local mode, the screen (stdout) is continously updated to show theprogress of the file transer.  A dot is printed for every four datapackets, other packets are shown by type (e.g. 'S' for Send-Init), 'T'is printed when there's a timeout, and '%' for each retransmission.  Inaddition, you may type (to stdin) certain "interrupt" commands duringfile transfer:.IPControl-F:  Interrupt the current File, and go on to the next (if any)..IPControl-B:  Interrupt the entire Batch of files, terminate the transaction..IPControl-R:  Resend the current packet.IPControl-A:  Display a status report for the current transaction..RE.IPThese interrupt characters differ from the ones used in other.I Kermitimplementations to avoid conflict with Unix shell interrupt characters.With System III and System V implementations of Unix, interrupt commandsmust be preceeded by the escape character (e.g. control-\\)..RE.PPSeveral other command-line options are provided:.TP 8.B \-iSpecifies that files should be sent or received exactly "as is" with noconversions.  This option is necessary for transmitting binary files.It may also be used to slightly boost efficiency in Unix-to-Unixtransfers of text files by eliminating CRLF/newline conversion..TP.B \-wWrite-Protect \(em Avoid filename collisions for incoming files..TP.B \-qQuiet \(em Suppress screen update during file transfer, for instance toallow a file transfer to proceed in the background..TP.B \-dDebug \(em Record debugging information in the file debug.log in thecurrent directory.  Use this option if you believe the program ismisbehaving, and show the resulting log to your local.I Kermitmaintainer..TP.B \-hHelp \(em Display a brief synopsis of the command line options..RE 1.PPThe command line may contain no more than one protocol action option..SS INTERACTIVE OPERATION.RE 1.PP.IR Kermit 'sinteractive command prompt is "C-Kermit>". In response to this prompt,you may type any valid command..I Kermitexecutes the command and then prompts you for another command.  Theprocess continues until you instruct the program to terminate..PPCommands begin with a keyword, normally an English verb, such as "send".You may omit trailing characters from any keyword, so long as youspecify sufficient characters to distinguish it from any other keywordvalid in that field.  Certain commonly-used keywords (such as "send","receive", "connect") have special non-unique abbreviations ("s" for"send", "r" for "receive", "c" for "connect")..PPCertain characters have special functions in interactive commands:.PP.TP 8.B ?Question mark, typed at any point in a command, will produce a messageexplaining what is possible or expected at that point.  Depending on thecontext, the message may be a brief phrase, a menu of keywords, or alist of files..TP 8.B ESC(The Escape or Altmode key) \(em Request completion of the current keywordor filename, or insertion of a default value.  The result will be a beepif the requested operation fails..TP 8.B DEL(The Delete or Rubout key) \(em Delete the previous character from thecommand.  You may also use BS (Backspace, Control-H) for this function..TP.B ^W(Control-W) \(em Erase the rightmost word from the command line..TP.B ^U(Control-U) \(em Erase the entire command..TP.B ^R(Control-R) \(em Redisplay the current command..TP.B SP(Space) \(em Delimits fields (keywords, filenames, numbers) within acommand.  HT (Horizontal Tab) may also be used for this purpose..TP.B CR(Carriage Return) \(em Enters the command for execution..B LF(Linefeed) or.B FF(formfeed) may also be used for this purpose..TP.B \e(Backslash) \(em 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 youto continue the command on the next line..RE 1.PPYou may type the editing characters (DEL, ^W, etc) repeatedly, to deleteall the way back to the prompt.  No action will be performed until thecommand is entered by typing carriage return, linefeed, or formfeed.  Ifyou make any mistakes, you will receive an informative error message anda new prompt \(em make liberal use of '?' and ESC to feel your way throughthe commands.  One important command is "help" \(em you should use it thefirst time you run.I Kermit..PPInteractive .I Kermitaccepts commands from files as well as from the keyboard.  When youenter interactive mode,.I Kermitlooks for the file .kermrc in your home or current directory (first itlooks in the home directory, then in the current one) and executes anycommands it finds there.  These commands must be in interactive format,not Unix command-line format.  A "take" command is also provided for useat any time during an interactive session.  Command files may be nestedto any reasonable depth..PPHere is a brief list of .I Kermitinteractive commands:.PD 0.6v.TP 12.B !Execute a Unix shell command..TP.B byeTerminate and log out a remote.I Kermitserver..TP.B closeClose a log file..TP.B connectEstablish a terminal connection to a remote system..TP.B  cwdChange Working Directory..TP.B dialDial a telephone number..TP.B directoryDisplay a directory listing..TP.B echoDisplay arguments literally..TP.B exitExit from the program, closing any open logs..TP.B finishInstruct a remote .I Kermitserver to exit, but not log out..TP.B getGet files from a remote .I Kermitserver..TP.B helpDisplay a help message for a given command..TP.B logOpen a log file \(em debugging, packet, session, transaction..TP.B quitSame as 'exit'..TP.B receivePassively wait for files to arrive..TP.B remoteIssue file management commands to a remote.I Kermitserver..TP.B scriptExecute a login script with a remote system..TP.B sendSend files..TP.B serverBegin server operation..TP.B setSet various parameters..TP.B showDisplay values of 'set' parameters..TP.B spaceDisplay current disk space usage..TP.B statisticsDisplay statistics about most recent transaction..TP.B take Execute commands from a file..sp 1.PPThe 'set' parameters are:.TP 21.B block-checkLevel of packet error detection..TP.B delayHow long to wait before sending first packet..TP.B duplexSpecify which side echoes during 'connect'..TP.B escape-characterCharacter to prefix "escape commands" during 'connect'..TP.B fileSet various file parameters..TP.Bflow-control  Communication line full-duplex flow control..TP.B handshakeCommunication line half-duplex turnaround character..TP.B lineCommunication line device name..TP.B  modem-dialerType of modem-dialer on communication line..TP.B parityCommunication line character parity..TP.B promptChange the .I Kermitprogram's prompt..TP.B receiveSet various parameters for inbound packets..TP.B sendSet various parameters for outbound packets..TP.B speedCommunication line speed..sp 1.PPThe 'remote' commands are:.TP 12.B cwd  Change remote working directory..TP.B delete  Delete remote files..TP.B directory  Display a listing of remote file names..TP.B help  Request help from a remote server..TP.B host  Issue a command to the remote host in its own command language..TP.B  space  Display current disk space usage on remote system..TP.B type  Display a remote file on your screen..TP.B whoDisplay who's logged in, or get information about a user..SH FILES.ta \w"$HOME/.kermrc  "u$HOME/.kermrc	\fIKermit\fR initialization commands.br\&./.kermrc	more \fIKermit\fR initialization commands.PD.SH SEE ALSOcu(1C), uucp(1C).brFrank da Cruz and Bill Catchings,.IR "Kermit User's Guide" ,Columbia University, 6th Edition.SH DIAGNOSTICSThe diagnostics produced by.I Kermititself are intended to be self-explanatory..SH BUGSSee recent issues of the Info-Kermit digest (on ARPANET or Usenet),or the file ckuker.bwr, for a list of bugs.