git-pack-objects(1) Manual Page

ファイルのペア(.packと.idx)に書き込み、そして、 <base-name> を使用して、作成されたファイルの名前を決定します。このオプションを使用すると、ペアの2つのファイルが <base-name>-<SHA-1>.{pack,idx} ファイルに書き込まれます。 <SHA-1>は、パックの内容に基づくハッシュであり、コマンドの標準出力にも書き込まれます。

パックの内容(.packファイルに書き込まれる内容)を標準出力に書き込みます。

個々のオブジェクト名ではなく、標準入力からリビジョン引数を読み取ります。リビジョン引数は、 git rev-list と同じ方法で処理され、 --objects フラグはその「commit」引数を使用して、出力するオブジェクトのリストを作成します。結果のリストのオブジェクトはパックされます。リビジョンに加えて、 --not または --shallow <SHA-1> 行も受け入れられます。

これは --revs の指定を含んでいます。標準入力から読み取られたリビジョン引数のリストを処理するときは、オブジェクトのパッキングを未だパックされていないオブジェクトに制限してください。

これは --revs の指定を含んでいます。標準入力から読み取られたリビジョン引数のリストに加えて、 refs/ の下のすべてのrefが含まれるように指定してあるかのように振る舞います。

参照するオブジェクトが結果のパックファイルに含まれている場合は、要求されていない注釈付きタグを含めます。これは、ネイティブGitクライアントに新しいタグを送信するのに役立ちます。

オブジェクト名やリビジョン引数ではなく、標準入力からパックファイル(例: pack-1234abcd.pack)のベース名を読み取ります。 結果のパックには、除外されたパック( ^ で始まる)にリストされているオブジェクトを除く、含まれているパック(^ で始まらないもの)にリストされているすべてのオブジェクトが含まれます。

到達不能なオブジェクトを、 .mtimes ファイルの存在によって示される別の「クラフト・パック」にパックします。 通常は git repack --cruft で使用されます。 呼び出し元はパック名のリストを提供し、 リポジトリに残すパックと、 削除するパック(接頭辞 - )を指定します。 クラフト・パックの内容は、 既存パックに含まれていない全てのオブジェクトで、 猶予期間(下記 --cruft-expiration 参照)を過ぎて無いもの、 または、 自身は猶予期間を過ぎているものの、 まだ期限が切れていない他のオブジェクトから到達可能なものです。

指定されている場合、 mtime が <approxidate> よりも古いオブジェクトはクラフト・パック(cruft pack)から削除されます。 指定されていない(そして --cruft が指定されている)場合、オブジェクトは削除されません。

これらの2つのオプションは、パックに含まれるオブジェクトをデルタ圧縮を使用して格納する方法に影響します。オブジェクトは最初にタイプとサイズ、および、オプションで名前で、内部的にソートされ、 --window 内の他のオブジェクトと比較されて、デルタ圧縮を使用することでスペースが節約されるかどうかが確認されます。 --depth は、最大デルタ深度を制限します。 深くしすぎると、必要なオブジェクトに到達するために差分データを何度も適用する必要があるため、パック解凍側のパフォーマンスに影響します。

このオプションは、 --window に加えて追加の制限を提供します。ウィンドウサイズは、メモリ内で <n> バイトを超えないように動的に縮小されます。これは、大きなオブジェクトと小さなオブジェクトが混在するリポジトリで、大きなウィンドウでメモリを使い果たさないようにしつつ、小さなオブジェクトには大きなウィンドウを活用できるようにするために有効です。サイズには、「k」または「m」または「g」の接尾辞を付けることができます。 --window-memory=0 は、メモリ使用量を無制限にします。デフォルトは、 pack.windowMemory 構成変数から取得されます。

めったにないシナリオですが、ファイルシステム上に特定のサイズより大きいファイルを作成できない場合があります。このオプションを使用して、出力パックファイルをそれぞれ指定されたサイズ以下の複数の独立したパックファイルに分割するようにコマンドに指示できます。 サイズには、「k」または「m」または「g」の接尾辞を付けることができます。許可される最小サイズは1MiBに制限されています。 構成変数 pack.packSizeLimit が設定されていない限り、デフォルトは無制限です。このオプションを使用すると、リポジトリが大きくなり、速度が低下する可能性があることに注意してください。 pack.packSizeLimit の説明を参照してください。

このフラグにより、.keepファイルを含むローカルパックにすでに含まれているオブジェクトは、他の方法でパックされていたとしても無視されます。

このフラグにより、指定のパックにすでに含まれているオブジェクトは、他の方法でパックされていたとしても無視されます。 <pack-name> は、先頭にディレクトリ名がないパックファイル名です(例: pack-123.pack)。このオプションは、複数のパックを保持するために複数回指定できます。

このフラグにより、すでにパックされているオブジェクトは、他の方法でパックされていたとしても無視されます。

このフラグにより、代替オブジェクトストアから借用されたオブジェクトは、他の方法でパックされていたとしても無視されます。

少なくとも1つのオブジェクトが含まれる場合にのみパックされたアーカイブを作成します。

-q が指定されていない場合、進行状況は、端末に接続されている場合、デフォルトで標準エラーストリームに報告されます。このフラグは、標準エラーストリームが端末に送信されていない場合でも、進行状況を強制します。

--stdout を指定すると、進行状況レポートはオブジェクトのカウントおよび圧縮フェーズでは表示されますが、書き込みフェーズでは禁止されます。その理由は、場合によっては、出力ストリームが別のコマンドに直接リンクされており、受信パックデータを処理するときに独自の進行状況を表示したい場合があるためです。このフラグは --progress に似ていますが、 --stdout が使用されている場合でも、書き込みフェーズの進行状況レポートを強制する点が異なります。

これは、進行状況の表示がアクティブになるたびに --all-progress の指定を含ませるために使用されます。 --all-progress とは異なり、このフラグは実際には進行状況の表示を強制しません。

このフラグにより、コマンドは標準エラーストリームで進行状況を報告しなくなります。

既存のパックがあるリポジトリに、パックされたアーカイブを作成する場合、コマンドは既存のデルタを再利用します。これにより、パックがわずかに最適化されない場合があります。このフラグは、既存のデルタを再利用せずに最初から計算するようにコマンドに指示します。

このフラグは、削除されていないオブジェクトを含め、既存のオブジェクトデータをまったく再利用しないようにコマンドに指示し、すべてを強制的に再圧縮します。 これは、 --no-reuse-delta の指定を含みます。パックされたデータに異なる圧縮レベルを大規模に適用する必要がある曖昧模糊なケースでのみ役立ちます。

生成するパック内の新しく圧縮するデータの圧縮レベルを指定します。指定しない場合、パックの圧縮レベルは pack.compression 、core.compression の順で取得します。どちらも設定されていない場合は、zlibのデフォルトである -1 になります。ソースに関係なくすべてのデータに均一な圧縮レベルを強制する場合は、 --no-reuse-object オプションを追加します。

--revs オプションと組み合わせた場合、「スパース」(sparse)アルゴリズムを切り替えて、パックに含めるオブジェクトを決定します。このアルゴリズムは、新しいオブジェクトを導入するパスに現れるツリーのみをウォークします。これは、小さな変更を送信するためのパックを計算するときに、パフォーマンスに大きなメリットをもたらす可能性があります。ただし、含まれているコミットに特定の種類の直接名前変更(direct renames)含まれている場合は、パックファイルに追加のオブジェクトが追加される可能性があります。このオプションが含まれていない場合、デフォルトで pack.useSparse の値になります。 pack.useSparse の値は、特に指定されていない限りtrueです。

ネットワーク転送を減らすために、送信者と受信者の間の共通オブジェクトを省略して「薄い」(thin)パックを作成します。このオプションは、 --stdout と組み合わせた場合にのみ意味があります。

浅いリポジトリ(shallow repository)を持つクライアントに提供されるパックを最適化します。このオプションを --thin と組み合わせると、速度を犠牲にしてパックを小さくすることができます。

パックされたアーカイブは、デルタのベースオブジェクトを20バイトのオブジェクト名またはストリーム内のオフセットのいずれかで表現できますが、Gitの古いバージョンは後者を理解していません。 デフォルトでは、 git pack-objects は互換性を高めるために前者の形式のみを使用します。このオプションを使用すると、コマンドで後者の形式を使用してコンパクトにすることができます。平均デルタチェーンの長さに応じて、このオプションは通常、結果のパックファイルを3〜5パーセント縮小します。

最適なデルタマッチングを検索するときに生成するスレッドの数を指定します。これには、pack-objectsをpthreadでコンパイルする必要があります。そうでない場合、このオプションは警告とともに無視されます。これは、マルチプロセッサマシンでのパッキング時間を短縮することを目的としています。ただし、デルタ検索ウィンドウに必要なメモリ量は、スレッド数で乗算されます。 0を指定すると、GitはCPUの数を自動検出し、それに応じてスレッドの数を設定します。

これは、テストスイートでのみ使用することを目的としています。生成するパックインデックスのバージョンを強制し、指定のオフセット上にあるオブジェクトに64ビットインデックスエントリを強制することができます。

このオプションを使用すると、 grafts によって隠されている親も、 それでもなおパックされます。

結果のパックファイルから特定のオブジェクト(通常はブロブ)を省略します。 有効な <filter-spec> 形式ついては、 git-rev-list(1) を参照してください。

以前の任意の --filter= 引数をオフにします。

将来の「partial clone」(部分クローン)開発に役立つデバッグオプション。このオプションは、欠落しているオブジェクトの処理方法を指定します。

promisorリモートにあることがわかっているオブジェクトを省略します。 (このオプションは、ローカルで作成されたオブジェクトのみを操作することを目的としているため、再パックするときに、ローカルで作成されたオブジェクト[.promisor なし]とpromisorリモートのオブジェクト[.promisor あり]の区別を維持します。) これは部分クローン(partial clone)で使用されます。

--unpacked= オプションで指定されたパック内の参照から到達不能なオブジェクトは、 *.keep ファイルでマークされたパック内にない到達可能オブジェクトに加えて、結果のパックに追加されます。 これは --revs の指定を含んでいます。

到達不能な緩いオブジェクト(loose objects)をパックします(そしてそれらの緩いオブジェクトを削除します)。 これは --revs の指定を含んでいます。

到達不能なオブジェクトは緩い(loose)オブジェクト形式のままにしてください。これは --revs の指定を含んでいます。

「islands」に基づいてデルタのマッチを制限します。 以下の DELTA ISLANDS を参照してください。

While performing delta compression, Git groups objects that may be similar based on heuristics using the path to that object. While grouping objects by an exact path match is good for paths with many versions, there are benefits for finding delta pairs across different full paths. Git collects objects by type and then by a "name hash" of the path and then by size, hoping to group objects that will compress well together.

Perform compression by first organizing objects by path, then a second pass that compresses across paths as normal. This has the potential to improve delta compression especially in the presence of filenames that cause collisions in Git’s default name-hash algorithm.