Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.43.1 → 2.47.1 no changes
- 2.43.0 11/20/23
- 2.22.1 → 2.42.3 no changes
- 2.22.0 06/07/19
- 2.18.1 → 2.21.4 no changes
- 2.18.0 06/21/18
- 2.3.10 → 2.17.6 no changes
- 2.2.3 09/04/15
- 2.1.4 no changes
- 2.0.5 12/17/14
DESCRIÇÃO
Este auxiliar remoto utiliza o <comando> informado para se conectar num servidor Git remoto.
Assume-se que os dados gravados no stdin do <comando> informado sejam encaminhados para um servidor git://
, git-upload-pack
, git-receive-pack
ou git-upload-archive
(dependendo da situação) e os dados lidos do stdout do <comando> assume-se ter sido recebido do mesmo serviço.
O comando e os argumentos são separados por um espaço sem escape.
As seguintes sequências têm um significado especial:
- '% '
-
Espaço literal em comando ou argumento.
- %%
-
Sinal de porcentagem literal.
- %s
-
Substituído pelo nome (
receive-pack
(pacote de recebimento),upload-pack
(pacote de upload), ouupload-archive
(arquivo de upload)) do serviço que o Git deseja invocar. - %S
-
Substituído pelo longo nome (
git-receive-pack
,git-upload-pack
, ougit-upload-archive
) do serviço que o Git deseja invocar. - %G (devem ser os primeiros caracteres num argumento)
-
Esse argumento não será passado para <comando>. Em vez disso, ele fará com que o auxiliar comece enviando as solicitações de serviço git:// para o lado remoto com o campo de serviço definido para um valor apropriado e o campo de repositório definido para o restante do argumento. A predefinição é não enviar esta solicitação.
É útil caso o lado remoto seja um servidor git:// acessado por algum túnel.
- %V (deve ser o primeiro caractere no argumento)
-
Esta opção não será passada para o
<comando>
. Em vez disso, ele define o campo vhost na solicitação de serviçogit://
(para o restante do argumento). A predefinição é não enviar o vhost em tal solicitação (se for enviado).
EXEMPLOS
Este auxiliar remoto é usado de maneira transparente pelo Git ao utilizar comandos como git fetch <URL>
, "git clone <URL>", git push <URL>
ou git remote add <nick> <URL>
, onde <URL>
começa com ext::
. Exemplos:
- "ext::ssh -i /home/foo/.ssh/somekey user@host.example %S foo/repo"
-
Como host.example:foo/repo, porém utilize /home/foo/.ssh/somekey como um par de chaves e o usuário como um usuário no lado remoto. Isso evita a necessidade de se editar o .ssh/config.
- "ext::socat -t3600 - ABSTRACT-CONNECT:/git-server %G/somerepo"
-
Representa o repositório com o caminho /algumrepo acessível através do protocolo git no endereço do espaço de nomes abstrato /git-server.
- "ext::git-server-alias foo %G/repo"
-
Representa um repositório com o caminho
/repo
acessado usando o programa auxiliar do comandogit-server-alias foo
. O caminho para o repositório e o tipo de solicitação não são passados na linha de comando, mas como parte do fluxo do protocolo, como de costume, com o protocologit://
. - "ext::git-server-alias foo %G/repo %Vfoo"
-
Representa um repositório com o caminho
/repo
acessado usando o programa auxiliar do comandogit-server-alias foo
. O nome do host do servidor remoto passado no fluxo do protocolo será "foo" (isso permite que vários servidores Git virtuais compartilhem um endereço no nível do link). - "ext::git-server-alias foo %G/repo% with% spaces %Vfoo"
-
Representa um repositório com o caminho
/repo com espaços
acessado usando o programa auxiliargit-server-alias foo
. O nome do host do servidor remoto passado no fluxo do protocolo será "foo" (isso permite que vários servidores Git virtuais compartilhem um endereço no nível do link). - "ext::git-ssl foo.examplo /bar"
-
Representa um repositório acessado usando o programa auxiliar
git-ssl foo.example /bar
. O tipo de solicitação pode ser determinado pelo auxiliar usando variáveis de ambiente (veja acima).
GIT
Parte do conjunto git[1]