mirror of
https://github.com/git/git.git
synced 2024-10-30 13:57:54 +01:00
72 lines
2 KiB
Text
72 lines
2 KiB
Text
|
git-remote-helpers(1)
|
||
|
=====================
|
||
|
|
||
|
NAME
|
||
|
----
|
||
|
git-remote-helpers - Helper programs for interoperation with remote git
|
||
|
|
||
|
SYNOPSIS
|
||
|
--------
|
||
|
'git remote-<transport>' <remote>
|
||
|
|
||
|
DESCRIPTION
|
||
|
-----------
|
||
|
|
||
|
These programs are normally not used directly by end users, but are
|
||
|
invoked by various git programs that interact with remote repositories
|
||
|
when the repository they would operate on will be accessed using
|
||
|
transport code not linked into the main git binary. Various particular
|
||
|
helper programs will behave as documented here.
|
||
|
|
||
|
COMMANDS
|
||
|
--------
|
||
|
|
||
|
Commands are given by the caller on the helper's standard input, one per line.
|
||
|
|
||
|
'capabilities'::
|
||
|
Lists the capabilities of the helper, one per line, ending
|
||
|
with a blank line.
|
||
|
|
||
|
'list'::
|
||
|
Lists the refs, one per line, in the format "<value> <name>
|
||
|
[<attr> ...]". The value may be a hex sha1 hash, "@<dest>" for
|
||
|
a symref, or "?" to indicate that the helper could not get the
|
||
|
value of the ref. A space-separated list of attributes follows
|
||
|
the name; unrecognized attributes are ignored. After the
|
||
|
complete list, outputs a blank line.
|
||
|
|
||
|
'fetch' <sha1> <name>::
|
||
|
Fetches the given object, writing the necessary objects to the
|
||
|
database. Outputs a blank line when the fetch is
|
||
|
complete. Only objects which were reported in the ref list
|
||
|
with a sha1 may be fetched this way.
|
||
|
+
|
||
|
Supported if the helper has the "fetch" capability.
|
||
|
|
||
|
If a fatal error occurs, the program writes the error message to
|
||
|
stderr and exits. The caller should expect that a suitable error
|
||
|
message has been printed if the child closes the connection without
|
||
|
completing a valid response for the current command.
|
||
|
|
||
|
Additional commands may be supported, as may be determined from
|
||
|
capabilities reported by the helper.
|
||
|
|
||
|
CAPABILITIES
|
||
|
------------
|
||
|
|
||
|
'fetch'::
|
||
|
This helper supports the 'fetch' command.
|
||
|
|
||
|
REF LIST ATTRIBUTES
|
||
|
-------------------
|
||
|
|
||
|
None are defined yet, but the caller must accept any which are supplied.
|
||
|
|
||
|
Documentation
|
||
|
-------------
|
||
|
Documentation by Daniel Barkalow.
|
||
|
|
||
|
GIT
|
||
|
---
|
||
|
Part of the linkgit:git[1] suite
|