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) を含まない参照のみをリストします。

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

フォーマットが空文字列に展開されるフォーマットされた ref の後に改行を出力しません。

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

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

参照の名前 ($GIT_DIR/ 以降の部分)。参照の曖昧でない短い名前には :short を追加します。オプション core.warnAmbiguousRefs は厳密な省略モードを選択するために使用されます。もし lstrip=<N> (rstrip=<N>) が追加された場合、参照名から先頭 (後端) のスラッシュ区切りのパスコンポーネントを <N> 個削除します (例: %(refname:lstrip=2) は refs/tags/foo を foo に、%(refname:rstrip=2) は refs/tags/foo を refs に変換します)。もし <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 です。一意のオブジェクト名を保証するために長さは超過する場合があります。

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

表示される参照から「上流」と見なすことができるローカル参照の名前。上記の refname と同じ方法で :short, :lstrip, :rstrip を尊重します。さらに、"[ahead N, behind M]" を表示する :track と、簡潔なバージョン: ">" (ahead), "<" (behind), "<>" (ahead and behind), または "=" (同期済み) を表示する :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) アトムを使用し、HEAD 参照にのみ if 条件を適用したい場合に便利です。%(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 行。