gen_custom(3p)gen_custom(3p)NAMEgen_custom - extract necessary routines from an archive library to cre‐
ate a purpose-built library.
SYNOPSISgen_custom-lib lib target [ -V ] [ -o output ] [ -tmp path ]
DESCRIPTION
The gen_custom command extracts a subset of routines from an archive
library and recombines them into a customized library specific to the
target file which can be an object file, archive library, shared
library, or executable.
gen_custom-lib library target
The target file is opened and analyzed for unsatisfied external
references. References that can be satisfied from the library
file are extracted and recombined into the output library.
OPTIONS
if /usr/bin/perl is not installed on the system, a failure will result
"gen_custom: Command not found", even though it is perl, not gen_custom
that is missing. If the version of perl on the system is not recent
enough, the script may fail with a message about an undefined variable.
-tmp path
Specify a path to a directory where temporary files can be
stored briefly. If the specified directory doesn't exist, the
script will exit with an error message:
Unable to open files in specified temporary directory >path<
-o output
The default name for the custom library is libCustom.a (libCus‐
tom.so is also created). If the -o flag is specified, the cre‐
ated library will have the desired name.
-V Verbose output. The script will output (to standard out) a list
of symbols called directly from the target and symbols called
indirectly.
The script can be executed on :
an object file :
gen_custom-lib /opt/SUNWspro/prod/lib/libsunperf.a -o myLib
myObj.o
Resulting in libmyLib.a and libmyLib.so
an executable :
gen_custom-lib /opt/SUNWspro/prod/lib/libsunperf.a myApp
Resulting in libCustom.a and libCustom.so
an archive library :
gen_custom-lib /opt/SUNWspro/prod/lib/libsunperf.a -o optBLAS
liblapack.a
Resulting in liboptBLAS.a and liboptBLAS.so
a shared library :
gen_custom-lib /opt/SUNWspro/prod/lib/libsunperf.a libscala‐
pack.so
Resulting in libCustom.a and libCustom.so
NOTES
While it is possible to run the gen_custom script on archive libraries
other than the Sun Performance Library the results are undefined since
the Sun Performance Library is specially constructed and the script
expects certain elements to be present for successful completion.
January 2009 gen_custom(3p)