mirror of
https://github.com/RPCS3/llvm-mirror.git
synced 2024-11-25 04:02:41 +01:00
141c4ec759
2. Fix a bug where the lib directory specified also had to be cwd 3. Weight the output so archive->archive edges are shorter 4. Generate two different graphs: one for libraries, one for objects. 5. Adjust the properties of the graphs till it looks nice. llvm-svn: 19293
129 lines
3.8 KiB
Perl
Executable File
129 lines
3.8 KiB
Perl
Executable File
#!/usr/bin/perl -w
|
|
#
|
|
# Program: GenLibDeps.pl
|
|
#
|
|
# Synopsis: Generate HTML output that shows the dependencies between a set of
|
|
# libraries. The output of this script should periodically replace
|
|
# the similar content in the UsingLibraries.html document.
|
|
#
|
|
# Syntax: GenLibDeps.pl <directory_with_libraries_in_it>
|
|
#
|
|
|
|
# Give first option a name.
|
|
my $Directory = $ARGV[0];
|
|
|
|
# Find the "dot" program
|
|
chomp(my $DotPath = `which dot`);
|
|
die "Can't find 'dot'" if (! -x "$DotPath");
|
|
|
|
# Open the directory and read its contents, sorting by name and differentiating
|
|
# by whether its a library (.a) or an object file (.o)
|
|
opendir DIR,$Directory;
|
|
my @files = readdir DIR;
|
|
closedir DIR;
|
|
@libs = grep(/libLLVM.*\.a$/,sort(@files));
|
|
@objs = grep(/LLVM.*\.o$/,sort(@files));
|
|
|
|
# Declare the hashes we will use to keep track of the library and object file
|
|
# symbol definitions.
|
|
my %libdefs;
|
|
my %objdefs;
|
|
|
|
# Gather definitions from the libraries
|
|
foreach $lib (@libs ) {
|
|
open DEFS,
|
|
"nm -g --defined-only $Directory/$lib | grep ' [ABCDGRST] ' | sed -e 's/^[0-9A-Fa-f]* [ABCDGRST] //' | sort | uniq |";
|
|
while (<DEFS>) {
|
|
chomp($_);
|
|
$libdefs{$_} = $lib;
|
|
}
|
|
close DEFS;
|
|
}
|
|
|
|
# Gather definitions from the object files.
|
|
foreach $obj (@objs ) {
|
|
open DEFS,
|
|
"nm -g --defined-only $Directory/$obj | grep ' [ABCDGRST] ' | sed -e 's/^[0-9A-Fa-f]* [ABCDGRST] //' | sort | uniq |";
|
|
while (<DEFS>) {
|
|
chomp($_);
|
|
$objdefs{$_} = $obj;
|
|
}
|
|
close DEFS;
|
|
}
|
|
|
|
# Generate one entry in the <dl> list. This generates the <dt> and <dd> elements
|
|
# for one library or object file. The <dt> provides the name of the library or
|
|
# object. The <dd> provides a list of the libraries/objects it depends on.
|
|
sub gen_one_entry {
|
|
my $lib = $_[0];
|
|
my $lib_ns = $lib;
|
|
$lib_ns =~ s/(.*)\.[oa]/$1/;
|
|
print " <dt><b>$lib</b</dt><dd><ul>\n";
|
|
open UNDEFS,
|
|
"nm -u $Directory/$lib | grep ' U ' | sed -e 's/ U //' | sort | uniq |";
|
|
open DEPENDS,
|
|
"| sort | uniq > GenLibDeps.out";
|
|
while (<UNDEFS>) {
|
|
chomp;
|
|
if (defined($libdefs{$_}) && $libdefs{$_} ne $lib) {
|
|
print DEPENDS "$libdefs{$_}\n";
|
|
} elsif (defined($objdefs{$_}) && $objdefs{$_} ne $lib) {
|
|
$libroot = $lib;
|
|
$libroot =~ s/lib(.*).a/$1/;
|
|
if ($objdefs{$_} ne "$libroot.o") {
|
|
print DEPENDS "$objdefs{$_}\n";
|
|
}
|
|
}
|
|
}
|
|
close UNDEFS;
|
|
close DEPENDS;
|
|
open DF, "<GenLibDeps.out";
|
|
while (<DF>) {
|
|
chomp;
|
|
print " <li>$_</li>\n";
|
|
$suffix = substr($_,length($_)-1,1);
|
|
$_ =~ s/(.*)\.[oa]/$1/;
|
|
if ($suffix eq "a") {
|
|
print DOT "$lib_ns -> $_ [ weight=0 ];\n";
|
|
} else {
|
|
print DOT "$lib_ns -> $_ [ weight=10];\n";
|
|
}
|
|
}
|
|
close DF;
|
|
print " </ul></dd>\n";
|
|
}
|
|
|
|
# Make sure we flush on write. This is slower but correct based on the way we
|
|
# write I/O in gen_one_entry.
|
|
$| = 1;
|
|
|
|
# Print the definition list tag
|
|
print "<dl>\n";
|
|
|
|
open DOT, "| $DotPath -Tgif > libdeps.gif";
|
|
|
|
print DOT "digraph LibDeps {size=\"40,15\"; ratio=\"1.33333\"; margin=\"0.25\"; rankdir=\"LR\"; mclimit=\"50.0\"; ordering=\"out\"; center=\"1\";\n";
|
|
print DOT "node [shape=\"box\",color=\"#000088\",fillcolor=\"#FFFACD\",fontcolor=\"#5577DD\",style=\"filled\",fontsize=\"24\"];\n";
|
|
print DOT "edge [style=\"solid\",color=\"#000088\"];\n";
|
|
# Print libraries first
|
|
foreach $lib (@libs) {
|
|
gen_one_entry($lib);
|
|
}
|
|
print DOT "}\n";
|
|
close DOT;
|
|
open DOT, "| $DotPath -Tgif > objdeps.gif";
|
|
print DOT "digraph ObjDeps {size=\"40,15\"; ratio=\"1.33333\"; margin=\"0.25\"; rankdir=\"LR\"; mclimit=\"50.0\"; ordering=\"out\"; center=\"1\";\n";
|
|
print DOT "node [shape=\"box\",color=\"#000088\",fillcolor=\"#FFFACD\",fontcolor=\"#5577DD\",style=\"filled\",fontsize=\"24\"];\n";
|
|
print DOT "edge [style=\"solid\",color=\"#000088\"];\n";
|
|
|
|
# Print objects second
|
|
foreach $obj (@objs) {
|
|
gen_one_entry($obj);
|
|
}
|
|
|
|
print DOT "}\n";
|
|
close DOT;
|
|
|
|
# Print end tag of definition list element
|
|
print "</dl>\n";
|