3 # (C) Copyright IBM Corporation 2006.
4 # Released under GPL v2.
5 # Author : Ram Pai (linuxram@us.ibm.com)
7 # Usage: export_report.pl -k Module.symvers [-o report_file ] -f *.mod.c
14 my $no1 = (split /\s+/, $a)[1];
15 my $no2 = (split /\s+/, $b)[1];
20 my ($module1, $value1) = @
{$a};
21 my ($module2, $value2) = @
{$b};
22 return $value1 <=> $value2 || $module2 cmp $module1;
25 sub print_depends_on
{
28 while (my ($mod, $list) = each %$href) {
30 foreach my $sym (sort numerically @
{$list}) {
31 my ($symbol, $no) = split /\s+/, $sym;
32 printf("\t\t%-25s\t%-25d\n", $symbol, $no);
41 print "Usage: @_ -h -k Module.symvers [ -o outputfile ] \n",
42 "\t-f: treat all the non-option argument as .mod.c files. ",
43 "Recommend using this as the last option\n",
44 "\t-h: print detailed help\n",
45 "\t-k: the path to Module.symvers file. By default uses ",
46 "the file from the current directory\n",
47 "\t-o outputfile: output the report to outputfile\n";
53 = `cat .tmp_versions/*.mod | grep '.*\.ko\$' | sed s/\.ko$/.mod.c/`;
58 my (%SYMBOL, %MODULE, %opt, @allcfiles);
60 if (not getopts
('hk:o:f',\
%opt) or defined $opt{'h'}) {
64 if (defined $opt{'f'}) {
67 @allcfiles = collectcfiles
();
70 if (not defined $opt{'k'}) {
71 $opt{'k'} = "Module.symvers";
74 open (my $module_symvers, '<', $opt{'k'})
75 or die "Sorry, cannot open $opt{'k'}: $!\n";
77 if (defined $opt{'o'}) {
78 open (my $out, '>', $opt{'o'})
79 or die "Sorry, cannot open $opt{'o'} $!\n";
85 # collect all the symbols and their attributes from the
88 while ( <$module_symvers> ) {
90 my (undef, $symbol, $module, $gpl) = split;
91 $SYMBOL { $symbol } = [ $module , "0" , $symbol, $gpl];
93 close($module_symvers);
96 # collect the usage count of each symbol.
98 foreach my $thismod (@allcfiles) {
101 unless (open ($module, '<', $thismod)) {
102 warn "Sorry, cannot open $thismod: $!\n";
107 while ( <$module> ) {
110 $state = 1 if ($_ =~ /static const struct modversion_info/);
114 $state = 2 if ($_ =~ /__attribute__\(\(section\("__versions"\)\)\)/);
118 if ( $_ !~ /0x[0-9a-f]+,/ ) {
121 my $sym = (split /([,"])/,)[4];
122 my ($module, $value, $symbol, $gpl) = @
{$SYMBOL{$sym}};
123 $SYMBOL{ $sym } = [ $module, $value+1, $symbol, $gpl];
124 push(@
{$MODULE{$thismod}} , $sym);
128 print "WARNING:$thismod is not built with CONFIG_MODVERSION enabled\n";
133 print "\tThis file reports the exported symbols usage patterns by in-tree\n",
135 printf("%s\n\n\n","x"x80
);
136 printf("\t\t\t\tINDEX\n\n\n");
137 printf("SECTION 1: Usage counts of all exported symbols\n");
138 printf("SECTION 2: List of modules and the exported symbols they use\n");
139 printf("%s\n\n\n","x"x80
);
140 printf("SECTION 1:\tThe exported symbols and their usage count\n\n");
141 printf("%-25s\t%-25s\t%-5s\t%-25s\n", "Symbol", "Module", "Usage count",
145 # print the list of unused exported symbols
147 foreach my $list (sort alphabetically
values(%SYMBOL)) {
148 my ($module, $value, $symbol, $gpl) = @
{$list};
149 printf("%-25s\t%-25s\t%-10s\t", $symbol, $module, $value);
151 printf("%-25s\n",$gpl);
156 printf("%s\n\n\n","x"x80
);
158 printf("SECTION 2:\n\tThis section reports export-symbol-usage of in-kernel
159 modules. Each module lists the modules, and the symbols from that module that
160 it uses. Each listed symbol reports the number of modules using it\n");
163 while (my ($thismod, $list) = each %MODULE) {
165 $thismod =~ s/\.mod\.c/.ko/;
166 print "\t\t\t$thismod\n";
167 foreach my $symbol (@
{$list}) {
168 my ($module, $value, undef, $gpl) = @
{$SYMBOL{$symbol}};
169 push (@
{$depends{"$module"}}, "$symbol $value");
171 print_depends_on
(\
%depends);