#!/usr/bin/perl -w # # The contents of this file are subject to the Netscape Public # License Version 1.1 (the "License"); you may not use this file # except in compliance with the License. You may obtain a copy of # the License at http://www.mozilla.org/NPL/ # # Software distributed under the License is distributed on an "AS # IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or # implied. See the License for the specific language governing # rights and limitations under the License. # # The Original Code is Mozilla Communicator client code. # # The Initial Developer of the Original Code is Netscape Communications # Corporation. Portions created by Netscape are # Copyright (C) 1998 Netscape Communications Corporation. All # Rights Reserved. # # Contributor(s): # # $Id: balance.cgi,v 1.1 1999/11/15 22:31:31 waterson%netscape.com Exp $ # # # Builds a tree of reference counts # use 5.004; use strict; use CGI; use POSIX; use Zip; $::query = new CGI(); $::opt_log = $::query->param('log'); $::opt_class = $::query->param('class'); $::opt_object = $::query->param('object'); @::opt_exclude = $::query->param('exclude'); $::opt_show_balanced = $::query->param('show-balanced'); $::opt_subtree_size = $::query->param('subtree-size'); $::opt_prune_depth = $::query->param('prune-depth'); $::opt_reverse = $::query->param('reverse'); $::opt_collapse_to_method = $::query->param('collapse-to-method'); $::opt_collapse_to_class = $::query->param('collapse-to-class'); $::opt_log || die; $::opt_class || die; $::opt_object || die; # Make sure that values get initialized properly $::opt_prune_depth = 0 if (! $::opt_prune_depth); $::opt_subtree_size = 0 if (! $::opt_subtree_size); $::opt_collapse_to_class = 0 if (! $::opt_collapse_to_class); $::opt_collapse_to_method = 0 if (! $::opt_collapse_to_method); # Sanity checks $::opt_prune_depth = 0 if $::opt_prune_depth < 0; $::opt_subtree_size = 0 if $::opt_subtree_size < 0; print $::query->header; print qq{ $::opt_class [$::opt_object] }; print $::query->h1("$::opt_class [$::opt_object]"); print "\n"; { my @statinfo = stat($::opt_log); my $when = POSIX::strftime "%a %b %e %H:%M:%S %Y", localtime($statinfo[9]); print "$when
\n"; } print "Bloat Log\n"; print "Back to Overview\n"; print "
\n"; # The 'excludes' are functions that, if detected in a particular call # stack, will cause the _entire_ call stack to be ignored. You might, # for example, explicitly exclude two functions that have a matching # AddRef/Release pair. my %excludes; { my $method; foreach $method (@::opt_exclude) { $excludes{$method} = 1; } } # Each entry in the tree rooted by callGraphRoot contains the following: # #name# This call's name+offset string # #refcount# The net reference count of this call # #label# The label used for this subtree; only defined for labeled nodes # #children# List of children in alphabetical order # zero or more children indexed by method name+offset strings. my $callGraphRoot; $callGraphRoot = { '#name#' => '.root', '#refcount#' => 'n/a' }; # The 'imbalance' is a gross count of how balanced a particular # callsite is. It is used to prune away callsites that are detected to # be balanced; that is, that have matching AddRef/Release() pairs. my %imbalance; $imbalance{'.root'} = 'n/a'; # The main read loop. my $log = new Zip($::opt_log); $log || die('unable to open log $log'); my $logfile = "refcnt-" . $::opt_class . "-" . $::opt_object . ".log"; my $handle = $log->expand($logfile); LINE: while (<$handle>) { next LINE if (! /^) { chomp; last CALLSITE if (/^$/); $stack[++$#stack] = $_; } # Reverse the remaining fields to produce the call stack, with the # oldest frame at the front of the array. if (! $::opt_reverse) { @stack = reverse(@stack); } my $call; # If any of the functions in the stack are supposed to be excluded, # march on to the next line. foreach $call (@stack) { next LINE if exists($excludes{$call}); } # Add the callstack as a path through the call graph, updating # refcounts at each node. my $caller = $callGraphRoot; foreach $call (@stack) { # Chop the method offset if we're 'collapsing to method' or # 'collapsing to class'. $call =~ s/\+0x.*$//g if ($::opt_collapse_to_method || $::opt_collapse_to_class); # Chop the method name if we're 'collapsing to class'. $call =~ s/::.*$//g if ($::opt_collapse_to_class); my $site = $caller->{$call}; if (!$site) { # This is the first time we've seen this callsite. Add a # new entry to the call tree. $site = { '#name#' => $call, '#refcount#' => 0 }; $caller->{$call} = $site; } if ($op eq 'AddRef') { ++($site->{'#refcount#'}); ++($imbalance{$call}); } elsif ($op eq 'Release') { --($site->{'#refcount#'}); --($imbalance{$call}); } else { die "Bad operation $op"; } $caller = $site; } } # Given a subtree and its nesting level, return true if that subtree should be pruned. # If it shouldn't be pruned, destructively attempt to prune its children. # Also compute the #children# properties of unpruned nodes. sub prune($$) { my ($site, $nest) = @_; # If they want us to prune the tree's depth, do so here. return 1 if ($::opt_prune_depth && $nest >= $::opt_prune_depth); # If the subtree is balanced, ignore it. return 1 if (!$::opt_show_balanced && !$site->{'#refcount#'}); my $name = $site->{'#name#'}; # If the symbol isn't imbalanced, then prune here (and warn) # XXX no symbol-level balancing; this was buggy. # if (!$::opt_show_balanced && !$imbalance{$name}) { # warn "discarding " . $name . "\n"; # return 1; # } my @children; foreach my $child (sort(keys(%$site))) { if (substr($child, 0, 1) ne '#') { if (prune($site->{$child}, $nest + 1)) { delete $site->{$child}; } else { push @children, $site->{$child}; } } } $site->{'#children#'} = \@children; return 0; } # Compute the #label# properties of this subtree. # Return the subtree's number of nodes, not counting nodes reachable # through a labeled node. sub createLabels($) { my ($site) = @_; my @children = @{$site->{'#children#'}}; my $nChildren = @children; my $nDescendants = 0; foreach my $child (@children) { my $childDescendants = createLabels($child); if ($nChildren > 1 && $childDescendants > $::opt_subtree_size) { die "Internal error" if defined($child->{'#label#'}); $child->{'#label#'} = "__label__"; $childDescendants = 1; } $nDescendants += $childDescendants; } return $nDescendants + 1; } my $nextLabel = 0; my @labeledSubtrees; sub list($$$$$) { my ($site, $nest, $nestStr, $childrenLeft, $root) = @_; my $label = !$root && $site->{'#label#'}; # Assign a unique number to the label. if ($label) { die unless $label eq "__label__"; $label = "__" . ++$nextLabel . "__"; $site->{'#label#'} = $label; push @labeledSubtrees, $site; } print $nestStr; if ($::opt_old_style) { print $label, " " if $label; print $site->{'#name#'}, ": bal=", $site->{'#refcount#'}, "\n"; } else { my $refcount = $site->{'#refcount#'}; my $l = 8 - length $refcount; $l = 1 if $l < 1; print $refcount, " " x $l; print $label, " " if $label; print ""; print $site->{'#name#'}; print "\n"; } $nestStr .= $childrenLeft && !$::opt_old_style ? "| " : " "; if (!$label) { my @children = @{$site->{'#children#'}}; $childrenLeft = @children; foreach my $child (@children) { $childrenLeft--; list($child, $nest + 1, $nestStr, $childrenLeft); } } } if (!prune($callGraphRoot, 0)) { createLabels $callGraphRoot if ($::opt_subtree_size); print "
\n";
     list $callGraphRoot, 0, "", 0, 1;
     while (@labeledSubtrees) {
         my $labeledSubtree = shift @labeledSubtrees;
         print "\n
\n", $labeledSubtree->{'#label#'}, "\n"; list $labeledSubtree, 0, "", 0, 1; } print "\n
\n" if @labeledSubtrees; print "
\n"; } # Now generate the control panel at the bottom. This needs to be "neater". print qq{
Methods to Exclude
Options }; print "Collapse To Method\n"; print "Collapse To Class\n"; print qq{
}; print $::query->end_html;