obnam - Online di Cloud

PROGRAM:

NAMA

obnam - membuat, memulihkan, dan memanipulasi cadangan

RINGKASAN

obnam [--selalu-kembalikan-setuid] [--tidak-selalu-mengembalikan-setuid] [--pos pemeriksaan=UKURAN]
[--ukuran-potongan-tas=UKURAN] [--ukuran-chunk-cache=UKURAN] [--ukuran-potongan=UKURAN]
[--chunkids-per-grup=NUM] [--Nama Klien=NAMA KLIEN] [--kompres-dengan=PROGRAM]
[--konfigurasi=FILE] [--dump-config] [--dump-pengaturan-nama] [--menghasilkan-halaman manual=TEMPLAT] [-h]
[--membantu] [--tolong-semua] [--daftar-file konfigurasi] [--Versi: kapan] [--tidak ada-konfigurasi-default]
[--crash-batas=COUNTER] [--usia kritis=UMUR] [--deduplikat=MODE] [--dir-tas-ukuran=UKURAN]
[--dir-ukuran-cache=UKURAN] [--dump-memori-profil=METODE] [--dump-repo-file-metadata]
[--tidak ada-dump-repo-file-metadata] [--enkripsi-dengan=ENKRIPSI-DENGAN] [--mengecualikan=MENGECUALIKAN]
[--kecuali-cache] [--no-kecualikan-cache] [--kecuali-dari=FILE] [--fsck-perbaiki]
[--tidak-fsck-perbaiki] [--fsck-abaikan-potongan] [--no-fsck-abaikan-potongan]
[--fsck-abaikan-klien=NAMA] [--fsck-generasi terakhir-saja] [--no-fsck-hanya generasi terakhir]
[--fsck-rm-tidak digunakan] [--no-fsck-rm-tidak digunakan] [--fsck-skip-checksum]
[--no-fsck-skip-checksum] [--fsck-skip-dirs] [--no-fsck-skip-dirs] [--fsck-skip-file]
[--no-fsck-skip-file] [--fsck-skip-generasi] [--no-fsck-skip-generasi]
[--fsck-lewati-per-klien-b-pohon] [--no-fsck-skip-per-klien-b-pohon]
[--fsck-lewati-berbagi-b-pohon] [--tidak-fsck-lewati-berbagi-b-pohon] [--sekering-opt=SEKERING]
[--generasi=GENERASI] [--gnupghome=RUMAH] [--idpath-bit=IDPATH-BIT]
[--idpath-kedalaman=IDPATH-KEDALAMAN] [--idpath-lewati=IDPATH-LEWATKAN] [--termasuk=TERMASUK]
[--menyimpan=TERUS] [--detail-kunci] [--tanpa-kunci-detail] [--keyid=ID KUNCI] [--tinggalkan-pos pemeriksaan]
[--pos pemeriksaan tanpa cuti] [--lock-timeout=TIMEOUT] [--catatan=FILE] [--log-simpan=N]
[--tingkat log=TINGKAT] [--log-maks=UKURAN] [--mode log=MODE] [--lru-ukuran=UKURAN]
[--interval pembuangan memori=DETIK] [--ukuran simpul=UKURAN] [--satu-file-sistem]
[--tidak ada satu file-sistem] [--keluaran=FILE] [--berpura-pura] [--lari-kering] [--tidak bertindak] [--tidak berpura-pura]
[--tanpa-lari-kering] [--tidak-tidak-bertindak] [--pura-pura-waktu=URUTAN WAKTU] [--murni-paramiko]
[--tidak-murni-paramiko] [--diam] [--diam] [--tidak-tenang] [--tidak diam] [-rURL]
[--gudang=URL] [--repositori-format=FORMAT] [--akar=URL] [--sftp-penundaan=SFTP-TUNDA]
[--file-kecil-dalam-btree] [--no-file-kecil-dalam-btree] [--ssh-perintah=DAPAT DILAKSANAKAN]
[--ssh-Host-keys-check=NILAI] [--ssh-kunci=NAMA FILE] [--ssh-dikenal-host=NAMA FILE]
[--kunci-host-ketat-ssh] [--tidak ada-ketat-ssh-host-kunci] [--simetris-kunci-bit=BITS]
[--pengujian-gagal-pencocokan=REGEXP] [--ke=UNTUK] [--jejak=TRACE] [--upload-antrian-ukuran=UKURAN]
[--bertele-tele] [--tidak bertele-tele] [--verifikasi-secara acak=N] [--peringatan-usia=UMUR] [--lemah-acak]
[--tidak-lemah-acak]

obnam [Pilihan] _kunci
obnam [Pilihan] tombol tambah [KLIEN-NAMA] ...
obnam [Pilihan] cadangan [DIREKTORI|URL] ...
obnam [Pilihan] kunci klien
obnam [Pilihan] klien
obnam [Pilihan] beda [GENERASI1]GENERASI2
obnam [Pilihan] dump-repo
obnam [Pilihan] kunci-paksa
obnam [Pilihan] lupa [GENERASI] ...
obnam [Pilihan] sial
obnam [Pilihan] generasi
obnam [Pilihan] genid
obnam [Pilihan] Tolong
obnam [Pilihan] bantuan-semua
obnam [Pilihan] kdirstat [FILE] ...
obnam [Pilihan] daftar-kesalahan
obnam [Pilihan] format daftar
obnam [Pilihan] tombol daftar
obnam [Pilihan] daftar-tingkat atas
obnam [Pilihan] aku [FILE] ...
obnam [Pilihan] Gunung [ROOT]
obnam [Pilihan] usia nagios-backup-terakhir
obnam [Pilihan] hapus-klien [KLIEN-NAMA] ...
obnam [Pilihan] hapus-kunci [KLIEN-NAMA] ...
obnam [Pilihan] memulihkan [DIREKTORI] ...
obnam [Pilihan] verifikasi [DIREKTORI] ...

DESKRIPSI

obnam membuat, memulihkan, memanipulasi, dan sebaliknya berurusan dengan cadangan. Itu bisa menyimpan
backup pada disk lokal atau ke server melalui sftp. Setiap generasi cadangan terlihat seperti
snapshot baru, tetapi benar-benar inkremental: pengguna tidak perlu khawatir apakah itu a
cadangan penuh atau tidak. Hanya data yang diubah yang dicadangkan, dan jika sebagian data sudah ada
dicadangkan di file lain, data itu digunakan kembali.

Tempat penyimpanan data yang dicadangkan disebut repositori cadangan. Sebuah gudang
mungkin, misalnya, direktori pada server sftp, atau direktori pada hard disk USB. A
repositori tunggal mungkin berisi cadangan dari beberapa klien. Data mereka akan bercampur
seolah-olah mereka menggunakan repositori terpisah, tetapi jika satu klien mencadangkan file, yang lain
dapat menggunakan kembali data tersebut.

obnam sintaks baris perintah terdiri dari a Command mungkin diikuti oleh argumen. NS
perintah adalah daftar di bawah ini.

· backup membuat cadangan baru. Pertama kali dijalankan, itu membuat cadangan penuh, setelah
yang inkremental.

· mengembalikan adalah kebalikan dari cadangan. Ini menyalin data yang dicadangkan dari cadangan
repositori ke direktori target. Anda dapat memulihkan semuanya dalam satu generasi, atau
hanya file yang dipilih.

· klien daftar klien yang didukung ke repositori.

· Generasi daftar setiap generasi cadangan untuk klien tertentu, ditambah beberapa metadata
tentang generasi.

· genid daftar pengidentifikasi untuk setiap generasi cadangan untuk klien tertentu. Tidak
informasi lain ditampilkan. Hal ini dapat berguna untuk scripting.

· ls daftar isi dari generasi tertentu, mirip dengan ls -lar.

· kdirstat daftar isi dari generasi tertentu, dalam format yang kompatibel
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. kdirstat format file cache, yang kemudian dapat digunakan untuk memvisualisasikan
isi cadangan.

· memeriksa membandingkan data dalam cadangan dengan data pengguna yang sebenarnya, dan memastikannya
identik. Sangat berguna untuk menjalankan segera setelah pencadangan, untuk memeriksa apakah itu
benar-benar bekerja. Itu dapat dijalankan kapan saja, tetapi jika data pengguna telah berubah,
verifikasi gagal meskipun cadangannya OK.

· lupa menghapus generasi cadangan yang tidak lagi diinginkan, sehingga tidak digunakan
ruang disk. Perhatikan bahwa setelah pembuatan cadangan dihapus, data tidak dapat
dipulihkan lagi. Anda dapat menentukan generasi yang akan dihapus dengan mencantumkannya
di baris perintah, atau gunakan --menyimpan opsi untuk menentukan kebijakan tentang apa yang harus disimpan
(segala sesuatu yang lain akan dihapus).

· fsck memeriksa konsistensi internal dari repositori cadangan. Ini memverifikasi bahwa
semua klien, generasi, direktori, file, dan semua konten file masih ada di
repositori cadangan. Mungkin butuh waktu yang cukup lama untuk berjalan.

· kunci paksa menghapus file kunci untuk klien di repositori. Anda hanya harus
paksa kunci jika Anda yakin tidak ada yang mengakses data klien itu di
gudang. Kunci yang menggantung mungkin terjadi, misalnya, jika obnam kehilangan jaringannya
koneksi ke repositori cadangan.

· kunci-klien daftar kunci enkripsi yang terkait dengan setiap klien.

· daftar-kunci mencantumkan kunci yang dapat mengakses repositori, dan level atas mana
direktori yang dapat diakses oleh setiap kunci. Beberapa direktori tingkat atas dibagikan
antara klien, yang lain khusus untuk klien.

· daftar-tingkat atas adalah seperti daftar-kunci, tetapi mencantumkan level teratas dan kunci mana yang dapat diakses
Mereka.

· kunci tambahan menambahkan kunci enkripsi ke repositori. Secara default, kuncinya ditambahkan
hanya ke direktori tingkat atas bersama, tetapi juga dapat ditambahkan ke tertentu
klien: daftar nama klien di baris perintah. Kunci mereka diberikan dengan
itu --keyid pilihan. Siapa pun yang memiliki akses ke kunci rahasia yang sesuai dengan kunci tersebut
id dapat mengakses repositori cadangan (tingkat atas bersama ditambah klien tertentu).

· hapus-kunci menghapus kunci dari direktori tingkat atas bersama, ditambah klien apa pun
ditentukan pada baris perintah.

· nagios-cadangan terakhir-usia adalah cek yang keluar dengan pengembalian bukan nol jika usia cadangan
melebihi ambang batas tertentu. Sangat cocok untuk digunakan sebagai plugin cek untuk nagios.
Ambang batas dapat diberikan --peringatan-usia dan --usia kritis Pilihan.

· diff membandingkan dua generasi dan membuat daftar file yang berbeda di antara mereka. Setiap keluaran
baris akan diawali dengan tanda plus (+) untuk file yang ditambahkan, minus
tanda (-) untuk file yang telah dihapus atau tanda bintang (*) untuk file yang telah
berubah. Jika hanya satu ID generasi yang ditentukan pada baris perintah yang
generasi akan dibandingkan dengan pendahulunya langsung. Jika dua ID telah
ditentukan, semua perubahan antara dua generasi tersebut akan dicantumkan.

· meningkat membuat repositori cadangan tersedia melalui sistem file FUSE read-only. Setiap
generasi cadangan terlihat sebagai subdirektori, dinamai id generasi.
Ini berarti Anda dapat melihat data yang dicadangkan menggunakan alat normal, seperti file GUI Anda
manajer, atau alat baris perintah seperti ls(1) diff(1), dan cp(1). Anda tidak bisa membuat
backup baru dengan subcommand mount, tetapi Anda dapat memulihkan data dengan mudah.

Anda harus memiliki utilitas FUSE dan memiliki izin untuk menggunakan FUSE agar dapat
kerja. Rinciannya akan bervariasi antara sistem operasi; di Debian, instal:
paket sekering dan tambahkan diri Anda ke sekering grup (Anda mungkin perlu keluar dan kembali
masuk lagi).

Membuat backup
Saat Anda menjalankan pencadangan, obnam mengunggah data ke dalam repositori cadangan. Datanya terbagi
menjadi potongan, dan jika potongan sudah ada di repositori cadangan, itu tidak diunggah
lagi. Ini memungkinkan obnam untuk menangani file yang telah diubah atau diganti namanya sejak
menjalankan pencadangan sebelumnya. Ini juga memungkinkan beberapa klien cadangan untuk menghindari mengunggah yang sama
data. Jika, misalnya, setiap orang di kantor memiliki salinan brosur penjualan yang sama,
hanya satu salinan yang perlu disimpan dalam repositori cadangan.

Setiap proses pencadangan adalah generasi. Tambahan lagi, obnam akan membuat pos pemeriksaan Generasi
sesekali. Ini persis seperti generasi normal, tetapi tidak dijamin
menjadi snapshot lengkap dari data langsung. Jika proses pencadangan perlu dibatalkan di
tengah, pencadangan berikutnya dapat dilanjutkan dari pos pemeriksaan terbaru, menghindari kebutuhan untuk
memulai dari awal.

Jika satu proses pencadangan menjatuhkan direktori root cadangan, generasi yang lebih lama akan tetap menyimpannya:
tidak ada perubahan pada generasi lama hanya karena ada yang baru. Jika akarnya adalah
dijatuhkan secara tidak sengaja, dapat ditambahkan kembali dan pencadangan berikutnya akan menggunakan kembali yang ada
data dalam repositori cadangan, dan hanya akan mencadangkan metadata file (nama file,
izin, dll).

Verifikasi backup
Apa gunanya sistem cadangan yang tidak dapat Anda andalkan? Bagaimana Anda bisa mengandalkan sesuatu yang Anda tidak bisa
tes? NS obnam memeriksa perintah memeriksa apakah data dalam repositori cadangan cocok dengan yang sebenarnya
data pengguna. Ini mengambil satu atau lebih file dari repositori dan membandingkannya dengan
data pengguna. Ini pada dasarnya sama dengan melakukan pemulihan, lalu membandingkan file yang dipulihkan
dengan file asli menggunakan CMP(1), tetapi lebih mudah digunakan.

Secara default, verifikasi terjadi pada semua file. Anda juga dapat menentukan file yang akan
diverifikasi dengan mencantumkannya di baris perintah. Anda harus menentukan jalur lengkap ke
file, tidak relatif terhadap direktori saat ini.

Output mencantumkan file yang gagal verifikasi karena beberapa alasan. Jika Anda memverifikasi semuanya,
kemungkinan beberapa file (misalnya, direktori induk dari root cadangan) mungkin telah berubah
tanpa itu menjadi masalah. Perhatikan bahwa Anda perlu menentukan seluruh jalur ke
file atau direktori yang akan diverifikasi, tidak relatif terhadap root cadangan. Anda masih perlu
tentukan setidaknya satu root cadangan pada baris perintah atau melalui --akar pilihan jadi
obnam itu akan menemukan sistem file, jika itu adalah sistem jarak jauh.

URL sintaksis
Setiap kali obnam menerima URL, itu bisa berupa nama path lokal, atau sftp URL. Sebuah sftp
URL memiliki bentuk berikut:

sftp: //[pemakai@]domain[:pelabuhan]/jalur

dimana domain adalah nama domain Internet normal untuk server, pemakai apakah nama pengguna Anda itu?
server, pelabuhan adalah nomor port opsional, dan path adalah nama path di sisi server. Suka
bzr(1), tetapi tidak seperti standar URL sftp, nama path adalah absolut, kecuali jika dimulai dengan
/~/ dalam hal ini relatif terhadap direktori home pengguna di server.

Lihat bagian CONTOH untuk contoh URL.

Anda dapat menggunakan sftp URL untuk repositori, atau data langsung (root), tetapi perhatikan bahwa karena
keterbatasan dalam protokol, dan implementasinya dalam paramiko perpustakaan, beberapa hal
tidak akan berfungsi dengan baik untuk mengakses data langsung melalui sftp. Yang terpenting, penanganannya
dari hardlink agak kurang optimal. Untuk akses data langsung, Anda tidak boleh mengakhiri URL
dengan /~/ dan harus menambahkan titik di akhir dalam kasus khusus ini.

Generasi spesifikasi
Saat tidak menggunakan generasi terbaru, Anda harus menentukan yang mana yang Anda butuhkan. Ini
akan dilakukan dengan --generasi opsi, yang mengambil spesifikasi generasi sebagai
argumen. Spesifikasinya adalah kata Terbaru, artinya generasi terbaru
(juga default), atau nomor. Lihat Generasi perintah untuk melihat generasi apa itu
tersedia, dan berapa jumlahnya.

Kebijakan untuk pemeliharaan dan menghapus backup Generasi
Grafik lupa perintah dapat mengikuti kebijakan untuk secara otomatis menyimpan beberapa dan menghapus cadangan lainnya
generasi. Kebijakan tersebut ditetapkan dengan --menyimpan=KEBIJAKAN .

KEBIJAKAN adalah daftar aturan yang dipisahkan koma. Setiap aturan terdiri dari hitungan dan periode waktu.
Periode waktu adalah h, d, w, m, dan y, untuk jam, hari, minggu, bulan, dan tahun.

Sebuah kebijakan dari 30d berarti menyimpan cadangan terbaru untuk setiap hari saat pencadangan dibuat, dan
simpan 30 cadangan terakhir tersebut. Cadangan apa pun yang cocok dengan aturan kebijakan apa pun disimpan, dan semua
cadangan di antaranya akan dihapus, seperti halnya cadangan yang lebih lama dari cadangan terlama yang disimpan.

Sebagai contoh, asumsikan pencadangan dilakukan setiap jam, pada jam: pukul 00:00, 01:00, 02:00,
dan seterusnya, hingga pukul 23:00. jika lupa perintah dijalankan pada 23:15, dengan kebijakan di atas, itu
akan menyimpan cadangan yang diambil pada pukul 23:00 setiap hari, dan menghapus setiap cadangan lainnya pada hari itu.
Ini juga akan menghapus cadangan yang lebih lama dari 30 hari.

Jika pencadangan dilakukan setiap dua hari sekali, pada siang hari, lupa akan menyimpan 30 cadangan terakhir, atau 60
cadangan senilai hari, dengan kebijakan di atas.

Perhatikan bahwa obnam hanya akan memeriksa stempel waktu di repositori cadangan, dan tidak peduli
berapa waktu aktual saat ini. Ini berarti bahwa jika Anda berhenti membuat cadangan baru,
yang sudah ada tidak akan dihapus secara otomatis. Intinya, obnam berpura-pura waktu saat ini
hanya setelah pencadangan terbaru ketika lupa dijalankan.

Aturan dapat diberikan dalam urutan apa pun, tetapi akan diurutkan ke urutan menaik dari periode waktu
sebelum diterapkan. (Adalah kesalahan untuk memberikan dua aturan untuk periode yang sama.) Cadangan
generasi disimpan jika cocok dengan aturan apa pun.

Misalnya, asumsikan frekuensi pencadangan yang sama seperti di atas, tetapi kebijakan 30d,52w. Ini
akan menyimpan cadangan harian terbaru untuk setiap hari selama tiga puluh hari, dan mingguan terbaru
cadangan selama 52 minggu. Karena cadangan per jam akan dihapus setiap hari, sebelum mereka memiliki
kesempatan untuk diselamatkan oleh aturan mingguan, efeknya adalah cadangan jam 23:00 untuk masing-masing
hari disimpan selama sebulan, dan cadangan 23:00 pada hari Minggu disimpan selama setahun.

Sebaliknya, jika Anda menggunakan kebijakan 72j,30d,52w, obnam akan menyimpan cadangan 72 jam terakhir,
dan cadangan terakhir setiap hari kalender selama 30 hari, dan cadangan terakhir setiap kalender
minggu selama 52 minggu. Jika frekuensi pencadangan dilakukan sekali per hari, obnam akan menyimpan cadangan
dari setiap jam kalender yang membuat cadangan, untuk 72 cadangan tersebut. Dengan kata lain,
itu akan secara efektif menyimpan 72 cadangan harian terakhir.

Terdengar membingungkan? Coba bayangkan betapa bingungnya developer saat menulis kodenya.

Jika tidak ada kebijakan yang diberikan, lupa akan menjaga semuanya.

Kebijakan tipikal mungkin 72 jam, 7 hari, 5w, 12m, yang berarti: simpan cadangan 72 jam terakhir,
7 pencadangan harian terakhir, 5 pencadangan mingguan terakhir, dan 12 pencadangan bulanan terakhir. jika
pencadangan dijalankan secara sistematis setiap jam, ini berarti menyimpan cadangan per jam
selama tiga hari, pencadangan harian selama seminggu, pencadangan mingguan selama sebulan, dan pencadangan bulanan
untuk setahun.

Cara kerja kebijakan ini agak rumit. Lari lupa pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. --berpura-pura pilihan untuk
pastikan Anda menghapus yang benar.

Menggunakan enkripsi
obnam dapat mengenkripsi semua data yang ditulisnya ke repositori cadangan. Ini menggunakan gpg(1) untuk melakukan
enkripsi. Anda perlu membuat pasangan kunci menggunakan gpg --gen-kunci (atau gunakan yang sudah ada
satu), dan kemudian beri tahu obnam tentang hal itu menggunakan --enkripsi-dengan pilihan. Anda dapat secara opsional
gunakan direktori home terpisah menggunakan --gnupghome pilihan. Secara default, default
direktori untuk gpg(1) akan digunakan.

konfigurasi arsip
obnam akan mencari file konfigurasi di sejumlah lokasi. Lihat bagian FILE
untuk daftar. Semua file ini bersama-sama diperlakukan sebagai satu file besar dengan konten semua
file yang digabungkan.

File dalam format INI, dan hanya file [konfigurasi] bagian digunakan (bagian lain adalah
diabaikan).

Nama panjang opsi digunakan sebagai kunci untuk variabel konfigurasi. Pengaturan apa saja yang
dapat diatur dari baris perintah dapat diatur dalam file konfigurasi, di [konfigurasi]
bagian.

Misalnya, opsi di baris perintah berikut:

obnam --repository=/backup --exclude='.wav$' backup

dapat diganti dengan file konfigurasi berikut:

[konfigurasi]
repositori: /cadangan
kecualikan: .wav$

(Anda dapat menggunakan keduanya foo=nilai or foo: nilai sintaks dalam file.)

Satu-satunya hal yang tidak biasa tentang file adalah cara opsi yang dapat digunakan berkali-kali adalah
menyatakan. Semua nilai diletakkan dalam satu baris logis, dipisahkan dengan koma (dan
opsional spasi juga). Sebagai contoh:

[konfigurasi]
kecualikan = foo, bar, \.mp3$

Di atas memiliki tiga nilai untuk mengecualikan opsi: file apa pun yang berisi kata-kata foo or
bar di mana saja dalam nama path yang sepenuhnya memenuhi syarat, atau file dengan nama yang diakhiri dengan titik dan
mp3 (karena pengecualian adalah ekspresi reguler).

Garis logis yang panjang dapat dipecah menjadi beberapa garis fisik, dengan memulai baris baru di
spasi putih, dan membuat indentasi baris lanjutan:

[konfigurasi]
kecualikan = foo,
bar,
\.mp3$

Contoh di atas menambahkan tiga pola pengecualian.

kelipatan klien dan mengunci
obnam mendukung berbagi repositori antara beberapa klien. Klien dapat berbagi
isi file (potongan), sehingga jika klien A mencadangkan file besar, dan klien B memiliki
file yang sama, maka B tidak perlu mengupload file besar ke repositori untuk kedua kalinya.
Agar ini berfungsi tanpa kebingungan, klien menggunakan protokol penguncian sederhana yang memungkinkan
hanya satu klien pada satu waktu untuk mengubah struktur data bersama. Kunci tidak mencegah
akses baca-saja pada saat yang sama: ini memungkinkan Anda untuk memulihkan saat orang lain sedang
membuat cadangan.

Terkadang operasi read-only terjadi untuk mengakses struktur data pada saat yang sama
sedang dimodifikasi. Hal ini dapat mengakibatkan crash. Itu tidak akan menghasilkan data yang rusak, atau
pengembalian yang salah. Namun, Anda mungkin perlu memulai ulang operasi baca-saja setelah a
jatuh.

PILIHAN

--selalu-kembalikan-setuid
pulihkan bit setuid/setgid dalam file yang dipulihkan, meskipun bukan file yang di-root atau dicadangkan
memiliki pemilik yang berbeda dari pengguna yang menjalankan pemulihan

--tidak-selalu-mengembalikan-setuid
kebalikan dari --always-restore-setuid

--Nama Klien=NAMA KLIEN
nama klien (default ke nama host)

--kompres-dengan=PROGRAM
gunakan PROGRAM untuk mengompresi repositori dengan (salah satu dari tidak ada, mengempis)

--usia kritis=UMUR
untuk nagios-last-backup-age: usia maksimum (secara default dalam jam) untuk yang terbaru
backup sebelum statis sangat penting. Menerima satu penentu unit karakter (s,m,h,d untuk
detik, menit, jam, dan hari.

--dump-repo-file-metadata
membuang metadata tentang file?

--tidak ada-dump-repo-file-metadata
kebalikan dari --dump-repo-file-metadata

--menghasilkan-halaman manual=TEMPLAT
BANTUAN TEKAN

--generasi=GENERASI
generasi mana yang akan dipulihkan

-h, --membantu
tunjukkan pesan bantuan ini dan keluar

--menyimpan=TERUS
kebijakan untuk generasi apa yang harus disimpan ketika lupa

--lock-timeout=TIMEOUT
saat mengunci di repositori cadangan, tunggu TIMEOUT detik untuk kunci yang ada untuk
pergilah sebelum menyerah

--keluaran=FILE
tulis output ke FILE, alih-alih output standar

--berpura-pura, --lari-kering, --tidak bertindak
tidak benar-benar mengubah apa pun (berfungsi dengan pencadangan, pelupaan, dan pemulihan saja, dan
hanya dapat mensimulasikan perilaku yang kira-kira nyata)

--tidak berpura-pura, --tanpa-lari-kering, --tidak-tidak-bertindak
kebalikan dari --pretend

--diam, --diam
diam: hanya tampilkan pesan kesalahan, tidak ada pembaruan kemajuan

--tidak-tenang, --tidak diam
kebalikan dari --tenang

-r, --gudang=URL
nama repositori cadangan (bisa berupa nama path atau URL yang didukung)

--repositori-format=FORMAT
gunakan FORMAT untuk repositori baru; salah satu dari "6", "albatros hijau"

--ke=UNTUK
tempat untuk memulihkan atau memasang FUSE; untuk restore, harus kosong atau tidak boleh ada

--bertele-tele
bertele-tele: beri tahu pengguna lebih banyak tentang apa yang sedang terjadi dan secara umum pastikan pengguna
menyadari apa yang sedang terjadi atau setidaknya sesuatu sedang terjadi dan juga membuat
yakin layar mereka sering diperbarui dan ada perubahan yang terjadi
sepanjang waktu sehingga mereka tidak bosan dan bahkan frustrasi oleh
terganggu oleh begitu banyak pembaruan sehingga mereka akan pindah ke gurun Gobi untuk
hidup di bawah batu

--tidak bertele-tele
kebalikan dari --verbose

--verifikasi-secara acak=N
verifikasi N file secara acak dari cadangan (defaultnya adalah nol, artinya semuanya)

--Versi: kapan
tampilkan nomor versi program dan keluar

--peringatan-usia=UMUR
untuk nagios-last-backup-age: usia maksimum (secara default dalam jam) untuk yang terbaru
backup sebelum status peringatan. Menerima satu penentu unit karakter (s,m,h,d untuk
detik, menit, jam, dan hari.

Dukungan up
--pos pemeriksaan=UKURAN
buat pos pemeriksaan setelah SIZE yang diberikan

--deduplikat=MODE
temukan data duplikat dalam data yang dicadangkan dan simpan hanya sekali; tiga mode adalah
tersedia: tidak pernah menghapus duplikat, memverifikasi bahwa tidak ada tabrakan hash yang terjadi, atau (
default) secara fatal menerima risiko tabrakan

--mengecualikan=MENGECUALIKAN
ekspresi reguler untuk nama jalur yang akan dikecualikan dari cadangan (dapat digunakan beberapa kali)
waktu)

--kecuali-cache
mengecualikan direktori (dan subdirnya) yang berisi file CACHEDIR.TAG (lihat
http://www.brynosaurus.com/cachedir/spec.html untuk apa yang perlu dikandungnya, dan
http://liw.fi/cachedir/ untuk alat pembantu)

--no-kecualikan-cache
kebalikan dari --exclude-caches

--kecuali-dari=FILE
baca pola pengecualian dari FILE

--termasuk=TERMASUK
ekspresi reguler untuk nama path untuk disertakan dari cadangan meskipun cocok dengan
kecualikan aturan (dapat digunakan beberapa kali)

--tinggalkan-pos pemeriksaan
tinggalkan generasi pos pemeriksaan di akhir proses pencadangan yang berhasil

--pos pemeriksaan tanpa cuti
kebalikan dari --leave-checkpoints

--satu-file-sistem
mengecualikan direktori (dan subdirnya) yang berada di sistem file yang berbeda

--tidak ada satu file-sistem
kebalikan dari --one-file-system

--akar=URL
apa yang harus dicadangkan

--file-kecil-dalam-btree
ini hanya tersedia untuk kompatibilitas mundur; jangan gunakan, dan hapus
dari konfigurasi Anda

--no-file-kecil-dalam-btree
kebalikan dari --small-files-in-btree

konfigurasi arsip dan pengaturan
--konfigurasi=FILE
tambahkan FILE ke file konfigurasi

--dump-config
tuliskan seluruh konfigurasi saat ini

--dump-pengaturan-nama
BANTUAN TEKAN

--tolong-semua
tampilkan semua opsi

--daftar-file konfigurasi
BANTUAN TEKAN

--tidak ada-konfigurasi-default
hapus daftar file konfigurasi untuk dibaca

Pengembangan of obnam Diri
--crash-batas=COUNTER
membuat crash program secara artifisial setelah file COUNTER ditulis ke repositori; ini
berguna untuk pengujian crash aplikasi, dan tidak boleh diaktifkan secara nyata
menggunakan; atur ke 0 untuk menonaktifkan (dinonaktifkan secara default)

--pura-pura-waktu=URUTAN WAKTU
berpura-pura itu adalah TIMESTAMP (YYYY-MM-DD HH:MM:SS); ini hanya berguna untuk pengujian
tujuan

--sftp-penundaan=SFTP-TUNDA
tambahkan penundaan buatan (dalam milidetik) ke semua transfer SFTP

--pengujian-gagal-pencocokan=REGEXP
pembantu pengujian pengembangan: simulasikan kegagalan selama pencadangan untuk file yang cocok
ekspresi reguler yang diberikan

--jejak=TRACE
tambahkan ke pola nama file yang menyebabkan logging debugging jejak terjadi

enkripsi
--enkripsi-dengan=ENKRIPSI-DENGAN
Kunci PGP yang digunakan untuk mengenkripsi data dalam repositori cadangan

--gnupghome=RUMAH
direktori home untuk GPG

--detail-kunci
tampilkan ID pengguna tambahan untuk semua kunci

--tanpa-kunci-detail
kebalikan dari --key-details

--keyid=ID KUNCI
ID kunci PGP untuk ditambahkan/dihapus dari repositori cadangan

--simetris-kunci-bit=BITS
ukuran kunci simetris, dalam bit

--lemah-acak
gunakan /dev/urandom alih-alih /dev/random untuk menghasilkan kunci simetris

--tidak-lemah-acak
kebalikan dari --weak-random

Integritas memeriksa (sialan)
--fsck-perbaiki
haruskah fsck mencoba memperbaiki masalah? Menyiratkan --fsck-rm-unused

--tidak-fsck-perbaiki
kebalikan dari --fsck-fix

--fsck-abaikan-potongan
abaikan potongan saat memeriksa integritas repositori (anggap semua potongan ada dan ada)
benar)

--no-fsck-abaikan-potongan
kebalikan dari --fsck-ignore-chunks

--fsck-abaikan-klien=NAMA
jangan periksa data repositori untuk NAMA kuno

--fsck-generasi terakhir-saja
periksa hanya generasi terakhir untuk setiap klien

--no-fsck-hanya generasi terakhir
kebalikan dari --fsck-last-generation-only

--fsck-rm-tidak digunakan
haruskah fsck menghapus potongan yang tidak digunakan?

--no-fsck-rm-tidak digunakan
kebalikan dari --fsck-rm-unused

--fsck-skip-checksum
jangan periksa checksum file

--no-fsck-skip-checksum
kebalikan dari --fsck-skip-checksums

--fsck-skip-dirs
jangan periksa apa pun tentang direktori dan file mereka

--no-fsck-skip-dirs
kebalikan dari --fsck-skip-dirs

--fsck-skip-file
jangan periksa apa pun tentang file

--no-fsck-skip-file
kebalikan dari --fsck-skip-files

--fsck-skip-generasi
jangan periksa generasi apa pun

--no-fsck-skip-generasi
kebalikan dari --fsck-skip-generations

--fsck-lewati-per-klien-b-pohon
jangan periksa pohon B per klien

--no-fsck-skip-per-klien-b-pohon
kebalikan dari --fsck-skip-per-client-b-trees

--fsck-lewati-berbagi-b-pohon
jangan centang B-tree yang dibagikan

--tidak-fsck-lewati-berbagi-b-pohon
kebalikan dari --fsck-skip-shared-b-trees

Logging
--catatan=FILE
menulis entri log ke FILE (default adalah untuk tidak menulis file log sama sekali); gunakan "syslog"
untuk masuk ke log sistem, "stderr" untuk masuk ke keluaran kesalahan standar, atau "tidak ada" untuk
nonaktifkan pencatatan

--log-simpan=N
simpan N log terakhir (10)

--tingkat log=TINGKAT
log at LEVEL, salah satu debug, info, warning, error, critical, fatal (default: info)

--log-maks=UKURAN
putar log lebih besar dari SIZE, nol untuk tidak pernah (default: 0)

--mode log=MODE
atur izin file log baru ke MODE (oktal; default 0600)

Bantalan dengan SEKERING
--sekering-opt=SEKERING
pilihan untuk lulus langsung ke Fuse

kinerja
--dump-memori-profil=METODE
buat dump profil memori menggunakan METODE, yang merupakan salah satu dari: none, simple, atau meliae
(default: sederhana)

--interval pembuangan memori=DETIK
buat pemrofilan memori terpisah setidaknya SECONDS

Performance tweaking
--ukuran-potongan=UKURAN
ukuran potongan data file yang dicadangkan

--chunkids-per-grup=NUM
menyandikan NUM potongan id per grup

--idpath-bit=IDPATH-BIT
ukuran tingkat id potongan

--idpath-kedalaman=IDPATH-KEDALAMAN
kedalaman pemetaan id chunk

--idpath-lewati=IDPATH-LEWATKAN
potongan id memetakan bit terendah lewati

--lru-ukuran=UKURAN
ukuran cache LRU untuk node B-tree

--ukuran simpul=UKURAN
ukuran node B-tree pada disk; hanya mempengaruhi pohon-B baru sehingga Anda mungkin perlu menghapus
klien atau repositori untuk mengubah ini untuk repositori yang ada

--upload-antrian-ukuran=UKURAN
panjang antrian unggah untuk node B-tree

Gudang format elang laut hijau
--ukuran-potongan-tas=UKURAN
perkiraan ukuran maksimum tas yang menggabungkan banyak objek potongan

--ukuran-chunk-cache=UKURAN
ukuran cache dalam memori untuk objek potongan data file

--dir-tas-ukuran=UKURAN
perkiraan ukuran maksimum tas yang menggabungkan banyak objek DIR

--dir-ukuran-cache=UKURAN
ukuran cache dalam memori untuk objek DIR

SSH/SFTP
--murni-paramiko
jangan gunakan openssh meskipun tersedia, gunakan paramiko saja sebagai gantinya

--tidak-murni-paramiko
kebalikan dari --pure-paramiko

--ssh-perintah=DAPAT DILAKSANAKAN
alternatif yang dapat dieksekusi untuk digunakan sebagai ganti "ssh" (path lengkap diizinkan, tidak
argumen dapat ditambahkan)

--ssh-Host-keys-check=NILAI
Jika "ya", mengharuskan kunci host ssh harus diketahui dan benar untuk dapat diterima.
Jika "tidak", tidak mengharuskan itu. Jika "bertanya", pengguna secara interaktif diminta untuk menerima
host baru. Default ("ssh-config") adalah mengandalkan pengaturan yang mendasarinya
klien SSH

--ssh-kunci=NAMA FILE
gunakan FILENAME sebagai kunci pribadi ssh RSA untuk akses sftp (default menggunakan kunci
diketahui ssh-agent)

--ssh-dikenal-host=NAMA FILE
nama file dari file host yang diketahui pengguna

--kunci-host-ketat-ssh
TIDAK DIPAKAI, gunakan --ssh-Host-keys-check sebagai gantinya

--tidak ada-ketat-ssh-host-kunci
kebalikan dari --strict-ssh-Host-keys

pilihan nilai-nilai
Grafik UKURAN nilai dalam opsi yang disebutkan di atas menentukan ukuran dalam byte, dengan opsional
akhiran untuk menunjukkan kilobyte (k), kibibyte (Ki), megabyte (M), mebibyte (Mi),
gigabyte (G), gibibyte (Gi), terabyte (T), tibibyte (Ti). Sufiksnya adalah kasus-
tidak peka.

EXIT STATUS

obnam akan keluar dengan nol jika semuanya berjalan dengan baik, dan bukan nol sebaliknya.

LINGKUNGAN

obnam akan meneruskan lingkungan yang didapatnya dari induknya, tanpa modifikasi. memang
tidak mematuhi variabel lingkungan yang tidak biasa, tetapi mematuhi yang biasa saat dijalankan
program eksternal, membuat file sementara, dll.

Gunakan obnam online menggunakan layanan onworks.net