arのヘルプ・マニュアル／リナックスコマンド

arのヘルプ・マニュアル

help
man

ar --help

Usage: ar [emulation options] [-]{dmpqrstx}[abcfilNoPsSuvV] [member-name] [count] archive-file file... ar -M [ - read options from emulation options: No emulation specific options ar: supported targets: elf64-x86-64 elf32-i386 a.out-i386-linux pei-i386 pei-x86-64 elf64-l1om elf64-little elf64-big elf32-little elf32-big srec symbolsrec verilog tekhex binary ihex Report bugs to

man ar

ar(1) GNU Development Tools ar(1) 名前 ar - 書庫の作成、変更、および書庫からのファイルの取出しを行う書式 ar [-]{dmpqrtx}[abcilosSuvV] [membername] archive files... 説明 GNU arプログラムは書庫 ( archive ) ファイルの作成、変更、および書庫からのファイルの取出しを行う。書庫はいくつかのファイルを集めて一つのファイルにしたもので、内部からオリジナルのファイルそれぞれを復元することができるようになっている。内部に含まれるファイルを書庫のメンバーと呼ぶ。オリジナルのファイルの内容、モード (許可属性)、タイムスタンプ、オーナーおよびグループも書庫に保存され、取出しの際に再設定することができる。 GNU ar では、書庫に含まれるメンバーの名前の長さに制限はない。ただし ar のインストール時の設定によっては、制限が付いている場合があるかもしれない (他のツールで扱える書庫フォーマットとの互換性のためであることが多い) 。制限がある場合には、 15 文字 (a.out 関連フォーマット) または 16 文字 (coff 関連フォーマット) であることが多い。 ar はバイナリーユーティリティ (binary utility) とされている。なぜならこの種の書庫は汎用のサブルーチンをまとめたライブラリとして用いられることが多いからである。 ar は、書庫に入っているリロケータブルなオブジェクトモジュールに含まれるシンボルの索引 (index) を作成することができる。これは修正子 (modifier) ‘s’ が指定されたときの動作である。一度作成されると、この索引は ar によって書庫の内容が変更されるたびに更新される (ただし ‘q’ によって書庫が更新された場合を除く)。このような索引を持った書庫では、ライブラリとしてリンクされる場合の速度が向上する。またライブラリの内部に含まれるルーチンが、書庫内部での位置によらずお互いを呼び出すことができるようになる。 ‘nm -s’ または ‘nm --print-armap’ とすればこの索引をリストすることができる。書庫に索引がない場合は、 ar の別名である ranlib を用いて索引を追加することもできる。 ar の実行には最低 2 つの引数が必要である。一つは ar の動作 (operation) を指定する一文字の英字 (動作指定子 :keyletter) であり (他の英字が修正子として付随することもある)、もう一つは実際に操作の対象となる書庫の名前である。ほとんどの動作では動作対象とするファイルを files 引数として与えることもできる。オプション GNU arでは動作指定子 p と修正子 mod の順番は任意であるが、これらはまとめて最初のコマンドライン引数に与える必要がある。最初のコマンドライン引数の先頭にダッシュ (-) を加えてもかまわない。動作指定子 p では実行する動作を指定する。これには以下のどれかを指定する。複数指定することはできない。 d 書庫からモジュールを削除 ( Delete ) する。削除するモジュールの名前は files に指定する。もし一つもファイルが指定されなかった場合は、書庫に何の操作も行わない。修正子として v を指定すると、 ar は削除したモジュールをそれぞれ表示する。 m 書庫中のメンバーを移動 ( Move )する。一つのシンボルが書庫内部の複数のメンバーによって定義されている場合、メンバーの配置の順番が異なると、このライブラリへのリンクのされ方が予想とは異なる可能性がある。修正子による指定がなければ、 m による操作では files 引数によって指定されたメンバーを書庫の最後尾に移動する。移動先を修正子 ‘a’、 ‘b’、 i によって指定することもできる。 p 指定された書庫内部のメンバー (複数可) を標準出力に表示 ( Print ) する。 ‘v’ 修正子が指定された場合には、メンバーの内容を標準出力に表示する前にそのメンバーの名前を表示する。 files を指定しないと、書庫の内部のすべてのファイルが表示される。 q files を書庫の最後に追加する。このとき置き換えのチェックを行わない (Quickappend)。修正子 a、b、i はこの操作には影響しない。新しいメンバーは常に書庫の最後に配置される。修正子 vをつけるとar は追加する際にそれぞれのファイルを表示する。この操作のミソは速度なので、書庫のシンボルテーブルは更新されない (存在していても更新されない)。シンボルテーブルを明示的に更新させるには ar s または ranlib を用いればよい。しかし、 quick append の際に index が再構築されるとみなしているシステムがあまりにも多いので、 GNU ar の実装では q を r と同義としている。 r 書庫に files を挿入し、同名のファイルがあったら置換 ( Replace- ment ) する。この操作は q とは異なり、もとから書庫にあったメンバーのうち追加したメンバーと同名のものはすべて削除される。 files のリストの中に存在しないファイルがあった場合 ar はエラーを表示する。そしてそのメンバーに関しては古いものを書庫にそのまま残し、変更を行なわない。デフォルトでは新たなメンバーはファイルの最後に追加される。修正子 a、 b、 i を使えば、現在存在しているメンバーからの相対位置として、新たなファイルを追加する位置を指定することができる。この操作で修正子 v を用いると、挿入されるファイルを一行ずつ表示する。またこのとき a または r の文字を表示する。これはそれぞれファイルが追加 (append) された (つまり書庫には削除すべき古いメンバーが存在しなかった) か、置換 (replace) されたかに対応する。 t 書庫の内容の表 ( table ) を表示する。 files が指定された場合は、files のうち書庫に存在するものを表示する。通常はメンバーの名前のみが表示される。モード (パーミッション)、タイムスタンプ、オーナー、グループ、サイズなども表示させたい場合には、リクエストの際に同時に修正子 v をつければ良い。 files を指定しなければ、書庫にあるすべてのファイルがリストされる。同じ名前のファイル (仮に fie とする) が書庫 (b.a とする) に二つ以上存在する場合には、 ‘ar t b.a fie’ では最初のものしか表示しない。すべての fie を表示させたい場合には、書庫のファイル全てを表示させるように実行しなければならない (この例ならば ‘ar t b.a’ となる)。 x メンバーを書庫から取り出す ( eXtract )。この操作に修正子 v を用いると、 ar は取出したファイルをそれぞれ表示する。 files を何も指定しないと、書庫のすべてのファイルが取り出される。いくつかの修正子 ( mod ) を動作指定子 p に続けて指定することができる。これによって動作を調整することができる。 a 新たなファイルを、すでに書庫に存在するメンバーの後 ( after ) に追加する。修正子 a を用いる場合は、書庫にすでに存在するメンバーの名前を引数 membername として書庫名の指定の前に置かなければならない。 b 新たなファイルを、すでに書庫に存在するメンバーの前 ( before ) に追加する。修正子 b を用いる場合は、書庫にすでに存在するメンバーの名前を引数 membername として、書庫名の指定の前に置かなければならない。 ( i と同じ動作をする) c 書庫を作成 ( create ) する。書庫を更新する操作の場合には、指定した書庫が存在しなければ、それは常に作成される。しかしこのとき警告メッセージが出る。この修正子をあらかじめ同時に指定しておけば、この警告を抑止することができる。 f 書庫の中の名前を切りつめる。通常 ar では、ファイル名には任意の長さを指定できる。しかしこのことは、他のシステムのネイティブな ar プログラムと互換性のない書庫を作ってしまう原因にもなりかねない。もしこれが問題となるときは、修正子 f を用いれば書庫の中に入れるファイルの名前を切りつめることができる。 i 新しいファイルを書庫に存在するメンバーの前に挿入 (insert) する。この修正子 i を用いる際には、書庫に存在しているメンバーの名前を membername 引数として書庫の指定の前に置く必要がある。 ( b と同じ動作をする) l この修正子はエラーにはならないが何の効力もない。 o 書庫からメンバーを取り出すときに、元の日付を保存する (original) 。この修正子を指定しなければ、書庫から取り出されたファイルのタイムスタンプは取り出し時のものになる。 s オブジェクトファイルの索引を書庫に書き込むか、または存在する索引を更新する。書庫に何の変化がなくても更新は行われる。この修正子はどんな操作とも同時に用いることができるし、単独でも用いることができる。 ‘ar s’ を書庫に対して実行するのは、 ‘ranlib’ と等価である。 S 書庫のシンボルテーブルを作成しない。これは大きな書庫を構築する場合は結構な速度向上になる。結果としてできた書庫は、リンカからは使うことができない。シンボルテーブルをつくるには、最後の段階で実行される ar に S 修正子をつけないか、あるいはそのアーカイブに ran- lib を実行しなければならない。 u 通常 ar r... はリストされたすべてのファイルを書庫に挿入する。指定したファイルと同名のメンバーが書庫中にすでにあった時に、元のメンバーの方が古い場合に限って挿入を行いたい場合には、この修正子を使うと良い (update)。 ‘u’ 修正子を用いることができるのは r 操作 (replace) の場合に限られる。 qu の組み合わせは許されない。なぜならタイムスタンプをチェックすると ‘q’ 操作の速度面での利点が損なわれてしまうからである。 v この修正子は饒舌 ( verbose ) モードの動作を指定するために用いられる。 ‘v’ 修正子が追加されると、多くの操作において、より詳細な情報が表示される (例えば処理しているファイル名など)。 V この修正子は ar のバージョン番号を表示する。関連項目 info の ‘ binutils ’ エントリ、 The GNU Binary Utilities, Roland H. Pesch (October 1991)、 nm(1)、 ranlib(1) 著作権 Copyright (c) 1991 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the en- tire resulting derived work is distributed under the terms of a permis- sion notice identical to this one. Permission is granted to copy and distribute translations of this manu- al into another language, under the above conditions for modified ver- sions, except that this permission notice may be included in transla- tions approved by the Free Software Foundation instead of in the origi- nal English. cygnus support 5 November 1991 ar(1)

AR(1) GNU Development Tools AR(1) NAME ar - create, modify, and extract from archives SYNOPSIS ar [--plugin name] [-X32_64] [-]p[mod [relpos] [count]] archive [member...] DESCRIPTION The GNU ar program creates, modifies, and extracts from archives. An archive is a single file holding a collection of other files in a structure that makes it possible to retrieve the original individual files (called members of the archive). The original files’ contents, mode (permissions), timestamp, owner, and group are preserved in the archive, and can be restored on extraction. GNU ar can maintain archives whose members have names of any length; however, depending on how 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). ar is considered a binary utility because archives of this sort are most often used as libraries holding commonly needed subroutines. ar creates an index to the symbols defined in relocatable object modules in the archive when you specify the modifier s. Once created, this index is updated in the archive whenever ar makes a change to its contents (save for the q update operation). 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 their placement in the archive. You may use nm -s or nm --print-armap to list this index table. If an archive lacks the table, another form of ar called ranlib can be used to add just the table. GNU ar can optionally create a thin archive, which contains a symbol index and references to the original copies of the member files of the archives. Such an archive is useful for building libraries for use within a local build, where the relocatable objects are expected to remain available, and copying the contents of each object would only waste time and space. Thin archives are also flattened, so that adding one or more archives to a thin archive will add the elements of the nested archive individually. The paths to the elements of the archive are stored relative to the archive itself. GNU ar is designed to be compatible with two different facilities. You can control its activity using command-line options, like the different varieties of ar on Unix systems; or, if you specify the single command- line option -M, you can control it with a script supplied via standard input, like the MRI "librarian" program. OPTIONS GNU ar allows you to mix the operation code p and modifier flags mod in any order, within the first command-line argument. If you wish, you may begin the first command-line argument with a dash. The p keyletter specifies what operation to execute; it may be any of the following, but you must specify only one of them: d Delete modules from the archive. Specify the names of modules to be deleted as member...; the archive is untouched if you specify no files to delete. If you specify the v modifier, ar lists each module as it is deleted. m Use this operation to move members in an archive. The ordering of members in an archive can make a difference in how programs are linked using the library, if a symbol is defined in more than one member. If no modifiers are used with "m", any members you name in the member arguments are moved to the end of the archive; you can use the a, b, or i modifiers to move them to a specified place instead. p Print the specified members of the archive, to the standard output file. If the v modifier is specified, show the member name before copying its contents to standard output. If you specify no member arguments, all the files in the archive are printed. q Quick append; Historically, add the files member... to the end of archive, without checking for replacement. The modifiers a, b, and i do not affect this operation; new members are always placed at the end of the archive. The modifier v makes ar list each file as it is appended. Since the point of this operation is speed, the archive’s symbol table index is not updated, even if it already existed; you can use ar s or ranlib explicitly to update the symbol table index. However, too many different systems assume quick append rebuilds the index, so GNU ar implements q as a synonym for r. r Insert the files member... into archive (with replacement). This operation differs from q in that any previously existing members are deleted if their names match those being added. If one of the files named in member... does not exist, ar displays an error message, and leaves undisturbed any existing members of the archive matching that name. By default, new members are added at the end of the file; but you may use one of the modifiers a, b, or i to request placement relative to some existing member. The modifier v used with this operation elicits a line of output for each file inserted, along with one of the letters a or r to indicate whether the file was appended (no old member deleted) or replaced. t Display a table listing the contents of archive, or those of the files listed in member... that are present in the archive. Normally only the member name is shown; if you also want to see the modes (permissions), timestamp, owner, group, and size, you can request that by also specifying the v modifier. If you do not specify a member, all files in the archive are listed. If there is more than one file with the same name (say, fie) in an archive (say b.a), ar t b.a fie lists only the first instance; to see them all, you must ask for a complete listing---in our example, ar t b.a. x Extract members (named member) from the archive. You can use the v modifier with this operation, to request that ar list each name as it extracts it. If you do not specify a member, all files in the archive are extracted. Files cannot be extracted from a thin archive. A number of modifiers (mod) may immediately follow the p keyletter, to specify variations on an operation’s behavior: a Add new files after an existing member of the archive. If you use the modifier a, the name of an existing archive member must be present as the relpos argument, before the archive specification. b Add new files before an existing member of the archive. If you use the modifier b, the name of an existing archive member must be present as the relpos argument, before the archive specification. (same as i). c Create the archive. The specified archive is always created if it did not exist, when you request an update. But a warning is issued unless you specify in advance that you expect to create it, by using this modifier. D Operate in deterministic mode. When adding files and the archive index use zero for UIDs, GIDs, timestamps, and use consistent file modes for all files. When this option is used, if ar is used with identical options and identical input files, multiple runs will create identical output files regardless of the input files’ owners, groups, file modes, or modification times. f Truncate names in the archive. GNU ar will normally permit file names of any length. This will cause it to create archives which are not compatible with the native ar program on some systems. If this is a concern, the f modifier may be used to truncate file names when putting them in the archive. i Insert new files before an existing member of the archive. If you use the modifier i, the name of an existing archive member must be present as the relpos argument, before the archive specification. (same as b). l This modifier is accepted but not used. N Uses the count parameter. This is used if there are multiple entries in the archive with the same name. Extract or delete instance count of the given name from the archive. o Preserve the original dates of members when extracting them. If you do not specify this modifier, files extracted from the archive are stamped with the time of extraction. P Use the full path name when matching names in the archive. GNU ar can not create an archive with a full path name (such archives are not POSIX complaint), but other archive creators can. This option will cause GNU ar to match file names using a complete path name, which can be convenient when extracting a single file from an archive created by another tool. s Write an object-file index into the archive, or update an existing one, even if no other change is made to the archive. You may use this modifier flag either with any operation, or alone. Running ar s on an archive is equivalent to running ranlib on it. S Do not generate an archive symbol table. This can speed up building a large library in several steps. The resulting archive can not be used with the linker. In order to build a symbol table, you must omit the S modifier on the last execution of ar, or you must run ranlib on the archive. T Make the specified archive a thin archive. If it already exists and is a regular archive, the existing members must be present in the same directory as archive. u Normally, ar r... inserts all files listed into the archive. If you would like to insert only those of the files you list that are newer than existing members of the same names, use this modifier. The u modifier is allowed only for the operation r (replace). In particular, the combination qu is not allowed, since checking the timestamps would lose any speed advantage from the operation q. v This modifier requests the verbose version of an operation. Many operations display additional information, such as filenames processed, when the modifier v is appended. V This modifier shows the version number of ar. ar ignores an initial option spelt -X32_64, for compatibility with AIX. The behaviour produced by this option is the default for GNU ar. ar does not support any of the other -X options; in particular, it does not support -X32 which is the default for AIX ar. The optional command line switch --plugin name causes ar to load the plugin called name which adds support for more file formats. This option is only available if the toolchain has been built with plugin support enabled. @file Read command-line options from file. The options read are inserted in place of the original @file option. If file does not exist, or cannot be read, then the option will be treated literally, and not removed. Options in file are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The file may itself contain additional @file options; any such options will be processed recursively. SEE ALSO nm(1), ranlib(1), and the Info entries for binutils. COPYRIGHT Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". binutils-2.20.51.0.2 2019-02-26 AR(1)

リナックスコマンド