gitremote-helpers(7) Manual Page

ヘルパーの機能を1行に1つずつリスト出力し、空白行で終わります。各機能の前に * を付けることができます。これは、リモートヘルパーを使うGitのバージョンで理解することが必須であることを示します。不明な必須機能は致命的なエラーです。

refを1行に1つずつ、 <value> <name> [<attr> ...] の形式で一覧出力します。 値は、16進のsha1ハッシュ または、symrefの場合は @<dest> または、キーと値のペアの場合は :<keyword> <value> または、 `？｀ の場合はヘルパーがrefの値を取得できなかったことを示します。 nameの後には、スペースで区切られたattributes(属性)のリストが続きます。認識されない属性は無視されます。リストは空白行で終わります。

list と似ていますが、呼び出し元が結果のrefリストでプッシュコマンドを準備したい場合にのみ使用される点が異なります。プッシュとフェッチの両方をサポートするヘルパーは、これを使用して、 list の出力が使用される操作を区別し、実行する必要のある作業の量を減らすことができます。

転送(transport)ヘルパーオプション <name> を <value> に設定します。出力は、 ok(オプションが正常に設定された)または、 unsupported(オプションが認識されない)または、 error <msg>(オプション<name>はサポートされていますが、<value>は無効です)のいずれかを含む単一行です。オプションは他のコマンドの前に設定する必要があり、それらのコマンドの動作に影響を与える可能性があります。

指定されたオブジェクトをフェッチし、必要なオブジェクトをデータベースに書き込みます。fetchコマンドは、1行に1つずつバッチで送信され、空白行で終了します。 同じバッチ内のすべてのfetchコマンドが完了すると、1行の空白行を出力します。この方法でフェッチできるのは、sha1を使用した list の出力で報告されたオブジェクトのみです。

指定された ローカル <src> コミットまたはブランチを、 <dst>で記述されたリモートブランチにプッシュします。 1つ以上の push コマンドのバッチシーケンスは空白行で終了します(pushへの参照が1つしかない場合は、単一の push コマンドの後に空白行が続きます)。たとえば、以下は push の2つのバッチであり、最初のはリモートヘルパーに、ローカル参照 master をリモート参照 master にプッシュし、ローカル HEAD をリモート branch にプッシュするように要求します。2番目のは ref foo を ref bar にプッシュするように要求します(+ によって要求された強制更新です)。

push refs/heads/master:refs/heads/master
push HEAD:refs/heads/branch
\n
push +refs/heads/foo:refs/heads/bar
\n

名前付きrefの現在の値をインポートするfast-importストリームを生成します。履歴を効率的に構築するために、必要に応じて他の参照を追加でインポートする場合があります。スクリプトは、ヘルパー固有のプライベート名前空間に書き込みます。名前付きrefの値は、「refspec」機能からのrefspecをrefの名前に適用することによって派生した、この名前空間内の場所に書き込む必要があります。

後続の入力は、リモートにプッシュする必要のあるオブジェクトを含むfast-importストリーム( git fast-export によって生成される)の一部であることをリモートヘルパーに指示します。

指定のサービスに接続します。ヘルパーの標準入力と標準出力は、リモート側で指定指定のサービスに接続されます(gitプレフィックスはサービス名に含まれているので、例えばフェッチはサービスとして git-upload-pack を使用します)。このコマンドに対する有効な応答は、空行(接続が確立されました)と、 fallback (スマート転送サポートなし、バカ転送(dumb transports)にフォールバック)と、エラーメッセージが印刷された状態で終了するだけです(接続できません、フォールバックしようと気にしないで)。肯定(空)応答が改行で終了すると、サービスの出力が開始されます。接続が終了すると、リモートヘルパーは終了します。

実験的: 内部使用のみ。 gitのワイヤープロトコルバージョン2を使用して通信するために、指定のリモートサービスに接続します。このコマンドへの有効な応答は、空行(接続が確立されました)と、 fall back (スマート転送サポートなし、バカ転送にフォールバック)と、エラーメッセージ出力するだけです(接続できません。わざわざフォールバックしようとしないでください)。 正の(空の)応答を終了する改行の後、サービスの出力が開始されます。 メッセージ(要求と応答の両方)は、0個以上のPKT-LINEで構成され、フラッシュパケットで終了する必要があります。 応答メッセージには、応答の終了を示すフラッシュパケットの後に応答終了パケットがあります。 クライアントは、サーバーが要求と応答のペアの間に状態を保持することを期待してはなりません。接続が終了すると、リモートヘルパーが終了します。

指定の <uri> から指定の <path> へファイルをダウンロードします。 <path>.temp が存在する場合、Git は .temp ファイルが以前の試みからの部分的なダウンロードであると想定し、 その位置からダウンロードを再開します。

このrefは、最後にインポートまたはフェッチしたときから変更されていませんが、ヘルパーは必ずしもどの値が生成されたかを判別することはできるわけではありません。

refは指定のハッシュアルゴリズムを使用しています。このキーワードは、サーバーとクライアントの両方がオブジェクト形式の拡張機能(object-format extension)をサポートしている場合にのみ使用されます。

ヘルパーによって表示されるメッセージの詳細度を変更します。 <n>の値0は、プロセスが静かに動作し、ヘルパーがエラー出力のみを生成することを意味します。 1は冗長性のデフォルトレベルであり、<n>の値が大きさは、コマンドラインで渡される -v フラグの数に対応します。

コマンド実行中に転送(transport)ヘルパーによって表示される進行状況メッセージを有効(または無効)にします。

浅いリポジトリ(shallow repository)の履歴を深めます。

時間に基づいて浅いリポジトリ(shallow repository)の履歴を深めます。

refを除く浅いリポジトリ(shallow repository)の履歴を深めます。複数回使用できます。

現在の境界に比べて浅いリポジトリの履歴を深めます。 「option depth」で使用する場合にのみ有効です。

有効にすると、フェッチコマンド中にタグが指すオブジェクトが転送された場合、ヘルパーは注釈付きのタグオブジェクトを自動的にフェッチする必要があります。 タグがヘルパーによってフェッチされない場合、通常、2番目のフェッチコマンドが送信され、タグを具体的に要求します。一部のヘルパーは、このオプションを使用して2番目のネットワーク接続を回避できる場合があります。

trueの場合、操作が正常に完了したふりをしますが、実際にはリポジトリデータを変更しません。 ほとんどのヘルパーの場合、これはサポートされている場合、 push にのみ適用されます。

次の接続のサービスパス(--upload-pack 、--receive-pack など)を設定します。 リモートヘルパーはこのオプションをサポートする場合がありますが、接続要求が発生する前に、設定されているこのオプションに依存してはなりません。

ヘルパーにクローンの接続を確認(check)するように依頼(request)します。

ヘルパーに強制更新を実行するように依頼(request)します。デフォルトは false です。

これがクローンリクエストであることをヘルパーに通知します(つまり、現在のリポジトリは空であることが保証されています)。

新しいrefで必要な場合は、 .git/shallow を拡張できるようにします。

GPG署名プッシュ。

<string>をプッシュオプションとして送信します。プッシュオプションにはLFまたはNUL文字を含めることはできないため、文字列はエンコードされません。

これらのオブジェクトがpromisorからフェッチされていることを示します。

依存関係ではなく、必要なオブジェクトのみをフェッチする必要があることを示します。

プッシュするときは、リモートサーバーに単一のアトミックトランザクションで参照を更新するように要求します。 成功すると、すべての参照が更新されるか、何も更新されません。 リモート側がこの機能をサポートしていない場合、プッシュは失敗します。

Indicate that the caller wants hash algorithm information to be passed back from the remote. This mode is used when fetching refs.