gitremote-helpers - Online w chmurze

PROGRAM:

IMIĘ

gitremote-helpers - Programy pomocnicze do interakcji ze zdalnymi repozytoriami

STRESZCZENIE

odrzutowiec zdalny- [ ]

OPIS

Zdalne programy pomocnicze zwykle nie są używane bezpośrednio przez użytkowników końcowych, ale są wywoływane
przez Git, gdy musi wchodzić w interakcje ze zdalnymi repozytoriami, których Git nie obsługuje natywnie. A
dany pomocnik zaimplementuje podzbiór udokumentowanych tutaj możliwości. Kiedy Git potrzebuje
aby wchodzić w interakcje z repozytorium za pomocą zdalnego pomocnika, odradza pomocnika jako plik
niezależny proces, wysyła polecenia na standardowe wejście pomocnika i oczekuje wyników
ze standardowego wyjścia pomocnika. Ponieważ zdalny pomocnik działa jako niezależny proces
z Git, nie ma potrzeby ponownego łączenia Git, aby dodać nowego pomocnika, ani żadnej potrzeby łączenia
pomocnik przy implementacji Git.

Każdy pomocnik musi obsługiwać polecenie „capabilities”, którego Git używa do określenia czego
inne polecenia, które pomocnik zaakceptuje. Te inne polecenia mogą służyć do wykrywania i
aktualizuj zdalne referencje, transportuj obiekty między bazą danych obiektów a zdalnym
repozytorium i zaktualizuj lokalną składnicę obiektów.

Git jest dostarczany z rodziną „curl” zdalnych pomocników, którzy obsługują różne protokoły transportowe,
jak na przykład git-zdalny-http, git-zdalny-https, git-remote-ftp i git-remote-ftps. Oni
wdrożyć możliwości sprowadzać, opcja, naciskać.

WEZWANIE

Zdalne programy pomocnicze są wywoływane z jednym lub (opcjonalnie) dwoma argumentami. Pierwszy
argument określa zdalne repozytorium jak w Git; jest to albo nazwa skonfigurowanego
zdalny lub adres URL. Drugi argument określa adres URL; ma zwykle postać
://, ale możliwy jest dowolny ciąg znaków. The GIT_DIR środowisko
zmienna jest ustawiona dla zdalnego pomocnika i może być użyta do określenia miejsca przechowywania
dodatkowe dane lub z którego katalogu wywoływać pomocnicze polecenia Gita.

Gdy Git napotka adres URL formularza ://, Gdzie jest
protokół, którego nie może obsłużyć natywnie, wywołuje automatycznie odrzutowiec zdalny-
z pełnym adresem URL jako drugim argumentem. Jeśli taki adres URL zostanie napotkany bezpośrednio w pliku
linii poleceń, pierwszy argument jest taki sam jak drugi, a jeśli zostanie napotkany w a
skonfigurowanego pilota, pierwszym argumentem jest nazwa tego pilota.

Adres URL formularza :: wyraźnie instruuje Git, aby wywołał odrzutowiec
zdalny- w jako drugi argument. Jeśli taki adres URL zostanie napotkany
bezpośrednio w wierszu poleceń, pierwszym argumentem jest , a jeśli występuje w
skonfigurowanego pilota, pierwszym argumentem jest nazwa tego pilota.

Dodatkowo, gdy skonfigurowany pilot ma zdalny. .vcs Ustawić , Git
wyraźnie wzywa odrzutowiec zdalny- w jako pierwszy argument. Jeśli ustawione,
drugim argumentem jest zdalny. .url; w przeciwnym razie drugi argument jest pomijany.

WEJŚCIE FORMAT

Git wysyła zdalnemu pomocnikowi listę poleceń na standardowym wejściu, po jednym w każdym wierszu. Pierwszy
polecenie jest zawsze możliwości polecenie, w odpowiedzi na które zdalny pomocnik musi
wydrukuj listę obsługiwanych możliwości (patrz poniżej), a następnie pustą linię. The
odpowiedź na polecenie możliwości określa, jakich poleceń Git używa w pozostałej części
strumień poleceń.

Strumień poleceń jest zakończony pustą linią. W niektórych przypadkach (wskazanych w
dokumentacji odpowiednich poleceń), po tym pustym wierszu w niektórych przypadkach następuje ładunek
inny protokół (np. protokół pack), podczas gdy w innych wskazuje koniec wejścia.

Nasze możliwości
Oczekuje się, że każdy zdalny pomocnik będzie obsługiwał tylko podzbiór poleceń. Operacje
wsparcie pomocnicze jest deklarowane Gitowi w odpowiedzi na polecenie Ability (patrz
POLECENIA poniżej).

Poniżej wymienimy wszystkie zdefiniowane możliwości i dla każdej z nich wymienimy, które polecenia a
pomocnik z tą zdolnością musi zapewnić.

Nasze możliwości dla Popychanie
connect
Może próbować połączyć się z odrzutowiec pakiet odbiorczy (do pchania), odrzutowiec pakiet przesyłania, itp. dla
komunikacja przy użyciu natywnego protokołu git packfile. Wymaga to dwukierunkowego,
połączenie w trybie pełnego dupleksu.

Obsługiwane polecenia: connect.

naciskać
Może odkrywać zdalne referencje i przekazywać lokalne zatwierdzenia oraz historię prowadzącą do nich
do nowych lub istniejących zdalnych referencji.

Obsługiwane polecenia: podstęp for-push, naciskać.

eksport
Może wykrywać zdalne referencje i przesyłać określone obiekty ze strumienia szybkiego importu do
zdalne ref.

Obsługiwane polecenia: podstęp for-push, eksport.

Jeśli pomocnik się reklamuje connect, Git użyje go, jeśli to możliwe, i wróci do innego
możliwości, jeśli pomocnik poprosi o to podczas łączenia (zobacz connect dowództwo pod
POLECENIA). Wybierając pomiędzy naciskać i eksport, preferuje Git naciskać. Inne nakładki
może mieć inną kolejność preferencji.

brak-prywatnej-aktualizacji
Podczas korzystania z refspec możliwości, git zwykle aktualizuje prywatne odwołanie
udane pchnięcie. Ta aktualizacja jest wyłączona, gdy pomocnik zdalny zadeklaruje
zdolność brak-prywatnej-aktualizacji.

Nasze możliwości dla Ujmujący
connect
Może spróbować połączyć się z odrzutowiec pakiet przesyłania (do pobierania), odrzutowiec pakiet odbiorczy, itp. dla
komunikacja przy użyciu natywnego protokołu plików pakietowych Gita. To wymaga
dwukierunkowe połączenie w trybie pełnego dupleksu.

Obsługiwane polecenia: connect.

sprowadzać
Może wykrywać zdalne referencje i przenosić osiągalne z nich obiekty do lokalnego
magazyn obiektów.

Obsługiwane polecenia: podstęp, sprowadzać.

importować
Może wykrywać zdalne referencje i osiągalne z nich obiekty wyjściowe jako strumień w
format szybkiego importu.

Obsługiwane polecenia: podstęp, importować.

sprawdź łączność
Może zagwarantować, że gdy wymagany jest klon, otrzymany pakiet jest samowystarczalny
i jest podłączony.

Jeśli pomocnik się reklamuje connect, Git użyje go, jeśli to możliwe, i wróci do innego
możliwości, jeśli pomocnik poprosi o to podczas łączenia (zobacz connect dowództwo pod
POLECENIA). Wybierając pomiędzy sprowadzać i importować, preferuje Git sprowadzać. Inne nakładki
może mieć inną kolejność preferencji.

Różne możliwości
opcja
Do określania ustawień, takich jak gadatliwość (ilość danych wyjściowych do zapisu na stderr) i
głębokość (ile historii jest potrzebne w przypadku płytkiego klonu), które wpływają na to, jak
wykonywane są inne polecenia.

refspec
Dla zdalnych pomocników, którzy wdrażają importować or eksport, ta zdolność umożliwia
refs być ograniczone do prywatnej przestrzeni nazw, zamiast pisać do refs/heads lub
refs/remote bezpośrednio. Zaleca się, aby wszyscy importerzy dostarczający importować
możliwość korzystania z tego. Jest to obowiązkowe dla eksport.

Pomocnik reklamujący zdolność refspec
refs/heads/*:refs/svn/Origin/branches/* mówi to, gdy jest proszony o import
refs/heads/topic, strumień, który wyprowadza, zaktualizuje
refs/svn/origin/branches/temat ref.

Ta funkcja może być reklamowana wielokrotnie. Pierwsza mająca zastosowanie specyfikacja ref
ma pierwszeństwo. Lewa ręka refspeców reklamowanych z tą możliwością musi
obejmuje wszystkie referencje zgłoszone przez polecenie list. Jeśli nie refspec zdolność jest
reklamowany, istnieje domniemany refspec *:*.

Podczas pisania zdalnych pomocników dla zdecentralizowanych systemów kontroli wersji tak jest
radzimy zachować lokalną kopię repozytorium w celu interakcji z nim i pozwolić plikowi
private namespace refs wskazują na to lokalne repozytorium, podczas gdy refs/remotes
przestrzeń nazw jest używana do śledzenia zdalnego repozytorium.

import bidi
To modyfikuje importować zdolność. Polecenia szybkiego importu kot-kropelka i ls mogą
być używane przez zdalnych pomocników do pobierania informacji o obiektach blob i drzewach
już istnieją w pamięci szybkiego importu. Wymaga to kanału z szybkiego importu do
zdalny pomocnik. Jeśli jest reklamowany oprócz „importu”, Git ustanawia plik
potok z szybkiego importu do stdin zdalnego pomocnika. Wynika z tego, że Git i
fast-import są połączone ze stdin zdalnego pomocnika. Ponieważ Git może wysyłać
wiele poleceń do zdalnego pomocnika, wymagane jest, aby pomocnicy, którzy używają
import bidi buforuj wszystko importować polecenia partii przed wysłaniem danych do
szybki import. Ma to na celu zapobieżenie mieszaniu poleceń i odpowiedzi szybkiego importu na
stdin pomocnika.

znaki eksportowe
To modyfikuje eksport możliwości, instruując Git, aby zrzucił wewnętrzne znaki
stół do po zakończeniu. Aby uzyskać szczegółowe informacje, czytaj dalej --export-znaki= in
git-szybki-eksport(1).

znaki importowe
To modyfikuje eksport możliwości, instruując Git, aby załadował określone znaki
W przed przetworzeniem jakichkolwiek danych wejściowych. Aby uzyskać szczegółowe informacje, czytaj dalej
--import-znaki= in git-szybki-eksport(1).

podpisane tagi
To modyfikuje eksport możliwości, instruując Git, aby przeszedł
--signed-tags=dosłownie do git-szybki-eksport(1). W przypadku braku tej zdolności,
Git użyje --signed-tags=pasek ostrzegawczy.

POLECENIA

Polecenia wydawane są przez dzwoniącego na standardowe wejście pomocnika, po jednym w każdym wierszu.

możliwości
Wyświetla listę możliwości pomocnika, po jednym w każdym wierszu, kończąc na pustym wierszu. Każdy
zdolność może być poprzedzone *, co oznacza, że ​​są one obowiązkowe dla używanych wersji Git
zdalny pomocnik do zrozumienia. Każda nieznana obowiązkowa zdolność jest błędem krytycznym.

Obsługa tego polecenia jest obowiązkowa.

podstęp
Wyświetla odnośniki, po jednym w wierszu, w formacie „ [ ...]". Wartość
może być hashem szesnastkowym sha1, "@ " dla symref lub "?", aby wskazać, że pomocnik
nie można uzyskać wartości ref. Poniżej znajduje się oddzielona spacjami lista atrybutów
nazwa; nierozpoznane atrybuty są ignorowane. Lista kończy się pustą linią.

Zobacz REF LIST ATRYBUTY, aby zapoznać się z listą aktualnie zdefiniowanych atrybutów.

Obsługiwane, jeśli pomocnik ma możliwość „pobierania” lub „importowania”.

podstęp for-push
Podobny do podstęp, z wyjątkiem tego, że jest używany wtedy i tylko wtedy, gdy dzwoniący chce
wynikową listę referencyjną w celu przygotowania poleceń wypychania. Pomocnik obsługujący zarówno wypychanie, jak i pobieranie
może to wykorzystać do rozróżnienia, dla której operacji dane wyjściowe podstęp będzie
wykorzystane, co może zmniejszyć ilość pracy, którą należy wykonać.

Obsługiwane, jeśli pomocnik ma możliwość „wypychania” lub „eksportowania”.

opcja
Ustawia opcję pomocnika transportu Do . Wyprowadza pojedynczą linię zawierającą
jeden z ok (opcja pomyślnie ustawiona), nieobsługiwane (opcja nierozpoznana) lub błąd
(opcja jest obsługiwany, ale się do tego nie nadaje). Opcje powinny być
ustawić przed innymi poleceniami i może wpływać na zachowanie tych poleceń.

Zobacz OPCJE, aby zapoznać się z listą aktualnie zdefiniowanych opcji.

Obsługiwane, jeśli pomocnik ma możliwość „opcji”.

sprowadzać
Pobiera podany obiekt, zapisując niezbędne obiekty do bazy danych. Aportować
polecenia są wysyłane w partii, po jednym w wierszu, zakończone pustą linią. Wyjścia
pojedynczy pusty wiersz, gdy wszystkie polecenia pobierania w tej samej partii są zakończone. Tylko obiekty
które zostały zgłoszone w danych wyjściowych podstęp z sha1 można pobrać w ten sposób.

Opcjonalnie może wyprowadzić a zablokować wiersz wskazujący plik w katalogu GIT_DIR/objects/pack
który przechowuje paczkę, dopóki referencje nie zostaną odpowiednio zaktualizowane.

Jeśli opcja sprawdź łączność jest wymagane, pomocnik musi wyjść łączność-ok if
klon jest samowystarczalny i połączony.

Obsługiwane, jeśli pomocnik ma możliwość „pobierania”.

naciskać + :
Wypycha podanego lokalnego zatwierdzenie lub rozgałęzienie do zdalnej gałęzi opisanej przez .
Sekwencja wsadowa jednego lub więcej naciskać polecenia kończy się pustą linią (if
istnieje tylko jedno odniesienie do wypychania, pojedyncze naciskać po poleceniu następuje spacja
linia). Na przykład następujące będą dwie partie naciskać, pierwszy pytając
zdalny pomocnik, aby wypchnąć lokalny ref mistrz do zdalnego ref mistrz i miejscowy GŁOWA
do pilota oddział, a drugi z prośbą o wypchnięcie ref bla do ref bar (wymuszona aktualizacja
na żądanie +).

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

Po ostatniej można wprowadzić zero lub więcej opcji protokołu naciskać komenda, przed
pusta linia kończąca partię.

Po zakończeniu wypychania wyprowadza jeden lub więcej ok or błąd ? linie
aby wskazać powodzenie lub niepowodzenie każdego wypchniętego ref. Wyjście raportu stanu to
zakończone pustą linią. Pole opcji może być cytowany w łańcuchu w stylu C
jeśli zawiera LF.

Obsługiwane, jeśli pomocnik ma możliwość „wypychania”.

importować
Tworzy strumień szybkiego importu, który importuje bieżącą wartość nazwanego ref. Może
dodatkowo importuj inne referencje w razie potrzeby, aby wydajnie konstruować historię. The
script zapisuje do prywatnej przestrzeni nazw specyficznej dla pomocnika. Wartość nazwanego ref
należy zapisać w lokalizacji w tej przestrzeni nazw uzyskanej przez zastosowanie refspecs
od możliwości „refspec” do nazwy ref.

Szczególnie przydatne do współdziałania z zagranicznym systemem wersjonowania.

Tak jak naciskać, sekwencja wsadowa jednego lub więcej importować kończy się spacją
linia. Dla każdej partii importować, pomocnik zdalny powinien wygenerować strumień szybkiego importu
rozwiązany przez A zrobić dowództwo.

Zwróć uwagę, że jeśli import bidi wykorzystywana jest pełna sekwencja partii
buforowane przed rozpoczęciem wysyłania danych do szybkiego importu, aby zapobiec mieszaniu poleceń i
szybkie importowanie odpowiedzi na stdin pomocnika.

Obsługiwane, jeśli pomocnik ma możliwość „importowania”.

eksport
Instruuje pomocnika zdalnego, że każde kolejne wejście jest częścią strumienia szybkiego importu
(wygenerowane przez odrzutowiec szybki eksport) zawierające obiekty, które należy przesunąć do
zdalny.

Szczególnie przydatne do współdziałania z zagranicznym systemem wersjonowania.

Połączenia znaki eksportowe i znaki importowe możliwości, jeśli są określone, wpływają na to polecenie w
o ile są przekazywane odrzutowiec szybki eksport, który następnie załaduje/przechowa tabelę
znaki dla lokalnych obiektów. Można to wykorzystać do implementacji operacji przyrostowych.

Obsługiwane, jeśli pomocnik ma możliwość „eksportowania”.

connect
Łączy się z daną usługą. Standardowe wejście i standardowe wyjście pomocnika są podłączone
do określonej usługi (przedrostek git jest zawarty w nazwie usługi, więc np
git-upload-pack jako usługa) po stronie zdalnej. Prawidłowe odpowiedzi na to polecenie są puste
linia (połączenie nawiązane), awaryjna (brak inteligentnego wsparcia transportowego, powrót do głupiego
transports) i po prostu wychodzić z wydrukowanym komunikatem o błędzie (nie można się połączyć, nie przejmuj się
próbując się wycofać). Po wysuwie wiersza kończącym pozytywną (pustą) odpowiedź,
rozpoczyna się wyjście usługi. Po zakończeniu połączenia pomocnik zdalny kończy pracę.

Obsługiwane, jeśli pomocnik ma możliwość „łączenia”.

Jeśli wystąpi błąd krytyczny, program zapisuje komunikat o błędzie na stderr i kończy działanie. The
wywołujący powinien spodziewać się, że w przypadku zamknięcia elementu potomnego zostanie wydrukowany odpowiedni komunikat o błędzie
połączenie bez podania prawidłowej odpowiedzi na bieżące polecenie.

Mogą być obsługiwane dodatkowe polecenia, co można określić na podstawie możliwości zgłoszonych przez
pomocnik.

REF WYKAZ ATRYBUTY

Połączenia podstęp Komenda tworzy listę referencji, w której po każdej referencji może następować lista referencji
atrybuty. Zdefiniowane są następujące atrybuty listy ref.

bez zmian
Ten ref jest niezmieniony od ostatniego importu lub pobrania, chociaż pomocnik nie może
koniecznie określić, jaką wartość wytworzyła.

OPCJE

Następujące opcje są zdefiniowane i (w odpowiednich okolicznościach) ustawione przez Git, jeśli:
zdalny pomocnik ma opcja zdolność.

opcja gadatliwość
Zmienia szczegółowość komunikatów wyświetlanych przez pomocnika. Wartość 0 dla oznacza
że procesy działają cicho, a pomocnik generuje tylko błąd. 1 jest
domyślny poziom gadatliwości i wyższe wartości odpowiadają liczbie -v
flagi przekazywane w wierszu poleceń.

opcja postęp {prawdziwy|fałszywy}
Włącza (lub wyłącza) komunikaty o postępie wyświetlane przez pomocnika transportu podczas a
dowództwo.

opcja głębokość
Pogłębia historię płytkiego repozytorium.

opcja Obserwuj tagi {prawdziwy|fałszywy}
Jeśli ta opcja jest włączona, pomocnik powinien automatycznie pobierać obiekty znaczników z adnotacjami, jeśli obiekt
znacznik wskazuje na został przesłany podczas wykonywania polecenia pobierania. Jeśli tag nie zostanie pobrany
pomocnik zwykle wysyła drugie polecenie pobierania z prośbą o tag
konkretnie. Niektórzy pomocnicy mogą skorzystać z tej opcji, aby uniknąć drugiej sieci
połączenia.

opcja próba {prawdziwy|fałszywy}: Jeśli prawda, udawaj, że operacja zakończyła się pomyślnie, ale
tak naprawdę nie zmieniaj żadnych danych repozytorium. W przypadku większości pomocników dotyczy to tylko pliku naciskać,
jeśli jest obsługiwany.

opcja ścieżka serwa
Ustawia ścieżkę usługi (--upload-pack, --receive-pack itp.) dla następnego połączenia. Zdalny pomocnik
może obsługiwać tę opcję, ale nie może polegać na ustawieniu tej opcji przed połączeniem
występuje żądanie.

opcja sprawdź łączność {prawdziwy|fałszywy}
Poproś pomocnika o sprawdzenie łączności klona.

opcja siła {prawdziwy|fałszywy}
Poproś pomocnika o wykonanie wymuszonej aktualizacji. Domyślnie do fałszywy.

opcja klonowanie {'PRAWDA|fałszywy}
Powiadom pomocnika, że ​​jest to żądanie klonowania (tj. bieżące repozytorium jest gwarantowane
pusty).

opcja aktualizacja-płytka {'PRAWDA|fałszywy}
Pozwól rozszerzyć .git/shallow, jeśli wymagają tego nowe referencje.

opcja pushcert {'PRAWDA|fałszywy}
Pchnięcia znaku GPG.

Korzystaj z gitremote-helpers online, korzystając z usług onworks.net