binutils: ranlib
1
1 5 ranlib
1 ********
1
1 ranlib [--plugin NAME] [-DhHvVt] ARCHIVE
1
1 'ranlib' generates an index to the contents of an archive and stores
1 it in the archive. The index lists each symbol defined by a member of
1 an archive that is a relocatable object file.
1
1 You may use 'nm -s' or 'nm --print-armap' to list this index.
1
1 An archive with such an index speeds up linking to the library and
1 allows routines in the library to call each other without regard to
1 their placement in the archive.
1
1 The GNU 'ranlib' program is another form of GNU 'ar'; running
1 'ranlib' is completely equivalent to executing 'ar -s'. ⇒ar.
1
1 '-h'
1 '-H'
1 '--help'
1 Show usage information for 'ranlib'.
1
1 '-v'
1 '-V'
1 '--version'
1 Show the version number of 'ranlib'.
1
1 '-D'
1 Operate in _deterministic_ mode. The symbol map archive member's
1 header will show zero for the UID, GID, and timestamp. When this
1 option is used, multiple runs will produce identical output files.
1
1 If 'binutils' was configured with
1 '--enable-deterministic-archives', then this mode is on by default.
1 It can be disabled with the '-U' option, described below.
1
1 '-t'
1 Update the timestamp of the symbol map of an archive.
1
1 '-U'
1 Do _not_ operate in _deterministic_ mode. This is the inverse of
1 the '-D' option, above: the archive index will get actual UID, GID,
1 timestamp, and file mode values.
1
1 If 'binutils' was configured _without_
1 '--enable-deterministic-archives', then this mode is on by default.
1