| 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 |
