interface_check.pl revision 75ce41a57ff334bd8fe2cb9ed51eea835892f944
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# CDDL HEADER START
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# The contents of this file are subject to the terms of the
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Common Development and Distribution License (the "License").
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# You may not use this file except in compliance with the License.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# See the License for the specific language governing permissions
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# and limitations under the License.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# When distributing Covered Code, include this CDDL HEADER in each
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# If applicable, add the following below this CDDL HEADER, with the
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# fields enclosed by brackets "[]" replaced with your own identifying
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# information: Portions Copyright [yyyy] [name of copyright owner]
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# CDDL HEADER END
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Copyright 2009 Sun Microsystems, Inc. All rights reserved.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Use is subject to license terms.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Check versioning information.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# This script descends a directory hierarchy inspecting ELF shared objects for
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# version definitions. The general theme is to verify that common versioning
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# rules have been used to build these objects.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# As always, a number of components don't follow the rules, or require
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# special handling. An exceptions file is used to specify these cases.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# By default any file that has conditions that should be reported is first
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# listed and then each condition follows. The -o (one-line) option produces a
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# more terse output which is better for sorting/diffing with "nightly".
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Besides the default operation of checking the files within a directory
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# hierarchy, a detailed analysis of each files versions can be created with the
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# -d option. The database created is useful for auditing the difference between
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# different builds, and for thus monitoring that versioning changes are made in
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# a compatible manner.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Define all global variables (required for strict)
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# An exception file is used to specify regular expressions to match
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# objects. These directives specify special attributes of the object.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# The regular expressions are read from the file and compiled into the
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# regular expression variables.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# The name of each regular expression variable is of the form
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# where xxx is the name of the exception in lower case. For example,
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# the regular expression variable for PLUGINS is $EXRE_plugins.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# onbld_elfmod::LoadExceptionsToEXRE() depends on this naming convention
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# to initialize the regular expression variables, and to detect invalid
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# exception names.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# If a given exception is not used in the exception file, its regular
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# expression variable will be undefined. Users of these variables must
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# test the variable with defined() prior to use:
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# defined($EXRE_plugins) && ($foo =~ $EXRE_plugins)
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# The exceptions are:
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# NONSTD_VERNAME
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Objects are expected to use standard names for versions.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# This directive is used to relax that requirement.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Objects that are not required to have a versioned name. Note that
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# PLUGINS objects are implicitly NOVERDEF, so this directive is
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# for use with non-plugin objects.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Plugin objects are not required to have a versioned name, and are
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# not required to be internally versioned.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahramiuse vars qw($EXRE_nonstd_vername $EXRE_noverdef $EXRE_plugin);
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami## ProcFile(BasePath, RelPath, Class, Type, Verdef, Alias)
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Investigate runtime attributes of a sharable object
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# BasePath - Base path from which relative paths are taken
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# RelPath - Path of object taken relative to BasePath
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Class - ELFCLASS of object
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Type - ELF type of object
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Verdef - VERDEF if object defines versions, NOVERDEF otherwise
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Alias - Alias lines corresponding to the object, or an empty ('')
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# string if there are no aliases.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami my($BasePath, $RelPath, $Class, $Type, $Verdef, $Alias) = @_;
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami @_ = split /\//, $RelPath;
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If this object does not follow the runtime versioned name convention,
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # and it does not reside underneath a directory identified as
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # containing plugin objects intended for use with dlopen() only,
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # issue a warning.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami $NotPlugin = !defined($EXRE_plugin) || ($RelPath !~ $EXRE_plugin);
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami "does not have a versioned name");
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If there are no versions in the file we're done.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Report the lack of versioning, unless the object is
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # a known plugin, or is explicitly exempt.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami (!defined($EXRE_noverdef) || ($RelPath !~ $EXRE_noverdef))) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami "no versions found");
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Get a hash of the top versions in the inheritance chains.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami foreach my $Line (split(/\n/, `pvs -don $FullPath 2>&1`)) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # First determine what versions exist that offer interfaces. pvs -dos
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # will list these. Note that other versions may exist, ones that
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # don't offer interfaces ... we'll get to those next.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami foreach my $Line (split(/\n/, `pvs -dos $FullPath 2>&1`)) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # See if we've already caught this version name. We only look
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # at each version once.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Note that the non-empty version has been seen
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # We expect the public SUNW_major.minor.micro versions to use
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # inheritance, so there should only be one top version for
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # each major number. It is possible, though rare, to have
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # more than one top version if the major numbers differ.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # %TopSUNWVers uses the major name as the key, with each
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # value yielding an array reference to the top versions for
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # that major number.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami push @{$TopSUNWVers{$1}}, $Ver if $TopVer{$Ver};
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Having already handled SUNW_ public versions above, is it
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # a different version name that we recognise?
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Along with the standard version names, each object exports
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # a "base" version which contains the linker generated symbols
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # _etext, _edata, etc., and is named using the objects SONAME.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # This name should typically match the file name.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If we get here, it's a non-standard version.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami if (!defined($EXRE_nonstd_vername) ||
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami "non-standard version name: $Ver");
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If this file has been scoped, but not versioned (i.e., a mapfile was
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # used to demote symbols but no version name was applied to the
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # global interfaces) then it's another non-standard case.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami "scoped object contains no versions");
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If this file has multiple inheritance chains with the public
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # SUNW_ name, that's wrong.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami "multiple $Ver inheritance chains (missing " .
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami "inheritance?): " .
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Produce an interface description for the object.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # For each version, generate a VERSION declaration of the form:
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # [TOP_]VERSION version direct-count total-count
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # There are two types of version that we suppress from this
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # The "base" version is used to hold symbols that must be
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # public, but which are not part of the versioning interface
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # (_end, _GLOBAL_OFFSET_TABLE_, _PROCEDURE_LINKAGE_TABLE_, etc).
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Any version with "private" in its name is skipped. We
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # expect these to be SUNWprivate, but are extra lenient in
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # what we accept.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If an object only has base or private versions, we do not produce
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # an interface description for that object.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # The use of 'pvs -v' is to identify the BASE version
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami foreach my $Line (split(/\n/, `pvs -dv $FullPath 2>&1`)) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Skip base version
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Skip private versions
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Directly inherited versions follow the version name
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # in a comma separated list within {} brackets. Capture
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # that information, for use with our VERSION line.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami my $InheritVers = ($Line =~ /(\{.*\});$/) ? "\t$1" : '';
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Older versions of pvs have a bug that prevents
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # them from printing [BASE] on the base version.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Work around this by excluding versions that end
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # with a '.so.*' suffix.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # SONAME of the object.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # We want to output the symbols in sorted order, so
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # we gather them first, and then sort the results.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # An array would suffice, but we have observed objects
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # with odd inheritance chains in which the same
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # sub-version gets inherited more than once, leading
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # to the same symbol showing up more than once. Using
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # a hash instead of an array thins out the duplicates.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami (split(/\n/, `pvs -ds -N $Line $FullPath 2>&1`)) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami if ($Sym =~ /:$/) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # If this is an inherited sub-version,
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # we don't need to continue unless
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # generating output in -I mode.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami last if !$opt{I};
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print INTFILE "\n" if !$opt{h} && ($ObjCnt != 0);
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami my $item = $TopVer{$Line} ? 'TOP_VERSION' : 'VERSION';
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Output symbols in sorted order
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami## ProcFindElf(file)
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Open the specified file, which must be produced by "find_elf -r",
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# and process the files it describes.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami open(FIND_ELF, $file) || die "$Prog: Unable to open $file";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # This script requires relative paths, created by the 'find_elf -r'
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # option. When this is done, the first non-comment line will always
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # be PREFIX. Obtain that line, or issue a fatal error.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami while ($line = onbld_elfmod::GetLine(\*FIND_ELF, \$LineNum)) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami die "$file: PREFIX expected on line $LineNum\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Process the remainder of the file.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami while ($line = onbld_elfmod::GetLine(\*FIND_ELF, \$LineNum)) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami my ($item, $obj, $alias) = split(/\s+/, $line, 3);
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami my $alias = defined($ObjToAlias{$obj}) ? $ObjToAlias{$obj} : '';
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # We are only interested in sharable objects. We may see
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # other file types if processing a list of objects
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # supplied via the -f option.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami ProcFile($prefix, $obj, $class, $type, $verdef, $alias);
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# -----------------------------------------------------------------------------
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Establish a program name for any error diagnostics.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# The onbld_elfmod package is maintained in the same directory as this
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# script, and is installed in ../lib/perl. Use the local one if present,
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# and the installed one otherwise.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami$moddir = "$moddir/../lib/perl" if ! -f "$moddir/onbld_elfmod.pm";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Check that we have arguments.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahramiif ((getopts('E:e:f:hIi:ow:', \%opt) == 0) || (!$opt{f} && ($#ARGV == -1))) {
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "usage: $Prog [-hIo] [-E errfile] [-e exfile] [-f listfile]\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t\t[-i intffile] [-w outdir] file | dir, ...\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-E errfile]\tdirect error output to file\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-e exfile]\texceptions file\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-f listfile]\tuse file list produced by find_elf -r\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-h]\tdo not produce a CDDL/Copyright header comment\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-I]\tExpand inheritance in -i output (debugging)\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-i intffile]\tcreate interface description output file\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-o]\t\tproduce one-liner output (prefixed with pathname)\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami print "\t[-w outdir]\tinterpret all files relative to given directory\n";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# If -w, change working directory to given location
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami!$opt{w} || chdir($opt{w}) || die "$Prog: can't cd to $opt{w}";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Error messages go to stdout unless -E is specified. $ErrFH is a
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# file handle reference that points at the file handle where error messages
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami open(ERROR, ">$opt{E}") || die "$Prog: open failed: $opt{E}";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Locate and process the exceptions file
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahramionbld_elfmod::LoadExceptionsToEXRE('interface_check');
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# If creating an interface description output file, prepare it for use
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami die "$Prog: Unable to create file: $opt{i}";
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Generate the output header
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami onbld_elfmod::Header(\*INTFILE, $0, \@SaveArgv) if !$opt{h};;
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Number of OBJECTs output to INTFILE
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# If we were passed a file previously produced by 'find_elf -r', use it.
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Process each argument
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami # Run find_elf to find the files given by $Arg and process them
75ce41a57ff334bd8fe2cb9ed51eea835892f944Ali Bahrami# Close any working output files.