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

`--stdin` が指定された場合、パターンのリストは引数リストからではなく標準入力から読み込まれます。

デフォルトでは、このコマンドは `<pattern>` に一致するすべての参照を表示します。このオプションを使用すると、その数の参照を表示した後に停止します。

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

表示されている参照とその参照が指すオブジェクトから `%(fieldname)` を補間する文字列。さらに、文字列リテラル `%%` は ` % ` とレンダリングされ、`%xx` (ここで `xx` は16進数字) は16進コード `xx` の文字としてレンダリングされます。例えば、`%00` は `\0` (NUL) に、`%09` は `\t` (TAB) に、`%0a` は `\n` (LF) に補間されます。

`--format` オプションで指定された色を尊重します。`<when>` フィールドは `always`、`never`、または `auto` のいずれかである必要があります ( `<when>` が省略された場合、`always` が指定されたものとして動作します)。

指定された場合、`%(fieldname)` プレースホルダーを置き換える文字列は、指定されたホスト言語に適した文字列リテラルとして引用符で囲まれます。これは、直接 `eval` 可能なスクリプトレットを生成することを意図しています。

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

指定されたコミット (指定されていない場合は HEAD) から到達可能な先端を持つ参照のみをリストします。

指定されたコミット (指定されていない場合は HEAD) から到達不可能な先端を持つ参照のみをリストします。

指定されたコミット (指定されていない場合は HEAD) を含む参照のみをリストします。

指定されたコミット (指定されていない場合は HEAD) を含まない参照のみをリストします。

参照のソートとフィルタリングは大文字と小文字を区別しません。

フォーマットされた参照の後に改行を出力しません。ただし、フォーマットが空文字列に展開される場合は出力しません。

1つ以上のパターンが指定された場合、除外されたパターンに一致しない参照のみが表示されます。一致は上記の `<pattern>` と同じルールを使用して行われます。

通常の参照とは別に、ルート参照 (HEAD および擬似参照) をリストします。

参照の名前 ($GIT_DIR/ の後の部分)。参照の曖昧さのない短い名前には `:short` を追加します。オプション `core.warnAmbiguousRefs` は厳密な省略モードを選択するために使用されます。`lstrip=<N>` (`rstrip=<N>`) が追加された場合、参照名 (例: `%(refname:lstrip=2)` は `refs/tags/foo` を `foo` に、`%(refname:rstrip=2)` は `refs/tags/foo` を `refs` に変換します) の先頭 (末尾) から `<N>` 個のスラッシュ区切りのパスコンポーネントを削除します。`<N>` が負の数の場合、指定された末尾から必要な数のパスコンポーネントを削除して `-<N>` 個のパスコンポーネントを残します (例: `%(refname:lstrip=-2)` は `refs/tags/foo` を `tags/foo` に、`%(refname:rstrip=-1)` は `refs/tags/foo` を `refs` に変換します)。参照が十分なコンポーネントを持たない場合、正の <N> で削除すると結果は空文字列になり、負の <N> で削除すると完全な参照名になります。どちらもエラーではありません。

オブジェクトのタイプ (`blob`、`tree`、`commit`、`tag`)。

オブジェクトのサイズ (git cat-file -s が報告するものと同じ)。ディスク上でオブジェクトが占めるサイズをバイト単位で取得するには `:disk` を追加します。下記の `CAVEATS` セクションにあるディスク上のサイズに関する注意を参照してください。

オブジェクト名 (別名 SHA-1)。オブジェクト名の曖昧さのない省略形には `:short` を追加します。希望の長さのオブジェクト名の省略形には `:short=<length>` を追加します。ここで最小の長さは MINIMUM_ABBREV です。一意のオブジェクト名を確保するために長さが超過する場合があります。

これは、指定されたオブジェクトがデルタとして格納されている場合、そのデルタベースのオブジェクト名に展開されます。そうでなければ、nullオブジェクト名 (すべてゼロ) に展開されます。

表示されている参照の「上流」と見なすことができるローカル参照の名前。上記の `refname` と同じように `:short`、`:lstrip`、`:rstrip` を尊重します。さらに、`[ahead N, behind M]` を表示する `:track` と、簡潔なバージョン ( `>` (ahead), `<` (behind), `<>` (ahead and behind), `=` (in sync)) を表示する `:trackshort` を尊重します。`:track` は、不明な上流参照が見つかった場合には `[gone]` も出力します。追跡情報を括弧なしで表示するには (つまり "ahead N, behind M")、`:track,nobracket` を追加します。

表示されている参照の `@{push}` 位置を表すローカル参照の名前。`upstream` と同様に `:short`、`:lstrip`、`:rstrip`、`:track`、`:trackshort`、`:remotename`、`:remoteref` オプションを尊重します。`@{push}` 参照が設定されていない場合は空文字列を生成します。

HEADが現在の参照（チェックアウトされているブランチ）と一致する場合は `*`、それ以外の場合は ` `。

出力の色を変更します。`:<colorname>` が続き、カラー名は git-config[1] の「CONFIGURATION FILE」セクションの「Values」で説明されています。例: `%(color:bold red)`。

`%(align:…​)` と `%(end)` の間のコンテンツを左寄せ、中央寄せ、または右寄せします。「align:」の後に、カンマで区切られた `width=<width>` と `position=<position>` が任意の順序で続きます。ここで `<position>` は `left`、`right`、`middle` のいずれかで、デフォルトは `left`、`<width>` は配置後のコンテンツの合計長です。簡潔にするため、「width=」や「position=」のプレフィックスは省略でき、代わりに単独の <width> と <position> を使用できます。例えば、`%(align:<width>,<position>)`。コンテンツの長さが幅よりも長い場合、配置は実行されません。`--quote` と共に使用した場合、`%(align:…​)` と `%(end)` の間のすべてが引用符で囲まれますが、ネストされている場合は最上位レベルのみが引用符処理を実行します。

`%(if)…​%(then)…​%(end)` または `%(if)…​%(then)…​%(else)…​%(end)` として使用されます。`%(if)` の後に値または文字列リテラルを持つアトムがある場合、`%(then)` の後のすべてが出力されます。それ以外で `%(else)` アトムが使用されている場合、`%(else)` の後のすべてが出力されます。`%(then)` の前の文字列を評価する際にスペースを無視します。これは、`"*"` または `" "` を出力する `%(HEAD)` アトムを使用し、`if` 条件を `HEAD` 参照にのみ適用したい場合に便利です。`%(if:…​)` と `%(then)` アトムの間の値を指定された文字列と比較するには、`:equals=<string>` または `:notequals=<string>` を追加します。

指定されたシンボリック参照が指す参照。シンボリック参照でない場合、何も出力されません。上記の `refname` と同じように `:short`、`:lstrip`、`:rstrip` オプションを尊重します。

コミットのGPG署名。

良好 (有効) な署名には「G」、不正な署名には「B」、有効性が不明な良好な署名には「U」、期限切れの良好な署名には「X」、期限切れのキーで作成された良好な署名には「Y」、取り消されたキーで作成された良好な署名には「R」、署名をチェックできない場合 (例: キーが見つからない) には「E」、署名がない場合には「N」を表示します。

コミットのGPG署名の署名者。

コミットのGPG署名のキー。

コミットのGPG署名のフィンガープリント。

コミットのGPG署名のプライマリキーフィンガープリント。

コミットのGPG署名の信頼レベル。可能な出力は `ultimate`、`fully`、`marginal`、`never`、`undefined` です。

参照がリンクされた作業ツリーでチェックアウトされている場合、その作業ツリーへの絶対パス。それ以外の場合は空文字列。

出力される参照とフォーマットで指定された `<committish>` を比較した際に、それぞれ先行コミット数と後続コミット数を示す、スペースで区切られた2つの整数。

多くても1行で、`(<committish>)` が表示され、`<committish>` を生成したブランチの開始点として最も可能性が高い参照を示します。この選択はヒューリスティックを使用して行われます: `<committish>` の第一親履歴にはあるが、参照の第一親履歴にはないコミットの数を最小化する参照を選択します。

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

git-describe[1] のような人間が読める名前。説明できないコミットの場合は空文字列。`describe` 文字列の後にはコロンと1つ以上のカンマ区切りのオプションが続く場合があります。

オブジェクトの生データサイズ。

コミットまたはタグメッセージのバイト単位のサイズ。

メッセージの最初の段落 (通常は1行) は、コミットまたはタグメッセージの「件名」として扱われます。`contents:subject` の代わりに、`subject` フィールドも同じ結果を得るために使用できます。ファイル名に適した件名行にするには、`subject` に `:sanitize` を追加できます。

「件名」に続くコミットまたはタグメッセージの残り。

タグのオプションのGPG署名。

メッセージの最初の `N` 行。