unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 lorder(1)							   lorder(1)




 NAME
      lorder - find ordering relation for an object library

 SYNOPSIS
      lorder [files]

 DESCRIPTION
      The input consists of one or more object or archive library files (see
      ar(1)) placed on the command line or read from standard input.  The
      standard output is a list of pairs of object file names, meaning that
      the first file of the pair refers to external identifiers defined in
      the second.  Output can be processed by tsort to find an ordering of a
      library suitable for one-pass access by ld (see tsort(1) and ld(1)).
      Note that the link editor ld is capable of multiple passes over an
      archive in the archive format and does not require that lorder be used
      when building an archive.	 Using the lorder command may, however,
      allow for a slightly more efficient access of the archive during the
      link edit process.

      The symbol table maintained by ar allows ld to randomly access symbols
      and files in the archive, making the use of lorder unnecessary when
      building archive libraries (see ar(1)).

 EXTERNAL INFLUENCES
    Environment Variables
      The following internationalization variables affect the execution of
      lorder:

      LANG Determines the locale category for native language, local customs
	   and coded character set in the absence of LC_ALL and other LC_*
	   environment variables.  If LANG is not specified or is set to the
	   empty string, a default of C (see lang(5)) is used instead of
	   LANG.

      LC_ALL
	   Determines the values for all locale categories and has
	   precedence over LANG and other LC_* environment variables.

      LC_COLLATE
	   Determines the locale category for character collation.

      LC_CTYPE
	   Determines the locale category for character handling functions.

      LC_MESSAGES
	   Determines the locale that should be used to affect the format
	   and contents of diagnostic messages written to standard error.

      LC_NUMERIC
	   Determines the locale category for numeric formatting.




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 lorder(1)							   lorder(1)




      NLSPATH
	   Determines the location of message catalogues for the processing
	   of LC_MESSAGES.

      If any internationalization variable contains an invalid setting,
      lorder behaves as if all internationalization variables are set to C.
      See environ(5).

    International Code Set Support
      Single- and multi-byte character code sets are supported.

 EXAMPLES
      Build a new library from existing .o files:

	   ar cr library `lorder *.o | tsort`

      When creating libraries with so many objects that the shell cannot
      properly handle the *.o expansion, the following technique may prove
      useful:

	   ls | grep '.o$' | lorder | tsort | xargs ar cq library

 WARNINGS
      Object files whose names do not end with .o are overlooked, even when
      contained in library archives.  Their global symbols and references
      are attributed to some other file.

 FILES
      /var/tmp/*symref	       temporary files
      /var/tmp/*symdef

 SEE ALSO
    System Tools:
      ar(1)		create archived libraries
      ld(1)		invoke the link editor

    Miscellaneous:
      tsort(1)		produce an ordered list of items (topological sort)

 STANDARDS CONFORMANCE
      lorder: SVID2, SVID3, XPG2, XPG4













 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000