gen_custom (3p)

Name

gen_custom - ate a purpose-built library.

Synopsis

gen_custom -lib lib  target [ -V ] [ -o output ] [ -tmp path  ]

Description

Perl Programmers Reference Guide                                gen_custom(3p)



NAME
       gen_custom - extract necessary routines from an archive library to cre-
       ate a purpose-built library.


SYNOPSIS
       gen_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  Oracle Solaris Studio Performance Library the results
       are undefined since the Oracle Solaris Studio  Performance  Library  is
       specially  constructed  and  the  script expects certain elements to be
       present for successful completion.



                                 January 2009                   gen_custom(3p)