10.8 Gitの内部構造 - 環境変数

Gitの一般的なコンピュータプログラムとしての動作の一部は、環境変数に依存しています。

GIT_EXEC_PATH は、Gitがサブプログラム（git-commit、git-diffなど）を探す場所を決定します。現在の設定はgit --exec-pathを実行することで確認できます。

HOME は通常、カスタマイズ可能とは見なされませんが（他の多くのものがそれに依存するため）、Gitがグローバルな設定ファイルを探す場所です。グローバルな設定を含む真にポータブルなGitインストールが必要な場合、ポータブルなGitのシェルプロファイルでHOMEをオーバーライドできます。

PREFIX も同様ですが、システム全体の設定用です。Gitはこのファイルを$PREFIX/etc/gitconfigで探します。

GIT_CONFIG_NOSYSTEM は、設定されている場合、システム全体の設定ファイルの使用を無効にします。これは、システム設定がコマンドと競合しているが、それを変更または削除するアクセス権がない場合に役立ちます。

GIT_PAGER は、コマンドラインで複数ページの出力を表示するために使用されるプログラムを制御します。これが設定されていない場合、PAGERがフォールバックとして使用されます。

GIT_EDITOR は、ユーザーがテキスト（コミットメッセージなど）を編集する必要があるときにGitが起動するエディタです。設定されていない場合、EDITORが使用されます。

Gitは、現在のリポジトリとどのように連携するかを決定するために、いくつかの環境変数を使用します。

GIT_DIR は、.gitフォルダーの場所です。これが指定されていない場合、Gitはディレクトリツリーを~または/に到達するまで上に辿り、各ステップで.gitディレクトリを探します。

GIT_CEILING_DIRECTORIES は、.gitディレクトリの検索動作を制御します。読み込みが遅いディレクトリ（テープドライブ上のディレクトリや低速なネットワーク接続を介したディレクトリなど）にアクセスする場合、Gitが通常よりも早く検索を停止するようにしたい場合があります。特に、シェルプロンプトを構築するときにGitが呼び出される場合はそうです。

GIT_WORK_TREE は、ベアではないリポジトリの作業ディレクトリのルートの場所です。--git-dirまたはGIT_DIRが指定されているが、--work-tree、GIT_WORK_TREE、core.worktreeのいずれも指定されていない場合、現在の作業ディレクトリは作業ツリーの最上位とみなされます。

GIT_INDEX_FILE は、インデックスファイルへのパスです（ベアではないリポジトリのみ）。

GIT_OBJECT_DIRECTORY は、通常.git/objectsにあるディレクトリの場所を指定するために使用できます。

GIT_ALTERNATE_OBJECT_DIRECTORIES はコロン区切りのリスト（/dir/one:/dir/two:…のような形式）で、GIT_OBJECT_DIRECTORYにオブジェクトがない場合にGitがオブジェクトをどこでチェックするかを指示します。同じ内容を持つ大きなファイルを多数のプロジェクトで持っている場合、これを活用して、それらのコピーを過剰に保存することを避けることができます。

「パススペック」とは、Gitでワイルドカードを使用するなどして、パスを指定する方法を指します。これらは.gitignoreファイルだけでなく、コマンドライン（git add *.c）でも使用されます。

GIT_GLOB_PATHSPECS と GIT_NOGLOB_PATHSPECS は、パススペックにおけるワイルドカードのデフォルトの動作を制御します。GIT_GLOB_PATHSPECSが1に設定されている場合、ワイルドカード文字はワイルドカードとして機能します（これがデフォルトです）。GIT_NOGLOB_PATHSPECSが1に設定されている場合、ワイルドカード文字はそれ自体のみにマッチし、*.cのようなものは、名前が.cで終わるファイルではなく、"*.c"という名前のファイルのみにマッチします。個々のケースでは、パススペックを:(glob)または:(literal)で始めることで、これをオーバーライドできます（例：:(glob)\*.c）。

GIT_LITERAL_PATHSPECS は、上記の動作を両方とも無効にします。ワイルドカード文字は機能せず、オーバーライドプレフィックスも無効になります。

GIT_ICASE_PATHSPECS は、すべてのパススペックを大文字小文字を区別しないように設定します。

Gitコミットオブジェクトの最終的な作成は通常git-commit-treeによって行われ、これはこれらの環境変数を主要な情報源として使用し、これらの変数が存在しない場合にのみ設定値にフォールバックします。

GIT_AUTHOR_NAME は、「author」フィールドの人間が読める名前です。

GIT_AUTHOR_EMAIL は、「author」フィールドのメールアドレスです。

GIT_AUTHOR_DATE は、「author」フィールドに使用されるタイムスタンプです。

GIT_COMMITTER_NAME は、「committer」フィールドの人間が読める名前を設定します。

GIT_COMMITTER_EMAIL は、「committer」フィールドのメールアドレスです。

GIT_COMMITTER_DATE は、「committer」フィールドのタイムスタンプに使用されます。

EMAIL は、user.email設定値が設定されていない場合のフォールバックメールアドレスです。これが設定されていない場合、Gitはシステムユーザー名とホスト名にフォールバックします。

Gitはcurlライブラリを使用してHTTP経由でネットワーク操作を行うため、GIT_CURL_VERBOSE はGitにそのライブラリによって生成されたすべてのメッセージを出力するように指示します。これはコマンドラインでcurl -vを実行するのと似ています。

GIT_SSL_NO_VERIFY は、GitにSSL証明書を検証しないように指示します。これは、HTTPS経由でGitリポジトリを提供するために自己署名証明書を使用している場合、またはGitサーバーをセットアップしている最中でまだ完全な証明書をインストールしていない場合に、時々必要になることがあります。

HTTP操作のデータレートがGIT_HTTP_LOW_SPEED_LIMIT バイト/秒より低く、それがGIT_HTTP_LOW_SPEED_TIME 秒より長く続いた場合、Gitはその操作を中止します。これらの値はhttp.lowSpeedLimitおよびhttp.lowSpeedTimeの設定値をオーバーライドします。

GIT_HTTP_USER_AGENT は、GitがHTTP経由で通信するときに使用するユーザーエージェント文字列を設定します。デフォルトはgit#2.0.0のような値です。

GIT_DIFF_OPTS は少し誤解を招く名前です。有効な値は-u<n>または--unified=<n>のみで、git diffコマンドで表示されるコンテキスト行数を制御します。

GIT_EXTERNAL_DIFF は、diff.external設定値のオーバーライドとして使用されます。これが設定されている場合、git diffが呼び出されたときにGitはこのプログラムを呼び出します。

GIT_DIFF_PATH_COUNTER と GIT_DIFF_PATH_TOTAL は、GIT_EXTERNAL_DIFFまたはdiff.externalで指定されたプログラム内から便利です。前者は、一連のファイルでどのファイルが差分されているかを表し（1から始まる）、後者はバッチ内のファイルの総数です。

GIT_MERGE_VERBOSITY は、再帰的マージ戦略の出力を制御します。許可される値は以下の通りです。

デフォルト値は2です。

Gitが実際に何をしているかを知りたいですか？ Gitにはかなり完全なトレースセットが埋め込まれており、それらを有効にするだけで済みます。これらの変数の可能な値は以下の通りです。

GIT_TRACE は、特定のカテゴリに当てはまらない一般的なトレースを制御します。これには、エイリアスの展開や他のサブプログラムへの委譲が含まれます。

GIT_TRACE_PACK_ACCESS は、パックファイルアクセスに関するトレースを制御します。最初のフィールドはアクセスされているパックファイル、2番目のフィールドはそのファイル内のオフセットです。

GIT_TRACE_PACKET は、ネットワーク操作のパケットレベルのトレースを有効にします。

GIT_TRACE_PERFORMANCE は、パフォーマンスデータのロギングを制御します。出力は、各特定のgit呼び出しにかかる時間を示します。

GIT_TRACE_SETUP は、Gitが対話しているリポジトリと環境についてGitが何を検出しているかに関する情報を表示します。

GIT_SSH は、指定されている場合、GitがSSHホストに接続しようとしたときにsshの代わりに呼び出されるプログラムです。$GIT_SSH [username@]host [-p <port>] <command>のように呼び出されます。これはsshの呼び出し方法をカスタマイズする最も簡単な方法ではないことに注意してください。追加のコマンドラインパラメータをサポートしません。追加のコマンドラインパラメータをサポートするには、GIT_SSH_COMMAND を使用するか、ラッパースクリプトを作成してGIT_SSHをそれを指すように設定するか、~/.ssh/configファイルを使用できます。

GIT_SSH_COMMAND は、GitがSSHホストに接続しようとしたときに使用されるSSHコマンドを設定します。コマンドはシェルによって解釈され、GIT_SSH_COMMAND="ssh -i ~/.ssh/my_key" git clone git@example.com:my/repoのようにsshで追加のコマンドライン引数を使用できます。

GIT_ASKPASS は、core.askpass設定値のオーバーライドです。これは、Gitがユーザーに認証情報を要求する必要があるたびに呼び出されるプログラムで、コマンドライン引数としてテキストプロンプトを期待し、stdoutに回答を返す必要があります（このサブシステムの詳細については資格情報の保存を参照）。

GIT_NAMESPACE は、名前空間付きのリファレンスへのアクセスを制御し、--namespaceフラグと同等です。これは主にサーバー側で役立ちます。サーバー側では、単一のリポジトリの複数のフォークを1つのリポジトリに保存し、リファレンスのみを分離したい場合があります。

GIT_FLUSH は、stdoutに増分的に書き込むときにGitに非バッファリングI/Oを使用するように強制するために使用できます。値1はGitに頻繁にフラッシュさせ、値0はすべての出力をバッファリングさせます。デフォルト値（この変数が設定されていない場合）は、アクティビティと出力モードに応じて適切なバッファリングスキームを選択します。

GIT_REFLOG_ACTION を使用すると、reflogに書き込まれる説明テキストを指定できます。以下に例を示します。