gitrepository-layout(5) Manual Page

このリポジトリーに関連付けられているオブジェクト・ストア。 通常、 オブジェクト・ストアは自己完結です(つまり、 そこにあるオブジェクトによって参照されるすべてのオブジェクトもそこにあります)が、 それを破る方法がいくつかあります。

新しく作成されたオブジェクトは、独自のファイルに保存されます。オブジェクトは、sha1オブジェクト名の最初の2文字を使用して、256個のサブディレクトリに分散され、 objects 自体のディレクトリエントリの数を管理可能な数に保ちます。ここにあるオブジェクトは、「アンパックオブジェクト」(unpacked obuject)(または「ルーズオブジェクト」(loose object))と呼ばれることがよくあります。

パック(多くのオブジェクトを圧縮形式で格納するファイルと、ランダムにアクセスできるようにするためのインデックスファイル)は、このディレクトリにあります。

オブジェクトストアに関する追加情報は、このディレクトリに記録されます。

このファイルは、馬鹿プロトコルがこのオブジェクトストアで使用可能なパックを検出するのに役立ちます。リポジトリが馬鹿プロトコル用に公開されている場合は、パックを追加または削除するたびに、 git update-server-info を実行して、このファイルを最新の状態に保つ必要があります。 git repack はデフォルトでこれを行います。

このファイルは、このオブジェクトストアがオブジェクトを借用(borrow)する代替オブジェクトストアへのパスを、1行に1つのパス名で記録します。ネイティブGitツールがローカルで使用するだけでなく、HTTP fetcher もリモートで使用しようとすることに注意してください。これは通常、代替ファイルに相対パス(リポジトリではなくオブジェクトデータベースに対して！)がある場合は機能しますが、ファイルシステムとWeb URLの絶対パスが同じでない限り、絶対パスを使用する場合は機能しません。 objects/info/http-alternates も参照してください。

このファイルは、このオブジェクトストアがオブジェクトを借用(borrow)する代替オブジェクトストアへのURLを記録し、リポジトリがHTTP経由でフェッチされるときに使用されます。

参照(reference)は、 このディレクトリーのサブディレクトリーに保存されます。 git prune コマンドは、 このディレクトリーとそのサブディレクトリーで見つかった参照から到達可能なオブジェクトを認識し保持します。 $GIT_COMMON_DIR が設定されていて、代わりに $GIT_COMMON_DIR/refs が使用される場合、 このディレクトリーは無視されます( refs/bisect と refs/rewritten と refs/worktree を除く)。

ブランチ name のツリーの先端(tip-of-the-tree)のコミットオブジェクトを記録します

オブジェクト名を記録します(必ずしもコミットオブジェクト、またはコミットオブジェクトを指すタグオブジェクトである必要はありません)。

リモートリポジトリからコピーされたブランチのツリーの先端(tip-of-the-tree)のコミットオブジェクトを記録します。

<obj-sha1> を置き換えるオブジェクトのSHA-1を記録します。これはinfo/graftsに似ており、 git-replace(1) によって内部的に使用および保守されます。 このような参照はリポジトリ間で交換できますが、 grafts はできません。

refs/heads/ や refs/tags/ と同じ情報を記録し、そして friends がより効率的な方法で記録します。 git-pack-refs(1) を参照してください。 $GIT_COMMON_DIR が設定されている場合、このファイルは無視され、代わりに「$GIT_COMMON_DIR/packed-refs」が使用されます。

現在アクティブなブランチを説明する refs/heads/ 名前空間へのシンボリック参照(symref;glossaryを参照)。 リポジトリーが作業ツリーに関連付けられていない場合(つまり、ベア・リポジトリーの場合)はあまり意味がありませんが、 有効な Git リポジトリーには HEAD ファイルが「必要」です。 一部の磁器コマンドは、 これを使用して、 リポジトリーの指定された「デフォルト」ブランチ(通常は「master」)を推測する場合があります。 名前付きブランチ name が(まだ)存在しない場合も合法です。 一部のレガシー設定では、 現在のブランチを指すシンボリック参照(symref)ではなくシンボリック・リンクです。

リポジトリ固有の構成ファイル。 $GIT_COMMON_DIR が設定されている場合、このファイルは無視され、代わりに「$GIT_COMMON_DIR/config」が使用されます。

複数の作業ディレクトリ設定の、メイン作業ディレクトリための、作業ディレクトリ固有の構成ファイル(git-worktree(1) を参照)。

git fetch や git pull や git push へのURLを指定するために使用される短縮形を格納するための、少々非推奨の方法。ファイルは branches/<name> として保存でき、 repository 引数の代わりに name をこれらのコマンドに指定できます。詳細については、 git-fetch(1) の REMOTES セクションを参照してください。この機構はレガシーであり、最新のリポジトリには見られない可能性があります。 $GIT_COMMON_DIR が設定されている場合、このディレクトリは無視され、代わりに「$GIT_COMMON_DIR/branches」が使用されます。

フックは、さまざまなGitコマンドで使用されるカスタマイズスクリプトです。 git init を実行すると、いくつかのサンプルフックがインストールされますが、デフォルトではすべて無効になっています。有効にするには、ファイル名から .sample サフィックスを削除して名前を変更する必要があります。各フックの詳細については、 githooks(5) をお読みください。 $GIT_COMMON_DIR が設定されている場合、このディレクトリは無視され、代わりに「$GIT_COMMON_DIR/hooks」が使用されます。

複数の作業ツリーが使用されている場合、 $GIT_DIR 内のほとんどのファイルは、 いくつかの既知の例外を除いて、 各作業ツリー毎にあります。 ただし、「common」の下にあるすべてのファイルは、 すべての作業ツリー間で共有されます。

リポジトリの現在のインデックスファイル。通常、ベアリポジトリには見つかりません。

$GIT_DIR/indexおよびその他の一時(temporary)インデックスファイルによって参照される共有インデックス部分。スプリットインデックスモード(split index mode)でのみ有効です。

リポジトリに関する追加情報は、このディレクトリに記録されます。 $GIT_COMMON_DIR が設定されている場合、このディレクトリは無視され、代わりに「$GIT_COMMON_DIR/info」が使用されます。

このファイルは、 馬鹿プロトコル(dumb transports)がこのリポジトリーで使用可能な参照を検出するのに役立ちます。 リポジトリーが馬鹿プロトコル用に公開されている場合、 このファイルは、 タグまたはブランチが作成または変更されるたびに、 git update-server-info によって再生成される必要があります。 これは通常、 リポジトリーに git push したときに git-receive-pack コマンドによって実行される hooks/update フックから実行されます。

このファイルは、コミットが実際に作成された方法とは異なる親のセットを装うために、偽のコミットの祖先情報を記録します。1行に1つのレコードは、スペースで区切られ、改行で終了する40バイトの16進オブジェクト名をリストすることにより、コミットとその偽の親を記述します。

このファイルは、磁器コマンドの慣例により、除外パターンリストを格納します。 .gitignore は、ディレクトリごとの無視ファイルです。「git status」、「git add」、「git rm」、「git clean」はこの除外パターンリストを調べますが、コアGitコマンドはこの除外パターンリストを調べません。 gitignore(5) も参照してください。

ディレクトリごとの .gitattributes ファイルと同様に、パスに割り当てる属性を定義します。 gitattributes(5) も参照してください。

このファイルには、スパースチェックアウトパターン(sparse checkout patterns)が格納されています。 git-read-tree(1) も参照してください。

git fetch や git pull や git push コマンドを介してリモート・リポジトリーと対話するときに使用するURLの省略形とデフォルトの参照名を格納します。 詳細については、 git-fetch(1)のREMOTESセクションを参照してください。 このメカニズムはレガシーであり、 最新のリポジトリーには見られない可能性があります。 $GIT_COMMON_DIR が設定されている場合、このディレクトリは無視され、 代わりに $GIT_COMMON_DIR/remotes が使用されます。

参照に加えられた変更の記録は、 このディレクトリに保存されます。 詳細については、 git-update-ref(1) を参照してください。 $GIT_COMMON_DIR が設定されていて、 代わりに $GIT_COMMON_DIR/logs が使用される場合、 このディレクトリは無視されます(但し、 logs/HEAD を除く)。

name という名前のブランチ先端(branch tip)に加えられたすべての変更を記録します。

name という名前のタグに加えられたすべての変更を記録します。

これは info/grafts に似ていますが、内部的に使用され、浅いクローンメカニズム(shallow clone mechanism)によって維持されます。 git-clone(1) と git-fetch(1) の --depth オプションを参照してください。 $GIT_COMMON_DIRが設定されている場合、このファイルは無視され、代わりに「$GIT_COMMON_DIR/shallow」が使用されます。

このファイルが存在する場合、明示的に設定されていなければ、 $GIT_COMMON_DIR (git(1) を参照)はこのファイルで指定されたパスに設定されます。指定されたパスが相対パスの場合、それは$GIT_DIRからの相対パスです。commondirのあるリポジトリは、「commondir」が指すリポジトリがないと不完全です。

サブモジュールのgitリポジトリが含まれています。

リンクされた作業ツリー(linked working trees)の管理データが含まれています。各サブディレクトリには、リンクされた作業ツリーの作業ツリー関連部分が含まれています。 $GIT_COMMON_DIRが設定されている場合、このディレクトリは無視され、代わりに「$GIT_COMMON_DIR/worktrees」が使用されます。

ここを指す .git ファイルへの絶対パスを含むテキストファイル。 これは、 リンクされたリポジトリが手動で削除されたかどうかを確認するために使用され、 このディレクトリを保持する必要がなくなった場合に役立ちます。 このファイルの最終変更時刻(mtime)は、 リンクされたリポジトリーにアクセスするたびに更新されるべきです。

このファイルが存在する場合、リンクされた作業ツリーがポータブルデバイス上にあり、使用できない可能性があります。このファイルが存在すると、 git worktree prune によって worktrees/<id> が自動または手動で剪定(prune)されるのを防ぎます。ファイルには、リポジトリがロックされている理由を説明する文字列が含まれている場合があります。

作業ディレクトリ固有の構成ファイル。