lorder(1)

lorder(1)

NAME

lorder - ®nd ordering relation for an object library

SYNOPSIS

lorder [ ®les ]

DESCRIPTION

The input consists of one or more object or archive library ®les (see ar(1)) placed on the command line or read from standard input. The standard output is a list of pairs of object ®le names, meaning that the ®rst ®le of the pair refers to external identi®ers de®ned in the second. Output can be processed by tsort to ®nd 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 ef®cient access of the archive during the link edit process.

The symbol table maintained by ar allows ld to randomly access symbols and ®les 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 speci®ed 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.

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 ®les:

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 ®les 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 ®le.

l

HP-UX Release 11i: December 2000

− 1 −

Section 1−467