Loading...
1#!/usr/bin/perl -w
2#
3# (C) Copyright IBM Corporation 2006.
4# Released under GPL v2.
5# Author : Ram Pai (linuxram@us.ibm.com)
6#
7# Usage: export_report.pl -k Module.symvers [-o report_file ] -f *.mod.c
8#
9
10use Getopt::Std;
11use strict;
12
13sub numerically {
14 my $no1 = (split /\s+/, $a)[1];
15 my $no2 = (split /\s+/, $b)[1];
16 return $no1 <=> $no2;
17}
18
19sub alphabetically {
20 my ($module1, $value1) = @{$a};
21 my ($module2, $value2) = @{$b};
22 return $value1 <=> $value2 || $module2 cmp $module1;
23}
24
25sub print_depends_on {
26 my ($href) = @_;
27 print "\n";
28 for my $mod (sort keys %$href) {
29 my $list = $href->{$mod};
30 print "\t$mod:\n";
31 foreach my $sym (sort numerically @{$list}) {
32 my ($symbol, $no) = split /\s+/, $sym;
33 printf("\t\t%-25s\n", $symbol);
34 }
35 print "\n";
36 }
37 print "\n";
38 print "~"x80 , "\n";
39}
40
41sub usage {
42 print "Usage: @_ -h -k Module.symvers [ -o outputfile ] \n",
43 "\t-f: treat all the non-option argument as .mod.c files. ",
44 "Recommend using this as the last option\n",
45 "\t-h: print detailed help\n",
46 "\t-k: the path to Module.symvers file. By default uses ",
47 "the file from the current directory\n",
48 "\t-o outputfile: output the report to outputfile\n";
49 exit 0;
50}
51
52sub collectcfiles {
53 my @file;
54 while (<.tmp_versions/*.mod>) {
55 open my $fh, '<', $_ or die "cannot open $_: $!\n";
56 push (@file,
57 grep s/\.ko/.mod.c/, # change the suffix
58 grep m/.+\.ko/, # find the .ko path
59 <$fh>); # lines in opened file
60 }
61 chomp @file;
62 return @file;
63}
64
65my (%SYMBOL, %MODULE, %opt, @allcfiles);
66
67if (not getopts('hk:o:f',\%opt) or defined $opt{'h'}) {
68 usage($0);
69}
70
71if (defined $opt{'f'}) {
72 @allcfiles = @ARGV;
73} else {
74 @allcfiles = collectcfiles();
75}
76
77if (not defined $opt{'k'}) {
78 $opt{'k'} = "Module.symvers";
79}
80
81open (my $module_symvers, '<', $opt{'k'})
82 or die "Sorry, cannot open $opt{'k'}: $!\n";
83
84if (defined $opt{'o'}) {
85 open (my $out, '>', $opt{'o'})
86 or die "Sorry, cannot open $opt{'o'} $!\n";
87
88 select $out;
89}
90
91#
92# collect all the symbols and their attributes from the
93# Module.symvers file
94#
95while ( <$module_symvers> ) {
96 chomp;
97 my (undef, $symbol, $module, $gpl) = split;
98 $SYMBOL { $symbol } = [ $module , "0" , $symbol, $gpl];
99}
100close($module_symvers);
101
102#
103# collect the usage count of each symbol.
104#
105my $modversion_warnings = 0;
106
107foreach my $thismod (@allcfiles) {
108 my $module;
109
110 unless (open ($module, '<', $thismod)) {
111 warn "Sorry, cannot open $thismod: $!\n";
112 next;
113 }
114
115 my $state=0;
116 while ( <$module> ) {
117 chomp;
118 if ($state == 0) {
119 $state = 1 if ($_ =~ /static const struct modversion_info/);
120 next;
121 }
122 if ($state == 1) {
123 $state = 2 if ($_ =~ /__attribute__\(\(section\("__versions"\)\)\)/);
124 next;
125 }
126 if ($state == 2) {
127 if ( $_ !~ /0x[0-9a-f]+,/ ) {
128 next;
129 }
130 my $sym = (split /([,"])/,)[4];
131 my ($module, $value, $symbol, $gpl) = @{$SYMBOL{$sym}};
132 $SYMBOL{ $sym } = [ $module, $value+1, $symbol, $gpl];
133 push(@{$MODULE{$thismod}} , $sym);
134 }
135 }
136 if ($state != 2) {
137 warn "WARNING:$thismod is not built with CONFIG_MODVERSIONS enabled\n";
138 $modversion_warnings++;
139 }
140 close($module);
141}
142
143print "\tThis file reports the exported symbols usage patterns by in-tree\n",
144 "\t\t\t\tmodules\n";
145printf("%s\n\n\n","x"x80);
146printf("\t\t\t\tINDEX\n\n\n");
147printf("SECTION 1: Usage counts of all exported symbols\n");
148printf("SECTION 2: List of modules and the exported symbols they use\n");
149printf("%s\n\n\n","x"x80);
150printf("SECTION 1:\tThe exported symbols and their usage count\n\n");
151printf("%-25s\t%-25s\t%-5s\t%-25s\n", "Symbol", "Module", "Usage count",
152 "export type");
153
154#
155# print the list of unused exported symbols
156#
157foreach my $list (sort alphabetically values(%SYMBOL)) {
158 my ($module, $value, $symbol, $gpl) = @{$list};
159 printf("%-25s\t%-25s\t%-10s\t", $symbol, $module, $value);
160 if (defined $gpl) {
161 printf("%-25s\n",$gpl);
162 } else {
163 printf("\n");
164 }
165}
166printf("%s\n\n\n","x"x80);
167
168printf("SECTION 2:\n\tThis section reports export-symbol-usage of in-kernel
169modules. Each module lists the modules, and the symbols from that module that
170it uses. Each listed symbol reports the number of modules using it\n");
171
172print "\nNOTE: Got $modversion_warnings CONFIG_MODVERSIONS warnings\n\n"
173 if $modversion_warnings;
174
175print "~"x80 , "\n";
176for my $thismod (sort keys %MODULE) {
177 my $list = $MODULE{$thismod};
178 my %depends;
179 $thismod =~ s/\.mod\.c/.ko/;
180 print "\t\t\t$thismod\n";
181 foreach my $symbol (@{$list}) {
182 my ($module, $value, undef, $gpl) = @{$SYMBOL{$symbol}};
183 push (@{$depends{"$module"}}, "$symbol $value");
184 }
185 print_depends_on(\%depends);
186}
1#!/usr/bin/env perl
2# SPDX-License-Identifier: GPL-2.0-only
3#
4# (C) Copyright IBM Corporation 2006.
5# Author : Ram Pai (linuxram@us.ibm.com)
6#
7# Usage: export_report.pl -k Module.symvers [-o report_file ] -f *.mod.c
8#
9
10use warnings;
11use Getopt::Std;
12use strict;
13
14sub numerically {
15 my $no1 = (split /\s+/, $a)[1];
16 my $no2 = (split /\s+/, $b)[1];
17 return $no1 <=> $no2;
18}
19
20sub alphabetically {
21 my ($module1, $value1) = @{$a};
22 my ($module2, $value2) = @{$b};
23 return $value1 <=> $value2 || $module2 cmp $module1;
24}
25
26sub print_depends_on {
27 my ($href) = @_;
28 print "\n";
29 for my $mod (sort keys %$href) {
30 my $list = $href->{$mod};
31 print "\t$mod:\n";
32 foreach my $sym (sort numerically @{$list}) {
33 my ($symbol, $no) = split /\s+/, $sym;
34 printf("\t\t%-25s\n", $symbol);
35 }
36 print "\n";
37 }
38 print "\n";
39 print "~"x80 , "\n";
40}
41
42sub usage {
43 print "Usage: @_ -h -k Module.symvers [ -o outputfile ] \n",
44 "\t-f: treat all the non-option argument as .mod.c files. ",
45 "Recommend using this as the last option\n",
46 "\t-h: print detailed help\n",
47 "\t-k: the path to Module.symvers file. By default uses ",
48 "the file from the current directory\n",
49 "\t-o outputfile: output the report to outputfile\n";
50 exit 0;
51}
52
53sub collectcfiles {
54 my @file;
55 open my $fh, '< modules.order' or die "cannot open modules.order: $!\n";
56 while (<$fh>) {
57 s/\.ko$/.mod.c/;
58 push (@file, $_)
59 }
60 close($fh);
61 chomp @file;
62 return @file;
63}
64
65my (%SYMBOL, %MODULE, %opt, @allcfiles);
66
67if (not getopts('hk:o:f',\%opt) or defined $opt{'h'}) {
68 usage($0);
69}
70
71if (defined $opt{'f'}) {
72 @allcfiles = @ARGV;
73} else {
74 @allcfiles = collectcfiles();
75}
76
77if (not defined $opt{'k'}) {
78 $opt{'k'} = "Module.symvers";
79}
80
81open (my $module_symvers, '<', $opt{'k'})
82 or die "Sorry, cannot open $opt{'k'}: $!\n";
83
84if (defined $opt{'o'}) {
85 open (my $out, '>', $opt{'o'})
86 or die "Sorry, cannot open $opt{'o'} $!\n";
87
88 select $out;
89}
90
91#
92# collect all the symbols and their attributes from the
93# Module.symvers file
94#
95while ( <$module_symvers> ) {
96 chomp;
97 my (undef, $symbol, $module, $gpl, $namespace) = split('\t');
98 $SYMBOL { $symbol } = [ $module , "0" , $symbol, $gpl];
99}
100close($module_symvers);
101
102#
103# collect the usage count of each symbol.
104#
105my $modversion_warnings = 0;
106
107foreach my $thismod (@allcfiles) {
108 my $module;
109
110 unless (open ($module, '<', $thismod)) {
111 warn "Sorry, cannot open $thismod: $!\n";
112 next;
113 }
114
115 my $state=0;
116 while ( <$module> ) {
117 chomp;
118 if ($state == 0) {
119 $state = 1 if ($_ =~ /static const struct modversion_info/);
120 next;
121 }
122 if ($state == 1) {
123 $state = 2 if ($_ =~ /__attribute__\(\(section\("__versions"\)\)\)/);
124 next;
125 }
126 if ($state == 2) {
127 if ( $_ !~ /0x[0-9a-f]+,/ ) {
128 next;
129 }
130 my $sym = (split /([,"])/,)[4];
131 my ($module, $value, $symbol, $gpl) = @{$SYMBOL{$sym}};
132 $SYMBOL{ $sym } = [ $module, $value+1, $symbol, $gpl];
133 push(@{$MODULE{$thismod}} , $sym);
134 }
135 }
136 if ($state != 2) {
137 warn "WARNING:$thismod is not built with CONFIG_MODVERSIONS enabled\n";
138 $modversion_warnings++;
139 }
140 close($module);
141}
142
143print "\tThis file reports the exported symbols usage patterns by in-tree\n",
144 "\t\t\t\tmodules\n";
145printf("%s\n\n\n","x"x80);
146printf("\t\t\t\tINDEX\n\n\n");
147printf("SECTION 1: Usage counts of all exported symbols\n");
148printf("SECTION 2: List of modules and the exported symbols they use\n");
149printf("%s\n\n\n","x"x80);
150printf("SECTION 1:\tThe exported symbols and their usage count\n\n");
151printf("%-25s\t%-25s\t%-5s\t%-25s\n", "Symbol", "Module", "Usage count",
152 "export type");
153
154#
155# print the list of unused exported symbols
156#
157foreach my $list (sort alphabetically values(%SYMBOL)) {
158 my ($module, $value, $symbol, $gpl) = @{$list};
159 printf("%-25s\t%-25s\t%-10s\t", $symbol, $module, $value);
160 if (defined $gpl) {
161 printf("%-25s\n",$gpl);
162 } else {
163 printf("\n");
164 }
165}
166printf("%s\n\n\n","x"x80);
167
168printf("SECTION 2:\n\tThis section reports export-symbol-usage of in-kernel
169modules. Each module lists the modules, and the symbols from that module that
170it uses. Each listed symbol reports the number of modules using it\n");
171
172print "\nNOTE: Got $modversion_warnings CONFIG_MODVERSIONS warnings\n\n"
173 if $modversion_warnings;
174
175print "~"x80 , "\n";
176for my $thismod (sort keys %MODULE) {
177 my $list = $MODULE{$thismod};
178 my %depends;
179 $thismod =~ s/\.mod\.c/.ko/;
180 print "\t\t\t$thismod\n";
181 foreach my $symbol (@{$list}) {
182 my ($module, $value, undef, $gpl) = @{$SYMBOL{$symbol}};
183 push (@{$depends{"$module"}}, "$symbol $value");
184 }
185 print_depends_on(\%depends);
186}