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



-------------------------------------------------------------------------------
lorder



PURPOSE

Finds the best order for files in an object library.

SYNTAX


lorder -- file --|
        ^      |
        +------+


DESCRIPTION

The lorder command reads one or more object or library archive files, looking
for external references and writing a list of paired file names to standard
output.  The first file in each pair contains references to identifiers that
are defined in the second file.  You can send this list to the tsort command to
find an ordering of a library member file suitable for one-pass access by the
ld command.

The lorder command accepts any object or archive file regardless of its suffix
as long as multiple input files are specified.  A single file must have a .o
suffix.

EXAMPLE

To create a subroutine library:

  lorder charin.o scanfld.o scan.o scanln.o | tsort | xargs ar qv libsubs.a

This command creates a subroutine library named "libsubs.a" that contains the
files "charin.o", "scanfld.o", "scan.o", and "scanln.o".

The ordering of the object modules in the library is important.  The ld command
requires that each module precede all the other modules that it calls or
references.  The lorder and tsort commands together add the subroutines to the
library in the proper order.

Suppose that the file "scan.o" calls the files "scanfld.o" and "scanln.o".  The
file "scanfld.o" also calls the file "charin.o".  First, the lorder command
creates a list of pairs that shows these dependencies:








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

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



  charin.o charin.o
  scanfld.o scanfld.o
  scan.o scan.o
  scanln.o scanln.o
  scanfld.o charin.o
  scan.o scanfld.o
  scan.o scanln.o

Next, the | (vertical bar) sends this list to the tsort command, which converts
it into the ordering we need:

  scan.o
  scanfld.o
  scanln.o
  charin.o

Each module precedes the module it calls.  The file "charin.o", which does not
call another module, is last.

The second | (vertical bar) then sends this list to the xargs, command which
constructs and runs the following ar command:

  ar  qv  libsubs.a  scan.o  scanfld.o  scanln.o  charin.o

This ar command creates the properly ordered library.

FILES

/tmp/sym*           Temporary files.

RELATED INFORMATION

See the following commands:  "ar,"  "ld," "nm" "tsort," and "xargs."

See the ar file in AIX Operating System Technical Reference.




















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