*** This version of yamm compiles under HPUX and Linux ***
                                        ^^^^^^^^^^^^^^

NOTE TO NON-SUPPORTED OSs USERS:

This is *extremely* unlikely to work on NON-SUPPORTED systems,
without hard reworking (read: porting) of the code !
If anyone make a porting of this program on unsupported platforms, let the
author know.
For porting, read the doc/README.porting

HOW-TO-INSTALL:

* Binaries:

You can find binaries for Linux and HPUX in the bin/ directory.
If you want re-compile the package, or if you have a version of ncurses
different from 1.8.6, and you need to re-compile, go to configuration section.

* Makefile and configuration:

/*
 * There is a new top level Makefile, but it is not guaranteed that it works.
 * If it don't work for you, please send me a report, and
 * #define _do_it_the_slow_way
 */
#undef _do_it_the_slow_way

#if defined(_do_it_the_slow_way)
 - Change directory to src/
 - run Configure and answer some questions
 - double check the Makefile just to be sure all is ok
 - do not forget to pray :)
 - report any bug you find in this script :))
#else
 - Use the top level Makefile. Do 'make' and it will Configure+make all.
   (make install to Configure+make all+make install all)
#endif /* _do_it_the_slow_way */

* To compile:

>>> Linux <<<

you need to have the linux source tree, configured and compiled. To speed
up the things you may want to:

chdir to kernel sources (usually /usr/src/linux/)
make config
make dep

#if (KERNEL_VERSION < 1.1.74)
make tools/version.h
#else
make include/linux/version.h
#endif

This should be enought for yamm compilation.

>>> end Linux <<<

chdir to yamm top level directory

make

To install:

make install

Notes:

* Whenever you upgrade the kernel sources, you have to recompile che
  drv_yamm.o module of course. To speed up things now you may want to
  chdir to the top level source directory and:
  make clean
  make install_module
* Remember that yamm now needs the Linux kernel sources installed and configured
  To do that you should install the kernel sources of the current running
  kernel, then you should chdir to the kernel (usually /usr/src/linux),
  then do the things explained in the paragraph (* To compile)
* Remember that to run the modular yamm you need to have a /dev/yamm,
  created by make, and the drv_yamm.o loaded in memory.
  /dev/yamm is a device with MAJOR=29 and MINOR=0
  drv_yamm.o need to be loaded and linked into the kernel with the
  command 'insmod drv_yamm.o' (to use it you need to install the package
  modules.tar.gz that you can find in the kernel directory in any linux
  ftp site).
* Now yamm supports the new loadable module version strategy, present in
  kernels > 1.1.86, you need modules-1.1.87.tar.gz package, which include
  depmod, modprobe, insmod, genksyms programs.
* Doesn't need to be run setuid'ed or setgid'ed to return info.
* Now the program have a man page.
* yamm is recommended instead of top: it seems to offer some neat stats
  that top can't.

- riccardo -
