git-refs(1) Manual Page

異なる形式間で参照ストアを移行します。

参照データーベースの一貫性を検証する。

フィルタリング、書式設定、ソートをサポートして、リポジトリ内の参照を一覧表示します。このサブコマンドは git-for-each-ref(1) の別名で、同一の機能を提供します。

指定した参照が存在するかどうかを確認します。存在する場合は終了コード 0、存在しない場合は 2 を返し、参照が存在しないこと以外のエラーにより参照の検索に失敗した場合は 1 を返します。これは、参照が実際のオブジェクトに解決されるかどうかは検証しません。

リポジトリの性能を改善しディスク使用量を減らすために、参照を最適化します。このサブコマンドは git-pack-refs(1) の別名で、同一の機能を提供します。

参照ストアを移行する対象の参照形式。 以下のいずれかになります:

移行を実行しますが、 リポジトリーは変更しません。 移行された ref は、 別個に検査できるように別のディレクトリに書き込まれます。 ディレクトリの名前は stdout で報告されます。 これを使用して、 実際の移行を実行する前に、 移行が予想どおりに機能することを再確認できます。

reflog データを新しいバックエンドへ移行するか、破棄するかを選択します。デフォルトは「移行する」(--reflog)です。

より厳格なエラー・チェックを有効にします。 これにより、 警告がエラーとして報告されます。 inkgit:git-fsck[1] 参照。

参照データベースの一貫性を確認するときに、 おしゃべりにします。

1つ以上のパターン(<pattern>)が指定されている場合、 少なくとも1つのパターンに一致する参照のみが表示されます。 fnmatch(3) を使用するか、 文字通り(lietrally)に書くかです。 文字通りに書いた場合、 完全に一致するか、 先頭からスラッシュ(/)まで一致するかです。

パターンのリストは引数リストからではなく標準入力から読み取られます。

<count> 個の参照を表示して停止(stop)します。

並べ替えるフィールド名を <key> とします。 プレフィックス - を使用すると、 値の降順で並べ替えます。 並べ替えるフィールド名を指定しない場合 refname が使用されます。 --sort=<key> オプションは複数回使用できます。 その場合、 最後のキーが主キー(primary key)になります。

表示されている参照とそれが指すオブジェクトを %(フィールド名) によって差し込みする書式文字列。 更に、 リテラル文字列の %% は % とレンダリングされ、 %xx は16進数 xx の値のキャラクター・コードをレンダリングします。 たとえば %00 は \0(NUL)、 %09 は \t(TAB)、 %0a は \n(LF)を差し込みます。

--format オプションで指定された色を尊重します。 <when> フィールドは always または never または auto のいずれかでなければなりません(<when> の指定が無い場合は、 always が指定されたかのように動作します)。

指定した場合、 %(fieldname) プレースホルダーを置き換える文字列は、指定のホストプログラム言語に適した文字列リテラルとしてクォートします。これは、直接「評価」(eval)できるスクリプトレットを作成することを目的としています。

指定のオブジェクトを指す参照のみをリストします。

指定のコミット(指定されていない場合は HEAD)から先端に到達できる参照のみをリストします。

<object> (指定されていない場合は HEAD)から先端に到達でき無い参照のみをリストします。

<object> (指定されていない場合は HEAD)を含む参照のみをリストします。

<object> (指定されていない場合は HEAD)を含ま無い参照のみをリストします。

参照の並べ替え(sort)とフィルタリングでは英大文字小文字を区別しません。

フォーマットが空の文字列に展開されるフォーマット済み参照の後に改行を出力しないでください。

1つ以上の --exclude オプションが与えられている場合、 与えられた <excluded-pattern> パラメーター達とマッチし無い参照のみが表示されます。 マッチングは、 上記 の <pattern> と同じルールを使用して行われます。

通常の参照以外のルート参照(root refs)(HEAD と疑似参照)をリストします。

ページ単位での出力(ページネーション;pagination)を可能にし、 指定されたマーカー(<marker>)(マーカー自身も含めて)までの参照をスキップします。 参照はページ単位での出力中に削除または変更または追加される可能性があることに注意してください。 出力には、 マーカーの辞書順(lexicographically)で後に続く参照のみが含まれます。 出力は、 マーカーよりアルファベット順(alphabetically)で次に来る最初の参照から始まります。 --sort=<key> オプションや --stdin オプション、 または参照を制限するための <pattern> 引数と併用することはできません。

このコマンドはデフォルトでは、 すでにパックされているすべてのタグと参照をパックし、 他の参照はそのままにします。 これは、 ブランチが積極的に開発されることが期待されており、 その先端をパックしてもパフォーマンスが向上しないためです。 このオプションを使用すると、 非表示の参照や壊れた参照やシンボリック参照 を除く、 すべての参照もパックされます。 過去の履歴として大量のブランチを残しているリポジトリーで特に有用です。

コマンドは通常、それらをパックした後、 $GIT_DIR/refs 階層の下の緩い参照(loose refs)を削除します。 このオプションは、そうしないように指示します。

参照データベースの現在の状態に応じて、 必要に応じて参照をパッキングします。 この振る舞いは、 リポジトリーが使用する参照形式に依存しており、 将来的に変更される可能性があります。

glob(7) パターンに基づいて参照をパックします。 このオプションを繰り返し指定すると、 包含パターンが蓄積されます。 ある参照が --include と --exclude の両方に含まれている場合、 --exclude が優先されます。 --include を使用すると、 デフォルトではすべてのタグが含まれなくなります。 シンボリック参照と壊れた参照は決してパックされる事はありません。 --all と一緒に使用すると、 なにもしません(noop)。 パターンのリストをクリアして再セットするには、 --no-include を使用します。

指定された glob(7) パターンにマッチする参照をパックしません。 このオプションを繰り返し指定すると、 除外パターンが蓄積されます。 パターンのリストをクリアして再セットするには、 --no-exclude を使用します。 とある参照がすでにパックされている場合、 それを --exclude で包含してもアンパックされません。