obnam - Online in de cloud

PROGRAMMA:

NAAM

obnam - back-ups maken, herstellen en manipuleren

KORTE INHOUD

obnam [--altijd-herstellen-setuid] [--no-altijd-herstel-setuid] [--controlepunt=SIZE]
[--brokzak-formaat=SIZE] [--stuk-cache-grootte=SIZE] [--formaat van een blokje=SIZE]
[--chunkids-per-groep=NUM] [--klantnaam=KLANTNAAM] [--comprimeren-met=PROGRAMMA]
[--config=FILE] [--dump-config] [--dump-instellingsnamen] [--genereer-manpage=TEMPLATE] [-h]
[--help] [--Help iedereen] [--lijst-config-bestanden] [--versie] [--geen-standaard-configs]
[--crashlimiet=COUNTER] [--kritieke leeftijd=LEEFTIJD] [--dedupliceren=MODE] [--dir-bag-formaat=SIZE]
[--dir-cache-grootte=SIZE] [--dump-geheugen-profiel=METHODE] [--dump-repo-bestand-metadata]
[--no-dump-repo-bestand-metadata] [--versleutelen-met=ENCRYPT-MET] [--uitsluiten=UITSLUITEN]
[--uitsluiten-caches] [--geen-uitsluiten-caches] [--Uitsluiten van=FILE] [--fsck-fix]
[--no-fsck-fix] [--fsck-negeer-brokken] [--no-fsck-negeer-brokken]
[--fsck-negeer-client=NAAM] [--fsck-alleen-laatste-generatie] [--no-fsck-alleen-laatste-generatie]
[--fsck-rm-ongebruikt] [--no-fsck-rm-ongebruikt] [--fsck-overslaan-checksums]
[--geen-fsck-overslaan-checksums] [--fsck-skip-directories] [--no-fsck-skip-dirs] [--fsck-bestanden overslaan]
[--no-fsck-skip-bestanden] [--fsck-skip-generaties] [--geen-fsck-skip-generaties]
[--fsck-skip-per-client-b-bomen] [--no-fsck-skip-per-client-b-trees]
[--fsck-skip-gedeelde-b-trees] [--no-fsck-skip-shared-b-trees] [--zekering-opt=FUSE]
[--generatie=GENERATION] [--gnupghome=HOMEDIR] [--idpath-bits=IDPATH-BITS]
[--idpath-diepte=IDPATH-DIEPTE] [--idpath-overslaan=IDPATH-OVERSLAAN] [--erbij betrekken=BEVATTEN]
[--houden=HOUDEN] [--sleuteldetails] [--geen-sleuteldetails] [--keyid=SLEUTELID] [--verlof-checkpoints]
[--geen-verlof-controlepunten] [--lock-time-out=TIME-OUT] [--log=FILE] [--logboek bijhouden=N]
[--Log niveau=NIVEAU] [--log-max=SIZE] [--log-modus=MODE] [--lru-maat=SIZE]
[--geheugen-dump-interval=SECONDS] [--node-grootte=SIZE] [--één-bestandssysteem]
[--niemand-bestandssysteem] [--uitvoer=FILE] [--doen alsof] [--oefening] [--geen-act] [--niet doen alsof]
[--geen droogloop] [--nee-geen-act] [--doen alsof-tijd=TIJDSTAMP] [--pure-paramiko]
[--geen-pure-paramiko] [--stil] [--stil] [--niet-stil] [--geen-stil] [-rURL]
[--opslagplaats=URL] [--repository-formaat=FORMAT] [--wortel=URL] [--sftp-vertraging=SFTP-VERTRAGING]
[--kleine-bestanden-in-btree] [--geen-kleine-bestanden-in-btree] [--ssh-opdracht=UITVOERBAAR]
[--ssh-host-sleutels-controle=WAARDE] [--ssh-sleutel=BESTANDSNAAM] [--ssh-bekende-hosts=BESTANDSNAAM]
[--strikte-ssh-hostsleutels] [--geen-strikte-ssh-host-sleutels] [--symmetrische-sleutelbits=BITS]
[--testen-mislukt-matching=REGEXP] [--tot=TO] [--spoor=SPOOR] [--upload-wachtrij-grootte=SIZE]
[--uitgebreid] [--niet-uitgebreid] [--verifiëren-willekeurig=N] [--waarschuw-leeftijd=LEEFTIJD] [--zwak-willekeurig]
[--geen-zwak-willekeurig]

obnam [opties] _slot
obnam [opties] add-toets [CLIËNT-NAAM] ...
obnam [opties] back-up [DIRECTORY|URL] ...
obnam [opties] clientsleutels
obnam [opties] klanten
obnam [opties] verschil [GENERATION1]GENERATION2
obnam [opties] dump-repo
obnam [opties] geforceerd vergrendelen
obnam [opties] vergeten [GENERATION] ...
obnam [opties] fsck
obnam [opties] generaties
obnam [opties] geniden
obnam [opties] hulp
obnam [opties] Help iedereen
obnam [opties] kdirstat [FILE] ...
obnam [opties] lijstfouten
obnam [opties] lijstformaten
obnam [opties] lijsttoetsen
obnam [opties] lijst-topniveaus
obnam [opties] ls [FILE] ...
obnam [opties] monteren [ROOT]
obnam [opties] nagios-laatste-backup-leeftijd
obnam [opties] verwijder-client [CLIËNT-NAAM] ...
obnam [opties] sleutel verwijderen [CLIËNT-NAAM] ...
obnam [opties] herstellen [DIRECTORY] ...
obnam [opties] verifiëren [DIRECTORY] ...

PRODUCTBESCHRIJVING

obnam maakt, herstelt, manipuleert en behandelt anderszins back-ups. Het kan opslaan
back-ups op een lokale schijf of naar een server via sftp. Elke back-upgeneratie ziet eruit als een
verse momentopname, maar is echt incrementeel: de gebruiker hoeft zich geen zorgen te maken of het een
volledige back-up of niet. Er wordt alleen een back-up gemaakt van gewijzigde gegevens, en als er al een deel van de gegevens is
waarvan een back-up is gemaakt in een ander bestand, worden die gegevens opnieuw gebruikt.

De plaats waar back-upgegevens worden geplaatst, wordt de back-uprepository genoemd. Een opslagplaats
kan bijvoorbeeld een directory op een sftp-server zijn, of een directory op een USB-harddisk. A
een enkele repository kan back-ups van verschillende clients bevatten. Hun gegevens zullen zich vermengen
alsof ze afzonderlijke opslagplaatsen gebruiken, maar als de ene client een back-up van een bestand maakt, de anderen
mag de gegevens hergebruiken.

obnam opdrachtregel syntaxis bestaat uit a commando eventueel gevolgd door argumenten. De
commando's staan ​​hieronder.

· backup maakt een nieuwe back-up. De eerste keer dat het wordt uitgevoerd, maakt het daarna een volledige back-up
dat een incrementele.

· herstellen is het tegenovergestelde van een back-up. Het kopieert back-upgegevens van de back-up
repository naar een doelmap. Je kunt alles in een generatie herstellen, of
net geselecteerde bestanden.

· klanten somt de clients op waarvan een back-up naar de repository is gemaakt.

· generaties somt elke back-upgeneratie voor een bepaalde client op, plus enkele metadata
over de generatie.

· geniden somt de identifier op voor elke back-upgeneratie voor een bepaalde client. Nee
andere informatie wordt weergegeven. Dit kan handig zijn bij het schrijven van scripts.

· ls somt de inhoud van een bepaalde generatie op, vergelijkbaar met ls -lAR.

· kdirstat somt de inhoud van een bepaalde generatie op, in een formaat dat compatibel is
met de kdirstat cache-bestandsindeling, die vervolgens kan worden gebruikt om de
inhoud van een back-up.

· controleren vergelijkt gegevens in de back-up met daadwerkelijke gebruikersgegevens en zorgt ervoor dat dit het geval is
identiek. Het is het handigst om direct na een back-up te draaien om te controleren of deze is gemaakt
werkte eigenlijk. Het kan op elk moment worden uitgevoerd, maar als de gebruikersgegevens zijn gewijzigd,
verificatie mislukt, hoewel de back-up in orde is.

· vergeten verwijdert back-upgeneraties die niet langer gewenst zijn, zodat ze niet gebruiken
schijf ruimte. Merk op dat nadat een back-upgeneratie is verwijderd, de gegevens niet meer kunnen worden verwijderd
meer hersteld. U kunt de te verwijderen generaties specificeren door ze op te sommen
op de opdrachtregel of gebruik de --houden optie om een ​​beleid op te geven voor wat u wilt bewaren
(de rest wordt verwijderd).

· fsck controleert de interne consistentie van de back-uprepository. Het verifieert dat
alle clients, generaties, mappen, bestanden en alle bestandsinhoud bestaan ​​nog steeds in
de back-upopslagplaats. Het kan behoorlijk lang duren om te draaien.

· geforceerd vergrendelen verwijdert een vergrendelingsbestand voor een client in de repository. Je zou alleen moeten
forceer een slot als u zeker weet dat niemand toegang heeft tot de gegevens van die klant in de
opslagplaats. Een bungelend slot kan bijvoorbeeld voorkomen als obnam zijn netwerk verliest
verbinding met de back-uprepository.

· client-sleutels somt de coderingssleutel op die aan elke client is gekoppeld.

· lijst-toetsen somt de sleutels op die toegang hebben tot de repository, en welk toplevel
mappen waartoe elke sleutel toegang heeft. Sommige mappen op het hoogste niveau worden gedeeld
tussen klanten, andere zijn specifiek voor een klant.

· lijst-topniveaus is als lijst-toetsen, maar vermeldt de hoogste niveaus en welke sleutels toegang hebben
Hen.

· add-sleutel voegt een coderingssleutel toe aan de repository. Standaard wordt de sleutel toegevoegd
alleen aan de gedeelde mappen op het hoogste niveau, maar het kan ook worden toegevoegd aan specifieke
clients: vermeld de namen van de clients op de opdrachtregel. De sleutel wordt meegegeven
de --keyid keuze. Degene die toegang heeft tot de geheime sleutel die overeenkomt met de sleutel
id heeft toegang tot de back-uprepository (de gedeelde topniveaus plus gespecificeerde clients).

· sleutel verwijderen verwijdert een sleutel uit de gedeelde mappen op het hoogste niveau, plus eventuele clients
opgegeven op de opdrachtregel.

· nagios-laatste-backup-leeftijd is een controle die wordt afgesloten met een niet-nul terugkeer als een back-upleeftijd
een bepaalde drempel overschrijdt. Het is geschikt voor gebruik als check-plugin voor nagios.
Drempels kunnen worden opgegeven --waarschuw-leeftijd en --kritieke leeftijd opties.

· diff vergelijkt twee generaties en somt bestanden op die onderling verschillen. Elke uitgang
regel wordt voorafgegaan door een plusteken (+) voor bestanden die zijn toegevoegd, een minteken
teken (-) voor bestanden die zijn verwijderd of een sterretje (*) voor bestanden die zijn verwijderd
veranderd. Als er slechts één generatie-ID is opgegeven op de opdrachtregel, is dat
generatie zal worden vergeleken met zijn directe voorganger. Als er twee ID's zijn geweest
opgegeven, worden alle wijzigingen tussen die twee generaties weergegeven.

· monteren maakt de back-uprepository beschikbaar via een alleen-lezen FUSE-bestandssysteem. Elk
back-upgeneratie is zichtbaar als een submap, genoemd naar de generatie-ID.
Dit betekent dat u back-upgegevens kunt bekijken met behulp van normale hulpmiddelen, zoals uw GUI-bestand
manager of opdrachtregelprogramma's zoals ls(1) diff(1), en cp(1). Je kunt niet maken
nieuwe back-ups maken met het subcommando mount, maar u kunt gegevens eenvoudig herstellen.

U moet de FUSE-hulpprogramma's hebben en toestemming hebben om FUSE hiervoor te gebruiken
werk. De details variëren per besturingssysteem; installeer in Debian de
pakket zekering en voeg jezelf toe aan de zekering groep (mogelijk moet u uitloggen en weer terug
weer binnen).

maken backups
Wanneer u een back-up maakt, obnam uploadt gegevens naar de back-uprepository. De gegevens zijn verdeeld
opgedeeld in chunks, en als er al een chunk bestaat in de back-uprepository, wordt deze niet geüpload
opnieuw. Dit maakt het mogelijk obnam om te gaan met bestanden die zijn gewijzigd of hernoemd sinds de
vorige back-uprun. Het stelt ook verschillende back-upclients in staat om te voorkomen dat ze hetzelfde uploaden
gegevens. Als bijvoorbeeld iedereen op kantoor een exemplaar van dezelfde verkoopbrochures heeft,
er hoeft slechts één kopie te worden opgeslagen in de back-uprepository.

Elke back-uprun is een generatie. Bovendien, obnam zal maken checkpoint generaties
zo nu en dan. Deze zijn precies zoals normale generaties, maar zijn niet gegarandeerd
een volledige momentopname zijn van de live gegevens. Als de back-uprun moet worden afgebroken in de
midden kan de volgende back-uprun worden voortgezet vanaf het laatste controlepunt, zodat dit niet nodig is
helemaal opnieuw beginnen.

Als een back-uprun een back-uphoofdmap laat vallen, zullen de oudere generaties deze nog steeds behouden:
er verandert niets in de oude generaties alleen maar omdat er een nieuwe is. Als de wortel was
per ongeluk is verwijderd, kan het weer worden toegevoegd en zal de volgende back-uprun het bestaande opnieuw gebruiken
gegevens in de back-uprepository en maakt alleen een back-up van de metadata van het bestand (bestandsnamen,
machtigingen, enz.).

Het verifiëren backups
Wat heb je aan een back-upsysteem waarop je niet kunt vertrouwen? Hoe kun je vertrouwen op iets dat je niet kunt
test? De obnam controleren opdracht controleert of de gegevens in de back-uprepository overeenkomen met de werkelijke
gebruikersgegevens. Het haalt een of meer bestanden uit de repository en vergelijkt ze met de
gebruikersgegevens. Dit is in wezen hetzelfde als een herstel uitvoeren en vervolgens herstelde bestanden vergelijken
met de originele bestanden gebruiken cmp(1), maar gemakkelijker te gebruiken.

Verificatie vindt standaard plaats op alle bestanden. U kunt ook de bestanden opgeven die moeten worden
geverifieerd door ze op de opdrachtregel te vermelden. U moet de volledige paden naar het
bestanden, niet relatief ten opzichte van de huidige directory.

De uitvoer bevat bestanden die om de een of andere reden niet geverifieerd kunnen worden. Als je alles verifieert,
het is waarschijnlijk dat sommige bestanden (bijv. bovenliggende mappen van back-up root) gewijzigd zijn
zonder dat het een probleem is. Merk op dat u het hele pad naar het
bestanden of mappen die moeten worden geverifieerd, niet relatief ten opzichte van de back-uproot. Je moet nog steeds
specificeer ten minste één van de back-uproots op de opdrachtregel of via de --wortel optie dus
dat obnam het bestandssysteem zal vinden, voor het geval het een extern systeem is.

URL syntaxis
Wanneer obnam een ​​URL accepteert, kan dit een lokale padnaam zijn of een sftp URL. Een sftp
URL heeft de volgende vorm:

sftp: //[gebruiker@]domein[:port]/pad

WAAR domein is een normale internetdomeinnaam voor een server, gebruiker is uw gebruikersnaam daarop
server, port is een optioneel poortnummer, en pad is een padnaam aan de serverzijde. Leuk vinden
bzr(1), maar in tegenstelling tot de sftp URL-standaard is de padnaam absoluut, tenzij deze begint met
/~/ in welk geval het relatief is ten opzichte van de thuismap van de gebruiker op de server.

Zie het gedeelte VOORBEELD voor voorbeelden van URL's.

Je kunt gebruiken sftp URL's voor de repository of de live data (root), maar houd er rekening mee dat vanwege
beperkingen in het protocol, en de uitvoering ervan in de paramiko bibliotheek, sommige dingen
zal niet erg goed werken voor toegang tot live gegevens via sftp. Het belangrijkste is de bediening
aantal hardlinks is nogal suboptimaal. Voor live gegevenstoegang mag u de URL niet beëindigen
Met /~/ en zou in dit speciale geval een punt aan het einde moeten toevoegen.

Generatie specificaties
Als u de nieuwste generatie niet gebruikt, moet u aangeven welke u nodig heeft. Dit
wordt gedaan met de --generatie optie, die een generatiespecificatie als zijn
argument. De specificatie is ofwel het woord laatste, wat betekent de nieuwste generatie
(ook de standaard), of een nummer. Zie de generaties opdracht om te zien wat generaties zijn
beschikbaar zijn en wat hun aantal is.

Beleid For houden en het verwijderen van backup generaties
De vergeten commando kan een beleid volgen om automatisch sommige back-ups te behouden en andere te verwijderen
generaties. Het beleid wordt bepaald met de --houden=BELEID optie.

BELEID is een door komma's gescheiden lijst met regels. Elke regel bestaat uit een telling en een tijdsperiode.
De tijdvakken zijn h, d, w, m en y, voor uur, dag, week, maand en jaar.

een beleid van 30d betekent om de laatste back-up te bewaren voor elke dag waarop een back-up is gemaakt, en
bewaar de laatste 30 van dergelijke back-ups. Elke back-up die overeenkomt met een beleidsregel wordt bewaard, en alle
back-ups ertussen worden verwijderd, evenals back-ups die ouder zijn dan de oudste bewaarde back-up.

Stel dat er elk uur back-ups worden gemaakt, op het hele uur: om 00:00, 01:00, 02:00,
enzovoort, tot 23 uur. Als de vergeten commando wordt uitgevoerd om 23:15, met het bovenstaande beleid, it
zal de back-up elke dag om 23:00 uur bewaren en elke andere back-up die dag verwijderen.
Het verwijdert ook back-ups die ouder zijn dan 30 dagen.

Als er om de dag, om XNUMX uur, back-ups worden gemaakt, vergeten zou de 30 laatste back-ups behouden, of 60
dagen aan back-ups, met het bovenstaande beleid.

Merk op dat obnam alleen tijdstempels in de back-uprepository inspecteert en dat het niet uitmaakt
wat de werkelijke huidige tijd is. Dit betekent dat als u stopt met het maken van nieuwe back-ups, de
bestaande worden niet automatisch verwijderd. In wezen doet obnam alsof het de huidige tijd is
is net na de laatste back-up wanneer vergeten wordt uitgevoerd.

De regels kunnen in willekeurige volgorde worden gegeven, maar worden gesorteerd in oplopende volgorde van tijdsperiode
voor toegepast. (Het is een fout om twee regels voor dezelfde periode te geven.) Een back-up
generatie wordt behouden als het overeenkomt met een regel.

Ga bijvoorbeeld uit van dezelfde back-upfrequentie als hierboven, maar een beleid van 30d,52w. Deze
bewaart de nieuwste dagelijkse back-up voor elke dag gedurende dertig dagen, en het nieuwste weekblad
back-up voor 52 weken. Omdat de uurlijkse back-ups dagelijks worden verwijderd, voordat ze een
kans om gered te worden door een wekelijkse regel, het effect is dat de 23:00 uur back-up voor elk
dag wordt een maand bewaard en de 23:00 back-up op zondag wordt een jaar bewaard.

Als u in plaats daarvan een beleid gebruikt van 72u,30d,52w, obnam zou de laatste 72 uurlijkse back-ups bewaren,
en de laatste back-up van elke kalenderdag gedurende 30 dagen, en de laatste back-up van elke kalender
week gedurende 52 weken. Als de back-upfrequentie eenmaal per dag was, obnam zou de back-up bewaren
van elk kalenderuur waarvoor een back-up is gemaakt, voor 72 van dergelijke back-ups. Met andere woorden,
het zou effectief de laatste 72 dagelijkse back-ups bewaren.

Klinkt verwarrend? Bedenk eens hoe verward de ontwikkelaar was bij het schrijven van de code.

Als er geen beleid wordt gegeven, vergeten zal alles bewaren.

Een typisch beleid zou kunnen zijn 72u,7d,5w,12m, wat betekent: bewaar de laatste 72 uurlijkse back-ups, de
laatste 7 dagelijkse back-ups, de laatste 5 wekelijkse back-ups en de laatste 12 maandelijkse back-ups. Als de
back-ups worden systematisch op uurbasis uitgevoerd, dit betekent dat er elk uur back-ups worden gemaakt
voor drie dagen, dagelijkse back-ups voor een week, wekelijkse back-ups voor een maand en maandelijkse back-ups
voor een jaar.

De manier waarop het beleid werkt, is een beetje ingewikkeld. Loop vergeten met de --doen alsof optie om
zorg ervoor dat u de juiste verwijdert.

gebruik encryptie
obnam kan alle gegevens versleutelen die het naar de back-uprepository schrijft. Het gebruikt GPG(1) te doen
de encryptie. U moet een sleutelpaar maken met behulp van GPG --gen-sleutel (of gebruik een bestaande
één), en vertel het dan obnam erover met behulp van de --versleutelen-met keuze. U mag optioneel
gebruik een aparte thuismap met behulp van de --gnupghome keuze. Standaard, de standaard
directory voor GPG(1) gebruikt.

Configuratie bestanden
obnam zoekt naar configuratiebestanden op een aantal locaties. Zie de sectie BESTANDEN
voor een lijst. Al deze bestanden samen worden behandeld als één groot bestand met de inhoud van allemaal
bestanden samengevoegd.

De bestanden zijn in INI-indeling en alleen de [configuratie] sectie wordt gebruikt (eventuele andere secties zijn
buiten beschouwing gelaten).

De lange namen van opties worden gebruikt als sleutels voor configuratievariabelen. Elke instelling dat
kan worden ingesteld vanaf de opdrachtregel kan worden ingesteld in een configuratiebestand, in de [configuratie]
pagina.

Bijvoorbeeld de opties in de volgende opdrachtregel:

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

kan worden vervangen door het volgende configuratiebestand:

[configuratie]
opslagplaats: /back-up
uitsluiten: .wav$

(Je kunt beide gebruiken foo=waarde or foe: waarde syntaxis in de bestanden.)

Het enige ongebruikelijke aan de bestanden is de manier waarop opties die vaak kunnen worden gebruikt, zijn
uitgedrukt. Alle waarden worden op één logische regel geplaatst, gescheiden door komma's (and
eventueel ook spaties). Bijvoorbeeld:

[configuratie]
uitsluiten = foo, bar, \.mp3$

Het bovenstaande heeft drie waarden voor de uitsluiten optie: alle bestanden die de woorden bevatten foo or
bars ergens in de volledig gekwalificeerde padnaam, of bestanden waarvan de naam eindigt op een punt en
mp3 (omdat de uitsluitingen reguliere expressies zijn).

Een lange logische regel kan worden opgesplitst in meerdere fysieke regels door een nieuwe regel te beginnen bij
witruimte en de vervolgregels laten inspringen:

[configuratie]
uitsluiten = foo,
bar,
\.mp3$

Het bovenstaande voorbeeld voegt drie uitsluitingspatronen toe.

meervoudig klanten en vergrendeling
obnam ondersteunt het delen van een repository tussen meerdere clients. De klanten kunnen de
bestandsinhoud (chunks), zodat als client A een back-up maakt van een groot bestand en client B de
hetzelfde bestand, dan hoeft B het grote bestand niet een tweede keer naar de repository te uploaden.
Om dit zonder verwarring te laten werken, gebruiken de clients een eenvoudig vergrendelingsprotocol dat dit mogelijk maakt
slechts één client tegelijk om de gedeelde gegevensstructuren te wijzigen. Sloten voorkomen niet
tegelijkertijd alleen-lezen toegang: hiermee kunt u herstellen terwijl iemand anders dat is
backing up.

Soms gebeurt het dat een alleen-lezen bewerking tegelijk toegang heeft tot een gegevensstructuur
wordt gewijzigd. Dit kan resulteren in een crash. Het zal niet resulteren in corrupte gegevens, of
onjuiste herstelt. Het is echter mogelijk dat u de alleen-lezen bewerking opnieuw moet starten na een
crash.

OPTIES

--altijd-herstellen-setuid
herstel setuid/setgid-bits in herstelde bestanden, zelfs als het geen root- of back-upbestand is
had een andere eigenaar dan de gebruiker die herstel uitvoerde

--no-altijd-herstel-setuid
tegenovergestelde van --always-restore-setuid

--klantnaam=KLANTNAAM
naam van client (standaard hostnaam)

--comprimeren-met=PROGRAMMA
gebruik PROGRAM om repository te comprimeren met (een van geen, leeglopen)

--kritieke leeftijd=LEEFTIJD
voor nagios-last-backup-age: maximale leeftijd (standaard in uren) voor de meest recente
back-up vóór statistiek is van cruciaal belang. Accepteert één tekeneenheidspecificatie (s,m,h,d voor
seconden, minuten, uren en dagen.

--dump-repo-bestand-metadata
dump metadata over bestanden?

--no-dump-repo-bestand-metadata
tegenovergestelde van --dump-repo-file-metadata

--genereer-manpage=TEMPLATE
ONDERDRUKHULP

--generatie=GENERATION
welke generatie te herstellen

-h, --help
toon dit helpbericht en sluit af

--houden=HOUDEN
beleid voor welke generaties te behouden bij vergeten

--lock-time-out=TIME-OUT
wacht bij het vergrendelen in de back-uprepository TIMEOUT seconden op een bestaande vergrendeling
ga weg voordat je opgeeft

--uitvoer=FILE
schrijf uitvoer naar BESTAND, in plaats van standaard uitvoer

--doen alsof, --oefening, --geen-act
verander eigenlijk niets (werkt alleen met back-up, vergeten en herstellen, en
kan slechts bij benadering echt gedrag simuleren)

--niet doen alsof, --geen droogloop, --nee-geen-act
tegenovergestelde van --doen alsof

--stil, --stil
wees stil: toon alleen foutmeldingen, geen voortgangsupdates

--niet-stil, --geen-stil
tegenovergestelde van --stil

-r, --opslagplaats=URL
naam van back-uprepository (kan padnaam of ondersteunde URL zijn)

--repository-formaat=FORMAT
gebruik FORMAT voor nieuwe repositories; een van de "6", "groene albatros"

--tot=TO
waar te herstellen of FUSE mount; voor herstel, moet leeg zijn of mag niet bestaan

--uitgebreid
wees breedsprakig: vertel de gebruiker meer over wat er aan de hand is en zorg er in het algemeen voor dat de gebruiker
is zich bewust van wat er gebeurt of in ieder geval dat er iets gebeurt en maakt het ook
ervoor zorgen dat hun scherm regelmatig wordt bijgewerkt en dat er veranderingen plaatsvinden
de hele tijd zodat ze zich niet vervelen en dat ze er zelfs door gefrustreerd raken
afgeleid worden door zoveel updates dat ze naar de Gobi-woestijn zullen verhuizen
leef onder een steen

--niet-uitgebreid
tegenovergestelde van --verbose

--verifiëren-willekeurig=N
controleer N bestanden willekeurig vanaf de back-up (standaard is nul, wat alles betekent)

--versie
toon het versienummer van het programma en sluit af

--waarschuw-leeftijd=LEEFTIJD
voor nagios-last-backup-age: maximale leeftijd (standaard in uren) voor de meest recente
back-up voordat de status een waarschuwing is. Accepteert één tekeneenheidspecificatie (s,m,h,d for
seconden, minuten, uren en dagen.

steun up
--controlepunt=SIZE
maak een checkpoint na een gegeven GROOTTE

--dedupliceren=MODE
vind dubbele gegevens in geback-upte gegevens en sla deze slechts één keer op; drie modi zijn
beschikbaar: dedupliceer nooit, controleer of er geen hash-botsingen plaatsvinden, of (de
standaard) accepteren fatalistisch het risico van botsingen

--uitsluiten=UITSLUITEN
reguliere expressie voor padnamen om uit te sluiten van back-up (kan meerdere
keer)

--uitsluiten-caches
sluit mappen (en hun submappen) uit die een CACHEDIR.TAG-bestand bevatten (zie
http://www.brynosaurus.com/cachedir/spec.html voor wat het moet bevatten, en
http://liw.fi/cachedir/ voor een hulpmiddel)

--geen-uitsluiten-caches
tegenovergestelde van --exclude-caches

--Uitsluiten van=FILE
lees patronen uit BESTAND uitsluiten

--erbij betrekken=BEVATTEN
reguliere expressie voor padnamen die vanuit een back-up moeten worden opgenomen, zelfs als deze overeenkomt met een
uitsluitingsregel (kan meerdere keren worden gebruikt)

--verlof-checkpoints
checkpoint-generaties achterlaten aan het einde van een succesvolle back-uprun

--geen-verlof-controlepunten
tegenovergestelde van --leave-checkpoints

--één-bestandssysteem
sluit mappen (en hun submappen) uit die zich in een ander bestandssysteem bevinden

--niemand-bestandssysteem
tegenovergestelde van --one-file-system

--wortel=URL
wat te back-uppen

--kleine-bestanden-in-btree
dit is alleen beschikbaar voor achterwaartse compatibiliteit; gebruik het niet en verwijder het
van uw configuratie

--geen-kleine-bestanden-in-btree
tegenovergestelde van --small-files-in-btree

Configuratie bestanden en settings
--config=FILE
voeg BESTAND toe aan configuratiebestanden

--dump-config
schrijf de gehele huidige configuratie uit

--dump-instellingsnamen
ONDERDRUKHULP

--Help iedereen
toon alle opties

--lijst-config-bestanden
ONDERDRUKHULP

--geen-standaard-configs
duidelijke lijst met te lezen configuratiebestanden

Ontwikkeling of Obnam zelf
--crashlimiet=COUNTER
het programma kunstmatig laten crashen nadat COUNTER-bestanden naar de repository zijn geschreven; dit
is handig voor het crashtesten van de applicatie en zou niet echt moeten worden ingeschakeld
gebruik; ingesteld op 0 om uit te schakelen (standaard uitgeschakeld)

--doen alsof-tijd=TIJDSTAMP
doe alsof het TIMESTAMP is (JJJJ-MM-DD UU:MM:SS); dit is alleen nuttig om te testen
doeleinden

--sftp-vertraging=SFTP-VERTRAGING
voeg een kunstmatige vertraging (in milliseconden) toe aan alle SFTP-overdrachten

--testen-mislukt-matching=REGEXP
ontwikkelingstesthulp: simuleer fouten tijdens back-up voor bestanden die overeenkomen
de gegeven reguliere expressies

--spoor=SPOOR
voeg toe aan bestandsnaampatronen waarvoor logboekregistratie van traceerfoutopsporing plaatsvindt

Encryptie
--versleutelen-met=ENCRYPT-MET
PGP-sleutel waarmee gegevens in de back-uprepository worden versleuteld

--gnupghome=HOMEDIR
thuismap voor GPG

--sleuteldetails
toon extra gebruikers-ID's voor alle sleutels

--geen-sleuteldetails
tegenovergestelde van --key-details

--keyid=SLEUTELID
PGP-sleutel-ID om toe te voegen aan/te verwijderen uit de back-uprepository

--symmetrische-sleutelbits=BITS
grootte van symmetrische sleutel, in bits

--zwak-willekeurig
gebruik /dev/urandom in plaats van /dev/random om symmetrische sleutels te genereren

--geen-zwak-willekeurig
tegenovergestelde van --zwak-willekeurig

Integriteit controleren (fsck)
--fsck-fix
moet fsck proberen problemen op te lossen? Impliceert --fsck-rm-unused

--no-fsck-fix
tegenovergestelde van --fsck-fix

--fsck-negeer-brokken
negeer chunks bij het controleren van de integriteit van de repository (neem aan dat alle chunks bestaan ​​en zijn
juist)

--no-fsck-negeer-brokken
tegenovergestelde van --fsck-ignore-chunks

--fsck-negeer-client=NAAM
controleer de repositorygegevens niet voor cient NAME

--fsck-alleen-laatste-generatie
controleer alleen de laatste generatie voor elke klant

--no-fsck-alleen-laatste-generatie
tegenovergestelde van --fsck-alleen-laatste-generatie

--fsck-rm-ongebruikt
moet fsck ongebruikte brokken verwijderen?

--no-fsck-rm-ongebruikt
tegenovergestelde van --fsck-rm-unused

--fsck-overslaan-checksums
controleer geen checksums van bestanden

--geen-fsck-overslaan-checksums
tegenovergestelde van --fsck-skip-checksums

--fsck-skip-directories
controleer niets over mappen en hun bestanden

--no-fsck-skip-dirs
tegenovergestelde van --fsck-skip-dirs

--fsck-bestanden overslaan
controleer niets over bestanden

--no-fsck-skip-bestanden
tegenovergestelde van --fsck-skip-files

--fsck-skip-generaties
controleer geen generaties

--geen-fsck-skip-generaties
tegenovergestelde van --fsck-skip-generations

--fsck-skip-per-client-b-bomen
controleer geen B-trees per klant

--no-fsck-skip-per-client-b-trees
tegenovergestelde van --fsck-skip-per-client-b-trees

--fsck-skip-gedeelde-b-trees
controleer gedeelde B-trees niet

--no-fsck-skip-shared-b-trees
tegenovergestelde van --fsck-skip-shared-b-trees

Logging
--log=FILE
schrijf log-items naar FILE (standaard is om helemaal geen log-bestanden te schrijven); gebruik "syslog"
om in het systeemlogboek te loggen, "stderr" om in de standaardfoutuitvoer te loggen, of "none" in
logboekregistratie uitschakelen

--logboek bijhouden=N
laatste N logs bijhouden (10)

--Log niveau=NIVEAU
log op NIVEAU, een van debuggen, info, waarschuwing, fout, kritiek, fataal (standaard: info)

--log-max=SIZE
roteer logs groter dan SIZE, nul voor nooit (standaard: 0)

--log-modus=MODE
stel machtigingen van nieuwe logbestanden in op MODE (octaal; standaard 0600)

Montage Met FUSE
--zekering-opt=FUSE
opties om rechtstreeks door te geven aan Fuse

peformance
--dump-geheugen-profiel=METHODE
maak geheugenprofileringsdumps met METHOD, wat een van is: geen, eenvoudig of meliae
(standaard: eenvoudig)

--geheugen-dump-interval=SECONDS
maak geheugenprofileringsdumps ten minste SECONDEN uit elkaar

Performance tweaken
--formaat van een blokje=SIZE
grootte van delen van bestandsgegevens waarvan een back-up is gemaakt

--chunkids-per-groep=NUM
codeer NUM stuk-ID's per groep

--idpath-bits=IDPATH-BITS
chunk id-niveau grootte

--idpath-diepte=IDPATH-DIEPTE
diepte van chunk id mapping

--idpath-overslaan=IDPATH-OVERSLAAN
chunk id mapping laagste bits overslaan

--lru-maat=SIZE
grootte van LRU-cache voor B-tree-knooppunten

--node-grootte=SIZE
grootte van B-boomknooppunten op schijf; heeft alleen invloed op nieuwe B-trees, dus het kan zijn dat u een
client of repository om dit te wijzigen voor bestaande repositories

--upload-wachtrij-grootte=SIZE
lengte van de uploadwachtrij voor B-tree-knooppunten

bewaarplaats formaat groen-albatros
--brokzak-formaat=SIZE
geschatte maximale grootte van een tas die veel stukken objecten combineert

--stuk-cache-grootte=SIZE
grootte van in-memory cache voor data chunk-objecten

--dir-bag-formaat=SIZE
geschatte maximale grootte van tassen die veel DIR-objecten combineren

--dir-cache-grootte=SIZE
grootte van in-memory cache voor DIR-objecten

SSH / SFTP
--pure-paramiko
gebruik openssh niet, zelfs als deze beschikbaar is, gebruik in plaats daarvan alleen paramiko

--geen-pure-paramiko
tegenovergestelde van --pure-paramiko

--ssh-opdracht=UITVOERBAAR
alternatief uitvoerbaar bestand dat moet worden gebruikt in plaats van "ssh" (volledig pad is toegestaan, nee
argumenten kunnen worden toegevoegd)

--ssh-host-sleutels-controle=WAARDE
Indien "ja", vereist dat de ssh-hostsleutel bekend en correct is om geaccepteerd te worden.
Indien "nee", hoeft u dat niet te eisen. Als "vragen" wordt de gebruiker interactief gevraagd om te accepteren
nieuwe gastheren. De standaard ("ssh-config") is om te vertrouwen op de instellingen van het onderliggende
SSH-client

--ssh-sleutel=BESTANDSNAAM
gebruik FILENAME als de ssh RSA privésleutel voor sftp-toegang (standaard is het gebruik van sleutels
bekend bij ssh-agent)

--ssh-bekende-hosts=BESTANDSNAAM
bestandsnaam van het bekende hosts-bestand van de gebruiker

--strikte-ssh-hostsleutels
VEROUDERD, gebruik in plaats daarvan --ssh-host-keys-check

--geen-strikte-ssh-host-sleutels
tegenovergestelde van --strict-ssh-host-keys

Keuze waarden
De SIZE waarde in bovengenoemde opties specificeert een grootte in bytes, met optional
achtervoegsels om kilobytes (k), kibibytes (Ki), megabytes (M), mebibytes (Mi), aan te geven
gigabytes (G), gibibytes (Gi), terabytes (T), tibibytes (Ti). De achtervoegsels zijn hoofdlettergebruik
ongevoelig.

EXIT STATUS

obnam zal afsluiten met nul als alles goed is gegaan, en anders niet nul.

MILIEU

obnam zal de omgeving die het van zijn ouder krijgt doorgeven, zonder wijziging. Het doet
gehoorzaamt niet aan ongebruikelijke omgevingsvariabelen, maar het gehoorzaamt wel aan de gebruikelijke tijdens het draaien
externe programma's, het maken van tijdelijke bestanden, enz.

Gebruik obnam online met behulp van onworks.net-services