diff options
Diffstat (limited to 'binutils/binutils.texinfo')
| -rwxr-xr-x | binutils/binutils.texinfo | 36 |
1 files changed, 13 insertions, 23 deletions
diff --git a/binutils/binutils.texinfo b/binutils/binutils.texinfo index 59068d8..ef61e69 100755 --- a/binutils/binutils.texinfo +++ b/binutils/binutils.texinfo @@ -107,8 +107,12 @@ The original files' contents, mode (permissions), timestamp, owner, and group are preserved in the archive, and may be reconstituted on extraction. -Only the first fifteen characters of a file name are kept in archives. -@c FIXME: with BFD version, this depends on obj format. +GNU @code{ar} can maintain archives whose members have names of any +length; however, depending on how @code{ar} is configured on your +system, a limit on member-name length may be imposed (for compatibility +with archive formats maintained with other tools). If it exists, the +limit is often 15 characters (typical of formats related to a.out) or 16 +characters (typical of formats related to coff). @code{ar} is considered a binary utility because archives of this sort are most often used as @dfn{libraries} holding commonly needed @@ -149,10 +153,6 @@ any of the following, but you must specify only one of them: be deleted as @var{files}; the archive is untouched if you specify no files to delete. -If you wish to delete an archive's index, you can use this option to do -it; the internal name of the index (which you will need to specify in -@var{files} to delete it) is @samp{__.SYMDEF}. - If you specify the @samp{v} option flag, @code{ar} will list each module as it is deleted. @@ -173,9 +173,7 @@ specified place instead. output file. If the @samp{v} option flag is specified, show the member name before copying its contents to standard output. -If you specify no @var{files}, all the files in the archive are printed, -save for the index (if any), which is listed only if you ask for it by -name: @samp{__.SYMDEF}. +If you specify no @var{files}, all the files in the archive are printed. @item q @emph{Quick append}; add @var{files} to the end of @var{archive}, @@ -215,9 +213,7 @@ see the modes (permissions), timestamp, owner, group, and size, you can request that by also specifying the @samp{v} option flag. If you do not specify any @var{files}, all files in the archive -are listed; but the index to symbols from relocatable modules, called -@samp{__.SYMDEF}, is not listed unless you explicitly request it by -name. +are listed. If there is more than one file with the same name (say, @samp{fie}) in an archive (say @samp{b.a}), @samp{ar t b.a fie} will list only the @@ -232,10 +228,7 @@ use the @samp{v} option flag with this operation, to request that @code{ar} list each name as it extracts it. If you do not specify any @var{files}, all files in the archive -are extracted; but the index to symbols from relocatable modules, called -@samp{__.SYMDEF}, is not extracted unless you explicitly request it by -name. -@c FIXME: does __.SYMDEF appear in all BFD arch formats? If not, which? +are extracted. @end table @@ -268,9 +261,9 @@ member must be present as the @var{membername} argument, before the @var{archive} specification. (same as @samp{b}). @item l -This option flag is recognized but not used; it is permitted for -compatibility with other forms of @code{ar}. -@c FIXME ar l modifier???---pesch@@cygnus.com, 25jan91 +This option flag is accepted but not used. +@c whaffor ar l modifier??? presumably compat; with +@c what???---pesch@@cygnus.com, 25jan91 @item o Preserve the @emph{original} dates of members when extracting them. If @@ -349,7 +342,7 @@ names. @item +print-armap @itemx -s When listing symbols from archives, list the index: a mapping (stored in -the archive by @code{ar} or @code{ranlib} of what modules contain +the archive by @code{ar} or @code{ranlib}) of what modules contain definitions for what names. @item +print-file-name @@ -481,9 +474,6 @@ stores it in the archive. The index lists each symbol defined by a member of an archive that is a relocatable object file. You may use @code{nm -s} or @code{nm +print-armap} to list this table. -The index is internally stored in the archive under the name -@samp{__.SYMDEF}. -@c FIXME does __.SYMDEF exist in archives in all flavors? (ranlib) An archive with such an index speeds up linking to the library, and allows routines in the library to call each other without regard to |