home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume26 / sps3 / part01 / README < prev    next >
Text File  |  1992-05-08  |  5KB  |  101 lines
  1.         SPS  -  Show Process Status
  2.         ===========================
  3.  
  4.  
  5. Introduction:
  6.     SPS is a intended to be used as a replacement for the standard
  7.     ps(1) program. Its advantages over ps(1) are that it shows more
  8.     useful information, that the displayed information is more
  9.     comprehensible and that it is faster.
  10.  
  11.  
  12.     SPS is currently implemented for the following operating systems and
  13.     architectures.  The corresponding Makefiles are also shown here:
  14.  
  15.     Makefile.4.1        Standard 4.1bsd for Vax
  16.     Makefile.4.2        Standard 4.2bsd, Ultrix 1.x for Vax
  17.     Makefile.4.3        Standard 4.3bsd (or 4.3-tahoe) for Vax
  18.     Makefile.4.3+NFS    4.3bsd+NFS from Wisconsin (Mt. Xinu?, others?)
  19.     Makefile.sun.2.0    Sun 4.2 UNIX Release 2.0 - 2.2 for Sun-2
  20.     Makefile.sun.3.0    Sun 4.2 UNIX Release 3.0 for Sun-2, Sun-3
  21.     Makefile.sun.3.2    Sun 4.2 UNIX Release 3.2 for Sun-2, Sun-3
  22.     Makefile.sun.4.0    SunOS 4.0 for Sun-2, Sun-3, Sun-4
  23.     Makefile.sun.4.0+386i    SunOS 4.0 for Sun 386i
  24.     Makefile.sun.4.1    SunOS 4.1 for Sun-2, Sun-3, Sun-4
  25.     Makefile.sun4.3.2    SunOS Sys 4-3.2 for Sun-4
  26.     Makefile.ultrix.2.0    DEC Ultrix 2.0 - 2.2
  27.     Makefile.ultrix.3.0    DEC Ultrix 3.0
  28.     Makefile.ultrix.4.0    DEC Ultrix 4.x
  29.  
  30.     (I also have a somewhat ancient implementation for V7 on a PDP-11 as well
  31.     as Unisoft Version 1.3 on a MC68000 if anyone is interested).
  32.  
  33.  
  34. What SPS does:
  35.     SPS displays wait channels symbolically, rather than as hexadecimal
  36.     addresses.  (If you wish to teach SPS about a new sort of device,
  37.     you must add an entry in the symbol table (globals2.c) as well as
  38.     increasing the size of that table (NWAITSTATE in sps.h)).
  39.  
  40.     SPS sorts processes before listing them, the order reflecting the
  41.     relationship of the processes.  A child process is listed
  42.     underneath its corresponding parent and is indented to depict the
  43.     exact relationship.  SPS also indicates setuid processes.
  44.  
  45.     SPS displays such values as the resident and virtual sizes of
  46.     system processes.  It accepts a whole range of options to control
  47.     the output.  By default, SPS lists information about one's own
  48.     processes.  Other options instruct it to be verbose (the "v"
  49.     option), to list all the command arguments of a process (the "w"
  50.     option) or to list the environment strings of that process (the "e"
  51.     option).  Similarly, there are options to control which processes
  52.     are to be displayed.  The "a" option tells it to describe all
  53.     processes and the "b" option tells it to describe "busy" processes;
  54.     the latter is useful if you wish to find out what is loading your
  55.     system.  There are also options to select the output according to
  56.     user, controlling tty or process number.
  57.  
  58.     SPS keeps its information in an information file; by default, this
  59.     is /tmp/.spsinfo. This means that it can avoid having to do an
  60.     expensive nlist() operation each time it is run.  It must be
  61.     reinitialised (with the "i" option) if new users are added to
  62.     /etc/passwd or if a new version of /vmunix is installed.
  63.  
  64.  
  65. How to build SPS:
  66.     1. In order to compile and install SPS, first unbundle the three shell
  67.        archive files.
  68.     2. Check that the define statements in sps.h are large enough for
  69.        your system.  In particular, you may need to increase MAXTTYS
  70.        to reflect the number of tty devices in /dev.  The parameter
  71.        MAXUSERS defines the maximum number of users defined in the
  72.        password file (or through the Yellow Pages).  Because the
  73.        user-ids are held in an internal hash table, this should
  74.        probably be at least double the number of actual users.
  75.     3. Choose an appropriate Makefile from the table above and compile
  76.        the source files.  For example:
  77.        % make -f Makefile.sun.3.2
  78.     4. Try running SPS.  First, a suitable information file must be
  79.        initialised.  It should then be able to display information
  80.        concerning running processes on your system:
  81.          # Initialise SPS.  Ignore any error messages at this stage.
  82.        % sps i
  83.          # Instruct SPS to list all active processes in verbose format.
  84.        % sps va
  85.     5. If this all works, install SPS with the appropriate Makefile
  86.        and reinitialise it:
  87.        % make -f Makefile.sun.3.2 install
  88.        % sps -i
  89.  
  90.  
  91. Bug reports:
  92.     Send all bug reports, fixes, comments and suggestions to Robert Ward at -
  93.  
  94. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  95.     J. Robert Ward,
  96.     Olsen & Associates AG, Seefeldstrasse 233, CH-8008 Zuerich, Switzerland
  97.  
  98. Tel.:   +41 1 552224           Fax: +41 1 552282
  99. Email:  robert@olsen.ch        Uucp:  uunet!olsen!robert
  100. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  101.