NAME

objectwatcher − list data objects allocated/deallocated in X11/NeWS since this command was last run. 

SYNOPSIS

objectwatcher

DESCRIPTION

objectwatcher is a Unix Bourne shell script that prints a formatted summary of data objects allocated and deallocated in X11/NeWS since the command was last run. 

This tool uses the X11/NeWS operator objectdump and the objectdiff command.  Each time objectwatcher is run, the current snapshot of the server obtained from objectdump is left in the file /tmp/objects.latest for future comparisons. 

The first time objectwatcher is run, there is usually no objects.latest file in /tmp.  This results in no output.  If an objects.latest file exists in /tmp from a run of objectwatcher on a previous server, the output should be ignored as it is comparing different servers. 

The output from objectwatcher is in the following format:

   nnnnn bytes for  mmm object_type objects

The output is sorted from the largest memory size allocated at the top to the smallest size allocated or the largest size freed at the bottom. There is a total-line at the end:

   nnnnn bytes for  mmm TOTAL objects

The object_types are the same as those used for the output from objectdump. 

EXAMPLES

To find the number of objects allocated/deallocated during some operation, set up the environment to test the operation in question.  Execute objectwatcher to flush information about data objects allocated so far.  Execute the operation in question.  Execute objectwatcher again.  The output indicates what allocations and deallocations of data objects occurred during processing of the operation:

example% objectwatcher
    % empty output or difference from last run
example% psh
executive
/Var 1 def
quit
example% objectwatcher
    % report of objects created or destroyed during the operation

SEE ALSO

objectdiff(1)

Sun Release 4.0  —  Last change: 15 June 1989