Linux Binary Readme
-------------------

This is a pre-compiled binary distribution of the treeps 1.1
package for Linux. This particular package was built and
is known to run on:


	Linux 2.0.34	   - Red Hat 5.1 ( Motif2.0, LessTif-0.88.1 )


Recent Changes
--------------

Please see  doc/ChangeLog-1.1

Quick_start
-----------

	su root
	    ./install_treeps
	    exit
	treeps


Note: 	If you are running against a lesstif library, then you *MUST* 
	install the lesstif resource file found in Res/linux. Copy it 
	to app-defaults/Treeps or to $HOME/Treeps. There are still a 
	couple of LessTif related issues, so it's better to get a
	package with the motif libs statically linked in.

Security
--------

Note: The program is now installed setuid to root, this enables

                running renice to decrease nice value
                trace process system calls
                view some details on processes not owned by current user:

                        CWD, exe, fds, ...

             As with any setuid program there is an opportunity for
             security violations. I have taken precautions to prevent this
             i.e. using absolute paths ..., but if you are installing
             on a multiuser system you may want to make it non-suid. The
             program will still function, except the above features won't
             work(it generates appropriate error messages).

Compatable Linux Versions
-------------------------

The extent of the Linux versions that this binary will run on are unknown, 
notifications of non-compatible versions would be appreciated.



Statically Linked
-----------------

You either got a statically, or dynamically linked executable.
The statically linked file, is linked with all of the
required libraries, so it is quite large.



Required Dynamic Libraries
--------------------------

If the binary is dynamically linked it will requires compatable
dynamic libraries to run with. 


In particular the result of a file(1) command is:

    ELF 32-bit LSB executable, Intel 80386, version 1, dynamically linked, 
    not stripped


The result ldd(1), is

 libMrm.so.2 => /usr/X11R6/lib/libMrm.so.2 (0x40005000)
        libXm.so.2 => /usr/X11R6/lib/libXm.so.2 (0x40021000)
        libXt.so.6 => /usr/X11R6/lib/libXt.so.6 (0x401ab000)
        libSM.so.6 => /usr/X11R6/lib/libSM.so.6 (0x401ee000)
        libICE.so.6 => /usr/X11R6/lib/libICE.so.6 (0x401f8000)
        libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x4020c000)
        libm.so.6 => /lib/libm.so.6 (0x402a3000)
        libXext.so.6 => /usr/X11R6/lib/libXext.so.6 (0x402bc000)
        libXp.so.6 => /usr/X11R6/lib/libXp.so.6 (0x402c7000)
        libc.so.6 => /lib/libc.so.6 (0x402ce000)
        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x00000000)


Documentation
-------------

The man page, treeps(1), has a brief description of the program,
in general though the online help should be sufficient.
Left Click on a process to view details(perform default action),
right clicking brings up a menu of actions.


Please read the Copyrights file



LessTif Notes
=============


You will need to add something like

        LD_LIBRARY_PATH=/usr/local/lib
        export LD_LIBRARY_PATH

to your startup scripts(.bashrc), to allow the treeps
application to find the LessTif version of the Motif
library.


LessTif Specific Bug
--------------------

  The color bar does not work properly under LessTif,
  please use the LessTif specific X resource file.


