home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / cku200.zip / ckututor.txt < prev    next >
Text File  |  2001-12-18  |  89KB  |  1,865 lines
  1.  
  2. C-KERMIT 8.0 UNIX MANUAL PAGE AND TUTORIAL
  3.  
  4.      Frank da Cruz, Christine M. Gianone
  5.      [1]The Kermit Project, [2]Columbia University
  6.      
  7.    [ [3]PDF version ] [ [4]Nroff version ]
  8.    
  9.      This document is intended to give the beginner sufficient
  10.      information to make basic (if not advanced) use of C-Kermit 8.0.
  11.      Although it might be rather long for a Unix manual page (about 1600
  12.      lines), it's still far shorter than the C-Kermit manual, which
  13.      should be consulted for advanced topics such as customization,
  14.      character-sets, scripting, etc. We also attempt to provide a clear
  15.      structural overview of C-Kermit's many capabilities, functional
  16.      areas, states, and modes and their interrelation, that should be
  17.      helpful to beginners and veterans alike, as well as to those
  18.      upgrading to the new release. 
  19.      
  20.    Most recent update: 12 December 2001
  21.     ________________________________________________________________________
  22.   
  23.   CONTENTS
  24.      * [5]DESCRIPTION
  25.      * [6]SYNOPSIS
  26.      * [7]OPTIONS
  27.      * [8]COMMAND LANGUAGE
  28.      * [9]INITIALIZATION FILE
  29.      * [10]MODES OF OPERATION
  30.      * [11]MAKING CONNECTIONS
  31.      * [12]TRANSFERRING FILES WITH KERMIT
  32.      * [13]KERMIT'S BUILT-IN FTP AND HTTP CLIENTS
  33.      * [14]INTERNET KERMIT SERVICE
  34.      * [15]SECURITY
  35.      * [16]ALTERNATIVE COMMAND-LINE PERSONALITIES
  36.      * [17]LICENSE
  37.      * [18]OTHER TOPICS
  38.      * [19]DOCUMENTATION AND UPDATES
  39.      * [20]FILES
  40.      * [21]AUTHORS
  41.      _________________________________________________________________
  42.    
  43.    DESCRIPTION [ [22]Top ] [ [23]Contents ] [ [24]Next ]
  44.    
  45.    [25]C-Kermit is an all-purpose communications software package from
  46.    the [26]Kermit Project at [27]Columbia University that:
  47.    
  48.      * Is portable to many platforms, Unix and non-Unix alike.
  49.      * Can make both serial and network connections.
  50.      * Can conduct interactive terminal sessions over its connection.
  51.      * Can transfer text or binary files over the same connection.
  52.      * Can convert text-file character sets in terminal mode or file
  53.        transfer.
  54.      * Is customizable in every aspect of its operation.
  55.        
  56.    C-Kermit is a modem program, a Telnet client, an Rlogin client, an FTP
  57.    client, an HTTP client, and on selected platforms, also an X.25
  58.    client. It can make its own secure Internet connections using
  59.    IETF-approved security methods including Kerberos IV, Kerberos V,
  60.    SSL/TLS, and SRP and it can also make SSH (Secure Shell) connections
  61.    through your external SSH client application. It can be the far-end
  62.    file-transfer or client/server partner of your desktop Kermit client.
  63.    It can also accept incoming dialed and network connections. It can
  64.    even be installed as an Internet service on its own standard TCP
  65.    socket, 1649 [[28]RFC2839, [29]RFC2840].
  66.    
  67.    And perhaps most important, everything you can do "by hand"
  68.    (interactively) with C-Kermit, can be "scripted" (automated) using its
  69.    built-in cross-platform transport-independent script programming
  70.    language, which happens to be identical to its interactive command
  71.    language.
  72.    
  73.    This manual page offers an overview of C-Kermit 8.0 for Unix ("Unix"
  74.    is an operating system family that includes AIX, DG/UX, FreeBSD,
  75.    HP-UX, IRIX, Linux, Mac OS X, NetBSD, OpenBSD, Open Server, Open Unix,
  76.    QNX, Solaris, SunOS, System V R3, System V R4, Tru64 Unix, Unixware,
  77.    Xenix, and many others). For thorough coverage, please consult the
  78.    published C-Kermit manual and supplements (see [30]DOCUMENTATION
  79.    below). For further information about C-Kermit, Kermit software for
  80.    other platforms, and Kermit manuals, visit the Kermit Project website:
  81.    
  82.   [31]http://www.columbia.edu/kermit/
  83.  
  84.    This is a longer-than-average manual page, and yet it barely scratches
  85.    the surface. Don't be daunted. C-Kermit is a large and complex
  86.    package, evolving over decades of practice and experience, but that
  87.    doesn't mean it's hard to learn or use. Its most commonly used
  88.    functions are explained here with pointers to additional information
  89.    elsewhere.
  90.    
  91.    [ [32]Kermit Home ] [ [33]C-Kermit Home ] [ [34]C-Kermit FAQ ]
  92.     ________________________________________________________________________
  93.   
  94.   SYNOPSIS [ [35]Top ] [ [36]Contents ] [ [37]Next ] [ [38]Previous ]
  95.   
  96.    Usage:  kermit [filename] [-x arg [-x arg]...[-yyy]..] [ {=,--,+} text
  97.    ] ]
  98.    Or:    kermit URL
  99.    
  100.      * -x is an option requiring an argument;
  101.      * -y is an option with no argument.
  102.        
  103.    If the first command-line argument is the name of a file,
  104.    interactive-mode commands are executed from the file. The '=' (or
  105.    "--") argument tells Kermit not to parse the remainder of the command
  106.    line, but to make the words following '=' available as \%1, \%2, ...
  107.    \%9. The "+" argument is like "=" but for use in "kerbang scripts"
  108.    (explained [39]below). A second command-line format allows the one and
  109.    only argument to be a [40]Telnet, FTP, HTTP, or IKSD URL.
  110.    
  111.    Order of execution:
  112.    
  113.     1. [41]The command file (if any).
  114.     2. [42]The initialization file, if any, unless suppressed with -Y.
  115.     3. [43]The customization file (if it is executed by the
  116.        initialization file).
  117.     4. [44]The command-line URL (if any, and if so, execution stops
  118.        here).
  119.     5. [45]Command-line options (if any).
  120.     6. [46]Interactive commands.
  121.        
  122.    Some command-line options can cause actions (such as -s to send a
  123.    file); others just set parameters. If any action options are included
  124.    on the command line, Kermit exits when finished unless also given the
  125.    -S ("stay") option. If no action options are given, no initialization
  126.    or command files contained an EXIT or QUIT command, and no fatal
  127.    errors occurred, Kermit issues its prompt and waits for you to type
  128.    commands.
  129.    
  130.      Bear in mind that C-Kermit can be built with selected features
  131.      disabled, and also that certain features are not available on all
  132.      platforms. For example, C-Kermit can't be built with TCP/IP support
  133.      on a platform that does not have TCP/IP header files and libraries
  134.      (and even if Kermit does include TCP/IP support, it can't be used
  135.      to make TCP/IP connections on a computer that does not have a
  136.      TCP/IP stack installed). If your version of C-Kermit lacks a
  137.      feature mentioned here, use its SHOW FEATURES command to see what
  138.      might have been excluded. 
  139.      
  140.    C-Kermit has three kinds of commands: regular single-letter
  141.    command-line options, extended-format command-line options, and
  142.    interactive commands.
  143.    
  144.    [ [47]Kermit Home ] [ [48]C-Kermit Home ] [ [49]C-Kermit FAQ ]
  145.     ________________________________________________________________________
  146.   
  147.   OPTIONS [ [50]Top ] [ [51]Contents ] [ [52]Next ] [ [53]Previous ]
  148.   
  149.    Like most Unix commands, C-Kermit can be be given options on the
  150.    command line. But C-Kermit also can be used interactively by giving it
  151.    [54]commands composed of words, which are more intuitive than cryptic
  152.    command-line options, and more flexible too. In other words, you don't
  153.    have to use C-Kermit's command-line options, but they are available if
  154.    you want to. (By the same token, you don't have to use its interactive
  155.    commands either -- you can use either or both in any combination.)
  156.    
  157.    C-Kermit is generally installed in the PATH as "kermit", and therefore
  158.    is invoked by typing the word "kermit" (lowercase) at the shell
  159.    prompt, and then pressing the Return or Enter key. If you wish to
  160.    include command-line options, put them after the word "kermit" but
  161.    before pressing Return or Enter, separated by spaces, for example:
  162.    
  163.   $ kermit -s ckermit.tar.gz
  164.  
  165.    ('$' is the shell prompt; "kermit -s ckermit.tar.gz" is what you type,
  166.    followed by Return or Enter.)
  167.    
  168.    Here is a list of C-Kermit's single-letter command-line options, which
  169.    start with a single dash (-), in ASCII ("alphabetical") order.
  170.    Alphabetic case is significant (-A is not the same as -a). The Action?
  171.    column contains Y for action options and N for non-action options.
  172.    Option Action? Description
  173.    -0 N (digit zero) 100% transparent Connect state for "in-the-middle"
  174.    operation: 8 bits, no parity, no escape character, everything passes
  175.    through.
  176.    -8 N (digit eight) Connection is 8-bit clean (this is the default in
  177.    C-Kermit 8.0). Equivalent to the EIGHTBIT command, which in turn is a
  178.    shortcut for SET TERMINAL BYTESIZE 8, SET COMMAND BYTESIZE 8, SET
  179.    PARITY NONE.
  180.    -9 arg N (digit nine) Make a connection to an FTP server. Equivalent
  181.    to the FTP OPEN command.
  182.    Argument: IP-address-or-hostname[:optional-TCP-port].
  183.    NOTE: C-Kermit also has a separate FTP command-line personality, with
  184.    regular FTP-like command-line syntax. [55]More about this below.
  185.    -A N Kermit is to be started as an Internet service (IKSD) (only from
  186.    inetd.conf).
  187.    -B N Kermit is running in Batch or Background (no controlling
  188.    terminal). To be used in case Kermit doesn't automatically sense its
  189.    background status. Equivalent to the SET BACKGROUND ON command.
  190.    -C arg N Interactive-mode Commands to be executed.
  191.    Argument: Commands separated by commas, list in doublequotes.
  192.    -D arg N Delay before starting to send in Remote mode. Equivalent to
  193.    the SET DELAY command.
  194.    Argument: Number of seconds.
  195.    -E N Exit automatically when connection closes. Equivalent to SET EXIT
  196.    ON-DISCONNECT ON.
  197.    -F arg N Use an open TCP connection.
  198.    Argument: Numeric file descriptor of open TCP connection.
  199.    Also see: -j, -J.
  200.    -G arg Y Get file(s) from server, send contents to standard output,
  201.    which normally would be piped to another process.
  202.    Argument: Remote file specification, in quotes if it contains
  203.    metacharacters.
  204.    Also see: -g, -k.
  205.    -H N Suppress program startup Herald and greeting.
  206.    -I N Tell Kermit it has a reliable connection, to force streaming to
  207.    be used where it normally would not be. Equivalent to the SET RELIABLE
  208.    ON command.
  209.    -J arg N "Be like Telnet." Like -j but implies -E.
  210.    Argument: IP hostname/address optionally followed by service.
  211.    NOTE: C-Kermit also has a separate Telnet command-line personality,
  212.    with regular Telnet-like command-line syntax. [56]More about this
  213.    below.
  214.    -L N Recursive directory descent for files in -s option.
  215.    -M arg N My user name (for use with Telnet, Rlogin, FTP, etc).
  216.    Equivalent to the SET LOGIN USER command.
  217.    Argument: Username string.
  218.    -O Y (Uppercase letter O) Be a server for One command only. Also see:
  219.    -x.
  220.    -P N Don't convert file (Path) names of transferred files. Equivalent
  221.    to SET FILE NAMES LITERAL.
  222.    -Q N Quick Kermit protocol settings. Equivalent to the FAST command.
  223.    This is the default in C-Kermit 7.0 and later.
  224.    -R N Remote-only (this just makes IF REMOTE true).
  225.    -S N Stay (enter command parser after action options).
  226.    -T N Force Text mode for file transfer; implies -V. Equivalent to SET
  227.    TRANSFER MODE MANUAL, SET FILE TYPE TEXT.
  228.    -V N Disable automatic per-file text/binary switching. Equivalent to
  229.    SET TRANSFER MODE MANUAL.
  230.    -Y N Skip (don't execute) the initialization file.
  231.    -a arg N As-name for file(s) in -s, -r, or -g.
  232.    Argument: As-name string (alternative filename). When receiving files,
  233.    this can be a directory name.
  234.    -b arg N Speed for serial device. Equivalent to SET SPEED.
  235.    Argument: Numeric Bits per second for serial connections.
  236.    -c Y Enter Connect state before transferring files.
  237.    -d N Create a debug.log file with detailed debugging information (a
  238.    second -d adds timestamps). Equivalent to LOG DEBUG but takes effect
  239.    sooner.
  240.    -e arg N Maximum length for incoming Kermit file-transfer packets.
  241.    Equivalent to SET RECEIVE PACKET-LENGTH.
  242.    Argument: Length in bytes.
  243.    -f Y Send a FINISH command to a Kermit server.
  244.    -g arg N Get file(s) from a Kermit server.
  245.    Argument: File specification on other computer, in quotes if it
  246.    contains metacharacters. Equivalent to GET.
  247.    Also see: -a, -G, -r.
  248.    -h Y Print Help text for single-letter command-line options (pipe thru
  249.    'more' to prevent scrolling).
  250.    -i N Force binary (Image) mode for file transfer; implies -V.
  251.    Equivalent to SET TRANSFER MODE MANUAL, SET FILE TYPE BINARY.
  252.    -j arg N Make a TCP/IP connection.
  253.    Argument: IP host name/address and optional service name or number.
  254.    Equivalent to the TELNET command.
  255.    Also see: -J, -F.
  256.    -k Y Receive file(s) to standard output, which normally would be piped
  257.    to another process.
  258.    Also see: -r, -G.
  259.    -l arg N (Lowercase letter L) Make a connection on the given serial
  260.    communications device. Equivalent to the SET LINE (SET PORT) command.
  261.    Argument: Serial device name, e.g. /dev/ttyS0.
  262.    -m arg N Modem type for use with the -l device. Equivalent to the SET
  263.    MODEM TYPE command.
  264.    Argument: Modem name as in SET MODEM TYPE command, e.g. "usrobotics".
  265.    -n Y Enter Connect state after transferring files (historical).
  266.    -p arg N Parity. Equivalent to the SET PARITY command.
  267.    Argument: One of the following: e(ven), o(dd), m(ark), n(one),
  268.    s(pace).
  269.    -q N Quiet (suppress most messages). Equivalent to SET QUIET ON.
  270.    -r Y Receive file(s). Equivalent to the RECEIVE command.
  271.    Argument: (none, but see -a)
  272.    -s arg N Send file(s).
  273.    Argument: One or more local file specifications. Equivalent to the
  274.    SEND command.
  275.    Also see: -a.
  276.    -t N (Historical) Xon (Ctrl-Q) Turnaround character for half-duplex
  277.    connections (used on serial linemode connections to old mainframes).
  278.    Equivalent to SET DUPLEX HALF, SET HANDSHAKE XON.
  279.    -v arg N Window size for Kermit protocol (ignored when streaming).
  280.    Equivalanet to SET WINDOW-SIZE.
  281.    Argument: Number, 1 to 32.
  282.    -w N Incoming files Write over existing files. Equivalent to SET FILE
  283.    COLLISION OVERWRITE.
  284.    -x Y Enter server mode. Equivalent to the SERVER command. Also see:
  285.    -O.
  286.    -y arg N Alternative initialization file.
  287.    Argument: Filename.
  288.    -z N Force foreground behavior. To be used in case Kermit doesn't
  289.    automatically sense its foreground status. Equivalent to the SET
  290.    BACKGROUND OFF command.
  291.    
  292.    Extended command-line options (necessary because single-letter ones
  293.    are about used up) start with two dashes (--), with words rather than
  294.    single letters as option names. If an extended option takes an
  295.    argument, it is separated from the option word by a colon (:).
  296.    Extended options include:
  297.    Option Description
  298.    --bannerfile:filename File to display upon startup or IKSD login.
  299.    --cdfile:filename File to be sent for display to the client when
  300.    server changes directory (filename is relative to the changed-to
  301.    directory).
  302.    --cdmessage:{on,off} Enable/disable the server CD message feature.
  303.    --help Prints usage message for extended options.
  304.    --helpfile:filename Designates a file containing custom text to
  305.    replace the top-level HELP command.
  306.    --nointerrupts Disables keyboard interrupts.
  307.    --noperms Disables the Kermit protocol file Permissions attribute, to
  308.    prevent transmission of file permissions (protection) from sender to
  309.    receiver.
  310.    
  311.    Plus several other [57]IKSD-Only options.
  312.    
  313.    See the [58]file-transfer section for examples of command-line
  314.    invocation.
  315.     ________________________________________________________________________
  316.   
  317.   COMMAND LANGUAGE [ [59]Top ] [ [60]Contents ] [ [61]Next ] [ [62]Previous ]
  318.   
  319.      * [63]Command Files, Macros, and Scripts
  320.      * [64]Command List
  321.        
  322.    C-Kermit's interactive command language is the subject of a
  323.    [65]622-page book and another several hundred pages of updates, far
  324.    too much for a manual page. But it's not hard to get started. At the
  325.    shell prompt, just type "kermit" to get C-Kermit's interactive command
  326.    prompt:
  327.    
  328.   $ kermit
  329.   (/current/directory) C-Kermit>
  330.  
  331.    Begin by typing "help" (and then press the Return or Enter key) for a
  332.    top-level overview, read it, and go from there. Your second command
  333.    should probably be "intro" (introduction). Note the prompt shows your
  334.    current directory (unless you tell Kermit to prompt you with something
  335.    else).
  336.    
  337.    Interactive commands are composed mainly of regular English words,
  338.    usually in the form of imperative sentences, such as:
  339.    
  340.   send oofa.txt
  341.  
  342.    which tells Kermit to send (transfer) the file whose name is oofa.txt,
  343.    or:
  344.    
  345.   set transfer mode automatic
  346.  
  347.    which sets Kermit's "transfer mode" to "automatic" (whatever that
  348.    means).
  349.    
  350.    While typing commands, you can abbreviate, ask for help (by pressing
  351.    the "?" key anywhere in a command), complete keywords or filenames
  352.    (with the Tab or Esc key), and edit your typing with Backspace or
  353.    Delete, Ctrl-W, Ctrl-U, etc. You can also recall previous commands,
  354.    save your command history, and who knows what else. Give the INTRO
  355.    command for details.
  356.    
  357.    C-Kermit has hundreds of commands, and they can be issued in infinite
  358.    variety and combinations, including commands for:
  359.    
  360.      * Making connections (SET LINE, DIAL, TELNET, SSH, FTP, CONNECT,
  361.        ...)
  362.      * Breaking connections (HANGUP, CLOSE)
  363.      * Transferring files (SEND, GET, RECEIVE, MOVE, RESEND, ...)
  364.      * Establishing preferences (SET)
  365.      * Displaying preferences (SHOW)
  366.      * Managing local files (CD, DELETE, MKDIR, DIRECTORY, RENAME, TYPE,
  367.        ...)
  368.      * Managing remote files (RCD, RDEL, RMKDIR, RDIR, ...)
  369.      * Using local files (FOPEN, FCLOSE, FREAD, FWRITE)
  370.      * Programming (TAKE, DEFINE, IF, FOR, WHILE, SWITCH, DECLARE, ...)
  371.      * Interacting with the user (ECHO, ASK, ...)
  372.      * Interacting with a remote computer (INPUT, OUTPUT, ...)
  373.      * Interacting with local programs (RUN, EXEC, PTY, ...)
  374.      * Logging things (LOG SESSION, LOG PACKETS, LOG DEBUG, ...)
  375.        
  376.    And of course QUIT or EXIT to get out and HELP to get help, and for
  377.    programmers: loops, decision making, variables, arrays, associative
  378.    arrays, integer and floating point arithmetic, macros, built-in and
  379.    user-defined functions, string manipulation, pattern matching, block
  380.    structure, scoping, recursion, and all the rest. To get a list of all
  381.    C-Kermit's commands, type a question mark (?) at the prompt. To get a
  382.    description of any command, type HELP followed by the name of the
  383.    command, for example:
  384.    
  385.   help send
  386.  
  387.    The command interruption character is Ctrl-C (hold down the Ctrl key
  388.    and press the C key).
  389.    
  390.    The command language "escape character", used to introduce variable
  391.    names, function invocations, and so on, is backslash (\). If you need
  392.    to include a literal backslash in a command, type two of them, e.g.:
  393.    
  394.   get c:\\k95\\k95custom.ini
  395.  
  396.   Command Files, Macros, and Scripts
  397.   
  398.    A file containing Kermit commands is called a Kermit command file or
  399.    Kermit script. It can be executed with Kermit's TAKE command:
  400.    
  401.   (/current/dir) C-Kermit> take commandfile
  402.  
  403.    (where "commandfile" is the name of the command file). Please don't
  404.    pipe a command file into Kermit's standard input (which might or might
  405.    not work); if you have Kermit commands in a file, tell Kermit to TAKE
  406.    the file.
  407.    
  408.    In Unix only, a Kermit command file can also be executed directly by
  409.    including a "kerbang" line as the first line of the file:
  410.    
  411.   #!/usr/local/bin/kermit +
  412.  
  413.    That is, a top line that starts with "#!", followed immediately by the
  414.    full path of the Kermit executable, and then, if the Kermit script is
  415.    to be given arguments on the command line, a space and a plus sign.
  416.    The script file must also have execute permission:
  417.    
  418.   chmod +x commandfile
  419.  
  420.    Except for the " +" part, this is exactly the same as you would do for
  421.    a shell script, a Perl script, etc. Here's a simple but useless
  422.    example script that regurgitates its arguments (up to three of them):
  423.    
  424.   #!/usr/local/bin/kermit +
  425.   if defined \%1 echo "Argument 1: \%1"
  426.   if defined \%2 echo "Argument 2: \%2"
  427.   if defined \%3 echo "Argument 3: \%3"
  428.   if defined \%4 echo "etc..."
  429.   exit
  430.  
  431.    If this file is stored in your current directory as "commandfile",
  432.    then:
  433.    
  434.   ./commandfile one two three four five
  435.  
  436.    prints:
  437.    
  438.   Argument 1: one
  439.   Argument 2: two
  440.   Argument 3: three
  441.   etc...
  442.  
  443.    This illustrates the basic structure of a standalone Kermit script:
  444.    the "kerbang line", then some commands. It should end with "exit"
  445.    unless you want the Kermit prompt to appear when it is finished. \%1
  446.    is the first argument, \%2 the second, and so on.
  447.    
  448.    You can also create your own commands by defining named macros
  449.    composed of other Kermit commands (or macros). Here's a simple
  450.    example:
  451.    
  452.   define mydial {
  453.       set modem type usrobotics
  454.       set port /dev/ttyS0
  455.       if fail end 1
  456.       set speed 57600
  457.       dial \%1
  458.       if success connect
  459.   }
  460.  
  461.    This shows how you can combine many commands into one command,
  462.    "mydial" in this case (you can use any name you like, provided it does
  463.    not clash with the name of a built-in command). When this macro
  464.    definition is in effect, you can type commands like:
  465.    
  466.   mydial 7654321
  467.  
  468.    and it executes all the commands in macro definition, substituting the
  469.    first operand ("7654321") for the formal parameter ("\%1") in the
  470.    definition. This saves you from having to type lots of commands every
  471.    time you want to make a modem call.
  472.    
  473.    One way to have the macro definition in effect is to type the
  474.    definition at the Kermit prompt. Another way is to store the
  475.    definition in a file and TAKE the file. If you want the the definition
  476.    to be in effect automatically every time you start Kermit, put the
  477.    definition in your initialization or customization file (explained
  478.    [66]below).
  479.    
  480.    Here's a somewhat more ambitious example:
  481.    
  482.   define mydelete {
  483.       local trash
  484.       assign trash \v(home)trashcan/
  485.       if not defined \%1 end 1 "Delete what?"
  486.       if wild \%1 end 1 "Deleting multiple files is too scary"
  487.       if not exist \%1 end 1 "I can't find \%1"
  488.       if not directory \m(trash) {
  489.           mkdir \m(trash)
  490.           if fail end 1 "No trash can"
  491.       }
  492.       rename /list \%1 \m(trash)
  493.   }
  494.   define myundelete {
  495.       local trash
  496.       assign trash \v(home)trashcan/
  497.       if not defined \%1 end 1 "Undelete what?"
  498.       if wild \%1 end 1 "Undeleting multiple files is too hard"
  499.       if not directory \m(trash) end 1 "No trash can"
  500.       if not exist \m(trash)\%1 end 1 "I can't find \%1 in trash can"
  501.       rename /list \m(trash)\%1 .
  502.   }
  503.  
  504.    These macros are not exactly production quality (they don't handle
  505.    filenames that include path segments, they don't handle multiple
  506.    files, etc), but you get the idea: you can pass arguments to macros,
  507.    they can check them and make other kinds of decisions, and the
  508.    commands themselves are relatively intuitive and intelligible.
  509.    
  510.    If you put the above lines into your initialization or customization
  511.    file, you'll have MYDELETE and MYUNDELETE commands available every
  512.    time you start Kermit, at least as long as you don't suppress
  513.    execution of the initialization file. (Exercise for the reader: Make
  514.    these macros generally useful: remove limitations, add trashcan
  515.    display, browsing, emptying, etc.)
  516.    
  517.    Kerbang scripts execute without the initialization file. This to keep
  518.    them portable and also to make them start faster. If you want to write
  519.    Kerbang scripts that depend on the initialization file, include the
  520.    command
  521.    
  522.   take \v(home).kermrc
  523.  
  524.    at the desired spot in the script. By the way, \v(xxx) is a built-in
  525.    variable (xxx is the variable name, "home" in this case). To see what
  526.    built-in variables are available, type "show variables" at the
  527.    C-Kermit prompt. To see what else you can show, type "show ?". \m(xxx)
  528.    is a user defined variable (strictly speaking, it is a macro used as a
  529.    variable).
  530.    
  531.   Command List
  532.   
  533.    C-Kermit has more than 200 top-level commands, and some of these, such
  534.    as SET, branch off into hundreds of subcommands of their own, so it's
  535.    not practical to describe them all here. Instead, here's a concise
  536.    list of the most commonly used top-level commands, grouped by
  537.    category. To learn about each command, type "help" followed by the
  538.    command name, e.g. "help set". Terms such as Command state and Connect
  539.    state are explained in subsequent sections.
  540.    
  541.    Optional fields are shown in [ italicized brackets ]. filename means
  542.    the name of a single file. filespec means a file specification that is
  543.    allowed to contain wildcard characters like '*' to match groups of
  544.    files. options are (optional) switches like /PAGE, /NOPAGE, /QUIET,
  545.    etc, listed in the HELP text for each command. Example:
  546.    
  547.   send /recursive /larger:10000 /after:-1week /except:*.txt *
  548.  
  549.    which can be read as "send all the files in this directory and all the
  550.    ones underneath it that are larger than 10000 bytes, no more than one
  551.    week old, and whose names don't end with ".txt".
  552.    
  553.    Basic Commands
  554.           HELP Requests top-level help.
  555.           HELP command Requests help about the given command.
  556.           INTRODUCTION Requests a brief introduction to C-Kermit.
  557.           LICENSE Displays the C-Kermit software copyright and license.
  558.           VERSION Displays C-Kermit's version number.
  559.           EXIT [ number ] Exits from Kermit with the given status code.
  560.           Synonyms: QUIT, E, Q.
  561.           TAKE filename [ parameters... ] Executes commands from the
  562.           given file.
  563.           LOG item [ filename ] Keeps a log of the given item in the
  564.           given file.
  565.           [ DO ] macro [ parameters... ]    Executes commands from the
  566.           given macro.
  567.           SET parameter value Sets the given parameter to the given
  568.           value.
  569.           SHOW category Shows settings in a given category.
  570.           STATUS Tells whether previous command succeeded or failed.
  571.           DATE [ date-and/or-time ] Shows current date-time or interprets
  572.           given date-time.
  573.           RUN [ extern-command [ parameters... ] Runs the given external
  574.           command. Synonym: !.
  575.           EXEC [ extern-command [ params... ] Kermit overlays itself with
  576.           the given command.
  577.           SUSPEND Stops Kermit and puts it in the background. Synonym: Z.
  578.           
  579.    Local File Management
  580.           TYPE [ options ] filename Displays the contents of the given
  581.           file.
  582.           MORE [ options ] filename Equivalent to TYPE /PAGE (pause after
  583.           each screenful).
  584.           CAT [ options ] filename Equivalent to TYPE /NOPAGE.
  585.           HEAD [ options ] filename Displays the first few lines of a
  586.           given file.
  587.           TAIL [ options ] filename Displays the last few lines of a
  588.           given file.
  589.           GREP [ options ] pattern filespec Displays lines from files
  590.           that match the pattern. Synonym: FIND.
  591.           DIRECTORY [ options ] [ filespec ] Lists files (built-in, many
  592.           options).
  593.           LS [ options ] [ filespec ] Lists files (runs external "ls"
  594.           command).
  595.           DELETE [ options ] [ filespec ] Deletes files. Synonym: RM.
  596.           PURGE [ options ] [ filespec ] Removes backup (*.~n~) files.
  597.           COPY [ options ] [ filespecs... ] Copies files. Synonym: CP.
  598.           RENAME [ options ] [ filespecs... ] Renames files. Synonym: MV.
  599.           CHMOD [ options ] [ filespecs... ] Changes permissions of
  600.           files.
  601.           TRANSLATE filename charsets filename ] Converts file's
  602.           character set. Synonym: XLATE.
  603.           CD Changes your working directory to your home directory.
  604.           CD directory Changes your working directory to the one given.
  605.           CDUP Changes your working directory one level up.
  606.           PWD Displays your working directory.
  607.           BACK Returns to your previous working directory.
  608.           MKDIR [ directory ] Creates a directory.
  609.           RMDIR [ directory ] Removes a directory.
  610.           
  611.    Making Connections
  612.           SET LINE [ options ] devicename        Opens the named serial
  613.           port. Synonym: SET PORT.
  614.           OPEN LINE [ options ] devicename Same as SET LINE. Synonym:
  615.           OPEN PORT.
  616.           SET MODEM TYPE [ name ] Tells Kermit what kind of modem is on
  617.           the port.
  618.           DIAL [ number ] Tells Kermit to dial the given phone number
  619.           with the modem.
  620.           REDIAL Redials the most recently dialed phone number.
  621.           ANSWER Waits for and answers an incoming call on the modem.
  622.           AUTHENTICATE [ parameters... ] Performs secure authentication
  623.           on a TCP/IP connection.
  624.           SET NETWORK TYPE { TCP/IP, X.25, ... } Selects network type for
  625.           subsequent SET HOST commands.
  626.           SET HOST [ options ] host [ port ] Opens a network connection
  627.           to the given host and port.
  628.           SET HOST * port Waits for an incoming TCP/IP connection on the
  629.           given port.
  630.           TELNET [ options ] host Opens a Telnet connection to the host
  631.           and enters Connect state.
  632.           RLOGIN [ options ] host Opens an Rlogin connection to the host
  633.           and enters Connect state.
  634.           IKSD [ options ] host Opens a connection to an Internet Kermit
  635.           Service.
  636.           SSH [ options ] host Opens an SSH connection to the host and
  637.           enters Connect state.
  638.           FTP OPEN host [ options ] Opens an FTP connection to the host.
  639.           HTTP [ options ] OPEN host Opens an HTTP connection to the
  640.           host.
  641.           PTY external-command Runs the command on a pseudoterminal as if
  642.           it were a connection.
  643.           PIPE external-command Runs the command through a pipe as if it
  644.           were a connection.
  645.           
  646.    Using Connections
  647.           CONNECT [ options ]                    Enters Connect
  648.           (terminal) state. Synonym: C.
  649.           REDIRECT command Redirects the given external command over the
  650.           connection.
  651.           TELOPT command Sends a Telnet protocol command (Telnet
  652.           connections only).
  653.           Ctrl-\C "Escapes back" from Connect state to Command state.
  654.           Ctrl-\B (In Connect state) Sends a BREAK signal (serial or
  655.           Telnet).
  656.           Ctrl-\! (In Connect state) Enters inferior shell; "exit" to
  657.           return.
  658.           Ctrl-\? (In Connect state) Shows a menu of other escape-level
  659.           options.
  660.           Ctrl-\Ctrl-\ (In Connect state) Type two Ctrl-Backslashes to
  661.           send one of them.
  662.           SET ESCAPE [ character ] Changes Kermit's Connect-state escape
  663.           character.
  664.           
  665.    Closing Connections
  666.           HANGUP Hangs up the currently open serial-port or network
  667.           connection.
  668.           CLOSE Closes the currently open serial-port or network
  669.           connection.
  670.           SET LINE (with no devicename)          Closes the currently
  671.           open serial-port or network connection.
  672.           SET HOST (with no hostname) Closes the currently open
  673.           serial-port or network connection.
  674.           FTP CLOSE Closes the currently open FTP connection.
  675.           HTTP CLOSE Closes the currently open HTTP connection.
  676.           EXIT Also closes all connections. Synonym: QUIT.
  677.           SET EXIT WARNING OFF Suppresses warning about open connections
  678.           on exit or close.
  679.           
  680.    File Transfer
  681.           SEND [ options ] filename [ as-name ]  Sends the given file.
  682.           Synonym: S.
  683.           SEND [ options ] filespec Sends all files that match.
  684.           RESEND [ options ] filespec Resumes an interupted SEND from the
  685.           point of failure.
  686.           RECEIVE [ options ] [ as-name ] Waits passively for files to
  687.           arrive. Synonym: R.
  688.           LOG TRANSACTIONS [ filename ] Keeps a record of file transfers.
  689.           FAST Use fast file-transfer settings (default).
  690.           CAUTIOUS Use cautious and less fast file-transfer settings.
  691.           ROBUST Use ultra-conservative and slow file-transfer settings.
  692.           STATISTICS [ options ] Gives statistics about the most recent
  693.           file transfer.
  694.           WHERE After transfer: "Where did my files go?".
  695.           TRANSMIT [ options ] [ filename ] Sends file without protocol.
  696.           Synonym: XMIT.
  697.           LOG SESSION [ filename ] Captures remote text or files without
  698.           protocol.
  699.           SET PROTOCOL [ name... ] Tells Kermit to use an external
  700.           file-transfer protocol.
  701.           FTP { PUT, MPUT, GET, MGET, ... } FTP client commands.
  702.           HTTP { PUT, GET, HEAD, POST, ... } HTTP client commands.
  703.           
  704.    Kermit Server
  705.           ENABLE, DISABLE                        Controls which features
  706.           can be used by clients.
  707.           SET SERVER Sets parameters prior to entering Server state.
  708.           SERVER Enters Server state.
  709.           
  710.    Client of Kermit or FTP Server
  711.           [ REMOTE ] LOGIN [ user password ] Logs in to a Kermit server
  712.           or IKSD that requires it.
  713.           [ REMOTE ] LOGOUT Logs out from a Kermit server or IKSD.
  714.           SEND [ options ] filename [ as-name ]  Sends the given file to
  715.           the server. Synonyms: S, PUT.
  716.           SEND [ options ] filespec Sends all files that match.
  717.           RESEND [ options ] filespec Resumes an interupted SEND from the
  718.           point of failure.
  719.           GET [ options ] remote-filespec Asks the server to send the
  720.           given files. Synonym: G.
  721.           REGET [ options ] remote-filespec Resumes an interrupted GET
  722.           from the point of failure.
  723.           REMOTE CD [ directory ] Asks server to change its working
  724.           directory. Synonym: RCD.
  725.           REMOTE PWD [ directory ] Asks server to display its working
  726.           directory. Synonym: RPWD.
  727.           REMOTE DIRECTORY [ filespec... ] Asks server to send a
  728.           directory listing. Synonym: RDIR.
  729.           REMOTE DELETE [ filespec... ] Asks server to delete files.
  730.           Synonym: RDEL.
  731.           REMOTE [ command... ] (Many other commands: "remote ?" for a
  732.           list).
  733.           MAIL [ options ] filespec Sends file(s) to be delivered as
  734.           e-mail (Kermit only).
  735.           FINISH Asks the server to exit server state (Kermit only).
  736.           BYE Asks the server to log out and close the connection.
  737.           
  738.    Script Programming
  739.           DEFINE, DECLARE, UNDEFINE, UNDECLARE, ASSIGN, EVALUATE,
  740.           SEXPRESSION, ARRAY, SORT, INPUT, OUTPUT, IF, FOR, WHILE,
  741.           SWITCH, GOTO, ECHO, ASK, GETC, GETOK, ASSERT, WAIT, SLEEP,
  742.           FOPEN, FREAD, FWRITE, FCLOSE, STOP, END, RETURN, LEARN, SHIFT,
  743.           TRACE, VOID, INCREMENT, DECREMENT, ... For these and many more
  744.           you'll need to consult the [67]manual and supplements, and/or
  745.           visit the [68]Kermit Script Library, which also includes a
  746.           brief tutorial. Hint: HELP LEARN to find out how to get Kermit
  747.           to write simple scripts for you.
  748.           
  749.    Many of Kermit's commands have synonyms, variants, relatives, and so
  750.    on. For example, MSEND is a version of SEND that accepts a list of
  751.    file specifications to be sent, rather than just one file
  752.    specification, and MPUT is a synonym of MSEND. MOVE means to SEND and
  753.    then DELETE the source file if successful. MMOVE is like MOVE, but
  754.    accepts a list of filespecs, and so on. These are described in the
  755.    [69]full documentation.
  756.    
  757.    Use question mark to feel your way through an unfamiliar command, as
  758.    in this example (the part you type is underlined):
  759.    
  760.   C-Kermit> remote ? One of the following:
  761.    assign     delete     help       login      print      rename     space
  762.    cd         directory  host       logout     pwd        rmdir      type
  763.    copy       exit       kermit     mkdir      query      set        who
  764.   C-Kermit> remote set ? One of the following:
  765.    attributes   file         retry        transfer
  766.    block-check  receive      server       window
  767.   C-Kermit> remote set file ? One of the following:
  768.    character-set  incomplete     record-length
  769.    collision      names          type
  770.   C-Kermit> remote set file names ? One of the following:
  771.    converted  literal
  772.   C-Kermit> remote set file names literal
  773.   C-Kermit>
  774.  
  775.    This is called menu on demand: you get a menu when you want one, but
  776.    menus are not forced on you even when know what you're doing. Note
  777.    that you can also abbreviate most keywords, and you can complete them
  778.    with the Tab or Esc key. Also note that ? works for filenames too, and
  779.    that you can use it in the middle of a keyword or filename, not just
  780.    at the beginning. For example, "send x?" lists all the files in the
  781.    current directory whose names start with 'x'.
  782.    
  783.    [ [70]Kermit Home ] [ [71]C-Kermit Home ] [ [72]C-Kermit FAQ ]
  784.     ________________________________________________________________________
  785.   
  786.   INITIALIZATION FILE [ [73]Top ] [ [74]Contents ] [ [75]Next ] [ [76]Previous
  787.   ]
  788.   
  789.    In its default configuration, C-Kermit executes commands from a file
  790.    called .kermrc in your home directory when it starts, unless it is
  791.    given the -Y or -y command-line option. Custom configurations might
  792.    substitute a shared system-wide initialization file. The SHOW FILE
  793.    command tells what initialization file, if any, was used. The standard
  794.    initialization file "chains" to an individual customization file,
  795.    .mykermc, in the home directory, in which each user can establish
  796.    her/his own preferences, define macros, and so on.
  797.    
  798.    Since execution of the initialization file (at least the standard one)
  799.    makes C-Kermit take longer to start, it might be better not to have an
  800.    initialization file, especially now that Kermit's default startup
  801.    configuration is well attuned to modern computing and networking -- in
  802.    other words, you no longer have do anything special to make Kermit
  803.    transfers go fast. So instead of having an initialization file that is
  804.    executed every time Kermit starts, you might consider making one or
  805.    more kerbang scripts (with names other that .kermrc) that do NOT
  806.    include an "exit" command, and invoke those when you need the
  807.    settings, macro definitions, and/or scripted actions they contain, and
  808.    invoke C-Kermit directly when you don't.
  809.    
  810.    To put it another way... We still distribute the standard
  811.    initialization file since it's featured in the manual and backwards
  812.    compatibility is important to us. But there's no harm in not using it
  813.    if you don't need the stuff that's in it (services directory, dialing
  814.    directory, network directory, and associated macro definitions). On
  815.    the other hand, if there are settings or macros you want in effect
  816.    EVERY time you use Kermit, the initialization file (or the
  817.    customization file it chains to) is the place to put them, because
  818.    that's the only place Kermit looks for them automatically each time
  819.    you start it.
  820.    
  821.    [ [77]Kermit Home ] [ [78]C-Kermit Home ] [ [79]C-Kermit FAQ ]
  822.     ________________________________________________________________________
  823.   
  824.   MODES OF OPERATION [ [80]Top ] [ [81]Contents ] [ [82]Next ] [ [83]Previous ]
  825.   
  826.    Kermit is said to be in Local mode if it has made a connection to
  827.    another computer, e.g. by dialing it or establishing a Telnet
  828.    connection to it. The other computer is remote, so if you start
  829.    another copy of Kermit on the remote computer, it is said to be in
  830.    Remote mode (as long as it has not made any connections of its own).
  831.    The local Kermit communicates over the communications device or
  832.    network connection, acting as a conduit between the the remote
  833.    computer and your keyboard and screen. The remote Kermit is the
  834.    file-transfer partner to the local Kermit and communicates only
  835.    through its standard input and output.
  836.    
  837.    At any moment, a Kermit program can be in any of the following states.
  838.    It's important to know what they are and how to change from one to the
  839.    other.
  840.    
  841.    Command state
  842.           
  843.           In this state, Kermit reads commands from:
  844.           
  845.           + Your keyboard; or:
  846.           + A file, or:
  847.           + A macro definition.
  848.             
  849.           You can exit from Command state back to Unix with the EXIT or
  850.           QUIT command (same thing). You can enter Connect state with any
  851.           of various commands (CONNECT, DIAL, TELNET, etc). You can enter
  852.           file transfer state with commands like SEND, RECEIVE, and GET.
  853.           You can enter Server state with the SERVER command. The TAKE
  854.           command tells Kermit to read and execute commands from a file.
  855.           The (perhaps implied) DO command tells Kermit to read and
  856.           execute commands from a macro definition. While in Command
  857.           state, you can interrupt any command, macro, or command file by
  858.           typing Ctrl-C (hold down the Ctrl key and press the C key);
  859.           this normally brings you back to the prompt.
  860.           
  861.    Shell state
  862.           
  863.           You can invoke an inferior shell or external command from the
  864.           Kermit command prompt by using the PUSH, RUN (!), EDIT, or
  865.           BROWSE command. While the inferior shell or command is active,
  866.           Kermit is suspended and does nothing. Return to Kermit Command
  867.           state by exiting from the inferior shell or application.
  868.           
  869.    Connect state
  870.           
  871.           In this state, which can be entered only when in Local mode
  872.           (i.e. when Kermit has made a connection to another computer),
  873.           Kermit is acting as a terminal to the remote computer. Your
  874.           keystrokes are sent to the remote computer and characters that
  875.           arrive over the communication connection are displayed on your
  876.           screen. This state is entered when you give a CONNECT, DIAL,
  877.           TELNET, RLOGIN, or IKSD command. You can return to command
  878.           state by logging out of the remote computer, or by typing:
  879.           
  880.   Ctrl-\c
  881.  
  882.           That is: Hold down the Ctrl key and press the backslash key,
  883.           then let go of the Ctrl key and press the C key. This is called
  884.           escaping back. Certain other escape-level commands are also
  885.           provided; type Ctrl-\? for a list. For example, you can enter
  886.           Shell state with:
  887.           
  888.   Ctrl-\!
  889.  
  890.           To send a Ctrl-\ to the host while in Connect state, type two
  891.           of them in a row. See HELP CONNECT and HELP SET ESCAPE for more
  892.           info.
  893.           
  894.    Local file-transfer state
  895.           
  896.           In this state, Kermit is sending packets back and forth with
  897.           the other computer in order to transfer a file or accomplish
  898.           some other file-related task. And at the same time, it is
  899.           displaying its progress on your screen and watching your
  900.           keyboard for interruptions. In this state, the following
  901.           single-keystroke commands are accepted:
  902.           
  903.             X Interrupt the current file and go on to the next (if any).
  904.             Z Interrupt the current file and skip all the rest.
  905.             E Like Z but uses a "stronger" protocol (use if X or Z don't
  906.           work).
  907.             Ctrl-C   Interrupt file-transfer mode (use if Z or E don't
  908.           work).
  909.           
  910.           Kermit returns to its previous state (Command or Connect) when
  911.           the transfer is complete or when interrupted successfully by X,
  912.           Z, E, or Ctrl-C (hold down the Ctrl key and press the C key).
  913.           
  914.    Remote file-transfer state
  915.           
  916.           In this state, Kermit is exchanging file-transfer packets with
  917.           its local partner over its standard i/o. It leaves this state
  918.           automatically when the transfer is complete. In case you find
  919.           your local Kermit in Connect state and the remote one in
  920.           File-transfer state (in which it seems to ignore your
  921.           keystrokes), you can usually return it to command state by
  922.           typing three Ctrl-C's in a row. If that doesn't work, return
  923.           your local Kermit to Command state (Ctrl-\ C) and type
  924.           "e-packet" and then press the Return or Enter key; this forces
  925.           a fatal Kermit protocol error.
  926.           
  927.    Remote Server state
  928.           
  929.           This is like Remote File-transfer state, except it never
  930.           returns automatically to Command state. Rather, it awaits
  931.           further instructions from the client program; that is, from
  932.           your Local Kermit program. You can return the Remote Server to
  933.           its previous state by issuing a "finish" command to the client,
  934.           or if you are in Connect state, by typing three Ctrl-C's in a
  935.           row. You can tell the server job to log out and break the
  936.           connection by issuing a "bye" command to the client.
  937.           
  938.    Local Server state
  939.           
  940.           Like Remote-Server state, but in local mode, and therefore with
  941.           its file-transfer display showing, and listening for single-key
  942.           commands, as in Local File-transfer state. Usually this state
  943.           is entered automatically when a remote Kermit program gives a
  944.           GET command.
  945.           
  946.    C-Kermit, Kermit 95, and MS-DOS Kermit all can switch automatically
  947.    from Connect state to Local File-transfer state when you initiate a
  948.    file transfer from the remote computer by starting Kermit and telling
  949.    it to send or get a file, in which case, Connect state is
  950.    automatically resumed after the file transfer is finished.
  951.    
  952.    Note that C-Kermit is not a terminal emulator. It is a communications
  953.    application that you run in a terminal window (e.g. console or Xterm).
  954.    The specific emulation, such as VT100, VT220, Linux Console, or Xterm,
  955.    is provided by the terminal window in which you are running C-Kermit.
  956.    Kermit 95 and MS-DOS Kermit, on the other hand, are true terminal
  957.    emulators. Why is C-Kermit not a terminal emulator? [84]CLICK HERE to
  958.    read about it.
  959.    
  960.    [ [85]Kermit Home ] [ [86]C-Kermit Home ] [ [87]C-Kermit FAQ ]
  961.     ________________________________________________________________________
  962.   
  963.   MAKING CONNECTIONS [ [88]Top ] [ [89]Contents ] [ [90]Next ] [ [91]Previous ]
  964.   
  965.    Here is how to make different kinds of connections using interactive
  966.    Kermit commands (as noted above, you can also make connections with
  967.    command-line options). Note that you don't have to make connections
  968.    with Kermit. It can also be used on the far end of a connection as the
  969.    remote file transfer and management partner of your local
  970.    communications software.
  971.    
  972.    Making a Telnet Connection
  973.           
  974.           At the C-Kermit command prompt, simply type:
  975.           
  976.   telnet foo.bar.com         ; Substitute desired host name or address.
  977.   telnet xyzcorp.com 3000    ; You can also include a port number.
  978.  
  979.           If the connection is successful, Kermit automically enters
  980.           Connect state. When you logout from the remote host, Kermit
  981.           automatically returns to its prompt. More info: HELP TELNET,
  982.           HELP SET TELNET, HELP SET TELOPT. Also see the [92]IKSD section
  983.           below.
  984.           
  985.    Making an Rlogin connection
  986.           
  987.           This is just like Telnet, except you have to be root to do it
  988.           because Rlogin uses a privileged TCP port:
  989.           
  990.   rlogin foo.bar.com         ; Substitute desired host name or address.
  991.  
  992.           More info: HELP RLOGIN.
  993.           
  994.    Making an SSH Connection
  995.           
  996.           Unlike Telnet and Rlogin, SSH connections are not built-in, but
  997.           handled by running your external SSH client through a
  998.           pseudoterminal. Using C-Kermit to control the SSH client gives
  999.           you all of Kermit's features (file transfer, character-set
  1000.           conversion, scripting, etc) over SSH.
  1001.           
  1002.   ssh foo.bar.com            ; Substitute desired host name or address.
  1003.  
  1004.           More info: HELP SSH, HELP SET SSH.
  1005.           
  1006.    Dialing with a Modem
  1007.           
  1008.           If it's an external modem, make sure it is connected to a
  1009.           usable serial port on your computer with a regular
  1010.           (straight-through) modem cable, and to the telephone jack with
  1011.           a telephone cable, and that it's turned on. Then use these
  1012.           commands:
  1013.           
  1014.   set modem type usrobotics  ; Or other supported type
  1015.   set line /dev/ttyS0        ; Specify device name
  1016.   set speed 57600            ; Or other desired speed
  1017.   set flow rts/cts           ; Most modern modems support this
  1018.   set dial method tone       ; (or pulse)
  1019.   dial 7654321               ; Dial the desired number
  1020.  
  1021.           Type "set modem type ?" for a list of supported modem types. If
  1022.           you omit the SET MODEM TYPE command, the default type is
  1023.           "generic-high-speed", which should work for most modern
  1024.           AT-command-set modems. If the line is busy, Kermit redials
  1025.           automatically. If the call does not succeed, use "set dial
  1026.           display on" and try it again to watch what happens. If the call
  1027.           succeeds, Kermit enters Connect state automatically and returns
  1028.           to its prompt automatically when you log out from the remote
  1029.           computer or the connection is otherwise lost.
  1030.           
  1031.           You can also dial from a modem that is accessible by Telnet,
  1032.           e.g. to a reverse terminal server. In this case the command
  1033.           sequence is:
  1034.           
  1035.   set host ts.xxx.com 2000   ; Terminal-server and port
  1036.   set modem type usrobotics  ; Or other supported type
  1037.   set dial method tone       ; (or pulse)
  1038.   dial 7654321               ; Dial the desired number
  1039.  
  1040.           If the terminal server supports the Telnet Com Port Option,
  1041.           [93]RFC 2217, you can also give serial-port related commands
  1042.           such as SET SPEED, SET PARITY, and so on, and Kermit relays
  1043.           them to the terminal server using the protocol specified in the
  1044.           RFC.
  1045.           
  1046.           More info: HELP SET MODEM, HELP SET LINE, HELP SET SPEED, HELP
  1047.           SET FLOW, HELP DIAL, HELP SET DIAL, HELP SET MODEM, HELP SET
  1048.           CARRIER-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL.
  1049.           
  1050.    Direct Serial Port
  1051.           
  1052.           Connect the two computers, A and B, with a null modem cable (or
  1053.           two modem cables interconnected with a null-modem adapter or
  1054.           modem eliminator). From Computer A:
  1055.           
  1056.   set modem type none        ; There is no modem
  1057.   set line /dev/ttyS0        ; Specify device name
  1058.   set carrier-watch off      ; If DTR and CD are not cross-connected
  1059.   set speed 57600            ; Or other desired speed
  1060.   set flow rts/cts           ; If RTS and CTS are cross-connected
  1061.   set flow xon/xoff          ; If you can't use RTS/CTS
  1062.   set parity even            ; (or "mark" or "space", if necessary)
  1063.   set stop-bits 2            ; (rarely necessary)
  1064.   connect                    ; Enter Connect (terminal) state
  1065.  
  1066.           This assumes Computer B is set up to let you log in. If it
  1067.           isn't, you can run a copy of Kermit on Computer B and follow
  1068.           approximately the same directions. More info: As above plus
  1069.           HELP CONNECT.
  1070.           
  1071.    With modems or direct serial connections, you might also have to "set
  1072.    parity even" (or "mark" or "space") if it's a 7-bit connection.
  1073.    
  1074.    Of the connection types listed above, only one can be open at a time.
  1075.    However, any one of these can be open concurrently with an [94]FTP or
  1076.    HTTP session. Each connection type can be customized to any desired
  1077.    degree, scripted, logged, you name it. See the manual.
  1078.    
  1079.    NOTE: On selected platforms, C-Kermit also can make X.25 connections.
  1080.    See the manual for details.
  1081.    
  1082.    [ [95]Kermit Home ] [ [96]C-Kermit Home ] [ [97]C-Kermit FAQ ]
  1083.     ________________________________________________________________________
  1084.   
  1085.   TRANSFERRING FILES WITH KERMIT [ [98]Top ] [ [99]Contents ] [ [100]Next ] [
  1086.   [101]Previous ]
  1087.   
  1088.      * [102]Downloading Files
  1089.      * [103]Uploading Files
  1090.      * [104]Kermit Transfers the Old-Fashioned Way
  1091.      * [105]If File Transfer Fails
  1092.      * [106]Advanced Kermit File Transfer Features
  1093.      * [107]Non-Kermit File Transfer
  1094.        
  1095.    There is a [108]widespread and persistent belief that Kermit is a slow
  1096.    protocol. This is because, until recently, it used conservative tuning
  1097.    by default to make sure file transfers succeeded, rather than failing
  1098.    because they overloaded the connection. Some extra commands (or
  1099.    command-line options, like -Q) were needed to make it go fast, but
  1100.    nobody bothered to find out about them. Also, it takes two to tango:
  1101.    most non-Kermit-Project Kermit protocol implementations really ARE
  1102.    slow. The best file-transfer partners for C-Kermit are: another copy
  1103.    of [109]C-Kermit (7.0 or later) and [110]Kermit 95. These combinations
  1104.    work well and they work fast by default. MS-DOS Kermit is good too,
  1105.    but you have to tell it to go fast (by giving it the FAST command).
  1106.    
  1107.    Furthermore, all three of these Kermit programs support "autodownload"
  1108.    and "autoupload", meaning that when they are in Connect state and a
  1109.    Kermit packet comes in from the remote, they automatically switch into
  1110.    file transfer mode.
  1111.    
  1112.    And plus, C-Kermit and K95 also switch automatically between text and
  1113.    binary mode for each file, so there is no need to "set file type
  1114.    binary" or "set file type text", or to worry about files being
  1115.    corrupted because they were transferred in the wrong mode.
  1116.    
  1117.    What all of these words add up to is that now, when you use up-to-date
  1118.    Kermit software from the Kermit Project, file transfer is not only
  1119.    fast, it's ridiculously easy. You barely have to give any commands at
  1120.    all.
  1121.    
  1122.    Downloading Files
  1123.           
  1124.           Let's say you have [111]Kermit 95, [112]C-Kermit, or
  1125.           [113]MS-DOS Kermit on your desktop computer, with a connection
  1126.           to a Unix computer that has C-Kermit installed as "kermit". To
  1127.           download a file (send it from Unix to your desktop computer),
  1128.           just type the following command at your Unix shell prompt:
  1129.           
  1130.   kermit -s oofa.txt
  1131.  
  1132.           (where oofa.txt is the filename). If you want to send more than
  1133.           one file, you can put as many filenames as you want on the
  1134.           command line, and they can be any combination of text and
  1135.           binary:
  1136.           
  1137.   kermit -s oofa.txt oofa.zip oofa.html oofa.tar.gz
  1138.  
  1139.           and/or you can use wildcards to send groups of files:
  1140.           
  1141.   kermit -s oofa.*
  1142.  
  1143.           If you want to send a file under an assumed name, use:
  1144.           
  1145.   kermit -s friday.txt -a today.txt
  1146.  
  1147.           This sends the file friday.txt but tells the receiving Kermit
  1148.           that its name is today.txt. In all cases, as noted, when the
  1149.           file transfer is finished, your desktop Kermit returns
  1150.           automatically to Connect state. No worries about escaping back,
  1151.           re-connecting, text/binary mode switching. Almost too easy,
  1152.           right?
  1153.           
  1154.    Uploading Files
  1155.           
  1156.           To upload files (send them from your desktop computer to the
  1157.           remote Unix computer) do the same thing, but use the -g (GET)
  1158.           option instead of -s:
  1159.           
  1160.   kermit -g oofa.txt
  1161.  
  1162.           This causes your local Kermit to enter server mode; then the
  1163.           remote Kermit program requests the named file and the local
  1164.           Kermit sends it and returns automatically to Connect state when
  1165.           done.
  1166.           
  1167.           If you want to upload multiple files, you have have use shell
  1168.           quoting rules, since these aren't local files:
  1169.           
  1170.   kermit -g "oofa.txt oofa.zip oofa.html oofa.tar.gz"
  1171.   kermit -g "oofa.*"
  1172.  
  1173.           If you want to upload a file but store it under a different
  1174.           name, use:
  1175.           
  1176.   kermit -g friday.txt -a today.txt
  1177.  
  1178.    Kermit Transfers the Old-Fashioned Way
  1179.           
  1180.           If your desktop communications software does not support
  1181.           autoupload or autodownload, or it does not include Kermit
  1182.           server mode, the procedure requires more steps.
  1183.           
  1184.           To download a file, type:
  1185.           
  1186.   kermit -s filename
  1187.  
  1188.           on the host as before, but if nothing happens automatically in
  1189.           response to this command, you have to switch your desktop
  1190.           communications software into Kermit Receive state. This might
  1191.           be done by escaping back using keyboard characters or hot keys
  1192.           (Alt-x is typical) and/or with a command (like RECEIVE) or a
  1193.           menu. When the file transfer is complete, you have to go back
  1194.           to Connect state, Terminal emulation, or whatever terminology
  1195.           applies to your desktop communications software.
  1196.           
  1197.           To upload a file, type:
  1198.           
  1199.   kermit -r
  1200.  
  1201.           on the host (rather than "kermit -g"). This tells C-Kermit to
  1202.           wait passively for a file to start arriving. Then regain the
  1203.           attention of your desktop software (Alt-x or whatever) and
  1204.           instruct it to send the desired file(s) with Kermit protocol.
  1205.           When the transfer is finished, return to the Connect or
  1206.           Terminal screen.
  1207.           
  1208.    If File Transfer Fails
  1209.           
  1210.           Although every aspect of Kermit's operation can be finely
  1211.           tuned, there are also three short and simple "omnibus tuning"
  1212.           commands you can use for troubleshooting:
  1213.           
  1214.         FAST
  1215.                 Use fast file-transfer settings. This has been the
  1216.                 default since C-Kermit 7.0 now that most modern computers
  1217.                 and connections support it. If transfers fail with fast
  1218.                 settings, try . . .
  1219.                 
  1220.         CAUTIOUS
  1221.                 Use cautious but not paranoid settings. File transfers,
  1222.                 if they work, will go at medium speed. If not, try . . .
  1223.                 
  1224.         ROBUST
  1225.                 Use the most robust, resilient, conservative, safe, and
  1226.                 reliable settings. File transfers will almost certainly
  1227.                 work, but they will be quite slow (of course this is a
  1228.                 classic tradeoff; ROBUST was C-Kermit's default tuning in
  1229.                 versions 6.0 and earlier, which made everybody think
  1230.                 Kermit protocol was slow). If ROBUST doesn't do the
  1231.                 trick, try again with SET PARITY SPACE first in case it's
  1232.                 not an 8-bit connection.
  1233.                 
  1234.           Obviously the success and performance of a file transfer also
  1235.           depends on C-Kermit's file transfer partner. Up-to-date, real
  1236.           [114]Kermit Project partners are recommended because they
  1237.           contain the best Kermit protocol implementations and because
  1238.           [115]we can support them in case of trouble.
  1239.           
  1240.           If you still have trouble, consult Chapter 10 of [116]Using
  1241.           C-Kermit, or send email to [117]kermit-support@columbia.edu.
  1242.           
  1243.    Advanced Kermit File-Transfer Features
  1244.           
  1245.           Obviously there is a lot more to Kermit file transfer,
  1246.           including all sorts of interactive commands, preferences,
  1247.           options, logging, debugging, troubleshooting, and anything else
  1248.           you can imagine but that's what the [118]manual and updates are
  1249.           for. Here are a few topics you can explore if you're interested
  1250.           by Typing HELP for the listed commands:
  1251.           
  1252.         Logging transfers:
  1253.                 LOG TRANSACTIONS (HELP LOG)
  1254.                 
  1255.         Automatic per-file text/binary mode switching:
  1256.                 SET TRANSFER MODE { AUTOMATIC, MANUAL } (HELP SET
  1257.                 TRANSFER).
  1258.                 
  1259.         Cross-platform recursive directory tree transfer:
  1260.                 SEND /RECURSIVE, GET /RECURSIVE (HELP SEND, HELP GET).
  1261.                 
  1262.         File collision options:
  1263.                 SET FILE COLLISION { OVERWRITE, BACKUP, DISCARD, ... }
  1264.                 (HELP SET FILE).
  1265.                 
  1266.         Update mode (only transfer files that changed since last time):
  1267.                 SET FILE COLLISION UPDATE (HELP SET FILE).
  1268.                 
  1269.         Filename selection patterns:
  1270.                 (HELP WILDCARD).
  1271.                 
  1272.         Flexible file selection:
  1273.                 SEND (or GET) /BEFORE /AFTER /LARGER /SMALLER /TYPE
  1274.                 /EXCEPT, ...
  1275.                 
  1276.         Character-set conversion:
  1277.                 SET { FILE, TRANSFER } CHARACTER-SET, ASSOCIATE, ...
  1278.                 
  1279.         File/Pathname control:
  1280.                 SET { SEND, RECEIVE } PATHNAMES, SET FILE NAMES.
  1281.                 
  1282.         Atomic file movement:
  1283.                 SEND (or GET) /DELETE /RENAME /MOVE-TO
  1284.                 
  1285.         Transferring to/from standard i/o of other commands:
  1286.                 SEND (or GET) /COMMAND
  1287.                 
  1288.         Recovery of interrupted transfer from point of failure:
  1289.                 RESEND, REGET (HELP RESEND, HELP REGET).
  1290.                 
  1291.    Non-Kermit File Transfer
  1292.           
  1293.           You can also use C-Kermit to transfer files with FTP or HTTP
  1294.           Internet protocols; [119]see below.
  1295.           
  1296.           On a regular serial or Telnet connection where the other
  1297.           computer doesn't support Kermit protocol at all, you have
  1298.           several options. For example, if your desktop communications
  1299.           software supports Zmodem, use "rz" and "sz" on the host rather
  1300.           than Kermit. But if Kermit is your desktop software, and you
  1301.           are using it to make calls or network connections to other
  1302.           computers that don't support Kermit protocol (or that don't
  1303.           have a good implementation of it), then if your computer also
  1304.           has external X, Y, or Zmodem programs that are redirectable,
  1305.           Kermit can use them as external protocols. HELP SET PROTOCOL
  1306.           for details.
  1307.           
  1308.           You can also capture "raw" data streams from the other computer
  1309.           with LOG SESSION (HELP LOG and HELP SET SESSION-LOG for
  1310.           details), and you can upload files without any protocol at all
  1311.           with TRANSMIT (HELP TRANSMIT, HELP SET TRANSMIT).
  1312.           
  1313.    [ [120]Kermit Home ] [ [121]C-Kermit Home ] [ [122]C-Kermit FAQ ]
  1314.     ________________________________________________________________________
  1315.   
  1316.   KERMIT'S BUILT-IN FTP AND HTTP CLIENTS [ [123]Top ] [ [124]Contents ] [
  1317.   [125]Next ] [ [126]Previous ]
  1318.   
  1319.    Kermit's FTP client is like the regular Unix FTP client that you're
  1320.    used to, but with some differences:
  1321.    
  1322.      * It has lots more commands and features.
  1323.      * Each FTP command must be prefixed with "ftp", for example "ftp
  1324.        open", "ftp get", "ftp bye", etc (this is not strictly true, but
  1325.        until you're more familiar with it, it's best to follow this
  1326.        rule).
  1327.      * Commands like "cd", "directory", etc, execute locally, not on the
  1328.        server. Use "ftp cd", "ftp dir", etc, to have them act on the
  1329.        server.
  1330.      * You can have an FTP session and a regular Kermit serial or Telnet
  1331.        session open at the same time.
  1332.      * FTP sessions can be fully automated.
  1333.        
  1334.    Pending publication of the next edition of the manual, the Kermit FTP
  1335.    client is thoroughly documented at the Kermit Project website:
  1336.    
  1337.   [127]http://www.columbia.edu/kermit/ftpclient.html
  1338.  
  1339.    You also can use HELP FTP and HELP SET FTP to get descriptions of
  1340.    Kermit's FTP-related commands.
  1341.    
  1342.    The HTTP client is similar to the FTP one, except you prefix each
  1343.    command with HTTP instead of FTP: HTTP OPEN, HTTP GET, HTTP PUT, HTTP
  1344.    CLOSE, etc. Type HELP HTTP for details, or visit the to view the
  1345.    [128]manual supplements. HTTP connections can be open at the same time
  1346.    as regular serial or Telnet connections and FTP connections. So Kermit
  1347.    can manage up to three types connections simultaneously.
  1348.    
  1349.    [ [129]Kermit Home ] [ [130]C-Kermit Home ] [ [131]C-Kermit FAQ ] [
  1350.    [132]FTP Client ] [ [133]HTTP Client ]
  1351.     ________________________________________________________________________
  1352.   
  1353.   INTERNET KERMIT SERVICE [ [134]Top ] [ [135]Contents ] [ [136]Next ] [
  1354.   [137]Previous ]
  1355.   
  1356.    C-Kermit can be configured and run as an Internet service (called
  1357.    IKSD), similar to an FTP server (FTPD) except you can (but need not)
  1358.    interact with it directly, plus it does a lot more than an FTP server
  1359.    can do. The TCP port for IKSD is 1649. It uses Telnet protocol.
  1360.    C-Kermit can be an Internet Kermit Server, or it can be a client of an
  1361.    IKSD. You can make connections from C-Kermit to an IKSD with any of
  1362.    the following commands:
  1363.    
  1364.   telnet foo.bar.edu 1649
  1365.   telnet foo.bar.edu kermit   ; if "kermit" is listed in /etc/services
  1366.   iksd foo.bar.edu
  1367.  
  1368.    The IKSD command is equivalent to a TELNET command specifying port
  1369.    1649. For more information about making and using connections to an
  1370.    IKSD, see:
  1371.    
  1372.   [138]http://www.columbia.edu/kermit/cuiksd.html
  1373.  
  1374.    You can run an Internet Kermit Service on your own computer too (if
  1375.    you are the system administrator). For instructions, see:
  1376.    
  1377.   [139]http://www.columbia.edu/kermit/iksd.html
  1378.  
  1379.    [ [140]Kermit Home ] [ [141]C-Kermit Home ] [ [142]C-Kermit FAQ ]
  1380.     ________________________________________________________________________
  1381.   
  1382.   SECURITY [ [143]Top ] [ [144]Contents ] [ [145]Next ] [ [146]Previous ]
  1383.   
  1384.    All of C-Kermit's built-in TCP/IP networking methods (Telnet, Rlogin,
  1385.    IKSD, FTP, and HTTP) can be secured by one or more of the following
  1386.    IETF-approved methods:
  1387.    
  1388.      * MIT Kerberos IV
  1389.      * MIT Kerberos V
  1390.      * SSL/TLS
  1391.      * Stanford SRP
  1392.        
  1393.    For complete instructions see:
  1394.    
  1395.   [147]http://www.columbia.edu/kermit/security.html
  1396.  
  1397.    And as noted previously, you can also make SSH connections with
  1398.    C-Kermit if you already have an SSH client installed.
  1399.    
  1400.    [ [148]Kermit Home ] [ [149]C-Kermit Home ] [ [150]C-Kermit FAQ ]
  1401.     ________________________________________________________________________
  1402.   
  1403.   ALTERNATIVE COMMAND-LINE PERSONALITIES [ [151]Top ] [ [152]Contents ] [
  1404.   [153]Next ] [ [154]Previous ]
  1405.   
  1406.    When invoked as "kermit" or any other name besides any of the special
  1407.    ones, C-Kermit has the command-line options described above in the
  1408.    [155]OPTIONS section. However, if you invoke C-Kermit using any of the
  1409.    following names:
  1410.    
  1411.      telnet  Telnet client
  1412.      ftp     FTP client
  1413.      http    HTTP client
  1414.      https   Secure HTTP client
  1415.    
  1416.    Kermit's command-line personality changes to match. This can be done
  1417.    (among other ways) with symbolic links (symlinks). For example, if you
  1418.    want C-Kermit to be your regular Telnet client, or the Telnet helper
  1419.    of your Web browser, you can create a link like the following in a
  1420.    directory that lies in your PATH ahead of the regular telnet program:
  1421.    
  1422.   ln -s /usr/local/bin/kermit telnet
  1423.  
  1424.    Now when you give a "telnet" command, you are invoking Kermit instead,
  1425.    but with its Telnet command-line personality so, for example:
  1426.    
  1427.   telnet xyzcorp.com
  1428.  
  1429.    Makes a Telnet connection to xyzcorp.com, and Kermit exits
  1430.    automatically when the connection is closed (just like the regular
  1431.    Telnet client). Type "telnet -h" to get a list of Kermit's
  1432.    Telnet-personality command-line options, which are intended to be as
  1433.    compatible as possible with the regular Telnet client.
  1434.    
  1435.    Similarly for FTP:
  1436.    
  1437.   ln -s /usr/local/bin/kermit ftp
  1438.  
  1439.    And now type "ftp -h" to see its command-line options, and use command
  1440.    lines just like you would give your regular FTP client:
  1441.    
  1442.   ftp -n xyzcorp.com
  1443.  
  1444.    but with additional options allowing an entire session to be specified
  1445.    on the command line, as explained in the C-Kermit [156]FTP client
  1446.    documentation.
  1447.    
  1448.    And similarly for HTTP:
  1449.    
  1450.   ln -s /usr/local/bin/kermit http
  1451.   ./http -h
  1452.   ./http www.columbia.edu -g kermit/index.html
  1453.  
  1454.    Finally, if Kermit's first command-line option is a Telnet, FTP, IKSD,
  1455.    or HTTP URL, Kermit automatically makes the appropriate kind of
  1456.    connection and, if indicated by the URL, takes the desired action:
  1457.    
  1458.   kermit telnet:xyzcorp.com                            ; Opens a Telnet session
  1459.   kermit telnet://olga@xyzcorp.com                     ; Ditto for user olga
  1460.   kermit ftp://olga@xyzcorp.com/public/oofa.zip        ; Downloads a file
  1461.   kermit kermit://kermit.columbia.edu/kermit/f/READ.ME ; Ditto for IKSD
  1462.   kermit iksd://kermit.columbia.edu/kermit/f/READ.ME   ; (This works too)
  1463.   kermit http://www.columbia.edu/kermit/index.html     ; Grabs a web page
  1464.   kermit https://wwws.xyzcorp.com/secret/plan.html     ; Grabs a secure web pag
  1465. e
  1466.  
  1467.    [ [157]Kermit Home ] [ [158]C-Kermit Home ] [ [159]C-Kermit FAQ ]
  1468.     ________________________________________________________________________
  1469.   
  1470.   LICENSE [ [160]Top ] [ [161]Contents ] [ [162]Next ] [ [163]Previous ]
  1471.   
  1472.    C-Kermit has an unusual license, but a fair and sensible one given
  1473.    that the Kermit Project must support itself out of revenue: it's not a
  1474.    BSD license, not GPL, not Artistic, not commercial, not shareware, not
  1475.    freeware. It can be summed up like this: if you want C-Kermit for your
  1476.    own use, you can download and use it without cost or license (but we'd
  1477.    appreciate it if you would purchase the manual). But if you want to
  1478.    sell C-Kermit or bundle it with a product or otherwise distribute it
  1479.    in a commercial setting EXCEPT WITH AN OPEN-SOURCE OPERATING SYSTEM
  1480.    DISTRIBUTION such as Linux, FreeBSD, NetBSD, or OpenBSD, you must
  1481.    license it. To see the complete license, give the LICENSE command at
  1482.    the prompt, or see the COPYING.TXT file distributed with C-Kermit 7.0
  1483.    or later, or download it from
  1484.    [164]ftp://kermit.columbia.edu/kermit/c-kermit/COPYING.TXT. Send
  1485.    licensing inquiries to [165]kermit@columbia.edu.
  1486.    
  1487.    [ [166]Kermit Home ] [ [167]C-Kermit Home ] [ [168]C-Kermit FAQ ]
  1488.     ________________________________________________________________________
  1489.   
  1490.   OTHER TOPICS [ [169]Top ] [ [170]Contents ] [ [171]Next ] [ [172]Previous ]
  1491.   
  1492.    There's way more to C-Kermit than we've touched on here --
  1493.    troubleshooting, customization, character sets, dialing directories,
  1494.    sending pages, script writing, and on and on, all of which are covered
  1495.    in the manual and updates and supplements. For the most up-to-date
  1496.    information on documentation (or updated documentation itself) visit
  1497.    the Kermit Project website:
  1498.    
  1499.   [173]http://www.columbia.edu/kermit/
  1500.  
  1501.    There you will also find [174]Kermit software packages for other
  1502.    platforms: different Unix varieties, Windows, DOS, VMS, IBM
  1503.    mainframes, and many others: 20+ years' worth.
  1504.    
  1505.    [ [175]Kermit Home ] [ [176]C-Kermit Home ] [ [177]C-Kermit FAQ ]
  1506.     ________________________________________________________________________
  1507.   
  1508.   DOCUMENTATION AND UPDATES [ [178]Top ] [ [179]Contents ] [ [180]Next ] [
  1509.   [181]Previous ]
  1510.   
  1511.    The manual for C-Kermit is:
  1512.    
  1513.     1. Frank da Cruz and Christine M. Gianone, [182]Using C-Kermit,
  1514.        Second Edition, Digital Press / Butterworth-Heinemann, Woburn, MA,
  1515.        1997, 622 pages, ISBN 1-55558-164-1. This is a printed book. It
  1516.        covers C-Kermit 6.0.
  1517.     2. The C-Kermit 7.0 Supplement:
  1518.        [183]http://www.columbia.edu/kermit/ckermit70.html
  1519.     3. The C-Kermit 8.0 Supplement:
  1520.        [184]http://www.columbia.edu/kermit/ckermit80.html
  1521.        
  1522.    The C-Kermit home page is here:
  1523.    
  1524.   [185]http://www.columbia.edu/kermit/ckermit.html
  1525.  
  1526.    Visit this page to learn about new versions, Beta tests, and other
  1527.    news; to read case studies and tutorials; to download source code,
  1528.    install packages, and [186]prebuilt binaries for many platforms. Also
  1529.    visit:
  1530.    
  1531.    [187]http://www.columbia.edu/kermit/scriptlib.html
  1532.           The Kermit script library and tutorial
  1533.           
  1534.    [188]http://www.columbia.edu/kermit/newfaq.html
  1535.           The Kermit FAQ (Frequently Asked Questions about Kermit)
  1536.           
  1537.    [189]http://www.columbia.edu/kermit/ckfaq.html
  1538.           The C-Kermit FAQ (Frequently Asked Questions about C-Kermit)
  1539.           
  1540.    [190]http://www.columbia.edu/kermit/security.html
  1541.           The Kermit security reference.
  1542.           
  1543.    [191]http://www.columbia.edu/kermit/telnet.html
  1544.           C-Kermit Telnet client documentation.
  1545.           
  1546.    [192]http://www.columbia.edu/kermit/studies.html
  1547.           Case studies.
  1548.           
  1549.    [193]http://www.columbia.edu/kermit/ckcbwr.html
  1550.           General C-Kermit Hints and Tips.
  1551.           
  1552.    [194]http://www.columbia.edu/kermit/ckubwr.html
  1553.           Unix C-Kermit Hints and Tips.
  1554.           
  1555.    [195]http://www.columbia.edu/kermit/ckvbwr.html
  1556.           VMS C-Kermit Hints and Tips.
  1557.           
  1558.    [196]http://www.columbia.edu/kermit/ckuins.html
  1559.           Unix C-Kermit Installation Instructions
  1560.           
  1561.    [197]http://www.columbia.edu/kermit/ckvins.html
  1562.           VMS C-Kermit Installation Instructions
  1563.           
  1564.    [198]http://www.columbia.edu/kermit/support.html
  1565.           Technical support.
  1566.           
  1567.    [199]http://www.columbia.edu/kermit/k95tutorial.html
  1568.           Kermit 95 tutorial (this document).
  1569.           
  1570.    [200]comp.protocols.kermit.misc
  1571.           The Kermit newsgroup (unmoderated).
  1572.           
  1573.    [ [201]Kermit Home ] [ [202]C-Kermit Home ] [ [203]C-Kermit FAQ ]
  1574.     ________________________________________________________________________
  1575.   
  1576.   FILES [ [204]Top ] [ [205]Contents ] [ [206]Next ] [ [207]Previous ]
  1577.   
  1578.    [208]COPYING.TXT
  1579.           C-Kermit license.
  1580.           
  1581.    [209]~/.kermrc
  1582.           Initialization file.
  1583.           
  1584.    [210]~/.mykermrc
  1585.           Customization file.
  1586.           
  1587.    ~/.kdd
  1588.           Kermit dialing directory (see manual).
  1589.           
  1590.    ~/.knd
  1591.           Kermit network directory (see manual).
  1592.           
  1593.    ~/.ksd
  1594.           Kermit services directory (see manual).
  1595.           
  1596.    [211]ckuins.html
  1597.           Installation instructions for Unix.
  1598.           
  1599.    [212]ckcbwr.html
  1600.           General C-Kermit bugs, hints, tips.
  1601.           
  1602.    [213]ckubwr.html
  1603.           Unix-specific C-Kermit bugs, hints, tips.
  1604.           
  1605.    [214]ckcplm.html
  1606.           C-Kermit program logic manual.
  1607.           
  1608.    [215]ckccfg.html
  1609.           C-Kermit compile-time configuration options.
  1610.           
  1611.    ssh
  1612.           (in your PATH) SSH connection helper.
  1613.           
  1614.    rz, sz, etc.
  1615.           (in your PATH) external protocols for XYZmodem.
  1616.           
  1617.    /var/spool/locks (or whatever)
  1618.           UUCP lockfile for dialing out (see [216]installation
  1619.           instructions).
  1620.           
  1621.    [ [217]Kermit Home ] [ [218]C-Kermit Home ] [ [219]C-Kermit FAQ ]
  1622.     ________________________________________________________________________
  1623.   
  1624.   AUTHORS [ [220]Top ] [ [221]Contents ] [ [222]Previous ]
  1625.   
  1626.      Frank da Cruz and Jeffrey E Altman
  1627.      The Kermit Project - Columbia Univerity
  1628.      612 West 115th Street
  1629.      New York NY 10025-7799
  1630.      USA
  1631.      
  1632.    1985-present, with contributions from hundreds of others all over the
  1633.    world.
  1634.      _________________________________________________________________
  1635.    
  1636.    
  1637.     C-Kermit 8.0 Unix Manual Page and Tutorial /
  1638.     [223]kermit@columbia.edu / 12 December 2001
  1639.  
  1640. References
  1641.  
  1642.    1. http://www.columbia.edu/kermit/
  1643.    2. http://www.columbia.edu/
  1644.    3. http://www.columbia.edu/kermit/ckututor.pdf
  1645.    4. ftp://kermit.columbia.edu/kermit/test/text/ckuker.nr
  1646.    5. http://www.columbia.edu/kermit/ckututor.html#description
  1647.    6. http://www.columbia.edu/kermit/ckututor.html#synopsis
  1648.    7. http://www.columbia.edu/kermit/ckututor.html#options
  1649.    8. http://www.columbia.edu/kermit/ckututor.html#commands
  1650.    9. http://www.columbia.edu/kermit/ckututor.html#initfile
  1651.   10. http://www.columbia.edu/kermit/ckututor.html#modes
  1652.   11. http://www.columbia.edu/kermit/ckututor.html#connections
  1653.   12. http://www.columbia.edu/kermit/ckututor.html#transfer
  1654.   13. http://www.columbia.edu/kermit/ckututor.html#ftp
  1655.   14. http://www.columbia.edu/kermit/ckututor.html#iksd
  1656.   15. http://www.columbia.edu/kermit/ckututor.html#security
  1657.   16. http://www.columbia.edu/kermit/ckututor.html#personae
  1658.   17. http://www.columbia.edu/kermit/ckututor.html#license
  1659.   18. http://www.columbia.edu/kermit/ckututor.html#other
  1660.   19. http://www.columbia.edu/kermit/ckututor.html#documentation
  1661.   20. http://www.columbia.edu/kermit/ckututor.html#files
  1662.   21. http://www.columbia.edu/kermit/ckututor.html#authors
  1663.   22. http://www.columbia.edu/kermit/ckututor.html#top
  1664.   23. http://www.columbia.edu/kermit/ckututor.html#contents
  1665.   24. http://www.columbia.edu/kermit/ckututor.html#synopsis
  1666.   25. http://www.columbia.edu/kermit/ckermit.html
  1667.   26. http://www.columbia.edu/kermit/
  1668.   27. http://www.columbia.edu/
  1669.   28. ftp://ftp.isi.edu/in-notes/rfc2839.txt
  1670.   29. ftp://ftp.isi.edu/in-notes/rfc2840.txt
  1671.   30. http://www.columbia.edu/kermit/ckututor.html#documentation
  1672.   31. http://www.columbia.edu/kermit/
  1673.   32. http://www.columbia.edu/kermit/
  1674.   33. http://www.columbia.edu/kermit/ckermit.html
  1675.   34. http://www.columbia.edu/kermit/ckfaq.html
  1676.   35. http://www.columbia.edu/kermit/ckututor.html#top
  1677.   36. http://www.columbia.edu/kermit/ckututor.html#contents
  1678.   37. http://www.columbia.edu/kermit/ckututor.html#options
  1679.   38. http://www.columbia.edu/kermit/ckututor.html#synopsis
  1680.   39. http://www.columbia.edu/kermit/ckututor.html#kerbang
  1681.   40. http://www.columbia.edu/kermit/ckututor.html#personae
  1682.   41. http://www.columbia.edu/kermit/ckututor.html#kerbang
  1683.   42. http://www.columbia.edu/kermit/ckututor.html#initfile
  1684.   43. http://www.columbia.edu/kermit/ckututor.html#initfile
  1685.   44. http://www.columbia.edu/kermit/ckututor.html#personae
  1686.   45. http://www.columbia.edu/kermit/ckututor.html#options
  1687.   46. http://www.columbia.edu/kermit/ckututor.html#commands
  1688.   47. http://www.columbia.edu/kermit/
  1689.   48. http://www.columbia.edu/kermit/ckermit.html
  1690.   49. http://www.columbia.edu/kermit/ckfaq.html
  1691.   50. http://www.columbia.edu/kermit/ckututor.html#top
  1692.   51. http://www.columbia.edu/kermit/ckututor.html#contents
  1693.   52. http://www.columbia.edu/kermit/ckututor.html#commands
  1694.   53. http://www.columbia.edu/kermit/ckututor.html#description
  1695.   54. http://www.columbia.edu/kermit/ckututor.html#commands
  1696.   55. http://www.columbia.edu/kermit/ckututor.html#personae
  1697.   56. http://www.columbia.edu/kermit/ckututor.html#personae
  1698.   57. http://www.columbia.edu/kermit/ckututor.html#iksd
  1699.   58. http://www.columbia.edu/kermit/ckututor.html#transfer
  1700.   59. http://www.columbia.edu/kermit/ckututor.html#top
  1701.   60. http://www.columbia.edu/kermit/ckututor.html#contents
  1702.   61. http://www.columbia.edu/kermit/ckututor.html#initfile
  1703.   62. http://www.columbia.edu/kermit/ckututor.html#options
  1704.   63. http://www.columbia.edu/kermit/ckututor.html#kerbang
  1705.   64. http://www.columbia.edu/kermit/ckututor.html#cmdlist
  1706.   65. http://www.columbia.edu/kermit/ckututor.html#documentation
  1707.   66. http://www.columbia.edu/kermit/ckututor.html#initfile
  1708.   67. http://www.columbia.edu/kermit/ckututor.html#documentation
  1709.   68. http://www.columbia.edu/kermit/ckscripts.html
  1710.   69. http://www.columbia.edu/kermit/ckututor.html#documentation
  1711.   70. http://www.columbia.edu/kermit/
  1712.   71. http://www.columbia.edu/kermit/ckermit.html
  1713.   72. http://www.columbia.edu/kermit/ckfaq.html
  1714.   73. http://www.columbia.edu/kermit/ckututor.html#top
  1715.   74. http://www.columbia.edu/kermit/ckututor.html#contents
  1716.   75. http://www.columbia.edu/kermit/ckututor.html#modes
  1717.   76. http://www.columbia.edu/kermit/ckututor.html#commands
  1718.   77. http://www.columbia.edu/kermit/
  1719.   78. http://www.columbia.edu/kermit/ckermit.html
  1720.   79. http://www.columbia.edu/kermit/ckfaq.html
  1721.   80. http://www.columbia.edu/kermit/ckututor.html#top
  1722.   81. http://www.columbia.edu/kermit/ckututor.html#contents
  1723.   82. http://www.columbia.edu/kermit/ckututor.html#connections
  1724.   83. http://www.columbia.edu/kermit/ckututor.html#initfile
  1725.   84. http://www.columbia.edu/kermit/ckfaq.html#term
  1726.   85. http://www.columbia.edu/kermit/
  1727.   86. http://www.columbia.edu/kermit/ckermit.html
  1728.   87. http://www.columbia.edu/kermit/ckfaq.html
  1729.   88. http://www.columbia.edu/kermit/ckututor.html#top
  1730.   89. http://www.columbia.edu/kermit/ckututor.html#contents
  1731.   90. http://www.columbia.edu/kermit/ckututor.html#transfer
  1732.   91. http://www.columbia.edu/kermit/ckututor.html#modes
  1733.   92. http://www.columbia.edu/kermit/ckututor.html#iksd
  1734.   93. ftp://ftp.isi.edu/in-notes/rfc2217.txt
  1735.   94. http://www.columbia.edu/kermit/ckututor.html#ftp
  1736.   95. http://www.columbia.edu/kermit/
  1737.   96. http://www.columbia.edu/kermit/ckermit.html
  1738.   97. http://www.columbia.edu/kermit/ckfaq.html
  1739.   98. http://www.columbia.edu/kermit/ckututor.html#top
  1740.   99. http://www.columbia.edu/kermit/ckututor.html#contents
  1741.  100. http://www.columbia.edu/kermit/ckututor.html#ftp
  1742.  101. http://www.columbia.edu/kermit/ckututor.html#connections
  1743.  102. http://www.columbia.edu/kermit/ckututor.html#download
  1744.  103. http://www.columbia.edu/kermit/ckututor.html#upload
  1745.  104. http://www.columbia.edu/kermit/ckututor.html#oldfashioned
  1746.  105. http://www.columbia.edu/kermit/ckututor.html#trouble
  1747.  106. http://www.columbia.edu/kermit/ckututor.html#advanced
  1748.  107. http://www.columbia.edu/kermit/ckututor.html#nonkermit
  1749.  108. http://www.columbia.edu/kermit/kermit.html#notslow
  1750.  109. http://www.columbia.edu/kermit/ckermit.html
  1751.  110. http://www.columbia.edu/kermit/k95.html
  1752.  111. http://www.columbia.edu/kermit/k95.html
  1753.  112. http://www.columbia.edu/kermit/ckermit.html
  1754.  113. http://www.columbia.edu/kermit/mskermit.html
  1755.  114. http://www.columbia.edu/kermit/
  1756.  115. http://www.columbia.edu/kermit/support.html
  1757.  116. http://www.columbia.edu/kermit/ckmanual.html
  1758.  117. mailto:kermit-support@columbia.edu
  1759.  118. http://www.columbia.edu/kermit/ckututor.html#documentation
  1760.  119. http://www.columbia.edu/kermit/ckututor.html#ftp
  1761.  120. http://www.columbia.edu/kermit/
  1762.  121. http://www.columbia.edu/kermit/ckermit.html
  1763.  122. http://www.columbia.edu/kermit/ckfaq.html
  1764.  123. http://www.columbia.edu/kermit/ckututor.html#top
  1765.  124. http://www.columbia.edu/kermit/ckututor.html#contents
  1766.  125. http://www.columbia.edu/kermit/ckututor.html#iksd
  1767.  126. http://www.columbia.edu/kermit/ckututor.html#transfer
  1768.  127. http://www.columbia.edu/kermit/ftpclient.html
  1769.  128. http://www.columbia.edu/kermit/ckututor.html#documentation
  1770.  129. http://www.columbia.edu/kermit/
  1771.  130. http://www.columbia.edu/kermit/ckermit.html
  1772.  131. http://www.columbia.edu/kermit/ckfaq.html
  1773.  132. http://www.columbia.edu/kermit/ckermit3.html#x3
  1774.  133. http://www.columbia.edu/kermit/ckermit3.html#x2.2
  1775.  134. http://www.columbia.edu/kermit/ckututor.html#top
  1776.  135. http://www.columbia.edu/kermit/ckututor.html#contents
  1777.  136. http://www.columbia.edu/kermit/ckututor.html#security
  1778.  137. http://www.columbia.edu/kermit/ckututor.html#ftp
  1779.  138. http://www.columbia.edu/kermit/cuiksd.html
  1780.  139. http://www.columbia.edu/kermit/iksd.html
  1781.  140. http://www.columbia.edu/kermit/
  1782.  141. http://www.columbia.edu/kermit/ckermit.html
  1783.  142. http://www.columbia.edu/kermit/ckfaq.html
  1784.  143. http://www.columbia.edu/kermit/ckututor.html#top
  1785.  144. http://www.columbia.edu/kermit/ckututor.html#contents
  1786.  145. http://www.columbia.edu/kermit/ckututor.html#personae
  1787.  146. http://www.columbia.edu/kermit/ckututor.html#iksd
  1788.  147. http://www.columbia.edu/kermit/security.html
  1789.  148. http://www.columbia.edu/kermit/
  1790.  149. http://www.columbia.edu/kermit/ckermit.html
  1791.  150. http://www.columbia.edu/kermit/ckfaq.html
  1792.  151. http://www.columbia.edu/kermit/ckututor.html#top
  1793.  152. http://www.columbia.edu/kermit/ckututor.html#contents
  1794.  153. http://www.columbia.edu/kermit/ckututor.html#license
  1795.  154. http://www.columbia.edu/kermit/ckututor.html#iksd
  1796.  155. http://www.columbia.edu/kermit/ckututor.html#options
  1797.  156. http://www.columbia.edu/kermit/ckermit3.html#x3.1.2
  1798.  157. http://www.columbia.edu/kermit/
  1799.  158. http://www.columbia.edu/kermit/ckermit.html
  1800.  159. http://www.columbia.edu/kermit/ckfaq.html
  1801.  160. http://www.columbia.edu/kermit/ckututor.html#top
  1802.  161. http://www.columbia.edu/kermit/ckututor.html#contents
  1803.  162. http://www.columbia.edu/kermit/ckututor.html#other
  1804.  163. http://www.columbia.edu/kermit/ckututor.html#personae
  1805.  164. ftp://kermit.columbia.edu/kermit/c-kermit/COPYING.TXT
  1806.  165. mailto:kermit@columbia.edu
  1807.  166. http://www.columbia.edu/kermit/
  1808.  167. http://www.columbia.edu/kermit/ckermit.html
  1809.  168. http://www.columbia.edu/kermit/ckfaq.html
  1810.  169. http://www.columbia.edu/kermit/ckututor.html#top
  1811.  170. http://www.columbia.edu/kermit/ckututor.html#contents
  1812.  171. http://www.columbia.edu/kermit/ckututor.html#documentation
  1813.  172. http://www.columbia.edu/kermit/ckututor.html#license
  1814.  173. http://www.columbia.edu/kermit/
  1815.  174. http://www.columbia.edu/kermit/howtoget.html
  1816.  175. http://www.columbia.edu/kermit/
  1817.  176. http://www.columbia.edu/kermit/ckermit.html
  1818.  177. http://www.columbia.edu/kermit/ckfaq.html
  1819.  178. http://www.columbia.edu/kermit/ckututor.html#top
  1820.  179. http://www.columbia.edu/kermit/ckututor.html#contents
  1821.  180. http://www.columbia.edu/kermit/ckututor.html#files
  1822.  181. http://www.columbia.edu/kermit/ckututor.html#other
  1823.  182. http://www.columbia.edu/kermit/ckmanual.html
  1824.  183. http://www.columbia.edu/kermit/ckermit70.html
  1825.  184. http://www.columbia.edu/kermit/ckermit80.html
  1826.  185. http://www.columbia.edu/kermit/ckermit.html
  1827.  186. http://www.columbia.edu/kermit/ck80binaries.html
  1828.  187. http://www.columbia.edu/kermit/scriptlib.html
  1829.  188. http://www.columbia.edu/kermit/newfaq.html
  1830.  189. http://www.columbia.edu/kermit/ckfaq.html
  1831.  190. http://www.columbia.edu/kermit/security.html
  1832.  191. http://www.columbia.edu/kermit/telnet.html
  1833.  192. http://www.columbia.edu/kermit/studies.html
  1834.  193. http://www.columbia.edu/kermit/ckcbwr.html
  1835.  194. http://www.columbia.edu/kermit/ckubwr.html
  1836.  195. http://www.columbia.edu/kermit/ckvbwr.html
  1837.  196. http://www.columbia.edu/kermit/ckuins.html
  1838.  197. http://www.columbia.edu/kermit/ckvins.html
  1839.  198. http://www.columbia.edu/kermit/support.html
  1840.  199. http://www.columbia.edu/kermit/k95tutorial.html
  1841.  200. news:comp.protocols.kermit.misc
  1842.  201. http://www.columbia.edu/kermit/
  1843.  202. http://www.columbia.edu/kermit/ckermit.html
  1844.  203. http://www.columbia.edu/kermit/ckfaq.html
  1845.  204. http://www.columbia.edu/kermit/ckututor.html#top
  1846.  205. http://www.columbia.edu/kermit/ckututor.html#contents
  1847.  206. http://www.columbia.edu/kermit/ckututor.html#authors
  1848.  207. http://www.columbia.edu/kermit/ckututor.html#documentation
  1849.  208. ftp://kermit.columbia.edu/kermit/c-kermit/COPYING.TXT
  1850.  209. ftp://kermit.columbia.edu/kermit/c-kermit/ckermit.ini
  1851.  210. ftp://kermit.columbia.edu/kermit/c-kermit/ckermod.ini
  1852.  211. http://www.columbia.edu/kermit/ckuins.html
  1853.  212. http://www.columbia.edu/kermit/ckcbwr.html
  1854.  213. http://www.columbia.edu/kermit/ckubwr.html
  1855.  214. http://www.columbia.edu/kermit/ckcplm.html
  1856.  215. http://www.columbia.edu/kermit/ckccfg.html
  1857.  216. http://www.columbia.edu/kermit/ckuins.html
  1858.  217. http://www.columbia.edu/kermit/
  1859.  218. http://www.columbia.edu/kermit/ckermit.html
  1860.  219. http://www.columbia.edu/kermit/ckfaq.html
  1861.  220. http://www.columbia.edu/kermit/ckututor.html#top
  1862.  221. http://www.columbia.edu/kermit/ckututor.html#contents
  1863.  222. http://www.columbia.edu/kermit/ckututor.html#files
  1864.  223. mailto:kermit@columbia.edu
  1865.