bup-get - salin item repositori (PERHATIAN: EKSPERIMENTAL)
bup get [-s source-path] [-r host:path] OPTIONS <(METHOD ref [dest])>...
bup dapatkan salinan ref yang ditunjukkan dari repositori sumber ke repositori tujuan (menghormati --bup-dir dan BUP_DIR), menurut METODE yang ditentukan, yang mungkin salah satu dari --ff, --ff:, --append, --append:, --pick, --pick:, --force-pick, --force-pick:, --new-tag, --new-tag:, --replace, --replace:, atau --unnamed. Lihat CONTOH di bawah ini untuk pengenalan cepat.
ref adalah referensi repositori sumber dari objek yang akan diambil, dan dest adalah referensi tujuan opsional. A dest hanya dapat ditentukan untuk METODE yang namanya diakhiri dengan titik dua. Misalnya:
bup get -s /source/repo --ff foo
bup get -s /source/repo --ff: foo/latest bar
bup get -s /source/repo --pick: foo/2010-10-10-101010 .tag/barSebagai kasus khusus, jika ref menamai symlink penyimpanan “terbaru ”, maka bup akan bertindak persis seolah-olah penyimpanan yang ditunjuk oleh “terbaru ” telah ditentukan, daripada symlink “terbaru ” itu sendiri, jadi bup get foo/latest sebenarnya akan diartikan sebagai sesuatu seperti bup get foo/2013-01-01-030405.
Dalam beberapa situasi bup get akan mengevaluasi operasi cabang sesuai dengan apakah itu akan menjadi "maju cepat" atau tidak (yang mengharuskan setiap cabang tujuan yang ada menjadi nenek moyang dari sumber).
Tag tujuan yang sudah ada hanya dapat ditimpa dengan --replace atau --force-pick.
Ketika komit baru dibuat (yaitu melalui --append, --pick, dll.), itu akan memiliki penulis, tanggal penulis, dan pesan yang sama seperti aslinya, tetapi tanggal pengalih dan pengalih sesuai dengan pengguna dan waktu saat ini .
Jika diminta oleh opsi yang sesuai, bup akan mencetak hash komit, pohon, atau tag untuk setiap referensi tujuan yang diperbarui. Jika relevan, hash pohon akan dicetak sebelum hash komit.
ref lokal dapat didorong ke repositori jarak jauh dengan opsi --remote, dan ref jarak jauh dapat ditarik ke repositori lokal melalui “bup on HOST get ... ”. Lihat bup-on(1) dan CONTOH di bawah untuk informasi lebih lanjut.
PERINGATAN: Ini adalah salah satu dari sedikit perintah bup yang dapat mengubah arsip Anda dengan cara yang sengaja merusak. Meskipun jika upaya untuk bergabung atau memulihkan data yang Anda pedulikan berhasil setelah Anda menjalankan perintah ini, maka itu adalah tanda yang cukup menggembirakan bahwa itu berfungsi dengan benar. (Perintah dev/compare-trees di pohon sumber dapat digunakan untuk membantu menguji sebelum/setelah hasil.)
maju cepat dest agar cocok dengan ref. Jika dest tidak ditentukan dan ref memberi nama penyimpanan, setel dest ke cabang penyimpanan. Jika dest tidak ditentukan dan ref menamai cabang atau tag, gunakan nama yang sama untuk dest.
tambahkan semua komit yang diwakili oleh ref ke dest sebagai komit baru. Jika ref memberi nama direktori/pohon, tambahkan komit baru untuk pohon itu. Jika dest tidak ditentukan dan ref memberi nama simpanan atau cabang, setel dest ke nama cabang ref. Jika dest tidak ditentukan dan ref memberi nama tag, gunakan nama yang sama untuk dest.
tambahkan komit tunggal yang dinamai oleh ref ke dest sebagai komit baru. Jika dest tidak ditentukan dan ref memberi nama penyimpanan, setel dest ke nama cabang ref. Jika dest tidak ditentukan dan ref memberi nama tag, gunakan nama yang sama untuk dest.
lakukan hal yang sama seperti --pick, tetapi jangan menolak untuk menimpa tag yang sudah ada.
buat tag dest untuk ref, tetapi tolak untuk menimpa tag yang sudah ada. Jika dest tidak ditentukan dan ref memberi nama tag, gunakan nama yang sama untuk dest.
clobber dest dengan ref, menimpa tag yang ada, atau mengganti cabang yang ada. Jika dest tidak ditentukan dan ref memberi nama cabang atau tag, gunakan nama yang sama untuk dest.
salin ref ke repositori tujuan, tanpa nama apa pun, meninggalkan referensi yang berpotensi menjuntai sampai/kecuali objek yang dinamai oleh ref dirujuk ke cara lain (lih. tag bup).
gunakan path sebagai repositori sumber, bukan default.
simpan item yang ditunjukkan di server jauh yang diberikan. Jika jalur dihilangkan, gunakan jalur default di server jarak jauh (Anda masih harus menyertakan `:'). Koneksi ke server jarak jauh dilakukan dengan SSH. Jika Anda ingin menentukan port, pengguna, atau kunci pribadi mana yang akan digunakan untuk koneksi SSH, kami sarankan Anda menggunakan file ~/.ssh/config.
untuk setiap cabang yang diperbarui, cetak id komit git yang baru.
untuk setiap cabang yang diperbarui, cetak id git tree baru dari root sistem file.
untuk setiap tag yang diperbarui, cetak id git baru.
meningkatkan verbositas (dapat digunakan lebih dari sekali). Dengan -v, cetak nama setiap item yang diambil, dengan -vv tambahkan nama direktori, dan dengan -vvv tambahkan setiap nama file.
jangan mengirimkan lebih dari byte/detik byte per detik ke server. Ini dapat membantu menghindari menyedot semua bandwidth jaringan Anda. Gunakan akhiran seperti k, M, atau G untuk menentukan kelipatan masing-masing 1024, 1024*1024, 1024*1024*1024.
atur level kompresi ke # (nilai dari 0-9, di mana 9 adalah yang tertinggi dan 0 adalah tanpa kompresi). Standarnya adalah 1 (kompresi cepat dan longgar)
Perbarui atau salin cabang arsip di src-repo ke repositori lokal:
bup get -s src-repo --ff archivesTambahkan penyimpanan arsip tertentu ke cabang pruned-archives:
bup get -s src-repo --pick: archives/2013-01-01-030405 pruned-archivesPerbarui atau salin cabang arsip di remotehost ke repositori lokal:
bup on remotehost get --ff archivesPerbarui atau salin arsip cabang lokal ke remotehost:
bup get -r remotehost: --ff archivesPerbarui atau salin cabang arsip di src-repo ke remotehost:
bup get -s src-repo -r remotehost: --ff archivesPerbarui cabang arsip-2 di remotehost agar sesuai dengan arsip. Jika arsip-2 ada dan bukan leluhur dari arsip, bup akan menolak:
bup get -r remotehost: --ff: archives archives-2Ganti isi cabang y dengan yang dari x:
bup get --replace: x ySalin penyimpanan lokal terbaru dari cabang arsip ke tag jarak jauh foo:
bup get -r remotehost: --pick: archives/latest .tag/fooAtau jika foo sudah ada:
bup get -r remotehost: --force-pick: archives/latest .tag/fooTambahkan foo (dari atas) ke cabang arsip lain lokal:
bup on remotehost get --append: .tag/foo other-archivesTambahkan hanya direktori /home dari arsip/terbaru ke only-home:
bup get -s "$BUP_DIR" --append: archives/latest/home only-homebup-on(1), bup-tag(1), ssh_config(5)
Bagian dari paket bup(1).
Rob Browning