5 # This script takes at least two arguments, a GNU style version script and
6 # a list of object and archive files, and generates a corresponding Sun
7 # style version script as follows:
9 # Each glob pattern, C++ mangled pattern or literal in the input script is
10 # matched against all global symbols in the input objects, emitting those
11 # that matched (or nothing if no match was found).
12 # A comment with the original pattern and its type is left in the output
13 # file to make it easy to understand the matches.
15 # It uses elfdump when present (native), GNU readelf otherwise.
16 # It depends on the GNU version of c++filt, since it must understand the
26 # Input version script, GNU style.
30 # Get all the symbols from the library, match them, and add them to a hash.
34 # List of objects and archives to process.
37 # List of shared objects to omit from processing.
40 # Filter out those input archives that have corresponding shared objects to
41 # avoid adding all symbols matched in the archive to the output map.
42 foreach $file (@ARGV) {
43 if (($so = $file) =~ s/\.a$/.so/ && -e
$so) {
44 printf STDERR
"omitted $file -> $so\n";
45 push (@SHAREDOBJS, $so);
47 push (@OBJECTS, $file);
51 # We need to detect and ignore hidden symbols. Solaris nm can only detect
52 # this in the harder to parse default output format, and GNU nm not at all,
53 # so use elfdump -s in the native case and GNU readelf -s otherwise.
54 # GNU objdump -t cannot be used since it produces a variable number of
57 # The path to elfdump.
58 my $elfdump = "/usr/ccs/bin/elfdump";
61 open ELFDUMP
,$elfdump.' -s '.(join ' ',@OBJECTS).'|' or die $!;
69 # End of archive symbol table, stop skipping.
70 $skip_arsym = 0 if $skip_arsym;
74 # Keep skipping until end of archive symbol table.
75 next if ($skip_arsym);
77 # Ignore object name header for individual objects and archives.
80 # Ignore table header lines.
81 next if (/^Symbol Table Section:/);
82 next if (/index.*value.*size/);
84 # Start of archive symbol table: start skipping.
85 if (/^Symbol Table: \(archive/) {
91 (undef, undef, undef, undef, $bind, $oth, undef, $shndx, $name) = split;
93 # Error out for unknown input.
94 die "unknown input line:\n$_" unless defined($bind);
96 # Ignore local symbols.
97 next if ($bind eq "LOCL");
98 # Ignore hidden symbols.
99 next if ($oth eq "H");
100 # Ignore undefined symbols.
101 next if ($shndx eq "UNDEF");
102 # Error out for unhandled cases.
103 if ($bind !~ /^(GLOB|WEAK)/ or $oth ne "D") {
104 die "unhandled symbol:\n$_";
110 close ELFDUMP
or die "$elfdump error";
112 open READELF
, 'readelf -s -W '.(join ' ',@OBJECTS).'|' or die $!;
113 # Process each symbol.
117 # Ignore empty lines.
120 # Ignore object name header.
121 next if (/^File: .*$/);
123 # Ignore table header lines.
124 next if (/^Symbol table.*contains.*:/);
125 next if (/Num:.*Value.*Size/);
128 (undef, undef, undef, undef, $bind, $vis, $ndx, $name) = split;
130 # Error out for unknown input.
131 die "unknown input line:\n$_" unless defined($bind);
133 # Ignore local symbols.
134 next if ($bind eq "LOCAL");
135 # Ignore hidden symbols.
136 next if ($vis eq "HIDDEN");
137 # Ignore undefined symbols.
138 next if ($ndx eq "UND");
139 # Error out for unhandled cases.
140 if ($bind !~ /^(GLOBAL|WEAK)/ or $vis ne "DEFAULT") {
141 die "unhandled symbol:\n$_";
147 close READELF
or die "readelf error";
151 # The various types of glob patterns.
153 # A glob pattern that is to be applied to the demangled name: 'cxx'.
154 # A glob patterns that applies directly to the name in the .o files: 'glob'.
155 # This pattern is ignored; used for local variables (usually just '*'): 'ign'.
157 # The type of the current pattern.
160 # We're currently inside `extern "C++"', which Sun ld doesn't understand.
163 # The c++filt command to use. This *must* be GNU c++filt; the Sun Studio
164 # c++filt doesn't handle the GNU mangling style.
165 my $cxxfilt = $ENV{'CXXFILT'} || "c++filt";
167 # The current version name.
168 my $current_version = "";
170 # Was there any attempt to match a symbol to this version?
171 my $matches_attempted;
173 # The number of versions which matched this symbol.
176 open F
,$symvers or die $!;
178 # Print information about generating this file
179 print "# This file was generated by make_sunver.pl. DO NOT EDIT!\n";
180 print "# It was generated by:\n";
181 printf "# %s %s %s\n", $0, $symvers, (join ' ',@ARGV);
182 printf "# Omitted archives with corresponding shared libraries: %s\n",
183 (join ' ', @SHAREDOBJS) if $#SHAREDOBJS >= 0;
187 # Lines of the form '};'
188 if (/^([ \t]*)(\}[ \t]*;[ \t]*)$/) {
199 # Lines of the form '} SOME_VERSION_NAME_1.0;'
200 if (/^[ \t]*\}[ \tA-Z0-9_.a-z]+;[ \t]*$/) {
202 # We tried to match symbols agains this version, but none matched.
203 # Emit dummy hidden symbol to avoid marking this version WEAK.
204 if ($matches_attempted && $matched_symbols == 0) {
206 print " .force_WEAK_off_$current_version = DATA S0x0 V0x0;\n";
211 # Comment and blank lines
212 if (/^[ \t]*\#/) { print; next; }
213 if (/^[ \t]*$/) { print; next; }
215 # Lines of the form '{'
225 # Lines of the form 'SOME_VERSION_NAME_1.1 {'
226 if (/^([A-Z0-9_.]+)[ \t]+{$/) {
227 # Record version name.
228 $current_version = $1;
229 # Reset match attempts, #matched symbols for this version.
230 $matches_attempted = 0;
231 $matched_symbols = 0;
237 if (/^[ \t]*global:$/) { print; next; }
239 # After 'local:', globs should be ignored, they won't be exported.
240 if (/^[ \t]*local:$/) {
246 # After 'extern "C++"', globs are C++ patterns
247 if (/^([ \t]*)(extern \"C\+\+\"[ \t]*)$/) {
250 # Need to comment, Sun ld cannot handle this.
251 print "$1##$2\n"; next;
254 # Chomp newline now we're done with passing through the input file.
257 # Catch globs. Note that '{}' is not allowed in globs by this script,
258 # so only '*' and '[]' are available.
259 if (/^([ \t]*)([^ \t;{}#]+);?[ \t]*$/) {
262 # Turn the glob into a regex by replacing '*' with '.*', '?' with '.'.
263 # Keep $ptn so we can still print the original form.
264 ($pattern = $ptn) =~ s/\*/\.\*/g;
265 $pattern =~ s/\?/\./g;
267 if ($glob eq 'ign') {
268 # We're in a local: * section; just continue.
273 # Print the glob commented for human readers.
274 print "$ws##$ptn ($glob)\n";
275 # We tried to match a symbol to this version.
276 $matches_attempted++;
278 if ($glob eq 'glob') {
281 # Match ptn against symbols in %sym_hash.
282 foreach my $sym (keys %sym_hash) {
283 # Maybe it matches one of the patterns based on the symbol in
285 $ptn_syms{$sym}++ if ($sym =~ /^$pattern$/);
288 foreach my $sym (sort keys(%ptn_syms)) {
292 } elsif ($glob eq 'cxx') {
295 # Verify that we're actually using GNU c++filt. Other versions
296 # most likely cannot handle GNU style symbol mangling.
297 my $cxxout = `$cxxfilt --version 2>&1`;
298 $cxxout =~ m/GNU/ or die "$0 requires GNU c++filt to function";
300 # Talk to c++filt through a pair of file descriptors.
301 # Need to start a fresh instance per pattern, otherwise the
302 # process grows to 500+ MB.
303 my $pid = open2
(*FILTIN
, *FILTOUT
, $cxxfilt) or die $!;
305 # Match ptn against symbols in %sym_hash.
306 foreach my $sym (keys %sym_hash) {
307 # No? Well, maybe its demangled form matches one of those
309 printf FILTOUT
"%s\n",$sym;
312 $dem_syms{$sym}++ if ($dem =~ /^$pattern$/);
315 close FILTOUT
or die "c++filt error";
316 close FILTIN
or die "c++filt error";
317 # Need to wait for the c++filt process to avoid lots of zombies.
320 foreach my $sym (sort keys(%dem_syms)) {
325 # No? Well, then ignore it.
329 # Important sanity check. This script can't handle lots of formats
330 # that GNU ld can, so be sure to error out if one is seen!
331 die "strange line `$_'";