3 # Program: GenLibDeps.pl
5 # Synopsis: Generate HTML output that shows the dependencies between a set of
6 # libraries. The output of this script should periodically replace
7 # the similar content in the UsingLibraries.html document.
9 # Syntax: GenLibDeps.pl <directory_with_libraries_in_it>
12 # Give first option a name.
13 my $Directory = $ARGV[0];
15 # Find the "dot" program
16 chomp(my $DotPath = `which dot`);
17 die "Can't find 'dot'" if (! -x "$DotPath");
19 # Open the directory and read its contents, sorting by name and differentiating
20 # by whether its a library (.a) or an object file (.o)
21 opendir DIR,$Directory;
22 my @files = readdir DIR;
24 @libs = grep(/libLLVM.*\.a$/,sort(@files));
25 @objs = grep(/LLVM.*\.o$/,sort(@files));
27 # Declare the hashes we will use to keep track of the library and object file
32 # Gather definitions from the libraries
33 foreach $lib (@libs ) {
35 "nm -g --defined-only $Directory/$lib | grep ' [ABCDGRST] ' | sed -e 's/^[0-9A-Fa-f]* [ABCDGRST] //' | sort | uniq |";
43 # Gather definitions from the object files.
44 foreach $obj (@objs ) {
46 "nm -g --defined-only $Directory/$obj | grep ' [ABCDGRST] ' | sed -e 's/^[0-9A-Fa-f]* [ABCDGRST] //' | sort | uniq |";
54 # Generate one entry in the <dl> list. This generates the <dt> and <dd> elements
55 # for one library or object file. The <dt> provides the name of the library or
56 # object. The <dd> provides a list of the libraries/objects it depends on.
60 $lib_ns =~ s/(.*)\.[oa]/$1/;
61 print " <dt><b>$lib</b</dt><dd><ul>\n";
63 "nm -u $Directory/$lib | grep ' U ' | sed -e 's/ U //' | sort | uniq |";
65 "| sort | uniq > GenLibDeps.out";
68 if (defined($libdefs{$_}) && $libdefs{$_} ne $lib) {
69 print DEPENDS "$libdefs{$_}\n";
70 } elsif (defined($objdefs{$_}) && $objdefs{$_} ne $lib) {
72 $libroot =~ s/lib(.*).a/$1/;
73 if ($objdefs{$_} ne "$libroot.o") {
74 print DEPENDS "$objdefs{$_}\n";
80 open DF, "<GenLibDeps.out";
83 print " <li>$_</li>\n";
84 $suffix = substr($_,length($_)-1,1);
85 $_ =~ s/(.*)\.[oa]/$1/;
87 print DOT "$lib_ns -> $_ [ weight=0 ];\n";
89 print DOT "$lib_ns -> $_ [ weight=10];\n";
93 print " </ul></dd>\n";
96 # Make sure we flush on write. This is slower but correct based on the way we
97 # write I/O in gen_one_entry.
100 # Print the definition list tag
103 open DOT, "| $DotPath -Tgif > libdeps.gif";
105 print DOT "digraph LibDeps {size=\"40,15\"; ratio=\"1.33333\"; margin=\"0.25\"; rankdir=\"LR\"; mclimit=\"50.0\"; ordering=\"out\"; center=\"1\";\n";
106 print DOT "node [shape=\"box\",color=\"#000088\",fillcolor=\"#FFFACD\",fontcolor=\"#5577DD\",style=\"filled\",fontsize=\"24\"];\n";
107 print DOT "edge [style=\"solid\",color=\"#000088\"];\n";
108 # Print libraries first
109 foreach $lib (@libs) {
114 open DOT, "| $DotPath -Tgif > objdeps.gif";
115 print DOT "digraph ObjDeps {size=\"40,15\"; ratio=\"1.33333\"; margin=\"0.25\"; rankdir=\"LR\"; mclimit=\"50.0\"; ordering=\"out\"; center=\"1\";\n";
116 print DOT "node [shape=\"box\",color=\"#000088\",fillcolor=\"#FFFACD\",fontcolor=\"#5577DD\",style=\"filled\",fontsize=\"24\"];\n";
117 print DOT "edge [style=\"solid\",color=\"#000088\"];\n";
119 # Print objects second
120 foreach $obj (@objs) {
127 # Print end tag of definition list element