obnam - Online sa Cloud

PROGRAMA:

NAME

obnam - gumawa, ibalik, at manipulahin ang mga backup

SINOPSIS

obnam [--laging-ibalik-setuid] [--hindi-palaging-ibalik-setuid] [--checkpoint=SIZE]
[--chunk-bag-size=SIZE] [--chunk-cache-size=SIZE] [--laki ng tipak=SIZE]
[--chunkids-per-group=NUM] [--Pangalan ng kliyente=PANGALAN NG KLIYENTE] [--compress-with=PROGRAMA]
[--config=FILE] [--dump-config] [--dump-setting-pangalan] [--generate-manpage=TEMPLATE] [-h]
[- Tumulong] [--tulong-lahat] [--list-config-files] [--bersyon] [--no-default-configs]
[--crash-limit=COUNTER] [--kritikal na edad=AGE] [--deduplicate=MODE] [--dir-bag-laki=SIZE]
[--dir-cache-size=SIZE] [--dump-memory-profile=Pamamaraan] [--dump-repo-file-metadata]
[--no-dump-repo-file-metadata] [--encrypt-with=ENCRYPT-WITH] [--ibukod=HALIMBAWA]
[--exclude-caches] [--no-exclude-cache] [--bukod-sa=FILE] [--fsck-fix]
[--no-fsck-fix] [--fsck-ignore-chunks] [--no-fsck-ignore-chunks]
[--fsck-ignore-client=NAME] [--fsck-last-generation-only] [--no-fsck-last-generation-only]
[--fsck-rm-hindi nagamit] [--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] [--fuse-opt=Piyus]
[--generation=GENERATION] [--gnupghome=HOMEDIR] [--idpath-bits=IDPATH-BITS]
[--idpath-depth=IDPATH-DEPTH] [--idpath-skip=IDPATH-SKIP] [--isama=MAISASALI]
[--panatilihin=PANATILIHING] [--key-detalye] [--walang-susi-mga detalye] [--keyid=KEYID] [--umalis-mga checkpoint]
[--walang-leave-checkpoints] [--lock-timeout=TIMEOUT] [--log=FILE] [--log-panatilihin=N]
[--log-level=ANTAS] [--log-max=SIZE] [--log-mode=MODE] [--lru-size=SIZE]
[--memory-dump-interval=SECONDS] [--laki ng node=SIZE] [--isang-file-system]
[--walang-isang-file-system] [--output=FILE] [--kunwari] [--dry-run] [--walang-kilos] [--hindi-kunwari]
[--walang-dry-run] [--no-no-act] [--kunwari-oras=TIMESTAMP] [--pure-paramiko]
[--walang-pure-paramiko] [--tahimik] [--tahimik] [--walang-tahimik] [--walang-tahimik] [-rURL]
[--imbakan=URL] [--repository-format=FORMAT] [--ugat=URL] [--sftp-antala=SFTP-DELAY]
[--maliit na mga file-sa-btree] [--no-small-files-in-btree] [--ssh-utos=MAAABOT]
[--ssh-host-keys-check=VALUE] [--ssh-key=FILENAME] [--ssh-kilalang-host=FILENAME]
[--strict-ssh-host-keys] [--no-strict-ssh-host-keys] [--symmetric-key-bits=BITS]
[--testing-fail-matching=REGEXP] [--sa=SA] [--bakas=TRACE] [--upload-queue-size=SIZE]
[--verbose] [--no-verbose] [--verify-randomly=N] [--warning-edad=AGE] [--mahina-random]
[--walang-mahina-random]

obnam [pagpipilian] _lock
obnam [pagpipilian] add-key [PAKIKITA-NAME] ...
obnam [pagpipilian] backup [DIRECTORY|URL] ...
obnam [pagpipilian] mga client-key
obnam [pagpipilian] mga kliyente
obnam [pagpipilian] pagkakaiba [GENERATION1]GENERATION2
obnam [pagpipilian] dump-repo
obnam [pagpipilian] puwersa-lock
obnam [pagpipilian] kalimutan [GENERATION] ...
obnam [pagpipilian] fsck
obnam [pagpipilian] mga henerasyon
obnam [pagpipilian] mga genid
obnam [pagpipilian] tulong
obnam [pagpipilian] tulong-lahat
obnam [pagpipilian] kdirstat [FILE] ...
obnam [pagpipilian] list-errors
obnam [pagpipilian] mga format ng listahan
obnam [pagpipilian] list-key
obnam [pagpipilian] list-toplevels
obnam [pagpipilian] ls [FILE] ...
obnam [pagpipilian] bundok [Ugat]
obnam [pagpipilian] nagios-last-backup-age
obnam [pagpipilian] alisin-kliyente [PAKIKITA-NAME] ...
obnam [pagpipilian] remove-key [PAKIKITA-NAME] ...
obnam [pagpipilian] ibalik [DIRECTORY] ...
obnam [pagpipilian] i-verify [DIRECTORY] ...

DESCRIPTION

obnam gumagawa, nagpapanumbalik, nagmamanipula, at kung hindi man ay nakikitungo sa mga backup. Maaari itong mag-imbak
backup sa isang lokal na disk o sa isang server sa pamamagitan ng sftp. Ang bawat backup na henerasyon ay mukhang isang
bagong snapshot, ngunit talagang incremental: ang user ay hindi kailangang mag-alala kung ito ay a
buong backup o hindi. Ang binagong data lang ang naba-back up, at kung mayroon nang isang bahagi ng data
na-back up sa isa pang file, ang data na iyon ay muling ginagamit.

Ang lugar kung saan inilalagay ang naka-back up na data ay tinatawag na backup na imbakan. Isang imbakan
maaaring, halimbawa, isang direktoryo sa isang sftp server, o isang direktoryo sa isang USB hard disk. A
Ang isang imbakan ay maaaring maglaman ng mga backup mula sa ilang mga kliyente. Maghahalo ang kanilang data
na parang gumagamit sila ng hiwalay na mga repository, ngunit kung ang isang kliyente ay nagba-back up ng isang file, ang iba
maaaring muling gamitin ang data.

obnam Ang command line syntax ay binubuo ng a utos posibleng sinundan ng mga argumento. Ang
Ang mga utos ay nakalista sa ibaba.

· backup gumagawa ng bagong backup. Sa unang pagkakataon na ito ay tumakbo, ito ay gumagawa ng isang buong backup, pagkatapos
na isang incremental.

· ibalik ay ang kabaligtaran ng isang backup. Kinokopya nito ang naka-back up na data mula sa backup
imbakan sa isang target na direktoryo. Maaari mong ibalik ang lahat sa isang henerasyon, o
mga napiling file lang.

· kliyente naglilista ng mga kliyente na naka-back up sa repositoryo.

· Henerasyon naglilista ng bawat backup na henerasyon para sa isang partikular na kliyente, kasama ang ilang metadata
tungkol sa henerasyon.

· mga genid naglilista ng identifier para sa bawat backup na henerasyon para sa isang partikular na kliyente. Hindi
iba pang impormasyon ang ipinapakita. Ito ay maaaring maging kapaki-pakinabang para sa scripting.

· ls naglilista ng mga nilalaman ng isang naibigay na henerasyon, katulad ng ls -lAR.

· kdirstat naglilista ng mga nilalaman ng isang naibigay na henerasyon, sa isang format na tugma
sa kdirstat cache file format, na maaaring magamit upang mailarawan ang
nilalaman ng isang backup.

· patunayan inihahambing ang data sa backup sa aktwal na data ng user, at tinitiyak na ang mga ito
magkapareho. Ito ay pinaka-kapaki-pakinabang na tumakbo kaagad pagkatapos ng isang backup, upang suriin na ito
talagang nagtrabaho. Maaari itong patakbuhin anumang oras, ngunit kung nagbago ang data ng user,
nabigo ang pag-verify kahit na OK ang backup.

· kalimutan nag-aalis ng mga backup na henerasyon na hindi na gusto, upang hindi nila magamit
espasyo sa disk. Tandaan na pagkatapos maalis ang isang backup na henerasyon ang data ay hindi maaaring
naibalik pa. Maaari mong tukuyin ang mga henerasyong aalisin sa pamamagitan ng paglilista sa kanila
sa command line, o gamitin ang --panatilihin opsyon upang tumukoy ng isang patakaran para sa kung ano ang dapat panatilihin
(lahat ng iba ay aalisin).

· fsck sinusuri ang panloob na pagkakapare-pareho ng backup na imbakan. Bine-verify nito iyon
lahat ng kliyente, henerasyon, direktoryo, file, at lahat ng nilalaman ng file ay umiiral pa rin
ang backup na imbakan. Maaaring tumagal ng medyo mahabang oras upang tumakbo.

· puwersa-lock nag-aalis ng lock file para sa isang kliyente sa repositoryo. Ikaw lang dapat
pilitin ang lock kung sigurado kang walang nag-a-access sa data ng kliyenteng iyon sa
imbakan. Maaaring mangyari ang isang nakalawit na lock, halimbawa, kung mawala ang network ng obnam
koneksyon sa backup na imbakan.

· mga susi ng kliyente naglilista ng encryption key na nauugnay sa bawat kliyente.

· mga list-key naglilista ng mga key na maaaring ma-access ang repository, at kung aling toplevel
mga direktoryo na maaaring ma-access ng bawat key. Ang ilan sa mga toplevel na direktoryo ay ibinahagi
sa pagitan ng mga kliyente, ang iba ay tiyak sa isang kliyente.

· list-toplevels ay tulad ng mga list-key, ngunit naglilista ng mga nangungunang antas at kung aling mga susi ang maaaring ma-access
Kanila.

· add-key nagdadagdag ng encryption key sa repository. Bilang default, idinagdag ang susi
sa mga shared toplevel na direktoryo lamang, ngunit maaari rin itong idagdag sa partikular
mga kliyente: ilista ang mga pangalan ng mga kliyente sa command line. Binigay ang susi nila
ang --keyid opsyon. Sinumang may access sa sikretong susi na naaayon sa susi
maa-access ng id ang backup na repository (ang mga nakabahaging toplevel at mga tinukoy na kliyente).

· alisin-susi nag-aalis ng susi mula sa mga nakabahaging direktoryo sa pinakamataas na antas, kasama ang anumang mga kliyente
tinukoy sa command line.

· nagios-last-backup-age ay isang tseke na lumalabas na may non-zero return kung isang backup na edad
lumampas sa isang tiyak na threshold. Ito ay angkop para gamitin bilang check plugin para sa nagios.
Ang mga threshold ay maaaring ibigay sa --warning-edad at --kritikal na edad mga pagpipilian.

· Diff naghahambing ng dalawang henerasyon at naglilista ng mga file na naiiba sa pagitan nila. Bawat output
Ang linya ay lagyan ng prefix alinman sa pamamagitan ng plus sign (+) para sa mga file na idinagdag, isang minus
sign (-) para sa mga file na naalis o isang asterisk (*) para sa mga file na may
nagbago. Kung isang generation ID lang ang tinukoy sa command line na
ihahambing ang henerasyon sa direktang hinalinhan nito. Kung may dalawang ID
tinukoy, lahat ng pagbabago sa pagitan ng dalawang henerasyong iyon ay ililista.

· Mount ginagawang available ang backup na repository sa pamamagitan ng read-only na FUSE filesystem. Bawat isa
Ang backup na henerasyon ay makikita bilang isang subdirectory, na pinangalanan pagkatapos ng generation id.
Nangangahulugan ito na maaari mong tingnan ang naka-back up na data gamit ang mga normal na tool, gaya ng iyong GUI file
manager, o mga tool sa command line gaya ng lsNa (1), Diff(1), at cp(1). Hindi ka makakagawa
mga bagong backup gamit ang mount subcommand, ngunit madali mong maibabalik ang data.

Kailangan mong magkaroon ng FUSE utilities at may pahintulot na gamitin ang FUSE para dito
trabaho. Mag-iiba ang mga detalye sa pagitan ng mga operating system; sa Debian, i-install ang
pakete piyus at idagdag ang iyong sarili sa piyus grupo (maaaring kailanganin mong mag-log out at bumalik
sa muli).

Paggawa pag-backup
Kapag nagpatakbo ka ng backup, obnam nag-a-upload ng data sa backup na imbakan. Ang data ay hinati
sa mga chunks, at kung mayroon nang isang tipak sa backup na imbakan, hindi ito na-upload
muli. Ito ay nagpapahintulot obnam upang harapin ang mga file na binago o pinalitan ng pangalan mula noong
nakaraang backup run. Pinapayagan din nito ang ilang mga backup na kliyente na maiwasan ang pag-upload ng pareho
datos. Kung, halimbawa, ang lahat sa opisina ay may kopya ng parehong mga brochure sa pagbebenta,
isang kopya lamang ang kailangang maimbak sa backup na imbakan.

Ang bawat backup run ay a henerasyon. At saka, obnam Gagawing checkpoint Henerasyon
paminsan-minsan. Ang mga ito ay eksaktong katulad ng mga normal na henerasyon, ngunit hindi ginagarantiyahan
maging isang kumpletong snapshot ng live na data. Kung ang backup run ay kailangang i-abort sa
gitna, ang susunod na backup run ay maaaring magpatuloy mula sa pinakabagong checkpoint, pag-iwas sa pangangailangan na
magsimula muli sa simula.

Kung ang isang backup run ay nag-drop ng isang backup na root directory, pananatilihin ito ng mga mas lumang henerasyon:
walang nagbabago sa mga lumang henerasyon dahil lang may bago. Kung ang ugat ay
nahulog nang hindi sinasadya, maaari itong idagdag pabalik at ang susunod na backup run ay muling gagamitin ang umiiral na
data sa backup na imbakan, at iba-back up lamang ang metadata ng file (mga filename,
mga pahintulot, atbp).

Pag-verify pag-backup
Ano ang silbi ng backup system na hindi mo maaasahan? Paano ka makakaasa sa isang bagay na hindi mo kaya
pagsusulit? Ang obnam patunayan sinusuri ng command na ang data sa backup na repository ay tumutugma sa aktwal
data ng gumagamit. Kinukuha nito ang isa o higit pang mga file mula sa imbakan at inihahambing ang mga ito sa
data ng gumagamit. Ito ay mahalagang kapareho ng paggawa ng isang pagpapanumbalik, pagkatapos ay paghahambing ng mga naibalik na file
gamit ang orihinal na mga file cmp(1), ngunit mas madaling gamitin.

Bilang default, nangyayari ang pag-verify sa lahat ng file. Maaari mo ring tukuyin ang mga file na magiging
na-verify sa pamamagitan ng paglilista sa kanila sa command line. Dapat mong tukuyin ang buong mga landas patungo sa
mga file, hindi nauugnay sa kasalukuyang direktoryo.

Ang output ay naglilista ng mga file na nabigo sa pag-verify para sa ilang kadahilanan. Kung patunayan mo ang lahat,
malamang na ang ilang mga file (hal., mga direktoryo ng magulang ng backup na ugat) ay maaaring nagbago
nang hindi ito nagiging problema. Tandaan na kakailanganin mong tukuyin ang buong landas patungo sa
mga file o direktoryo na ibe-verify, hindi nauugnay sa backup na ugat. Kailangan mo pa
tukuyin ang hindi bababa sa isa sa mga backup na ugat sa command line o sa pamamagitan ng --ugat opsyon kaya
mahahanap ng obnam na iyon ang filesystem, kung sakaling malayo ito.

URL palaugnayan
Sa tuwing tumatanggap ang obnam ng URL, maaari itong maging lokal na pathname, o isang sftp URL. Isang sftp
Ang URL ay may sumusunod na form:

sftp: //[gumagamit@]domain[:port]/landas

saan domain ay isang normal na Internet domain name para sa isang server, gumagamit username mo ba diyan
server, port ay isang opsyonal na numero ng port, at landas ay isang pathname sa gilid ng server. Gaya ng
bzr(1), ngunit hindi tulad ng sftp URL standard, ang pathname ay ganap, maliban kung ito ay nagsisimula sa
/~/ kung saan ito ay nauugnay sa home directory ng user sa server.

Tingnan ang seksyong EXAMPLE para sa mga halimbawa ng mga URL.

Maaari mong gamitin ang sftp Mga URL para sa repositoryo, o ang live na data (ugat), ngunit tandaan na dahil sa
mga limitasyon sa protocol, at ang pagpapatupad nito sa paramiko library, ilang bagay
hindi gagana nang maayos para sa pag-access ng live na data sftp. Pinakamahalaga, ang paghawak
ng mga hardlink ay medyo suboptimal. Para sa live na pag-access ng data, hindi mo dapat tapusin ang URL
sa /~/ at dapat magdagdag ng tuldok sa dulo sa espesyal na kaso na ito.

Henerasyon pagtutukoy
Kapag hindi ginagamit ang pinakabagong henerasyon, kakailanganin mong tukuyin kung alin ang kailangan mo. Ito
gagawin sa --generation opsyon, na kumukuha ng detalye ng henerasyon bilang nito
argumento. Ang pagtutukoy ay alinman sa salita pinakahuli, ibig sabihin ang pinakabagong henerasyon
(din ang default), o isang numero. Tingnan ang Henerasyon utos upang makita kung ano ang mga henerasyon
magagamit, at kung ano ang kanilang mga numero.

Patakaran para pag-iingat at alis backup Henerasyon
Ang kalimutan Maaaring sundin ng command ang isang patakaran upang awtomatikong panatilihin ang ilan at alisin ang iba pang backup
mga henerasyon. Ang patakaran ay itinakda sa --panatilihin=PATAKARAN pagpipilian.

PATAKARAN ay listahan ng mga panuntunan na pinaghihiwalay ng kuwit. Ang bawat panuntunan ay binubuo ng isang bilang at isang yugto ng panahon.
Ang mga yugto ng panahon ay h, d, w, m, at y, para sa oras, araw, linggo, buwan, at taon.

Isang patakaran ng 30d ibig sabihin ay panatilihin ang pinakabagong backup para sa bawat araw kung kailan ginawa ang isang backup, at
panatilihin ang huling 30 ganoong backup. Ang anumang backup na tumugma sa anumang patakaran ng patakaran ay pinapanatili, at anuman
aalisin ang mga backup sa pagitan, pati na rin ang anumang mga backup na mas luma kaysa sa pinakalumang pinananatiling backup.

Bilang halimbawa, ipagpalagay na ang mga backup ay kinukuha bawat oras, sa oras: sa 00:00, 01:00, 02:00,
at iba pa, hanggang 23:00. Kung ang kalimutan Ang command ay pinapatakbo sa 23:15, kasama ang patakaran sa itaas, ito
papanatilihin ang backup na kinuha sa 23:00 sa bawat araw, at aalisin ang bawat iba pang backup sa araw na iyon.
Aalisin din nito ang mga backup na mas matanda sa 30 araw.

Kung ang pag-backup ay ginawa tuwing ibang araw, sa tanghali, kalimutan ay panatilihin ang 30 huling backup, o 60
araw na halaga ng mga backup, kasama ang patakaran sa itaas.

Tandaan na susuriin lang ng obnam ang mga timestamp sa backup na repository, at walang pakialam
kung ano ang aktwal na kasalukuyang oras. Nangangahulugan ito na kung hihinto ka sa paggawa ng mga bagong backup, ang
ang mga umiiral na ay hindi awtomatikong maaalis. Sa esensya, ang obnam ay nagpapanggap sa kasalukuyang oras
ay pagkatapos lamang ng pinakabagong backup kung kailan kalimutan ay run.

Ang mga patakaran ay maaaring ibigay sa anumang pagkakasunud-sunod, ngunit pag-uuri-uriin sa pataas na pagkakasunud-sunod ng yugto ng panahon
bago ilapat. (Ito ay isang error na magbigay ng dalawang panuntunan para sa parehong panahon.) Isang backup
ang henerasyon ay pinananatili kung ito ay tumutugma sa anumang tuntunin.

Halimbawa, ipagpalagay ang parehong dalas ng pag-backup tulad ng nasa itaas, ngunit isang patakaran ng 30d,52w. ito
papanatilihin ang pinakabagong pang-araw-araw na backup para sa bawat araw sa loob ng tatlumpung araw, at ang pinakabagong lingguhan
backup para sa 52 linggo. Dahil ang oras-oras na pag-backup ay aalisin araw-araw, bago sila magkaroon ng a
pagkakataong maligtas ng isang lingguhang tuntunin, ang epekto ay ang 23:00 na backup para sa bawat
araw ay nai-save para sa isang buwan, at ang 23:00 backup sa Linggo ay na-save para sa isang taon.

Kung, sa halip, gumamit ka ng patakaran ng 72h,30d,52w, obnam ay panatilihin ang huling 72 oras na pag-backup,
at ang huling backup ng bawat araw sa kalendaryo sa loob ng 30 araw, at ang huling backup ng bawat kalendaryo
linggo para sa 52 linggo. Kung ang dalas ng pag-backup ay isang beses bawat araw, obnam ay panatilihin ang backup
ng bawat oras sa kalendaryo kung saan ginawa ang isang backup, para sa 72 ganoong pag-backup. Sa ibang salita,
epektibo nitong mapapanatili ang huling 72 araw-araw na pag-backup.

Nakakalito ang tunog? Isipin na lang kung gaano nalilito ang developer sa pagsulat ng code.

Kung walang ibinigay na patakaran, kalimutan itatago ang lahat.

Ang isang tipikal na patakaran ay maaaring 72h,7d,5w,12m, na nangangahulugang: panatilihin ang huling 72 oras-oras na pag-backup, ang
huling 7 araw-araw na pag-backup, ang huling 5 lingguhang pag-backup at ang huling 12 buwanang pag-backup. Kung ang
ang mga backup ay sistematikong tumatakbo sa isang oras-oras na batayan, ito ay mangangahulugan ng pagpapanatiling oras-oras na pag-backup
para sa tatlong araw, araw-araw na pag-backup para sa isang linggo, lingguhang pag-backup para sa isang buwan, at buwanang pag-backup
sa loob ng isang taon.

Ang paraan ng paggana ng patakaran ay medyo kumplikado. Takbo kalimutan sa --kunwari pagpipilian sa
siguraduhing aalisin mo ang mga tama.

paggamit pag-encrypt
obnam maaaring i-encrypt ang lahat ng data na isinusulat nito sa backup na imbakan. Ito ay gumagamit ng gpg(1) gawin
ang pag-encrypt. Kailangan mong gumawa ng key pair gamit ang gpg --gen-key (o gumamit ng umiiral na
isa), at pagkatapos ay sabihin obnam tungkol dito gamit ang --encrypt-with opsyon. Maaari kang opsyonal
gumamit ng hiwalay na home directory gamit ang --gnupghome opsyon. Bilang default, ang default
direktoryo para sa gpg(1) gagamitin.

Configuration file
obnam maghahanap ng mga configuration file sa ilang mga lokasyon. Tingnan ang seksyong FILES
para sa isang listahan. Ang lahat ng mga file na ito nang magkasama ay itinuturing bilang isang malaking file na may mga nilalaman ng lahat
pinagsama-samang mga file.

Ang mga file ay nasa INI na format, at tanging ang [config] ginagamit ang seksyon (anumang iba pang mga seksyon ay
hindi pinansin).

Ang mahahabang pangalan ng mga opsyon ay ginagamit bilang mga susi para sa mga variable ng pagsasaayos. Kahit anong setting yan
maaaring itakda mula sa command line ay maaaring itakda sa isang configuration file, sa [config]
seksyon.

Halimbawa, ang mga opsyon sa sumusunod na command line:

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

maaaring mapalitan ng sumusunod na configuration file:

[config]
imbakan: /backup
ibukod ang: .wav$

(Maaari mong gamitin ang alinman foo=halaga or foo: halaga syntax sa mga file.)

Ang tanging hindi pangkaraniwang bagay tungkol sa mga file ay ang paraan ng mga opsyon na maaaring magamit nang maraming beses
ipinahayag. Ang lahat ng mga halaga ay inilalagay sa isang solong lohikal na linya, na pinaghihiwalay ng mga kuwit (at
opsyonal na mga puwang din). Halimbawa:

[config]
ibukod = foo, bar, \.mp3$

Ang nasa itaas ay may tatlong halaga para sa huwag isama opsyon: anumang mga file na naglalaman ng mga salita foo or
bar saanman sa ganap na kwalipikadong pathname, o mga file na may mga pangalan na nagtatapos sa isang tuldok at
mp3 (dahil ang mga pagbubukod ay mga regular na expression).

Ang isang mahabang lohikal na linya ay maaaring hatiin sa ilang mga pisikal, sa pamamagitan ng pagsisimula ng isang bagong linya sa
puting espasyo, at indenting ang mga linya ng pagpapatuloy:

[config]
ibukod = foo,
bar,
\.mp3$

Ang halimbawa sa itaas ay nagdaragdag ng tatlong pattern ng pagbubukod.

Maramihang kliyente at naisasara
obnam sumusuporta sa pagbabahagi ng repositoryo sa pagitan ng maraming kliyente. Maaaring ibahagi ng mga kliyente ang
mga nilalaman ng file (mga tipak), upang kung ang client A ay nagba-back up ng isang malaking file, at ang client B ay mayroong
parehong file, pagkatapos ay hindi kailangang i-upload ng B ang malaking file sa repositoryo sa pangalawang pagkakataon.
Para gumana ito nang walang kalituhan, ang mga kliyente ay gumagamit ng isang simpleng locking protocol na nagbibigay-daan
isang kliyente lamang sa isang pagkakataon upang baguhin ang mga nakabahaging istruktura ng data. Hindi pinipigilan ng mga kandado
read-only na access nang sabay-sabay: nagbibigay-daan ito sa iyong i-restore habang may ibang tao
pag-back up.

Minsan nangyayari ang isang read-only na operasyon upang ma-access ang isang istraktura ng data kasabay nito
ay binago. Maaari itong magresulta sa isang pag-crash. Hindi ito magreresulta sa corrupt na data, o
maling pagbabalik. Gayunpaman, maaaring kailanganin mong i-restart ang read-only na operasyon pagkatapos ng a
pag-crash.

Opsyon

--laging-ibalik-setuid
ibalik ang setuid/setgid bits sa mga naibalik na file, kahit na hindi root o naka-back up na file
may ibang may-ari kaysa sa pagpapanumbalik ng user na tumatakbo

--hindi-palaging-ibalik-setuid
kabaligtaran ng --always-restore-setuid

--Pangalan ng kliyente=PANGALAN NG KLIYENTE
pangalan ng kliyente (default sa hostname)

--compress-with=PROGRAMA
gumamit ng PROGRAM upang i-compress ang repository na may (isa sa wala, deflate)

--kritikal na edad=AGE
para sa nagios-last-backup-age: maximum na edad (bilang default sa mga oras) para sa pinakabago
backup bago ang istatistika ay kritikal. Tumatanggap ng isang char unit specifier (s,m,h,d para sa
segundo, minuto, oras, at araw.

--dump-repo-file-metadata
dump metadata tungkol sa mga file?

--no-dump-repo-file-metadata
kabaligtaran ng --dump-repo-file-metadata

--generate-manpage=TEMPLATE
SUPPRESSHELP

--generation=GENERATION
kung aling henerasyon ang ibabalik

-h, - Tumulong
ipakita ang mensahe ng tulong na ito at lumabas

--panatilihin=PANATILIHING
patakaran para sa kung anong mga henerasyon ang dapat panatilihin kapag nakakalimutan

--lock-timeout=TIMEOUT
kapag nagla-lock sa backup na repository, maghintay ng TIMEOUT segundo para sa isang umiiral nang lock
umalis ka bago sumuko

--output=FILE
isulat ang output sa FILE, sa halip na karaniwang output

--kunwari, --dry-run, --walang-kilos
huwag talagang baguhin ang anumang bagay (gumagana sa backup, kalimutan at ibalik lamang, at
maaari lamang gayahin ang tinatayang totoong pag-uugali)

--hindi-kunwari, --walang-dry-run, --no-no-act
kabaligtaran ng --kunwari

--tahimik, --tahimik
manahimik: ipakita lamang ang mga mensahe ng error, walang mga update sa pag-unlad

--walang-tahimik, --walang-tahimik
kabaligtaran ng --tahimik

-r, --imbakan=URL
pangalan ng backup na repository (maaaring pathname o sinusuportahang URL)

--repository-format=FORMAT
gumamit ng FORMAT para sa mga bagong repository; isa sa "6", "green-albatross"

--sa=SA
kung saan ibabalik o FUSE mount; para sa mga pagpapanumbalik, dapat walang laman o hindi dapat umiral

--verbose
maging verbose: sabihin sa user ang higit pa tungkol sa kung ano ang nangyayari at sa pangkalahatan ay siguraduhin na ang user
ay may kamalayan sa kung ano ang nangyayari o hindi bababa sa na may nangyayari at gumagawa din
siguradong madalas na nakakakuha ng mga update ang kanilang screen at may mga pagbabagong nangyayari
sa lahat ng oras upang hindi sila magsawa at sa katunayan sila ay nabigo sa pamamagitan ng
naabala sa napakaraming update na lilipat sila sa disyerto ng Gobi
nakatira sa ilalim ng bato

--no-verbose
kabaligtaran ng --verbose

--verify-randomly=N
random na i-verify ang N file mula sa backup (default ay zero, ibig sabihin lahat)

--bersyon
ipakita ang numero ng bersyon ng programa at lumabas

--warning-edad=AGE
para sa nagios-last-backup-age: maximum na edad (bilang default sa mga oras) para sa pinakabago
backup bago ang status ay babala. Tumatanggap ng isang char unit specifier (s,m,h,d para sa
segundo, minuto, oras, at araw.

Pag-back up up
--checkpoint=SIZE
gumawa ng checkpoint pagkatapos ng ibinigay na SIZE

--deduplicate=MODE
maghanap ng duplicate na data sa naka-back up na data at iimbak ito nang isang beses lamang; tatlong mga mode ay
available: hindi kailanman i-de-duplicate, i-verify na walang nangyaring banggaan ng hash, o (ang
default) fatalistically tanggapin ang panganib ng banggaan

--ibukod=HALIMBAWA
regular na expression para sa mga pathname na ibukod mula sa backup (maaaring magamit ng maramihang
beses)

--exclude-caches
ibukod ang mga direktoryo (at ang kanilang mga subdir) na naglalaman ng CACHEDIR.TAG file (tingnan ang
http://www.brynosaurus.com/cachedir/spec.html para sa kung ano ang kailangan nitong nilalaman, at
http://liw.fi/cachedir/ para sa isang katulong na kasangkapan)

--no-exclude-cache
kabaligtaran ng --exclude-caches

--bukod-sa=FILE
basahin ang ibukod ang mga pattern mula sa FILE

--isama=MAISASALI
regular na expression para sa mga pathname na isasama mula sa backup kahit na tumutugma ito sa isang
ibukod ang panuntunan (maaaring magamit nang maraming beses)

--umalis-mga checkpoint
iwanan ang mga henerasyon ng checkpoint sa pagtatapos ng isang matagumpay na backup run

--walang-leave-checkpoints
kabaligtaran ng --leave-checkpoints

--isang-file-system
ibukod ang mga direktoryo (at ang kanilang mga subdir) na nasa ibang filesystem

--walang-isang-file-system
kabaligtaran ng --one-file-system

--ugat=URL
ano ang i-backup

--maliit na mga file-sa-btree
ito ay magagamit lamang para sa pabalik na pagkakatugma; huwag gamitin ito, at alisin ito
mula sa iyong configuration

--no-small-files-in-btree
kabaligtaran ng --small-files-in-btree

Configuration file at mga setting
--config=FILE
magdagdag ng FILE sa mga config file

--dump-config
isulat ang buong kasalukuyang configuration

--dump-setting-pangalan
SUPPRESSHELP

--tulong-lahat
ipakita ang lahat ng mga pagpipilian

--list-config-files
SUPPRESSHELP

--no-default-configs
malinaw na listahan ng mga configuration file na babasahin

Pag-unlad of Obnam kanyang sarili
--crash-limit=COUNTER
artipisyal na i-crash ang program pagkatapos ng COUNTER file na isinulat sa repositoryo; ito
ay kapaki-pakinabang para sa pagsubok ng pag-crash sa application, at hindi dapat paganahin para sa tunay
gamitin; itakda sa 0 upang huwag paganahin (naka-disable bilang default)

--kunwari-oras=TIMESTAMP
magpanggap na ito ay TIMESTAMP (YYYY-MM-DD HH:MM:SS); ito ay kapaki-pakinabang lamang para sa pagsubok
Mga layunin

--sftp-antala=SFTP-DELAY
magdagdag ng artipisyal na pagkaantala (sa millisecond) sa lahat ng paglilipat ng SFTP

--testing-fail-matching=REGEXP
development testing helper: gayahin ang mga pagkabigo sa panahon ng backup para sa mga file na tumutugma
ang ibinigay na mga regular na expression

--bakas=TRACE
idagdag sa mga filename patters kung saan nangyayari ang trace debugging logging

Encryption
--encrypt-with=ENCRYPT-WITH
PGP key kung saan i-encrypt ang data sa backup na repository

--gnupghome=HOMEDIR
home directory para sa GPG

--key-detalye
magpakita ng mga karagdagang user ID para sa lahat ng key

--walang-susi-mga detalye
kabaligtaran ng --key-details

--keyid=KEYID
PGP key id upang idagdag sa/alisin mula sa backup na imbakan

--symmetric-key-bits=BITS
laki ng simetriko key, sa mga bit

--mahina-random
gamitin ang /dev/urandom sa halip na /dev/random upang makabuo ng mga simetriko na key

--walang-mahina-random
kabaligtaran ng --weak-random

Integridad pagsuri (fsck)
--fsck-fix
dapat bang subukan ng fsck na ayusin ang mga problema? Nagpapahiwatig --fsck-rm-unused

--no-fsck-fix
kabaligtaran ng --fsck-fix

--fsck-ignore-chunks
huwag pansinin ang mga chunks kapag sinusuri ang integridad ng repositoryo (ipagpalagay na ang lahat ng mga chunks ay umiiral at ay
tama)

--no-fsck-ignore-chunks
kabaligtaran ng --fsck-ignore-chunks

--fsck-ignore-client=NAME
huwag suriin ang data ng imbakan para sa cient NAME

--fsck-last-generation-only
suriin lamang ang huling henerasyon para sa bawat kliyente

--no-fsck-last-generation-only
kabaligtaran ng --fsck-last-generation-only

--fsck-rm-hindi nagamit
dapat bang tanggalin ng fsck ang mga hindi nagamit na tipak?

--no-fsck-rm-unused
kabaligtaran ng --fsck-rm-unused

--fsck-skip-checksums
huwag suriin ang mga checksum ng mga file

--no-fsck-skip-checksums
kabaligtaran ng --fsck-skip-checksums

--fsck-skip-dirs
huwag suriin ang anumang bagay tungkol sa mga direktoryo at kanilang mga file

--no-fsck-skip-dirs
kabaligtaran ng --fsck-skip-dirs

--fsck-skip-files
huwag suriin ang anumang bagay tungkol sa mga file

--no-fsck-skip-files
kabaligtaran ng --fsck-skip-files

--fsck-skip-generations
huwag suriin ang anumang henerasyon

--no-fsck-skip-generations
kabaligtaran ng --fsck-skip-generations

--fsck-skip-per-client-b-trees
huwag suriin ang bawat-kliyenteng B-puno

--no-fsck-skip-per-client-b-trees
kabaligtaran ng --fsck-skip-per-client-b-trees

--fsck-skip-shared-b-trees
huwag suriin ang mga nakabahaging B-tree

--no-fsck-skip-shared-b-trees
kabaligtaran ng --fsck-skip-shared-b-trees

Pagtotroso
--log=FILE
magsulat ng mga log entry sa FILE (default ay hindi magsulat ng mga log file sa lahat); gumamit ng "syslog"
upang mag-log sa log ng system, "stderr" upang mag-log sa karaniwang output ng error, o "wala" sa
huwag paganahin ang pag-log

--log-panatilihin=N
panatilihin ang huling N log (10)

--log-level=ANTAS
mag-log sa LEVEL, isa sa debug, impormasyon, babala, error, kritikal, nakamamatay (default: impormasyon)

--log-max=SIZE
paikutin ang mga log na mas malaki sa SIZE, zero para sa hindi kailanman (default: 0)

--log-mode=MODE
itakda ang mga pahintulot ng mga bagong log file sa MODE (octal; default 0600)

Kabitan sa Piyus
--fuse-opt=Piyus
mga opsyon na direktang ipasa sa Fuse

Pagsasaayos
--dump-memory-profile=Pamamaraan
gumawa ng memory profiling dumps gamit ang METHOD, na isa sa: wala, simple, o meliae
(default: simple)

--memory-dump-interval=SECONDS
gumawa ng memory profiling dumps ng hindi bababa sa SECONDS agwat

pagganap pag-aayos
--laki ng tipak=SIZE
laki ng mga piraso ng data ng file na na-back up

--chunkids-per-group=NUM
i-encode ang NUM chunk id bawat pangkat

--idpath-bits=IDPATH-BITS
laki ng antas ng chunk id

--idpath-depth=IDPATH-DEPTH
lalim ng chunk id mapping

--idpath-skip=IDPATH-SKIP
chunk id mapping lowest bits skip

--lru-size=SIZE
laki ng LRU cache para sa mga B-tree node

--laki ng node=SIZE
laki ng mga B-tree node sa disk; nakakaapekto lamang sa mga bagong B-tree kaya maaaring kailanganin mong tanggalin ang a
client o repository upang baguhin ito para sa mga kasalukuyang repositoryo

--upload-queue-size=SIZE
haba ng pila sa pag-upload para sa mga B-tree node

Repository format berde-albatross
--chunk-bag-size=SIZE
tinatayang maximum na laki ng bag na pinagsasama ang maraming tipak na bagay

--chunk-cache-size=SIZE
laki ng in-memory na cache para sa file data chunk objects

--dir-bag-laki=SIZE
approximage maximum na laki ng mga bag na pinagsasama ang maraming DIR object

--dir-cache-size=SIZE
laki ng in-memory na cache para sa mga bagay na DIR

SSH/SFTP
--pure-paramiko
huwag gumamit ng openssh kahit na magagamit, gumamit lamang ng paramiko

--walang-pure-paramiko
kabaligtaran ng --pure-paramiko

--ssh-utos=MAAABOT
alternatibong executable na gagamitin sa halip na "ssh" (pinahihintulutan ang buong landas, hindi
maaaring magdagdag ng mga argumento)

--ssh-host-keys-check=VALUE
Kung "oo", kinakailangan na ang ssh host key ay dapat na kilala at tama upang matanggap.
Kung "hindi", huwag i-require iyon. Kung "magtanong", interactive na hihilingin sa user na tanggapin
bagong host. Ang default ("ssh-config") ay umasa sa mga setting ng pinagbabatayan
SSH client

--ssh-key=FILENAME
gamitin ang FILENAME bilang ssh RSA private key para sa sftp access (default ay gumagamit ng mga key
kilala sa ssh-agent)

--ssh-kilalang-host=FILENAME
filename ng kilalang host file ng user

--strict-ssh-host-keys
DEPRECATED, gumamit na lang ng --ssh-host-keys-check

--no-strict-ssh-host-keys
kabaligtaran ng --strict-ssh-host-keys

Opsyon halaga
Ang SIZE ang halaga sa mga opsyon na nabanggit sa itaas ay tumutukoy ng laki sa bytes, na may opsyonal
mga suffix para ipahiwatig ang kilobytes (k), kibibytes (Ki), megabytes (M), mebibytes (Mi),
gigabytes (G), gibibytes (Gi), terabytes (T), tibibytes (Ti). Ang mga suffix ay case-
walang nararamdaman.

EXIT STATUS

obnam lalabas na may zero kung naging maayos ang lahat, at hindi zero kung hindi man.

Kapaligiran

obnam ay ipapasa ang kapaligirang nakukuha nito mula sa magulang nito, nang walang pagbabago. ginagawa nito
hindi sumusunod sa anumang hindi pangkaraniwang mga variable ng kapaligiran, ngunit sinusunod nito ang mga karaniwan kapag tumatakbo
mga panlabas na programa, paglikha ng mga pansamantalang file, atbp.

Gumamit ng obnam online gamit ang mga serbisyo ng onworks.net