borgbackup - Dalam talian di Awan

JADUAL:

NAMA

borg - BorgBackup ialah program sandaran penyahduplikasi dengan pemampatan pilihan dan
penyulitan yang disahkan.

Borg terdiri daripada beberapa arahan. Setiap arahan menerima beberapa hujah dan
pilihan. Bahagian berikut akan menerangkan setiap arahan secara terperinci.

UMUM

Jenis of log output
Tahap log konfigurasi pengelogan terbina dalam lalai kepada AMARAN. Ini adalah kerana
kami mahu Borg kebanyakannya senyap dan hanya mengeluarkan amaran, ralat dan mesej kritikal.

Tahap log: DEBUG < INFO < AMARAN < RALAT < KRITIKAL

Penggunaan --nyahpepijat untuk menetapkan tahap log DEBUG - untuk mendapatkan nyahpepijat, maklumat, amaran, ralat dan tahap kritikal
output.

Penggunaan --maklumat (Atau -v or --verbose) untuk menetapkan tahap log INFO - untuk mendapatkan maklumat, amaran, ralat dan
keluaran tahap kritikal.

Penggunaan --amaran (lalai) untuk menetapkan tahap log AMARAN - untuk mendapatkan amaran, ralat dan kritikal
keluaran tahap.

Penggunaan --kesilapan untuk menetapkan tahap log ERROR - untuk mendapatkan ralat dan output tahap kritikal.

Penggunaan --kritikal untuk menetapkan tahap log KRITIKAL - untuk mendapatkan output tahap kritikal.

Walaupun anda boleh menetapkan misc. tahap log, jangan mengharapkan bahawa setiap arahan akan memberikan yang berbeza
output pada tahap log yang berbeza - ia hanya satu kemungkinan.

AMARAN :
Pilihan --kritikal dan --ralat disediakan untuk kesempurnaan, penggunaannya tidak
disyorkan kerana anda mungkin terlepas maklumat penting.

AMARAN :
Walaupun beberapa pilihan (seperti --statistik or --senarai) akan mengeluarkan lebih banyak mesej maklumat, anda
perlu menggunakan tahap log INFO (atau lebih rendah) untuk memaparkannya dalam output log. guna -v atau
konfigurasi pembalakan.

Pulangkan kod
Borg boleh keluar dengan kod pemulangan berikut (rc):

0 = kejayaan (dilog sebagai INFO)
1 = amaran (operasi mencapai penghujung biasa, tetapi terdapat amaran -
anda harus menyemak log, dilog sebagai AMARAN)
2 = ralat (seperti ralat maut, pengecualian tempatan atau jauh, operasi
tidak mencapai penghujung biasa, dilog sebagai ERROR)
128+N = dibunuh oleh isyarat N (cth 137 == bunuh -9)

Jika anda menggunakan --tunjukkan-rc, kod pulangan juga dilog pada tahap yang dinyatakan sebagai yang terakhir
kemasukan log.

alam Sekitar Pembolehubah
Borg menggunakan beberapa pembolehubah persekitaran untuk automasi:

Umum:

BORG_REPO
Apabila ditetapkan, gunakan nilai untuk memberikan lokasi repositori lalai. Sekiranya
arahan memerlukan parameter arkib, anda boleh menyingkat sebagai :: arkib. Sekiranya
arahan memerlukan parameter repositori, anda boleh sama ada meninggalkannya atau
ringkaskan sebagai ::, jika parameter kedudukan diperlukan.

BORG_PASSPHRASE
Apabila ditetapkan, gunakan nilai untuk menjawab soalan frasa laluan untuk disulitkan
repositori.

BORG_DISPLAY_PASSPHRASE
Apabila ditetapkan, gunakan nilai untuk menjawab "paparkan frasa laluan untuk
pengesahan" soalan semasa mentakrifkan frasa laluan baharu untuk disulitkan
repositori.

BORG_LOGGING_CONF
Apabila ditetapkan, gunakan nama fail yang diberikan sebagai Inikonfigurasi pengelogan gaya.

BORG_RSH
Apabila ditetapkan, gunakan arahan ini dan bukannya ssh. Ini boleh digunakan untuk menentukan ssh
pilihan, seperti fail identiti tersuai ssh -i /path/to/private/key. Lihat lelaki
ssh untuk pilihan lain.

TMPDIR di mana fail sementara disimpan (mungkin memerlukan banyak ruang sementara untuk
beberapa operasi)

Sesetengah automatik penjawab (jika menetapkan, mereka secara automatik jawab pengesahan soalan):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=tidak (Atau =ya)
Untuk "Amaran: Percubaan untuk mengakses yang tidak diketahui sebelum ini tidak disulitkan
repositori"

BORG_RELOCATED_REPO_ACCESS_IS_OK=tidak (Atau =ya)
Untuk "Amaran: Repositori di lokasi ... sebelum ini terletak di ..."

BORG_SEMAK_SAYA_TAHU_APA_SAYA_AM_BUAT=TIDAK (Atau =YA)
Untuk "Amaran: 'check --repair' ialah ciri percubaan yang mungkin terhasil
dalam kehilangan data."

BORG_DELETE_SAYA_TAHU_APA_SAYA_AM_BUAT=TIDAK (Atau =YA)
Untuk "Anda meminta untuk MEMADAM sepenuhnya repositori termasuk semua
arkib yang mengandungi:"

Nota: jawapan adalah sensitif huruf besar-besaran. menetapkan nilai jawapan yang tidak sah mungkin sama ada memberi
jawapan lalai atau tanya anda secara interaktif, bergantung pada sama ada percubaan semula
dibenarkan (mereka secara lalai dibenarkan). Jadi sila uji skrip anda secara interaktif
sebelum menjadikannya skrip bukan interaktif.

Direktori:

BORG_KEYS_DIR
Lalai kepada '~/.config/borg/keys'. Direktori ini mengandungi kunci untuk disulitkan
repositori.

BORG_CACHE_DIR
Lalai kepada '~/.cache/borg'. Direktori ini mengandungi cache tempatan dan
mungkin memerlukan banyak ruang untuk berurusan dengan repositori besar).

bangunan:

BORG_OPENSSL_PREFIX
Menambah direktori fail pengepala OpenSSL yang diberikan ke lokasi lalai
(setup.py).

BORG_LZ4_PREFIX
Menambah direktori fail pengepala LZ4 yang diberikan ke lokasi lalai (setup.py).

Sila ambil perhatian:

· berhati-hati apabila menggunakan kata "ya", amaran dengan segera wujud untuk / anda
keselamatan/keselamatan data anda

· juga berhati-hati apabila meletakkan frasa laluan anda ke dalam skrip, pastikan ia ada
kebenaran fail yang sesuai (cth mod 600, root:root).

Sumber Penggunaan
Borg mungkin menggunakan banyak sumber bergantung pada saiz set data yang ditanganinya
dengan.

CPU: Ia tidak akan melebihi 100% daripada 1 teras kerana kod pada masa ini adalah satu benang.
Terutamanya tahap mampatan zlib dan lzma yang lebih tinggi menggunakan sejumlah besar CPU
kitaran.

Memori (RAM):
Indeks ketulan dan indeks fail dibaca ke dalam ingatan atas sebab prestasi.
Mampatan, esp. Mampatan lzma dengan tahap tinggi mungkin memerlukan jumlah yang banyak
ingatan.

Sementara fail:
Membaca data dan metadata daripada repositori yang dipasang FUSE akan menggunakan kira-kira
ruang yang sama dengan ketulan pendua yang digunakan untuk mewakilinya dalam repositori.

Cache fail:
Mengandungi indeks ketulan dan indeks fail (ditambah koleksi termampat
indeks ketulan arkib tunggal).

Ketulan indeks:
Berkadar dengan jumlah ketulan data dalam repo anda. Banyak ketulan dalam repo anda
membayangkan indeks ketulan besar. Ia adalah mungkin untuk mengubah suai params chunker (lihat create
pilihan).

Fail indeks:
Berkadar dengan jumlah fail dalam sandaran terakhir anda. Boleh dimatikan (lihat
buat pilihan), tetapi sandaran seterusnya akan menjadi lebih perlahan jika anda melakukannya.

Rangkaian:
Jika repositori anda jauh, semua dinyahduplikasi (dan secara pilihan dimampatkan/
disulitkan) data sudah tentu perlu melalui sambungan (ssh: repo url). Jika awak
gunakan sistem fail rangkaian yang dipasang secara tempatan, selain itu beberapa operasi penyalinan digunakan
untuk sokongan transaksi juga pergi ke atas sambungan. Jika anda membuat sandaran berbilang sumber
kepada satu repositori sasaran, trafik tambahan berlaku untuk penyegerakan semula cache.

Sekiranya anda berminat untuk mendapatkan butiran lanjut, sila baca dokumentasi dalaman.

Unit
Untuk memaparkan kuantiti, Borg mengambil berat untuk menghormati konvensyen skala biasa. Cakera
saiz dipaparkan dalam Perpuluhan, menggunakan kuasa sepuluh (jadi kB bermakna 1000 bait). Untuk ingatan
penggunaan, perduaan awalan digunakan, dan ditunjukkan menggunakan IEC perduaan awalan, Dengan menggunakan
kuasa dua (jadi KiB bermakna 1024 bait).

Tarikh and Masa
Kami memformat tarikh dan masa mengikut ISO-8601, iaitu: YYYY-MM-DD dan HH:MM:SS (24j
jam).

Untuk maklumat lanjut tentang itu, lihat: https://xkcd.com/1179/

Melainkan dinyatakan sebaliknya, kami memaparkan tarikh dan masa setempat. Secara dalaman, kami menyimpan dan memproses
tarikh dan masa sebagai UTC.

BORG INIT

penggunaan: borg init [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-e {none,keyfile,repokey}]
[REPOSITORI]

Mulakan repositori kosong

hujah kedudukan:
REPOSITORY repositori untuk mencipta

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
-e {none,keyfile,repokey}, --encryption {none,keyfile,repokey}
pilih mod kunci penyulitan (lalai: "repokey")

Penerangan Produk
Perintah ini memulakan repositori kosong. Repositori ialah direktori sistem fail
mengandungi data pendua daripada sifar atau lebih arkib. Penyulitan boleh didayakan di
masa init repositori.

Contoh
# Repositori tempatan (lalai ialah menggunakan penyulitan dalam mod repokey)
$ borg init /path/to/repo

# Repositori tempatan (tiada penyulitan)
$ borg init --encryption=none /path/to/repo

# Repositori jauh (mengakses borg jauh melalui ssh)
$ borg init pengguna@nama hos:sandaran

# Repositori jauh (simpan kunci dir rumah anda)
$ borg init --encryption=pengguna fail utama@nama hos:sandaran

Nota penting tentang penyulitan:

Ia tidak disyorkan untuk melumpuhkan penyulitan. Penyulitan repositori melindungi anda cth
terhadap kes bahawa penyerang mempunyai akses kepada repositori sandaran anda.

Tetapi berhati-hati dengan kunci / frasa laluan:

Jika anda mahukan keselamatan "frasa laluan sahaja", gunakan repokey mod. Kunci akan disimpan
di dalam repositori (dalam fail "config"). Dalam senario serangan yang disebutkan di atas, the
penyerang akan mempunyai kunci (tetapi bukan frasa laluan).

Jika anda mahukan keselamatan "frasa laluan dan mempunyai kunci", gunakan fail kunci mod. Kuncinya akan
disimpan dalam direktori rumah anda (dalam .config/borg/keys). Dalam senario serangan,
penyerang yang baru sahaja mengakses repo anda tidak akan mempunyai kunci (dan juga bukan
frasa laluan).

Buat salinan sandaran fail kunci (fail kunci mod) atau fail konfigurasi repo (repokey mod) dan
simpan di tempat yang selamat, jadi anda masih mempunyai kunci sekiranya ia rosak atau hilang. Juga
simpan frasa laluan di tempat yang selamat. Sandaran yang disulitkan dengan kunci itu tidak akan
membantu anda dengan itu, sudah tentu.

Pastikan anda menggunakan frasa laluan yang baik. Tidak terlalu pendek, tidak terlalu mudah. Penyulitan sebenar /
kunci penyahsulitan disulitkan dengan / dikunci oleh frasa laluan anda. Jika penyerang mendapat anda
kunci, dia tidak boleh membuka kunci dan menggunakannya tanpa mengetahui frasa laluan.

Berhati-hati dengan aksara khas atau bukan ascii dalam frasa laluan anda:

· Borg memproses frasa laluan sebagai unicode (dan mengekodnya sebagai utf-8), jadi ia tidak mempunyai
masalah berurusan dengan watak yang paling pelik.

· TETAPI: itu tidak semestinya terpakai pada konfigurasi OS / VM / papan kekunci anda.

Jadi lebih baik gunakan frasa laluan panjang yang dibuat daripada aksara ascii yang mudah daripada yang termasuk
bahan bukan ascii atau aksara yang sukar/tidak mungkin dimasukkan pada papan kekunci yang berbeza
susun atur.

Anda boleh menukar frasa laluan anda untuk repo sedia ada pada bila-bila masa, ia tidak akan menjejaskan fail
kunci penyulitan/penyahsulitan atau rahsia lain.

BORG CREATE

penggunaan: borg buat [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [-s] [-p] [--senarai]
[--filter STATUSCHARS] [-e CORAK]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--exclude-if-present FILENAME] [--keep-tag-files]
[-c SECONDS] [-x] [--numeric-owner]
[--cap masa yyyy-mm-ddThh:mm:ss]
[--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESSION] [--read-istimewa] [-n]
LALUAN ARKIB [LALUAN ...]

Buat arkib baharu

hujah kedudukan:
ARKIB nama arkib untuk dibuat (mesti juga arkib yang sah
nama direktori)
Laluan PATH ke arkib

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
-s, --stats mencetak statistik untuk arkib yang dibuat
-p, --progress menunjukkan paparan kemajuan semasa mencipta arkib,
menunjukkan saiz Asal, Mampat dan Nyahduplikasi,
diikuti dengan Bilangan fail yang dilihat dan laluan
sedang diproses, lalai: False
--list output verbose senarai item (fail, dirs, ...)
--filter STATUSHARS hanya memaparkan item dengan aksara status yang diberikan
-e CORAK, --kecualikan CORAK
kecualikan laluan padanan CORAK
--kecualikan-daripada EXCLUDEFILE
baca mengecualikan corak daripada EXCLUDEFILE, satu setiap baris
--exclude-caches mengecualikan direktori yang mengandungi fail CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-jika-hadir FILENAME
kecualikan direktori yang mengandungi fail yang ditentukan
--keep-tag-files menyimpan fail tag daripada cache/direktori yang dikecualikan
-c SECONDS, --checkpoint-interval SECONDS
tulis pusat pemeriksaan setiap SECONDS saat (Lalai: 300)
-x, --satu-sistem-fail
kekal dalam sistem fail yang sama, jangan silang titik pelekap
--numeric-owner hanya menyimpan pengecam pengguna berangka dan kumpulan
--cap masa yyyy-mm-ddThh:mm:ss
secara manual menentukan tarikh/masa penciptaan arkib (UTC).
sebagai alternatif, berikan fail/direktori rujukan.
--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
nyatakan parameter chunker. lalai: 19,23,21,4095
--ignore-inode abaikan data inode dalam cache metadata fail yang digunakan
mengesan fail yang tidak berubah.
-C COMPRESSION, --COMPRESSION COMPRESSION
pilih algoritma mampatan (dan tahap): tiada == tidak
mampatan (lalai), lz4 == lz4, zlib == zlib
(tahap lalai 6), zlib,0 .. zlib,9 == zlib (dengan
tahap 0..9), lzma == lzma (tahap lalai 6), lzma,0 ..
lzma,9 == lzma (dengan tahap 0..9).
--read-special buka dan baca fail khas seolah-olah ia biasa
fail
-n, --dry-run jangan buat arkib sandaran

Penerangan Produk
Perintah ini mencipta arkib sandaran yang mengandungi semua fail yang ditemui semasa secara rekursif
melalui semua laluan yang ditentukan. Arkib akan menggunakan hampir tiada ruang cakera untuk fail atau
bahagian fail yang telah disimpan dalam arkib lain.

Untuk mempercepatkan menarik sandaran ke atas sshfs dan sistem fail rangkaian serupa yang tidak
berikan maklumat inode yang betul bendera --ignore-inode boleh digunakan. Ini berpotensi
mengurangkan kebolehpercayaan pengesanan perubahan, sambil mengelakkan sentiasa membaca semua fail dihidupkan
sistem fail ini.

Lihat output perintah "borg help patterns" untuk mendapatkan bantuan lanjut tentang mengecualikan corak.

Contoh
# Sandaran ~/Dokumen ke dalam arkib bernama "dokumen saya"
$ borg buat /path/to/repo::my-documents ~/Dokumen

# sama, tetapi senaraikan semua fail secara lisan semasa kami memprosesnya
$ borg create -v --list /path/to/repo::my-documents ~/Dokumen

# Sandaran ~/Dokumen and ~/src tetapi tidak termasuk fail pyc
$ borg create /path/to/repo::my-files \
~/Dokumen \
~/src \
--exclude '*.pyc'

# Sandarkan direktori rumah tidak termasuk lakaran kecil imej (iaitu sahaja
# / rumah /*/.thumbnails dikecualikan, bukan / rumah /*/*/.gambar kecil)
$ borg buat /path/to/repo::my-files / home \
--exclude 're:^/ rumah /[^/]+/\.gambar kecil/'

# Lakukan perkara yang sama menggunakan corak gaya cangkerang
$ borg buat /path/to/repo::my-files / home \
--exclude 'sh:/ rumah /*/.thumbnails'

# Sandarkan sistem fail akar ke dalam arkib bernama "root-YYYY-MM-DD"
# gunakan pemampatan zlib (baik, tetapi perlahan) - lalai ialah tiada pemampatan
$ borg create -C zlib,6 /path/to/repo::root-{now:%Y-%m-%d} / --one-file-system

# Berusaha besar dalam penyahduplikasian berbutir halus (pengurusan bahagian besar
# overhead, memerlukan banyak RAM dan ruang cakera, lihat formula dalam dalaman
# docs - parameter yang sama seperti borg < 1.0 atau loteng):
$ borg create --chunker-params 10,23,16,4095 /path/to/repo::small /smallstuff

# Sandarkan peranti mentah (mesti tidak aktif/sedang digunakan/dilekapkan pada masa itu)
$ dd if=/dev/sdx bs=10J | borg create /path/to/repo::my-sdx -

# Tiada pemampatan (lalai)
$ borg buat /path/to/repo::arch ~

# Sangat pantas, mampatan rendah
$ borg create --compression lz4 /path/to/repo::arch ~

# Kurang pantas, mampatan lebih tinggi (N = 0..9)
$ borg create --compression zlib,N /path/to/repo::arch ~

# Lebih perlahan, mampatan lebih tinggi (N = 0..9)
$ borg create --compression lzma,N /path/to/repo::arch ~

# Format tag tersedia untuk nama arkib:
# {now}, {utcnow}, {fqdn}, {hostname}, {user}, {pid}
# tambah nama hos pendek, nama pengguna sandaran dan unixtime semasa (saat dari zaman)
$ borg create /path/to/repo::{hostname}-{user}-{now:%s} ~

BORG EXTRACT

penggunaan: ekstrak borg [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [--senarai] [-n] [-e CORAK]
[--exclude-from EXCLUDEFILE] [--numeric-owner]
[--jalur-komponen NUMBER] [--stdout] [--jarang]
ARKIB [LALUAN [LALUAN ...]]

Ekstrak kandungan arkib

hujah kedudukan:
Arkib arkib untuk diekstrak
Laluan PATH untuk diekstrak; corak disokong

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
--list output verbose senarai item (fail, dirs, ...)
-n, --dry-run sebenarnya tidak menukar sebarang fail
-e CORAK, --kecualikan CORAK
kecualikan laluan padanan CORAK
--kecualikan-daripada EXCLUDEFILE
baca mengecualikan corak daripada EXCLUDEFILE, satu setiap baris
--numeric-owner hanya mematuhi pengecam pengguna berangka dan kumpulan
--jalur-komponen NUMBER
Alih keluar bilangan elemen laluan utama yang ditentukan.
Nama laluan dengan unsur yang lebih sedikit akan menjadi senyap
dilangkau.
--stdout tulis semua data yang diekstrak ke stdout
--sparse mencipta lubang dalam output fail jarang dari semua-sifar
ketulan

Penerangan Produk
Perintah ini mengekstrak kandungan arkib. Secara lalai keseluruhan arkib adalah
diekstrak tetapi subset fail dan direktori boleh dipilih dengan menghantar senarai LALUAN
sebagai hujah. Pemilihan fail boleh dihadkan lagi dengan menggunakan --kecualikan pilihan.

Lihat output perintah "borg help patterns" untuk mendapatkan bantuan lanjut tentang mengecualikan corak.

Contoh
# Ekstrak keseluruhan arkib
$ borg ekstrak /path/to/repo::my-files

# Ekstrak keseluruhan arkib dan senarai fail semasa memproses
$ borg ekstrak -v --list /path/to/repo::my-files

# Ekstrak direktori "src".
$ borg ekstrak /path/to/repo::my-files home/USERNAME/src

# Ekstrak direktori "src" tetapi kecualikan fail objek
$ borg ekstrak /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# Pulihkan peranti mentah (mesti tidak aktif/sedang digunakan/dilekapkan pada masa itu)
$ ekstrak borg --stdout /path/to/repo::my-sdx | dd of=/dev/sdx bs=10M

Catatan: pada masa ini, mengekstrak sentiasa menulis ke dalam yang semasa bekerja direktori ("."),
jadi pastikan anda cd ke tempat yang betul sebelum membuat panggilan borg mengekstrak.

BORG CHECK

penggunaan: semak borg [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [--repositori-sahaja] [--arkib-sahaja]
[--baik pulih] [--jimat-ruang] [--N terakhir] [-P AWAL]
[REPOSITORY_OR_ARCHIVE]

Semak konsistensi repositori

hujah kedudukan:
REPOSITORY_OR_ARCHIVE
repositori atau arkib untuk menyemak konsistensi

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
--repository-only hanya melakukan semakan repositori
--archives-only hanya melakukan semakan arkib
--percubaan pembaikan untuk membaiki sebarang ketidakkonsistenan yang ditemui
--save-space berfungsi lebih perlahan, tetapi menggunakan lebih sedikit ruang
--N terakhir hanya semak arkib N terakhir (Lalai: semua)
-PREFIX PREFIX, --prefix PREFIX
hanya pertimbangkan nama arkib bermula dengan awalan ini

Penerangan Produk
Perintah semak mengesahkan ketekalan repositori dan arkib yang sepadan.

Pertama, fail data repositori asas diperiksa:

· Untuk semua segmen sihir segmen (pengepala) diperiksa

· Untuk semua objek yang disimpan dalam segmen, semua metadata (cth crc dan saiz) dan semua data adalah
membaca. Data baca disemak mengikut saiz dan CRC. Reput bit dan jenis lain yang tidak disengajakan
kerosakan boleh dikesan dengan cara ini.

· Jika kami berada dalam mod pembaikan dan ralat integriti dikesan untuk segmen, kami cuba melakukannya
pulihkan seberapa banyak objek daripada segmen yang mungkin.

· Dalam mod pembaikan, ia memastikan bahawa indeks adalah konsisten dengan data yang disimpan dalam
segmen.

· Jika anda menggunakan pelayan repo jauh melalui ssh:, semakan repo dilaksanakan pada pelayan repo
tanpa menyebabkan trafik rangkaian yang ketara.

· Semakan repositori boleh dilangkau menggunakan pilihan --archives-only.

Kedua, ketekalan dan ketepatan metadata arkib disahkan:

· Adakah manifes repo hadir? Jika tidak, ia dibina semula daripada ketulan metadata arkib (ini
memerlukan pembacaan dan penyahsulitan semua metadata dan data).

· Semak sama ada bahagian metadata arkib ada. jika tidak, alih keluar arkib daripada manifes.

· Untuk semua fail (item) dalam arkib, untuk semua bahagian yang dirujuk oleh fail ini, semak sama ada
ketulan ada (jika tidak dan kami dalam mod pembaikan, gantikannya dengan ketulan yang sama saiz
sifar). Ini memerlukan pembacaan metadata arkib dan fail, tetapi bukan data.

· Jika kami berada dalam mod pembaikan dan kami menyemak semua arkib: padamkan ketulan yatim daripada
repo itu.

· jika anda menggunakan pelayan repo jauh melalui ssh:, semakan arkib dilaksanakan pada klien
mesin (kerana jika penyulitan didayakan, semakan akan memerlukan penyahsulitan dan ini
sentiasa dilakukan di sisi pelanggan, kerana akses kunci akan diperlukan).

· Semakan arkib boleh memakan masa, ia boleh dilangkau menggunakan
--pilihan repositori sahaja.

BORG RENAME

penggunaan: nama semula borg [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan jauh LALUAN]
ARKIB NAMA BARU

Namakan semula arkib sedia ada

hujah kedudukan:
ARKIB untuk menamakan semula
NEWNAME nama arkib baharu untuk digunakan

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")

Penerangan Produk
Perintah ini menamakan semula arkib dalam repositori.

Contoh
$ borg create /path/to/repo::archivename ~
$ senarai borg /path/to/repo
nama arkib Isn, 2016-02-15 19:50:19

$ borg menamakan semula /path/to/repo::archivename newname
$ senarai borg /path/to/repo
nama baharu Mon, 2016-02-15 19:50:19

BORG SENARAI

penggunaan: senarai borg [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [--pendek] [--format-senarai LISTFORMAT]
[-P AWAL]
[REPOSITORY_OR_ARCHIVE]

Senaraikan kandungan arkib atau repositori

hujah kedudukan:
REPOSITORY_OR_ARCHIVE
repositori/arkib untuk menyenaraikan kandungan

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
--pendek sahaja cetak nama fail/direktori, tiada yang lain
--format-senarai LISTFORMAT
tentukan format untuk penyenaraian fail arkib (lalai:
"{mode} {user:6} {group:6} {size:8d} {isomtime}
{path}{extra}{NEWLINE}") Khas "{formatkeys}" wujud
untuk menyenaraikan kunci yang tersedia
-PREFIX PREFIX, --prefix PREFIX
hanya pertimbangkan nama arkib bermula dengan awalan ini

Penerangan Produk
Perintah ini menyenaraikan kandungan repositori atau arkib.

Contoh
$ senarai borg /path/to/repo
Isnin Isnin, 2016-02-15 19:15:11
repo Isn, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nama baharu Mon, 2016-02-15 19:50:19
...

$ senarai borg /path/to/repo::root-2016-02-15
drwxr-xr-x akar akar 0 Isn, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 Isn, 2016-02-15 19:04:49 bin
-rwxr-xr-x akar akar 1029624 Kha, 2014-11-13 00:08:51 bin/bash
lrwxrwxrwx akar akar 0 Jum, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x akar akar 2140 Jum, 2015-03-27 20:24:22 bin/bzdiff
...

$ borg list /path/to/repo::archiveA --list-format="{mode} {user:6} {group:6} {size:8d} {isomtime} {path}{extra}{NEWLINE}"
pengguna pengguna drwxrwxr-x 0 Ahad, 2015-02-01 11:00:00 .
pengguna pengguna drwxrwxr-x 0 Ahad, 2015-02-01 11:00:00 kod
pengguna pengguna drwxrwxr-x 0 Ahad, 2015-02-01 11:00:00 kod/projek saya
-rw-rw-r-- pengguna pengguna 1416192 Ahad, 2015-02-01 11:00:00 kod/myproject/file.ext
...

# lihat perkara yang diubah antara arkib, berdasarkan masa pengubahsuaian fail, saiz dan laluan fail
$ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archiveA
$ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .arkibB
$ diff -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0 . 1422781200 0 .
1422781200 0 kod 1422781200 0 kod
1422781200 0 kod/projek saya 1422781200 0 kod/projek saya
1422781200 1416192 code/myproject/file.ext | 1454664653 1416192 code/myproject/file.ext
...

BORG DELETE

penggunaan: borg padam [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [-p] [-s] [-c] [--save-space]
[SASARAN]

Padamkan repositori atau arkib sedia ada

hujah kedudukan:
Arkib atau repositori SASARAN untuk dipadamkan

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
-p, --progress menunjukkan paparan kemajuan semasa memadamkan satu arkib
-s, --stats mencetak statistik untuk arkib yang dipadamkan
-c, --cache-only padamkan cache setempat sahaja untuk repositori yang diberikan
--save-space berfungsi lebih perlahan, tetapi menggunakan lebih sedikit ruang

Penerangan Produk
Perintah ini memadamkan arkib daripada repositori atau repositori lengkap. Cakera
ruang dituntut semula dengan sewajarnya. Jika anda memadamkan repositori lengkap, cache tempatan untuk
ia (jika ada) juga dipadamkan.

Contoh
# padamkan satu arkib sandaran:
$ borg padam /path/to/repo::Monday

# padamkan keseluruhan repositori dan cache setempat yang berkaitan:
$ borg padam /path/to/repo
Anda meminta untuk MENGHAPUSKAN sepenuhnya repositori *termasuk* semua arkib yang terkandung di dalamnya:
repo Isn, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nama baharu Mon, 2016-02-15 19:50:19
Taip 'YA' jika anda faham perkara ini dan ingin meneruskan: YA

BORG PRUNE

penggunaan: borg prune [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [-n] [-s] [--senarai]
[--simpan-dalam DALAM] [-H SETIAP JAM] [-d HARIAN] [-w MINGGUAN]
[-m BULANAN] [-y TAHUNAN] [-P AWAL] [--jimat-ruang]
[REPOSITORI]

Pangkas arkib repositori mengikut peraturan yang ditetapkan

hujah kedudukan:
REPOSITORY repositori untuk memangkas

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
-n, --dry-run jangan tukar repositori
-s, --stats mencetak statistik untuk arkib yang dipadamkan
--list output verbose senarai arkib yang disimpan/prun
--keep-within WITHIN simpan semua arkib dalam selang masa ini
-H SETIAP JAM, --simpan setiap jam SETIAP JAM
bilangan arkib setiap jam untuk disimpan
-d HARIAN, --simpan-harian HARIAN
bilangan arkib harian untuk disimpan
-w MINGGUAN, --simpan-mingguan MINGGUAN
bilangan arkib mingguan untuk disimpan
-m BULANAN, --simpan-bulanan BULANAN
bilangan arkib bulanan untuk disimpan
-y TAHUNAN, --simpan-tahunan TAHUNAN
bilangan arkib tahunan untuk disimpan
-PREFIX PREFIX, --prefix PREFIX
hanya pertimbangkan nama arkib bermula dengan awalan ini
--save-space berfungsi lebih perlahan, tetapi menggunakan lebih sedikit ruang

Penerangan Produk
Perintah prune memangkas repositori dengan memadamkan arkib yang tidak sepadan dengan mana-mana
pilihan pengekalan yang ditentukan. Perintah ini biasanya digunakan oleh skrip sandaran automatik
ingin menyimpan sejumlah sandaran bersejarah tertentu.

Sebagai contoh, "-d 7" bermaksud menyimpan sandaran terkini pada setiap hari, sehingga 7 terbaharu
hari dengan sandaran (hari tanpa sandaran tidak dikira). Peraturan digunakan dari setiap jam
kepada setiap tahun, dan sandaran yang dipilih oleh peraturan sebelumnya tidak dikira terhadap peraturan yang kemudian
peraturan. Masa setiap sandaran selesai digunakan untuk tujuan pemangkasan. Tarikh dan masa
ditafsirkan dalam zon waktu tempatan, dan minggu pergi dari Isnin hingga Ahad. Menentukan a
bilangan negatif arkib untuk disimpan bermakna tiada had.

Pilihan "--keep-in" mengambil hujah dalam bentuk " ", dengan char ialah "H",
"d", "w", "m", "y". Contohnya, "--keep-within 2d" bermaksud menyimpan semua arkib yang ada
dibuat dalam tempoh 48 jam yang lalu. "1m" diambil bermaksud "31h". Arkib disimpan dengan
pilihan ini tidak dikira dalam jumlah yang ditentukan oleh mana-mana pilihan lain.

Jika awalan ditetapkan dengan -P, maka hanya arkib yang bermula dengan awalan akan dipertimbangkan
untuk pemadaman dan hanya arkib tersebut dikira dalam jumlah yang ditentukan oleh peraturan.
Jika tidak, semua arkib dalam repositori adalah calon untuk dipadamkan!

Contoh
Berhati-hati, prune adalah arahan yang berpotensi berbahaya, ia akan mengalih keluar arkib sandaran.

Kelalaian prun adalah memohon kepada semua arkib in yang repositori melainkan anda menyekatnya
operasi kepada subset arkib menggunakan --awalan. Semasa menggunakan --awalan, berhati-hati untuk
pilih awalan yang baik - cth. jangan gunakan awalan "foo" jika anda tidak mahu padankan
"foobar".

Ia amat disyorkan untuk sentiasa berjalan plum --lari kering ... pertama supaya anda akan melihat apa itu
akan melakukannya tanpa ia benar-benar melakukan apa-apa.

# Simpan 7 hujung hari dan 4 arkib hujung minggu tambahan.
# Lakukan larian kering tanpa benar-benar memadamkan apa-apa.
$ borg prune --dry-run --keep-daily=7 --keep-weekly=4 /path/to/repo

# Sama seperti di atas tetapi hanya digunakan untuk nama arkib bermula dengan "foo":
$ borg prune --keep-daily=7 --keep-weekly=4 --prefix=foo /path/to/repo

# Simpan 7 hujung hari, 4 arkib hujung minggu tambahan,
# dan arkib akhir bulan untuk setiap bulan:
$ borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /path/to/repo

# Simpan semua sandaran dalam 10 hari terakhir, 4 arkib akhir minggu tambahan,
# dan arkib akhir bulan untuk setiap bulan:
$ borg prune --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /path/to/repo

BORG INFO

penggunaan: maklumat borg [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan jauh LALUAN]
ARKIB

Tunjukkan butiran arkib seperti ruang cakera yang digunakan

hujah kedudukan:
Arkib ARKIB untuk memaparkan maklumat tentang

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")

Penerangan Produk
Perintah ini memaparkan beberapa maklumat terperinci tentang arkib yang ditentukan.

Contoh
$ borg info /path/to/repo::root-2016-02-15
Nama: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Nama hos: nama hos saya
Nama pengguna: root
Masa (mula): Isn, 2016-02-15 19:36:29
Masa (akhir): Isn, 2016-02-15 19:39:26
Baris arahan: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
Bilangan fail: 38100

Saiz asal Saiz mampat Saiz pendua
Arkib ini: 1.33 GB 613.25 MB 571.64 MB
Semua arkib: 1.63 GB 853.66 MB 584.12 MB

Ketulan unik Jumlah ketulan
Indeks bahagian: 36858 48844

BORG MOUNT

penggunaan: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [-f] [-o PILIHAN]
REPOSITORY_OR_ARCHIVE MOUNTPOINT

Lekapkan arkib atau keseluruhan repositori sebagai sistem fail FUSE

hujah kedudukan:
REPOSITORY_OR_ARCHIVE
repositori/arkib untuk dipasang
MOUNTPOINT tempat untuk melekapkan sistem fail

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
-f, --foreground kekal di latar depan, jangan daemonize
-o PILIHAN Pilihan pelekap tambahan

Penerangan Produk
Perintah ini memasang arkib sebagai sistem fail FUSE. Ini boleh berguna untuk menyemak imbas
mengarkibkan atau memulihkan fail individu. Melainkan jika --latar hadapan pilihan diberi arahan
akan berjalan di latar belakang sehingga sistem fail berada umounted.

Contoh
$ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
$ ls /tmp/mymountpoint
bin boot dan lain-lain rumah lib lib64 hilang+ditemui media mnt opt ​​root sbin srv tmp usr var
$ fusermount -u /tmp/mymountpoint

BORG PERUBAHAN-LALUAN

penggunaan: borg tukar-frasa laluan [-h] [--kritikal] [--ralat] [--amaran] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [--umask M]
[--laluan jauh LALUAN]
[REPOSITORI]

Tukar frasa laluan fail kunci repositori

hujah kedudukan:
REPOSITORI

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")

Penerangan Produk
Fail utama yang digunakan untuk penyulitan repositori dilindungi frasa laluan secara pilihan. ini
arahan boleh digunakan untuk menukar frasa laluan ini.

Contoh
# Buat repositori yang dilindungi fail utama
$ borg init --encryption=keyfile -v /path/to/repo
Memulakan repositori di "/path/to/repo"
Masukkan frasa laluan baharu:
Masukkan frasa laluan yang sama sekali lagi:
Ingat frasa laluan anda. Data anda tidak akan dapat diakses tanpanya.
Masukkan "/root/.config/borg/keys/mnt_backup" dibuat.
Simpan kunci ini dengan selamat. Data anda tidak akan dapat diakses tanpanya.
Menyegerakkan cache ketulan...
Arkib: 0, w/ cached Idx: 0, w/ outdated Idx: 0, w/o cached Idx: 0.
Menderma.

# Tukar frasa laluan fail utama
$ borg tukar frasa laluan -v /path/to/repo
Masukkan frasa laluan untuk kunci /root/.config/borg/keys/mnt_backup:
Masukkan frasa laluan baharu:
Masukkan frasa laluan yang sama sekali lagi:
Ingat frasa laluan anda. Data anda tidak akan dapat diakses tanpanya.
Kunci dikemas kini

BORG HIDANG

penggunaan: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [--sekat-ke-laluan LALUAN]

Mulakan dalam mod pelayan. Perintah ini biasanya tidak digunakan secara manual.

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
--restrict-to-path PATH
mengehadkan akses repositori kepada PATH

Penerangan Produk
Perintah ini memulakan proses pelayan repositori. Perintah ini biasanya tidak digunakan
secara manual.

Contoh
borg serve mempunyai sokongan khas untuk perintah paksa ssh (lihat kunci_benar contoh
di bawah): ia akan mengesan bahawa anda menggunakan perintah paksa dan mengekstrak nilai
--sekat-ke-laluan pilihan. Ia kemudiannya akan menghuraikan arahan asal yang datang dari
pelanggan, pastikan ia juga begitu borg berkhidmat dan menguatkuasakan sekatan laluan seperti yang diberikan oleh
perintah paksa. Dengan cara itu, pilihan lain yang diberikan oleh pelanggan (seperti --maklumat or --umask)
dipelihara (dan tidak ditetapkan oleh perintah paksa).

# Benarkan pasangan kekunci SSH hanya menjalankan borg, dan hanya mempunyai akses kepada /path/to/repo.
# Gunakan pilihan utama untuk melumpuhkan fungsi SSH yang tidak diperlukan dan berpotensi berbahaya.
# Ini akan membantu untuk mendapatkan sistem sandaran jauh automatik.
$ kucing ~/.ssh/authorized_keys
command="borg serve --restrict-to-path /path/to/repo",no-pty,no-agent-forwarding,no-port-forwarding,no-X11-forwarding,no-user-rc ssh-rsa AAAAB3[...]

BORG NAIK TARAF

penggunaan: naik taraf borg [-h] [--kritikal] [--ralat] [--amaran] [--info] [--debug]
[--kunci-tunggu N] [--show-rc] [--no-files-cache] [--umask M]
[--laluan-jauh] [-p] [-n] [-i]
[REPOSITORI]

menaik taraf repositori daripada versi sebelumnya

hujah kedudukan:
Laluan REPOSITORY ke repositori untuk dinaik taraf

hujah pilihan:
-h, --help tunjukkan mesej bantuan ini dan keluar
--kerja kritikal pada tahap log KRITIKAL
--error berfungsi pada peringkat log ERROR
--kerja amaran pada tahap log AMARAN (lalai)
--info, -v, --verbose
bekerja pada INFO peringkat log
--debug berfungsi pada DEBUG peringkat log
--kunci-tunggu N tunggu kunci, tetapi maks. N saat (lalai: 1).
--show-rc tunjukkan/log kod pulangan (rc)
--no-files-cache tidak memuatkan/kemas kini cache metadata fail yang digunakan
mengesan fail yang tidak berubah
--umask M tetapkan umask kepada M (tempatan dan jauh, lalai: 0077)
--remote-path PATH menetapkan laluan jauh kepada boleh laku (lalai: "borg")
-p, --progress menunjukkan paparan kemajuan semasa menaik taraf repositori
-n, --dry-run jangan tukar repositori
-i, --inplace repositori tulis semula di tempat, tanpa peluang untuk pergi
kembali ke versi lama repositori.

Penerangan Produk
Tingkatkan repositori Borg sedia ada. Ini pada masa ini menyokong penukaran Attic
repositori kepada Borg dan juga membantu dengan menukar Borg 0.xx kepada 1.0.

Pada masa ini, hanya repositori TEMPATAN boleh dinaik taraf (isu #465).

Ia akan menukar rentetan ajaib dalam segmen repositori agar sepadan dengan sihir Borg baharu
rentetan. Fail kunci yang terdapat dalam $ATTIC_KEYS_DIR atau ~/.attic/keys/ juga akan ditukar
dan disalin ke $BORG_KEYS_DIR atau ~/.config/borg/keys.

Fail cache ditukar, daripada $ATTIC_CACHE_DIR atau ~/.cache/loteng kepada $BORG_CACHE_DIR
or ~/.cache/borg, tetapi susun atur cache antara Borg dan Attic berubah, jadi mungkin
sandaran pertama selepas penukaran mengambil masa lebih lama daripada yang dijangkakan disebabkan penyegerakan semula cache.

Naik taraf sepatutnya dapat disambung semula jika terganggu, walaupun ia masih akan berulang
segmen. Jika anda ingin bermula dari awal, gunakan borg memadam atas repositori yang disalin ke
pastikan fail cache juga dialih keluar:
borg padam borg

Kecuali --di tempat ditentukan, proses naik taraf mula-mula mencipta salinan sandaran
repositori, dalam REPOSITORY.upgrade-DATETIME, menggunakan pautan keras. Ini mengambil masa lebih lama daripada dalam
tempat naik taraf, tetapi jauh lebih selamat dan memberikan maklumat kemajuan (berbanding dengan cp -al).
Sebaik sahaja anda berpuas hati dengan penukaran, anda boleh memusnahkan salinan sandaran dengan selamat.

AMARAN: Menjalankan peningkatan di tempat akan menjadikan salinan semasa tidak boleh digunakan dengan yang lebih lama
versi, tanpa cara untuk kembali ke versi sebelumnya. Ini boleh MEROSAKKAN ANDA SECARA KEKAL
REPOSITORI! Attic TIDAK BOLEH MEMBACA REPOSITORI BORG, kerana rentetan ajaib telah berubah. awak
telah diberi amaran.

Contoh
# Tingkatkan repositori borg kepada versi terbaharu.
$ borg naik taraf -v /path/to/repo
membuat salinan pautan keras dalam /path/to/repo.upgrade-2016-02-15-20:51:55
membuka repositori loteng dengan borg dan menukar
tiada fail kunci ditemui untuk repositori
menukar indeks repo /path/to/repo/index.0
menukar 1 segmen...
menukarkan borg 0.xx kepada arus borg
tiada fail kunci ditemui untuk repositori

PELBAGAI BANTU

borg membantu corak
Corak pengecualian menyokong empat gaya berasingan, fnmatch, shell, ungkapan biasa dan
awalan laluan. Jika diikuti dengan titik bertindih (':') dua aksara pertama corak digunakan
sebagai pemilih gaya. Pemilihan gaya eksplisit diperlukan apabila gaya bukan lalai diperlukan
dikehendaki atau apabila corak yang diingini bermula dengan dua aksara alfanumerik diikuti dengan a
kolon (cth aa:sesuatu/*).

Fnmatch, pemilih fm:
Corak ini menggunakan varian sintaks corak shell, dengan '*' sepadan dengan sebarang nombor
watak, '?' memadankan mana-mana aksara tunggal, '[...]' memadankan mana-mana aksara tunggal
ditentukan, termasuk julat, dan '[!...]' sepadan dengan mana-mana aksara yang tidak dinyatakan. Untuk
tujuan corak ini, pemisah laluan ('' untuk Windows dan '/' pada sistem lain)
tidak dilayan secara khusus. Balut aksara meta dalam kurungan untuk padanan literal (cth
[?] untuk memadankan watak literal ?). Untuk laluan sepadan dengan corak, ia mesti
sepadan sepenuhnya dari awal hingga akhir, atau mesti sepadan dari awal hingga sejurus sebelum laluan
pemisah. Kecuali untuk laluan akar, laluan tidak akan berakhir dalam pemisah laluan apabila
padanan dicuba. Oleh itu, jika corak yang diberikan berakhir dengan pemisah laluan, '*' ialah
dilampirkan sebelum pemadanan dicuba.

Corak gaya cangkerang, pemilih sh:
Seperti corak fnmatch ini serupa dengan corak cangkerang. Perbezaannya ialah
corak mungkin termasuk ** / untuk memadankan sifar atau lebih tahap direktori, * untuk padanan sifar
atau lebih banyak aksara sewenang-wenangnya dengan pengecualian mana-mana pemisah laluan.

Ungkapan biasa, pemilih semula:
Ungkapan biasa yang serupa dengan yang terdapat dalam Perl disokong. Tidak seperti corak cangkerang
ungkapan biasa tidak diperlukan untuk memadankan laluan lengkap dan mana-mana padanan subrentetan
adalah mencukupi. Ia amat disyorkan untuk menambat corak ke permulaan ('^'), ke
akhir ('$') atau kedua-duanya. Pemisah laluan ('' untuk Windows dan '/' pada sistem lain) dalam laluan
sentiasa dinormalkan kepada garis miring ke hadapan ('/') sebelum menggunakan corak. Yang biasa
sintaks ungkapan diterangkan dalam Python dokumentasi Untuk yang re modul.

Laluan awalan, pemilih ms:
Gaya corak ini berguna untuk memadankan keseluruhan sub-direktori. Corak itu pp:/data/bar
perlawanan /data/bar dan segala yang ada di dalamnya.

Pengecualian boleh diluluskan melalui pilihan baris arahan --kecualikan. Apabila digunakan dari dalam a
shell corak hendaklah dipetik untuk melindungi mereka daripada pengembangan.

. --kecualikan-daripada pilihan membenarkan memuatkan corak pengecualian daripada fail teks dengan satu
corak setiap baris. Baris kosong atau bermula dengan tanda nombor ('#') selepas dialih keluar
ruang putih pada kedua-dua hujung diabaikan. Awalan pemilih gaya pilihan juga disokong
untuk corak yang dimuatkan daripada fail. Disebabkan oleh laluan penyingkiran ruang putih dengan ruang putih di
permulaan atau akhir hanya boleh dikecualikan menggunakan ungkapan biasa.

Contoh:

# Kecualikan '/home/user/file.o' tetapi bukan '/home/user/file.odt': $ borg create -e '
*
.o' sandaran /

# Kecualikan '/home/user/junk' dan '/home/user/subdir/junk' tetapi # tidak
'/home/user/importantjunk' atau '/etc/junk': $ borg create -e '/ rumah /
*
/sampah' sandaran /

# Kecualikan kandungan '/home/user/cache' tetapi bukan direktori itu sendiri: $ borg create
-e /home/pengguna/cache/ sandaran /

# Fail '/home/user/cache/important' ialah tidak disandarkan: $ borg create -e
/home/user/cache/ backup / /home/user/cache/penting

# Kandungan direktori dalam '/ home' tidak disandarkan apabila nama mereka # berakhir
'.tmp' $ borg create --exclude 're:^/ rumah /[^/]+.tmp/' backup /

# Muatkan pengecualian daripada fail $ cat >exclude.txt < / rumah //sampah * .tmp
fm:aa:sesuatu/ semula:^/ rumah /[^/].tmp/ sh:/ rumah /
*
/.thumbnails EOF $ borg create --exclude-from exclude.txt backup /

HUTANG PERINTAH

Terdapat beberapa lagi arahan (semuanya bermula dengan "debug-") yang semuanya tidak Bertujuan Untuk
biasa penggunaan and berpotensi sangat berbahaya jika digunakan secara tidak betul.

Ia wujud untuk meningkatkan keupayaan penyahpepijatan tanpa akses sistem langsung, contohnya dalam kes
anda pernah mengalami kerosakan yang teruk. Gunakannya hanya jika anda tahu apa yang anda lakukan atau
jika pembangun Borg yang dipercayai memberitahu anda perkara yang perlu dilakukan.

TAMBAHAN NOTA

Berikut adalah pelbagai. nota tentang topik yang mungkin tidak dibincangkan dengan cukup terperinci dalam penggunaan
bawah seksyen ini.

Perkara bendera
borg mewujudkan -v --senarai mengeluarkan senarai verbose semua fail, direktori dan fail lain
item sistem yang dianggapnya (tidak kira sama ada mereka mempunyai perubahan kandungan atau tidak). Untuk setiap
item, ia memberi awalan bendera satu huruf yang menunjukkan jenis dan/atau status item.

Jika anda hanya berminat dengan subset keluaran itu, anda boleh berikan cth --filter=AME and
ia hanya akan menunjukkan fail biasa dengan status A, M atau E (lihat di bawah).

Aksara huruf besar mewakili status fail biasa berbanding dengan "fail"
cache (bukan relatif kepada repo -- ini adalah isu jika cache fail tidak digunakan).
Metadata disimpan dalam apa jua keadaan dan untuk 'A' dan 'M' juga potongan data baharu disimpan. Untuk
'U' semua ketulan data merujuk kepada ketulan sedia ada.

· 'A' = fail biasa, ditambah (lihat juga a_status_oddity dalam Soalan Lazim)

· 'M' = fail biasa, diubah suai

· 'U' = fail biasa, tidak berubah

· 'E' = fail biasa, ralat berlaku semasa mengakses/membaca ini fail

Aksara huruf kecil bermaksud jenis fail selain daripada fail biasa, borg biasanya hanya
menyimpan metadata mereka:

· 'd' = direktori

· 'b' = peranti blok

· 'c' = peranti char

· 'h' = fail biasa, pautan keras (kepada inod yang sudah dilihat)

· 's' = symlink

· 'f' = fifo

Bendera lain yang digunakan termasuk:

· 'i' = data sandaran telah dibaca daripada input standard (stdin)

· '-' = larian kering, item tadi tidak disokong

· '?' = tiada kod status (jika anda melihat ini, sila failkan laporan pepijat!)

--chunker-params
Param chunker mempengaruhi cara fail input dipotong menjadi kepingan (ketulan) yang kemudiannya
dipertimbangkan untuk deduplikasi. Mereka juga mempunyai kesan yang besar terhadap penggunaan sumber (RAM dan cakera
ruang) kerana jumlah sumber yang diperlukan (juga) ditentukan oleh jumlah keseluruhan
ketulan dalam repositori (lihat Indeks / Cache memori penggunaan untuk maklumat lanjut).

--chunker-params=10,23,16,4095 menghasilkan deduplikasi berbutir halus dan mencipta besar
jumlah ketulan dan dengan itu menggunakan banyak sumber untuk mengurusnya. Ini bagus untuk
volum data yang agak kecil dan jika mesin mempunyai jumlah RAM dan cakera percuma yang baik
ruang.

--chunker-params=19,23,21,4095 (lalai) menghasilkan deduplikasi berbutir kasar dan
menghasilkan jumlah ketulan yang lebih kecil dan dengan itu menggunakan kurang sumber. Ini bagus untuk
volum data yang agak besar dan jika mesin mempunyai jumlah RAM percuma yang agak rendah dan
ruang cakera.

Jika anda sudah membuat beberapa arkib dalam repositori dan anda kemudian menukar params chunker,
ini sudah tentu memberi kesan deduplikasi kerana ketulan akan dipotong secara berbeza.

Dalam kes yang paling teruk (semua fail adalah besar dan disentuh di antara sandaran), ini akan disimpan
semua kandungan ke dalam repositori semula.

Biasanya, ia tidak begitu buruk:

· biasanya kebanyakan fail tidak disentuh, jadi ia hanya akan menggunakan semula bahagian lama yang sudah ada
dalam repo

· fail yang lebih kecil daripada saiz minimum (lama dan baharu) menghasilkan hanya satu ketul
bagaimanapun, jadi potongan yang terhasil adalah sama dan penyahduplikasian akan digunakan

Jika anda menukar params chunker untuk menyimpan sumber untuk repo sedia ada yang sudah mempunyai beberapa
arkib sandaran, anda akan melihat kesan yang semakin meningkat dari semasa ke semasa, apabila semakin banyak fail
telah disentuh dan disimpan semula menggunakan chunksize yang lebih besar and semua rujukan kepada
ketulan lama yang lebih kecil telah dialih keluar (dengan memadam / memangkas arkib).

Jika anda ingin melihat kesan besar serta-merta terhadap penggunaan sumber, lebih baik anda mulakan yang baharu
repositori apabila menukar params chunker.

Untuk butiran lanjut, lihat chunker_details.

--baca-khas
pilihan --baca-khas tidak bertujuan untuk normal, peringkat sistem fail (penuh atau
sandaran sebahagian-rekursif). Anda hanya memberi pilihan ini jika anda ingin melakukan sesuatu
... istimewa -- dan jika anda telah memilih sendiri beberapa fail yang ingin anda perlakukan seperti itu.

borg mewujudkan --baca-khas akan membuka semua fail tanpa melakukan sebarang rawatan khas
mengikut jenis fail (satu-satunya pengecualian di sini ialah direktori: mereka akan diulang
ke dalam). Cuba bayangkan apa yang berlaku jika anda melakukannya kucing nama fail --- kandungan yang anda akan lihat di sana
adalah apa yang borg akan sandarkan untuk nama fail itu.

Jadi, sebagai contoh, symlinks akan diikuti, kandungan peranti blok akan dibaca, dinamakan paip
/ Soket domain UNIX akan dibaca.

Anda perlu berhati-hati dengan apa yang anda berikan sebagai nama fail apabila menggunakan --baca-khas, cth jika
awak beri /dev/sifar, sandaran anda tidak akan ditamatkan.

Metadata fail yang diberikan disimpan kerana ia akan disimpan tanpa --baca-khas (cthnya
nama, saiznya [mungkin 0], modnya, dsb.) -- tetapi selain itu, kandungan yang dibaca juga
daripadanya akan disimpan untuknya.

Memulihkan kandungan fail tersebut pada masa ini hanya disokong satu demi satu melalui --stdout
pilihan (dan anda perlu mengubah hala stdout ke mana sahaja ia akan pergi, mungkin terus ke dalam
fail peranti sedia ada pilihan anda atau secara tidak langsung melalui dd).

Contoh
Bayangkan anda telah membuat beberapa gambar volum logik (LV) yang ingin anda sandarkan.

PERHATIAN:
Untuk beberapa senario, ini adalah kaedah yang baik untuk mendapatkan konsistensi "seperti ranap" (saya memanggilnya
ranap kerana ia adalah sama seperti yang anda akan dapat jika anda hanya menekan butang set semula atau
mesin anda akan ranap secara tiba-tiba dan sepenuhnya). Ini lebih baik daripada tidak konsisten
sama sekali dan kaedah yang baik untuk beberapa kes penggunaan, tetapi mungkin tidak cukup baik jika anda ada
pangkalan data berjalan.

Kemudian anda membuat arkib sandaran semua syot kilat ini. Proses sandaran akan melihat a
"beku" keadaan jilid logik, manakala proses bekerja dalam jilid asal
teruskan menukar data yang disimpan di sana.

Anda juga menambah output daripada lvdisplay ke sandaran anda, supaya anda boleh melihat saiz LV sekiranya berlaku
anda perlu mencipta semula dan memulihkannya.

Selepas sandaran selesai, anda mengalih keluar syot kilat sekali lagi.

$ # buat syot kilat di sini
$ lvdisplay > lvdisplay.txt
$ borg create --read-special /path/to/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$ # alih keluar syot kilat di sini

Sekarang, mari lihat cara memulihkan beberapa LV daripada sandaran sedemikian.

$ borg ekstrak /path/to/repo::arch lvdisplay.txt
$ # buat LV kosong dengan saiz yang betul di sini (lihat ke dalam lvdisplay.txt).
$ # kami menganggap bahawa anda telah mencipta akar kosong dan LV rumah dan menulis ganti sekarang:
$ ekstrak borg --stdout /path/to/repo::arch dev/vg0/root-snapshot > /dev/vg0/root
$ ekstrak borg --stdout /path/to/repo::arch dev/vg0/home-snapshot > /dev/vg0/home

Tambahan sahaja mod
Repositori boleh dibuat "tambahan sahaja", yang bermaksud bahawa Borg tidak akan menulis ganti atau
memadam data yang komited. Ini berguna untuk senario di mana berbilang mesin membuat sandaran kepada a
pelayan sandaran pusat menggunakan borg berkhidmat, kerana mesin yang digodam tidak boleh memadamkan sandaran
secara kekal.

Untuk mengaktifkan mod tambahan sahaja, edit repositori config fail dan tambah baris append_only=1
kepada [repositori] bahagian (atau edit baris jika wujud).

Dalam mod tambahan sahaja Borg akan membuat log transaksi dalam urus niaga fail, di mana
setiap baris ialah transaksi dan cap waktu UTC.

Contoh
Katakan penyerang memadamkan semua sandaran dari jauh, tetapi repositori anda berada dalam tambahan sahaja
mod. Log transaksi dalam situasi ini mungkin kelihatan seperti ini:

transaksi 1, masa UTC 2016-03-31T15:53:27.383532
transaksi 5, masa UTC 2016-03-31T15:53:52.588922
transaksi 11, masa UTC 2016-03-31T15:54:23.887256
transaksi 12, masa UTC 2016-03-31T15:55:54.022540
transaksi 13, masa UTC 2016-03-31T15:55:55.472564

Daripada log keselamatan anda, anda membuat kesimpulan bahawa penyerang mendapat akses pada 15:54:00 dan semua
sandaran apabila dipadamkan atau digantikan dengan sandaran yang terjejas. Dari log anda tahu itu
urus niaga 11 dan kemudiannya terjejas. Ambil perhatian bahawa ID transaksi ialah nama bagi
lepas fail dalam urus niaga. Sebagai contoh, transaksi 11 merangkumi fail 6 hingga 11.

Dalam serangan sebenar, anda mungkin mahu mengekalkan repositori yang terjejas utuh untuk dianalisis
apa yang cuba dicapai oleh penyerang. Ia juga merupakan idea yang baik untuk membuat salinan ini untuk berjaga-jaga
ada yang tidak kena semasa pemulihan. Memandangkan pemulihan dilakukan dengan memadam beberapa fail, a
salinan pautan keras (cp -al) mencukupi.

Langkah pertama untuk menetapkan semula repositori kepada transaksi 5, yang terakhir tanpa kompromi
transaksi, adalah untuk mengeluarkan petunjuk.N and indeks.N fail dalam repositori (dua fail ini
sentiasa boleh dibelanjakan). Dalam contoh ini N ialah 13.

Kemudian alih keluar atau alihkan semua fail segmen daripada direktori segmen masuk data / bermula dengan
fail 6:

rm data/**/{6..13}

Itu sahaja.

kelemahan
Memandangkan data hanya dilampirkan, dan tiada apa-apa yang dipadam, arahan seperti plum or memadam tidak akan percuma
ruang cakera, mereka hanya menandai data sebagai dipadamkan dalam transaksi baharu.

Ambil perhatian bahawa anda boleh berulang-alik antara operasi biasa dan tambah sahaja dengan mengedit
fail konfigurasi, ia bukan "perjalanan sehala".

Lanjut pertimbangan
Mod tambahan sahaja tidak dihormati oleh alatan selain Borg. rm masih berfungsi pada
repositori. Pastikan mesin klien sandaran hanya boleh mengakses repositori melalui
borg berkhidmat.

Pastikan tiada akses jauh boleh dilakukan jika repositori ditetapkan kepada normal buat sementara waktu
mod untuk cth pemangkasan biasa.

Perlindungan lanjut boleh dilaksanakan, tetapi berada di luar skop Borgs. Sebagai contoh, fail
syot kilat atau pembalut sistem borg berkhidmat untuk menetapkan kebenaran khas atau ACL pada data baharu
fail.

Gunakan borgbackup dalam talian menggunakan perkhidmatan onworks.net