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

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


	Linux 2.0.34	   - Red Hat 5.1 - 7.1( Motif1.2 )


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

	su root
	    ./Setup
	    exit
	treeps

Installing
----------

This release of treeps uses an install mechanism called Setup
which performs more steps than a typical install. This includes
installing: 

	Executable programs
	Run time scripts
	Icons of various depths/sizes
	X Resource files
	Documentation 
	....

The Setup script also integrates the application into
various desktops, running installers if required.

The location of installed files can be changed by editing the
Install.params file. If you change the location of the icon
files then you will also need to set the corresponding X resource
so that the program can find it's icons.

The program can be installed either setuid root or not. It provides
greater functionality when setuid root(the default), but there is
an increase in security risk when doing so. If you are running
a multi-user system you may want to change the default setting
in the Install.params file. More details on security below and
in doc/Security. 


Uninstalling
------------

When installed via Setup an uninstall program is created that
will remove all files and deregister treeps from the various 
desktops ... To run the the uninstaller, cd to the LIBDIR directory as
defined in Install.params and run ./uninstall

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(or perform the current 
default action), right clicking brings up a menu of actions.


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

Please see  doc/ChangeLog-1.2.1

Security
--------

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

                Running renice to decrease nice value(some systems)
                Trace system calls on your processes
                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).

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

Binary packages come in various forms. The binary packages are compiled
against Motif. Thus the smallest executable which is not statically
linked with any libraries requires that you have Motif. The statically
linked executable is for those who do not have Motif. An executable
with just the Motif libs statically linked is provided and may
be the best for your platform, it will save you a lot of space and
therefore is probably the best one to try first.


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)


Please read the Copyrights file


