This file contains instructions for compiling and using MiNT-Net.
For more general information about MiNT-Net, see the file README
in this directory.

This package contains already compiled versions of the libraries
and the socket device driver for people who are not willing or
able to compile the stuff. If you are one of them you can ignore
the following instructions about compiling.

Things needed for compiling:
----------------------------

o	tar and gzip to unpack the archive (bit silly this one since you
	are reading this file).

o	gcc, preferably 2.3x, since later versions have been reported
	to be buggy, at least when using -mbaserel.

o	gmake, preferably 3.6x or later.

o	binutils PL >= 30.

o	MiNTLibs PL >= 41, because as of PL 41 they support the
	socket library in errno.h and strerror(). If you don't mind
	getting messages like 'unknown error' from perror(), you can
	use earlier versions too.

o	Minixfs or something similar that supports long filenames. This
	is not absolutely neccessary, but there are some filenames that
	do not fit into the 8+3 filename scheme.

Rebuilding the library and device driver:
-----------------------------------------

Edit MakeVars to reflect your setup.

It is easiest to rebuild the whole package by typing
(1)	make clean
(2)	make depend
(3)	make
into the top level directory. This will rebuild the socket device
driver and all the libraries as necessary. (1) deletes all .o files
from previous compilations. (2) generates the dependency-files that
tell make which files need to be rebuilt when changing one particular
file.

Of cource you can 'cd' to one particular subdirectory and remake only
parts of the package. Please have a look at the Makefiles.

You should get the following binaries out of the above steps:
lib/socket.olb		-- 32 bit socket library.
lib/socket16.olb	-- 16 bit socket library.
lib/bsocket.olb		-- 32 bit -mbaserel socket library.
lib/bsocket16.olb	-- 16 bit -mbaserel socket library.
net/sockdev.xdd		-- socket device driver.
tool/netstat		-- netstat(8) utility.
tool/route		-- route(8) utility.
tool/ifconfig		-- ifconfig(8) utility.
tool/slattach		-- slattach(8) utility.
tool/iflink		-- iflink(8) utility.

Installing the libraries and the device driver:
-----------------------------------------------

Type 'make install' into the toplevel MintNet directory. Cd to
the 'man' directory and type 'make install' to install the manuals.

Give your host a name by writing it to the file /etc/hostname.
Choose an IP address for this host. Lets say you choose
100.0.0.1 for the address and kermit for the name.
Then add the following line to /etc/hosts:

100.0.0.1	kermit

Supposed you are in the domain muppets.org, change the `domain'
line in the /etc/resolv.conf to

domain muppets.org

Run the /etc/rc.net script from mint.cnf or from /etc/rc or
form /etc/rc.local.

If you have versions of Mint before 1.08 you must build sockdev.ttp
and start that from your mint.cnf file

Puh, thats a lot to do I admit, time to write an install script ...

Getting information about socket and network programming:
---------------------------------------------------------

You can obtain information about using the facilities provided by
this package by having a look at the manual pages in the man sub-
directory. You could also get the texinfo manual from the GNU-C
library or a good book, like

o Comer, Stevens: `Internetworking with TCP/IP I-III'.

o Leffler, McKusick, Karels, Quaterman: `4.3 BSD Unix -- Design and
	Implementation'

o Santifaller: `TCP/IP und NFS in Theorie und Praxis'

o Loosemore, McGrath, Oram, Stallman: `The GNU C Library Reference Manual'

o RFCs 786(UDP), 790(assigned numbers), 791(IP), 792(ICMP), 793(TCP),
	1055(SLIP), 1122(Host Rquirements), 1331(PPP)


Please report any bugs, problems, incompatibilities, suggestions, thanks, ...
to roemer@hera.rbi.informatik.uni-frankfurt.de.

Thank you.


Have fun -- Kay Roemer.
