New York City USA
•
kermit@kermitproject.org
…since
1981
|
|
The Kermit Project
|
Now hosted by
Panix.com
New York City USA
•
kermit@kermitproject.org
…since
1981
|
| Home | C-Kermit | E-Kermit | Kermit 95 | Scripts | Timeline | About | FAQ |
1. FILE TRANSFER 2. SERIAL COMMUNICATION SPEEDS 3. FULLSCREEN FILE TRANSFER DISPLAY 4. CHARACTER SETS 5. APC EXECUTION 6. PROGRAM SIZE 7. MODEM DIALING 8. NETWORK SUPPORT 9. EXCEPTION HANDLING 10. SECURITY FEATURES 11. ENABLING SELECT() 12. I/O REDIRECTION 13. FLOATING-POINT NUMBERS, TIMERS, AND ARITHMETIC 14. SPECIAL CONFIGURATIONS I. SUMMARY OF COMPILE-TIME OPTIONS
For details about your particular operating system, also see the system-specific installation instructions file, such as the C-Kermit Installation Instructions for Unix.
[ C-Kermit Home ] [ Kermit Home ]
Prior to version 7.0, C-Kermit was always built with the most conservative Kermit file-transfer protocol defaults on every platform: no control-character prefixing, 94-byte packets, and a window size of 1.
Starting in version 7.0, fast settings are the default. To override these at compile time, include:
-DNOFAST
in the C compiler CFLAGS. Even with the fast defaults, C-Kermit automatically drops down to whatever window and packet sizes requested by the other Kermit, if these are smaller, when sending files (except for control-character unprefixing, which is not negotiated, and which is now set to CAUTIOUS rather than NONE at startup). C-Kermit's settings prevail when it is receiving.
[ C-Kermit Home ] [ Kermit Home ]
As of C-Kermit, a new simplified mechanism for obtaining the list of legal serial interface speeds is in place:
The
Note that this scheme does not necessarily rule out split speed operation, but effectively it does in C-Kermit as presently constituted since there are no commands to set input and output speed separately (except the special case "set speed 75/1200").
Note that some platforms, notably AIX 4.2 and 4.3, implement high serial speeds transparently to the application, e.g. by mapping 50 bps to 57600 bps, and so on.
That's the whole deal. When TTSPDLIST is not defined, the following applies:
Speeds are defined in two places: the SET SPEED keyword list in the command
parser (as of this writing, in the
0, 110, 300, 600, 1200, 2400, 4800, 9600
If one or more of these speeds is not supported by your computer, 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
460800 BPS_460K NOB_460K
921600 BPS_921K NOB_921K
C-Kermit 10.0 (2020) adds some higher speeds, including 1000000, 1152000, 1500000, 2000000, 2500000, 3000000, 3500000, and 4000000.
The
-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 (but they will work only if the OS supports them).
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
ALSO IMPORTANT: The list of available speeds is independent of how they are
set. The many UNIXes, for example, offer a wide variety of APIs that are
BSD-based, SYSV-based, POSIX-based, and purely made up. See the
[ C-Kermit Home ] [ Kermit Home ]
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. For example, in Unix these are usually "curses" or "ncurses" (and more recently, "ncursesw" and "slang"), perhaps also "termcap", "termlib", or "tinfo":
"LIBS= -lcurses -ltermcap" "LIBS= -lcurses -ltermlib" "LIBS= -lncurses" "LIBS= -ltermlib" "LIBS= -ltinfo"
"man curses" for further information, and
search through the Unix
There might still be a complication. Some implementations of curses reserve the right to alter the buffering on the output file without restoring it afterwards, which can leave Kermit's command processing in a mess when the prompt comes back after a fullscreen file transfer display. The typical symptom is that characters you type at the prompt after a local-mode file transfer (i.e. after seeing the curses file-transfer display) do not echo until you press the Return (Enter) key. If this happens to you, try adding
-DCK_NEWTERM
to your makefile target (see comments in
If that doesn't fix the problem, then use a bigger hammer and replace -DCK_NEWTERM with:
-DNONOSETBUF
which tells Kermit to force stdout to be unbuffered so CBREAK mode can work.
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
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
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
-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 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 targets have been added to take care of this (e.g. sys3upcshcc), but similar tricks might be necessary in other cases too.
On the curses file-transfer display, just below the "thermometer", 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
[ C-Kermit Home ] [ Kermit Home ]
Since version 5A, C-Kermit has included support for conversion 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), Greek, 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 C-Kermit 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, we get the following sizes:
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.
[ C-Kermit Home ] [ Kermit Home ]
The Kermit CONNECT and INPUT commands are 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 included in the OS/2, Windows, VMS, OS-9, and Unix versions, for which the symbol:
CK_APC
is defined automatically in
-DNOAPC
on the CC command line.
C-Kermit's autodownload feature depends on the APC feature, so deconfiguring APC also disables autodownload (it doesn't use APC escape sequences, but uses the APC switching mechanism internally).
[ C-Kermit Home ] [ Kermit Home ]
SECTION CONTENTS
6.1. Feature Selection 6.2. Changing Buffer Sizes 6.3. Other Size-Related Items 6.4. Space/Time Tradeoffs
(Also see Section 4)
Each release of C-Kermit is larger than the last. On some computers (usually old ones) the size of the program prevents it from being successfully linked and loaded. On some others (also usually old ones), 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.
If you are reading this section because all you want is a small, fast, quick-to-load Kermit file-transfer application for the remote end of your connection, and the remote end is Unix based, take a look at G-Kermit:
http://www.kermitproject.org/gkermit.html
#define NODEBUG
The following table shows the savings achieved when building C-Kermit 8.0 (Beta.04) with selected feature-deselection switches on an Intel-based PC with Red Hat Linux 7.0 and gcc 2.96. The sizes are for non-security builds. The fully configured non-security build is 2127408 bytes.
Option Size Savings Effect NOICP 545330 74.4% No Interactive Command Parser (command-line only) NOLOCAL 1539994 27.6% No making connections. NOXFER 1551108 27.1% No file transfer. IKSDONLY 1566608 26.4% Internet Kermit Server only. NOCSETS 1750097 17.7% No character-set conversion. NOSPL 1800293 15.4% No Script Programming Language. NONET 1808575 15.0% No making network connections. NOUNICODE 1834426 13.8% No Unicode character-set conversion. NOHELP 1837877 13.6% No built-in help text. NODEBUG 1891669 11.1% No debug log. NODEPRECATED No "deprecated" features (C-Kermit 10.0, 2022) NOFRILLS 1918966 9.8% No "frills". NOFTP 1972496 7.3% No FTP client. NODIAL 1984488 6.7% No automatic modem dialing. NOPUSH 2070184 2.7% No shell access, running external programs, etc. NOIKSD 2074129 2.5% No Internet Kermit Server capability. NOHTTP 2082610 2.1% No HTTP client. NOFLOAT 2091332 1.7% No floating-point arithmetic. NOCHANNELIO 2095978 1.5% No FOPEN/FREAD/FWRITE/FCLOSE, etc. MINIDIAL 2098035 1.4% No built-in support for many kinds of modems. NOSERVER 2098987 1.3% No server mode. NOSEXP 2105898 1.0% No S-Expressions. NOPTY 2117743 0.5% No pseudoterminal support. NORLOGIN 2121089 0.3% No RLOGIN connections. NOOLDMODEMS 2124038 0.2% No built-in support for old kinds of modems. NOSSH 2125696 0.1% No SSH command.
And here are a few combinations
Options Size Savings Effect NODEBUG NOICP NOCSETS NOLOCAL 281641 86.7% No debug log, parser, character sets, or making connections. NOICP NOCSETS NOLOCAL 376468 82.3% No parser, character sets, or making connections. NOICP NOCSETS NONET 427510 79.9% No parser, character sets, or network connections. NOSPL NOCSETS 1423784 33.1% No script language, or character sets.
-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.
Two major factors affect Kermit's size: feature selection and buffer sizes. Buffer sizes affect such things as the maximum length for a Kermit packet, the maximum length for a command, for a macro, for the name of a macro, etc. Big buffer sizes are used when the following symbol is defined:
BIGBUFOK
as it is by default for most modern platforms (Linux, AIX 4 and 5,
HP-UX 10 and 11, Solaris, etc) in
make xxxx KFLAGS=-DBIGBUFOK
where xxxx is the makefile target. On the other hand, if you want to build without big buffers when they normally would be selected, use:
make xxxx KFLAGS=-DNOBIGBUF
There are options to control Kermit's packet buffer allocations. The
following symbols are defined in
-DMAXSP=xxxx - Maximum send-packet length. -DMAXRP=xxxx - Maximum receive-packet length. -DSBSIZ=xxxx - Total allocation for send-packet buffers. -DRBSIZ=xxxx - Total allocation for receive-packet buffers.
The defaults depend on the platform.
Using dynamic allocation (-DDYNAMIC) reduces storage requirements for the executable program on disk, and allows more and bigger packets at runtime. This has proven safe over the years, and now most builds (e.g. all Unix, VMS, Windows, and OS/2 ones) use dynamic memory allocation by default. If it causes trouble, however, then omit the -DDYNAMIC option from CFLAGS, or add -DNODYNAMIC.
It is also possible to reduce the size of the executable program file in several other ways:
[ C-Kermit Home ] [ Kermit Home ]
-DNODIAL removes automatic modem dialing completely, including the entire
-DMINIDIAL leaves the DIAL and related commands (SET/SHOW MODEM, SET/SHOW DIAL) intact, but removes support for all types of modems except CCITT, Hayes, Unknown, User-defined, Generic-high-speed, and None (= Direct). The MINIDIAL option cuts the size of the dial module approximately in half. Use this option if you have only Hayes or CCITT modems and don't want to carry the baggage for the other types.
A compromise between full dialer support and MINIDIAL is obtained by removing support for "old" modems -- all the strange non-Hayes compatible 1200 and 2400 bps modems that C-Kermit has been carrying around since 1985 or so. To remove support for these modems, add -DNOOLDMODEMS to CFLAGS at compilation time.
Finally, if you keep support for old modems, you will notice that their names appear on the "set modem ?" menu. That's because their names are, by default, "visible". But the list is confusing to the younger generation, who have only heard of modems from the V.32bis-and-later era. If you want to be able to use old modems, but don't want their names cluttering up menus, add this to CFLAGS:
-DM_OLD=1
[ C-Kermit Home ] [ Kermit Home ]
SECTION CONTENTS
8.1. TCP/IP 8.2. X.25 8.3. Other Networks
C-Kermit supports not only serial-port and modem connections, but also TCP/IP and X.25 network connections. Some versions support other network types too like DECnet, LAT, NETBIOS, etc. If you define the following symbol:
NONET
then all network support is compiled away.
8.1.1. Firewalls 8.1.2. 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.1.6. Disabling SET TCP Options
C-Kermit's TCP/IP features require the Berkeley sockets library or equivalent, generally available on any Unix system, as well as in Windows 9x/NT, OS/2, VMS, AOS/VS, VOS, etc. The TCP/IP support includes built-in TELNET, FTP, and HTTP protocol. To select TCP/IP support, include -DTCPSOCKET in your makefile target's CFLAGS, or (in VMS) the appropriate variant (e.g. -DWOLLONGONG, -DMULTINET, -DEXCELAN, -DWINTCP, etc).
The VMS and/or early Unix third-party TCP/IP products are often incompatible with each other, and sometimes with different versions of themselves. For example, Wollongong reportedly put header files in different directories for different UNIX versions:
In cases like this, use the
cd /usr/include/arpa ln /usr/include/netinet/telnet.h telnet.h
("man ln" for details about links.)
The network support for TCP/IP and X.25 is in the source files
Within the TCPSOCKET code, some socket-level controls are included if
TCPSOCKET is defined in the C-Kermit CFLAGS and SOL_SOCKET is defined in
in the system's TCP-related header files, such as
SET TCP KEEPALIVE SET TCP LINGER SET TCP RECVBUF SET TCP SENDBUF
In addition, if TCP_NODELAY is defined, the following command is also enabled:
SET TCP NODELAY (Nagle algorithm)
See the C-Kermit user documentation for descriptions of these commands.
One firewall method is called SOCKS, in which a proxy server allows users inside a firewall to access the outside world, based on a permission list generally stored in a file. SOCKS is enabled in one of two ways. First, the standard sockets library is modified to handle the firewall, and then all the client applications are relinked (if necessary, i.e. if the libraries are not dynamically loaded) with the modified sockets library. The APIs are all the same, so the applications do not need to be recoded or recompiled.
In the other method, the applications must be modified to call replacement
routines, such as
-lsocks
to LIBS, or replacing
For SOCKS5, use -DCK_SOCKS5.
Explicit firewall support can, in general, not be a standard feature or a feature that is selected at runtime, because the SOCKS library tends to be different at each site -- local modifications abound.
The ideal situation occurs when firewalls are supported by the first method, using dynamically linked sockets-replacement libraries; in this case, all your TCP/IP client applications negotiate the firewall transparently.
Compilation errors might also have to do with the data type used for
HADDRLIST
This appears to be needed at least on the AT&T 3B2, where in
The UNIX version of C-Kermit also traps SIGWINCH, so it can send a NAWS to the
Telnet server any time the local console terminal window size changes,
e.g. when you stretch it with a mouse. The SIGWINCH-trapping code is enabled
if SIGWINCH is defined (i.e. in
If you want to disable incoming TCP/IP connections, then build C-Kermit with:
-DNOLISTEN
-DNOTCPOPTS
In UNIX, special makefile targets sunos4x25 and sunos41x25 (for SUNOS 4.0 and 4.1, respectively), or aix41x25, are provided to build in this feature, but they only work if conditions (a)-(c) are met. To request this feature, include -DSUNX25 (or -DIBMX25) in CFLAGS.
SUNX25 (or -DIBMX25) and TCPSOCKET can be freely mixed and matched, and selected by the user at runtime with the SET NETWORK TYPE command or SET HOST switches.
Provision is made in the organization of the modules, header files, commands, etc, for addition of new network types such as DECnet, X.25 for other systems (HP-UX, VMS, etc), and so on. Send email to kermit@kermitproject.org if you are willing and able to work on such a project.
[ C-Kermit Home ] [ Kermit Home ]
The C language setjmp/longjmp mechanism is used for handling exceptions. The jump buffer is of type jmp_buf, which almost everywhere is typedef'd as an array, in which case you should have no trouble compiling the exception-handling code. However, if you are building C-Kermit in/for an environment where jmp_buf is something other than an array (e.g. a struct), then you'll have to define the following symbol:
JBNOTARRAY
[ C-Kermit Home ] [ Kermit Home ]
Security, in the sense of secure authentication and strong encryption, can be
built into versionf of C-Kermit for which the appropriate libraries and header
files are available (Kerberos IV, Kerberos V, OpenSSL, SRP), as explained in
great detail in the
Besides the strong forms of security listed above, C-Kermit also embodies
various internal security features, including:
NOPUSH and NOCCTRAP together allow Kermit to be run from restricted shells,
preventing access to system functions.
[ C-Kermit Home ]
[ Kermit Home ]
Kermit works best if it can do nonblocking reads, nondestructive input buffer
checking, and millisecond sleeps. All of these functions can be accomplished
by the
Furthermore, even when
Other alternatives include
If your system supports the
to the CFLAGS, and removing -DRDCHK or -DCK_POLL if it is there. If you get
compilation errors, some adjustments to
Various macros and data types need to be defined in order to use
to the CFLAGS to tell C-Kermit to #include
In UNIX, the use of
As of C-Kermit 7.0,
SHOW VERSIONS tells whether the CONNECT module uses
C-Kermit 8.0 adds learned script capability, which depends on
[ C-Kermit Home ]
[ Kermit Home ]
The REDIRECT command allows a local program to be run with its i/o redirected
over the communications connection. Your version of C-Kermit has a REDIRECT
command if it was built with the following CFLAG:
This, in turn, is possible only if the underlying API is there. In the case
of UNIX this is just the
As of version 7.0, file transfer can be done using pipes and filters. To
enable this feature, #define PIPESEND (and fill in the code). To disable on
systems where it is normally enabled, define NOPIPESEND. This feature is, of
course, also disabled by building with NOPUSH (or giving the "nopush" command
at runtime).
C-Kermit 7.0 also adds the PIPE and SET HOST /COMMAND commands, which provide
another form of redirection. This feature is selected with -DNETCMD. CK_RDIR
must also be defined, since the same mechanisms are used internally.
[ C-Kermit Home ]
[ Kermit Home ]
Floating-point support was added in C-Kermit 7.0.
Floating-point numbers are enabled internally, at least for use in
high-precision file-transfer timers and statistics, unless the following
symbol is defined at compile time:
This might be necessary on old PCs that do not have built-in floating-point
hardware.
When NOFLOAT is not defined, the following symbol tells which floating-point
type to use:
The value is either "double" (normal for 32- and 16-bit architectures) or
"float" (normal for 64-bit architectures).
C-Kermit can be configured to use high-precision file-transfer timers for more
accurate statistics. This feature is enabled with:
and disabled with:
If you try to build with -DGFTIMER but you get compilation errors, either fix
them (and send email to kermit@kermitproject.org telling what you did), or else
give up and use -DNOGFTIMER (or -DNOFLOAT) instead. Hint: depending on your
machine architecture, you might have better luck using double than float as
the data type for floating-point numbers, or vice versa. Look in
Floating-point arithmetic is also supported in the script programming
language. First via the
and in Unix you must link with the Math library:
In K95 and VMS, FNFLOAT is defined automatically if CKFLOAT is defined. In
Unix, however, FNFLOAT must be added to each makefile target individually,
because of the special linking instructions that must also be added to each
target.
Note: S-Expressions require FNFLOAT.
[ C-Kermit Home ]
[ Kermit Home ]
As of C-Kermit 7.0, if you build C-Kermit normally, but with -DNOICP (No
Interactive Command Parser), you get a program capable of making serial
connections (but not dialing) and network connections (if TCPSOCKET or
other network option included), and can also transfer files using Kermit
protocol, but only via autodownload/upload. Furthermore, if you call
the executable "telnet", it will act like Telnet -- using the command-line
options. However, in this case there is nothing to escape back to, so if
you type Ctrl-\c, it just prints a message to this effect.
You can also build C-Kermit with -DNOXFER, meaning omit all the file-transfer
features. This leaves you with a scriptable communications program that is
considerably smaller than the full C-Kermit.
[ C-Kermit Home ]
[ Kermit Home ]
These are the symbols that can be specified on the cc command line, listed
alphabetically. Others are used internally, including those taken from header
files, those defined by the compiler itself, and those inferred from the ones
given below. Kermit's SHOW VERSIONS command attempts to display most of
these. See
Here is the complete list of the Kermit-specific compile-time switches:
11. ENABLING
[ Top ]
[ Contents ]
[ Next ]
[ Previous ]
SELECT
Use (BSD, or systems with sockets libraries)
CK_POLL
Use (System V)
RDCHK
Use (SCO XENIX and UNIX)
-DSELECT
-DSELECT_H
The
12. I/O REDIRECTION
[ Top ]
[ Contents ]
[ Next ]
[ Previous ]
-DCK_REDIR
13. FLOATING-POINT NUMBERS, TIMERS, AND ARITHMETIC
[ Top ]
[ Contents ]
[ Next ]
[ Previous ]
-DNOFLOAT
-DCKFLOAT=xxxx
-DGFTIMER
-DNOGFTIMER
-DFNFLOAT
LIBS=".... -lm"
14. SPECIAL CONFIGURATIONS
[ Top ]
[ Contents ]
[ Previous ]
APPENDIX I: SUMMARY OF COMPILE-TIME OPTIONS
[ Top ]
[ Contents ]
ACUCNTRL
Select BSD 4.3-style
aegis
Build for Apollo Aegis (predefined on Apollo systems).
AIX370
Build for IBM AIX/370 for IBM mainframes.
AIXESA
Build for IBM AIX/ESA for IBM mainframes.
AIXPS2
Build for IBM AIX 3.0 for PS/2 series (never formally released).
AIXRS
Build for IBM AIX 3.x on RS/6000.
AIX41
Build for IBM AIX 4.x on RS/6000.
AMIGA
Build for Commodore Amiga with Intuition OS.
ATT6300
Build for AT&T 6300 PLUS.
ATT7300
Build for AT&T 7300 UNIX PC (3B1).
ATTSV
Build for AT&T System III or V UNIX.
AUX
Build for Apple A/UX for the Macintosh.
BIGBUFOK
OK to use big buffers - "memory is not a problem"
BPS_xxxx
Enable SET SPEED xxxx
BSD29
Build for BSD 2.9 or 2.10.
BSD4
Build for BSD 4.2.
BSD41
Build for BSD 4.1.
BSD43
Build for BSD 4.3.
BSD44
Build for BSD 4.4.
C70
Build for BBN C/70.
CIE
Build for CIE Systems 680/20.
CKCONINTB4CB
Work around prompt-disappears after escape back from CONNECT.
CKLEARN
Build with support for learned scripts.
CKLOGDIAL
Enable connection log.
CKMAXPATH
Maximum length for a fully qualified filename.
CKREGEX
(misnomer) Include [...] or {xxx,xxx,xxx} matching in
CKSYSLOG
Enable syslogging.
CK_ANSIC
Enable ANSI C constructs - prototypes, etc.
CK_ANSILIBS
Use header files for ANSI C libraries.
CK_APC
Enable APC execution by CONNECT module.
CK_CURSES
Enable fullscreen file transfer display.
CK_DSYSINI
Use system-wide init file, with name supplied by Kermit.
CK_DTRCD
DTR/CD flow control is available.
CK_FAST
Build with fast Kermit protocol defaults.
CK_FORK_SIG
UNIX only:
CK_IFRO
IF REMOTE command is available (and can run in remote mode).
CK_INI_A
System-wide init file takes precedence over user's.
CK_INI_B
User's init file takes precedence over the system-wide one.
CK_LABELED
Include support for SET FILE TYPE LABELED.
CK_LBRK
This version can send Long BREAK.
CK_LINGER
Add code to turn off TCP socket "linger" parameter.
CK_MKDIR
This version has a
CK_NAWS
Include TELNET Negotiate About Window Size support.
CK_NEWTERM
Use
CK_PAM
Include PAM authentication (might also require
CK_PCT_BAR
Fullscreen file transfer display should include "thermometer".
CK_POLL
System-V or POSIX based UNIX has
CK_POSIX_SIG
Use POSIX signal handing: sigjmp_buf, sigsetjmp, siglongjmp.
CK_READ0
CK_REDIR
Enable the REDIRECT command.
CK_RESEND
Include the RESEND command (needs
CK_RTSCTS
RTS/CTS flow control is available.
CK_SHADOW
Include support for shadow passwords (e.g. for IKSD authentication).
CK_SOCKBUF
Enable TCP socket-buffer-size-increasing code.
CK_SOCKS
UNIX only: Build with socks library rather than regular sockets
CK_SOCKS5
UNIX only: Build with socks 5 lib rather than regular sockets
CK_SPEED
Enable control-character unprefixing.
CK_SYSINI="xxxxx"
Quoted string to be used as system-wide init file name.
CK_TIMERS
Build with support for dynamically calculated packet timeouts.
CK_TMPDIR
This version of Kermit has an
CK_TTYFD
Defined on systems where the communications connection file
descriptor (ttyfd) can be passed to other processes as a
command-line argument via
CK_URL
Parse URLs as well as hostnames, etc.
CK_XONXOFF
Xon/Xoff flow control available.
CK_XYZ
Include support for XYZMODEM protocols.
CK_WREFRESH
Curses package includes
CKFLOAT=type
Floating-point data type, "double" or "float".
CKTYP_H=xxx
Force include of xxx as
CLSOPN
When hanging up a tty device, also close and reopen it.
CMDDEP
Maximum recursion depth for self-referential user-defined fn's.
COHERENT
Build for Mark Williams Coherent UNIX
CONGSPD
Define if this version has
datageneral
Build for Data General AOS/VS or AOS/VS II
DCLPOPEN
DEC_TCPIP
Build with support for DEC TCP/IP (UCX) for (Open)VMS
DGUX430
Build for DG/UX 4.30
DGUX540
Build for DG/UX 5.40
DEFPAR=x
Default parity, 0, 'e', 'o', 'm', or 's'.
DFTTY=xxx
Default communications device name.
DIRENT
UNIX directory structure to be taken from
DIRPWDRP
Prompt for password in REMOTE CWD command.
DTILDE
Include UNIX ~ notation for username/home-directory
DYNAMIC
Allocate file transfer packet buffers dynamically with malloc.
ENCORE
Build for Encore Multimax computers.
EXCELAN
Build with excelan TCP/IP.
FNFLOAT
Include floating-point math functions (logs, sin, cos, exp, etc)
FT18
Build for Fortune For:Pro 1.8.
FT21
Build for Fortune For:Pro 2.1.
GEMDOS
Build for Atari ST GEMDOS.
GFTIMER
Use high-precision floating-point file-transfer timers.
GID_T=xxx
Group IDs are of type xxx (usually int, short, or gid_t).
HADDRLIST
If
HDBUUCP
Build with support for Honey DanBer UUCP.
HPUX
Build for Hewlett Packard HP-UX.
HPUX9
Build for Hewlett Packard HP-UX 9.x.
HPUX10
Build for Hewlett Packard HP-UX 10.x.
HWPARITY
Define if this version can SET PARITY HARDWARE { EVEN, ODD...}
I386IX
Build for Interactive System V R3.
IFDEBUG
Add IF stmts "if (deblog)" before "
INADDRX
TCP/IP
INTERLAN
Build with support for Racal/Interlan TCP/IP.
ISDIRBUG
System defs of S_ISDIR and S_ISREG have bug, define ourselves.
ISIII
Build for Interactive System III.
IX370
Build for IBM IX/370.
KANJI
Build with Kanji character-set translation support.
LCKDIR
UUCP lock directory is /usr/spool/uucp/LCK/.
LFDEVNO
UUCP lockfile name uses device numbers, as in SVR4.
LINUXFSSTND
For Linux, use FSSTND UUCP lockfile conventions (default).
LOCK_DIR=xxx
UUCP lock directory is xxx (quoted string).
LOCKF
Use
LONGFN
BSD long filenames supported using
LYNXOS
Build for Lynx OS 2.2 or later (POSIX-based).
MAC
Build for Apple Macintosh with Mac OS.
MATCHDOT
Make wildcards match filenames that start with period (.)
MAXRP=number
Maximum receive-packet length.
MAXSP=number
Maximum send-packet length.
MDEBUG
Malloc-debugging requested.
MINIDIAL
Minimum modem dialer support: CCITT, Hayes, Unknown, and None.
MINIX
Build for MINIX.
MIPS
Build for MIPS workstation.
MULTINET
Build with support for TGV MultiNet TCP/IP (VAX/VMS).
M_UNIX
Defined by SCO.
NAP
The
NAPHACK
The
NDIR
BSD long filenames supported using
NDGPWNAM
Don't declare
NDSYSERRLIST
Don't declare
NEEDSELECTDEFS
NETCMD
Build with support for SET HOST /COMMAND and PIPE commands.
NEXT
Build for NeXT Mach 1.x or 2.x or 3.0, 3.1, or 3.2.
NEXT33
Build for NeXT Mach 3.3.
NOANSI
Disable ANSI C function prototyping.
NOAPC
Do not include CK_APC code.
NOARROWKEYS
Exclude code to parse ANSI arrow-key sequences.
NOB_xxxx
Disable SET SPEED xxxx
NOBIGBUF
Override BIGBUFOK when it is the default
NOBRKC
Don't try to refer to t_brkc or t_eof tchars structure members.
NOCKFQHOSTNAME
Exclude code to get fully qualified hostname in case it causes core dumps.
NOCCTRAP
Disable Control-C (SIGINT) trapping.
NOCKSPEED
Disable control-prefix removal feature (SET CONTROL).
NOCKTIMERS
Build without support for dynamic timers.
NOCKXYZ
Overrides CK_XYZ.
NOCKREGEX
Do not include [...] or {xxx,xxx,xxx} matching in
NOCMDL
Build with no command-line option processing.
NOCOTFMC
No Close(Open()) [serial-port-device] To Force Mode Change (UNIX).
NOCSETS
Build with no support for character set translation.
NOCYRIL
Build with no support for Cyrillic character set translation.
NOCYRILLIC
Ditto.
NODEBUG
Build with no debug logging capability.
NODIAL
Build with no DIAL or SET DIAL commands.
NODISPO
Build to always refuse incoming MAIL or REMOTE PRINT files.
DNODISPLAY
Build with no file-transfer display.
NOESCSEQ
Build with no support for ANSI escape sequence recognition.
NOFAST
Do not make FAST Kermit protocol settings the default.
NOFDZERO
Do not use file descriptor 0 for remote-mode file transfer.
NOFILEH
Do not #include
NOFLOAT
Don't include any floating-point data types or operations.
NOFRILLS
Build with "no frills" (this should be phased out...)
NOFTRUNCATE
Include this on UNIXes that don't have
NOGETUSERSHELL
Include this on UNIXes that don't have
NOGFTIMER
Don't use high-precision floating-point file-transfer timers.
NOHEBREW
Build with no support for Hebrew character sets.
NOHELP
Build with no built-in help.
NOIKSD
Build with IKSD support excluded.
NOINITGROUPS
Include this on UNIXes that don't have
NOICP
Build with no interactive command parser.
NOJC
Build with no support for job control (suspend).
NOKANJI
Build with no support for Japanese Kanji character sets.
NOKVERBS
Build with no support for keyboard verbs (\Kverbs).
NOLATIN2
Build with no ISO Latin-2 character-set translation support.
NOLEARN
Build with no support for learned scripts.
NOLINKBITS
Use of S_ISLNK and _IFLNK untrustworthy; use
NOLOCAL
Build without any local-mode features: No Making Connections.
NOLOGDIAL
Disable connection log.
NOLOGIN
Build without IKSD (network login) support.
NOLSTAT
Not OK to use
NOMDMHUP
Build without "modem-specific hangup" (e.g. ATH0) feature.
NOMHHOST
Exclude the multihomed-host TCP/IP code (if compilation errors)
NOMINPUT
Build without MINPUT command.
NOMSEND
Build with no MSEND command.
NONAWS
Do not include TELNET Negotiate About Window Size support.
NONET
Do not include any network support.
NONOSETBUF
(See NOSETBUF)
NOPARSEN
Build without automatic parity detection.
NOPIPESEND
Disable file transfer using pipes and filters.
NOPOLL
Override CK_POLL definition.
NOPOPEN
The
NOPRINTFSUBST
Don't implement printf/fprintf/perror subsitutes,
which are needed only for IKSD.
NOPURGE
Build with no PURGE command.
NOPUSH
Build with no escapes to operating system.
NOREALPATH
In UNIX,
NORECALL
Disable the command-recall feature.
NOREDIRECT
Disable REDIRECT command.
NORENAME
Don't use
NORESEND
Build with no RESEND command.
NORETRY
Build with no command-retry feature.
NOSCRIPT
Build with no SCRIPT command.
NOSELECT
Don't try to use
NOSERVER
Build with no SERVER mode and no server-related commands.
NOSETBUF
Don't make console writes unbuffered.
NONOSETBUF
DO make console writes unbuffered.
NOSETREU
NOSHOW
Build with no SHOW command (not recommended!).
NOSIGWINCH
Disable SIGWINCH signal trapping.
NOSPL
Build with no script programming language.
NOSTAT
Don't call
NOSYMLINK
Include this for UNIXes that don't have
NOSYSIOCTLH
Do not #include
NOSYSTIMEH
Co not include
NOSYSLOG
Disable syslogging code.
NOTCPOPTS
Build with no SET TCP options or underlying support.
NOTLOG
Build with no support for transaction logging.
NOTM_ISDST
Struct tm has no tm_isdst member.
NOUNICODE
Build with no support for Unicode character-set translation.
NOURL
Don't parse URLs
NOUUCP
Build with no UUCP lockfile support (dangerous!).
NOWARN
Make EXIT WARNING be OFF by default (otherwise it's ON).
NOWREFRESH
Override built-in definition of CK_WREFRESH (q.v.).
NOXFER
Build with no Kermit or other file-transfer protocols.
NOXMIT
Build with no TRANSMIT command.
NOXPRINT
Disables transparent print code.
OLDMSG
Use old "entering server mode" message (see
OLINUXHISPEED
Build in old Linux hi-serial-speed code (for Linux <= 1.0).
OPENBSD
Build for OpenBSD.
OS2
Build for OS/2.
OSF
Build for OSF/1.
OSFPC
Build for OSF/1 on a PC.
OSF32
Digital UNIX 3.2 or later.
OSF40
Build for Digital UNIX 4.0.
OSF50
Build for Digital UNIX 5.0.
OSK
Build for OS-9.
OXOS
Build for Olivetti X/OS 2.3.
PCIX
Build for PC/IX
PID_T=xxx
Type for pids is xxx (normally int or pid_t).
POSIX
Build for POSIX: use POSIX header files, functions, etc.
_POSIX_SOURCE
Disable non-POSIX features.
PROVX1
Build for Venix 1.0 on DEC Professional 3xx.
PTX
Build for Dynix/PTX
PWID_T=xxx
RBSIZ=xxx
Define overall size of receive-packet buffer (with DYNAMIC).
RDCHK
RENAME
RTAIX
Build for AIX 2.2.1 on IBM RT PC.
RTU
Build for Masscomp / Concurrent RTU.
SAVEDUID
BSD or other non-AT&T UNIX has saved-setuid feature.
SBSIZ=xxx
Define overall size of send-packet buffer (use with DYNAMIC).
SDIRENT
Directory structure specified in
SELECT
SELECT_H
Include
SETEUID
BSD 4.4-style
SIG_V
Type for
SIG_I
Type for
SOCKOPT_T
Override default data type for
SOLARIS
Build for Solaris.
SOLARIS25
Build for Solaris 2.5 or later.
SONYNEWS
Build for Sony NEWS-OS.
STERMIOX
STRATUS
Build for Stratus VOS.
STRATUSX25
Include Stratus VOS X.25 support.
SUN4S5
Build for SUNOS 4.x in the System V R3 environment.
SUNOS4
Build for SUNOS 4.0 in the BSD environment.
SUNOS41
Build for SUNOS 4.1 in the BSD environment.
SUNX25
Build with support for SunLink X.25.
SVR3
Build for AT&T System V Release 3.
SVR3JC
Allow job control support on System V Release 3 UNIX versions.
SVR4
Build for AT&T System V Release 4.
SW_ACC_ID
UNIX only -- swap real & effective ids around
sxaE50
Build for PFU Compact A Series SX/A TISP.
SYSLOGLEVEL=n
Force syslogging at given level.
SYSTIMEH
Include
SYSUTIMEH
Include
TCPSOCKET
Build with support for TCP/IP via Berkeley sockets library.
TERMIOX
TNCODE
Include TELNET-specific code.
TOWER1
Build for NCR Tower 1632 with OS 1.02.
TRS16
Build for Tandy 16/6000.
UID_T=xxx
Type for uids is xxx (normally int or uid_t).
UNIX
Must be defined for all UNIX versions.
UNIX351M
AT&T UNIX 3.51m on the AT&T 7300 UNIX PC.
USE_ARROWKEYS
Include code to parse ANSI arrow-key sequences.
USE_LSTAT
OK to use
USE_MEMCPY
Define this if
USE_STRERROR
Define this if
USLEEP
UTEK
Build for Tektronix workstations with UTEK OS.
UTIMEH
Include
UTS24
Build for Amdahl UTS 2.4.
V7
Build for Version 7 UNIX.
V7MIN
Build a minimum-size Kermit program, about ⅐ normal size.
VMS
Build for VAX/VMS.
VOID=xxx
VOID type for functions (int or void).
VXVE
Build for CDC VX/VE 5.2.1.
WAIT_T=xxx
Type of argument passed to
WINTCP
Build with Wollongong VAX/VMS TCP/IP (implies TCPSOCKET)
WOLLONGONG
Build with Wollongong UNIX TCP/IP (implies TCPSOCKET)
XENIX
Build for Xenix (SCO, Tandy, others).
XNDIR
Support for BSD long filenames via
XYZ_INTERNAL
Support for XYZMODEM protocols is internal, not external.
ZFCDAT
Define this if
ZILOG
Build for Zilog ZEUS.
ZJDATE
Has
XPRINT
Transparent print code included in CONNECT module.
[ Top ] [ Contents ] [ C-Kermit Home ] [ Kermit Home ]