------------------------------------------------------------
Welcome ps & procinfo ReadMe
------------------------------------------------------------

Last Update 2005 April

------------------------------------------------------------
------------------------------------------------------------
Notes on Installation
------------------------------------------------------------

This two programs were created over a Linux 2.6.8.x Kernel
on x86 and PPC.
We suppose that running them over a different kernel version
(or over a different architecture) wouldn't damage your
system, but we ain't sure of their perfect compatibility.

------------------------------------------------------------
How to get help
------------------------------------------------------------

You can view a little usage help by including '-h' parameter
You can have an idea of what the single options do by
consulting the ps and procinfo manpage.

------------------------------------------------------------
Things to know to get the programs running well
------------------------------------------------------------

These two programs were made with bash scripting and they
are really slower than the ones written in C included in
your Linux Version, so be patient!!
It is a good idea to keep all the scripts concerning the
same program in the same directory.

------------------------------------------------------------
test.sh
------------------------------------------------------------

This is a little test script that calls "ps.sh" and
"procinfo.sh" with some arguments. It has to be seen as a
little "quick start tour" (like the MS Windows(TM) one :) ).


------------------------------------------------------------
ps.sh
------------------------------------------------------------

We've included all the basic options, all the selection
options, the '-l' and 'u' output format options and the
'-V'/'V' option. You can read a complete list of all
parameters executing 'ps.sh -h'.  You can use "grouped
parameters" paying attention to the '-'.
For example writing:
# ps -lNA
Will be parsed as
# ps -l -N -A
But writing:
# ps -lNa
won't be parsed as
# ps -l -N a
but as
# ps -l -N -a !!
You can, indeed, use groups of argouments composed only by
options in BSD-style or  groups composed by -options.
In the original "ps" there are some options that require
argouments like "ps U <username>", we use instead this form:
"ps U=<username>".

Our ps is composed of two files: ps.sh and ps_functions.

- ps.sh
Init some array used, calls the parser and checks for errors
in the parameters composition. After that it begins a "for"
cycle that grab informations from each directory in "/proc"
that represents a process or a kernel thread and prints a
formatted output containing only the informations specified
by parameters.

- ps_functions
The "library" file used by "ps.sh". The description of each
function is included in its declaration.


------------------------------------------------------------
procinfo.sh
------------------------------------------------------------

The usage of this script is explained by the help on line
displayed through "procinfo.sh -h".

Our program procinfo is composed of two files: procinfo.sh and 
procinfo_functions.

-procinfo.sh
Init some arrays used for parsing and calls the parsing
function. All the informations (except help and version) are
computed by the "core" function that can be invoked with a
output redirection if the "-F" options is used.

-procinfo_functions
The "library" file used by "procinfo.sh". The description of
each function is included in its declaration.

