git-show-ref(1)

SYNOPSIS

git show-ref [--head] [-d | --dereference]
             [-s | --hash[=<n>]] [--abbrev[=<n>]] [--branches] [--tags]
             [--] [<pattern>…]
git show-ref --verify [-q | --quiet] [-d | --dereference]
             [-s | --hash[=<n>]] [--abbrev[=<n>]]
             [--] [<ref>…]
git show-ref --exclude-existing[=<pattern>]
git show-ref --exists <ref>

DESCRIPTION

ローカルリポジトリで使用可能な参照を、関連するコミットIDとともに表示します。結果はパターンを使用してフィルタリングでき、タグはオブジェクトIDに逆参照できます。さらに、特定のrefが存在するかどうかをテストするために使用できます。

デフォルトでは、タグとヘッドとリモートrefを表示します。

--exclude-existing 形式は、逆を行うフィルターです。 stdinから1行に1つのrefを読み取り、ローカルリポジトリに存在しないものを表示します。

The --exists form can be used to check for the existence of a single references. This form does not verify whether the reference resolves to an actual object.

.git ディレクトリの下のファイルに直接アクセスするために、このユーティリティの使用をお勧めします。

OPTIONS

--head: Show the HEAD reference, even if it would normally be filtered out.
--branches
--tags: Limit to local branches and local tags, respectively. These options are not mutually exclusive; when given both, references stored in "refs/heads" and "refs/tags" are displayed. Note that --heads is a deprecated synonym for --branches and may be removed in the future.
-d
--dereference: Dereference tags into object IDs as well. They will be shown with ^{} appended.
-s
--hash[=<n>]: Only show the OID, not the reference name. When combined with --dereference, the dereferenced tag will still be shown after the OID.
--verify: Enable stricter reference checking by requiring an exact ref path. Aside from returning an error code of 1, it will also print an error message if --quiet was not specified.
--exists: Check whether the given reference exists. Returns an exit code of 0 if it does, 2 if it is missing, and 1 in case looking up the reference failed with an error other than the reference being missing.
--abbrev[=<n>]: Abbreviate the object name. When using --hash, you do not have to say --hash --abbrev; --hash=n would do.
-q
--quiet: Do not print any results to stdout. Can be used with --verify to silently check if a reference exists.
--exclude-existing[=<pattern>]: Make git show-ref act as a filter that reads refs from stdin of the form ^(?:<anything>\s)?<refname>(?:\^{})?$ and performs the following actions on each: (1) strip ^{} at the end of line if any; (2) ignore if pattern is provided and does not head-match refname; (3) warn if refname is not a well-formed refname and skip; (4) ignore if refname is a ref that exists in the local repository; (5) otherwise output the line.
<pattern>…: 1つ以上のパターンに一致する参照を表示します。パターンはフルネームの末尾から一致し、完全な部品のみが一致します。「master」は「refs/heads/master」や「refs/remotes/origin/master」や「refs/tags/jedi/master」と一致しますが、「refs/heads/mymaster」とか「refs/remotes/master/jedi」とは一致しません。

OUTPUT

出力は以下の形式になります:

<oid> SP <ref> LF

これは例えば以下のようになります

$ git show-ref --head --dereference
832e76a9899f560a90ffd62ae2ce83bbeff58f54 HEAD
832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/master
832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/origin
3521017556c5de4159da4615a39fa4d5d2c279b5 refs/tags/v0.99.9c
6ddc0964034342519a87fe013781abf31c6db6ad refs/tags/v0.99.9c^{}
055e4ae3ae6eb344cbabf2a5256a49ea66040131 refs/tags/v1.0rc4
423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
...

( --dereference ではなく、) --hash を使用する場合の出力形式:

<oid> LF

これは例えば以下のようになります

$ git show-ref --branches --hash
2e3ba0114a1f52b47df29743d6915d056be13278
185008ae97960c8d551adcd9e23565194651b5d1
03adf42c988195b50e1a1935ba5fcbc39b2b029b
...

EXAMPLES

タグやヘッドなど、「master」と呼ばれるすべての参照を表示するには、参照の名前付け階層の深さに関係なく、以下を使用します:

        git show-ref master

This will show "refs/heads/master" but also "refs/remote/other-repo/master", if such references exist.

--verify フラグを使用する場合、コマンドには正確なパスが必要です:

        git show-ref --verify refs/heads/master

これは「master」と呼ばれる正確なブランチにのみ一致します。

一致するものがない場合、 git show-ref はエラーコード1を返し、検証の場合はエラーメッセージを表示します。

スクリプトの場合は、 --quiet フラグを使用して静かにするように要求できます。これにより、以下のようにできます

        git show-ref --quiet --verify -- "refs/heads/$headname" ||
                echo "$headname is not a valid branch"

これは、特定のブランチが存在するかどうかを確認します(実際には結果を表示したくないので、あいまいな部分一致で問題が発生しないように、完全なrefnameを使用します)。

To show only tags, or only proper branch heads, use --tags and/or --branches respectively (using both means that it shows tags and branches, but not other random references under the refs/ subdirectory).

タグオブジェクトの自動逆参照を行うには、 -d または --dereference フラグを使用すると、以下のようにできます

        git show-ref --tags --dereference

これは、すべてのタグのリストを、それらが逆参照するものと一緒に取得します。

FILES

.git/refs/*, .git/packed-refs

GIT

Part of the git(1) suite

git-show-ref(1) Manual Page

NAME