ckccfg.txt

C-Kermit源码。是使用串口/Modem和网络通讯的程序

to your makefile entry (see comments in screenc() in ckuusx.c for an
explanation).

In SCO Xenix and SCO UNIX, there are two separate curses libraries, one based
on termcap and the other based on terminfo.  The default library, usually
terminfo, is established when the development system is installed.  To
manually select terminfo (at compile time):

  compile -DM_TERMINFO and link -ltinfo

and to manually select termcap:

  compile -DM_TERMCAP and link -ltcap -ltermlib

<curses.h> looks at M_TERMINFO and M_TERMCAP to decide which header files to
use.  /usr/lib/libcurses.a is a link to either libtinfo.a or libtcap.a.  The
C-Kermit compilation options must agree with the version of the curses library
that is actually installed.

NOTE: If you are doing an ANSI-C compilation and you get compile time warnings
like the following:

  Warning: function not declared in ckuusx.c: wmove, printw, wclrtoeol,
  wclear, wrefresh, endwin, etc...

it means that your <curses.h> file does not contain prototypes for these
functions.  The warnings should be harmless.

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.

In some C-Kermit builds, we replace printf() via #define printf...  However,
this can cause conflicts with the [n]curses header files.  Various hacks are
required to get around this -- see ckutio.c, ckuusx.c, ckufio.c, ckucmd.c,
etc.

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.

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
Cyrillic, add -DNOCYRIL.  To omit Hebrew, add -DNOHEBREW.  If -DNOCSETS is
*not* included, you'll always get LATIN1.  To build with no KANJI include
-DNOKANJI.  There is presently no way to include Latin-2, Cyrillic, Hebrew, or
Kanji without also including Latin-1.

Unicode support was added in version 7.0, and it adds a fair amount of tables
and code (and this is only a "Level 1" implementation -- a higher level would
also require building in the entire Unicode database).  On a PC with RH 5.2
Linux, building C-Kermit 7.0 Beta 11:

  NOCSETS NOUNICODE NOKANJI   Before    After
   [   ]    [   ]    [   ]    1329014          (Full)
   [   ]    [   ]    [ X ]    1325686          (Unicode but no Kanji)
   [   ]    [ X ]    [   ]    1158837          (All charsets except Unicode)
   [ X ]    [ x ]    [ x ]    1090845          (NOCSETS implies the other two)

Note, by the way, that NOKANJI without NOUNICODE only removes the non-Unicode
Kanji sets (Shift-JIS, EUC-JP, JIS-7, etc).  Kanji is still representable in
UCS-2 and UTF-8.


5. APC EXECUTION

The Kermit CONNECT module can be coded to execute Application Program Command
escape sequences from the host:

  <ESC>_<text><ESC>\

where <text> is a C-Kermit command, or a list of C-Kermit commands separated
by commas, up to about 1K in length.

To date, this feature has been coded into the OS/2, Windows, VMS, OS-9, and
UNIX versions, for which the symbol:

  CK_APC

is defined automatically in ckuusr.h.  For OS/2, APC is enabled at runtime
by default, for UNIX it is disabled.  It is controlled by the SET TERMINAL
APC command.  Configuring APC capability into a version that gets it by
default (because CK_APC is defined in ckuusr.h) can be overridden by including:

  -DNOAPC

on the CC command line.

The autodownload feature depends on the APC feature, so deconfiguring APC
also disables autodownload.


6. PROGRAM SIZE

(Also see Section 4: Character Sets)

C-Kermit has become a large program, much larger than early versions because
of all the new features, primarily the script programming language, sliding
window packet protocol, and international character set translation.  On some
systems, the size of the program prevents it from being successfully linked
and loaded.  On some others, it occupies so much memory that it is constantly
swapping or paging.  In such cases, you can reduce C-Kermit's size in various
ways, outlined in this section.  The following options can cut down on the
program's size at compile time by removing features or changing the size of
storage areas.

6.1. When Memory Is Not a Problem

But first, also note that if "memory is no problem" on your system, you can
easily INCREASE the sizes of many things (buffers, command length, macro
length, maximum number of all sorts of things) simply by defining the
following symbol at compile time:

  BIGBUFOK

This symbol is defined for certain platforms by default in ckcdeb.h.  If you
want to override this, use:

  make xxxx KFLAGS=-DNOBIGBUF

6.2. Removing Features

Features can be removed by defining symbols on the CC (C compiler) command
line.  "-D" is the normal CC directive to define a symbol so, for example,
"-DNODEBUG" defines the symbol NODEBUG.  Some C compilers might use different
syntax, e.g.  "-d NODEBUG" or "/DEFINE=NODEBUG".  For C compilers that do not
take command-line arguments, you can put the corresponding #define statements
in the file CKCSYM.H, for example:

#define NODEBUG

(The #define statement must be on the left margin.)  Here are C-Kermit's
size-related compile-time options.  The ones that take up the most space are
marked by asterisk (*).  If you are desperate to save space, remove debugging
first, rather than some more useful feature.  Remove built-in help only if
absolutely necessary.  The final resort is to remove the interactive command
parser completely, leaving only a UNIX-style command-line interface
("kermit -s foo").  This cuts the program down to about 25% of its fully
configured size.

* -DNOUNICODE:Add this option to omit Unicode character-set support.
* -DNOCSETS:  Add this option to remove ALL character set support.
* -DNODEBUG:  Add this option to omit all debugging code.
  -DNOTLOG:   Add this option to omit transaction logging.
* -DNOHELP:   Add this option to omit built-in help.
  -DNODISPLAY:Add this option to omit the file-transfer display.
  -DTCPSOCKET:Remove this option to omit TCP/IP support.
  -DSUNX25:   Remove this option to omit SunLink X.25 support.
* -DNONET:    Add this to remove all network support.
  -DNOMSEND:  Add this option to remove the MSEND command.
* -DNOLOCAL:  Add this option to remove all support for making connections.
* -DNODIAL:   Add this option to remove the DIAL command and modem support.
* -DMINIDIAL: Add this option to support only standard &/or generic modem types
* -DNOOLDMODEMS: Add this option to drop support for "old" modem types.
* -DNOCHANNELIO: Add this option to remove the FILE command & related functions
  -DNOXMIT:   Add this option to remove the TRANSMIT command.
  -DNOSCRIPT: Add this option to remove the UUCP-style SCRIPT command.
  -DNOCMDL:   Add this option to remove the command-line option interface.
* -DNOSPL:    Add this option to remove the script programming language.
* -DNOICP:    Add this option to remove the entire interactive command parser.
  -DNOIKSD:   Remove support for the Internet Kermit Service Daemon.
  -DDCMDBUF:  Add this option to allocate command buffers dynamically.
  -DNOLATIN2  Add this option to remove ISO Latin-2 character-set translation.
  -DNOCYRIL:  Add this option to remove Cyrillic character set translation.
  -DNOLATIN2: Add this option to remove Latin-2 character set translation.
  -DNOHEBREW: Add this option to remove Hebrew character set translation.
  -DKANJI:    Omit this option to exclude Kanji character set translation.
  -DNOESCSEQ: Add this option to omit ANSI escape sequence recognition.
  -DNOSERVER: Add this option to remove server mode.
  -DNOSETKEY: Add this option to remove the SET KEY command.
  -DNOPUSH:   Add this option to remove escapes to operating system.
  -DNOFRILLS: Add this option to remove "frills".
* -DNOCURSES: Omit this option to keep the curses library out of Kermit.
* -DNOBIGBUF: Override BIGBUFOK in case it is defined: force smaller buffers.
* -DNOXFER:   Add this option to omit all file-transfer protocols.

  -DSBSIZ=nnnn -DRBSIZ=nnnnn
     Change the overall size of the packet send and receive buffers.

-DNOFRILLS removes various command synonyms; the following top-level commands:
CLEAR, DELETE, DISABLE, ENABLE, GETOK, MAIL, RENAME, TYPE, WHO; and the
following REMOTE commands: KERMIT, LOGIN, LOGOUT, PRINT, TYPE, WHO.

The CK_CURSES option, at least on UNIX, requires C-Kermit be linked with a
large external library (curses or ncurses).  On certain small systems,
C-Kermit programs built this way have been observed to cause swapping and/or
performance problems.  If you include -DNOCURSES, you might also have to edit
the makefile entry to remove all references to "curses", "termcap", and/or
"termlib", etc, from the LIBS clause.

6.3. Changing Buffer Sizes

(This section is somewhat obsolete -- most modern C-Kermit versions are built
with BIGBUFOK defined, which selects maximum-size packet buffers, plus big
command and other buffers).

There are options to control Kermit's packet buffer allocations.  The
following symbols are defined in ckcker.h in such a way that you can override
them by redefining them in CFLAGS:

  -DMAXSP=xxxx - Maximum send-packet length, default 2048.
  -DMAXRP=xxxx - Maximum receive-packet length, 2048 for UNIX, 1920 for VMS.
  -DSBSIZ=xxxx - Total allocation for send-packet buffers, default 3008.