gittremote-helpers - Online di Cloud

PROGRAM:

NAMA

gitremote-helpers - Program pembantu untuk berinteraksi dengan repositori jarak jauh

RINGKASAN

git terpencil- [ ]

DESKRIPSI

Program pembantu jarak jauh biasanya tidak digunakan secara langsung oleh pengguna akhir, tetapi mereka dipanggil
oleh Git ketika perlu berinteraksi dengan repositori jarak jauh Git tidak mendukung secara asli. A
pembantu yang diberikan akan mengimplementasikan subset dari kemampuan yang didokumentasikan di sini. Ketika Git membutuhkan
untuk berinteraksi dengan repositori menggunakan pembantu jarak jauh, itu memunculkan pembantu sebagai
proses independen, mengirimkan perintah ke input standar helper, dan mengharapkan hasil
dari keluaran standar helper. Karena pembantu jarak jauh berjalan sebagai proses independen
dari Git, tidak perlu menautkan ulang Git untuk menambahkan pembantu baru, juga tidak perlu menautkan
pembantu dengan implementasi Git.

Setiap helper harus mendukung perintah "capabilities", yang digunakan Git untuk menentukan apa
perintah lain yang akan diterima oleh helper. Perintah-perintah lain itu dapat digunakan untuk menemukan dan
perbarui referensi jarak jauh, angkut objek antara database objek dan remote
repositori, dan perbarui toko objek lokal.

Git hadir dengan keluarga "curl" dari remote helper, yang menangani berbagai protokol transport,
seperti git-jarak jauh-http, git-jarak jauh-https, git-jarak jauh-ftp dan git-jarak jauh-ftps. Mereka
mengimplementasikan kemampuan mengambil, Option, dan mendorong.

DOA

Program pembantu jarak jauh dipanggil dengan satu atau (opsional) dua argumen. Pertama
argumen menentukan repositori jarak jauh seperti di Git; itu adalah nama yang dikonfigurasi
jauh atau URL. Argumen kedua menentukan URL; biasanya berbentuk
://, tetapi string arbitrer apa pun dimungkinkan. NS GIT_DIR lingkungan Hidup
variabel diatur untuk pembantu jarak jauh dan dapat digunakan untuk menentukan tempat menyimpan
data tambahan atau dari direktori mana untuk menjalankan perintah Git tambahan.

Ketika Git menemukan URL formulir ://, Di mana adalah
protokol yang tidak dapat ditangani secara asli, secara otomatis dipanggil git terpencil-
dengan URL lengkap sebagai argumen kedua. Jika URL seperti itu ditemukan langsung di
baris perintah, argumen pertama sama dengan yang kedua, dan jika ditemui di a
dikonfigurasi remote, argumen pertama adalah nama remote itu.

URL formulir :: secara eksplisit menginstruksikan Git untuk memanggil git
terpencil- dengan sebagai argumen kedua. Jika URL seperti itu ditemukan
langsung di baris perintah, argumen pertama adalah , dan jika ditemui di
remote yang dikonfigurasi, argumen pertama adalah nama remote itu.

Selain itu, ketika remote yang dikonfigurasi memiliki terpencil. .vcs mulai , Git
secara eksplisit memanggil git terpencil- dengan sebagai argumen pertama. Jika diatur,
argumen kedua adalah terpencil. .url; jika tidak, argumen kedua dihilangkan.

INPUT FORMAT

Git mengirimkan helper jarak jauh daftar perintah pada input standar, satu per baris. Pertama
perintah selalu kemampuan perintah, sebagai tanggapan yang harus dilakukan oleh pembantu jarak jauh
cetak daftar kemampuan yang didukungnya (lihat di bawah) diikuti dengan baris kosong. NS
respons terhadap perintah kemampuan menentukan perintah apa yang digunakan Git di sisa
aliran perintah.

Aliran perintah diakhiri dengan baris kosong. Dalam beberapa kasus (ditunjukkan dalam
dokumentasi perintah yang relevan), baris kosong ini diikuti oleh muatan di beberapa
protokol lain (misalnya, protokol paket), sementara yang lain menunjukkan akhir input.

Kemampuan
Setiap pembantu jarak jauh diharapkan hanya mendukung sebagian perintah. Operasi
dukungan helper dideklarasikan ke Git sebagai respons terhadap perintah kemampuan (lihat
PERINTAH, di bawah).

Berikut ini, kami mencantumkan semua kemampuan yang ditentukan dan untuk masing-masing kami mencantumkan perintah mana yang a
pembantu dengan kemampuan itu harus menyediakan.

Kemampuan untuk Mendorong
menghubungkan
Dapat mencoba untuk terhubung ke git terima-paket (untuk mendorong), git unggah-paket, dll untuk
komunikasi menggunakan protokol paket file asli git. Hal ini membutuhkan dua arah,
koneksi dupleks penuh.

Perintah yang didukung: menghubungkan.

mendorong
Dapat menemukan referensi jarak jauh dan mendorong komitmen lokal dan riwayat yang mengarah ke sana
ke referensi jarak jauh baru atau yang sudah ada.

Perintah yang didukung: daftar untuk-dorong, mendorong.

ekspor
Dapat menemukan referensi jarak jauh dan mendorong objek tertentu dari aliran impor cepat ke
referensi jarak jauh.

Perintah yang didukung: daftar untuk-dorong, ekspor.

Jika seorang pembantu mengiklankan menghubungkan, Git akan menggunakannya jika memungkinkan dan kembali ke yang lain
kemampuan jika pembantu meminta demikian saat menghubungkan (lihat menghubungkan perintah di bawah
PERINTAH). Saat memilih antara mendorong dan ekspor, Git lebih suka mendorong. Frontend lainnya
mungkin memiliki beberapa urutan preferensi lainnya.

tidak ada pembaruan pribadi
Saat menggunakan spesifikasi referensi kemampuan, git biasanya memperbarui referensi pribadi pada
sukses mendorong. Pembaruan ini dinonaktifkan ketika remote-helper menyatakan
kemampuan tidak ada pembaruan pribadi.

Kemampuan untuk Mengambil
menghubungkan
Dapat mencoba terhubung ke git unggah-paket (untuk pengambilan), git terima-paket, dll untuk
komunikasi menggunakan protokol paket file asli Git. Ini membutuhkan
koneksi dua arah, full-duplex.

Perintah yang didukung: menghubungkan.

mengambil
Dapat menemukan referensi jarak jauh dan mentransfer objek yang dapat dijangkau dari mereka ke lokal
toko objek.

Perintah yang didukung: daftar, mengambil.

mengimpor
Dapat menemukan referensi jarak jauh dan objek keluaran yang dapat dijangkau darinya sebagai aliran masuk
format impor cepat.

Perintah yang didukung: daftar, mengimpor.

periksa konektivitas
Dapat menjamin bahwa ketika klon diminta, paket yang diterima berisi sendiri
dan terhubung.

Jika seorang pembantu mengiklankan menghubungkan, Git akan menggunakannya jika memungkinkan dan kembali ke yang lain
kemampuan jika pembantu meminta demikian saat menghubungkan (lihat menghubungkan perintah di bawah
PERINTAH). Saat memilih antara mengambil dan mengimpor, Git lebih suka mengambil. Frontend lainnya
mungkin memiliki beberapa urutan preferensi lainnya.

bermacam-macam kemampuan
Option
Untuk menentukan pengaturan seperti verbositas (berapa banyak output yang akan ditulis ke stderr) dan
kedalaman (berapa banyak sejarah yang diinginkan dalam kasus klon dangkal) yang mempengaruhi bagaimana
perintah lain dijalankan.

spesifikasi referensi
Untuk pembantu jarak jauh yang menerapkan mengimpor or ekspor, kemampuan ini memungkinkan
referensi dibatasi ke ruang nama pribadi, alih-alih menulis ke referensi/kepala atau
ref/remote secara langsung. Disarankan agar semua importir menyediakan mengimpor
kemampuan menggunakan ini. Wajib untuk ekspor.

Seorang pembantu yang mengiklankan refspec kemampuan
refs/heads/*:refs/svn/Origin/branchs/* mengatakan bahwa, ketika diminta untuk mengimpor
ref/heads/topic, aliran yang dihasilkannya akan memperbarui
ref/svn/asal/cabang/topik ref.

Kemampuan ini dapat diiklankan beberapa kali. Refspec pertama yang berlaku
diutamakan. Bagian kiri dari refspec yang diiklankan dengan kemampuan ini harus
mencakup semua referensi yang dilaporkan oleh perintah daftar. Jika tidak spesifikasi referensi kemampuan adalah
diiklankan, ada refspec tersirat *:*.

Saat menulis remote-helper untuk sistem kontrol versi terdesentralisasi, itu adalah
disarankan untuk menyimpan salinan lokal repositori untuk berinteraksi, dan membiarkan
referensi namespace pribadi menunjuk ke repositori lokal ini, sedangkan referensi/remote
namespace digunakan untuk melacak repositori jarak jauh.

bidi-impor
Ini memodifikasi mengimpor kemampuan. Perintah impor cepat kucing-gumpalan dan ls bisa
digunakan oleh remote-helper untuk mengambil informasi tentang gumpalan dan pohon yang
sudah ada di memori fast-import. Ini membutuhkan saluran dari impor cepat ke
pembantu jarak jauh. Jika diiklankan selain "impor", Git menetapkan
pipa dari impor cepat ke stdin. Oleh karena itu, Git dan
fast-import keduanya terhubung ke stdin. Karena Git dapat mengirim
beberapa perintah ke remote-helper diperlukan helper yang menggunakan
bidi-impor penyangga semua mengimpor perintah batch sebelum mengirim data ke
cepat-impor. Ini untuk mencegah pencampuran perintah dan respons impor cepat di
stdin pembantu.

tanda ekspor
Ini memodifikasi ekspor kapabilitas, menginstruksikan Git untuk membuang tanda internal
meja untuk ketika selesai. Untuk detailnya, baca di --ekspor-tanda= in
git-fast-ekspor(1).

tanda impor
Ini memodifikasi ekspor kemampuan, menginstruksikan Git untuk memuat tanda yang ditentukan
di dalam sebelum memproses input apa pun. Untuk detailnya, baca di
--impor-tanda= in git-fast-ekspor(1).

tanda-tanda
Ini memodifikasi ekspor kemampuan, menginstruksikan Git untuk lulus
--signed-tags=kata demi kata untuk git-fast-ekspor(1). Dengan tidak adanya kemampuan ini,
Git akan menggunakan --signed-tags=peringatan-strip.

PERINTAH

Perintah diberikan oleh pemanggil pada input standar helper, satu per baris.

kemampuan
Daftar kemampuan pembantu, satu per baris, diakhiri dengan baris kosong. Setiap
kemampuan dapat didahului dengan *, yang menandai mereka wajib untuk versi Git menggunakan
pembantu jarak jauh untuk memahami. Kemampuan wajib yang tidak diketahui adalah kesalahan fatal.

Dukungan untuk perintah ini adalah wajib.

daftar
Daftar referensi, satu per baris, dalam format " [ ...]". Nilai
mungkin hash hex sha1, "@ " untuk symref, atau "?" untuk menunjukkan bahwa helper
tidak bisa mendapatkan nilai dari ref. Daftar atribut yang dipisahkan oleh spasi mengikuti
nama; atribut yang tidak dikenal diabaikan. Daftar berakhir dengan baris kosong.

Lihat REF LIST ATTRIBUTES untuk daftar atribut yang saat ini ditentukan.

Didukung jika helper memiliki kemampuan "fetch" atau "import".

daftar untuk-dorong
Mirip dengan daftar, kecuali digunakan jika dan hanya jika penelepon ingin
daftar ref yang dihasilkan untuk menyiapkan perintah push. Seorang pembantu yang mendukung push dan fetch
dapat menggunakan ini untuk membedakan untuk operasi mana output dari daftar akan menjadi
digunakan, mungkin mengurangi jumlah pekerjaan yang perlu dilakukan.

Didukung jika helper memiliki kemampuan "push" atau "ekspor".

Option
Menyetel opsi pembantu transportasi ke . Menghasilkan satu baris yang berisi
salah satu ok (opsi berhasil disetel), tidak didukung (opsi tidak dikenali) atau kesalahan
(pilihan didukung tetapi tidak sah untuk itu). Pilihan seharusnya
diatur sebelum perintah lain, dan dapat mempengaruhi perilaku perintah tersebut.

Lihat OPSI untuk daftar opsi yang ditentukan saat ini.

Didukung jika penolong memiliki kemampuan "opsi".

mengambil
Mengambil objek yang diberikan, menulis objek yang diperlukan ke database. Mengambil
perintah dikirim dalam batch, satu per baris, diakhiri dengan baris kosong. Keluaran
satu baris kosong ketika semua perintah pengambilan dalam batch yang sama selesai. Hanya benda
yang dilaporkan dalam output dari daftar dengan sha1 dapat diambil dengan cara ini.

Secara opsional dapat menghasilkan a mengunci baris yang menunjukkan file di bawah GIT_DIR/objects/pack
yang menyimpan paket hingga referensi dapat diperbarui dengan tepat.

Jika pilihan periksa konektivitas diminta, helper harus mengeluarkan konektivitas-ok if
klon itu mandiri dan terhubung.

Didukung jika penolong memiliki kemampuan "mengambil".

mendorong + :
Mendorong lokal yang diberikan komit atau cabang ke cabang jarak jauh yang dijelaskan oleh .
Urutan batch dari satu atau lebih mendorong perintah diakhiri dengan baris kosong (jika
hanya ada satu referensi untuk mendorong, satu mendorong perintah diikuti dengan tanda kosong
garis). Misalnya, berikut ini akan menjadi dua kumpulan mendorong, yang pertama bertanya
remote-helper untuk mendorong referensi lokal menguasai ke referensi jarak jauh menguasai dan lokal KEPALA
ke remote cabang, dan yang kedua meminta untuk mendorong ref foo untuk ref bar (pembaruan paksa
diminta oleh +).

push ref/heads/master:refs/heads/master
dorong KEPALA: ref/kepala/cabang
\n
tekan +refs/heads/foo:refs/heads/bar
\n

Nol atau lebih opsi protokol dapat dimasukkan setelah yang terakhir mendorong perintah, sebelum
baris kosong penghentian batch.

Saat push selesai, output satu atau lebih ok or kesalahan ? baris
untuk menunjukkan keberhasilan atau kegagalan setiap ref yang didorong. Keluaran laporan status adalah
diakhiri dengan baris kosong. bidang pilihan dapat dikutip dalam string gaya C
jika mengandung LF.

Didukung jika helper memiliki kemampuan "push".

mengimpor
Menghasilkan aliran impor cepat yang mengimpor nilai saat ini dari referensi bernama. Mungkin
tambahan impor referensi lain yang diperlukan untuk membangun sejarah secara efisien. NS
skrip menulis ke namespace pribadi khusus pembantu. Nilai dari referensi bernama
harus ditulis ke lokasi di namespace ini yang diturunkan dengan menerapkan refspecs
dari kemampuan "refspec" hingga nama referensi.

Sangat berguna untuk interoperabilitas dengan sistem versi asing.

Sama seperti mendorong, urutan batch dari satu atau lebih mengimpor diakhiri dengan blanko
garis. Untuk setiap batch mengimpor, pembantu jarak jauh harus menghasilkan aliran impor cepat
diakhiri oleh dilakukan perintah.

Perhatikan bahwa jika bidi-impor kapabilitas digunakan urutan batch lengkap harus
buffer sebelum mulai mengirim data ke impor cepat untuk mencegah pencampuran perintah dan
tanggapan impor cepat pada stdin pembantu.

Didukung jika helper memiliki kemampuan "impor".

ekspor
Menginstruksikan helper jarak jauh bahwa setiap input berikutnya adalah bagian dari aliran impor cepat
(dihasilkan oleh git ekspor cepat) berisi objek yang harus didorong ke
terpencil.

Sangat berguna untuk interoperabilitas dengan sistem versi asing.

tanda ekspor dan tanda impor kemampuan, jika ditentukan, mempengaruhi perintah ini di
sejauh mereka diteruskan ke git ekspor cepat, yang kemudian akan memuat/menyimpan tabel
tanda untuk objek lokal. Ini dapat digunakan untuk mengimplementasikan operasi inkremental.

Didukung jika helper memiliki kemampuan "ekspor".

menghubungkan
Terhubung ke layanan yang diberikan. Input standar dan output standar pembantu terhubung
ke layanan yang ditentukan (awalan git disertakan dalam nama layanan jadi misalnya mengambil kegunaan
git-upload-paket sebagai layanan) di sisi remote. Balasan yang valid untuk perintah ini kosong
garis (koneksi dibuat), mundur (tidak ada dukungan transportasi pintar, kembali menjadi bodoh
transports) dan baru saja keluar dengan pesan kesalahan tercetak (tidak dapat terhubung, jangan repot-repot
mencoba untuk mundur). Setelah umpan baris mengakhiri respons positif (kosong),
keluaran layanan dimulai. Setelah koneksi berakhir, pembantu jarak jauh keluar.

Didukung jika helper memiliki kemampuan "connect".

Jika terjadi kesalahan fatal, program menulis pesan kesalahan ke stderr dan keluar. NS
penelepon harus mengharapkan bahwa pesan kesalahan yang sesuai telah dicetak jika anak menutup
koneksi tanpa menyelesaikan respons yang valid untuk perintah saat ini.

Perintah tambahan mungkin didukung, seperti yang dapat ditentukan dari kemampuan yang dilaporkan oleh
pembantu.

REF DAFTAR ATRIBUT

daftar perintah menghasilkan daftar referensi di mana setiap referensi dapat diikuti oleh daftar
atribut. Atribut daftar ref berikut didefinisikan.

tanpa perubahan
Ref ini tidak berubah sejak impor atau pengambilan terakhir, meskipun helper tidak bisa
tentu menentukan nilai apa yang dihasilkan.

PILIHAN

Opsi berikut ditentukan dan (dalam keadaan yang sesuai) ditetapkan oleh Git jika:
pembantu jarak jauh memiliki Option kemampuan.

Option kata kerja
Mengubah verbositas pesan yang ditampilkan oleh helper. Nilai 0 untuk cara
bahwa proses beroperasi dengan tenang, dan helper hanya menghasilkan keluaran kesalahan. 1 adalah
tingkat verbositas default, dan nilai yang lebih tinggi sesuai dengan jumlah -v
bendera diteruskan pada baris perintah.

Option kemajuan {benar|palsu}
Mengaktifkan (atau menonaktifkan) pesan kemajuan yang ditampilkan oleh pembantu transportasi selama a
perintah.

Option kedalaman
Memperdalam sejarah repositori dangkal.

Option mengikuti tag {benar|palsu}
Jika diaktifkan, helper akan secara otomatis mengambil objek tag beranotasi jika objek tersebut
titik tag di ditransfer selama perintah ambil. Jika tag tidak diambil
oleh helper perintah pengambilan kedua biasanya akan dikirim untuk meminta tag
secara khusus. Beberapa helper mungkin dapat menggunakan opsi ini untuk menghindari jaringan kedua
koneksi.

Option lari kering {benar|palsu}: Jika benar, berpura-pura operasi selesai dengan sukses, tapi
tidak benar-benar mengubah data repositori apa pun. Untuk sebagian besar pembantu, ini hanya berlaku untuk mendorong,
jika didukung.

Option jalur servis
Menetapkan jalur layanan (--upload-pack, --receive-pack dll.) untuk koneksi berikutnya. Pembantu jarak jauh
dapat mendukung opsi ini, tetapi tidak boleh bergantung pada opsi ini yang disetel sebelum terhubung
permintaan terjadi.

Option periksa konektivitas {benar|palsu}
Minta helper untuk memeriksa konektivitas klon.

Option kekuatan {benar|palsu}
Minta helper untuk melakukan pembaruan paksa. Default untuk palsu.

Option kloning {'benar|palsu}
Beri tahu helper bahwa ini adalah permintaan klon (yaitu repositori saat ini dijamin
kosong).

Option update-dangkal {'benar|palsu}
Izinkan untuk memperpanjang .git/shallow jika referensi baru memerlukannya.

Option sertifikat dorong {'benar|palsu}
Tanda GPG mendorong.

Gunakan gitremote-helper online menggunakan layanan onworks.net