gitremote-helpers - Bulutta Çevrimiçi

Program:

ADI

gitremote-helpers - Uzak depolarla etkileşim için yardımcı programlar

SİNOPSİS

git uzak- [ ]

TANIM

Uzak yardımcı programlar normalde doğrudan son kullanıcılar tarafından kullanılmaz, ancak çağrılır.
Git tarafından uzak depolarla etkileşime girmesi gerektiğinde Git yerel olarak desteklemez. A
verilen yardımcı burada belgelenen yeteneklerin bir alt kümesini uygulayacaktır. Git'in ihtiyacı olduğunda
uzak bir yardımcı kullanarak bir havuzla etkileşim kurmak için, yardımcıyı bir
bağımsız süreç, yardımcının standart girdisine komutlar gönderir ve sonuçları bekler
yardımcının standart çıktısından. Remote helper bağımsız bir süreç olarak çalıştığı için
Git'ten, yeni bir yardımcı eklemek için Git'i yeniden bağlamaya veya
Git'in uygulanmasında yardımcı.

Her yardımcı, Git'in neyin ne olduğunu belirlemek için kullandığı "yetenekler" komutunu desteklemelidir.
yardımcının kabul edeceği diğer komutlar. Bu diğer komutlar keşfetmek ve
uzak referansları güncelleyin, nesneleri nesne veritabanı ile uzak arasında taşıyın
deposu ve yerel nesne deposunu güncelleyin.

Git, çeşitli taşıma protokollerini yöneten bir "curl" uzak yardımcılar ailesiyle birlikte gelir.
gibi git-uzaktan-http, git-uzaktan-https, git-uzaktan-ftp ve git-uzaktan-ftps. Onlar
yetenekleri uygulamak almak, seçenek, ve itmek.

ÇAĞRI

Uzak yardımcı programlar, bir veya (isteğe bağlı olarak) iki bağımsız değişkenle çağrılır. İlk
argüman Git'teki gibi uzak bir depo belirtir; ya yapılandırılmış bir adıdır
uzak veya bir URL. İkinci argüman bir URL belirtir; genellikle formdadır
://, ancak herhangi bir isteğe bağlı dize mümkündür. NS GIT_DIR çevre
uzak yardımcı için değişken ayarlanır ve nerede saklanacağını belirlemek için kullanılabilir
ek veriler veya hangi dizinden yardımcı Git komutlarının çağrılacağı.

Git, formun bir URL'siyle karşılaştığında ://, Burada bir
yerel olarak işleyemediği protokol, otomatik olarak çağırır git uzak-
ikinci argüman olarak tam URL ile. Doğrudan bu tür bir URL ile karşılaşılırsa,
komut satırında, ilk argüman ikinciyle aynıdır ve bir
uzaktan yapılandırılmışsa, ilk bağımsız değişken o uzaktan kumandanın adıdır.

Formun bir URL'si :: Git'e açıkça çağırması talimatını verir git
uzak- ile ikinci argüman olarak. Böyle bir URL ile karşılaşılırsa
doğrudan komut satırında, ilk argüman , ve eğer karşılaşılırsa
yapılandırılmış bir uzaktan kumanda, ilk bağımsız değişken o uzaktan kumandanın adıdır.

Ek olarak, yapılandırılmış bir uzaktan kumanda uzak. .vcs ayarlandığında , git
açıkça çağırır git uzak- ile ilk argüman olarak. ayarlanırsa,
ikinci argüman uzak. .url; aksi takdirde, ikinci argüman atlanır.

GİRİŞ FORMAT

Git, uzak yardımcıya, her satırda bir tane olmak üzere standart girişte bir komut listesi gönderir. İlk
komut her zaman yetenekleri uzak yardımcının yanıt vermesi gereken komut
desteklediği yeteneklerin bir listesini (aşağıya bakın) ve ardından boş bir satır yazdırın. NS
yetenekler komutuna yanıt, Git'in geri kalanında hangi komutları kullanacağını belirler.
komut akışı.

Komut akışı boş bir satırla sonlandırılır. Bazı durumlarda (belirtilen
ilgili komutların dokümantasyonu), bu boş satırı bazılarında bir yük takip eder.
diğer protokoller (örneğin, paket protokolü), diğerlerinde ise girişin sonunu gösterir.

Uygulama Alanı
Her uzak yardımcının yalnızca bir komut alt kümesini desteklemesi beklenir. operasyonlar bir
yardımcı destekler, yetenekler komutuna yanıt olarak Git'e bildirilir (bkz.
KOMUTLAR, aşağıda).

Aşağıda, tanımlanmış tüm yetenekleri listeliyoruz ve her biri için hangi komutları bir araya getiriyoruz?
bu yeteneğe sahip yardımcı sağlamalıdır.

Uygulama Alanı için itme
bağlamak
bağlanmayı deneyebilir git alma paketi (itmek için), git yükleme paketi, vb için
git'in yerel paket dosyası protokolünü kullanarak iletişim. Bu, çift yönlü bir
tam çift yönlü bağlantı.

Desteklenen komutlar: bağlamak.

itmek
Uzak referansları keşfedebilir ve yerel taahhütleri ve bunlara giden geçmişi zorlayabilir
yeni veya mevcut uzak referanslara.

Desteklenen komutlar: liste itme için, itmek.

ihracat
Uzak referansları keşfedebilir ve belirtilen nesneleri hızlı içe aktarma akışından
uzak referanslar

Desteklenen komutlar: liste itme için, ihracat.

Bir yardımcı reklam verirse bağlamak, Git mümkünse onu kullanacak ve diğerine geri dönecek
yardımcı, bağlanırken isterse (bkz. bağlamak altında komut
KOMUTLAR). arasında seçim yaparken itmek ve ihracat, Git tercih ediyor itmek. Diğer ön uçlar
başka bir tercih sırasına sahip olabilir.

özel-güncelleme yok
Kullanıldığı zaman referans spesifikasyonu yeteneği, git normalde özel referansı günceller
başarılı itme. Bu güncelleme, uzaktan yardımcı tarafından bildirildiğinde devre dışı bırakılır.
kabiliyet özel-güncelleme yok.

Uygulama Alanı için Getiriliyor
bağlamak
bağlanmayı deneyebilir git yükleme paketi (almak için), git alma paketi, vb için
Git'in yerel paket dosyası protokolünü kullanarak iletişim. Bu bir gerektirir
çift ​​yönlü, tam çift yönlü bağlantı.

Desteklenen komutlar: bağlamak.

almak
Uzak referansları keşfedebilir ve onlardan erişilebilen nesneleri yerele aktarabilir
nesne deposu.

Desteklenen komutlar: liste, almak.

ithalat
Bir akış olarak onlardan erişilebilen uzak referansları ve çıktı nesnelerini keşfedebilir.
hızlı içe aktarma biçimi.

Desteklenen komutlar: liste, ithalat.

bağlantı kontrolü
Bir klon istendiğinde, alınan paketin kendi kendine yeteceğini garanti edebilir
ve bağlanır.

Bir yardımcı reklam verirse bağlamak, Git mümkünse onu kullanacak ve diğerine geri dönecek
yardımcı, bağlanırken isterse (bkz. bağlamak altında komut
KOMUTLAR). arasında seçim yaparken almak ve ithalat, Git tercih ediyor almak. Diğer ön uçlar
başka bir tercih sırasına sahip olabilir.

Diğer yetenekleri
seçenek
Ayrıntı (stderr'e ne kadar çıktı yazılacak) ve
derinliği (sığ bir klon durumunda ne kadar geçmiş isteniyor)
diğer komutlar yürütülür.

referans spesifikasyonu
uygulayan uzak yardımcılar için ithalat or ihracat, bu yetenek,
refs/heads veya
doğrudan referanslar/uzaktan kumandalar. sağlayan tüm ithalatçıların ithalat
yeteneği bunu kullanır. için zorunludur ihracat.

Yetenek refspec'in reklamını yapan bir yardımcı
refs/heads/*:refs/svn/Origin/branches/* içe aktarma istendiğinde bunu söylüyor
refs/heads/topic, çıktısı akışı güncelleyecektir
refs/svn/menşei/dallar/konu ref.

Bu yetenek birden çok kez tanıtılabilir. İlk uygulanabilir refspec
öncelik alır. Bu yetenekle reklamı yapılan refspec'lerin sol tarafı,
list komutu tarafından bildirilen tüm referansları kapsar. Eğer hayırsa referans spesifikasyonu yetenek
reklamı yapıldığında, zımni bir refspec *:* vardır.

Merkezi olmayan sürüm kontrol sistemleri için uzaktan yardımcılar yazarken,
ile etkileşime geçmek ve veri havuzunun yerel bir kopyasını saklamanız önerilir.
özel ad alanı başvuruları bu yerel depoya işaret ederken, başvurular/uzaktan kumandalar
uzak depoyu izlemek için ad alanı kullanılır.

bidi-ithalat
Bu, ithalat kabiliyet. Hızlı içe aktarma komutları kedi damlası ve ls yapabilmek
bloblar ve ağaçlar hakkında bilgi almak için uzaktan yardımcılar tarafından kullanılabilir.
hızlı içe aktarmanın belleğinde zaten var. Bu, hızlı içe aktarmadan
uzaktan yardımcı. "İçe aktarma"ya ek olarak tanıtılıyorsa, Git bir
hızlı içe aktarmadan uzak yardımcının stdin'ine boru. Git ve
hızlı içe aktarmanın her ikisi de uzaktan yardımcının stdin'ine bağlıdır. Çünkü Git gönderebilir
uzaktan yardımcıya birden çok komut, kullanan yardımcıların
bidi-ithalat hepsini tamponla ithalat veri göndermeden önce bir toplu işlemin komutları
hızlı ithalat. Bu, komutları karıştırmayı ve hızlı içe aktarma yanıtlarını
yardımcının stdin'i.

ihracat işaretleri
Bu, ihracat yeteneği, Git'e dahili işaretleri boşaltmasını söyleyen
tablo tamamlandığında. Ayrıntılar için, okumaya devam edin --ihracat-işaretleri= in
git-hızlı-dışa aktarma(1).

ithalat işaretleri
Bu, ihracat Git'e belirtilen işaretleri yüklemesini söyleyen yetenek
içinde Herhangi bir girişi işlemeden önce. Ayrıntılar için, okumaya devam edin
--import-marks= in git-hızlı-dışa aktarma(1).

imzalı etiketler
Bu, ihracat yetenek, Git'e geçmesi talimatını verir
--signed-tags=kelimesi kelimesine için git-hızlı-dışa aktarma(1). Bu yeteneğin yokluğunda,
Git kullanacak --signed-tags=uyarı şeridi.

KOMUTLAR

Komutlar, arayan tarafından, her satıra bir tane olmak üzere, yardımcının standart girişinde verilir.

yetenekleri
Her satırda bir tane olmak üzere yardımcının yeteneklerini boş bir satırla listeler. Her biri
yetenek önce gelebilir *, bu da onları Git sürümleri için zorunlu olarak işaretler.
anlamak için uzaktan yardımcı. Bilinmeyen herhangi bir zorunlu yetenek, ölümcül bir hatadır.

Bu komut için destek zorunludur.

liste
Referansları her satıra bir tane olacak şekilde "biçiminde listeler" [ ...]". Değer
bir onaltılık sha1 karma olabilir, "@ " bir symref için veya "?" yardımcı olduğunu belirtmek için
ref değerini alamadı. Boşlukla ayrılmış bir öznitelik listesi, aşağıdaki
isim; tanınmayan nitelikler yoksayılır. Liste boş bir satırla biter.

Halihazırda tanımlanmış niteliklerin bir listesi için REF LİSTESİ ÖZELLİKLERİ'ne bakın.

Yardımcının "getirme" veya "içe aktarma" özelliği varsa desteklenir.

liste itme için
Benzer liste, ancak ve sadece arayan kişi istiyorsa kullanılır.
push komutları hazırlamak için ortaya çıkan ref listesi. Hem itme hem de getirmeyi destekleyen bir yardımcı
çıktısının hangi işlem için olduğunu ayırt etmek için bunu kullanabilir. liste olacak
kullanılması, muhtemelen yapılması gereken iş miktarını azaltır.

Yardımcının "itme" veya "dışa aktarma" özelliği varsa desteklenir.

seçenek
Taşıma yardımcısı seçeneğini ayarlar ile . içeren tek bir satır çıktısı verir.
birini ok (seçenek başarıyla ayarlandı), desteklenmeyen (seçenek tanınmadı) veya hata
(seçenek destekleniyor ama için geçerli değildir). Seçenekler
diğer komutlardan önce ayarlanır ve bu komutların davranışını etkileyebilir.

Halihazırda tanımlanmış seçeneklerin listesi için SEÇENEKLER'e bakın.

Yardımcının "seçenek" özelliği varsa desteklenir.

almak
Gerekli nesneleri veritabanına yazarak verilen nesneyi getirir. Gidip getirmek
komutlar, satır başına bir tane olacak şekilde toplu olarak gönderilir ve boş bir satırla sonlandırılır. çıktılar bir
aynı toplu işteki tüm getirme komutları tamamlandığında tek boş satır. sadece nesneler
çıktısında rapor edilen liste sha1 ile bu şekilde alınabilir.

İsteğe bağlı olarak bir çıktı verebilir kilitlemek GIT_DIR/objects/pack altındaki bir dosyayı gösteren satır
referanslar uygun şekilde güncellenene kadar bir paket tutuyor.

Eğer seçenek bağlantı kontrolü istendiğinde, yardımcının çıktı alması gerekir bağlantı-tamam if
klon bağımsızdır ve bağlantılıdır.

Yardımcının "getirme" özelliği varsa desteklenir.

itmek + :
Verilen yereli iter tarafından açıklanan uzak şubeye taahhüt veya şube .
Bir veya daha fazla toplu iş dizisi itmek komutlar boş bir satırla sonlandırılır (eğer
itmek için yalnızca bir referans var, tek bir itmek komutun ardından bir boşluk
hat). Örneğin, aşağıdaki iki parti olacaktır: itmek, ilk soran
yerel referansı itmek için uzaktan yardımcı usta uzak referansa usta ve yerel KAFA
uzaktan kumandaya şube, ve ikincisi ref'e basmak istiyor foo başvurmak bar (zorunlu güncelleme
tarafından talep edilen +).

referansları/kafaları/ustayı itin:başvuruları/kafaları/ana
HEAD'i itin:başvurular/kafalar/dal
\n
+başvurular/başlıklar/başvurular:başvurular/başlar/çubuk'a basın
\n

Son protokolden sonra sıfır veya daha fazla protokol seçeneği girilebilir. itmek komutundan önce,
partinin boş satırı sonlandırıyor.

Push tamamlandığında, bir veya daha fazla çıktı verir ok or hata ? hatları
basılan her referansın başarısını veya başarısızlığını belirtmek için. Durum raporu çıktısı
boş satır ile sonlandırılır. Seçenek alanı C tarzı bir dizede alıntı yapılabilir
bir LF içeriyorsa.

Yardımcının "itme" özelliği varsa desteklenir.

ithalat
Adlandırılmış başvurunun geçerli değerini içe aktaran bir hızlı içe aktarma akışı üretir. Olabilir
ayrıca, geçmişi verimli bir şekilde oluşturmak için gerektiğinde diğer referansları içe aktarın. NS
komut dosyası, yardımcıya özel bir özel ad alanına yazar. Adlandırılmış başvurunun değeri
refspecs uygulanarak türetilen bu ad alanındaki bir konuma yazılmalıdır.
"refspec" yeteneğinden ref adına.

Yabancı bir sürüm oluşturma sistemiyle birlikte çalışabilirlik için özellikle yararlıdır.

Tıpkı itmek, bir veya daha fazla parti dizisi ithalat boşluk ile sonlandırılır
hat. Her parti için ithalat, uzak yardımcının hızlı içe aktarma akışı oluşturması gerekir
tarafından sonlandırıldı yapılmış Komut.

Dikkat edin, eğer bidi-ithalat yeteneği kullanıldığında, tam parti dizisinin olması gerekir
komutların karışmasını önlemek için hızlı içe aktarmaya veri göndermeye başlamadan önce arabelleğe alınır ve
yardımcının stdin'inde hızlı içe aktarma yanıtları.

Yardımcının "içe aktarma" özelliği varsa desteklenir.

ihracat
Uzak yardımcıya, sonraki herhangi bir girişin hızlı içe aktarma akışının bir parçası olduğunu bildirir
(oluşturan git hızlı ihracat) itilmesi gereken nesneleri içeren
uzaktan.

Yabancı bir sürüm oluşturma sistemiyle birlikte çalışabilirlik için özellikle yararlıdır.

The ihracat işaretleri ve ithalat işaretleri yetenekler, belirtilirse, bu komutu etkiler
aktarıldıkları sürece git hızlı ihracat, bu daha sonra bir tablo yükleyecek/saklayacak
yerel nesneler için işaretler. Bu, artımlı işlemler için uygulamak için kullanılabilir.

Yardımcının "dışa aktarma" özelliği varsa desteklenir.

bağlamak
Verilen hizmete bağlanır. Yardımcının standart girişi ve standart çıkışı bağlanır
belirtilen hizmete (git öneki hizmet adına dahil edilmiştir, bu nedenle örneğin getirme kullanımları
git-yükleme paketi hizmet olarak) uzak tarafta. Bu komuta verilen geçerli yanıtlar boş
hat (bağlantı kuruldu), geri çekil (akıllı ulaşım desteği yok, aptallığa geri dönün
aktarımlar) ve yalnızca yazdırılan hata mesajıyla çıkılıyor (bağlanamıyor, rahatsız etmeyin
geri çekilmeye çalışmak). Pozitif (boş) yanıtı sonlandıran satır beslemesinden sonra,
hizmet çıkışı başlar. Bağlantı sona erdikten sonra remote helper çıkar.

Yardımcının "bağlan" özelliği varsa desteklenir.

Önemli bir hata oluşursa, program hata mesajını stderr'e yazar ve çıkar. NS
arayan, çocuk kapanırsa uygun bir hata mesajının yazdırıldığını beklemelidir.
geçerli komut için geçerli bir yanıt tamamlamadan bağlantı.

tarafından bildirilen yeteneklerden belirlenebileceği gibi ek komutlar desteklenebilir.
yardımcı

REF LİSTESİ ÖZNİTELİKLERİ

The liste komutu, her bir referansın bir listesinin izlenebileceği bir referans listesi üretir.
Öznitellikler. Aşağıdaki başvuru listesi öznitelikleri tanımlanmıştır.

değişmemiş
Bu ref, son içe aktarma veya getirme işleminden bu yana değişmedi, ancak yardımcı bunu yapamıyor
mutlaka hangi değeri ürettiğini belirler.

SEÇENEKLER

Aşağıdaki seçenekler, aşağıdaki durumlarda Git tarafından tanımlanır ve (uygun koşullar altında) ayarlanır:
uzak yardımcı vardır seçenek kabiliyet.

seçenek lâf salatası
Yardımcı tarafından görüntülenen mesajların ayrıntı düzeyini değiştirir. için 0 değeri anlamına geliyor
süreçlerin sessiz çalıştığı ve yardımcının yalnızca hata çıktısı ürettiğidir. 1
varsayılan ayrıntı düzeyi ve daha yüksek değerler -v sayısına karşılık gelir
komut satırında geçirilen bayraklar.

seçenek ilerleme {gerçek|yanlış}
sırasında taşıma yardımcısı tarafından görüntülenen ilerleme mesajlarını etkinleştirir (veya devre dışı bırakır)
Komut.

seçenek derinlik
Sığ bir havuzun tarihini derinleştirir.

seçenek takip etiketleri {gerçek|yanlış}
Etkinleştirilirse, yardımcı, nesne varsa açıklamalı etiket nesnelerini otomatik olarak getirmelidir.
etiket noktaları, getirme komutu sırasında aktarıldı. Etiket getirilmezse
yardımcı tarafından genellikle etiketi istemek için ikinci bir getirme komutu gönderilir
özellikle. Bazı yardımcılar, ikinci bir ağdan kaçınmak için bu seçeneği kullanabilir.
bağ.

seçenek kuru çalışma {gerçek|yanlış}: Doğruysa, işlemin başarıyla tamamlandığını varsayın, ancak
aslında herhangi bir depo verisini değiştirmeyin. Çoğu yardımcı için bu yalnızca itmek,
desteklenirse.

seçenek hizmet yolu
Sonraki bağlantı için hizmet yolunu (--upload-pack, --receive-pack vb.) ayarlar. uzaktan yardımcı
bu seçeneği destekleyebilir, ancak bağlanmadan önce bu seçeneğin ayarlanmasına güvenmemelidir.
istek oluşur.

seçenek bağlantı kontrolü {gerçek|yanlış}
Yardımcıdan bir klonun bağlantısını kontrol etmesini isteyin.

seçenek anabolik etkileri de mevcuttur {gerçek|yanlış}
Yardımcıdan zorunlu güncelleme yapmasını isteyin. Varsayılan yanlış.

seçenek Klonlama {'NS|yanlış}
Yardımcıya bunun bir klon isteği olduğunu bildirin (yani mevcut depo garantilidir
boş).

seçenek güncelleme sığ {'NS|yanlış}
Yeni referanslar gerektiriyorsa .git/shallow uzantısına izin verin.

seçenek itme sertifikası {'NS|yanlış}
GPG işareti iter.

onworks.net hizmetlerini kullanarak gitremote-helpers'ı çevrimiçi kullanın