lorder(1) [sunos man page]

lorder(1)							   User Commands							 lorder(1)

NAME

       lorder - find ordering relation for an object or library archive

SYNOPSIS

       lorder filename...

DESCRIPTION

       The input is one or more object or library archive filenames (see ar(1)).  The standard output is a list of pairs of object file or archive
       member names; the first file of the pair refers to external identifiers defined in the second. The output may be processed by  tsort(1)	to
       find  an  ordering  of a library suitable for one-pass access by ld. Note that the link editor ld is capable of multiple passes over an ar-
       chive in the portable archive format (see ar.h(3HEAD)) and does not require that lorder be used when building an  archive.   The  usage	of
       the lorder command may, however, allow for a more efficient access of the archive during the link edit process.

       The following example builds a new library from existing .o files.

	      ar -cr library `lorder *.o | tsort`

FILES

       TMPDIR/*symref	       temporary files

       TMPDIR/*symdef	       temporary files

       TMPDIR		       usually /var/tmp but can be redefined by setting the environment variable  TMPDIR (see tempnam() in tmpnam(3C))

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWbtool 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ar(1), ld(1), tsort(1), tmpnam(3C), ar.h(3HEAD), attributes(5)

NOTES

       lorder  will  accept as input any object or archive file, regardless of its suffix, provided there is more than one input file. If there is
       but a single input file, its suffix must be .o.

       The length of the filename for TMPDIR is limited to whatever sed allows.

SunOS 5.10							    29 Oct 1991 							 lorder(1)

lorder(1)						      General Commands Manual							 lorder(1)

NAME

       lorder - Finds the best order for member files in an object library

SYNOPSIS

       lorder file...

DESCRIPTION

       The lorder command is essentially obsolete.  Use the following command in its place: % ar -ts file.a

       The  lorder command reads one or more object or library archive files, looks for external references, and writes a list of paired filenames
       to standard output.  The first of each pair of files 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 1-pass access by ld.

       If object files do not end with lorder overlooks them and attributes their global symbols and references to some other file.

EXAMPLES

       To create a subroutine library, enter: lorder charin.o scanfld.o scan.o scanln.o |      tsort | xargs ar qv libsubs.a

       (Enter this command entirely on one line, not on two lines as shown above.)

       This  creates a subroutine library named libsubs.a that contains charin.o, scanfld.o, scan.o, and scanln.o. The ordering of the object mod-
       ules in the library is important. The lorder and tsort commands together add the subroutines to the library in the proper order.

       Suppose that scan.o calls entry points in scanfld.o and scanln.o.  scanfld.o also calls entry points in charin.o. First, the lorder command
       creates	a  list  of  pairs  that shows these dependencies: charin.o charin.o scanfld.o scanfld.o scan.o scan.o scanln.o scanln.o scanfld.o
       charin.o scanln.o charin.o scan.o scanfld.o

       This list is piped to the tsort command, which converts the list into the ordering that is needed:

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

       Note that each module precedes the module it calls.  charin.o, which does not call another module, is last. The second list is  then  piped
       to xargs, 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

       Temporary files

SEE ALSO

       Commands:  ar(1), as(1), cc(1), ld(1), make(1), nm(1), size(1), strip(1), tsort(1), xargs(1)

       Files:  a.out(4), ar(4)

																	 lorder(1)