Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Make sure that all the categories are connected with XBT_LOG_CONNECT() too, so that...
[simgrid.git] / tools / doxygen / xbt_log_extract_hierarchy.pl
index 7eabb24..64d9a25 100755 (executable)
@@ -10,7 +10,57 @@ my $debug = 0;
 my %ancestor;
 my %desc;
 # $ancestor{"toto"} is the ancestor of the toto channel
+#    as declared by XBT_LOG_NEW_SUBCATEGORY and XBT_LOG_NEW_DEFAULT_SUBCATEGORY
+#    ie, when the channel toto is initialized (does not work under windows)
+
 # $desc{"toto"} is its description
+my %c_ancestor;
+# $c_ancestor{"toto"} is the ancestor of the toto channel, as declared by XBT_LOG_CONNECT
+#    ie, in a initialization function (only way to do so under windows)
+#    we want $ancestor{"toto"} == $c_ancestor{"toto"} for each toto, or bad things will happen under windows
+
+sub cleanup_ctn {
+    my $ctn = shift;        # cleanup the content of a macro call
+    $ctn =~ s/ *\n//gs;                                                                                 
+    $ctn =~ s/,\s*"/,"/gs;
+    $ctn =~ s/"\s*$/"/gs;
+    $ctn =~ s/,\s*/,/gs;
+    my @elms_tmp=split (/,/,$ctn); 
+    my @elms;
+    print "ctn=$ctn\n" if $debug > 1;
+    # There may be some ',' in the description. Remerge the stuff like: "description, really"
+    while (1) {
+       my $acc = shift @elms_tmp;
+       last unless defined $acc;
+       if ($acc =~ /^"/) { # ") {
+           while (shift @elms_tmp) { 
+               $acc .= $_;
+           }
+           die "Unparsable content: $ctn\n"
+             unless ($acc =~ s/^"(.*)"$/$1/);
+       }
+       print "  seen $acc\n" if $debug > 1;
+       push @elms, $acc;
+    }
+    if (scalar(@elms) eq 3) {
+       # Perfect, we got 0->name; 1->anc; 2->desc
+    } elsif (scalar(@elms) eq 2) {
+       # Mmm. got no ancestor. Add the default one.
+       $elms[2] = $elms[1]; # shift the desc
+       $elms[1] = "XBT_LOG_ROOT_CAT";
+    } else {
+       my $l = scalar(@elms);
+       my $s = "";
+       map {$s .= $_;} @elms;
+       die "Unparsable content: $ctn (length=$l) (content=$s)\n";
+    }
+    
+    $elms[0] =~ s/^\s*(\S*)\s*$/$1/; # trim
+    $elms[1]  =~ s/^\s*(\S*)\s*$/$1/; # trim
+
+    return @elms;
+}
+
 
 sub parse_file {
     my $filename = shift;
@@ -30,51 +80,13 @@ sub parse_file {
     # C++ comments are forbiden in SG for portability reasons, but deal with it anyway
     $data =~ s|//.*$||mg;
 
+    my $connect_data = $data; # save a copy for second parsing phase
     while ($data =~ s/^.*?XBT_LOG_NEW(_DEFAULT)?_(SUB)?CATEGORY\(//s) {
        $data =~ s/([^"]*"[^"]*")\)//s || die "unparsable macro: $data"; # ]]);
-       my $ctn = $1;
-    
-        # cleanup the content                                                                                   
-       $ctn =~ s/ *\n//gs;                                                                              
-        $ctn =~ s/,\s*"/,"/gs;
-        $ctn =~ s/"\s*$/"/gs;
-        $ctn =~ s/,\s*/,/gs;
-        my @elms_tmp=split (/,/,$ctn); 
-        my @elms;
-        print "ctn=$ctn\n" if $debug > 1;
-        # There may be some ',' in the description. Remerge the stuff like: "description, really"
-        while (1) {
-           my $acc = shift @elms_tmp;
-           last unless defined $acc;
-           if ($acc =~ /^"/) { # ") {
-               while (shift @elms_tmp) { 
-                  $acc .= $_;
-               }
-               die "Unparsable content: $ctn\n"
-                  unless ($acc =~ s/^"(.*)"$/$1/);
-           }
-           print "  seen $acc\n" if $debug > 1;
-           push @elms, $acc;
-        }
-
-        my ($name,$anc,$desc);
+           
+        my ($name,$anc,$desc) = cleanup_ctn($1);
+           
         # build the tree, checking for name conflict
-        if (scalar(@elms) eq 3) {
-          $name = $elms[0];
-          $anc  = $elms[1];
-          $desc = $elms[2];
-        } elsif (scalar(@elms) eq 2) {
-          $name = $elms[0];
-          $anc  = "XBT_LOG_ROOT_CAT";
-          $desc = $elms[1];
-        } else {
-          my $l = scalar(@elms);
-          my $s = "";
-          map {$s .= $_;} @elms;
-          die "Unparsable content: $ctn (length=$l) (content=$s)\n";
-        }
-       $name =~ s/^\s*(\S*)\s*$/$1/; # trim
-       $anc  =~ s/^\s*(\S*)\s*$/$1/; # trim
         die "ERROR: Category name conflict: $name used several times\n"
           if defined ($ancestor{$name}) && $ancestor{$name} ne $anc &&
               defined ($desc{$name}) && $desc{$name} ne $desc;
@@ -83,10 +95,23 @@ sub parse_file {
    
        print " $name -> $anc\n" if $debug;
    }
+
+   # Now, look for XBT_LOG_CONNECT calls
+   $data = $connect_data;
+   while ($data =~ s/^.*?XBT_LOG_CONNECT\(//s) {
+                                                                        
+       $data =~ s/([^\)]*)\)//s || die "unparsable macro: $data"; # ]]);           
+        my ($name, $ignoreme, $anc) = cleanup_ctn($1);
+           
+        # build the tree, checking for name conflict
+       $c_ancestor{$name}=$anc;
+   
+       print STDERR " $name -> $anc\n" if $debug;
+   }
 }
 # Retrieve all the file names, and add their content to $data
 my $data;
-open FILES, "find -name '*.c'|" || die "Cannot search for the source file names; $!\n";
+open FILES, "find -name '*.c'|" || die "Cannot search for the source file names: $!\n";
 while (my $file=<FILES>) {
     chomp $file;
     parse_file($file);         
@@ -95,7 +120,7 @@ close FILES;
 
 # Display the tree, looking for disconnected elems    
 my %used;
-    
+       
 sub display_subtree {
     my $name=shift;
     my $indent=shift;
@@ -111,4 +136,17 @@ sub display_subtree {
     
 display_subtree("XBT_LOG_ROOT_CAT","");
 
+sub check_connection {
+    my $name=shift;
+    
+    foreach my $cat (grep {$ancestor{$_} eq $name} sort keys %ancestor) {
+       unless ($ancestor{$cat} eq "XBT_LOG_ROOT_CAT" || (defined($c_ancestor{$cat}) && $c_ancestor{$cat} eq $name)) {
+           warn "Category $cat will be disconnected under windows. Add the following to an initialization function:\n   XBT_LOG_CONNECT($cat, $ancestor{$cat});\n";
+       } else {
+           warn "Correctly connected, even under windows: Category $cat.\n" if $debug;
+       }
+       check_connection($cat);
+    }
+}
+check_connection("XBT_LOG_ROOT_CAT");  
 map {warn "Category $_ does not seem to be connected to the root (anc=$ancestor{$_})\n";} grep {!defined $used{$_}} sort keys %ancestor;