SE Toolkit Files

SE Toolkit
==========

The SE Toolkit consists of an interpreter for the SymbEL-language
and several scripts written in SymbEL for system monitoring and
data gathering.  SymbEL is an interpretive language based on C
that was created to address the need for simplified access to
data residing in the SunOS kernel. The functionality is a subset
of DTrace where kernel state can be inspected but not dynamically
configured. Please keep in mind that the SE Toolkit started
10 years before DTrace.


Compatibility
-------------

SE provides access to the Solaris kernel which has changed
quite a lot over the past years. For older versions of Solaris
specific releases of the SE Toolkit must be used according
to the following table:

   Solaris     | 2.3 | 2.4 | 2.5 |2.5.1| 2.6 |  7  |  8  |  9  | 10 
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- | --- |32*64|32/64|32/64|   64
   3.5.1   x86 | --- | --- | --- | --- | --- |32*  |32   |32   |32/64
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- | --- |32*64|32/64|32/64|   64
   3.5.0   x86 | --- | --- | --- | --- | --- |32*  |32   |32   |32/64
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- | --- |--*64|--/64|--/64|   64 
   3.4.1   x86 | --- | --- | --- | --- | --- |32*  |32   |32   |32/--
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- | --- |--*64|--/64|--/64|   64
   3.4     x86 | --- | --- | --- | --- | --- |32*  |32   |32   |32/--
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- | --- |--/64|--/64|--/64| ---
   3.3.1   x86 | --- | --- | --- | --- | --- | --- | --- | --- | ---
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- | --- |--/64|--/64|--/64| ---
   3.3     x86 | --- | --- | --- | --- | --- | --- | --- | --- | ---
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- |32   |32/64|32/64| --- | ---
   3.2.1   x86 | --- | --- | --- | --- |32   |32   |32   | --- | ---
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- |32   |32/64|32/64| --- | ---
   3.2     x86 | --- | --- | --- | --- |32   |32   |32   | --- | ---
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- | --- | --- |32   |32/64|32p64| --- | ---
   3.1     x86 | --- | --- | --- | --- |32   |32   |32p  | --- | ---
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc | --- | --- |32   |32   |32   | --- | --- | --- | ---
   3.0     x86 | --- | --- |32   |32   |32   | --- | --- | --- | --- 
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   SE    Sparc |32   |32   |32   | --- | --- | --- | --- | --- | ---
   2.5     x86 | --- |32   |32   | --- | --- | --- | --- | --- | ---
   ------------+-----+-----+-----+-----+-----+-----+-----+-----+-----
   
     32/64 = Works on both 32 and 64 bit kernel
     32/-- = Works on 32 bit kernels only. Does not work on 64 bit kernel
     --/64 = Works on 64 bit kernels only. Does not work on 32 bit kernel
     32    = Works on OS, which has only 32 bit mode
        64 = Works on OS, which has only 64 bit mode
      ---  = Does not work on this OS release

     __*__ = May work, but is not tested
     __p__ = Works with supplied patch

Starting with SE Toolkit 3.4.1 the sourcecode has been
published under GPL. Earlier versions are provided in
binary form only.
For information on running old versions on old Solaris releases
see the original information on the original webpages at
  http://web.archive.org/web/*/http://setoolkit.com


Binary Distributions
--------------------

Binary distributions are available from the SourceForge project
site at

  http://sourceforge.net/projects/setoolkit

or as a OpenCSW package 'CSWsetoolkit'. For more information, see

  http://www.opencsw.org/packages/setoolkit


Bug Reporting
-------------

Please report bugs to the bugtracker (preferred) at

  http://sourceforge.net/projects/setoolkit

or write an email to

  setoolkit-bugs@lists.sourceforge.net

If the problem includes a core dump, please provide instructions on how
to get at the core file or create a bug report at the "Tracker" section at
SourceForge and upload the corefile.  The core file should be from a run of "se",
not the script, so if you have a #! at the top of the file and are
running the script, generate the core file by running "se script-name".

IMPORTANT: Because the sourcecode for versions prior to 3.4.1 is not available
there will be no support and no bugfixing for old releases.


Orcallator
----------

Orcallator is a data measurement tool that measures almost every
system statistics on Solaris (both SPARC and x86) systems thanks to
the SE toolkit. It works in conjunction with Orca, which takes the
raw data and generates all sorts of useful plots for you to examine.

For more information, see

    http://www.orcaware.com/orca/
    http://www.opencsw.org/packages/orca

For a demonstration of the plots generated, see

    http://www.orcaware.com/orca/docs/orcallator.html
    http://www.orcaware.com/orca/orca-example/