Welcome to the Linux module utilities.

This release represents an almost complete rewrite of the utilities
compared to "modules-2.0.0", as well as a lot of "modutils-2.1.121".

The goals of these rewrites were to clean out accumulated kruft
(e.g. a.out isn't used anymore), make it easier to support different
architectures, improving performance and adding some new features.

These utilities are intended primarily for use with kernels 2.1.18
and above.  They do fall back on a compatibility mode when used with
2.0.x kernels so that multiple sets of binaries are not needed when
switching between the two series.

If you are planning on using the 2.2.x kernel line, it is a good idea
to install this package, especially since the improvements in the kernel
are definitely much better supported by this 2.2.2 release.


INSTALLATION
============

First of all, remember to remove the old man pages in section 1!
They are (usually) stored in the /usr/man/man1 directory.
The new man pages for the utilities are now located in section 8:

	depmod.8	genksyms.8	insmod.8	kerneld.8
	ksyms.8		lsmod.8		modinfo.8	modprobe.8
	rmmod.8

The next step is to run the configure script by entering the command:

	./configure

The build process uses the configure script to figure out a few things
about your system before actually compiling anything. Configyre takes
several command line options which can modify the installation
paths. Try './configure --help' for more information. (Minor note:
--exec-prefix defaults to / not /usr if not specified.)

The second step is to actually compile and install the utilities. Do
'make install' in this directory to get the following tools:

insmod/
	insmod		install a loadable module
	rmmod		remove module(s)
	ksyms		show symbols
	lsmod		show modules
	modinfo		display information about module
	modprobe	load (a stack of) modules, controlled by a "makefile"
			and a configuration file.

genksyms/
	genksyms	version generator for module symbols,
			to be run automatically during kernel make
			if CONFIG_MODVERSIONS was selected in "make config"

depmod/
	depmod		generate dependencies for modprobe.


kerneld/
	kerneld		A "user level kernel extension" that allows
			the kernel to perform some tasks in user space.
			Suitable tasks are e.g. loading of modules.


Richard Henderson <rth@cygnus.com>
Bjrn Ekwall <bj0rn@blox.se>
