
		Installation and Release Notes for NET-2

			Base Utilities Distribution

			Version: 0.33 NET-2 Rev.E

		      Sun, 29 Jan 23:00:00 1994 MET


			    Fred N. van Kempen,

			    <waltje@aris.com>
		       <waltje@uwalt.nl.mugnet.org>



PREFACE
This document describes the contents of the NET-2 "Base Distribution"
of the NET-2 network package for the Linux operating system.  Read it
carefully, and, when you encounter problems, also read the "NET-2 HOWTO"
that has been added to this distribution, see the file called "HOWTO".

If you cannot find it there, send electronic mail to:

	Terry Dawson <terryd@extro.ucc.su.oz.au>

and ask for a copy of the "NET-2 HOWTO".



NETWORK PROGRAMS

NET-2 has changed a lot, so a new set of "base utilities" comes with
it.  These programs allow you to set up and maintain your network.
To compile and install:

1.  Create the directory:

	# mkdir /usr/src/commands/usr.net/net

2.  Unpack the distribution:

	# cd /usr/src/commands/usr.net/net
	# tar xfvz /tmp/net-base.tgz

3.  Make the stuff.

    If you do not have the correct configuration files at hand
    (which is the case if you are installing this package for
    the first time!), type:

	# make install

    otherwise, type

	# make firsttime

The "firsttime" installation takes the NET-2 sample config files, and
put them in their corresponding places in the file system.  It also
sets up the necessary symbolic links where needed.

Have a look at the sample config files in the net-base distribution, and
pay close attention to the "NETCONF" and/or "rc.net" files, which set up
your network.


CONFIGURATION FILES

A complete set of "sample" configuration files can be found in the
"sample" subdirectory of this package.  You can either install them
into the /etc directory, or put them in /etc/inet if you run SLS.

After installing the files, check all of them and see if you have to
change them.  Some of them are quite static (like the "services" and
"rpc" file, for example), but others may change often (like the
"hosts" and "networks" files...).

Also, pay close attention to the "NETCONF" and/or "rc.net" files.
These are the files that setup your network at boot time, and these
are the files that cause the most trouble for people.

The "rc.net" script is the one started by INIT, right after booting.
Its only job is to scan a configuration file (called /conf/net/NETCONF
or /etc/NETCONF), which in turn does basic things like setting up the
interfaces (using the /sbin/ifconfig command), and then setting up
routes to them (using the /sbin/route command).  It also takes care of
starting all kinds of daemon processes, like system servers.

Note: you *WILL* have to check these files manually !


SOURCES

The sources for all NET-2 related programs (including those of this
package, which may have reached you as a binary-only package) can be
obtained by anonymous FTP from:

	aris.com:/pub/linux/system/Network/net-2/sources/*

and by all machines that shadow this directory.  Note that the source
distributions often have somewhat more recent versions of the programs
than the binary packages, because of obvious release delays.

HISTORY

The following things changed since the previous release:

- Minor changes to the command sources to get them compile with C++.
  This is not finished yet, DIP and WdSetup still don't compile clean.

- New DIP commands: "echo" and "init".

- An even newer installation script, which was re-done (part A) by
  Johannes (John) Grosen (grosen@argv.cs.ndsu.nodak.edu).  This should
  fix a lot of problems.

- Re-format of the "netstat" program while I was changing it for the
  new NET-2e release include files.

- This archive also contains a dump of the new include files for the
  </usr/include/net> and </usr/include/netinet> directories. The makefile
  will check if you need these files (i.e. have a library older than the
  4.4.2b release).

- Changed all /etc-based binaries to live in /sbin, as per the new
  Linux/PRO and FSSTND File System Standard drafts.

- Improved /dev checking of the installation script, to cover even
  more "bug reports" about non-working "ifconfig" programs.  Grin.

- Added a simple "slattach" program, for local hardwired lines.

- Used Johannes' idea of allowing the "broadcast" and "pointopoint"
  keywords of the ifconfig(8) program to be flags, too.

- Cleaned up the netstat(1) program.

- Improved the Install and Unpack scripts.

- I started with generalizing the "base" tools to support more than
  just the standard INET (TCP/IP) protocol family, and more than the
  Ethernet hardware type (ARP !).  This because I am implementing
  the AX.25 protocol family in the kernel :-)

- SEE THE INSTALLATION NOTES BELOW ---- CONFIGURATION HAS BEEN
  CHANGED !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

- THIS IS THE "FIXED" VERSION!

- Fixed the output of ifconfig (it didn't show the HW address because
  of a stupid memcpy() address bug.)

- Updated manual pages.

- Moved the "DIP" and "WdSetup" directories to packages of their own;
  the size of this base package is getting out of hand...

- Improved the "Unpack.sh" script.

- Updated the "netstat" program.

- Added a "Configure" script to ease configuration of this package. I
  used the kernel "Configure" as a base - it works *very* well!

- Changed this file's layout.

- Improved the "Install.sh" once again.

- Changed the device driver major numbers *again* .  This should be
  the last time, if all goes well.

- Set "HWAX.25" defaulting to "YES", as KISS is now a standard driver.

- Added Johannes' "timer" fixes for "netstat".

- Various small things.

- Upgraded the sample files.  Linux/PRO no longer uses /conf/net for
  storing the network configuration files (although they can be linked
  to that directory) so all files now go into /etc.

