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	while (my ($mod, $list) = each %$href) {
29		print "\t$mod:\n";
30		foreach my $sym (sort numerically @{$list}) {
31			my ($symbol, $no) = split /\s+/, $sym;
32			printf("\t\t%-25s\t%-25d\n", $symbol, $no);
33		}
34		print "\n";
35	}
36	print "\n";
37	print "~"x80 , "\n";
38}
39
40sub usage {
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";
48	exit 0;
49}
50
51sub collectcfiles {
52    my @file
53	= `cat .tmp_versions/*.mod | grep '.*\.ko\$' | sed s/\.ko$/.mod.c/`;
54    chomp @file;
55    return @file;
56}
57
58my (%SYMBOL, %MODULE, %opt, @allcfiles);
59
60if (not getopts('hk:o:f',\%opt) or defined $opt{'h'}) {
61        usage($0);
62}
63
64if (defined $opt{'f'}) {
65	@allcfiles = @ARGV;
66} else {
67	@allcfiles = collectcfiles();
68}
69
70if (not defined $opt{'k'}) {
71	$opt{'k'} = "Module.symvers";
72}
73
74open (my $module_symvers, '<', $opt{'k'})
75    or die "Sorry, cannot open $opt{'k'}: $!\n";
76
77if (defined $opt{'o'}) {
78    open (my $out, '>', $opt{'o'})
79	or die "Sorry, cannot open $opt{'o'} $!\n";
80
81    select $out;
82}
83
84#
85# collect all the symbols and their attributes from the
86# Module.symvers file
87#
88while ( <$module_symvers> ) {
89	chomp;
90	my (undef, $symbol, $module, $gpl) = split;
91	$SYMBOL { $symbol } =  [ $module , "0" , $symbol, $gpl];
92}
93close($module_symvers);
94
95#
96# collect the usage count of each symbol.
97#
98foreach my $thismod (@allcfiles) {
99	my $module;
100
101	unless (open ($module, '<', $thismod)) {
102		warn "Sorry, cannot open $thismod: $!\n";
103		next;
104	}
105
106	my $state=0;
107	while ( <$module> ) {
108		chomp;
109		if ($state == 0) {
110			$state = 1 if ($_ =~ /static const struct modversion_info/);
111			next;
112		}
113		if ($state == 1) {
114			$state = 2 if ($_ =~ /__attribute__\(\(section\("__versions"\)\)\)/);
115			next;
116		}
117		if ($state == 2) {
118			if ( $_ !~ /0x[0-9a-f]+,/ ) {
119				next;
120			}
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);
125		}
126	}
127	if ($state != 2) {
128		print "WARNING:$thismod is not built with CONFIG_MODVERSION enabled\n";
129	}
130	close($module);
131}
132
133print "\tThis file reports the exported symbols usage patterns by in-tree\n",
134	"\t\t\t\tmodules\n";
135printf("%s\n\n\n","x"x80);
136printf("\t\t\t\tINDEX\n\n\n");
137printf("SECTION 1: Usage counts of all exported symbols\n");
138printf("SECTION 2: List of modules and the exported symbols they use\n");
139printf("%s\n\n\n","x"x80);
140printf("SECTION 1:\tThe exported symbols and their usage count\n\n");
141printf("%-25s\t%-25s\t%-5s\t%-25s\n", "Symbol", "Module", "Usage count",
142	"export type");
143
144#
145# print the list of unused exported symbols
146#
147foreach my $list (sort alphabetically values(%SYMBOL)) {
148	my ($module, $value, $symbol, $gpl) = @{$list};
149	printf("%-25s\t%-25s\t%-10s\t", $symbol, $module, $value);
150	if (defined $gpl) {
151		printf("%-25s\n",$gpl);
152	} else {
153		printf("\n");
154	}
155}
156printf("%s\n\n\n","x"x80);
157
158printf("SECTION 2:\n\tThis section reports export-symbol-usage of in-kernel
159modules. Each module lists the modules, and the symbols from that module that
160it uses.  Each listed symbol reports the number of modules using it\n");
161
162print "~"x80 , "\n";
163while (my ($thismod, $list) = each %MODULE) {
164	my %depends;
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");
170	}
171	print_depends_on(\%depends);
172}
173