llvm-ar - クラウド上のオンライン

プログラム：

NAME

llvm-ar - LLVM アーカイバ

SYNOPSIS

llvm-ar [-]{dmpqrtx}[ラビコウ] [relpos] [カウント] [ファイル...]

DESCRIPTION

　 llvm-ar コマンドは一般的な Unix ユーティリティに似ています。 ar。 複数のファイルをアーカイブします
XNUMX つのファイルにまとめます。 この目的は、LLVM によってアーカイブ ライブラリを生成することです。
LLVM プログラムにリンクできるビットコード。 ただし、アーカイブにはあらゆる種類のファイルを含めることができます。
ファイルの。 デフォルトでは、 llvm-ar リンクを高速化するシンボル テーブルを生成します。
参照する必要があるのはシンボル テーブルのみであり、
アーカイブ。

　 llvm-ar コマンドは次の目的で使用できます read SVR4、GNU、BSD スタイルのアーカイブ ファイル。 しかし、
現時点では GNU 形式でのみ書き込むことができます。 SVR4 または BSD スタイルのアーカイブが使用されている場合
r (交換) または q (クイック更新) 操作では、アーカイブは次のように再構築されます。
GNU形式。

ここが llvm-ar 前から離れる ar 実装：

シンボル 表
Since llvm-ar ビットコードファイルをサポートします。 作成されるシンボル テーブルは GNU 形式であり、
ネイティブ ファイルとビットコード ファイルの両方が含まれます。

長い パス
現在 llvm-ar GNU および BSD の長いファイル名を読み取ることができますが、アーカイブの書き込みのみが可能です。
GNU フォーマット。

OPTIONS

するオプション llvm-ar 他と互換性があります ar 実装。 ただし、
いくつかの修飾子 (R) 他のものでは見つからない ar 実装。 オプションは、 llvm-ar
アーカイブに対して実行する単一の基本操作、さまざまな修飾子を指定します。
その操作、アーカイブ ファイルの名前、およびオプションのファイル名のリスト。 これらは
オプションは、方法を決定するために使用されます llvm-ar アーカイブ ファイルを処理する必要があります。

操作と修飾子については、以下のセクションで説明します。 最小限のセットは、
options は、少なくとも XNUMX つの演算子とアーカイブの名前です。 通常、アーカイブファイルは終了します
また、 .a 接尾辞を追加しますが、これは必須ではありません。 続いて、 アーカイブ名 のリストが来る
ファイル 操作対象のアーカイブの特定のメンバーを示します。 もし ファイル オプション
は指定されていませんが、通常、メンバーに応じて「なし」または「すべて」のメンバーを意味します。
操作。

業務執行統括
d
アーカイブからファイルを削除します。 この操作には修飾子は適用できません。 の
ファイル オプションは、アーカイブから削除するメンバーを指定します。 それはではありません
指定されたファイルがアーカイブに存在しない場合はエラーになります。 いいえの場合 ファイル 指定されている、
アーカイブは変更されません。

マ[アビ]
ファイルをアーカイブ内のある場所から別の場所に移動します。 の a, b, i 修飾子が適用される
この操作に。 の ファイル すべては修飾子で指定された場所に移動されます。
修飾子が使用されない場合、ファイルはアーカイブの最後に移動されます。 いいえの場合
ファイル が指定されている場合、アーカイブは変更されません。

p
ファイルを標準出力に出力します。 この操作では単に ファイル に指示された
標準出力。 いいえの場合 ファイル を指定すると、アーカイブ全体が印刷されます。
端末の設定を混乱させる可能性があるため、ビットコード ファイルを印刷することはお勧めできません。 の
p この操作によってアーカイブが変更されることはありません。

q
ファイルをアーカイブの末尾にすばやく追加します。 この操作により、 ファイル
最初に削除する必要がある重複をチェックせずにアーカイブにコピーします。 いいえの場合
ファイル が指定されている場合、アーカイブは変更されません。 そのやり方のせいで、 llvm-ar
アーカイブ ファイルを構築しますが、 q 操作は、
r 操作。

らぶ
ファイルメンバーを置換または挿入します。 の a, b, u 修飾子はこの操作に適用されます。
この操作は既存のものを置き換えます ファイル または、次の場合はアーカイブの最後に挿入します。
それらは存在しません。 いいえの場合 ファイル が指定されている場合、アーカイブは変更されません。

テレビ]
目次を印刷します。 修飾子を何も指定しないと、この操作は単に
メンバーの名前を標準出力に出力します。 とともに v 修飾子、 llvm-ar 印刷もします
ファイルタイプ (B=ビットコード、S=シンボルテーブル、ブランク=通常ファイル)、許可モード、
所有者とグループ、サイズ、日付。 もしあれば ファイル が指定されている場合、リストは
それらのファイルのみ。 いいえの場合 ファイル が指定されていると、全体の目次が表示されます。
アーカイブが印刷されます。

x[oP]
アーカイブ メンバーをファイルに抽出します。 の o 修飾子はこの操作に適用されます。 これ
操作は指定されたものを取得します ファイル アーカイブから取得して、
オペレーティング システムのファイル システム。 いいえの場合 ファイル が指定されている場合、アーカイブ全体が
エキス。

修飾子 （手術 明確な）
以下の修飾子は特定の操作に固有です。 「操作」セクション (上記) を参照してください。
どの修飾子がどの操作に適用できるかを決定します。

[A]
メンバー ファイルを挿入または移動する場合、このオプションは新しいファイルの宛先を指定します。
ファイルはその後にあるものとして、 レルポス メンバー。 もしも レルポス が見つからない場合、ファイルは次の場所に配置されます。
アーカイブの終わり。

[B]
メンバー ファイルを挿入または移動する場合、このオプションは新しいファイルの宛先を指定します。
ファイルは以前のものとして レルポス メンバー。 もしも レルポス 見つからない場合は、ファイルが配置されます
アーカイブの最後にあります。 この修飾子は i 修飾子。

[I]
の同義語 b オプションを選択します。

[o]
ファイルを抽出するときに、このオプションを使用すると、 llvm-ar オリジナルを保存するために
書き込まれるファイルの変更時刻。

[う]
アーカイブ内の既存のファイルを置き換える場合は、期限が切れているファイルのみを置き換えます。
アーカイブ内のメンバーのタイムスタンプよりもスタンプが大きくなります。

修飾子 （ジェネリック）
以下の修飾子はどの操作にも適用できます。

[c]
すべての操作において、 llvm-ar アーカイブが存在しない場合は常に作成されます。
通常は、 llvm-ar アーカイブが実行されていることを示す警告メッセージが出力されます。
作成した。 この修飾子を使用すると、その警告がオフになります。

[S]
この修飾子は、アーカイブ インデックス (またはシンボル テーブル) をアーカイブに追加するように要求します。
これがデフォルトの動作モードです。 シンボル テーブルには、外部のすべてのシンボルが含まれます。
アーカイブ内のすべてのビットコード ファイルによって定義された可視関数とグローバル変数。

[NS]
この修飾子は、 s 修飾子。 指示する llvm-ar を構築しないように
シンボルテーブル。 両方の場合 s & S を使用すると、オプション内で最後に出現する修飾子が
勝ちます。

[V]
この修飾子は指示します llvm-ar 何をしているのかを詳しく説明します。 それぞれの編集
アーカイブに対して操作を実行すると、何が行われているかを示す出力行が生成されます。
行います。

規格

　 llvm-ar このユーティリティは、IEEE Std 1003.2 (POSIX.2) のスーパーセットを提供することを目的としています。
の機能 ar. llvm-ar SVR4 と BSD4.4 (または Mac OS X) アーカイブの両方を読み取ることができます。 もし
f 修飾子が与えられるのは、 x or r その後の操作 llvm-ar SVR4互換を書き込みます
アーカイブ。 この修飾子がないと、 llvm-ar BSD4.4 と互換性のあるアーカイブを書き込みます。
ヘッダーの直後に長い名前があり、「#1/ddd」表記を使用して示されます。
ヘッダーの名前。

FILE FORMAT

LLVM アーカイブ ファイルのファイル形式は、BSD 4.4 または Mac OSX アーカイブのファイル形式に似ています。
ファイル。 実際、シンボルテーブルを除いて、 ar それらのオペレーティング システム上のコマンド
LLVM アーカイブ ファイルを読み取れる必要があります。 ファイル形式の詳細は次のとおりです。

各アーカイブは、印刷可能な XNUMX 文字であるアーカイブ マジック ナンバーで始まります。
「！ n" ここで、n は改行文字 (0x0A) を表します。マジックナンバーに続いて、
ファイルは、アーカイブ ヘッダーで始まり、次で終わる偶数の長さのメンバーで構成されます。
必要に応じてパディング文字（長さを均等にするため）。 各ファイルメンバーは構成されています
ヘッダー (以下に定義)、オプションの改行で終わる「長いファイル名」、および
ファイルの内容。

ヘッダーのフィールドについては、以下の項目で説明します。 ヘッダーのすべてのフィールド
ASCII 文字のみを含み、左揃えで右にスペースが埋め込まれます。
文字。

名前 - 文字[16]
ヘッダーのこのフィールドには、アーカイブ メンバーの名前が示されます。 名前が長ければ
15 文字未満、またはスラッシュ (/) 文字が含まれる場合、このフィールドには次の内容が含まれます #1/nnn
コラボレー NNN 名前の長さと、 #1/ 文字通りです。 この場合、
ファイルの実際の名前は、 NNN ヘッダーの直後のバイト。
名前が 15 文字以下の場合は、このフィールドに直接含まれます。
スラッシュ (/) 文字で終了します。

日付 - 文字[12]
このフィールドには、ファイルの変更日が XNUMX 進数の形式で表示されます。
エポックからの秒数を示すエンコードされた数値 (00 月 00:00:XNUMX 以降)
1、1970) Posix 仕様に従って。

uid - 文字[6]
このフィールドは、XNUMX 進数の ASCII 文字列としてエンコードされたファイルのユーザー ID を提供します。 これ
Unix 以外のシステムではフィールドはあまり意味を持たない可能性があります。 Unix では、次の値と同じです。
によって返される stat 構造体の st_uid フィールド STAT(2) オペレーティング システム コール。

gid - 文字[6]
このフィールドは、XNUMX 進数の ASCII 文字列としてエンコードされたファイルのグループ ID を提供します。 これ
Unix 以外のシステムではフィールドはあまり意味を持たない可能性があります。 Unix では、次の値と同じです。
によって返される stat 構造体の st_gid フィールド STAT(2) オペレーティング システム コール。

モード - 文字[8]
このフィールドは、XNUMX 進数の ASCII 文字列としてエンコードされたファイルのアクセス モードを提供します。 これ
Unix 以外のシステムではフィールドはあまり意味を持たない可能性があります。 Unix では、次の値と同じです。
によって返される stat 構造体の st_mode フィールド STAT(2) オペレーティング システム コール。

サイズ - 文字[10]
このフィールドは、XNUMX 進数の ASCII 文字列としてエンコードされたファイルのサイズをバイト単位で示します。

fmag - 文字[2]
このフィールドは、アーカイブ ファイル メンバーのマジックナンバーです。 その内容は常にXNUMXつです
バックティック (0x60) と改行 (0x0A) の文字。 これにより、何らかの測定ユーティリティが提供されます。
破損したアーカイブ ファイルを特定します。

offset - VBR エンコードされた 32 ビット整数
オフセット項目は、ビットコード メンバーが存在するアーカイブ ファイルへのオフセットを提供します。
シンボルに関連付けられて保存されます。 オフセット値は開始時点で 0 になります。
最初の「通常の」ファイル メンバー。 メンバーの実際のファイル オフセットを取得するには、次のようにします。
ファイル署名 (8 バイト) と記号が占めるバイト数を追加する必要があります。
テーブル。 この項目の値は、ビットレートを削減するために可変ビット レート エンコーディングを使用してエンコードされます。
シンボルテーブルのサイズ。 可変ビット レート エンコードでは、上位ビット (0x80) が使用されます。
各バイトは、さらに続くバイトがあるかどうかを示します。 それぞれの残りの 7 ビット
値のバイトキャリービット。 最終バイトには上位ビットが設定されていません。

length - VBR エンコードされた 32 ビット整数
長さ項目は、その後に続くシンボルの長さを示します。 このような オフセット アイテム、
長さは可変ビット レートでエンコードされます。

シンボル - 文字配列
シンボル項目は、に関連付けられたシンボルのテキストを提供します。 オフセットを選択します。
シンボルは文字で終了していません。 その長さは、 長さ フィールド。
非印刷文字 (0x00 であっても) を使用することは許可されています (ただし賢明ではありません)。
シンボル。 これにより、シンボル名の複数のエンコードが可能になります。

EXIT ステータス

If llvm-ar 成功すると、0 で終了します。使用法エラーの場合は、終了コード 1 が発生します。
ハード (通常はファイル システム) エラーの場合、終了コード 2 が発生します。その他または不明です。
エラーの場合は終了コード 3 が発生します。

onworks.net サービスを使用してオンラインで llvm-ar を使用する