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