Browse Source

Warn 'ar q' doesn't update archive ST index.

gdb-4_18-branch
Roland Pesch 35 years ago
parent
commit
8706a92ce1
  1. 17
      binutils/binutils.texinfo

17
binutils/binutils.texinfo

@ -121,11 +121,11 @@ subroutines.
@code{ar} will create an index to the symbols defined in relocatable @code{ar} will create an index to the symbols defined in relocatable
object modules in the archive when you specify the modifier @samp{s}. object modules in the archive when you specify the modifier @samp{s}.
Once created, this index is updated in the archive whenever @code{ar} Once created, this index is updated in the archive whenever @code{ar}
makes a change to its contents. An archive with such an index speeds up makes a change to its contents (save for the @samp{q} update operation).
linking to the library, and allows routines in the library to call each An archive with such an index speeds up linking to the library, and
other without regard to their placement in the archive. allows routines in the library to call each other without regard to
@c FIXME This auto-update may happen-always only for WRS version; Gumby their placement in the archive.
@c says, for instance, that it doesn't happen with 'q' updates elsewhere.
You may use @samp{nm -s} or @samp{nm +print-armap} to list this index You may use @samp{nm -s} or @samp{nm +print-armap} to list this index
table. If an archive lacks the table, another form of @code{ar} called table. If an archive lacks the table, another form of @code{ar} called
@ -177,15 +177,16 @@ If you specify no @var{files}, all the files in the archive are printed.
@item q @item q
@emph{Quick append}; add @var{files} to the end of @var{archive}, @emph{Quick append}; add @var{files} to the end of @var{archive},
without checking for replacement. without checking for replacement.
The modifiers @samp{a}, @samp{b}, and @samp{i} do @emph{not} affect this The modifiers @samp{a}, @samp{b}, and @samp{i} do @emph{not} affect this
operation; new members are always placed at the end of the archive. operation; new members are always placed at the end of the archive.
The modifier @samp{v} makes @code{ar} list each file as it is appended. The modifier @samp{v} makes @code{ar} list each file as it is appended.
@c FIXME: per Gumby, versions other than WRS of this will *not* auto-update Since the point of this operation is speed, the archive's symbol table
@c SYMDEF index on 'q' updates. index is not updated, even if it already existed; you can use @samp{ar s} or
@code{ranlib} explicitly to update the symbol table index.
@item r @item r
Insert @var{files} into @var{archive} (with @emph{replacement}). This Insert @var{files} into @var{archive} (with @emph{replacement}). This

Loading…
Cancel
Save