obnam - Dalam talian di Awan

JADUAL:

NAMA

obnam - membuat, memulihkan dan memanipulasi sandaran

SINOPSIS

obnam [--sentiasa-pulihkan-setuid] [--tidak-selalu-pulihkan-setuid] [--pusat pemeriksaan=SAIZ]
[--saiz beg ketul=SAIZ] [--saiz-cache-chunk=SAIZ] [--saiz ketul=SAIZ]
[--chunkids-per-kumpulan=NUM] [--nama pelanggan=NAMA PELANGGAN] [--mampat-dengan=PROGRAM]
[--config=FAIL] [--dump-config] [--dump-setting-namas] [--generate-manpage=TEMPLAT] [-h]
[- membantu] [--bantu-semua] [--list-config-files] [--versi] [--no-default-configs]
[--had-crash=KAUNTER] [--usia kritikal=UMUR] [--penduakan=MODE] [--saiz-beg-dir=SAIZ]
[--saiz-dir-cache=SAIZ] [--buang-memori-profil=KAEDAH] [--dump-repo-file-metadata]
[--no-dump-repo-file-metadata] [--encrypt-dengan=ENCRIPT-DENGAN] [--kecualikan=KECUALI]
[--kecualikan-cache] [--tiada-kecuali-cache] [--kecualikan-daripada=FAIL] [--fsck-fix]
[--no-fsck-fix] [--fsck-ignore-chunks] [--no-fsck-ignore-chunks]
[--fsck-ignore-client=NAMA] [--fsck-generasi-terakhir-sahaja] [--no-fsck-terakhir-generasi-sahaja]
[--fsck-rm-tidak digunakan] [--no-fsck-rm-unused] [--fsck-skip-checksums]
[--no-fsck-skip-checksums] [--fsck-skip-dirs] [--no-fsck-skip-dirs] [--fsck-skip-files]
[--no-fsck-skip-files] [--fsck-skip-generations] [--no-fsck-skip-generations]
[--fsck-skip-per-client-b-trees] [--no-fsck-skip-per-client-b-trees]
[--fsck-skip-shared-b-trees] [--no-fsck-skip-shared-b-trees] [--fius-opt=FIUS]
[--generasi=GENERASI] [--gnupghome=HOMEDIR] [--idpath-bits=IDPATH-BITS]
[--idpath-depth=IDPATH-DEPTH] [--idpath-langkau=IDPATH-SKIP] [--termasuk=TERMASUK]
[--simpan=KEEP] [--butiran kunci] [--tiada-kunci-butiran] [--keyid=KEYID] [--meninggalkan-tempat pemeriksaan]
[--tiada-cuti-tempat pemeriksaan] [--kunci-masa tamat=MASA TAMAT] [--log=FAIL] [--log-simpan=N]
[--peringkat-log=LEVEL] [--log-maks=SAIZ] [--mod-log=MODE] [--saiz-lru=SAIZ]
[--memory-dump-interval=SEKIAN] [--saiz nod=SAIZ] [--satu-sistem-fail]
[--tiada-satu-sistem-fail] [--pengeluaran=FAIL] [--berpura-pura] [--lari kering] [--tidak-bertindak] [--tidak-berpura-pura]
[--tiada-dry-run] [--tidak-tidak-bertindak] [--masa berpura-pura=STAMP MASA] [--paramiko tulen]
[--tiada-paramiko-tulen] [--senyap] [--senyap] [--tidak-tenang] [--tidak-senyap] [-rURL]
[--repositori=URL] [--format-repositori=FORMAT] [--akar=URL] [--sftp-delay=SFTP-KELEWATAN]
[--fail-kecil-dalam-btree] [--tiada-fail-kecil-dalam-btree] [--ssh-arahan=BOLEH DILAKSANAKAN]
[--ssh-host-keys-check=NILAI] [--ssh-key=NAMA FAIL] [--ssh-known-hosts=NAMA FAIL]
[--strict-ssh-host-keys] [--no-strict-ssh-host-keys] [--symmetric-key-bits=BITS]
[--pengujian-gagal-padanan=REGEXP] [--kepada=KEPADA] [--jejak=TRACE] [--muat naik-saiz baris gilir=SAIZ]
[--verbose] [--tidak bertele-tele] [--sahkan-secara rawak=N] [--amaran-umur=UMUR] [--lemah-rawak]
[--tidak-lemah-rawak]

obnam [pilihan] _kunci
obnam [pilihan] kunci tambah [CLIENT-NAMA]...
obnam [pilihan] sandaran [DIREKTORI|URL]...
obnam [pilihan] kunci pelanggan
obnam [pilihan] pelanggan
obnam [pilihan] berbeza [GENERASI1]GENERASI2
obnam [pilihan] dump-repo
obnam [pilihan] kunci paksa
obnam [pilihan] lupakan [GENERASI]...
obnam [pilihan] fsck
obnam [pilihan] generasi
obnam [pilihan] genid
obnam [pilihan] bantuan
obnam [pilihan] bantuan-semua
obnam [pilihan] kdirstat [FAIL]...
obnam [pilihan] ralat senarai
obnam [pilihan] format senarai
obnam [pilihan] kekunci senarai
obnam [pilihan] senarai-tingkat atas
obnam [pilihan] ls [FAIL]...
obnam [pilihan] lekapkan [ROOT]
obnam [pilihan] nagios-last-backup-age
obnam [pilihan] keluarkan-pelanggan [CLIENT-NAMA]...
obnam [pilihan] kunci keluarkan [CLIENT-NAMA]...
obnam [pilihan] pulihkan [DIREKTORI]...
obnam [pilihan] sahkan [DIREKTORI]...

DESCRIPTION

obnam membuat, memulihkan, memanipulasi, dan sebaliknya berurusan dengan sandaran. Ia boleh menyimpan
sandaran pada cakera tempatan atau ke pelayan melalui sftp. Setiap generasi sandaran kelihatan seperti a
syot kilat baru, tetapi benar-benar bertambah: pengguna tidak perlu risau sama ada a
sandaran penuh atau tidak. Hanya data yang ditukar disandarkan, dan jika sebahagian daripada data sudah ada
disandarkan dalam fail lain, data itu digunakan semula.

Tempat di mana data yang disandarkan diletakkan dipanggil repositori sandaran. Sebuah repositori
mungkin, sebagai contoh, direktori pada pelayan sftp, atau direktori pada cakera keras USB. A
repositori tunggal mungkin mengandungi sandaran daripada beberapa pelanggan. Data mereka akan bercampur
seolah-olah mereka menggunakan repositori berasingan, tetapi jika satu pelanggan menyandarkan fail, yang lain
boleh menggunakan semula data tersebut.

obnam sintaks baris arahan terdiri daripada a arahan mungkin diikuti dengan hujah. The
arahan adalah senarai di bawah.

· sandaran membuat sandaran baharu. Kali pertama ia dijalankan, ia membuat sandaran penuh, selepas
bahawa satu tambahan.

· memulihkan adalah bertentangan dengan sandaran. Ia menyalin data yang disandarkan daripada sandaran
repositori ke direktori sasaran. Anda boleh memulihkan segala-galanya dalam satu generasi, atau
hanya fail yang dipilih.

· pelanggan menyenaraikan pelanggan yang disandarkan ke repositori.

· generasi menyenaraikan setiap generasi sandaran untuk klien tertentu, serta beberapa metadata
mengenai generasi.

· genid menyenaraikan pengecam untuk setiap generasi sandaran untuk klien tertentu. Tidak
maklumat lain ditunjukkan. Ini boleh berguna untuk skrip.

· ls menyenaraikan kandungan generasi tertentu, serupa dengan ls -lAR.

· kdirstat menyenaraikan kandungan generasi tertentu, dalam format yang serasi
dengan kdirstat format fail cache, yang kemudiannya boleh digunakan untuk memvisualisasikan
kandungan sandaran.

· mengesahkan membandingkan data dalam sandaran dengan data pengguna sebenar dan memastikan ia adalah
sama. Ia adalah paling berguna untuk dijalankan serta-merta selepas sandaran, untuk menyemak sama ada ia
sebenarnya bekerja. Ia boleh dijalankan pada bila-bila masa, tetapi jika data pengguna telah berubah,
pengesahan gagal walaupun sandaran OK.

· lupa mengalih keluar generasi sandaran yang tidak lagi dikehendaki, supaya mereka tidak menggunakannya
ruang cakera. Ambil perhatian bahawa selepas penjanaan sandaran dialih keluar, data tidak boleh
dipulihkan lagi. Anda boleh sama ada menentukan generasi untuk dialih keluar dengan menyenaraikannya
pada baris arahan, atau gunakan --simpan pilihan untuk menentukan dasar untuk perkara yang perlu disimpan
(semua yang lain akan dialih keluar).

· fsck menyemak ketekalan dalaman repositori sandaran. Ia mengesahkan itu
semua pelanggan, generasi, direktori, fail dan semua kandungan fail masih wujud
repositori sandaran. Ia mungkin mengambil masa yang agak lama untuk dijalankan.

· kunci paksa mengalih keluar fail kunci untuk klien dalam repositori. Anda sepatutnya
paksa kunci jika anda pasti tiada sesiapa yang mengakses data pelanggan itu dalam
repositori. Kunci berjuntai mungkin berlaku, contohnya, jika obnam kehilangan rangkaiannya
sambungan ke repositori sandaran.

· kunci pelanggan menyenaraikan kunci penyulitan yang dikaitkan dengan setiap pelanggan.

· kekunci senarai menyenaraikan kunci yang boleh mengakses repositori, dan peringkat atas yang mana
direktori yang boleh diakses oleh setiap kunci. Beberapa direktori peringkat atas dikongsi
antara pelanggan, yang lain adalah khusus untuk pelanggan.

· senarai-peringkat atas adalah seperti kekunci senarai, tetapi menyenaraikan peringkat teratas dan kunci yang boleh diakses
Mereka.

· kunci tambah menambah kunci penyulitan pada repositori. Secara lalai, kunci ditambah
hanya pada direktori peringkat atas yang dikongsi, tetapi ia juga boleh ditambah kepada khusus
klien: senaraikan nama pelanggan pada baris arahan. Mereka kunci diberikan dengan
yang --keyid pilihan. Sesiapa sahaja yang mempunyai akses kepada kunci rahsia yang sepadan dengan kunci itu
id boleh mengakses repositori sandaran (peringkat teratas yang dikongsi serta pelanggan yang ditentukan).

· keluarkan-kunci mengalih keluar kunci daripada direktori peringkat atas yang dikongsi, serta mana-mana pelanggan
dinyatakan pada baris arahan.

· nagios-last-backup-age ialah semakan yang keluar dengan pulangan bukan sifar jika umur sandaran
melebihi ambang tertentu. Ia sesuai digunakan sebagai pemalam semak untuk nagios.
Ambang boleh diberikan --amaran-umur and --usia kritikal pilihan.

· diff membandingkan dua generasi dan menyenaraikan fail yang berbeza antara mereka. Setiap keluaran
baris akan diawali sama ada dengan tanda tambah (+) untuk fail yang telah ditambahkan, tolak
tanda (-) untuk fail yang telah dialih keluar atau tanda bintang (*) untuk fail yang telah
berubah. Jika hanya satu ID generasi ditentukan pada baris arahan itu
generasi akan dibandingkan dengan pendahulu langsungnya. Jika dua ID telah
ditentukan, semua perubahan antara dua generasi tersebut akan disenaraikan.

· mount menjadikan repositori sandaran tersedia melalui sistem fail FUSE baca sahaja. setiap satu
penjanaan sandaran kelihatan sebagai subdirektori, dinamakan sempena id penjanaan.
Ini bermakna anda boleh melihat data yang disandarkan menggunakan alat biasa, seperti fail GUI anda
pengurus, atau alat baris arahan seperti ls(1), diff(1), dan cp(1). Anda tidak boleh membuat
sandaran baharu dengan subperintah pelekap, tetapi anda boleh memulihkan data dengan mudah.

Anda perlu mempunyai utiliti FUSE dan mempunyai kebenaran untuk menggunakan FUSE untuk ini
kerja. Butiran akan berbeza antara sistem pengendalian; dalam Debian, pasangkan
pakej fius dan tambahkan diri anda pada fius kumpulan (anda mungkin perlu log keluar dan kembali
masuk semula).

Membuat sandaran
Apabila anda menjalankan sandaran, obnam memuat naik data ke dalam repositori sandaran. Data dibahagikan
menjadi ketulan, dan jika ketulan sudah wujud dalam repositori sandaran, ia tidak dimuat naik
sekali lagi. Ini membenarkan obnam untuk menangani fail yang telah ditukar atau dinamakan semula sejak
larian sandaran sebelumnya. Ia juga membenarkan beberapa pelanggan sandaran untuk mengelakkan memuat naik yang sama
data. Jika, sebagai contoh, semua orang di pejabat mempunyai salinan risalah jualan yang sama,
hanya satu salinan perlu disimpan dalam repositori sandaran.

Setiap larian sandaran ialah a generasi. Sebagai tambahan, obnam akan membuat pemeriksaan generasi
kadang kala. Ini sama seperti generasi biasa, tetapi tidak dijamin
menjadi gambaran lengkap data langsung. Jika larian sandaran perlu dihentikan dalam
tengah, larian sandaran seterusnya boleh diteruskan dari pusat pemeriksaan terkini, mengelakkan keperluan untuk
mula semula dari awal.

Jika satu larian sandaran menjatuhkan direktori akar sandaran, generasi lama masih akan menyimpannya:
tiada perubahan pada generasi lama hanya kerana ada yang baru. Jika akarnya adalah
tersalah jatuh, ia boleh ditambah semula dan larian sandaran seterusnya akan menggunakan semula yang sedia ada
data dalam repositori sandaran, dan hanya akan menyandarkan metadata fail (nama fail,
kebenaran, dsb).

Mengesahkan sandaran
Apa gunanya sistem sandaran yang anda tidak boleh harapkan? Bagaimana anda boleh bergantung pada sesuatu yang anda tidak boleh
ujian? The obnam mengesahkan arahan menyemak bahawa data dalam repositori sandaran sepadan dengan sebenar
Data pengguna. Ia mendapatkan semula satu atau lebih fail dari repositori dan membandingkannya dengan fail
Data pengguna. Ini pada asasnya sama seperti melakukan pemulihan, kemudian membandingkan fail yang dipulihkan
dengan fail asal menggunakan cmp(1), tetapi lebih mudah digunakan.

Secara lalai, pengesahan berlaku pada semua fail. Anda juga boleh menentukan fail untuk menjadi
disahkan dengan menyenaraikannya pada baris arahan. Anda harus menentukan laluan penuh ke
fail, bukan relatif kepada direktori semasa.

Output menyenaraikan fail yang gagal pengesahan atas sebab tertentu. Jika anda mengesahkan segala-galanya,
berkemungkinan beberapa fail (cth., direktori induk akar sandaran) mungkin telah berubah
tanpa ia menjadi masalah. Ambil perhatian bahawa anda perlu menentukan keseluruhan laluan ke
fail atau direktori untuk disahkan, bukan relatif kepada akar sandaran. Anda masih perlu
tentukan sekurang-kurangnya satu daripada akar sandaran pada baris arahan atau melalui --akar pilihan begitu
obnam itu akan mencari sistem fail, sekiranya ia adalah sistem jauh.

URL sintaks
Setiap kali obnam menerima URL, ia boleh sama ada nama laluan setempat atau nama laluan sftp URL. Satu sftp
URL mempunyai bentuk berikut:

sftp: //[pengguna@]domain[:pelabuhan]/jalan

di mana domain ialah nama domain Internet biasa untuk pelayan, pengguna adalah nama pengguna anda pada itu
pelayan, pelabuhan ialah nombor port pilihan, dan jalan ialah nama laluan pada bahagian pelayan. Suka
bzr(1), tetapi tidak seperti standard URL sftp, nama laluan adalah mutlak, melainkan ia bermula dengan
/~/ dalam hal ini ia adalah relatif kepada direktori rumah pengguna pada pelayan.

Lihat bahagian CONTOH untuk contoh URL.

Anda boleh menggunakan sftp URL untuk repositori, atau data langsung (root), tetapi ambil perhatian bahawa disebabkan oleh
batasan dalam protokol, dan pelaksanaannya dalam paramiko perpustakaan, beberapa perkara
tidak akan berfungsi dengan baik untuk mengakses data langsung sftp. Paling penting, pengendalian
daripada pautan keras agak tidak optimum. Untuk akses data langsung, anda tidak seharusnya menamatkan URL
bersama /~/ dan harus menambahkan titik pada penghujung dalam kes khas ini.

Generasi spesifikasi
Apabila tidak menggunakan generasi terkini, anda perlu menentukan yang mana yang anda perlukan. ini
akan dilakukan dengan --generasi pilihan, yang mengambil spesifikasi generasi sebagai pilihannya
hujah. Spesifikasinya sama ada perkataan Terkini, maksudnya generasi terkini
(juga lalai), atau nombor. Lihat generasi perintah untuk melihat apakah generasi itu
tersedia, dan bilangan mereka.

Dasar Untuk menjaga and mengeluarkan sandaran generasi
. lupa arahan boleh mengikut dasar untuk menyimpan beberapa secara automatik dan mengalih keluar sandaran lain
generasi. Dasar ditetapkan dengan --simpan=DASAR pilihan.

DASAR ialah senarai peraturan yang dipisahkan koma. Setiap peraturan terdiri daripada kiraan dan tempoh masa.
Tempoh masa adalah h, d, w, m, dan y, untuk jam, hari, minggu, bulan dan tahun.

Satu dasar daripada 30d bermakna menyimpan sandaran terkini untuk setiap hari apabila sandaran dibuat, dan
simpan 30 sandaran terakhir tersebut. Sebarang sandaran yang dipadankan dengan mana-mana peraturan dasar disimpan, dan mana-mana
sandaran di antaranya akan dialih keluar, begitu juga dengan mana-mana sandaran yang lebih lama daripada sandaran tertua yang disimpan.

Sebagai contoh, andaikan sandaran diambil setiap jam, pada jam: pada 00:00, 01:00, 02:00,
dan seterusnya, sehingga jam 23:00. Sekiranya lupa arahan dijalankan pada 23:15, dengan dasar di atas, ia
akan menyimpan sandaran diambil pada jam 23:00 pada setiap hari, dan mengalih keluar setiap sandaran lain pada hari itu.
Ia juga akan mengalih keluar sandaran yang lebih lama daripada 30 hari.

Jika sandaran dibuat setiap hari, pada tengah hari, lupa akan menyimpan 30 sandaran terakhir, atau 60
sandaran bernilai hari, dengan dasar di atas.

Ambil perhatian bahawa obnam hanya akan memeriksa cap masa dalam repositori sandaran, dan tidak peduli
apakah masa semasa yang sebenar. Ini bermakna jika anda berhenti membuat sandaran baharu, fail
yang sedia ada tidak akan dialih keluar secara automatik. Pada dasarnya, obnam berpura-pura masa semasa
hanya selepas sandaran terkini apabila lupa dijalankan.

Peraturan boleh diberikan dalam sebarang susunan, tetapi akan diisih mengikut urutan menaik tempoh masa
sebelum digunakan. (Adalah ralat untuk memberikan dua peraturan untuk tempoh yang sama.) Sandaran
generasi disimpan jika ia sepadan dengan mana-mana peraturan.

Sebagai contoh, anggap kekerapan sandaran yang sama seperti di atas, tetapi dasar 30h,52w. ini
akan menyimpan sandaran harian terbaharu untuk setiap hari selama tiga puluh hari, and mingguan terbaru
sandaran selama 52 minggu. Kerana sandaran setiap jam akan dialih keluar setiap hari, sebelum mereka mempunyai a
peluang untuk diselamatkan oleh peraturan mingguan, kesannya ialah sandaran jam 23:00 untuk setiap
hari disimpan selama sebulan, dan sandaran 23:00 pada hari Ahad disimpan selama setahun.

Jika, sebaliknya, anda menggunakan dasar bagi 72j,30h,52w, obnam akan menyimpan sandaran 72 jam terakhir,
dan sandaran terakhir setiap hari kalendar selama 30 hari, dan sandaran terakhir setiap kalendar
minggu selama 52 minggu. Jika kekerapan sandaran adalah sekali sehari, obnam akan menyimpan sandaran
setiap jam kalendar yang mana sandaran dibuat, untuk 72 sandaran tersebut. Dalam kata lain,
ia berkesan akan menyimpan 72 sandaran harian terakhir.

Bunyi mengelirukan? Fikirkan betapa kelirunya pembangun semasa menulis kod.

Jika tiada polisi diberikan, lupa akan menyimpan segala-galanya.

Dasar biasa mungkin 72j,7h,5w,12m, yang bermaksud: simpan sandaran 72 jam terakhir, yang
7 sandaran harian terakhir, 5 sandaran mingguan terakhir dan 12 sandaran bulanan terakhir. Sekiranya
sandaran dijalankan secara sistematik setiap jam, ini bermakna menyimpan sandaran setiap jam
selama tiga hari, sandaran harian selama seminggu, sandaran mingguan selama sebulan dan sandaran bulanan
untuk setahun.

Cara dasar itu berfungsi agak rumit. Lari lupa dengan --berpura-pura pilihan untuk
pastikan anda mengalih keluar yang betul.

Menggunakan penyulitan
obnam boleh menyulitkan semua data yang ditulisnya ke repositori sandaran. Ia menggunakan gpg(1) melakukan
penyulitan itu. Anda perlu mencipta pasangan kunci menggunakan gpg --gen-key (atau gunakan yang sedia ada
satu), dan kemudian beritahu obnam mengenainya menggunakan --encrypt-dengan pilihan. Anda boleh secara pilihan
gunakan direktori rumah yang berasingan menggunakan --gnupghome pilihan. Secara lalai, lalai
direktori untuk gpg(1) akan digunakan.

konfigurasi fail
obnam akan mencari fail konfigurasi di beberapa lokasi. Lihat bahagian FAIL
untuk senarai. Semua fail ini bersama-sama dianggap sebagai satu fail besar dengan kandungan semua
fail bercantum.

Fail adalah dalam format INI, dan hanya fail [konfigurasi] bahagian digunakan (mana-mana bahagian lain adalah
diabaikan).

Nama panjang pilihan digunakan sebagai kunci untuk pembolehubah konfigurasi. Mana-mana tetapan itu
boleh ditetapkan daripada baris arahan boleh ditetapkan dalam fail konfigurasi, dalam [konfigurasi]
bawah seksyen ini.

Sebagai contoh, pilihan dalam baris arahan berikut:

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

boleh digantikan dengan fail konfigurasi berikut:

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

(Anda boleh menggunakan sama ada foo=nilai or foo: nilai sintaks dalam fail.)

Satu-satunya perkara yang luar biasa tentang fail ialah cara pilihan yang boleh digunakan berkali-kali
diluahkan. Semua nilai diletakkan dalam satu baris logik, dipisahkan dengan koma (dan
ruang pilihan juga). Sebagai contoh:

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

Di atas mempunyai tiga nilai untuk tidak termasuk pilihan: mana-mana fail yang mengandungi perkataan foo or
bar mana-mana sahaja dalam nama laluan yang layak sepenuhnya, atau fail dengan nama yang berakhir dengan noktah dan
mp3 (kerana pengecualian adalah ungkapan biasa).

Garis logik yang panjang boleh dipecahkan kepada beberapa baris fizikal, dengan memulakan baris baharu di
ruang putih, dan inden garis kesinambungan:

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

Contoh di atas menambah tiga corak pengecualian.

Pelbagai pelanggan and pengunci
obnam menyokong perkongsian repositori antara berbilang pelanggan. Pelanggan boleh berkongsi
kandungan fail (ketulan), supaya jika klien A menyandarkan fail besar, dan klien B mempunyai fail
fail yang sama, maka B tidak perlu memuat naik fail besar ke repositori untuk kali kedua.
Untuk ini berfungsi tanpa kekeliruan, pelanggan menggunakan protokol penguncian mudah yang membenarkan
hanya satu pelanggan pada satu masa untuk mengubah suai struktur data yang dikongsi. Kunci tidak menghalang
akses baca sahaja pada masa yang sama: ini membolehkan anda memulihkan semasa orang lain berada
membuat sandaran.

Kadangkala operasi baca sahaja berlaku untuk mengakses struktur data pada masa yang sama dengannya
sedang diubah suai. Ini boleh mengakibatkan kemalangan. Ia tidak akan mengakibatkan data rosak, atau
pemulihan yang salah. Walau bagaimanapun, anda mungkin perlu memulakan semula operasi baca sahaja selepas a
kemalangan.

PILIHAN

--sentiasa-pulihkan-setuid
pulihkan bit setuid/setgid dalam fail yang dipulihkan, walaupun jika bukan fail root atau sandaran
mempunyai pemilik yang berbeza daripada pengguna yang menjalankan pemulihan

--tidak-selalu-pulihkan-setuid
bertentangan dengan --always-restore-setuid

--nama pelanggan=NAMA PELANGGAN
nama pelanggan (lalai kepada nama hos)

--mampat-dengan=PROGRAM
gunakan PROGRAM untuk memampatkan repositori dengan (salah satu daripada tiada, kempis)

--usia kritikal=UMUR
untuk nagios-last-backup-age: umur maksimum (secara lalai dalam jam) untuk yang paling terkini
sandaran sebelum statistik adalah kritikal. Menerima satu penentu unit aksara (s,m,h,d untuk
saat, minit, jam dan hari.

--dump-repo-file-metadata
buang metadata tentang fail?

--no-dump-repo-file-metadata
bertentangan dengan --dump-repo-file-metadata

--generate-manpage=TEMPLAT
MENENTANG

--generasi=GENERASI
generasi mana yang hendak dipulihkan

-h, - membantu
tunjukkan mesej bantuan ini dan keluar

--simpan=KEEP
dasar untuk generasi apa yang perlu dipelihara apabila terlupa

--kunci-masa tamat=MASA TAMAT
apabila mengunci dalam repositori sandaran, tunggu TIMEOUT saat untuk kunci sedia ada
pergi sebelum berputus asa

--pengeluaran=FAIL
tulis output ke FILE, bukannya output standard

--berpura-pura, --lari kering, --tidak-bertindak
sebenarnya tidak mengubah apa-apa (berfungsi dengan sandaran, lupa dan pulihkan sahaja, dan
hanya boleh mensimulasikan kira-kira tingkah laku sebenar)

--tidak-berpura-pura, --tiada-dry-run, --tidak-tidak-bertindak
bertentangan dengan --berpura-pura

--senyap, --senyap
senyap: tunjukkan hanya mesej ralat, tiada kemas kini kemajuan

--tidak-tenang, --tidak-senyap
bertentangan dengan --tenang

-r, --repositori=URL
nama repositori sandaran (boleh menjadi nama laluan atau URL yang disokong)

--format-repositori=FORMAT
gunakan FORMAT untuk repositori baharu; salah satu daripada "6", "albatros hijau"

--kepada=KEPADA
tempat untuk memulihkan atau memasang FUSE; untuk pemulihan, mesti kosong atau tidak boleh wujud

--verbose
beverbose: beritahu pengguna lebih lanjut tentang perkara yang sedang berlaku dan secara amnya pastikan pengguna
menyedari apa yang berlaku atau sekurang-kurangnya sesuatu sedang berlaku dan juga membuat
pasti skrin mereka mendapat kemas kini dengan kerap dan terdapat perubahan yang berlaku
sepanjang masa supaya mereka tidak bosan dan mereka sebenarnya kecewa
terganggu oleh begitu banyak kemas kini yang mereka akan berpindah ke padang pasir Gobi
tinggal di bawah batu

--tidak bertele-tele
bertentangan dengan --verbose

--sahkan-secara rawak=N
sahkan N fail secara rawak dari sandaran (lalai ialah sifar, bermakna segala-galanya)

--versi
tunjukkan nombor versi program dan keluar

--amaran-umur=UMUR
untuk nagios-last-backup-age: umur maksimum (secara lalai dalam jam) untuk yang paling terkini
sandaran sebelum status adalah amaran. Menerima satu penentu unit aksara (s,m,h,d untuk
saat, minit, jam dan hari.

Backing up
--pusat pemeriksaan=SAIZ
buat checkpoint selepas SAIZ yang diberikan

--penduakan=MODE
cari data pendua dalam data yang disandarkan dan simpan sekali sahaja; tiga mod adalah
tersedia: jangan sekali-kali menyahgandakan, sahkan bahawa tiada perlanggaran cincang berlaku, atau (the
lalai) menerima secara fatal risiko perlanggaran

--kecualikan=KECUALI
ungkapan biasa untuk nama laluan untuk dikecualikan daripada sandaran (boleh digunakan berbilang
kali)

--kecualikan-cache
kecualikan direktori (dan subdirnya) yang mengandungi fail CACHEDIR.TAG (lihat
http://www.brynosaurus.com/cachedir/spec.html untuk apa yang perlu terkandung di dalamnya, dan
http://liw.fi/cachedir/ untuk alat pembantu)

--tiada-kecuali-cache
bertentangan dengan --exclude-caches

--kecualikan-daripada=FAIL
baca mengecualikan corak daripada FILE

--termasuk=TERMASUK
ungkapan biasa untuk nama laluan disertakan daripada sandaran walaupun ia sepadan dengan
kecualikan peraturan (boleh digunakan beberapa kali)

--meninggalkan-tempat pemeriksaan
meninggalkan generasi pusat pemeriksaan pada penghujung larian sandaran yang berjaya

--tiada-cuti-tempat pemeriksaan
bertentangan dengan --cuti-checkpoints

--satu-sistem-fail
tidak termasuk direktori (dan subdirnya) yang berada dalam sistem fail yang berbeza

--tiada-satu-sistem-fail
bertentangan dengan --one-file-system

--akar=URL
apa yang hendak disandarkan

--fail-kecil-dalam-btree
ini tersedia hanya untuk keserasian ke belakang; jangan gunakannya, dan keluarkannya
daripada konfigurasi anda

--tiada-fail-kecil-dalam-btree
bertentangan dengan --small-files-in-btree

konfigurasi fail and tetapan
--config=FAIL
tambah FILE untuk mengkonfigurasi fail

--dump-config
tulis keseluruhan konfigurasi semasa

--dump-setting-namas
MENENTANG

--bantu-semua
tunjukkan semua pilihan

--list-config-files
MENENTANG

--no-default-configs
senarai fail konfigurasi yang jelas untuk dibaca

pembangunan of Obnam sendiri
--had-crash=KAUNTER
ranap program secara buatan selepas fail COUNTER ditulis ke repositori; ini
berguna untuk ujian ranap aplikasi dan tidak seharusnya didayakan secara nyata
penggunaan; ditetapkan kepada 0 untuk melumpuhkan (dilumpuhkan secara lalai)

--masa berpura-pura=STAMP MASA
berpura-pura ia adalah TIMESTAMP (YYYY-MM-DD HH:MM:SS); ini hanya berguna untuk ujian
tujuan

--sftp-delay=SFTP-KELEWATAN
tambahkan kelewatan buatan (dalam milisaat) pada semua pemindahan SFTP

--pengujian-gagal-padanan=REGEXP
pembantu ujian pembangunan: simulasi kegagalan semasa sandaran untuk fail yang sepadan
ungkapan biasa yang diberikan

--jejak=TRACE
tambahkan pada patters nama fail yang pengelogan penyahpepijatan surih berlaku

Penyulitan
--encrypt-dengan=ENCRIPT-DENGAN
Kunci PGP untuk menyulitkan data dalam repositori sandaran

--gnupghome=HOMEDIR
direktori rumah untuk GPG

--butiran kunci
tunjukkan ID pengguna tambahan untuk semua kunci

--tiada-kunci-butiran
bertentangan dengan --key-details

--keyid=KEYID
Id kunci PGP untuk menambah/mengalih keluar daripada repositori sandaran

--symmetric-key-bits=BITS
saiz kunci simetri, dalam bit

--lemah-rawak
gunakan /dev/urandom dan bukannya /dev/random untuk menjana kunci simetri

--tidak-lemah-rawak
bertentangan dengan --lemah-rawak

Integriti memeriksa (fsck)
--fsck-fix
patutkah fsck cuba menyelesaikan masalah? Menyiratkan --fsck-rm-unused

--no-fsck-fix
bertentangan dengan --fsck-fix

--fsck-ignore-chunks
abaikan ketulan semasa menyemak integriti repositori (andaikan semua ketulan wujud dan ada
betul)

--no-fsck-ignore-chunks
bertentangan dengan --fsck-ignore-chunks

--fsck-ignore-client=NAMA
jangan semak data repositori untuk NAMA cient

--fsck-generasi-terakhir-sahaja
semak hanya generasi terakhir untuk setiap pelanggan

--no-fsck-terakhir-generasi-sahaja
bertentangan dengan --fsck-terakhir-generasi-sahaja

--fsck-rm-tidak digunakan
patutkah fsck membuang ketulan yang tidak digunakan?

--no-fsck-rm-unused
bertentangan dengan --fsck-rm-unused

--fsck-skip-checksums
jangan semak jumlah semak fail

--no-fsck-skip-checksums
bertentangan dengan --fsck-skip-checksums

--fsck-skip-dirs
jangan semak apa-apa tentang direktori dan fail mereka

--no-fsck-skip-dirs
bertentangan dengan --fsck-skip-dirs

--fsck-skip-files
jangan semak apa-apa tentang fail

--no-fsck-skip-files
bertentangan dengan --fsck-skip-files

--fsck-skip-generations
jangan periksa mana-mana generasi

--no-fsck-skip-generations
bertentangan dengan --fsck-skip-generations

--fsck-skip-per-client-b-trees
jangan semak setiap pelanggan B-pokok

--no-fsck-skip-per-client-b-trees
bertentangan dengan --fsck-skip-per-client-b-trees

--fsck-skip-shared-b-trees
jangan semak pokok B yang dikongsi

--no-fsck-skip-shared-b-trees
bertentangan dengan --fsck-skip-shared-b-trees

Pembalakan
--log=FAIL
tulis entri log ke FILE (lalai adalah untuk tidak menulis fail log sama sekali); gunakan "syslog"
untuk log masuk ke log sistem, "stderr" untuk log ke output ralat standard, atau "tiada" ke
lumpuhkan pembalakan

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

--peringkat-log=LEVEL
log di LEVEL, salah satu nyahpepijat, maklumat, amaran, ralat, kritikal, maut (lalai: maklumat)

--log-maks=SAIZ
putar log lebih besar daripada SIZE, sifar untuk tidak pernah (lalai: 0)

--mod-log=MODE
tetapkan kebenaran fail log baharu kepada MODE (oktal; lalai 0600)

Mounting bersama FIUS
--fius-opt=FIUS
pilihan untuk dihantar terus ke Fius

Prestasi
--buang-memori-profil=KAEDAH
buat pembuangan pemprofilan memori menggunakan METHOD, iaitu salah satu daripada: tiada, mudah atau meliae
(lalai: mudah)

--memory-dump-interval=SEKIAN
jadikan pembuangan pemprofilan memori sekurang-kurangnya SECONDS

prestasi tweak
--saiz ketul=SAIZ
saiz ketulan data fail yang disandarkan

--chunkids-per-kumpulan=NUM
mengekod NUM id ketulan setiap kumpulan

--idpath-bits=IDPATH-BITS
saiz tahap id ketulan

--idpath-depth=IDPATH-DEPTH
kedalaman pemetaan id ketulan

--idpath-langkau=IDPATH-SKIP
chunk id pemetaan bit terendah langkau

--saiz-lru=SAIZ
saiz cache LRU untuk nod B-tree

--saiz nod=SAIZ
saiz nod B-tree pada cakera; hanya menjejaskan pokok-B baharu jadi anda mungkin perlu memadamkan a
klien atau repositori untuk menukar ini untuk repositori sedia ada

--muat naik-saiz baris gilir=SAIZ
panjang baris gilir muat naik untuk nod B-tree

Repositori format albatros hijau
--saiz beg ketul=SAIZ
anggaran saiz maksimum beg yang menggabungkan banyak objek bongkah

--saiz-cache-chunk=SAIZ
saiz cache dalam memori untuk objek ketulan data fail

--saiz-beg-dir=SAIZ
anggaran imej saiz maksimum beg yang menggabungkan banyak objek DIR

--saiz-dir-cache=SAIZ
saiz cache dalam memori untuk objek DIR

SSH/SFTP
--paramiko tulen
jangan gunakan openssh walaupun ada, gunakan paramiko sahaja

--tiada-paramiko-tulen
bertentangan dengan --pure-paramiko

--ssh-arahan=BOLEH DILAKSANAKAN
boleh laku alternatif untuk digunakan dan bukannya "ssh" (laluan penuh dibenarkan, tidak
hujah boleh ditambah)

--ssh-host-keys-check=NILAI
Jika "ya", memerlukan kunci hos ssh mesti diketahui dan betul untuk diterima.
Jika "tidak", tidak memerlukan itu. Jika "tanya", pengguna diminta secara interaktif untuk menerima
hos baharu. Lalai ("ssh-config") adalah bergantung pada tetapan asas
Pelanggan SSH

--ssh-key=NAMA FAIL
gunakan FILENAME sebagai kunci peribadi ssh RSA untuk akses sftp (lalai menggunakan kekunci
dikenali ssh-agent)

--ssh-known-hosts=NAMA FAIL
nama fail fail hos yang diketahui pengguna

--strict-ssh-host-keys
TIDAK TERUS, gunakan --ssh-host-keys-check sebaliknya

--no-strict-ssh-host-keys
bertentangan dengan --strict-ssh-host-keys

Lebih Baik nilai
. SAIZ nilai dalam pilihan yang disebutkan di atas menentukan saiz dalam bait, dengan pilihan
akhiran untuk menunjukkan kilobait (k), kibibait (Ki), megabait (M), mebibait (Mi),
gigabait (G), gibibait (Gi), terabait (T), tibibait (Ti). Imbuhan adalah huruf kecil-
tidak peka.

EXIT STATUS

obnam akan keluar dengan sifar jika semuanya berjalan lancar, dan bukan sifar sebaliknya.

PERSEKITARAN

obnam akan meneruskan persekitaran yang diperolehi daripada induknya, tanpa pengubahsuaian. Ia berlaku
tidak mematuhi sebarang pembolehubah persekitaran yang luar biasa, tetapi ia mematuhi yang biasa apabila berjalan
program luaran, mencipta fail sementara, dsb.

Gunakan obnam dalam talian menggunakan perkhidmatan onworks.net