a
ar(1) | ar(1) |
p: v, f, F, s | |
x: | v, f, F, s, C, T |
EXTERNAL INFLUENCES
Environment Variables
The following internationalization variables affect the execution of ar:
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_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.
LC_TIME
Determines the format and contents of date and time formatting.
NLSPATH
Determines the location of message catalogues for the processing of LC_MESSAGES .
If any internationalization variable contains an invalid setting, ar behaves as if all internationalization variables are set to C. See environ(5).
In addition, the following environment variable affects ar:
TMPDIR
Speci®es a directory for temporary ®les (see tmpnam(3S)). The l modi®er overrides the TMPDIR variable, and TMPDIR overrides /var/tmp, the default directory.
DIAGNOSTICS
phase error on file name
The named ®le was modi®ed by another process while ar was copying it into the archive. When this happens, ar exits and the original archive is left untouched.
ar write error: file system error message
ar could not write to a temporary ®le or the ®nal output ®le. If ar was trying to write the ®nal output ®le, the original archive is lost.
ar reports cannot create ®le.a, where ®le.a is an
EXAMPLES
Create a new ®le (if one does not already exist) in archive format with its constituents entered in the order indicated:
ar r newlib.a f3 f2 f1 f4
Replace ®les f2 and f3 such that the new copies follow ®le f1, and f3 follows f2:
ar ma f1 newlib.a f2 f3 ar ma f2 newlib.a f3 ar r newlib.a f2 f3
The archive is then ordered:
newlib.a: f1 f2' f3' f4
where the single quote marks indicate updated ®les. The ®rst command says "move f2 and f3 after f1 in newlib.a", thus creating the order:
Section 1−22 | − 3 − |