home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / k95 / README_1120.TXT < prev    next >
Text File  |  2020-01-01  |  21KB  |  499 lines
  1. WELCOME TO KERMIT 95 VERSION 1.1.20
  2.  
  3.   31 March 2000
  4.  
  5. Easy-to-use and powerful 32-bit communications software for Microsoft
  6. Windows 95, Windows 98, Windows NT 3.51 and later, and Windows 2000, and
  7. for IBM OS/2 3.0 and later. Please remember: this is licensed software,
  8. not to be redistributed in any form without license to do so, nor made
  9. available to unlicensed persons for copying by any means (including but
  10. not limited to network copying).
  11.  
  12.   Copyright (C) 1995, 2000, the Trustees of Columbia University in
  13.   the City of New York, all rights reserved.
  14.  
  15.   Portions Copyright (C) 1990, Massachusetts Institute of Technology.
  16.   Portions Copyright (C) 1991, 1993 Regents of the University of California.
  17.   Portions Copyright (C) 1991, 1992, 1993, 1994, 1995 by AT&T.
  18.   Portions Copyright (C) 1995, Oy Online Solutions Ltd., Jyvaskyla, Finland.
  19.   Portions Copyright (C) 1995, 1997, Eric Young <eay@cryptosoft.com>.
  20.   Portions Copyright (C) 1997, Stanford University.
  21.   (See Updates to Using C-Kermit, 2nd Edition, Appendix V, for full text.)
  22.  
  23. CONTENTS
  24.  
  25.    * WHAT'S WHAT
  26.    * SYSTEM REQUIREMENTS
  27.    * SECURITY AND ENCRYPTION
  28.    * REGISTRATION
  29.    * UNINSTALLING KERMIT 95
  30.    * RESOURCES
  31.    * FILES
  32.    * SUBDIRECTORIES
  33.    * HELPFUL HINTS
  34.    * SERVER INSTALLATION
  35.  
  36. ------------------------------------------------------------------------
  37. WHAT'S WHAT
  38.  
  39. This is version 1.1.20 of Kermit 95 -- the twentieth update since the
  40. original release in September 1995. You might have received this version as
  41. an update patch to a previous version, or you might have received it as
  42. part of a bulk or site license, or you might have purchased it new in its
  43. box. The box includes:
  44.  
  45. The Kermit 95 Software
  46.      The CDROM includes Kermit 95 for Windows 95, 98, NT, and 2000, and
  47.      for IBM OS/2. The NT version is provided for both Intel and Alpha
  48.      architectures. The appropriate version is installed for you
  49.      automatically.
  50.  
  51. The Kermit 95 Manual
  52.      The new Fourth Edition of the online Kermit 95 manual is completely up
  53.      to date with version 1.1.20. It is in HyperText Markup Language (HTML)
  54.      format so you can navigate it with your Web browser. This manual
  55.      concentrates on the unique aspects of Kermit 95, primarily its
  56.      terminal emulator and its interface to Windows (or OS/2).
  57.  
  58. The C-Kermit 7.0 CDROM
  59.      C-Kermit 7.0 is Kermit 95's file-transfer and client/server partner
  60.      for UNIX (Linux, Solaris, AIX, HP-UX, etc), VMS, VOS, and many other
  61.      operating systems.  It is not part of Kermit 95; it has been
  62.      included to ensure that you have an up-to-date, high-performance,
  63.      supported Kermit file transfer partner on the UNIX, VMS, or VOS
  64.      systems that you connect to with Kermit 95.
  65.  
  66. The C-Kermit Manual
  67.      The book, Using C-Kermit, is the technical reference manual for the
  68.      Command Window and script programming language, as well as for file
  69.      transfer, and also contains useful tutorials on character sets, data
  70.      communications and troubleshooting of dialing and connection
  71.      problems.  It is also the user manual for C-Kermit itself, which has
  72.      the same command and scripting language as Kermit 95.  The second
  73.      edition of Using C-Kermit was published concurrently with the
  74.      release of C-Kermit 6.0 and Kermit 95 1.1.8; updates for C-Kermit 7.0 
  75.      (which corresponds to Kermit 95 1.1.20) are included with the K95
  76.      manual.  Beginning with Kermit 95 1.1.20, Using C-Kermit is provided
  77.      in online PDF format rather than in printed form in shrinkwrap packages
  78.      only.
  79.  
  80. Your Serial Number Stickers and Registration Card
  81.      Explained below.
  82.  
  83. If you have Kermit 95 as part of a bulk or site license, then you received
  84. only the Kermit 95 software and online documentation, preregistered and
  85. possibly customized for your site.  Copies of Using C-Kermit (ISBN
  86. 1-55558-164-1) should be available at your organization's library or
  87. software licensing office, and can also be ordered separately or purchased
  88. book or computer stores.
  89.  
  90. ------------------------------------------------------------------------
  91. SYSTEM REQUIREMENTS
  92.  
  93.    * A computer running Microsoft Windows 95, 98, NT 3.51 or later,
  94.      or Windows 2000, or IBM OS/2 3.0 or later.
  95.    * A serial port and/or modem, and/or a network connection.
  96.    * For Windows NT, both Intel and Alpha architectures are supported.
  97.    * Windows NT 3.50 and earlier are not supported.
  98.    * Windows CE is not supported.
  99.  
  100. Windows 95/98, Windows NT/2000, and OS/2 are demand-paged virtual memory
  101. operating systems, and so the time-honored question, "How much RAM is
  102. required?" does not strictly apply to Kermit 95. In general, 6-8 megabytes
  103. of address space are used, of which about 1MB comprises the working set
  104. (i.e. the set of 4K "pages" that need to be in memory at the same time);
  105. the rest are paged to disk and tend to stay there. These memory
  106. requirements include not just Kermit 95 itself, but also all the DLLs that
  107. must be loaded in order for K95 to use TAPI, the TCP/IP stack, Kerberos,
  108. and other system services, which themselves are shared with other
  109. applications.
  110.  
  111. Pure code pages are shared among multiple invocations of K95.EXE and the
  112. DLLs it uses; thus you can have multiple simultaneous sessions with
  113. relatively small increments in overhead.
  114.  
  115. Kermit 95's total disk footprint after installation is about 30MB, of
  116. which about 20MB is the Using C-Kermit PDF file.  Approximately one
  117. additional megabyte is needed when the Dialer is active, for backup and
  118. temporary files, depending on the size of your Dialer database.
  119.  
  120. ------------------------------------------------------------------------
  121. SECURITY AND ENCRYPTION
  122.  
  123. Kermit 95 is capable of making secure, authenticated, encrypted
  124. Internet connections using a variety of methods. Under USA law,
  125. however, software that utilizes strong encryption as found in Kermit
  126. 95 cannot be distributed in binary form without a license to
  127. non-U.S. or Canadian citizens.  Patches that provide support
  128. for encrypted sessions using Kerberos, Secure Remote Password,
  129. and X.509 certificates for authentication are available from the
  130. web site:
  131.  
  132.   http://www.kermit-project.org/k95patch.html#crypto
  133.  
  134. See the Kermit 95 Online Manual's Network Security Methods Reference
  135. for further information on Authentication and Encryption methods
  136. supported by Kermit 95.
  137.  
  138. ------------------------------------------------------------------------
  139. REGISTRATION
  140.  
  141. If you have a site- or bulk-licensed version of Kermit 95, or if you are
  142. upgrading from an earlier version by applying a patch, then your copy of
  143. Kermit 95 is already registered, in which case please ignore this section.
  144.  
  145. Kermit 95 comes with two serial-number stickers. The serial number on each
  146. sticker should be the same.
  147.  
  148. The SETUP program includes a registration procedure that asks for your
  149. name, company, and Kermit 95 serial number.  You should enter your real
  150. name, since it will be announced every time you (or anyone else) starts the
  151. program.  The company name is optional.  The serial number must be entered
  152. exactly as shown on the sticker: letters, punctuation, and all.
  153.  
  154. Then please affix ONE of the stickers to your mailback registration card,
  155. fill out the card, and mail it back to us.  Keep the other sticker as a
  156. record of your serial number; for example, in case your PC stops working
  157. and you have to install K95 on a new PC.  In case you lose your serial
  158. number, we'll have a record of it if you sent in your card.
  159.  
  160. If you have an e-mail address, be sure to include it so we can notify you
  161. of new releases or patches (mailings are infrequent and there is no junk
  162. mail; the list is private and is not sold or otherwise provided to anyone
  163. else for any purpose).
  164.  
  165. ------------------------------------------------------------------------
  166. UNINSTALLING KERMIT 95
  167.  
  168. Should you wish to remove Kermit 95 from your Windows 95 system:
  169.  
  170.   1. If you used K95 Registry Tool to add Kermit 95 configuration
  171.      information into the Windows Registry, run it again to remove the
  172.      information from the Registry.
  173.  
  174.   2. Drag the Kermit 95 folder to the Recycle Bin. Do the same with any
  175.      shortcuts you might have created to Kermit 95.
  176.  
  177.   3. If you have followed Helpful Hint 5 below, you will also need to
  178.      rename Microsoft Telnet back to TELNET.EXE.
  179.  
  180. ------------------------------------------------------------------------
  181. RESOURCES
  182.  
  183. The "Using C-Kermit" PDF File
  184.      The user manual for C-Kermit and the technical reference manual for
  185.      Kermit95 in PDF format.  Included only with shrinkwrapped copies of
  186.      Kermit 95 1.1.20 and later.  Access from the References links in the
  187.      Kermit 95 manual.
  188.  
  189. The C-Kermit 7.0 Update Notes
  190.      Kermit 95 1.1.20 is based on C-Kermit 7.0, but Using C-Kermit is
  191.      current with C-Kermit 6.0.  The C-Kermit 7.0 update notes document all
  192.      the features added to C-Kermit since the second edition of the book
  193.      was published in 1997.  This is a fully cross-linked HTML document,
  194.      rather than plain text as in earlier K95 releases.  Access it via
  195.      the link in the References section at the top your K95 manual.
  196.  
  197. The Kermit 95 FAQ
  198.      Frequently Asked Questions (and answers) about Kermit 95. If you have
  199.      a question about Kermit 95, look here first.  Access the K95 FAQ via
  200.      the link in the References section at the top your K95 manual.
  201.  
  202. The Kermit 95 Bug List
  203.      A chronological list of bugs in all the Kermit 95 releases. Most of
  204.      them have been fixed; most of those that remain are due to bugs or
  205.      limitations in the underlying operating system. In many cases,
  206.      workarounds are suggested. If you have problems with Kermit 95, be
  207.      sure to look here for a discussion of it and a possible solution.
  208.      This is a fully indexed and crosslinked HTML document, rather than
  209.      plain text.  Access it via the link in the References section at the
  210.      top your K95 manual.
  211.  
  212. http://www.columbia.edu/kermit/
  213.      The Kermit Project website on the Internet. Here you will find
  214.      information about Kermit software for other platforms, news about
  215.      Kermit 95, hints and tips, script programming examples, and lots more.
  216.      Internet connection required. Here are some points of interest:
  217.  
  218.      ftp://kermit.columbia.edu/kermit/k95/newbugs.txt
  219.           The newbugs.txt file at the Kermit Project website. This file
  220.           lists bugs or other information discovered after this release of
  221.           Kermit 95 was packaged.
  222.  
  223.      http://www.columbia.edu/kermit/k95.html
  224.           The Kermit 95 page.
  225.  
  226.      http://www.columbia.edu/kermit/k95pricing.html
  227.           Kermit 95 pricing and licensing options. Details about low-cost
  228.           bulk right-to-copy licenses and academic site licenses.
  229.  
  230.      http://www.columbia.edu/kermit/k95next.html
  231.           News about upcoming K95 releases.
  232.  
  233.      http://www.columbia.edu/kermit/ckermit.html
  234.           The C-Kermit page, K95's companion software for UNIX, VMS, and
  235.           lots of other platforms.
  236.  
  237.      http://www.columbia.edu/kermit/support.html
  238.           The technical support page, explaining how to get technical
  239.           support, and including some hints and tips to save you some time.
  240.  
  241.      http://www.columbia.edu/kermit/scriptlib.html
  242.           The Kermit Script Library. Lots of sample scripts demonstrating
  243.           how to automate everything from dialing to Internet sessions to
  244.           complex file-management and computation tasks.
  245.  
  246. comp.protocols.kermit.announce
  247.      The Kermit software announcements newsgroup (moderated).
  248.  
  249. comp.protocols.kermit.misc
  250.      The Kermit software discussion newsgroup (unmoderated).
  251.  
  252. ------------------------------------------------------------------------
  253. FILES
  254.  
  255. The following files are included in the top-level Kermit 95 directory:
  256.  
  257. README.TXT
  258.      A this file (also available in an HTML version in your Browser).
  259. SETUP.EXE
  260.      The Kermit 95 setup (installation) program.
  261. K95DIAL.EXE
  262.      The Kermit 95 Dialer. This is the GUI program that gives you
  263.      point-and-click access to all your connections.
  264. K95.EXE
  265.      The Kermit 95 program. You can run this directly to bypass the Dialer
  266.      (normally only Kermit veterans would do this).
  267. K95.INI
  268.      Initialization file for K95.EXE.  Contains commands that are to be
  269.      executed every time K95.EXE is started. See Using C-Kermit for more
  270.      about initialization files.  In Kermit 95, however, most of the
  271.      traditional functions of initialization files are taken over by the
  272.      Dialer.  In any case, you should not change or delete this file; all
  273.      customizations should be made in:
  274. K95CUSTOM.INI
  275.      Customization file for K95.EXE. Created by SETUP.EXE, based your
  276.      answers to its questions. Of use primarily when running K95.EXE
  277.      without going through the Dialer. You may edit this file to change
  278.      your customizations, add new ones, define macros, special keys, and so
  279.      on. This file is never modifed by PATCH.
  280. HOSTMODE.BAT
  281.      Run this to start the host-mode management program.
  282. K95D.EXE
  283.      A daemon that waits for incoming TCP/IP connections.
  284. K95D.CFG
  285.      A configuration file for K95D.EXE.
  286. P95.DLL
  287.      The X/Y/ZMODEM protocol Dynamically Linked Library.
  288. K95DIAL.INF
  289.      Configuration information for the Kermit 95 Dialer (temporary),
  290.      renamed to K95CONFIG.INF after the first time you run the Dialer. It
  291.      contains the choices you made in SETUP.
  292. DIALER.DAT
  293.      Dialer screen definitions.
  294. DIALINF.DAT
  295.      The Kermit 95 Dialer preloaded database (read-only).
  296. DIALORG.DAT
  297.      Your organization's Dialer database (read-only).
  298. DIALUSR.DAT
  299.      Your personal Dialer database (read/write). The K95 Dialer creates
  300.      this file for you the first time you add or change an entry.
  301. P_DIRECT.ZNC
  302. P_SERVIC.ZNC
  303.      These files are used by the Dialer to support the new Browse buttons
  304.      on the Keyboard and Login notebook pages.
  305.  
  306. Utilities:
  307.  
  308. TEXTPS.EXE
  309.      A text-to-PostScript conversion utility, once used by K95 but no
  310.      longer since this capability is now built-in. See PRINTER\TEXTPS.TXT
  311.      for further info.
  312. SE.EXE
  313.      ShellExecute program. CLICK HERE for details.
  314. TELNET.EXE
  315.      Lets Kermit 95 stand in for Telnet (see Helpful Hint 5 below).
  316. RLOGIN.EXE
  317.      Makes an Rlogin connection with Kermit 95; usage: rlogin -l username
  318.      host.
  319. K95CINIT.EXE
  320. K95CINIT.DAT
  321.      An initialization utility for Plug-n-Play modems; Windows 95/98 only
  322.      (see Item 79 in the Bugs List), no longer needed by Kermit 95 but
  323.      might be useful with other software.
  324.  
  325. Several plain-text files included here in former releases, such as BUGS.TXT
  326. and FAQ.TXT, are now in HTML format and included in the DOCS\MANUAL
  327. subdirectory.
  328.  
  329. ------------------------------------------------------------------------
  330. SUBDIRECTORIES
  331.  
  332. Your Kermit 95 directory contains the following subdirectories. Each
  333. subdirectory contains its own READ.ME file explaining what is there.
  334.  
  335. DOCS
  336.      Supplemental documentation on various topics.
  337.  
  338. DOCS\MANUAL
  339.      The Kermit 95 Manual, to be accessed with your Web browser. This is
  340.      done most conveniently from the Dialer's Help menu. This directory
  341.      also contains the Using C-Kermit PDF file and the C-Kermit 7.0
  342.      Update Notes and the Kermit 95 Bug List.
  343.  
  344. DOWNLOAD
  345.      This is the directory where files that you download are stored unless
  346.      you specify otherwise (with the SET FILE DOWNLOAD-DIRECTORY command).
  347.  
  348. KEYMAPS
  349.      This directory contains key mapping files and keyboard-related
  350.      utilities. The DEFAULT.KSC shows K95's default keymaps. Use this as a
  351.      starting point for creating customized keymaps.
  352.  
  353. PHONES
  354.      This directory contains phonelists used by the Kermit 95 Dialer.
  355.  
  356. PRINTER
  357.      Utilities for use on UNIX and VMS computers, as well as on your PC,
  358.      for printing host files on your PC through Kermit 95's terminal
  359.      emulator.
  360.  
  361. SCRIPTS
  362.      This is where login scripts are kept. Some of these are used by the
  363.      Kermit 95 Dialer, some by host mode. Also APAGE.KSC, for sending
  364.      Telocator Alphanumeric Protocol (TAP) alpha pages.
  365.  
  366. ICONS
  367.      Standalone K-95 icons that you can associate with shortcuts to K-95
  368.      files (right-click on a shortcut, select Properties, specify the
  369.      icon).
  370.  
  371. TMP
  372.      Used by Kermit 95 for creating temporary files.
  373.  
  374. USERS
  375.      The root directory of the host-mode user ID system (see
  376.      DOCS\HOSTMODE.TXT).
  377.  
  378. INCOMING
  379.      Directory to which all host-mode users can upload files.
  380.  
  381. PUBLIC
  382.      Directory from which all host-mode users can download files.
  383.  
  384. ------------------------------------------------------------------------
  385. HELPFUL HINTS
  386.  
  387.   1. Be sure to keep phone-list files in the PHONES subdirectory because
  388.      that's where Kermit 95 looks for them. Otherwise you will need to
  389.      specify full path names for your phone list files.
  390.  
  391.   2. Be sure to keep script and other command files in the SCRIPTS
  392.      subdirectory because that's where Kermit 95 looks for them. Otherwise
  393.      you will have to specify full path names for your command and script
  394.      files.
  395.  
  396.   3. If you will not be dialing SprintNet, you can remove the "sprint.kdd"
  397.      file from the phonelist file list under the Dialer's File menu. That
  398.      will save each DIAL command from having to search through several
  399.      hundred entries that it will never use. Similarly for CompuServe and
  400.      "cis.kdd", for Genie and "genie.kdd", and for Tymnet and "tymnet.kdd"
  401.      (these files are even bigger).
  402.  
  403.   4. If you want to be able to run Kermit 95 from the DOS command line, you
  404.      should add the Kermit 95 directory to your PATH. In Windows 95, edit
  405.      your PC's C:\AUTOEXEC.BAT file. Use EDIT or NotePad or WordPad, and
  406.      add:
  407.  
  408.        ;C:\K95;
  409.  
  410.      (or other disk and directory where you installed Kermit 95) to the end
  411.      of the PATH statement.
  412.  
  413.      In Windows NT: Control Panel -> System -> Environment to do this.
  414.  
  415.   5. If you want to use Kermit 95 as your regular Telnet program, add the
  416.      Kermit 95 directory to your PATH (as in Hint 4), and also rename the
  417.      Microsoft TELNET.EXE (which is normally found in C:\WINDOWS) to
  418.      something else, like MSTELNET.EXE, and then the TELNET.EXE program in
  419.      the Kermit 95 directory (which simply translates the Telnet command
  420.      line into a Kermit 95 command line and then starts Kermit 95) will be
  421.      run instead of Microsoft Telnet whenever you give a "telnet" command
  422.      at the DOS prompt, and also by any other programs such as Internet
  423.      Explorer and Netscape that use TELNET.EXE.
  424.  
  425.      Alternatively, you can tell your Web browser that your Telnet
  426.      application is C:\K95\TELNET.EXE (replace C:\K95 with the disk and
  427.      directory where you installed Kermit 95), but not all browsers support
  428.      this.
  429.  
  430.      If you don't want to replace Microsoft Telnet by Kermit 95, but you do
  431.      want the Kermit 95 directory in your PATH, simply rename or delete the
  432.      TELNET.EXE file that's in the Kermit 95 directory.
  433.  
  434.   6. Be sure to consult the Bugs List about bugs in Windows, Kermit, and
  435.      elsewhere, pitfalls to watch out for, etc. Also read the Frequently
  436.      Asked Questions document.
  437.  
  438. ------------------------------------------------------------------------
  439. SERVER INSTALLATION
  440.  
  441. When Kermit 95 is installed on your own PC, all the files go in a directory
  442. (normally "K95") on your own PC, and in subdirectories of that directory,
  443. and Kermit 95 knows where to find all its files.
  444.  
  445. If Kermit 95 is to be run from a file server, which is allowed under bulk
  446. and academic site licenses, then some files go on the server while others
  447. should go on each user's PC. Installation on the server proceeds normally.
  448. But then:
  449.  
  450.   1. A Kermit 95 directory should also be created on each user's PC.
  451.  
  452.   2. The user's Kermit 95 directory should be added to the user's PATH.
  453.  
  454.   3. The server's Kermit 95 directory should be added to the user's PATH
  455.      after the user's own Kermit 95 directory.
  456.  
  457.   4. The following environment variables should be set for each user:
  458.  
  459.      K95.INI
  460.           Location of Kermit 95 initialization file if different from
  461.           location of K95.EXE file.
  462.  
  463.      K95CUSTOM
  464.           Location of user's Kermit 95 customization file.
  465.  
  466.      K95TMP, TEMP, or TMP
  467.           Location of a directory on the user's PC where temporary files
  468.           can be created. If none of these are defined, temporary files
  469.           will be created on the server's disk.
  470.  
  471.   5. The following files and subdirectories should go in the user's K95
  472.      directory:
  473.  
  474.      K95.INI
  475.           optionally (you can also keep one common copy on the fileserver).
  476.  
  477.      K95CUSTOM.INI
  478.           User's private customizations
  479.  
  480.      DIALUSR.DAT
  481.           The user's personal Dialer database (read/write). The K95 Dialer
  482.           creates this file for you the first time you add or change an
  483.           entry.
  484.  
  485.      The DOWNLOAD subdirectory
  486.           The default SET FILE DOWNLOAD-DIRECTORY should be on the user's
  487.           PC, not on the server!
  488.  
  489. If private dialing and network directories are desired, the central copy of
  490. K95.INI can be edited appropriately; for example, to list the central
  491. directory files as well as the user's own private files.
  492.  
  493. If you want to prevent users from accessing the DOS shell, define the
  494. environment variable NOPUSH, and this will disable Kermit 95's shell access
  495. features.
  496.  
  497. ------------------------------------------------------------------------
  498. Kermit 95 README / Version 1.1.20 / March 2000
  499.