shlibrpt(1) — AIX PS/2 1.2.1



SHLIBRPT(1,C)               AIX Commands Reference                SHLIBRPT(1,C)



-------------------------------------------------------------------------------
shlibrpt



PURPOSE

Generates a report file that aids in constructing a shared library.

SYNTAX


                                     +---------------+
shlibrpt --- list of object files ---|               |---|
                                     +- target file -+


DESCRIPTION

Given a list of object files ending in .o files that are to comprise a shared
library, this utility generates:

  o a shared lib specification file template;
  o an import.c file template;
  o an import.h file template; and
  o a complete cross reference, listing the imported and global variables and
    the files in which each variable is referenced or defined.

All output is directed to stdout by default, but can be placed into a single
output file by using I/O redirection.

After the output file is created you will have to edit it to produce the three
files required to make a shared library:

  o the specification file
  o import.h and
  o import.c.

In addition, the template files requires you to fill in certain items.  (The
general rule is to fill in items enclosed within < > braces.)  Since there is
no way to determine the type of a variable this must be filled in by you.  The
level of indirection can not be determined, so you must fill in the [*]
selection - the rule here is that the use of imported variables/routines adds
one extra level of indirection.  This extra level is taken care of in the
template, you must fill in the original level of indirection.

LIMITATIONS

  o All .o files must have a symbol table.
  o All .o files must be produced by the compiler or if assembled, the assembly
    language file must include the .file assembly directive; otherwise, the
    cross reference may fail.



Processed November 8, 1990       SHLIBRPT(1,C)                                1



SHLIBRPT(1,C)               AIX Commands Reference                SHLIBRPT(1,C)




EXAMPLES

In the directory containing the .o files which are to be placed into a shared
library, issue the following command:

  shlibrpt 'ls *.o' > REPORT

RELATED INFORMATION

See the following command:  "shlib2."

See the "Making a shared library" tutorial in AIX Operating System Programming
Tools and Interfaces.









































Processed November 8, 1990       SHLIBRPT(1,C)                                2

Museum

Related Articles