ckccfg.doc

linux终端仿真程序

C-KERMIT CONFIGURATION INFORMATION                                   -*-text-*-

  As of C-Kermit version:  6.0.192 Beta.030
  This file last updated:  Fri Sep  6 23:23:01 1996

  Frank da Cruz, Columbia University

  Copyright (C) 1985, 1996, Trustees of Columbia University in the City of New
  York.  The C-Kermit software may not be, in whole or in part, licensed or
  sold for profit as a software product itself, nor may it be included in or
  distributed with commercial products or otherwise distributed by commercial
  concerns to their clients or customers without written permission of the
  Office of Kermit Development and Distribution, Columbia University.  This
  copyright notice must not be removed, altered, or obscured.

DOCUMENTATION:

C-Kermit 5A is documented in the book "Using C-Kermit" by Frank da Cruz and
Christine M. Gianone, Second Edition, Digital Press / Butterworth-Heinemann,
Woburn, MA, 1997, ISBN 1-55558-164-1, Price: US $39.95.  To order call the
Kermit Project at Columbia University, [phone], and order with Master
Card or Visa, or call Digital Press, [phone], and order with Master
Card, Visa, or American Express.

DISCLAIMER:

  The C-Kermit software is provided in source code form by Kermit Development
  and Distribution, Columbia University.  The software is provided "as is;" no
  other warranty is provided, express or implied, including without
  limitations, any implied warranty of merchantability or implied warranty of
  fitness for a particular purpose.

  Neither Columbia University nor any of the contributors to the C-Kermit
  development effort, including, but not limited to, AT&T, Digital Equipment
  Corporation, Data General Corporation, or International Business Machines
  Corporation, warrant C-Kermit software or documentation in any way.  In
  addition, neither the authors of any Kermit programs, publications or
  documentation, nor Columbia University nor any contributing institutions or
  individuals acknowledge any liability resulting from program or
  documentation errors.

WHAT IS IN THIS FILE

This file is for C-Kermit developers.  It explains compilation options,
feature selection, and compilation problem-solving, as they (should) apply to
all versions of C-Kermit: UNIX, VMS, OS/2, and the rest.

CONTENTS

  1. OVERVIEW
  2. SERIAL COMMUNICATION SPEEDS
  3. FULLSCREEN FILE TRANSFER DISPLAY
  4. CHARACTER SETS
  5. APC EXECUTION
  6. PROGRAM SIZE
     6.1. When Memory Is Not a Problem
     6.2. Removing Features
     6.3. Changing Buffer Sizes
     6.4. Other Size-Related Items
     6.5. Space/Time Tradeoffs
  7. DIALER SUPPORT
  8. NETWORK SUPPORT
     8.1. TCP/IP
	  8.1.1. Firewalls
	  8.1.2. Solving Compilation and Linking Problems
	  8.1.3. Enabling Host Address Lists
	  8.1.4. Enabling Telnet NAWS
          8.1.5. Enabling Incoming TCP/IP Connections
     8.2. X.25
     8.3. Other Networks
  9. EXCEPTION HANDLING
 10. SECURITY FEATURES
 11. ENABLING SELECT()
 APPENDIX I: SUMMARY OF COMPILE-TIME OPTIONS

1. OVERVIEW

This file gives more-or-less system-independent configuration information for
C-Kermit 5A and later.  The major topics covered include program size (and how
to reduce it), how to include or exclude particular features, notes on modem
and network support, and a list of C-Kermit's compile-time options.

For details about your particular operating system, consult the system-specific
installation instructions file:

  CK?INS.DOC

(? = U for UNIX, V for VMS, etc, for example, CKUINS.DOC for UNIX, CKVINS.DOC
for VAX/VMS, CKDINS.DOC for Data General AOS/VS, etc).  Also consult the
following files:

  CKAAAA.HLP   Explanation of file naming conventions
  CKCPLM.DOC   C-Kermit "program logic manual"
  CK?KER.HLP   System-specific help file, if any
  CK?KER.MAK   System-specific build procedure
  CKCKER.BWR   "Beware file": C-Kermit bugs, limitations, workarounds
  CK?KER.BWR   System-specific "beware file"
  CKCKER.UPD   User-level documentation for new features
  CKCnnn.UPD   Program edit history for edit nnn, e.g. CKC190.UPD.

2. SERIAL COMMUNICATION SPEEDS

These are defined in two places: the SET SPEED keyword list in the command
parser (as of this writing, in the ckuus3.c source file), and in the system-
dependent communications i/o module, CK?TIO.C, functions ttsspd() (set speed)
and ttgspd() (get speed).  The following speeds are assumed to be available
in all versions:

  0, 110, 300, 600, 1200, 2400, 4800, 9600

If one or more of these speeds is not supported by your system, you'll need
to change the source code (this has never happened so far).  Other speeds
that are not common to all systems have Kermit-specific symbols:

               Symbol       Symbol
  Speed (bps)  to enable    to disable
       50       BPS_50       NOB_50
       75       BPS_75       NOB_75  
       75/1200  BPS_7512     NOB_7512
      134.5     BPS_134      NOB_134
      150       BPS_150      NOB_150
      200       BPS_200      NOB_200
     1800       BPS_1800     NOB_1800
     3600       BPS_3600     NOB_3600
     7200       BPS_7200     NOB_7200
    14400       BPS_14K      NOB_14K
    19200       BPS_19K      NOB_19K
    28800       BPS_28K      NOB_28K
    38400       BPS_38K      NOB_38K
    57600       BPS_57K      NOB_57K
    76800       BPS_76K      NOB_76K
   115200       BPS_115K     NOB_155K
   230400       BPS_230K     NOB_230K

The ckcdeb.h header file contains default speed configurations for the many
systems that C-Kermit supports.  You can override these defaults by (a)
editing ckcdeb.h, or (b) defining the appropriate enabling and/or disabling
symbols on the CC command line, for example:

  -DBPS_14400 -DNOB_115200

or the "make" command line, e.g.:

  make blah "KFLAGS=-DBPS_14400 -DNOB_115200"

Note: some speeds have no symbols defined for them, because they have never
been needed: 12.5bps, 45.5bps, 20000bps, etc.  These can easily be added if
required.

IMPORTANT: Adding one of these flags at compile time does not necessarily mean
that you will be able to use that speed.  A particular speed is usable only if
your underlying operating system supports it.  In particular, it needs to be
defined in the appropriate system header file (e.g. in UNIX, cd to
/usr/include and grep for B9600 in *.h and sys/*.h to find the header file
that contains the definitions for the supported speeds), and supported by the
serial device driver, and of course by the physical device itself.

3. FULLSCREEN FILE TRANSFER DISPLAY

New to edit 180 is support for an MS-DOS-Kermit-like local-mode full screen
file transfer display, accomplished using the curses library, or something
equivalent (for example, the Screen Manager on DEC VMS).  To enable this
feature, include the following in your CFLAGS:

  -DCK_CURSES

and then change your build procedure (if necessary) to include the necessary
libraries, usually "curses", perhaps also "termcap" or "termlib".  See
OS-dependent installation instructions and/or build procedure for details.  

New to edit 190 is the ability to refresh a messed-up full-screen display,
e.g. after receiving a broadcast message.  This depends on the curses package
including the wrefresh() and clearok() functions and the curscr variable.  If
your version has these, or has code to simulate them, then add:

  -DCK_WREFRESH

The curses and termcap libraries add considerable size to the program image
(e.g. about 20K on a SUN-4, 40K on a 386).  On some small systems, such as the
AT&T 6300 PLUS, curses support can push Kermit over the edge... even though it
compiles, loads, and runs correctly, its increased size apparently makes it
swap constantly, slowing it down to a crawl, even when the curses display is
not in use.  Some new makefile entries have been added to take care of this
(e.g. sys3upcshcc), but similar tricks might be necessary in other cases too.

Also new to edit 190 is an ASCII-graphic percent-done "thermometer".  This is
not included unless you add:

  -DCK_PCT_BAR

to your CFLAGS.

Just below the bar is a running display of the transfer rate, as a flat
quotient of file characters per elapsed seconds so far.  You can change this
to an average that gives greater weight to recent history (0.25 *
instantaneous cps + 0.75 * historical cps) by adding -DCPS_WEIGHTED to
your CFLAGS (sorry folks, this one is not worth a SET command).  You can
choose a second type of weighted average in which the weighting smooths
out progressively as the transfer progresses by adding -DCPS_VINCE to
-DCPS_WEIGHTED.

An alternative to curses is also available at compile time, but should be
selected if your version of Kermit is to be run in local mode only in an ANSI
terminal environment, for example on a desktop workstation that has an ANSI
console driver.  To select this option in place of curses, define the symbol
MYCURSES:

  -DMYCURSES

instead of CK_CURSES.  The MYCURSES option uses built-in ANSI (VT100) escape
sequences, and depends upon your terminal or console driver to interpret them
correctly.

To use the fullscreen display feature, SET FILE DISPLAY FULLSCREEN.  Beware, it
can slow the transfer down a bit (or a lot).  The faster the connection speed,
the more likely the fullscreen display will become the bottleneck.  To test
whether the fullscreen display is slowing your transfers down on a particular
connection, transfer the same with it and without it, and compare the figures
given in the STATISTICS command.  The default file transfer display is still
the old SERIAL ("dots") display, even if you build in curses support.

A compromise between the two styles (new to edit 183), that can be used on any
video display terminal, can be elected at runtime with the SET FILE DISPLAY
CRT.  It relies only on the ability of the terminal to write over the current
line when it receives a bare carriage return.  The same performance comments
apply to this display option.

4. CHARACTER SETS

By default, C-Kermit is built with support for translation of character sets
for Western European languages (i.e. languages that originated in Western
Europe, but are now also spoken in the Western Hemisphere and other parts of
the world), via ISO 8859-1 Latin Alphabet 1, for Eastern European languages
(ISO Latin-2), Hebrew (and Yiddish), and Cyrillic-alphabet languages (ISO
Latin/Cyrillic).  Many file (local) character sets are supported: ISO 646
7-bit national sets, IBM code pages, Apple, DEC, DG, NeXT, etc.

Japanese language support is available by defining the following symbol in
your CFLAGS (for example in UNIX, you can "make xxx KFLAGS=-KANJI"):

-DKANJI
   Japanese.
   Transfer character-set: Japanese EUC (= JIS X 0201 + JIS X 0208)
   File character-sets: EUC, JIS-7, DEC Kanji, Shift JIS

To build Kermit with no character-set translation at all, include -DNOCSETS in
the CFLAGS.  To build with no Latin-2, add -DNOLATIN2.  To build with no