
top 3.4 for MacOS X Server README
Version 1.2
May 9, 1999
============================================

This document describes the steps necessary to get top
version 3.4 running for MacOS X server.  The system
described requires an original top-3.4 distribution plus 
2 MacOS patch files and a separate machine-specific file.

Installation
============

U can just install the binary and man page, by becoming root and
run the install.sh script

# install.sh

To build top-3.4 for yourself, you will need the following
things:
	
	1) the original distribution of top-3.4 (included)
	2) the MacOS X utils.c patch
	3) the m_macosx.c file
        4) MacOS X Makefile patch

Unpack the normal top distribution into the directory of
your choice.  

Once this is done, copy the m_macosx.c file
into the machine directory where you unpacked the source. 

i.e. % cp m_macosx.c top-3.4/machine/

Apply the MacOS patch.  Follow the normal build instructions
by picking macosx from the list of available modules.

i.e. % patch top-3.4/utils.c < macosx.patch

Now, cd to the top 3.4 distribution, and run Configure

i.e. % cd top-3.4
     % ./Configure

Some changes to the default values, the mod for top should be 4755 instead
of 2755, and /usr/share/man/man1 should be man path.

There is one additional thing which must be done before the
build of top will work.  The generated makefile must be
edited to remove the references to -ltermcap and -lm which
don't exist.

I make a patch to make it easy.

(Assume u're at the top-3.4 directory)
% patch Makefile < ../Makefile.patch

You should now be able to build top-3.4 for MacOS X by
typing 'make'.


Credits
=======

Based on works of Andrew S. Townley.

More info on this port of top, pls refer to Andrew's original README at
README.orig.

Timothy S.H. Chong
chongt@computer.org
chongt@bah.com (MIME | NeXTmail OK!)
