git-daemon(1) Manual Page

パスを正確に一致させ(つまり、 実際のパスが "/foo/repo.git" または "/foo/repo/.git" の場合は "/foo/repo" を許可しないでください)、 そしてユーザー相対パスを許可しないでください。 このオプションが有効で、かつ、ディレクトリ引数が指定されていない場合、「git daemon」は起動を拒否します。

指定されたパスを基準にして、すべてのパス要求を再マップします。これは一種の "Git root" です。example.comで --base-path=/srv/git を伴って git daemon を実行し、後で git://example.com/hello.git をプルしようと試みると、 git daemon はパスを /srv/git/hello.git として解釈します。

--base-path が有効になっていて、リポジトリを探すのに失敗した場合、このオプションを使用すると、 git daemon はベースパスを前に付けずに探索を試みます。 これは、古いパスを許可したまま、 --base-path 使用に切り替える場合に便利です。

仮想ホスティングをサポートするために、補完されたパステンプレートを使用して、代替パスを動的に構築できます。テンプレートは、クライアントから提供されたターゲットホスト名の %H をサポートしますが、すべて小文字に変換されます。正規ホスト名の場合は %CH、サーバーのIPアドレスの場合は %IP、ポート番号の場合は %P、名前付きリポジトリの絶対パスの場合は %D です。補完後、パスはディレクトリのリストに対して検証されます。

git-daemon-export-ok ファイルがない場合でも、 (objects と refs サブディレクトリがある、)Gitリポジトリのように見えるすべてのディレクトリからのプルを許可します。

サーバーをinetdサービスとして実行します。--syslog の指定を含んでいます(--log-destination= でオーバーライドされる場合があります)。 --detach 、 --port 、 --listen 、 --user 、 --group オプションとは互換性がありません。

特定のIPアドレスまたはホスト名でリッスンします。IPアドレスは、IPv4アドレス、または、サポートされている場合はIPv6アドレス、 のいずれかになります。 IPv6がサポートされてい無い場合、 --listen=<hostname> もサポートされてい無いため、 --listen にはIPv4アドレスを指定する必要があります。 このオプションは複数回与えることができます。 --inetd オプションとは互換性がありません。

代わりのポートでリッスンします。 --inetd オプションと互換性がありません。

接続が確立されてからクライアント要求が受信されるまでのタイムアウト(秒単位)(基本的には即時である必要があるため、通常はかなり低い値)。

特定のクライアントサブリクエスト(client sub-requests)のタイムアウト(秒単位)。これには、サーバーがサブリクエストを処理するのにかかる時間と、次のクライアントのリクエストを待つために費やされる時間が含まれます。

同時クライアントの最大数。デフォルトは32です。制限しない場合はゼロに設定します。

--log-destination=syslog の短縮形。

指定した宛先にログメッセージを送信します。 このオプションは --verbose を意味しないため、デフォルトではエラー状態のみがログに記録されることに注意してください。 <destination> は以下のいずれかである必要があります:

~user 表記をリクエストで使用できるようにします。パラメータなしで指定した場合、 git://host/~alice/foo へのリクエストは、 ユーザー alice のホーム・ディレクトリにある foo リポジトリへのアクセス・リクエストと見なされます。 --user-path=<path> が指定されている場合、このリクエストは、ユーザー alice のホーム・ディレクトリにある <path>/foo リポジトリにアクセスするリクエストと見なされます。

着信接続と要求されたファイルに関する詳細をログに記録します。

リスニングソケットをバインドするときは SO_REUSEADDR を使用します。 これにより、古い接続がタイムアウトするのを待たずにサーバーを再起動できます。

シェルからデタッチします。 --syslog オプションの指定を含んでいます。

プロセスIDを <file> に保存します。デーモンが --inetd で実行されている場合は無視されます。

サービスループに入る前に、デーモンのuidとgidを変更します。 --group なしで --user のみが指定された場合、ユーザーのプライマリグループIDが使用されます。オプションの値は getpwnam(3) と getgrnam(3) に与えられ、数値IDはサポートされていません。

デフォルトでサイト全体のサービスを 有効/無効 にします。サイト全体で無効にされたサービスは、オーバーライド可能とマークされていて、リポジトリが構成アイテムでサービスを有効にしている場合でも、リポジトリごとに有効にできることに注意してください。

リポジトリごとの構成でサイト全体のデフォルトをオーバーライドすることを 許可/禁止 します。デフォルトでは、すべてのサービスがオーバーライドされる場合があります。

informative-errorsがオンになっている場合、git-daemonはより詳細なエラーをクライアントに報告し、「no such repository」(そのようなリポジトリがない)と「repository not exported」(リポジトリがエクスポートされていない)などの条件を区別します。これはクライアントにとってより便利ですが、エクスポートされていないリポジトリの存在に関する情報が漏洩する可能性があります。informative-errorsが有効になっていない場合、すべてのエラーは「access denied」とクライアントに報告します。 デフォルトは --no-informative-errors です。

クライアントが接続するたびに、最初に、<path> で指定された外部コマンドを実行します。コマンドライン引数として、サービス名("upload-pack"など)や、リポジトリへのパスや、ホスト名(%H)や、正規のホスト名(%CH)や、IPアドレス(%IP)や、TCPポート(%P)を、指定します。外部コマンドは、ゼロ以外のステータスで終了することによってサービスを拒否する(またはゼロ・ステータスで終了することによってサービスを許可する)ことを決定できます。また $REMOTE_ADDR や $REMOTE_PORT 環境変数を調べて、この決定を行うときにリクエスト側(requestor)ついて調べることもできます。

残りの引数は、ディレクトリのリストを提供します。 ディレクトリが指定されている場合、 git-daemon プロセスは、 要求されたディレクトリがこれらのディレクトリのいずれかに含まれている場合にのみ、 リクエストされたディレクトリをサーブします。 --strict-paths が指定されている場合、リクエストされたディレクトリはこれらのディレクトリのいずれかと正確に一致する必要があります。

これは、 git fetch-pack と git ls-remote クライアントにサービスを提供します。デフォルトで有効になっていますが、リポジトリでは daemon.uploadpack 構成アイテムを false に設定することで無効にできます。

これは git archive --remote を提供します。 デフォルトでは無効になっていますが、リポジトリでは、 daemon.uploadarch 構成アイテムを true に設定することで有効にできます。

これは git send-pack クライアントにサービスを提供し、匿名プッシュを可能にします。プロトコルに認証が「ない」ため、デフォルトでは無効になっています(つまり、参照の削除を含め、誰でもリポジトリに何でもプッシュできます)。これは、誰もが友好的であるクローズドLAN設定のみを対象としています。このサービスは、 daemon.receivepack 構成アイテムを true に設定することで有効にできます。

/pub/foo または /pub/bar 内の任意のリポジトリを処理する inetd サービスとして「git daemon」を設定するには、 以下のようなエントリを /etc/inetd に、すべて 1 行で配置します:

        git stream tcp nowait nobody  /usr/bin/git
                git daemon --inetd --verbose --export-all
                /pub/foo /pub/bar

異なる仮想ホスト www.example.com と www.example.org のリポジトリを処理するinetdサービスとして「git daemon」を設定するには、以下のようなエントリをすべて１行で /etc/inetd に配置します:

        git stream tcp nowait nobody /usr/bin/git
                git daemon --inetd --verbose --export-all
                --interpolated-path=/pub/%H%D
                /pub/www.example.org/software
                /pub/www.example.com/software
                /software

IPアドレスに基づいて複数の仮想ホストのリポジトリを処理する通常の非inetdサービスとして「git daemon」を設定するには、以下のようにデーモンを起動します:

        git daemon --verbose --export-all
                --interpolated-path=/pub/%IP/%D
                /pub/192.168.1.200/software
                /pub/10.10.220.23/software

リポジトリに対して git archive --remote を有効にし、 git fetch を無効にするには、リポジトリの構成ファイルに以下のものを含めます（つまり、「HEAD」、「refs」、および「objects」の横にあるファイル「config」)。

        [daemon]
                uploadpack = false
                uploadarch = true