home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / k95 / README.TXT < prev    next >
Text File  |  2020-01-01  |  60KB  |  1,268 lines
  1.  
  2.   WELCOME TO KERMIT 95 VERSION 1.1.21
  3.   
  4.      2 April 2002
  5.      
  6.    Powerful, flexible, customizable 32-bit communications software for
  7.    Microsoft Windows 95/98/ME/NT/2000/XP and OS/2. Please remember: this
  8.    is licensed software, not to be redistributed in any form without
  9.    license to do so, nor made available to unlicensed persons for copying
  10.    by any means (including but not limited to network copying).
  11.    
  12.      IMPORTANT: At this writing it has not yet been determined whether
  13.      OS/2 will be supported in K95 1.1.21. If it is not, all references
  14.      to OS/2 in this document should be considered historical. 
  15.      
  16.    Copyright ⌐ 1995, 2002, the Trustees of Columbia University in the
  17.    City of New York, all rights reserved.
  18.    
  19.      Portions Copyright ⌐ 1986 Gary S. Brown.
  20.      Portions Copyright ⌐ 1990, Massachusetts Institute of Technology.
  21.      Portions Copyright ⌐ 1991, 1993 Regents of the University of
  22.      California.
  23.      Portions Copyright ⌐ 1991, 1992, 1993, 1994, 1995 by AT&T.
  24.      Portions Copyright ⌐ 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo,
  25.      Finland.
  26.      Portions Copyright ⌐ 1995, Oy Online Solutions Ltd., Jyvaskyla,
  27.      Finland.
  28.      Portions Copyright ⌐ 1995-1998, Eric Young <eay@cryptosoft.com>.
  29.      Portions Copyright ⌐ 1997, Stanford University.
  30.      Portions Copyright ⌐ 1998 CORE SDI S.A., Buenos Aires, Argentina.
  31.      Portions Copyright ⌐ 1998-2001 The OpenSSL Project.
  32.      Portions Copyright ⌐ (date unspecified) Markus Friedl, Theo de
  33.      Raadt, Niels Provos, Dug Song, Aaron Campbell.
  34.      _________________________________________________________________
  35.    
  36.    CONTENTS
  37.     1. [1]WHAT'S WHAT
  38.     2. [2]WHAT'S NEW
  39.     3. [3]SYSTEM REQUIREMENTS
  40.     4. [4]SECURITY AND ENCRYPTION
  41.     5. [5]INSTALLING KERMIT 95
  42.     6. [6]UNINSTALLING KERMIT 95
  43.     7. [7]REGISTRATION
  44.     8. [8]RESOURCES
  45.     9. [9]FILES AND DIRECTORIES
  46.        
  47.     1. [10]The New Directory Structure
  48.     2. [11]Patches and Search Order
  49.     3. [12]Important K95 Files
  50.        
  51.      [13]ORIENTATION AND NAVIGATION
  52.     1. [14]K95's Initial Directory
  53.     2. [15]K95's CD Command
  54.     3. [16]Where Is My Customization File?
  55.     4. [17]Structure of .INI Files
  56.     5. [18]Where is the File I Just Downloaded?
  57.      _________________________________________________________________
  58.    
  59.    1. WHAT'S WHAT This is version 1.1.21 of Kermit 95 -- the twentieth
  60.    update since the original release in September 1995. You might have
  61.    received this version as an update patch to a previous version, or you
  62.    might have received it as part of a bulk or site license, or you might
  63.    have purchased it new in its box, or via some means of electronic
  64.    delivery. All versions include:
  65.    
  66.    The Kermit 95 Software
  67.           The CDROM includes Kermit 95 for Windows 95/98/ME/NT/2000/XP
  68.           and OS/2. The appropriate version is installed for you
  69.           automatically.
  70.           
  71.    The Kermit 95 Manual
  72.           The new Fifth Edition of the online Kermit 95 manual is
  73.           completely up to date with version 1.1.21. It is in
  74.           [19]HyperText Markup Language (HTML) format so you can navigate
  75.           it with your Web browser. This manual concentrates on the
  76.           unique aspects of Kermit 95, primarily the K95 Dialer and the
  77.           terminal emulator.
  78.           
  79.    The shrinkwrapped retail version, Kermit 95+, also includes the
  80.    following (hence the "+"):
  81.    
  82.    The C-Kermit 7.0 CDROM
  83.           C-Kermit 7.0 is Kermit 95's file-transfer and client/server
  84.           partner for UNIX (Linux, Solaris, AIX, HP-UX, etc), VMS, VOS,
  85.           and many other operating systems. It is not part of Kermit 95;
  86.           it has been included to ensure that you have an up-to-date,
  87.           high-performance, supported Kermit file transfer partner on the
  88.           UNIX, VMS, or VOS systems that you connect to with Kermit 95.
  89.           NOTE: At this writing C-Kermit 8.0 is newly released and
  90.           available on the [20]C-Kermit website, but the C-Kermit 8.0
  91.           CDROM is not ready yet.
  92.           
  93.    The C-Kermit Manual
  94.           The book, [21]Using C-Kermit, is the technical reference manual
  95.           for the Command Window and script programming language, as well
  96.           as for file transfer, and also contains useful tutorials on
  97.           character sets, data communications and troubleshooting of
  98.           dialing and connection problems. It is also the user manual for
  99.           C-Kermit itself, which has the same command and scripting
  100.           language as Kermit 95. The second edition of Using C-Kermit was
  101.           published concurrently with the release of C-Kermit 6.0 and
  102.           Kermit 95 1.1.8; updates for C-Kermit 7.0 (which corresponds to
  103.           Kermit 95 1.1.20) and 8.0 (Kermit 95 1.1.21) are included with
  104.           the K95 manual. Beginning with Kermit 95 1.1.20, Using C-Kermit
  105.           is provided in online PDF format.
  106.           
  107.    Your Serial Number Stickers and Registration Card
  108.           Explained [22]below.
  109.           
  110.    If you have Kermit 95 as part of a bulk or site license, then you
  111.    received only the Kermit 95 software and online Kermit 95 (but not
  112.    C-Kermit) documentation, preregistered and possibly customized for
  113.    your site. Copies of Using C-Kermit (ISBN 1-55558-164-1) should be
  114.    available at your organization's library or software licensing office,
  115.    and can also be ordered separately or purchased in book or computer
  116.    stores or from [23]Amazon.Com or from [24]the Kermit Project.
  117.    
  118.    [ [25]Top ] [ [26]Contents ] [ [27]K95 Manual ]
  119.      _________________________________________________________________
  120.    
  121.    2. WHAT'S NEW Kermit 95 1.1.21, despite differing from the previous
  122.    release only in the 4th decimal point, has tons of new features
  123.    representing two years of steady work:
  124.    
  125.      * A built-in [28]SSH v1 and v2 client (Windows only).
  126.      * A built-in [29]FTP client.
  127.      * A built-in [30]HTTP client.
  128.      * An [31]Internet Kermit Service for Windows NT/2000/XP
  129.      * A GUI (InstallShield) installation procedure.
  130.      * [32]New directory layout follows Windows standards.
  131.      * [33]Changes in the Dialer.
  132.      * All the new command language and scripting features of
  133.        [34]C-Kermit 8.0.
  134.        
  135.    Like the previous releases, it is a console program, but it will be
  136.    followed shortly by [35]Version 2.00: the long-awaited GUI version of
  137.    Kermit 95, with approximately the same feature set as 1.1.21 but in a
  138.    GUI rather than Console window.
  139.    
  140.    [ [36]Top ] [ [37]Contents ] [ [38]K95 Manual ]
  141.      _________________________________________________________________
  142.    
  143.    3. SYSTEM REQUIREMENTS All you need to use Kermit 95 are:
  144.      * An Intel-based or compatible PC running Microsoft Windows 95, 98,
  145.        ME, NT 4.0 or later, Windows 2000, or Windows XP.
  146.      * The normal amount of memory and swap space for those platforms (as
  147.        with any Windows application, K95 works best when there is plenty
  148.        of memory and a fast processor).
  149.      * For making connections: A serial port and/or modem, and/or a
  150.        network connection.
  151.        
  152.    The following are not supported:
  153.    
  154.      * Non-32-bit-Intel platforms are not supported in K95 1.1.21.
  155.      * Windows NT 3.50 and earlier are not supported.
  156.      * Windows CE is not supported.
  157.        
  158.    At this writing it has not yet been determined whether OS/2 will be
  159.    supported. NT/Alpha support was dropped after 1.1.20. NT/PowerPC
  160.    support was dropped as of K95 1.1.16. 
  161.    
  162.    Windows 95/98/ME and Windows NT/2000/XP are demand-paged virtual
  163.    memory operating systems, and so the time-honored question, "How much
  164.    RAM is required?" does not strictly apply to Kermit 95. But as with
  165.    most Windows applications: the more the better. K95 together with all
  166.    the DLLs it might use (which in turns depend on which features you
  167.    elected during installation or invoke at runtime) needs between 5 and
  168.    30MB, most of which is (a) shared among multiple copies of K95 and
  169.    other applications, and (b) usually paged out to disk. Thus the
  170.    incremental cost of running two, three, four, or more copies of K95 is
  171.    small.
  172.    
  173.    Kermit 95's total disk footprint after installation is about 30MB, of
  174.    which about 20MB is the Using C-Kermit PDF file. Approximately one
  175.    additional megabyte is needed when the Dialer is active, for backup
  176.    and temporary files, depending on the size of your Dialer database.
  177.    
  178.    [ [39]Top ] [ [40]Contents ] [ [41]K95 Manual ]
  179.      _________________________________________________________________
  180.    
  181.    4. SECURITY AND ENCRYPTION Kermit 95 is capable of making secure,
  182.    authenticated, encrypted Internet connections using a variety of
  183.    methods. Under USA law, however, software that utilizes strong
  184.    encryption as found in Kermit 95 cannot be distributed in binary form
  185.    without a license to non-U.S. or Canadian citizens or outside the USA
  186.    and Canada. Patches that provide support for encrypted sessions using
  187.    Kerberos, Secure Remote Password, and X.509 certificates for
  188.    authentication are available from the web site:
  189.    
  190.   [42]http://www.kermit-project.org/k95patch.html#crypto
  191.  
  192.    At this writing, our plan is to submit version 1.1.21 to the US
  193.    Department of Commerce for an export license or exception, allowing
  194.    secure versions of Kermit 95 to be distributed to most countries. We
  195.    have no control over this procedure and can make no guarantees, nor
  196.    give a schedule. Upgrade patches to 1.1.21 will come in secure and
  197.    exportable versions, just as with previous releases.
  198.    
  199.    See the Kermit 95 Online Manual's [43]Network Security Methods
  200.    Reference for further information on Authentication and Encryption
  201.    methods supported by Kermit 95.
  202.    
  203.    [ [44]Top ] [ [45]Contents ] [ [46]K95 Manual ]
  204.      _________________________________________________________________
  205.    
  206.    5. INSTALLING KERMIT 95 New copies of Kermit 1.1.21 and later are
  207.    installed using a new graphical [47]InstallShield procedure that
  208.    replaces the text-mode question and answer session of the SETUP.EXE
  209.    program that came with K95 1.1.20 and earlier. If you are patching up
  210.    from an original installation of 1.1.20 or earlier, you will never see
  211.    the InstallShield procedure. If you are installing a new copy Kermit
  212.    95, the installation instructions appear on your screen when you
  213.    install it. You can also read them [48]HERE.
  214.    
  215.    [ [49]Top ] [ [50]Contents ] [ [51]K95 Manual ]
  216.      _________________________________________________________________
  217.    
  218.    6. UNINSTALLING KERMIT 95 Should you wish to remove Kermit 95 from
  219.    your Windows 95 system, it depends on how you installed it in the
  220.    first place. In both cases you should exit from all Kermit programs
  221.    (K95, the Dialer) first. Then:
  222.    
  223.    If you installed K95 with the text-mode installer (SETUP.EXE):
  224.           
  225.          1. If you used K95 Registry Tool to add Kermit 95 configuration
  226.             information into the Windows Registry, run it again to remove
  227.             the information from the Registry.
  228.          2. Drag the Kermit 95 folder to the Recycle Bin. Do the same
  229.             with any shortcuts you might have created to Kermit 95.
  230.             
  231.    If you installed K95 with the GUI InstallShield installer:
  232.           Simply use Add/Remove Programs in the Windows Control Panel to
  233.           remove it:
  234.           
  235.          1. Press the Change/Remove button to re-start the installer.
  236.          2. Select Remove all installed components
  237.          3. The uninstall process deliberately leaves behind certain
  238.             files associated with Kermit 95, in case you ever re-install
  239.             K95 and want your customizations intact, or you want to keep
  240.             files that you downloaded, etc:
  241.                o IKSD.KSC
  242.                o K95CUSTOM.INI
  243.                o DIALUSR.DAT
  244.                o KRB.CON
  245.                o KRBREALM.CON
  246.                o KRB5.INI
  247.                o Each user's [52]application data directory and
  248.                  subdirectories.
  249.                o Each user's DOWNLOAD directory.
  250.                o Any files the K95 Installer didn't install.
  251.             If you wish to remove these files you may do so after the
  252.             uninstall is complete by deleting the files in the Windows
  253.             Explorer.
  254.          4. If you have installed Kerberos the uninstall might require a
  255.             reboot to remove the krbcc32s.exe application that stores
  256.             your Kerberos credentials in memory.
  257.             
  258.    [ [53]Top ] [ [54]Contents ] [ [55]K95 Manual ]
  259.      _________________________________________________________________
  260.    
  261.    7. REGISTRATION If you have a site- or bulk-licensed version of Kermit
  262.    95, or if you are upgrading from an earlier version by applying a
  263.    patch, then your copy of Kermit 95 is already registered, in which
  264.    case please [56]ignore this section, which applies to the
  265.    shrinkwrapped package.
  266.    
  267.    Kermit 95 comes with two serial-number stickers. The serial number on
  268.    each sticker should be the same.
  269.    
  270.    The installation software includes a registration procedure that asks
  271.    for your name, company, and Kermit 95 serial number. You should enter
  272.    your real name, since it will be announced every time you (or anyone
  273.    else) starts the program. The company name is optional. The serial
  274.    number must be entered exactly as shown on the sticker: letters,
  275.    punctuation, and all.
  276.    
  277.    Then please affix ONE of the stickers to your mailback registration
  278.    card, fill out the card, and mail it back to us. Keep the other
  279.    sticker as a record of your serial number; for example, in case your
  280.    PC stops working and you have to install K95 on a new PC. In case you
  281.    lose your serial number, we'll have a record of it if you sent in your
  282.    card.
  283.    
  284.    If you have an e-mail address, be sure to include it so we can notify
  285.    you of new releases or patches (mailings are infrequent and there is
  286.    no junk mail; the list is private and is not sold or otherwise
  287.    provided to anyone else for any purpose).
  288.    
  289.    [ [57]Top ] [ [58]Contents ] [ [59]K95 Manual ]
  290.      _________________________________________________________________
  291.    
  292.    8. RESOURCES
  293.    
  294.    [60]Using C-Kermit, 2nd Edition
  295.           The user manual for C-Kermit and the technical reference manual
  296.           for Kermit95 in PDF format. Included only with shrinkwrapped
  297.           copies of Kermit 95 1.1.20 and later. Access from the
  298.           References links in the Kermit 95 manual. Also available [61]in
  299.           book form.
  300.           
  301.    [62]The C-Kermit 7.0 Update Notes
  302.           
  303.    [63]The C-Kermit 8.0 Update Notes
  304.           Kermit 95 1.1.21 is based on C-Kermit 8.0, but Using C-Kermit
  305.           is current with C-Kermit 6.0. The C-Kermit 7.0 and 8.0 update
  306.           notes document all the features added to C-Kermit since the
  307.           second edition of the book was published in 1997. These are
  308.           fully cross-linked HTML documents, rather than plain text as in
  309.           earlier K95 releases. Access them via the link in the
  310.           References section at the top your K95 manual.
  311.           
  312.    [64]The Kermit 95 FAQ
  313.           Frequently Asked Questions (and answers) about Kermit 95. If
  314.           you have a question about Kermit 95, look here first. Access
  315.           the K95 FAQ via the link in the References section at the top
  316.           your K95 manual.
  317.           
  318.    [65]The Kermit 95 Bug List
  319.           A chronological list of bugs in all the Kermit 95 releases.
  320.           Most of them have been fixed; most of those that remain are due
  321.           to bugs or limitations in the underlying operating system. In
  322.           many cases, workarounds are suggested. If you have problems
  323.           with Kermit 95, be sure to look here for a discussion of it and
  324.           a possible solution. This is a fully indexed and crosslinked
  325.           HTML document, rather than plain text. Access it via the link
  326.           in the References section at the top your K95 manual.
  327.           
  328.    [66]The Kermit Security Reference
  329.           A detailed explanation of Kermit's many security methods, with
  330.           command lists for each.
  331.           
  332.    [67]http://www.columbia.edu/kermit/
  333.           The Kermit Project website on the Internet. Here you will find
  334.           information about Kermit software for other platforms, news
  335.           about Kermit 95, hints and tips, script programming examples,
  336.           and lots more. Internet connection required. Here are some
  337.           points of interest:
  338.           
  339.         [68]ftp://kermit.columbia.edu/kermit/k95/newbugs.txt
  340.                 The newbugs.txt file at the Kermit Project website. This
  341.                 file lists bugs or other information discovered after
  342.                 this release of Kermit 95 was packaged.
  343.                 
  344.         [69]http://www.columbia.edu/kermit/k95.html
  345.                 The Kermit 95 page.
  346.                 
  347.         [70]http://www.columbia.edu/kermit/k95pricing.html
  348.                 Kermit 95 pricing and licensing options. Details about
  349.                 low-cost bulk right-to-copy licenses and academic site
  350.                 licenses.
  351.                 
  352.         [71]http://www.columbia.edu/kermit/k95next.html
  353.                 News about upcoming K95 releases.
  354.                 
  355.         [72]http://www.columbia.edu/kermit/ckermit.html
  356.                 The C-Kermit page, K95's companion software for UNIX,
  357.                 VMS, and other platforms.
  358.                 
  359.         [73]http://www.columbia.edu/kermit/support.html
  360.                 The technical support page, explaining how to get
  361.                 technical support, and including some hints and tips to
  362.                 save you some time.
  363.                 
  364.         [74]http://www.columbia.edu/kermit/scriptlib.html
  365.                 The Kermit Script Library. Lots of sample scripts
  366.                 demonstrating how to automate everything from dialing to
  367.                 Internet sessions to complex file-management and
  368.                 computation tasks.
  369.                 
  370.    [75]comp.protocols.kermit.announce
  371.           The Kermit software announcements newsgroup (moderated).
  372.           
  373.    [76]comp.protocols.kermit.misc
  374.           The Kermit software discussion newsgroup (unmoderated).
  375.           
  376.    [ [77]Top ] [ [78]Contents ] [ [79]K95 Manual ]
  377.     ________________________________________________________________________
  378.   
  379.   9. FILES AND DIRECTORIES
  380.   
  381.   9.1. [80]The New Directory Structure
  382.   9.2. [81]Patches and Search Order
  383.   9.3. [82]Important K95 Files
  384.  
  385.    Version 1.1.21 of Kermit 95 marks a dramatic departure from earlier
  386.    versions in file and directory structure. 1.1.20 and earlier stored
  387.    everything in a single directory tree, such as C:\K95. This was simple
  388.    to explain, short to type, kept everything together in one place, and
  389.    made your Kermit files easy to find; for example, when you wanted to
  390.    [83]edit your K95CUSTOM.INI file. However, the original scheme does
  391.    mesh with multiuser file systems like the ones on Windows XP or
  392.    Terminal Server. Not only does it prevent users from having their own
  393.    separate customization files, dialing directories, download areas, and
  394.    so on, it also prevents system administrators from being able to
  395.    enforce appropriate file access permissions on the program tree.
  396.    
  397.    The new directory structure makes server installation much more
  398.    natural. The Program files directory goes on the server, read-only.
  399.    The Global (All Users) K95 data directory goes on the server too, with
  400.    any desired site-specific customizations, and then made read-only too.
  401.    Then the user-specific K95 data tree goes with the user's other data
  402.    files in the user's Application Data tree, read/write.
  403.     ________________________________________________________________________
  404.   
  405.   9.1. The New Directory Structure
  406.   
  407.    As of version 1.1.21, Kermit 95 is installed just like any other
  408.    Windows application. Parts of it go into "Program Files", other parts
  409.    into the All Users data area, and still others into the user's
  410.    directory tree. This is the Windows Way of installing applications.
  411.    The Windows directory paths are long and contain spaces, which tends
  412.    to confuse text-based programs -- not just Kermit 95, but any program
  413.    that has commands composed of fields separated by spaces. For this
  414.    reason Kermit 95 represents these directories by variables that expand
  415.    into Windows "short names" such as "MYDOCU~1" rather than long names
  416.    like "My Documents". Kermit 95's new directory structure is as
  417.    follows:
  418.    
  419.    The Program Directory
  420.           Created by: InstallShield (the Kermit 95 installer)
  421.           Purpose: Read/Execute-only software, DLLs, icons,
  422.           documentation.
  423.           Win9x/ME: C:\Program Files\Kermit 95\
  424.           NT/2000/XP:   C:\Program Files\Kermit 95\
  425.           Variable: \v(exedir)
  426.           Contents:
  427.           
  428.           + The Kermit 95 executable, K95.EXE
  429.           + The Dialer, K95DIAL.EXE, and its supporting resources (but
  430.             not data)
  431.           + Any DLLs needed by Kermit 95 or the Dialer
  432.           + Assorted utilities and scripts
  433.           + The following subdirectories: DOCS: Kermit 95 Documentation
  434.             ICONS:    Kermit 95 Icons
  435.             
  436.    Global (All Users) data for K95
  437.           Created by: InstallShield
  438.           Purpose: Read-only site-specific, site-wide configurations and
  439.           data.
  440.           Win9x/ME: C:\WINDOWS\All Users\Application Data\Kermit 95\
  441.           NT/2000/XP:   C:\Documents and Settings\All Users\Application
  442.           Data\Kermit 95\
  443.           Variable: \v(common)
  444.           Contents:
  445.           
  446.           + Kermit 95's initialization file, K95.INI.
  447.           + Site-specific customization file, K95SITE.INI (new).
  448.           + The DIALINF.DAT Dialer database (factory predefined entries).
  449.           + The DIALORG.DAT Dialer database (organizational predefined
  450.             entries).
  451.           + The following subdirectories containing data for all users at
  452.             the site. The files in these directories are initially as
  453.             distributed with K95, but might be modified by the site
  454.             administrator:
  455.             CERTS Site-wide X.509 certificates for SSL/TLS.
  456.             CRLS Site-wide X.509 certificate revocation lists for
  457.             SSL/TLS.
  458.             KEYMAPS    Site-wide key mapping files and information.
  459.             PHONES Site-wide dialing directories.
  460.             PRINTER Printer-related utilities and information
  461.             SCRIPTS Sample and/or production scripts
  462.             SSH Site-specific SSH host keys
  463.             
  464.      NOTE: On Windows NT, 2000, and XP, if the person installing Kermit
  465.      95 does not have write access to the All Users tree (e.g. because
  466.      Administrator privilege is lacking), all of the items listed above
  467.      for the \v(common) tree are placed instead in the \v(appdata) tree
  468.      (next item). In Windows 95, 98, and ME, the \v(common) tree is
  469.      always used as described above. 
  470.      
  471.    User-specific data for all applications (s = single-user, m =
  472.           multiuser):
  473.           Created by: Windows 98 and higher when your ID is created. Not
  474.           standard in Windows 95.
  475.           Purpose: Read/Write user-specific data for all applications.
  476.           Win95: C:\My Documents\ (if it exists).
  477.           Win98/ME (s): C:\My Documents\
  478.           Win98/ME (m): C:\WINDOWS\Profiles\username\My Documents\
  479.           NT/2000/XP:   C:\Documents and Settings\username\My Documents\
  480.           Variable: \v(personal) (might be empty in Win95).
  481.           Contents:
  482.           
  483.           + Kermit's DOWNLOAD directory, possibly shared with AOL, MSN,
  484.             and other applications.
  485.           + Other data or subdirectories not specific to any particular
  486.             application.
  487.             
  488.    User-specific data for K95 (s = single-user, m = multiuser):
  489.           Created by: Kermit 95 upon first use.
  490.           Purpose: Read/Write user-specific configurations and data.
  491.           Win9x/ME (s): C:\WINDOWS\Application Data\Kermit 95\
  492.           Win9x/ME (m): C:\WINDOWS\Profiles\username\Application
  493.           Data\Kermit 95\
  494.           NT/2000/XP:   C:\Documents and Settings\username\Application
  495.           Data\Kermit 95\
  496.           Variable: \v(appdata)
  497.           Contents:
  498.           
  499.           + Each user's customization file, K95CUSTOM.INI
  500.           + Each user's DIALUSR.DAT Dialer database
  501.           + For each user, the following subdirectories, initially empty;
  502.             can be populated by the user:
  503.             CERTS Your personal X.509 certificates for SSL/TSL.
  504.             CRLS Your personal X.509 certificate revocation lists for
  505.             SSL/TSL.
  506.             DOWNLOAD   Your personal download directory.
  507.             KEYMAPS Your personal key mapping files.
  508.             PHONES Your personal dialing directories.
  509.             SCRIPTS Your personal scripts.
  510.             SSH Your personal SSH host keys.
  511.             TMP Your personal Temporary directory.
  512.             
  513.    To alleviate confusion, Kermit 95 1.1.21 has a new ORIENTATION command
  514.    that gives this information as it applies to your computer. Here's an
  515.    example from Windows XP:
  516.    
  517.   [C:\Documents and Settings\Olga\] K-95> orient
  518.  
  519.   Program name:
  520.     k95
  521.  
  522.   Your home directory:
  523.     Variable:   \v(home)
  524.     Long name:  C:/Documents and Settings/Olga/
  525.     Short name: C:/DOCUME~1/OLGA/
  526.  
  527.   K95's current directory:
  528.     Variable:   \v(directory)
  529.     Long name:  C:/Documents and Settings/Olga/
  530.     Short name: C:/DOCUME~1/OLGA/
  531.  
  532.   K95 Program directory:
  533.     Variable:   \v(exedir)
  534.     Long name:  C:/Program Files/Kermit 95/
  535.     Short name: C:/PROGRAM~/KERMIT~/
  536.  
  537.   K95 Initialization file directory:
  538.     Variable:   \v(inidir)
  539.     Long name:  C:/Documents and Settings/All Users/Application Data/Kermit 95/
  540.     Short name: C:/DOCUME~1/ALLUSE~1/APPLIC~1/KERMIT~1/
  541.  
  542.   Current directory when started:
  543.     Variable:   \v(startup)
  544.     Long name:  C:/tmp/
  545.     Short name: C:/tmp/
  546.  
  547.   K95 data for all users:
  548.     Variable:   \v(common)
  549.     Long name:  C:/Documents and Settings/All Users/Application Data/Kermit 95/
  550.     Short name: C:/DOCUME~1/ALLUSE~1/APPLIC~1/KERMIT~1/
  551.  
  552.   Your personal data directory tree:
  553.     Variable:   \v(personal)
  554.     Long name:  C:/Documents and Settings/Olga/My Documents/
  555.     Short name: C:/DOCUME~1/OLGA/MYDOCU~1/
  556.  
  557.   Your personal K95 data tree:
  558.     Variable:   \v(appdata)
  559.     Long name:  C:/Documents and Settings/Olga/Application Data/Kermit 95/
  560.     Short name: C:/DOCUME~1/OLGA/APPLIC~1/KERMIT~1/
  561.  
  562.   Your K95 download directory:
  563.     Variable:   \v(download)
  564.     Long name:
  565.     Short name:
  566.  
  567.    For script writers, a pair of new functions has been added to convert
  568.    between Windows long and short names:
  569.    
  570.    \flongpathname(path)
  571.           
  572.    Converts the given path (file or directory name) from whatever format
  573.           it's in (short or long) to long format, except in Windows 95
  574.           and NT, which do not have this capability, and therefore simply
  575.           return the path as it was given.
  576.           
  577.    \fshortpathname(path)
  578.           
  579.    Converts the given path to short format.
  580.           
  581.    \flongpathname() (except in Windows 95 and NT) can be used in
  582.    conjunction with \fpathname(), which returns the full pathname of a
  583.    given file in short format, to show the full long path for a given
  584.    file, e.g.:
  585.    
  586.   K95> cd \v(exedir)
  587.   K95> echo \flongpathname(\fpathname(k95.exe))
  588.   C:\Program Files\Kermit 95\k95.exe
  589.   K95>
  590.     ________________________________________________________________________
  591.   
  592.   9.2. Patches and Search Order
  593.   
  594.    Those who patch up to version 1.1.21 from earlier releases will have a
  595.    hybrid structure; the old structure remains as it was, but the new
  596.    structure is created upon first use of the new K95.EXE or Dialer. This
  597.    adds an element of doubt as to where a particular file is or, if there
  598.    are multiple copies, which one is used? The following rules apply:
  599.    
  600.      * The original directory structure is preserved and all your
  601.        customized files are left intact (K95[CUSTOM].INI, DIALUSR.DAT,
  602.        etc) in their original locations.
  603.      * Upon first use of the patched K95 or K95DIAL prorgram:
  604.          1. The \v(common) and \v(appdata) directories are created
  605.             automatically. The \v(common) and \v(appdata) directories are
  606.             each populated with the following empty subdirectories:
  607.             CERTS, CRLS, KEYMAPS, PHONES, SCRIPTS, SSH, and (\v(appdata)
  608.             only) TMP, some of which (KEYMAPS, PHONES, SCRIPTS, and TMP)
  609.             duplicate directories that already exist in your \v(exedir)
  610.             tree. The CERTS, CRLS, and SSH directories are new so there
  611.             should be no confusion about them.
  612.          2. The \v(personal) directory is created if it does not exist
  613.             (except in Windows 95 versions that do not support it) and a
  614.             DOWNLOAD subdirectory is created in it.
  615.      * Kermit searches for its initialization file, K95.INI, in the
  616.        following order:
  617.          1. The global (All Users) Kermit 95 data directory: \v(common).
  618.          2. Program directory: \v(exedir).
  619.      * Your initialization file looks for the site-specific customization
  620.        file, K95SITE.INI, in its \v(common) (All Users) directory and, if
  621.        found, executes it. Note: if K95SITE.INI exists, it should end
  622.        with a TAKE command for the user's customization file,
  623.        \v(appdata)K95CUSTOM.INI. If K95SITE.INI is not found, K95.INI
  624.        searches for the user's customization file, K95CUSTOM.INI, in the
  625.        following order: \v(appdata), \v(inidir), \v(exedir) and, if
  626.        found, executes it.
  627.      * If the K95.INI file was not found, K95 searches for the user's
  628.        customization file anyway, and if found, executes it.
  629.      * After installing the 1.1.21 patch, your DIALUSR.DAT file, which
  630.        contains all the entries you have defined or changed, remains in
  631.        Kermit's program directory \v(exedir).
  632.      * The Dialer searches for your DIALUSR.DAT file in the following
  633.        order:
  634.          1. User-specific Kermit 95 data directory: \v(appdata).
  635.          2. Global (All Users) Kermit 95 data directory: \v(common).
  636.          3. Program directory: \v(exedir).
  637.          4. If no DIALUSR.DAT file is found a new one is created in your
  638.             \v(appdata) directory.
  639.      * Old (pre-patch) scripts remain in \v(exedir)SCRIPTS, but
  640.        post-patch Dialer-generated scripts go in \v(appdata)SCRIPTS. When
  641.        a script is executed with Kermit's TAKE command, and a specific
  642.        path is not given, Kermit searches for the script first in the
  643.        current directory, then in the same order as the customization
  644.        file: \v(appdata) first, \v(exedir) last. For safety and sanity,
  645.        it is better to give a full pathname for script files that are not
  646.        in K95's current directory.
  647.      * Dialing and network directory files are not searched for; you must
  648.        tell Kermit exactly where they are; either in the Dialer entry or
  649.        in the K95SITE.INI or K95CUSTOM.INI file.
  650.      * Each user's SSH-related files generated by Kermit go into the
  651.        user's \v(appdata)SSH directory, which is also where Kermit looks
  652.        for them. Site-wide SSH files can be placed into \v(common)SSH by
  653.        the system administrator.
  654.      * Each user's SSL/TLS-related X.509 certificate files should go into
  655.        \v(appdata)CERTS, which is also where Kermit looks for them.
  656.        Similarly, X.509 Certificate Revocation Lists should go in
  657.        \v(appdata)CRLS. Site-wide certificates and CRLs can be placed in
  658.        \v(common)CERTS and \v(common)CRLS by the system administrator.
  659.        
  660.    If you patch up to version 1.1.21 from an earlier version, it is
  661.    recommended that you convert the old structure to the new one to (a)
  662.    allow multiple user arrangements, (b) reduce confusion arising from
  663.    multiple copies of files and directories, and (c) to prepare for an
  664.    easy transition to K95 2.00. Here's a table summarizing what should be
  665.    moved where, which can be done at your convenience.
  666.    
  667.      File Old New Description
  668.      K95.INI \v(exedir) \v(common) Standard Initialization File
  669.      K95SITE.INI --- \v(common) Site-Wide Customization File
  670.      K95CUSTOM.INI   \v(exedir)    \v(appdata) Per-User Customization
  671.      File
  672.      DIALINF.DAT \v(exedir) \v(common) Built-in Dialer Entries
  673.      DIALORG.DAT \v(exedir) \v(common) Site-Wide Dialer Entries
  674.      DIALUSR.DAT \v(exedir) \v(appdata) Per-User Dialer Entries
  675.      Directory Old New Description
  676.      DOCS \v(exedir) \v(exedir) K95 Documentation
  677.      DOWNLOAD \v(exedir) \v(personal) Download Directory
  678.      ICONS \v(exedir) \v(exedir) Icons
  679.      INCOMING \v(exedir) \v(common) Host Mode Upload Directory (2)
  680.      KEYMAPS \v(exedir) \v(common) or \v(appdata)   Key maps and info
  681.      (1)
  682.      PHONES \v(exedir) \v(common) or \v(appdata) Dialing and Network
  683.      Directories (1)
  684.      PRINTER \v(exedir) \v(common) Printer Utilties and Info
  685.      PUBLIC \v(exedir) \v(common) Host Mode Public Directory (2)
  686.      SCRIPTS \v(exedir) \v(common) or \v(appdata) Kermit Scripts (1)
  687.      TMP \v(exedir) \v(appdata) Directory for Temporary Files
  688.      USERS \v(exedir) \v(common) Root of Host Mode User Tree (2)
  689.      
  690.    Notes:
  691.     1. In entries that give "\v(common) or \v(appdata)" as new location
  692.        choices, pick the destination for each file according to whether
  693.        it's for all users or only for you.
  694.     2. Host Mode should be considered obsolescent, replaceable by WIKSD,
  695.        at least in Windows NT, 2000, and XP.
  696.        
  697.    HINT: Entire directories and directory trees can be moved with the
  698.    MOVE command in the Windows Command Prompt or CMD window, provided you
  699.    have shut down any applications that might be using any of the
  700.    affected directories or files. Example:
  701.    
  702.   C:\> cd \k95
  703.   C:\K95\> move phones "\C:\Documents and Settings\Olga\Application Data\Kermit
  704.  95\Phones"
  705.     ________________________________________________________________________
  706.   
  707.   9.3. Important K95 Files
  708.   
  709.   9.3.1. [84]In the Program Directory
  710.   9.3.2. [85]In the All Users Kermit 95 Directory
  711.   9.3.3. [86]In Each User's My Documents Directory
  712.   9.3.4. [87]In Each User's K95 Application Data Directory
  713.  
  714.   9.3.1. In the Program Directory
  715.   
  716.    In multiuser Windows installation, this directory should be writeable
  717.    only by the system administrator.
  718.    
  719.    SETUP.EXE
  720.           The Kermit 95 setup (installation) program. This is the old
  721.           text-based one, which is being phased out in favor a GUI
  722.           InstallShield procedure (Windows only). It is not yet clear at
  723.           this writing whether version 1.1.21 will be packaged for
  724.           retail, or only downloadable as a patch; it depends on when
  725.           2.00 is released. If it is packaged for retail, it will have
  726.           the GUI installation rather than the text one (except if OS/2
  727.           is still supported it will still have the text-based
  728.           installation program).
  729.           
  730.    K95DIAL.EXE
  731.           The Kermit 95 Dialer. This is the GUI program that gives you
  732.           point-and-click access to all your connections. It is normally
  733.           found in the Program Files Kermit 95 directory. Depending on
  734.           your selections at install time, you might have a desktop icon
  735.           and/or Start menu entry for this, as well as for K95.EXE (next
  736.           item). Location: Program Directory.
  737.           
  738.    K95.EXE
  739.           The Kermit 95 program. You can run this directly to bypass the
  740.           Dialer (normally only Kermit veterans would do this). In
  741.           version 1.1.21 and earlier, this is the console version of K95.
  742.           
  743.    K95G.EXE
  744.           The GUI version of the Kermit 95 program (for future
  745.           reference).
  746.           
  747.    K95C.EXE
  748.           The Console version of the Kermit 95 program (for future
  749.           reference). It is expected that starting with version 2.00, the
  750.           Windows version of K95 will be offered in both GUI and Console
  751.           versions, and at install time the user will choose which one to
  752.           use by default; i.e. which one will be copied to K95.EXE.
  753.           
  754.    K95D.EXE
  755.           An Internet Listener for incoming Host Mode connections.
  756.           
  757.    K95D.CFG
  758.           The configuration file for K95D.EXE.
  759.           
  760.    DIALER.DAT
  761.           Dialer screen definitions. Note: All *.DAT and *.ZNC files, as
  762.           well as *.BKn files, are associated with the Dialer.
  763.           
  764.    PATCHDOS.EXE
  765.           The DOS (portable) version of the RT Patch, the program used to
  766.           install patches to Kermit 95.
  767.           
  768.    TELNET.EXE
  769.           A "stub" that lets you use Kermit 95 as though its name and
  770.           command-line personality were those of Telnet.
  771.           
  772.    RLOGIN.EXE
  773.           A "stub" that lets you use Kermit 95 as though its name and
  774.           command-line personality were those of Rlogin.
  775.           
  776.    SSH-AGENT.EXE
  777.           The SSH Agent program (explained in the [88]SSH Client
  778.           documentation.
  779.           
  780.    HOSTMODE.BAT
  781.           Run this to start the host-mode management program.
  782.           
  783.    The Program Directory also includes the following subdirectories:
  784.    
  785.    DOCS
  786.           Supplemental documentation on various topics.
  787.           
  788.    DOCS\MANUAL
  789.           (under the Kermit 95 Program directory) The [89]Kermit 95
  790.           Manual, to be accessed with your Web browser. This is done most
  791.           conveniently from the Dialer's Help menu. This directory also
  792.           contains the [90]Using C-Kermit PDF file (shrinkwrapped Kermit
  793.           95 versions only) and the [91]C-Kermit 7.0 Update Notes, the
  794.           [92]C-Kermit 8.0 Update Notes, and the [93]Kermit 95 Bug List.
  795.           
  796.    ICONS
  797.           Icons for use with K95 data files such as scripts.
  798.     ________________________________________________________________________
  799.   
  800.   9.3.2. In the All Users Kermit 95 Directory
  801.   
  802.    In multiuser Windows installation, this directory should be writeable
  803.    only by the system administrator.
  804.    
  805.    K95.INI
  806.           Initialization file for K95.EXE, normally found in the All
  807.           Users directory for Kermit 95, but in patched versions is
  808.           likely to be in the Program Directory. Contains commands that
  809.           are to be executed every time K95.EXE is started. See Using
  810.           C-Kermit for more about initialization files. In Kermit 95,
  811.           however, most of the traditional functions of initialization
  812.           files are taken over by the Dialer. In any case, you should not
  813.           change or delete this file; all customizations should be made
  814.           in:
  815.           
  816.    K95SITE.INI
  817.           Site-specific customizations. If this file exists, it is
  818.           executed by the standard K95.INI file and, in turn, it executes
  819.           the user's customization file, K95CUSTOM.INI. If this file does
  820.           not exist, the user's customization file is executed directly.
  821.           As shipped, Kermit 95 includes a skeleton version of this file
  822.           that simply prints a message and executes the user's
  823.           customization file.
  824.           
  825.    CA_CERTS.PEM
  826.           Site-wide OpenSSL X.509 Certificate Authority certificates.
  827.           
  828.    DIALINF.DAT
  829.           The Kermit 95 Dialer preloaded database (read-only).
  830.           
  831.    DIALORG.DAT
  832.           This file is not shipped from the factory. If you wish to have
  833.           organization/site-wide Dialer entries, they can be created by
  834.           adding new entries to the Dialer and then renaming the
  835.           resulting DIALUSR.DAT file to DIALORG.DAT, from which point it
  836.           is read-only.
  837.           
  838.    The All Users K95 directory also contains the subdirectories listed in
  839.    the previous section. Of particular interest are:
  840.    
  841.    PHONES
  842.           Dialing and network directories for use by everybody at the
  843.           site.
  844.           
  845.    SCRIPTS
  846.           Kermit scripts for use by everybody at the site.
  847.           
  848.    PRINTER
  849.           Printer-related utilities, e.g. shell scripts for Unix to send
  850.           Unix files to your PC printer via K95's Pass-Through Printing
  851.           feature.
  852.           
  853.    KEYMAPS
  854.           Sample and default key maps for reference and/or copying and
  855.           modification to suit your needs and preferences.
  856.           
  857.    Files in the KEYMAPS directory include:
  858.    
  859.    CTRL2CAP.*
  860.           A utility for Win9x/ME for swapping the Ctrl and Caps Lock
  861.           keys, and optionally the Esc and `/~ keys.
  862.           
  863.    KEYCODES.TXT
  864.           A reference listing of K95 and MS-DOS Kermit keycodes (plain
  865.           text, wide).
  866.           
  867.    DEFAULT.KSC
  868.           A listing of K95's default Key mappings for each of its
  869.           terminal types.
  870.           
  871.    EMACS.KSC
  872.           A sample key map for use with the EMACS fullscreen text editor
  873.           on the host.
  874.           
  875.    SNI.KSC
  876.           A sample key map for Siemens-Nixdorf 97801 terminal emulation.
  877.           
  878.    VT220.KSC
  879.           A sample key map for Digital Equipment Corporation VT220
  880.           terminal emulation.
  881.     ________________________________________________________________________
  882.   
  883.   9.3.3. In Each User's My Documents Directory
  884.   
  885.    This directory is for keeping data files that are not necessarily
  886.    associated with a particular application. This is where K95's DOWNLOAD
  887.    directory goes, since the files you download with Kermit might be for
  888.    any application at all. For this reason, your My Documents directory
  889.    can also contain other material, unrelated to K95.
  890.    
  891.    In Windows 95, the user's My Documents directory does not necessarily
  892.    exist, since it is not part of the standard Windows 95 directory
  893.    layout (it was first added in Windows 98). But it still might have
  894.    been created by a Microsoft Office component, Internet Explorer, or
  895.    some other Microsoft application. If it does exist, and it does not
  896.    already have a DOWNLOAD subdirectory, K95 installation creates one. If
  897.    it does not exist, no DOWNLOAD directory is created.
  898.    
  899.    Note that the \v(download) variable does not necessarily denote
  900.    Kermit's download directory. Initially, this variable has no value. It
  901.    takes on a value only when you have designated a download directory,
  902.    either on the General page of a Dialer entry, or with Kermit's SET
  903.    FILE DOWNLOAD-DIRECTORY command. The \v(personal)DOWNLOAD directory is
  904.    an obvious choice, but you can designate any directory you like for
  905.    this purpose, or none at all, in which case downloaded files go into
  906.    K95's current directory, in the absence of explicit instructions to
  907.    the contrary.
  908.    
  909.    If you want K95 to save downloaded files in its current directory by
  910.    default, leave its out-of-the-box configuration alone. If you want it
  911.    to save all downloaded files in one specific directory by default,
  912.    then do this in the Dialer, or [94]edit your K95CUSTOM.INI file to
  913.    include a SET FILE DOWNLOAD-DIRECTORY command.
  914.     ________________________________________________________________________
  915.   
  916.   9.3.4. In Each User's K95 Application Data Directory
  917.   
  918.    In multiuser Windows installation, each Kermit 95 user automatically
  919.    gets her/his own K95 application data directory upon first use of K95
  920.    1.1.21 or later. This directory tree allows full read/write access to
  921.    its owner.
  922.    
  923.    K95CUSTOM.INI
  924.           Customization file for K95.EXE, normally found in the
  925.           user-specific data directory for Kermit 95 (\v(appdata)), or in
  926.           patched versions in the Program Directory (\v(exedir)). On
  927.           multiuser file systems, each user should have her/his own copy
  928.           of this file. You may edit your copy to change your
  929.           customizations, add new ones, define macros, special keys, and
  930.           so on. In newly installed copies of K95 1.1.21, a sample copy
  931.           of this file is copied from the \v(common) directory to the
  932.           user's \v(appdata) directory the first time the user starts
  933.           K95. The customization file is never modifed by Patch or
  934.           InstallShield.
  935.           
  936.    DIALUSR.DAT
  937.           Your personal Dialer database (read/write). The K95 Dialer
  938.           creates this file for you the first time you add, clone, or
  939.           change an entry.
  940.           
  941.    Your Personal K95 Read/Write Subdirectories:
  942.           CERTS (X.509 certificates for SSL/TLS), CRLS (X.509 certificate
  943.           revocation lists for SSL/TLS), KEYMAPS (key mapping files),
  944.           PHONES (dialing and network directories), SCRIPTS (scripts),
  945.           SSH (SSH host keys), TMP (temporary directory). These are
  946.           initially empty. Some of them are used by K95; for example to
  947.           when adding SSH host keys when you make a connection to a new
  948.           host. Others are for your own use; for example, for installing
  949.           X.509 certificates for hosts that you visit, personalized key
  950.           maps, your own scripts, etc.
  951.      _________________________________________________________________
  952.    
  953.    10. ORIENTATION AND NAVIGATION
  954.   10.1. [95]K95's Initial Directory
  955.   10.2. [96]K95's CD Command
  956.   10.3. [97]Where Is My Customization File?
  957.   10.4. [98]Where is the File I Just Downloaded?
  958.   10.5. [99]Structure of .INI Files
  959.  
  960.    The new directory structure, although necessary for all the reasons
  961.    listed above, can bewilder even seasoned K95 users. Here we try to
  962.    clarify some confusing points, primarily for those who use K95
  963.    directly at its command prompt.
  964.    
  965.   10.1. K95's Initial Directory
  966.   
  967.    Kermit 95's current directory when you first start it depends on how
  968.    you started it, which initialization files it executed, and whether an
  969.    environment variable named HOME is defined to be a valid directory
  970.    name.
  971.    
  972.      * If you start K95 from a command window, it inherits its initial
  973.        directory from the command window's current directory.
  974.      * If you start K95 from the Dialer, its initial directory is your
  975.        home directory, which in turn is the value of the built-in Kermit
  976.        variable, \v(home), unless the Dialer entry includes a login
  977.        script that CD's somewhere else. \v(home) inherits the value of
  978.        the environment variable HOME, if it is defined, otherwise it is
  979.        the root of your user tree, e.g.:
  980.  
  981.   C:\Documents and Settings\Olga\
  982.      * If you start K95 from the Start menu, its initial directory is its
  983.        program directory.
  984.      * If you start K95 from a desktop shortcut, its initial directory is
  985.        K95's program directory, unless you have changed the properties of
  986.        the shortcut to specify a "Start in" directory.
  987.      * If you make a connection to WIKSD from outside and log in as
  988.        yourself, WIKSD's initial directory is the one specified in your
  989.        Windows user profile, if any, otherwise \WINDOWS\SYSTEM32\.
  990.      * If you make an anonymous connection to WIKSD, its initial
  991.        directory is whatever the system administrator configured for
  992.        anonymous users.
  993.        
  994.    Any of these can be changed by the initialization file sequence,
  995.    except when starting from the Dialer since, in that case, the
  996.    instructions emitted by the Dialer are executed after the
  997.    initialization files.
  998.     ________________________________________________________________________
  999.   
  1000.   10.2. K95's CD Command
  1001.   
  1002.    When Kermit 95 is installed the new way described in the [100]previous
  1003.    section, the CD command can be confusing. Here are a few tips that
  1004.    might help:
  1005.    
  1006.      * The CD command, when given with no operand, returns K95 to its
  1007.        \v(home) directory. If you don't like how \v(home) is defined, you
  1008.        can always override it by defining a HOME environment variable
  1009.        with the desired value. This is done in Control Panel . . System .
  1010.        . Advanced . . Environment Variables in newer Windows versions, or
  1011.        by adding SET commands to C:\AUTOEXEC.BAT in older ones.
  1012.      * Remember that in K95 commands, directory or pathnames that contain
  1013.        spaces must be enclosed in quotes or braces, e.g.:
  1014.  
  1015.   K-95> cd "c:/Documents and Settings/Olga/My Documents/"
  1016.      * Since it is difficult and annoying to type such long pathnames,
  1017.        you can use the K95 variables shown in the ORIENTATION command
  1018.        (example in previous section), for example:
  1019.  
  1020.   K-95> cd \v(personal)               ; My personal Windows data tree
  1021.   K-95> cd \v(appdata)                ; My personal K95 data tree
  1022.   K-95> cd \v(common)                 ; K95 data tree for all users
  1023.   K-95> cd \v(exedir)                 ; Directory where K95.EXE is started from
  1024.   K-95> cd \v(download)               ; My personal K95 download directory
  1025.   K-95> cd \v(tmpdir)                 ; My personal directory for temporary fil
  1026. es
  1027.      * You can also refer to Windows environment variables in the CD or
  1028.        any other command, as in the these examples:
  1029.  
  1030.   K-95> cd \$(HOMEDRIVE)\$(HOMEPATH)  ; My Windows HOMEPATH
  1031.   K-95> cd \$(ALLUSERSPROFILE)        ; Windows All Users
  1032.   K-95> cd \$(CommonProgramFiles)     ; Common Program Files
  1033.   K-95> cd \$(TEMP)                   ; Personal temporary directory
  1034.   K-95> cd \$(USERPROFILE)            ; Personal Windows data tree
  1035.        You can get a listing of Windows environment variables by typing
  1036.        SET in a CMD or Command Prompt or other shell window.
  1037.      * You can define macros that take you to commonly visited
  1038.        directories:
  1039.  
  1040.   K-95> define appdata cd \v(appdata)
  1041.   K-95> appdata
  1042.      * You can take advantage of the SET CD PATH command, which lets you
  1043.        type just the rightmost path segments in your CD commands.
  1044.        Example:
  1045.  
  1046.   K-95> set cd path \v(appdata);\v(personal) ; With this in effect...
  1047.   K-95> cd download                          ; This works from anywhere
  1048.      * Remember you can use ? for file/directory lists and Tab or Esc for
  1049.        completion anywhere within a path, which can save you some
  1050.        head-scratching and/or typing:
  1051.  
  1052.   K-95> cd /
  1053.   K-95> cd "Doc<Tab>uments and Settings/"Olga/App<Tab>ication Data/"...
  1054.        Actually it's a bit more complicated than shown because of the
  1055.        doublequotes; at each step you have to delete the closing
  1056.        doublequote before proceeding to the next path segment, but you'll
  1057.        get the hang of it quickly enough.
  1058.      * Remember that K95 has a BACK command that returns you to its
  1059.        previous directory.
  1060.      * There is also a new CDUP command that changes to the current
  1061.        directory's superior directory (if any).
  1062.        
  1063.    You can get additional information about CD, BACK, CDUP, SET CD, or
  1064.    any other command, by giving a HELP command for it at the K-95>
  1065.    prompt, e.g. "help set cd".
  1066.     ________________________________________________________________________
  1067.   
  1068.   10.3. Where Is My Customization File?
  1069.   
  1070.    K95 1.1.21 (and later), when installed from scratch, looks for your
  1071.    K95CUSTOM.INI file in your \v(appdata) directory. If it does not find
  1072.    it there, it looks in K95's program directory, \v(exedir). In the old
  1073.    days, when we said "edit your customization file", this generally
  1074.    meant something simple like:
  1075.    
  1076.   K-95> edit c:/k95/k95custom.ini
  1077.  
  1078.    Now it means something like this:
  1079.    
  1080.   K-95> edit "C:/Documents and Settings/Olga/Application Data/Kermit 95/k95cust
  1081. om.ini"
  1082.  
  1083.    But who wants to type all that? Instead you can use this:
  1084.    
  1085.   K-95> edit \v(appdata)k95custom.ini
  1086.  
  1087.    Of course if that's not where it really is you might need something
  1088.    more elaborate, like this:
  1089.    
  1090.   if exist \v(appdata)k95custom.ini edit \v(appdata)k95custom.ini
  1091.   else if exist \v(exedir)k95custom.ini edit \v(exedir)k95custom.ini
  1092.   else echo "Where is it?"
  1093.  
  1094.    HINT: If you installed K95 1.1.21 from patches and fear that you might
  1095.    have multiple K95CUSTOM.INI files lurking in various directories, of
  1096.    course you can find them all with Windows Search or Find. Then edit
  1097.    each one to include a line like this:
  1098.    
  1099.   echo EXECUTING \v(user)'s \flongpathname(\fpathname(\v(cmdfile)))...
  1100.  
  1101.    Then when K95 starts, this line prints the full pathname of the
  1102.    customization file that was actually executed.
  1103.     ________________________________________________________________________
  1104.   
  1105.   10.4. Structure of .INI Files
  1106.   
  1107.    In K95 1.1.21 and later, which can run remotely in its WIKSD guise,
  1108.    adds a new complication to construction of K95's .INI files because
  1109.    certain K95 commands are not legal in WIKSD. These include:
  1110.    
  1111.      * Any commands that set up or make connections.
  1112.      * Any commands having to do with terminal emulation or key mapping.
  1113.      * Any commands related to printers.
  1114.      * Any commands that access subprocesses or external programs.
  1115.      * Probably some others too...
  1116.        
  1117.    Yet if you log in through WIKSD using your own Windows ID, then your
  1118.    own K95CUSTOM.INI file -- which is likely to contain many such
  1119.    commands -- is executed. If you are going to be accessing the same
  1120.    computer from its physical keyboard and screen (or facsimile thereof)
  1121.    and remotely via WIKSD, your K95CUSTOM.INI file should separate the
  1122.    commonly valid commands from the ones that can only be executed by
  1123.    K95.EXE and not by WIKSD. It's easy. Just put the common commands at
  1124.    the top, then:
  1125.    
  1126.   if iksd end 0 IKSD Setup Complete.
  1127.  
  1128.    And then the rest of your K95 customizations. If you do not protect
  1129.    commands like SET TERMINAL, SET KEY, and so on, by IF [ NOT ] IKSD,
  1130.    you'll get tons of error messages when you log in to WIKSD. The same
  1131.    guidelines should be followed by the system administrator when setting
  1132.    up the K95.INI and K95SITE.INI files. The K95*.INI files that we
  1133.    distribute with version 1.1.21 have this structure already, but if you
  1134.    install 1.1.21 by patching, your old .INI files are preserved.
  1135.     ________________________________________________________________________
  1136.   
  1137.   10.5. Where is the File I Just Downloaded?
  1138.   
  1139.    Rather than try to enumerate the rules and their relative precedence,
  1140.    let's just say how to get this information during the transfer and
  1141.    after the transfer:
  1142.    
  1143.      * While the transfer is in progress, the full path of the downloaded
  1144.        file should be visible on your screen in the file-transfer
  1145.        display.
  1146.      * When the transfer is complete, the file-transfer display should
  1147.        still be visible in the Command screen (you might have to Alt-x
  1148.        back from the Terminal screen to see it). And of course you can
  1149.        always scroll back to it with the Page Up key.
  1150.      * At the K-95> prompt, type the WHERE command, which tells you where
  1151.        your files went.
  1152.        
  1153.    [ [101]Top ] [ [102]Contents ] [ [103]K95 Manual ]
  1154.      _________________________________________________________________
  1155.    
  1156.    
  1157.     Kermit 95 README / Version 1.1.21 / 2 April 2002
  1158.  
  1159. References
  1160.  
  1161.    Visible links:
  1162.    1. http://www.columbia.edu/kermit/k95readme.htm#x1
  1163.    2. http://www.columbia.edu/kermit/k95readme.htm#x2
  1164.    3. http://www.columbia.edu/kermit/k95readme.htm#x3
  1165.    4. http://www.columbia.edu/kermit/k95readme.htm#x4
  1166.    5. http://www.columbia.edu/kermit/k95readme.htm#x5
  1167.    6. http://www.columbia.edu/kermit/k95readme.htm#x6
  1168.    7. http://www.columbia.edu/kermit/k95readme.htm#x7
  1169.    8. http://www.columbia.edu/kermit/k95readme.htm#x8
  1170.    9. http://www.columbia.edu/kermit/x9
  1171.   10. http://www.columbia.edu/kermit/k95readme.htm#x9.1
  1172.   11. http://www.columbia.edu/kermit/k95readme.htm#x9.2
  1173.   12. http://www.columbia.edu/kermit/k95readme.htm#x9.3
  1174.   13. http://www.columbia.edu/kermit/k95readme.htm#x10
  1175.   14. http://www.columbia.edu/kermit/k95readme.htm#x10.1
  1176.   15. http://www.columbia.edu/kermit/k95readme.htm#x10.2
  1177.   16. http://www.columbia.edu/kermit/k95readme.htm#x10.3
  1178.   17. http://www.columbia.edu/kermit/k95readme.htm#x10.4
  1179.   18. http://www.columbia.edu/kermit/k95readme.htm#x10.5
  1180.   19. http://www.columbia.edu/kermit/gloss.htm#g_html
  1181.   20. http://www.columbia.edu/kermit/ckermit.html
  1182.   21. http://www.columbia.edu/kermit/ck60manual.html
  1183.   22. http://www.columbia.edu/kermit/k95readme.htm#register
  1184.   23. http://www.amazon.com/exec/obidos/redirect?tag=kermit95-20&path=ISBN=1555581641/6584-5665863-047434
  1185.   24. http://www.columbia.edu/kermit/manuals.html
  1186.   25. http://www.columbia.edu/kermit/k95readme.htm#top
  1187.   26. http://www.columbia.edu/kermit/k95readme.htm#contents
  1188.   27. http://www.columbia.edu/kermit/kermit95.htm
  1189.   28. http://www.columbia.edu/kermit/sshclien.htm
  1190.   29. http://www.columbia.edu/kermit/ckermi80.htm#x3
  1191.   30. http://www.columbia.edu/kermit/ckermi80.htm#x2.2
  1192.   31. http://www.columbia.edu/kermit/wiksd.htm
  1193.   32. http://www.columbia.edu/kermit/k95readme.htm#files
  1194.   33. http://www.columbia.edu/kermit/newdial.htm
  1195.   34. http://www.columbia.edu/kermit/ckermit.html
  1196.   35. http://www.columbia.edu/kermit/k95next.html
  1197.   36. http://www.columbia.edu/kermit/k95readme.htm#top
  1198.   37. http://www.columbia.edu/kermit/k95readme.htm#contents
  1199.   38. http://www.columbia.edu/kermit/kermit95.htm
  1200.   39. http://www.columbia.edu/kermit/k95readme.htm#top
  1201.   40. http://www.columbia.edu/kermit/k95readme.htm#contents
  1202.   41. http://www.columbia.edu/kermit/kermit95.htm
  1203.   42. http://www.kermit-project.org/k95patch.html#crypto
  1204.   43. http://www.columbia.edu/kermit/security.htm
  1205.   44. http://www.columbia.edu/kermit/k95readme.htm#top
  1206.   45. http://www.columbia.edu/kermit/k95readme.htm#contents
  1207.   46. http://www.columbia.edu/kermit/kermit95.htm
  1208.   47. http://www.installshield.com/
  1209.   48. http://www.columbia.edu/kermit/k95ins.htm
  1210.   49. http://www.columbia.edu/kermit/k95readme.htm#top
  1211.   50. http://www.columbia.edu/kermit/k95readme.htm#contents
  1212.   51. http://www.columbia.edu/kermit/kermit95.htm
  1213.   52. http://www.columbia.edu/kermit/k95readme.htm#files
  1214.   53. http://www.columbia.edu/kermit/k95readme.htm#top
  1215.   54. http://www.columbia.edu/kermit/k95readme.htm#contents
  1216.   55. http://www.columbia.edu/kermit/kermit95.htm
  1217.   56. http://www.columbia.edu/kermit/k95readme.htm#resources
  1218.   57. http://www.columbia.edu/kermit/k95readme.htm#top
  1219.   58. http://www.columbia.edu/kermit/k95readme.htm#contents
  1220.   59. http://www.columbia.edu/kermit/kermit95.htm
  1221.   60. http://www.columbia.edu/kermit/uck2epdf.htm
  1222.   61. http://www.columbia.edu/kermit/ck60manual.html
  1223.   62. http://www.columbia.edu/kermit/ckermi70.htm
  1224.   63. http://www.columbia.edu/kermit/ckermi80.htm
  1225.   64. http://www.columbia.edu/kermit/k95faq.htm
  1226.   65. http://www.columbia.edu/kermit/k95bugs.htm
  1227.   66. http://www.columbia.edu/kermit/security.htm
  1228.   67. http://www.columbia.edu/kermit/
  1229.   68. ftp://kermit.columbia.edu/kermit/k95/newbugs.txt
  1230.   69. http://www.columbia.edu/kermit/k95.html
  1231.   70. http://www.columbia.edu/kermit/k95pricing.html
  1232.   71. http://www.columbia.edu/kermit/k95next.html
  1233.   72. http://www.columbia.edu/kermit/ckermit.html
  1234.   73. http://www.columbia.edu/kermit/support.html
  1235.   74. http://www.columbia.edu/kermit/scriptlib.html
  1236.   75. news:comp.protocols.kermit.announce
  1237.   76. news:comp.protocols.kermit.misc
  1238.   77. http://www.columbia.edu/kermit/k95readme.htm#top
  1239.   78. http://www.columbia.edu/kermit/k95readme.htm#contents
  1240.   79. http://www.columbia.edu/kermit/kermit95.htm
  1241.   80. http://www.columbia.edu/kermit/k95readme.htm#x9.1
  1242.   81. http://www.columbia.edu/kermit/k95readme.htm#x9.2
  1243.   82. http://www.columbia.edu/kermit/k95readme.htm#x9.3
  1244.   83. http://www.columbia.edu/kermit/k95readme.htm#x10.3
  1245.   84. http://www.columbia.edu/kermit/k95readme.htm#x9.3.1
  1246.   85. http://www.columbia.edu/kermit/k95readme.htm#x9.3.2
  1247.   86. http://www.columbia.edu/kermit/k95readme.htm#x9.3.3
  1248.   87. http://www.columbia.edu/kermit/k95readme.htm#x9.3.4
  1249.   88. http://www.columbia.edu/kermit/sshclien.htm
  1250.   89. http://www.columbia.edu/kermit/kermit95.htm
  1251.   90. http://www.columbia.edu/kermit/uck2epdf.htm
  1252.   91. http://www.columbia.edu/kermit/ckermi70.htm
  1253.   92. http://www.columbia.edu/kermit/ckermi80.htm
  1254.   93. http://www.columbia.edu/kermit/k95bugs.htm
  1255.   94. http://www.columbia.edu/kermit/k95readme.htm#x10.3
  1256.   95. http://www.columbia.edu/kermit/k95readme.htm#x10.1
  1257.   96. http://www.columbia.edu/kermit/k95readme.htm#x10.2
  1258.   97. http://www.columbia.edu/kermit/k95readme.htm#x10.3
  1259.   98. http://www.columbia.edu/kermit/k95readme.htm#x10.4
  1260.   99. http://www.columbia.edu/kermit/k95readme.htm#x10.5
  1261.  100. http://www.columbia.edu/kermit/k95readme.htm#files
  1262.  101. http://www.columbia.edu/kermit/k95readme.htm#top
  1263.  102. http://www.columbia.edu/kermit/k95readme.htm#contents
  1264.  103. http://www.columbia.edu/kermit/kermit95.htm
  1265.  
  1266.    Hidden links:
  1267.  104. http://www.columbia.edu/kermit/k95readme.htm#files
  1268.