Annotation of coherent/a/usr/man/COHERENT/ckermit, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: ckermit                      Command                      ckermit
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Interactive inter-system communication and file transfer
        !             9: 
        !            10: cckkeerrmmiitt [-aabbccddeeffgghhiikkllppqqrrssttwwxx] [ _f_i_l_e ... ]
        !            11: 
        !            12: cckkeerrmmiitt implements  the kkeerrmmiitt communications  protocol.  It lets
        !            13: you communicate  with other systems via modem  or network, and to
        !            14: exchange files with  other systems that have also implemented the
        !            15: kkeerrmmiitt protocol.   Unlike the  kkeerrmmiitt command also  included with
        !            16: the COHERENT system,  cckkeerrmmiitt uses an interactive shell to remove
        !            17: some of the pain from  the process of exchanging files.  The name
        !            18: cckkeerrmmiitt relects  the fact that  this command is written  in the C
        !            19: language, and  so has been ported to  many different machines and
        !            20: operating systems.
        !            21: 
        !            22: You can  run cckkeerrmmiitt in either _i_n_t_e_r_a_c_t_i_v_e  _m_o_d_e or _c_o_m_m_a_n_d _m_o_d_e.
        !            23: Simply typing the command
        !            24: 
        !            25: 
        !            26:         ckermit
        !            27: 
        !            28: 
        !            29: invokes cckkeerrmmiitt  in interactive mode: cckkeerrmmiitt  displays a prompt,
        !            30: waits for  your command, executes, then prompts  you for its next
        !            31: command.   Typing the  command line  plus  one or  more arguments
        !            32: invokes cckkeerrmmiitt in command mode: cckkeerrmmiitt then reads the arguments
        !            33: from the command line  and executes them.  After execution of the
        !            34: commands, cckkeerrmmiitt returns to interactive mode.
        !            35: 
        !            36: cckkeerrmmiitt's command-line  options name either  actions or settings.
        !            37: An action option tells cckkeerrmmiitt to send a file, receive a file, or
        !            38: connect to a remote system.  The command line may contain no more
        !            39: than one action option.  A settings option changes one or more of
        !            40: the  internal  values  that  control  how cckkeerrmmiitt  operates;  for
        !            41: example, one  setting option  lets you set  the baud rate  of the
        !            42: serial  port that  cckkeerrmmiitt  will be  using.  A  command line  can
        !            43: contain any number of settings options.
        !            44: 
        !            45: ***** Command-Line Options *****
        !            46: 
        !            47: cckkeerrmmiitt recognizes the following command-line options:
        !            48: 
        !            49: -aa _f_i_l_e_n_a_m_e
        !            50:      Give  an alternate  name to a  file being  transferred.  For
        !            51:      example, the command
        !            52: 
        !            53: 
        !            54:         ckermit -s foo -a bar
        !            55: 
        !            56: 
        !            57: transmits the  file ffoooo to a remote system,  but tells the remote
        !            58: system that the file is named bbaarr. Likewise, the command
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: ckermit                      Command                      ckermit
        !            70: 
        !            71: 
        !            72: 
        !            73:         ckermit -ra baz
        !            74: 
        !            75: 
        !            76: stores the first incoming file under the name bbaazz.
        !            77: 
        !            78: If more than one file arrives  or is sent, only the first file is
        !            79: affected by the -aa option.
        !            80: 
        !            81: -bb _b_a_u_d_r_a_t_e
        !            82:      Set the baud rate of the device to _b_a_u_d_r_a_t_e.
        !            83: 
        !            84: -cc   Connect to  serial port, and  pass all subsequent  typing to
        !            85:      that port  To resume talking to your  local system, type the
        !            86:      escape  character followed  by the  letter `c'.   The escape
        !            87:      character is  set by default  to <ccttrrll-\>, although  you can
        !            88:      change it if you wish.
        !            89: 
        !            90: -dd   Debug  mode  -- record  debugging  information  in the  file
        !            91:      ddeebbuugg.lloogg in the current directory.
        !            92: 
        !            93: -ee _n Set  the length  of the  packet  to _n  where _n  is a  number
        !            94:      between  ten and  about  1,000.  Lengths  of  95 or  greater
        !            95:      require  that the  implementation  of kkeerrmmiitt  on the  remote
        !            96:      system  support  the  long-packet  extension to  the  kkeerrmmiitt
        !            97:      protocol.
        !            98: 
        !            99: -ff   Send a ``finish'' command to a remote server.
        !           100: 
        !           101: -gg _f_i_l_e
        !           102:      Ask a  remote system  to send _f_i_l_e  or _f_i_l_e_s. The  file name
        !           103:      must use the remote  system's own syntax; you must quote all
        !           104:      characters normally expanded by the COHERENT shell, e.g.:
        !           105: 
        !           106: 
        !           107:         ckermit -g x\*.\?
        !           108: 
        !           109: 
        !           110: -hh   Help  --  display  a  brief  synopsis  of  the  command-line
        !           111:      options.
        !           112: 
        !           113: -ii   The   ``image''  option:   specify  that   the   file  being
        !           114:      transmitted  or received  is an  eight-bit binary  file, and
        !           115:      therefore no  conversion should  be performed upon  the data
        !           116:      being received.
        !           117: 
        !           118: -kk   Passively receive  file or  files, copying them  to standard
        !           119:      output.
        !           120: 
        !           121: -ll _d_e_v_i_c_e
        !           122:      Name the serial device to be used.  For example
        !           123: 
        !           124: 
        !           125: 
        !           126: 
        !           127: 
        !           128: 
        !           129: 
        !           130: COHERENT Lexicon                                           Page 2
        !           131: 
        !           132: 
        !           133: 
        !           134: 
        !           135: ckermit                      Command                      ckermit
        !           136: 
        !           137: 
        !           138: 
        !           139:         ckermit -l /dev/com2
        !           140: 
        !           141: 
        !           142: tells cckkeerrmmiitt to use device /ddeevv/ccoomm22.
        !           143: 
        !           144: -nn   Like -cc, but used after a protocol transaction has occurred.
        !           145:      You can use both -cc and -nn in the same command.
        !           146: 
        !           147: -pp _x Set  parity,  where   _x  is  one  of  ee,  oo,   mm,  ss,  or  nn
        !           148:      (respectively, even, odd,  mark, space, or none).  If parity
        !           149:      is  other  than  none,  then  cckkeerrmmiitt  uses  the  eighth-bit
        !           150:      prefixing  mechanism to transfer  binary data,  provided the
        !           151:      impementation of  kkeerrmmiitt on  the remote system  agrees.  The
        !           152:      default parity is none.
        !           153: 
        !           154: -qq   Quiet --  suppress screen  update during file  transfer; for
        !           155:      example, this lets you transfer a file in the background.
        !           156: 
        !           157: -rr   Receive  a  file  or files.   Wait  passively  for files  to
        !           158:      arrive.
        !           159: 
        !           160: -ss _f_i_l_e
        !           161:      Send the specified _f_i_l_e or  _f_i_l_e_s. If _f_n is `-' then cckkeerrmmiitt
        !           162:      sends from standard input, which may come from a file:
        !           163: 
        !           164: 
        !           165:         ckermit -s - < foo.bar
        !           166: 
        !           167: 
        !           168: or come from a parallel process:
        !           169: 
        !           170: 
        !           171:         ls -l | ckermit -s -
        !           172: 
        !           173: 
        !           174: You  cannot  use  this mechanism  to  send  text  typed from  the
        !           175: keyboard.  To send a file named `-', precede it with a path name,
        !           176: e.g.:
        !           177: 
        !           178: 
        !           179:         ckermit -s ./-
        !           180: 
        !           181: 
        !           182: -tt   Specify  half  duplex,  line  turnaround  with  XON  as  the
        !           183:      handshake character.
        !           184: 
        !           185: -ww   Write-Protect  -- avoid  file-name  collisions for  incoming
        !           186:      files.
        !           187: 
        !           188: -xx   Begin server  operation.  This option can  be used in either
        !           189:      local or remote mode.
        !           190: 
        !           191: If   cckkeerrmmiitt is  in local  mode, shows the  progress of  the file
        !           192: transfer.  A  dot is printed  for every four  data packets; other
        !           193: packets  are shown  by  type (e.g.,  `S' for  Send-Init); `T'  is
        !           194: 
        !           195: 
        !           196: COHERENT Lexicon                                           Page 3
        !           197: 
        !           198: 
        !           199: 
        !           200: 
        !           201: ckermit                      Command                      ckermit
        !           202: 
        !           203: 
        !           204: 
        !           205: printed  when there's  a  timeout; and  `%' is  printed for  each
        !           206: retransmission.
        !           207: 
        !           208: During file  transfer, you  can type the  following ``interrupt''
        !           209: commands:
        !           210: 
        !           211: <ccttrrll-FF>
        !           212:      Interrupt the current file and go on to the next, if any.
        !           213: 
        !           214: <ccttrrll-BB>
        !           215:      Interrupt  the  entire  batch  of  files and  terminate  the
        !           216:      transaction.
        !           217: 
        !           218: <ccttrrll-RR>
        !           219:      Resend the current packet.
        !           220: 
        !           221: <ccttrrll-AA>
        !           222:      Display a status report for the current transaction.
        !           223: 
        !           224: These  interrupt characters  differ from the  ones used  in other
        !           225: implementations of  cckkeerrmmiitt to  avoid conflict with  the COHERENT
        !           226: shell's interrupt characters.
        !           227: 
        !           228: ***** Interactive Operation *****
        !           229: 
        !           230: When  you invoke  cckkeerrmmiitt in  interactive  mode, it  displays the
        !           231: following prompt.
        !           232: 
        !           233: 
        !           234:         C-Kermit>
        !           235: 
        !           236: 
        !           237: Type  any valid  cckkeerrmmiitt command;  the set  of valid  commands is
        !           238: described below.   cckkeerrmmiitt executes the command  and then prompts
        !           239: you  for another.   The process  continues until  you tell  it to
        !           240: quit.
        !           241: 
        !           242: Commands begin with a  keyword, normally an English verb, such as
        !           243: sseenndd. You can abbreviate any  keyword, as long as you type enough
        !           244: characters to  distinguish it  from all other  keywords.  Certain
        !           245: commonly  used  keywords  (e.g.,  sseenndd,  rreecceeiivvee,  ccoonnnneecctt)  hhaavvee
        !           246: ssppeecciiaall  nnoonn-uunniiqquuee aabbbbrreevviiaattiioonnss  (rreessppeeccttiivveellyy,  `ss', `rr',  aanndd
        !           247: `cc').
        !           248: 
        !           249: CCeerrttaaiinn   cchhaarraacctteerrss  hhaavvee   ssppeecciiaall  ffuunnccttiioonnss   iinn  iinntteerraaccttiivvee
        !           250: ccoommmmaannddss:
        !           251: 
        !           252: ?    Print a  message that explains what  is possible or expected
        !           253:      at the  current point within a  command.  Depending upon the
        !           254:      context,  the  message may  be  a brief  phrase,  a menu  of
        !           255:      keywords, or a list of files.
        !           256: 
        !           257: <eesscc>
        !           258:      Request completion  of the current keyword  or file name, or
        !           259:      insertion  of a  default value.   cckkeerrmmiitt  will beep  if the
        !           260: 
        !           261: 
        !           262: COHERENT Lexicon                                           Page 4
        !           263: 
        !           264: 
        !           265: 
        !           266: 
        !           267: ckermit                      Command                      ckermit
        !           268: 
        !           269: 
        !           270: 
        !           271:      requested operation fails.  <ttaabb> does the same thing.
        !           272: 
        !           273: <ddeell>
        !           274:      Delete the previous character from the command.  <bbaacckkssppaaccee>
        !           275:      does the same thing.
        !           276: 
        !           277: <ccttrrll-WW>
        !           278:      Erase the rightmost word from the command line.
        !           279: 
        !           280: <ccttrrll-UU>
        !           281:      Erase the entire command.
        !           282: 
        !           283: <ccttrrll-RR>
        !           284:      Redisplay the current command.
        !           285: 
        !           286: <ssppaaccee>
        !           287:      Delimit  fields  (keywords,  filenames,  numbers)  within  a
        !           288:      command.
        !           289: 
        !           290: <rreettuurrnn>
        !           291:      Execute the command.
        !           292: 
        !           293: \    Insert  any  of  the  above  characters  into  the  command,
        !           294:      literally.    To  enter  a   literal  backslash,   type  two
        !           295:      backslashes in a row (\\).  Typing one backslash immediately
        !           296:      <rreettuurrnn> lets you continue the command on the next line.
        !           297: 
        !           298: cckkeerrmmiitt recognizes the following interactive commands:
        !           299: 
        !           300: ! _c_o_m_m_a_n_d
        !           301:      Execute a shell command.  A space must follow the !.
        !           302: 
        !           303: %    A comment.  cckkeerrmmiitt ignores everything that follows the %.
        !           304: 
        !           305: bbyyee  Terminate and log out a remote kkeerrmmiitt server.
        !           306: 
        !           307: cclloossee
        !           308:      Close a log file.
        !           309: 
        !           310: ccoonnnneecctt
        !           311:      Connect to the remote system.
        !           312: 
        !           313: ccwwdd _d_i_r_e_c_t_o_r_y
        !           314:      Change the working directory to _d_i_r_e_c_t_o_r_y.
        !           315: 
        !           316: ddiiaall Dial a telephone number.
        !           317: 
        !           318: ddiirreeccttoorryy
        !           319:      Display a directory listing.
        !           320: 
        !           321: eecchhoo Display arguments literally.  Useful in take-command files.
        !           322: 
        !           323: eexxiitt Exit from the program, closing any open logs.
        !           324: 
        !           325: 
        !           326: 
        !           327: 
        !           328: COHERENT Lexicon                                           Page 5
        !           329: 
        !           330: 
        !           331: 
        !           332: 
        !           333: ckermit                      Command                      ckermit
        !           334: 
        !           335: 
        !           336: 
        !           337: ffiinniisshh
        !           338:      Instruct a remote  kkeerrmmiitt server to exit, but not log out.
        !           339: 
        !           340: ggeett  Get files from a remote  kkeerrmmiitt server.
        !           341: 
        !           342: hhaanngguupp
        !           343:      Hang up the telephone.
        !           344: 
        !           345: hheellpp Display a help message for a given command.
        !           346: 
        !           347: lloogg  Open a log file -- debugging, packet, session, transaction.
        !           348: 
        !           349: qquuiitt Same as eexxiitt.
        !           350: 
        !           351: rreecceeiivvee
        !           352:      Passively wait for files to arrive.
        !           353: 
        !           354: rreemmoottee
        !           355:      Issue file-management commands to a remote kkeerrmmiitt server.
        !           356: 
        !           357: ssccrriipptt
        !           358:      Execute a login script with a remote system.
        !           359: 
        !           360: sseenndd _f_i_l_e
        !           361:      Send _f_i_l_e to the remote kkeerrmmiitt server.
        !           362: 
        !           363: sseerrvveerr
        !           364:      Begin server operation.
        !           365: 
        !           366: sseett  Set various internal parameters.
        !           367: 
        !           368: sshhooww Display values of parameters, program version, etc.
        !           369: 
        !           370: ssppaaccee
        !           371:      Display current disk space usage.
        !           372: 
        !           373: ssttaattiissttiiccss
        !           374:      Display statistics about most recent transaction.
        !           375: 
        !           376: ttaakkee Execute commands from a file.
        !           377: 
        !           378: Interactive  cckkeerrmmiitt accepts  commands from files as well as from
        !           379: the keyboard.   Upon startup, cckkeerrmmiitt looks  for the file .kkeerrmmrrcc
        !           380: first in directory $HHOOMMEE and then in the current directory; if it
        !           381: finds the file, it executes all commands it finds therein.  These
        !           382: commands  must be  in interactive format.   Command files  may be
        !           383: nested to any reasonable depth.
        !           384: 
        !           385: ***** The set Command *****
        !           386: 
        !           387: As  noted  above,  the sseett  command  lets  you  set the  internal
        !           388: parameters by which cckkeerrmmiitt operates.  The sseett command recognizes
        !           389: the following arguments:
        !           390: 
        !           391: 
        !           392: 
        !           393: 
        !           394: COHERENT Lexicon                                           Page 6
        !           395: 
        !           396: 
        !           397: 
        !           398: 
        !           399: ckermit                      Command                      ckermit
        !           400: 
        !           401: 
        !           402: 
        !           403: bblloocckk-cchheecckk
        !           404:      Level of packet error detection.
        !           405: 
        !           406: ddeellaayy
        !           407:      Time to wait before sending first packet.
        !           408: 
        !           409: dduupplleexx
        !           410:      Specify which side echoes during connect mode.
        !           411: 
        !           412: eessccaappee-cchhaarraacctteerr
        !           413:      Character to prefix _e_s_c_a_p_e _c_o_m_m_a_n_d_s during connect mode.
        !           414: 
        !           415: ffiillee Set various file parameters.
        !           416: 
        !           417: ffllooww-ccoonnttrrooll
        !           418:      Communication line full-duplex flow control.
        !           419: 
        !           420: hhaannddsshhaakkee
        !           421:      Communication line half-duplex turnaround character.
        !           422: 
        !           423: lliinnee Communication-line device name.
        !           424: 
        !           425: mmooddeemm-ddiiaalleerr
        !           426:      Type of modem-dialer on communication line.
        !           427: 
        !           428: ppaarriittyy
        !           429:      Communication line character parity.
        !           430: 
        !           431: pprroommpptt
        !           432:      Change the  cckkeerrmmiitt program's prompt.
        !           433: 
        !           434: rreecceeiivvee
        !           435:      Set various parameters for inbound packets.
        !           436: 
        !           437: rreettrryy
        !           438:      Set the packet retransmission limit.
        !           439: 
        !           440: sseenndd Set various parameters for outbound packets.
        !           441: 
        !           442: ssppeeeedd
        !           443:      Communication line speed.
        !           444: 
        !           445: ***** Remote Commands *****
        !           446: 
        !           447: cckkeerrmmiitt also has a suite of  commands that are sent to the remote
        !           448: system for execution.  They are as follows:
        !           449: 
        !           450: ccwwdd  Change remote working directory (also, rreemmoottee ccdd).
        !           451: 
        !           452: ddeelleettee
        !           453:      Delete remote files.
        !           454: 
        !           455: ddiirreeccttoorryy
        !           456:      Display a listing of remote file names.
        !           457: 
        !           458: 
        !           459: 
        !           460: COHERENT Lexicon                                           Page 7
        !           461: 
        !           462: 
        !           463: 
        !           464: 
        !           465: ckermit                      Command                      ckermit
        !           466: 
        !           467: 
        !           468: 
        !           469: hheellpp Request help from a remote server.
        !           470: 
        !           471: hhoosstt Issue  a  command to  the  remote host  in  its own  command
        !           472:      language.
        !           473: 
        !           474: ssppaaccee
        !           475:      Display current disk space usage on remote system.
        !           476: 
        !           477: ttyyppee Display a remote file on your screen.
        !           478: 
        !           479: wwhhoo  Display the  users logged  in to  the remote system,  or get
        !           480:      information about a user.
        !           481: 
        !           482: ***** Files *****
        !           483: 
        !           484: .kkeerrmmrrcc -- cckkeerrmmiitt initialization commands
        !           485: 
        !           486: ***** See Also *****
        !           487: 
        !           488: ccoommmmaannddss, kkeerrmmiitt, uuuuccpp
        !           489: 
        !           490: ***** Notes *****
        !           491: 
        !           492: The  kkeerrmmiitt protocol  was  developed at  the Columbia  University
        !           493: Center for Computing Activities.
        !           494: 
        !           495: 
        !           496: 
        !           497: 
        !           498: 
        !           499: 
        !           500: 
        !           501: 
        !           502: 
        !           503: 
        !           504: 
        !           505: 
        !           506: 
        !           507: 
        !           508: 
        !           509: 
        !           510: 
        !           511: 
        !           512: 
        !           513: 
        !           514: 
        !           515: 
        !           516: 
        !           517: 
        !           518: 
        !           519: 
        !           520: 
        !           521: 
        !           522: 
        !           523: 
        !           524: 
        !           525: 
        !           526: COHERENT Lexicon                                           Page 8
        !           527: 
        !           528: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.