bup-get - skopiuj elementy repozytorium (UWAGA: EKSPERYMENTALNE)
bup get [-s source-path] [-r host:path] OPTIONS <(METHOD ref [dest])>...
bup get kopiuje wskazane ref z repozytorium źródłowego do repozytorium docelowego (respektując --bup-dir i BUP_DIR), zgodnie z określoną METODĄ, która może być jedną z --ff, -- ff:, --append, --append:, --pick, --pick:, --force-pick, --force-pick:, --new-tag, --new-tag:, --replace , --replace: lub --unnamed. Zobacz PRZYKŁADY poniżej, aby uzyskać szybkie wprowadzenie.
ref to odwołanie do repozytorium źródłowego obiektu do pobrania, a dest to opcjonalne odwołanie do miejsca docelowego. cel można określić tylko dla METOD, której nazwa kończy się dwukropkiem. Na przykład:
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/barW szczególnym przypadku, jeśli ref nazwie dowiązanie symboliczne „najnowszego” zapisu, to bup będzie działać dokładnie tak, jakby określony został zapis, na który wskazuje „najnowszy”, a nie samo „najnowsze” dowiązanie symboliczne, więc bup get foo/latest będzie faktycznie interpretowane jako coś w rodzaju bup get foo/2013-01-01-030405.
W niektórych sytuacjach bup get oceni operację rozgałęzienia w zależności od tego, czy będzie to „szybkie przewijanie do przodu” (co wymaga, aby każda istniejąca gałąź docelowa była przodkiem źródła).
Istniejący znacznik miejsca docelowego można zastąpić tylko opcją --replace lub --force-pick.
Kiedy tworzone jest nowe zatwierdzenie (np. przez --append, --pick itp.), będzie ono miało tego samego autora, datę autora i wiadomość, co oryginał, ale datę osoby zatwierdzającej i osoby zatwierdzającej odpowiadające bieżącemu użytkownikowi i czasowi .
Jeśli zażądają tego odpowiednie opcje, bup wypisze hash zatwierdzenia, drzewa lub znacznika dla każdego zaktualizowanego odniesienia do miejsca docelowego. W stosownych przypadkach skrót drzewa zostanie wydrukowany przed skrótem zatwierdzenia.
Lokalne ref można przesłać do zdalnego repozytorium za pomocą opcji --remote, a zdalne ref można pobrać do lokalnego repozytorium za pomocą „bup on HOST get .. . ”. Zobacz bup-on(1) i PRZYKŁADY poniżej, aby uzyskać więcej informacji.
OSTRZEŻENIE: Jest to jedno z niewielu poleceń bup, które mogą modyfikować twoje archiwa w celowo destrukcyjny sposób. Chociaż jeśli próba dołączenia lub przywrócenia danych, na których nadal Ci zależy, powiedzie się po uruchomieniu tego polecenia, to jest to dość zachęcający znak, że działało poprawnie. (Polecenie dev/compare-trees w drzewie źródłowym może być użyte do testowania wyników przed/po).
przewiń do przodu cel, aby dopasować ref. Jeśli dest nie jest określone, a ref nazywa zapis, ustaw dest na gałąź zapisu. Jeśli cel nie jest określony, a ref nazywa gałąź lub znacznik, użyj tej samej nazwy dla cel.
dołącz wszystkie rewizje reprezentowane przez ref do dest jako nowe rewizje. Jeśli ref nazywa katalog/drzewo, dołącz nowe zatwierdzenie dla tego drzewa. Jeśli dest nie jest podane, a ref nazywa zapis lub gałąź, ustaw dest na nazwę gałęzi ref. Jeśli dest nie jest określone, a ref nazywa tag, użyj tej samej nazwy dla dest.
dołącz pojedyncze zatwierdzenie o nazwie ref do dest jako nowe zatwierdzenie. Jeśli dest nie jest określone, a ref nazywa zapis, ustaw dest na nazwę gałęzi ref. Jeśli dest nie jest określone, a ref nazywa tag, użyj tej samej nazwy dla dest.
zrób to samo, co --pick, ale nie odmawiaj nadpisania istniejącego tagu.
utwórz tag dest dla ref, ale odmów zastąpienia istniejącego tagu. Jeśli dest nie jest określone, a ref nazywa tag, użyj tej samej nazwy dla dest.
clobber dest za pomocą ref, nadpisując istniejący tag lub zastępując istniejącą gałąź. Jeśli dest nie jest określone, a ref nazywa gałąź lub znacznik, użyj tej samej nazwy dla dest.
skopiuj ref do repozytorium docelowego, bez żadnej nazwy, pozostawiając potencjalnie zawieszoną referencję, dopóki/chyba, że obiekt nazwany przez ref zostanie przywołany w inny sposób (por. tag bup) .
użyj ścieżki jako repozytorium źródłowego zamiast domyślnego.
przechowywania wskazanych pozycji na danym serwerze zdalnym. Jeśli ścieżka zostanie pominięta, używa domyślnej ścieżki na zdalnym serwerze (nadal musisz dołączyć `:'). Połączenie ze zdalnym serwerem odbywa się za pomocą SSH. Jeśli chcesz określić, którego portu, użytkownika lub klucza prywatnego użyć do połączenia SSH, zalecamy użycie pliku ~/.ssh/config.
dla każdej zaktualizowanej gałęzi wydrukuj nowy identyfikator zatwierdzenia git.
dla każdej zaktualizowanej gałęzi wypisz nowy identyfikator drzewa git katalogu głównego systemu plików.
dla każdego zaktualizowanego tagu wydrukuj nowy identyfikator git.
zwiększyć gadatliwość (można użyć więcej niż jeden raz). Z -v wypisz nazwę każdego pobranego elementu, z -vv dodaj nazwy katalogów, a z -vvv dodaj każdą nazwę pliku.
nie przesyłaj do serwera więcej niż bajtów/s bajtów na sekundę. Może to pomóc uniknąć zasysania całej przepustowości sieci. Użyj sufiksu, takiego jak k, M lub G, aby określić wielokrotności odpowiednio 1024, 1024*1024, 1024*1024*1024.
ustaw poziom kompresji na # (wartość od 0 do 9, gdzie 9 to najwyższy poziom, a 0 to brak kompresji). Wartość domyślna to 1 (szybka, luźna kompresja)
Zaktualizuj lub skopiuj gałąź archiwów w src-repo do lokalnego repozytorium:
bup get -s src-repo --ff archivesDołącz określone archiwa do gałęzi pruned-archives:
bup get -s src-repo --pick: archives/2013-01-01-030405 pruned-archivesZaktualizuj lub skopiuj gałąź archiwów na zdalnym hoście do lokalnego repozytorium:
bup on remotehost get --ff archivesZaktualizuj lub skopiuj lokalne archiwa oddziałów na zdalny host:
bup get -r remotehost: --ff archivesZaktualizuj lub skopiuj gałąź archiwów w src-repo do zdalnego hosta:
bup get -s src-repo -r remotehost: --ff archivesZaktualizuj gałąź archives-2 na zdalnym hoście, aby pasowała do archiwów. Jeśli Archives-2 istnieje i nie jest przodkiem archiwów, bup odmówi:
bup get -r remotehost: --ff: archives archives-2Zamień zawartość gałęzi y na zawartość x:
bup get --replace: x ySkopiuj najnowszy lokalny zapis z gałęzi archiwum do zdalnego znacznika foo:
bup get -r remotehost: --pick: archives/latest .tag/fooLub jeśli foo już istnieje:
bup get -r remotehost: --force-pick: archives/latest .tag/fooDołącz foo (z góry) do lokalnej gałęzi other-archives:
bup on remotehost get --append: .tag/foo other-archivesDołącz tylko katalog /home z archives/latest do only-home:
bup get -s "$BUP_DIR" --append: archives/latest/home only-homebup-on(1), bup-tag(1), ssh_config(5)
Część pakietu bu(1).
Rob Browning