k5jb.k28.txt (and preface in unix.note)

Version k28 of the K5JB NET kit is a complete set of Unix and Coherent source 
code files for the KA9Q NET (pre NOS TCP/IP).  It is NOT necessary to get 
version k27, or earlier, source files to have a complete kit, but it IS 
necessary to get k5jb.bm.tar.Z to have a coordinated version of the mailer, 
BM.  Changes to the documentation since 12/25/92 are not significant enough 
to upload a replacement for k5jb.doc.tar.Z.  Thus, a complete k28 kit 
consists of:

k5jb.k28.txt   -- This file
k5jb.k28.tar.Z -- Source code for Unix KA9Q NET
k5jb.doc.tar.Z -- Documentation for same.  Unchanged.
k5jb.bm.tar.Z  -- Source code for BM, the mailer.  Unchanged.

(These files on ucsd.edu are either in /hamradio/packet/tcpip/incoming, or in 
/hamradio/packet/tcpip/k5jb.)

                        Brief description of Unix NET

NET is designed as an MS-DOS application, so does not make full use of Unix's 
multi-tasking ability but runs quite well in Unix.  You can use it in a Unix 
windowing environment (or in shell layers) but you must prevent blocking on 
input if you make the window session inactive.  See the doc on how to do 
this.  Also, a casual user shouldn't shell out of NET for an extended period 
of time, as NET suspends operation during shell escapes.  If you operate a 
heavily used machine, use your system's background methods and switch to 
another terminal session to do other things.

If you are unfamiliar with NET (the TCP/IP suite, written by Phil Karn, KA9Q, 
and preceding his current project, NOS), you need to break out the files in 
k5jb.doc.tar.Z and browse them.  k5jb.k28.tar.Z contains a file, unix.note, 
that has supplemental information that has not been incorporated into the doc 
files.  This tar also contains a file, source.note, which has modification 
information.

                          Brief description of kit

More detail on files contained in this set:

k5jb.k28.tar.Z
Contains files needed to compile NET under various System V, Release 3 
versions of Unix (I use AT&T) and under Coherent, version 4.0.1.  This file 
also contains source.note, a collection of revision notes, and unix.note for 
information specific to Unix and Coherent that I not yet included in the main 
documentation.  (This .txt file is also the preface to unix.note.) W5GFE 
compiled NET and BM under SCO Unix (80386) Sys V, release 3, both with the 
native compiler and with GNU.  Others report compiling it under various 
versions of Unix, but were not specific on versions used.

k5jb.bm.tar.Z
Contains source for Bdale's Mailer (BM).  Works with same environmental 
variables as K5JB version of NET.  Has been sanitized to prevent memory 
violations.

k5jb.doc.tar.Z
Contains NET and BM user's documentation.  Targeted for MS-DOS users, but 
contains essential Unix information.  I am not including any startup 
configuration information with the Unix kit so if you are new to this version 
of NET I strongly suggest you look at chapter0 and decide if you want to go 
on from there.  The TAPR kit contains starter information that would be 
helpful for new users.

(Footnote)  Since I uploaded k5jb.k28.tar.Z, two possible problems for
Coherent users were reported to me.  In the file, telunix.c, the line,
#include <sys/fcntl.h> may need to be changed to #include <fcntl.h>. 
The other possible problem is related to the use of the quit signal to
prepare NET for background operation under shl, the shell layer manager.
If you see a message to the effect that keyboard input is ignored...
use a Ctrl-\ to toggle the condition.  A quit signal sent to a process
from another active window may have been also received by NET.

(End of k5jb.k28.txt)