bup-get - başvuru kılavuzu, seçenekler, komut örnekleri

İSİM

bup-get - depo öğelerini kopyalayın (DİKKAT: DENEYSEL)

ÖZET

bup get [-s source-path] [-r host:path] OPTIONS <(METHOD ref [dest])>...

TANIM

bup get belirtilen refleri kaynak depodan hedef depoya kopyalar (-bup-dir ve BUP_DIR'e uygun olarak), belirtilen METHOD'a göre --ff, -- ff:, --append, --append:, --pick, --pick:, --force-pick, --force-pick:, --new-tag, --new-tag:, --replace , --replace: veya --unnamed. Hızlı bir giriş için aşağıdaki ÖRNEKLER'e bakın.

ref, getirilecek nesnenin kaynak havuz referansıdır ve dest, isteğe bağlı hedef referansıdır. Bir hedef, yalnızca adı iki nokta üst üste ile biten bir YÖNTEM için belirtilebilir. Örneğin:

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/bar

Özel bir durum olarak, eğer ref "en son" kaydetme sembolik bağlantısını adlandırırsa, bup "en son" sembolik bağlantının kendisi yerine tam olarak "en son" işaret ettiği kaydetme belirtilmiş gibi davranacaktır, bu nedenle bup get foo/latest aslında bup get foo/2013-01-01-030405 gibi bir şey olarak yorumlanacaktır.

Bazı durumlarda bup get, bir dal işlemini "hızlı ileri" olup olmayacağına göre değerlendirir (bu, mevcut herhangi bir hedef dalın kaynağın atası olmasını gerektirir).

Mevcut bir hedef etiketinin üzerine yalnızca bir --replace veya --force-pick yazılabilir.

Yeni bir taahhüt oluşturulduğunda (yani --append, --pick vb. yoluyla), orijinaliyle aynı yazara, yazar tarihine ve mesaja sahip olacak, ancak geçerli kullanıcı ve saate karşılık gelen bir gönderen ve gönderen tarihi olacaktır. .

Uygun seçenekler tarafından istenirse, bup, güncellenen her hedef referansı için kesinleştirme, ağaç veya etiket karmasını yazdıracaktır. İlgili olduğunda, ağaç karması kesinleştirme karmasından önce yazdırılacaktır.

Yerel ref'ler --remote seçeneğiyle uzak bir havuza gönderilebilir ve uzak ref'ler “bup on HOST get .. . ”. Daha fazla bilgi için bup-on(1)'e ve aşağıdaki ÖRNEKLER'e bakın.

UYARI: Bu, arşivlerinizi kasıtlı olarak yıkıcı şekillerde değiştirebilen birkaç bup komutundan biridir. Yine de, bu komutu çalıştırdıktan sonra hâlâ önemsediğiniz verileri birleştirme veya geri yükleme girişimi başarılı olursa, bu, düzgün çalıştığına dair oldukça cesaret verici bir işarettir. (Kaynak ağacındaki dev/compare-trees komutu, sonuçlardan önce/sonra test etmeye yardımcı olmak için kullanılabilir.)

YÖNTEMLER

--ff ref, --ff: ref dest: hedef öğesini başvuru ile eşleşecek şekilde hızlı ileri sarın. hedef belirtilmemişse ve ref bir kaydetmeyi adlandırıyorsa, dest öğesini kaydetmenin dalına ayarlayın. hedef belirtilmemişse ve ref bir dalı veya etiketi adlandırıyorsa, dest için aynı adı kullanın.
--append ref, --append: ref dest: ref tarafından temsil edilen tüm taahhütleri yeni taahhütler olarak dest'e ekleyin. ref bir dizini/ağacı adlandırırsa, o ağaç için yeni bir işlem ekleyin. hedef belirtilmemişse ve ref bir kayıt veya dalı adlandırıyorsa, dest öğesini ref dal adı olarak ayarlayın. dest belirtilmemişse ve ref bir etiketi adlandırıyorsa, dest için aynı adı kullanın.
--pick ref, --pick: ref dest: ref tarafından adlandırılan tek taahhüdü yeni bir taahhüt olarak dest'e ekleyin. dest belirtilmemişse ve ref bir kaydı adlandırıyorsa, dest öğesini ref dal adına ayarlayın. dest belirtilmemişse ve ref bir etiketi adlandırıyorsa, dest için aynı adı kullanın.
--force-pick ref, --force-pick: ref dest: --pick ile aynı şeyi yapın, ancak mevcut bir etiketin üzerine yazmayı reddetmeyin.
--new-tag ref, --new-tag: ref dest: ref için bir dest etiketi oluşturun, ancak mevcut bir etiketin üzerine yazmayı reddedin. dest belirtilmemişse ve ref bir etiketi adlandırıyorsa, dest için aynı adı kullanın.
--replace ref, --replace: ref dest: dest'i ref ile gizleyin, mevcut herhangi bir etiketin üzerine yazın veya mevcut herhangi bir dalı değiştirin. dest belirtilmemişse ve ref bir dalı veya etiketi adlandırıyorsa, dest için aynı adı kullanın.
--unnamed ref: ref öğesini herhangi bir ad olmadan hedef depoya kopyalayın ve ref tarafından adlandırılan nesne başka bir şekilde anılana kadar potansiyel olarak sarkan bir referans bırakın (cf. bup etiketi).

SEÇENEKLER

-s, --source=path: kaynak deposu olarak varsayılan yerine yol'u kullanın.
-r, --remote=host:path: belirtilen öğeleri verilen uzak sunucuda saklayın. yol atlanırsa, uzak sunucudaki varsayılan yolu kullanır (':' karakterini yine de eklemeniz gerekir). Uzak sunucuya bağlantı SSH ile yapılır. SSH bağlantısı için hangi bağlantı noktası, kullanıcı veya özel anahtarın kullanılacağını belirtmek isterseniz ~/.ssh/config dosyasını kullanmanızı öneririz.
-c, --print-commits: güncellenen her şube için yeni git taahhüt kimliğini yazdırın.
-t, --print-trees: güncellenen her dal için, dosya sistemi kökünün yeni git ağacı kimliğini yazdırın.
--print-tags: güncellenen her etiket için yeni git kimliğini yazdırın.
-v, --verbose: ayrıntıyı artırın (birden fazla kullanılabilir). -v ile getirilen her öğenin adını yazdırın, -vv ile dizin adlarını ekleyin ve -vvv ile her dosya adını ekleyin.
--bwlimit=bytes/sec: sunucuya saniyede bayt/sn bayttan fazlasını iletmeyin. Bu, tüm ağ bant genişliğinizi emmekten kaçınmanıza yardımcı olabilir. Sırasıyla 1024, 1024*1024, 1024*1024*1024'ün katlarını belirtmek için k, M veya G gibi bir sonek kullanın.
-#, --compress=#: sıkıştırma seviyesini # olarak ayarlayın (0-9 arasında bir değer, burada 9 en yüksek ve 0 sıkıştırma yok). Varsayılan 1'dir (hızlı, gevşek sıkıştırma)

ÖRNEKLER

src-repo'daki arşiv şubesini yerel depoya güncelleyin veya kopyalayın:

bup get -s src-repo --ff archives

Pruned-archives dalına belirli bir arşiv kaydı ekleyin:

bup get -s src-repo --pick: archives/2013-01-01-030405 pruned-archives

Remotehost'taki arşiv şubesini güncelleyin veya yerel depoya kopyalayın:

bup on remotehost get --ff archives

Yerel şube arşivlerini uzak ana bilgisayara güncelleyin veya kopyalayın:

bup get -r remotehost: --ff archives

src-repo'daki arşiv şubesini uzak ana bilgisayara güncelleyin veya kopyalayın:

bup get -s src-repo -r remotehost: --ff archives

Arşivleri eşleştirmek için remotehost'takiarchives-2 dalını güncelleyin. Eğer arşivler-2 mevcutsa ve arşivlerin atası değilse, bup şunları reddeder:

bup get -r remotehost: --ff: archives archives-2

y şubesinin içeriğini x'inkilerle değiştirin:

bup get --replace: x y

En son yerel kaydı arşiv dalından uzaktaki foo etiketine kopyalayın:

bup get -r remotehost: --pick: archives/latest .tag/foo

Veya foo zaten varsa:

bup get -r remotehost: --force-pick: archives/latest .tag/foo

Foo'yu (yukarıdan) yerel diğer arşiv dalına ekleyin:

bup on remotehost get --append: .tag/foo other-archives

archives/latest'ten only-home'a yalnızca /home dizinini ekleyin:

bup get -s "$BUP_DIR" --append: archives/latest/home only-home

AYRICA BAKINIZ

bup-on(1), bup-tag(1), ssh_config(5)

BÜP

bup(1) paketinin bir parçası.

YAZARLAR

Rob Browning .