bup-get - hướng dẫn tham khảo, tùy chọn, ví dụ về lệnh

---

TÊN

bup-get - sao chép các mục kho lưu trữ (THẬN TRỌNG: THỬ NGHIỆM)

TÓM TẮT

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

SỰ MIÊU TẢ

bup get sao chép các ref được chỉ định từ kho lưu trữ nguồn sang kho lưu trữ đích (tôn trọng --bup-dir và BUP_DIR), theo PHƯƠNG PHÁP đã chỉ định, có thể là một trong --ff, --ff:, --append, --append:, --pick, --pick:, --force-pick, --force-pick:, --new-tag, --new-tag:, --replace, --replace: hoặc --unnamed. Xem VÍ DỤ bên dưới để biết phần giới thiệu nhanh.

ref là tham chiếu kho lưu trữ nguồn của đối tượng được tìm nạp và dest là tham chiếu đích tùy chọn. Chỉ có thể chỉ định dest cho PHƯƠNG PHÁP có tên kết thúc bằng dấu hai chấm. Ví dụ:

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

Trong trường hợp đặc biệt, nếu ref đặt tên cho liên kết tượng trưng lưu “mới nhất ”, thì bup sẽ hoạt động chính xác như thể lưu mà “latest ” trỏ tới đã được chỉ định, chứ không phải bản thân liên kết tượng trưng “latest”, do đó, bup get foo/latest sẽ thực sự được hiểu là một cái gì đó giống như bup get foo/2013-01-01-030405.

Trong một số trường hợp, bup get sẽ đánh giá hoạt động của một nhánh tùy theo việc nó có phải là "chuyển tiếp nhanh" hay không (điều này yêu cầu bất kỳ nhánh đích hiện có nào phải là tổ tiên của nguồn).

Chỉ có thể ghi đè thẻ đích hiện tại bằng --replace hoặc --force-pick.

Khi một cam kết mới được tạo (tức là thông qua --append, --pick, v.v.), nó sẽ có cùng tác giả, ngày tác giả và thông báo như ban đầu, nhưng ngày của người gửi và người gửi tương ứng với người dùng và thời gian hiện tại.

Nếu được yêu cầu bởi các tùy chọn thích hợp, bup sẽ in mã băm cam kết, cây hoặc thẻ cho mỗi tham chiếu đích được cập nhật. Khi có liên quan, hàm băm cây sẽ được in trước hàm băm cam kết.

Các ref cục bộ có thể được đẩy vào một kho lưu trữ từ xa bằng tùy chọn --remote và các ref từ xa có thể được kéo vào một kho lưu trữ cục bộ thông qua “bup on HOST get…”. Xem bup-on(1) và VÍ DỤ bên dưới để biết thêm thông tin.

CẢNH BÁO: Đây là một trong số ít các lệnh bup có thể sửa đổi kho lưu trữ của bạn theo những cách phá hoại có chủ ý. Mặc dù nếu nỗ lực nối hoặc khôi phục dữ liệu mà bạn vẫn quan tâm thành công sau khi bạn chạy lệnh này, thì đó là một dấu hiệu khá đáng khích lệ rằng nó hoạt động chính xác. (Lệnh dev/so sánh cây trong cây nguồn có thể được sử dụng để giúp kiểm tra kết quả trước/sau.)

PHƯƠNG PHÁP

--ff ref, --ff: ref dest

tua nhanh dest để khớp với ref. Nếu dest không được chỉ định và ref đặt tên cho lưu, hãy đặt dest thành nhánh của lưu. Nếu dest không được chỉ định và ref đặt tên cho nhánh hoặc thẻ, hãy sử dụng cùng một tên cho dest.

--append ref, --append: ref dest

nối tất cả các lần xác nhận được đại diện bởi ref vào dest dưới dạng các lần xác nhận mới. Nếu ref đặt tên cho một thư mục/cây, hãy thêm một cam kết mới cho cây đó. Nếu dest không được chỉ định và ref đặt tên cho lưu hoặc nhánh, hãy đặt dest thành tên nhánh ref. Nếu dest không được chỉ định và ref đặt tên cho thẻ, hãy sử dụng cùng một tên cho dest.

--pick ref, --pick: ref dest

nối một lần xác nhận duy nhất được đặt tên bởi ref vào dest dưới dạng một lần xác nhận mới. Nếu dest không được chỉ định và ref đặt tên lưu, hãy đặt dest thành tên nhánh ref. Nếu dest không được chỉ định và ref đặt tên cho thẻ, hãy sử dụng cùng một tên cho dest.

--force-pick ref, --force-pick: ref dest

làm điều tương tự như --pick, nhưng đừng từ chối ghi đè lên một thẻ hiện có.

--new-tag ref, --new-tag: ref dest

tạo thẻ dest cho ref, nhưng từ chối ghi đè thẻ hiện có. Nếu dest không được chỉ định và ref đặt tên cho thẻ, hãy sử dụng cùng một tên cho dest.

--replace ref, --replace: ref dest

ghi đè dest bằng ref, ghi đè bất kỳ thẻ hiện có nào hoặc thay thế bất kỳ nhánh hiện có nào. Nếu dest không được chỉ định và ref đặt tên cho nhánh hoặc thẻ, hãy sử dụng cùng một tên cho dest.

--unnamed ref

sao chép ref vào kho lưu trữ đích, không có bất kỳ tên nào, để lại một tham chiếu có khả năng bị treo cho đến khi/trừ khi đối tượng được đặt tên bởi ref được tham chiếu theo một số cách khác (xem thẻ bup) .

TÙY CHỌN

-s, --source=path

sử dụng đường dẫn làm kho lưu trữ nguồn, thay vì mặc định.

-r, --remote=host:path

lưu trữ các mục được chỉ định trên máy chủ từ xa đã cho. Nếu đường dẫn bị bỏ qua, hãy sử dụng đường dẫn mặc định trên máy chủ từ xa (bạn vẫn cần bao gồm `:'). Kết nối đến máy chủ từ xa được thực hiện bằng SSH. Nếu bạn muốn chỉ định cổng, người dùng hoặc khóa riêng nào sẽ sử dụng cho kết nối SSH, chúng tôi khuyên bạn nên sử dụng tệp ~/.ssh/config.

-c, --print-commits

đối với mỗi nhánh được cập nhật, hãy in id cam kết git mới.

-t, --print-trees

đối với mỗi nhánh được cập nhật, hãy in id cây git mới của thư mục gốc của hệ thống tệp.

--print-tags

đối với mỗi thẻ được cập nhật, hãy in id git mới.

-v, --verbose

tăng độ chi tiết (có thể được sử dụng nhiều lần). Với -v, in tên của mọi mục được tìm nạp, với -vv thêm tên thư mục và với -vvv thêm mọi tên tệp.

--bwlimit=bytes/sec

không truyền nhiều hơn byte/giây byte mỗi giây tới máy chủ. Điều này có thể giúp tránh hút hết băng thông mạng của bạn. Sử dụng hậu tố như k, M hoặc G để chỉ định bội số của 1024, 1024*1024, 1024*1024*1024 tương ứng.

-#, --compress=#

đặt mức nén thành # (giá trị từ 0-9, trong đó 9 là mức cao nhất và 0 là không nén). Mặc định là 1 (nén nhanh, lỏng lẻo)

VÍ DỤ

Cập nhật hoặc sao chép nhánh lưu trữ trong src-repo vào kho lưu trữ cục bộ:

bup get -s src-repo --ff archives

Nối thêm một lưu trữ lưu trữ cụ thể vào nhánh lưu trữ đã cắt tỉa:

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

Cập nhật hoặc sao chép nhánh lưu trữ trên máy chủ lưu trữ từ xa vào kho lưu trữ cục bộ:

bup on remotehost get --ff archives

Cập nhật hoặc sao chép kho lưu trữ nhánh cục bộ sang máy chủ từ xa:

bup get -r remotehost: --ff archives

Cập nhật hoặc sao chép nhánh lưu trữ trong src-repo sang remotehost:

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

Cập nhật nhánh archives-2 trên máy chủ từ xa để khớp với archives. Nếu archives-2 tồn tại và không phải là tổ tiên của archives, bụp sẽ từ chối:

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

Thay thế nội dung của nhánh y bằng x:

bup get --replace: x y

Sao chép bản lưu cục bộ mới nhất từ nhánh lưu trữ sang thẻ từ xa foo:

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

Hoặc nếu foo đã tồn tại:

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

Nối foo (từ trên) vào nhánh lưu trữ khác cục bộ:

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

Chỉ nối thêm thư mục/home từ archives/latest vào only-home:

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

XEM THÊM

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

BÚP

Một phần của bộ bup(1).

TÁC GIẢ

Rob Browning .