borgbackup - Online in de cloud

PROGRAMMA:

NAAM

borg - BorgBackup is een deduplicerend back-upprogramma met optionele compressie en
geauthenticeerde encryptie.

Borg bestaat uit een aantal commando's. Elk commando accepteert een aantal argumenten en
opties. In de volgende secties wordt elke opdracht in detail beschreven.

ALGEMEEN

Type of inloggen uitgang
Het logniveau van de ingebouwde logconfiguratie is standaard ingesteld op WAARSCHUWING. Dit is zo omdat
we willen dat Borg meestal stil is en alleen waarschuwingen, fouten en kritieke berichten uitvoert.

Logniveaus: DEBUG < INFO < WAARSCHUWING < FOUT < KRITIEK

Te gebruiken --debuggen om het DEBUG-logniveau in te stellen - om debug, info, waarschuwing, fout en kritiek niveau te krijgen
uitgang.

Te gebruiken --info (of -v or --uitgebreid) om INFO-logniveau in te stellen - om info, waarschuwing, fout en . te krijgen
uitgang op kritisch niveau.

Te gebruiken --waarschuwing (standaard) om het logboekniveau WAARSCHUWING in te stellen - om waarschuwingen, fouten en kritieken te krijgen
niveau uitgang.

Te gebruiken --fout om het ERROR-logniveau in te stellen - om de uitvoer van fouten en kritieke niveaus te krijgen.

Te gebruiken --kritieke om KRITIEK logniveau in te stellen - om kritieke niveau-uitvoer te krijgen.

Terwijl je misc. log niveaus, verwacht niet dat elk commando anders zal geven
output op verschillende logniveaus - het is gewoon een mogelijkheid.

WAARSCHUWING:
Opties --critical en --error worden gegeven voor de volledigheid, hun gebruik is dat niet
aanbevolen omdat u belangrijke informatie zou kunnen missen.

WAARSCHUWING:
Hoewel sommige opties (zoals --statistieken or --lijst) zal meer informatieve berichten uitzenden, u
moeten INFO (of lager) logniveau gebruiken om ze in logoutput te laten verschijnen. Gebruik maken van -v of
logboekconfiguratie.

Retourneren codes
Borg kan afsluiten met de volgende retourcodes (rc):

0 = succes (gelogd als INFO)
1 = waarschuwing (de werking heeft zijn normale einde bereikt, maar er waren waarschuwingen -
u moet het logboek controleren, gelogd als WAARSCHUWING)
2 = fout (zoals een fatale fout, een lokale of externe uitzondering, de bewerking
heeft zijn normale einde niet bereikt, geregistreerd als ERROR)
128+N = gedood door signaal N (bijv. 137 == kill -9)

Als u gebruik maken van --show-rc, wordt de retourcode ook als laatste op het aangegeven niveau gelogd
logboek invoer.

Milieu Variabelen
Borg gebruikt enkele omgevingsvariabelen voor automatisering:

Algemeen:

BORG_REPO
Gebruik, indien ingesteld, de waarde om de standaard repository-locatie op te geven. Als een
commando heeft een archiefparameter nodig, je kunt het afkorten als ::archief. Als een
commando een repository-parameter nodig heeft, kunt u deze weglaten of
afkorten als ::, als een positionele parameter vereist is.

BORG_WACHTWOORD
Gebruik, indien ingesteld, de waarde om de vraag over de wachtwoordzin voor versleuteld te beantwoorden
opslagplaatsen.

BORG_DISPLAY_PASSPHRASE
Gebruik, indien ingesteld, de waarde om de "toon de wachtwoordzin voor" te beantwoorden
verificatie"-vraag bij het definiëren van een nieuwe wachtwoordzin voor versleuteld
opslagplaatsen.

BORG_LOGGING_CONF
Gebruik, indien ingesteld, de opgegeven bestandsnaam als INI-stijl logging configuratie.

BORG_RSH
Gebruik, indien ingesteld, deze opdracht in plaats van ssh. Dit kan worden gebruikt om ssh . te specificeren
opties, zoals een aangepast identiteitsbestand ssh -i /pad/naar/privé/sleutel. Zien man
ssh voor andere opties.

TMPDIR waar tijdelijke bestanden worden opgeslagen (heeft mogelijk veel tijdelijke ruimte nodig voor)
sommige operaties)

sommige automatisch antwoorders (als set, ze webmaster. beantwoorden bevestiging vragen):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=nee (of = ja)
Voor "Waarschuwing: poging tot toegang tot een voorheen onbekende niet-versleutelde"
opslagplaats"

BORG_RELOCATED_REPO_ACCESS_IS_OK=nee (of = ja)
Voor "Waarschuwing: de repository op locatie ... bevond zich voorheen op ..."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING=NEE (of =JA)
Voor "Waarschuwing: 'check --repair' is een experimentele functie die kan resulteren in
bij gegevensverlies."

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING=NEE (of =JA)
Voor "Je hebt gevraagd om de repository volledig te VERWIJDEREN waaronder allen
archieven die het bevat:"

Let op: antwoorden zijn hoofdlettergevoelig. het instellen van een ongeldige antwoordwaarde kan ofwel geven:
het standaardantwoord of u interactief vragen, afhankelijk van of nieuwe pogingen zijn
toegestaan ​​(ze zijn standaard toegestaan). Dus test uw scripts alstublieft interactief
voordat u er een niet-interactief script van maakt.

directories:

BORG_KEYS_DIR
Standaard op '~/.config/borg/sleutels'. Deze map bevat sleutels voor versleuteld
opslagplaatsen.

BORG_CACHE_DIR
Standaard op '~/.cache/borg'. Deze map bevat de lokale cache en
heeft mogelijk veel ruimte nodig om met grote repositories om te gaan).

Gebouw:

BORG_OPENSSL_PREFIX
Voegt de gegeven OpenSSL-headerbestandsmap toe aan de standaardlocaties
(setup.py).

BORG_LZ4_PREFIX
Voegt de gegeven LZ4-headerbestandsmap toe aan de standaardlocaties (setup.py).

Houd er rekening mee dat:

· wees zeer voorzichtig bij het gebruik van de "ja"-zeggers, de waarschuwingen met prompt bestaan ​​voor uw /
de beveiliging/veiligheid van uw gegevens

· wees ook heel voorzichtig wanneer u uw wachtwoordzin in een script plaatst, zorg ervoor dat het een
juiste bestandsrechten (bijv. modus 600, root:root).

Hulpmiddelen Gebruik
Borg kan veel bronnen gebruiken, afhankelijk van de grootte van de dataset die het behandelt
met.

CPU: Het zal niet verder gaan dan 100% van 1 core, aangezien de code momenteel single-threaded is.
Vooral hogere zlib- en lzma-compressieniveaus gebruiken aanzienlijke hoeveelheden CPU
cycli.

Geheugen (RAM):
De chunks-index en de bestandenindex worden om prestatieredenen in het geheugen ingelezen.
Compressie, bijv. lzma-compressie met hoge niveaus kan aanzienlijke hoeveelheden nodig hebben
van geheugen.

tijdelijk bestanden:
Het lezen van data en metadata van een FUSE-gemounte repository kost ongeveer de
dezelfde ruimte als de ontdubbelde chunks die werden gebruikt om ze in de repository weer te geven.

cache bestanden:
Bevat de chunks-index en bestandenindex (plus een gecomprimeerde verzameling van
single-archief chunk-indexen).

brokken inhoudsopgave:
Proportioneel aan de hoeveelheid gegevensbrokken in uw repo. Veel chunks in je repo
impliceren een grote brokken index. Het is mogelijk om de chunker-params aan te passen (zie create
opties).

Bestanden inhoudsopgave:
Proportioneel aan het aantal bestanden in uw laatste back-up. Uitschakelbaar (zie
maak opties), maar de volgende back-up zal veel langzamer zijn als u dat doet.

Netwerk:
Als uw repository extern is, worden alle gededupliceerde (en optioneel gecomprimeerde/
versleuteld) gegevens moeten natuurlijk over de verbinding gaan (ssh: repo url). als jij
gebruik een lokaal aangekoppeld netwerkbestandssysteem, daarnaast worden enkele kopieerbewerkingen gebruikt
voor transactieondersteuning ga ook over de verbinding. Als u een back-up maakt van meerdere bronnen
naar één doelrepository, vindt er extra verkeer plaats voor hersynchronisatie van de cache.

Als u geïnteresseerd bent in meer details, lees dan de interne documentatie.

Eenheden
Om hoeveelheden weer te geven, zorgt Borg ervoor dat de gebruikelijke schaalconventies worden gerespecteerd. Schijf
maten worden weergegeven in decimale, met machten van tien (dus kB betekent 1000 bytes). Voor geheugen
gebruik, binair voorvoegsels worden gebruikt en worden aangegeven met de IEC binair voorvoegselsgebruik
machten van twee (dus KiB betekent 1024 bytes).

Datum en Tijd
We formatteren datum en tijd conform ISO-8601, dat wil zeggen: JJJJ-MM-DD en UU:MM:SS (24u
klok).

Zie voor meer informatie daarover: https://xkcd.com/1179/

Tenzij anders vermeld, geven we de lokale datum en tijd weer. Intern bewaren en verwerken we
datum en tijd als UTC.

CREDIT INIT

gebruik: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [-e {none,keyfile,repokey}]
[OPSLAGPLAATS]

Een lege repository initialiseren

positionele argumenten:
REPOSITORY repository om aan te maken

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
-e {geen,sleutelbestand,repokey}, --encryption {geen,sleutelbestand,repokey}
selecteer de coderingssleutelmodus (standaard: "repokey")

Omschrijving
Deze opdracht initialiseert een lege repository. Een repository is een bestandssysteemmap
met de ontdubbelde gegevens van nul of meer archieven. Encryptie kan worden ingeschakeld op
initiatietijd van de repository.

Voorbeelden
# Lokale repository (standaard is om encryptie te gebruiken in repokey-modus)
$ borg init /pad/naar/repo

# Lokale repository (geen encryptie)
$ borg init --encryption=none /pad/naar/repo

# Externe repository (toegang tot een externe borg via ssh)
$ borg init gebruiker@hostnaam:backup

# Externe repository (sla de sleutel op in uw thuismap)
$ borg init --encryption=sleutelbestand gebruiker@hostnaam:backup

Belangrijke opmerkingen over encryptie:

Het wordt niet aanbevolen om encryptie uit te schakelen. Repository-encryptie beschermt u bijv
tegen het geval dat een aanvaller toegang heeft tot uw back-uprepository.

Maar wees voorzichtig met de sleutel / de wachtwoordzin:

Als u beveiliging met alleen een wachtwoordzin wilt, gebruikt u de opnieuw plaatsen modus. De sleutel wordt opgeslagen
in de repository (in het "config"-bestand). In het bovengenoemde aanvalsscenario is de
aanvaller heeft de sleutel (maar niet de wachtwoordzin).

Als u "wachtwoordzin en het hebben van de sleutel"-beveiliging wilt, gebruikt u de sleutelbestand modus. De sleutel zal
worden opgeslagen in uw thuismap (in .config/borg/sleutels). In het aanvalsscenario is de
aanvaller die alleen toegang heeft tot uw repo heeft de sleutel niet (en ook niet de
wachtwoordzin).

Maak een reservekopie van het sleutelbestand (sleutelbestand modus) of repo-configuratiebestand (opnieuw plaatsen modus) en
bewaar het op een veilige plaats, zodat u de sleutel nog hebt voor het geval deze beschadigd raakt of verloren gaat. Ook
bewaar de wachtwoordzin op een veilige plaats. De back-up die is versleuteld met die sleutel zal niet
helpen je daar natuurlijk bij.

Zorg ervoor dat u een goede wachtwoordzin gebruikt. Niet te kort, niet te simpel. De echte encryptie /
decoderingssleutel is versleuteld met / vergrendeld door uw wachtwoordzin. Als een aanvaller je
sleutel, kan hij deze niet ontgrendelen en gebruiken zonder de wachtwoordzin te kennen.

Wees voorzichtig met speciale of niet-ascii-tekens in uw wachtwoordzin:

· Borg verwerkt de wachtwoordzin als unicode (en codeert deze als utf-8), zodat deze geen
problemen met zelfs de vreemdste karakters.

· MAAR: dat is niet per se van toepassing op uw OS / VM / toetsenbordconfiguratie.

Gebruik dus beter een lange wachtzin gemaakt van eenvoudige ascii-tekens dan een die:
niet-ascii dingen of karakters die moeilijk/onmogelijk zijn in te voeren op een ander toetsenbord
lay-out.

U kunt uw wachtwoordzin voor bestaande repo's op elk moment wijzigen, dit heeft geen invloed op de
coderings-/decoderingssleutel of andere geheimen.

CREDIT CREATE

gebruik: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [-s] [-p] [--lijst]
[--filter STATUSCHARS] [-e PATROON]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--exclude-if-present FILENAME] [--keep-tag-files]
[-c SECONDEN] [-x] [--numeric-owner]
[--tijdstempel jjjj-mm-ddTuu:mm:ss]
[--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESSIE] [--read-special] [-n]
ARCHIEF PAD [PAD ...]

Nieuw archief maken

positionele argumenten:
ARCHIEF naam van te maken archief (moet ook een geldige zijn
mapnaam)
PATH-paden naar archief

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
-s, --stats print statistieken voor het aangemaakte archief
-p, --progress toont voortgangsweergave tijdens het maken van het archief,
met originele, gecomprimeerde en ontdubbelde formaten,
gevolgd door het aantal geziene bestanden en het pad
wordt verwerkt, standaard: False
--list output uitgebreide lijst met items (bestanden, mappen, ...)
--filter STATUSCHARS geeft alleen items weer met de gegeven statustekens
-e PATROON, --exclusief PATROON
paden uitsluiten die overeenkomen met PATTERN
--exclusief-van EXCLUDEFILE
lees patronen uitsluiten van EXCLUDEFILE, één per regel
--exclude-caches sluiten mappen uit die een CACHEDIR.TAG-bestand bevatten
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-if-present BESTANDSNAAM
mappen uitsluiten die het opgegeven bestand bevatten
--keep-tag-files bewaar tagbestanden van uitgesloten caches/mappen
-c SECONDEN, --controlepunt-interval SECONDEN
schrijf checkpoint elke SECONDEN seconden (standaard: 300)
-x, --één-bestandssysteem
blijf in hetzelfde bestandssysteem, kruis geen koppelpunten
--numeric-owner slaat alleen numerieke gebruikers- en groeps-ID's op
--tijdstempel jjjj-mm-ddTuu:mm:ss
geef handmatig de aanmaakdatum/-tijd van het archief op (UTC).
geef anders een referentiebestand/directory.
--chunker-parameter CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
specificeer de chunker-parameters. standaard: 19,23,21,4095
--ignore-inode negeer inode-gegevens in de metadata-cache van het bestand gebruikt om
onveranderde bestanden detecteren.
-C COMPRESSIE, --compressie COMPRESSIE
selecteer compressie-algoritme (en niveau): geen == nee
compressie (standaard), lz4 == lz4, zlib == zlib
(standaard niveau 6), zlib,0 .. zlib,9 == zlib (met
niveau 0..9), lzma == lzma (standaard niveau 6), lzma,0 ..
lzma,9 == lzma (met niveau 0..9).
--read-special open en lees speciale bestanden alsof ze normaal zijn
bestanden
-n, --dry-run maak geen back-uparchief

Omschrijving
Deze opdracht maakt een back-uparchief met alle bestanden die recursief zijn gevonden
alle opgegeven paden doorlopen. Het archief verbruikt bijna geen schijfruimte voor bestanden of
delen van bestanden die al in andere archieven zijn opgeslagen.

Om sneller back-ups te kunnen maken via sshfs en soortgelijke netwerkbestandssystemen die dat niet doen:
de juiste inode-informatie verstrekken, kan de vlag --ignore-inode worden gebruikt. Dit potentieel
vermindert de betrouwbaarheid van wijzigingsdetectie, terwijl wordt vermeden dat altijd alle bestanden worden gelezen op
deze bestandssystemen.

Zie de uitvoer van de opdracht "borg help patronen" voor meer hulp bij het uitsluiten van patronen.

Voorbeelden
# Back-up ~ / Documents in een archief met de naam "mijn-documenten"
$ borg create /path/to/repo::mijn-documenten ~ / Documents

# hetzelfde, maar een uitgebreide lijst van alle bestanden terwijl we ze verwerken
$ borg create -v --list /pad/naar/repo::mijn-documenten ~ / Documents

# Back-up ~ / Documents en ~/src maar sluit pyc-bestanden uit
$ borg create /pad/naar/repo::mijn-bestanden \
~ / Documents \
~/src \
--exclusief '*.pyc'

# Maak een back-up van thuismappen met uitzondering van afbeeldingsminiaturen (dwz alleen
# /huis/*/.thumbnails is uitgesloten, niet /huis/*/*/.miniaturen)
$ borg create /pad/naar/repo::mijn-bestanden / Home \
--exclusief 're:^/huis/[^/]+/\.thumbnails/'

# Doe hetzelfde met een shell-stijl patroon
$ borg create /pad/naar/repo::mijn-bestanden / Home \
--exclusief 'sh:/huis/*/.thumbnails'

# Maak een back-up van het rootbestandssysteem in een archief met de naam "root-YYYY-MM-DD"
# gebruik zlib-compressie (goed, maar traag) - standaard is geen compressie
$ borg create -C zlib,6 /pad/naar/repo::root-{nu:%Y-%m-%d} / --one-file-system

# Lever een grote inspanning in fijnkorrelige deduplicatie (big chunk management)
# overhead, heeft veel RAM en schijfruimte nodig, zie formule in internals
# docs - zelfde parameters als borg < 1.0 of zolder):
$ borg create --chunker-params 10,23,16,4095 /pad/naar/repo::small /smallstuff

# Maak een back-up van een onbewerkt apparaat (mag op dat moment niet actief/in gebruik/aangekoppeld zijn)
$ dd if=/dev/sdx bs=10M | borg create /pad/naar/repo::mijn-sdx -

# Geen compressie (standaard)
$ borg maak /path/to/repo::arch ~

# Supersnel, lage compressie
$ borg create --compressie lz4 /path/to/repo::arch ~

# Minder snel, hogere compressie (N = 0..9)
$ borg create --compressie zlib,N /path/to/repo::arch ~

# Nog langzamer, nog hogere compressie (N = 0..9)
$ borg create --compressie lzma,N /path/to/repo::arch ~

# Format-tags beschikbaar voor archiefnaam:
# {nu}, {utcnow}, {fqdn}, {hostnaam}, {gebruiker}, {pid}
# voeg korte hostnaam, back-up gebruikersnaam en huidige unixtime toe (seconden vanaf tijdperk)
$ borg maak /pad/naar/repo::{hostnaam}-{gebruiker}-{nu:%s} ~

CREDIT EXTRACT

gebruik: borg extract [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--list] [-n] [-e PATROON]
[--exclude-from EXCLUDEFILE] [--numerieke-eigenaar]
[--strip-componenten NUMBER] [--stdout] [--sparse]
ARCHIEF [PAD [PAD ...]]

Archiefinhoud uitpakken

positionele argumenten:
ARCHIEF archief om uit te pakken
PATH-paden om te extraheren; patronen worden ondersteund

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
--list output uitgebreide lijst met items (bestanden, mappen, ...)
-n, --dry-run veranderen eigenlijk geen bestanden
-e PATROON, --exclusief PATROON
paden uitsluiten die overeenkomen met PATTERN
--exclusief-van EXCLUDEFILE
lees patronen uitsluiten van EXCLUDEFILE, één per regel
--numeric-owner gehoorzaamt alleen aan numerieke gebruikers- en groeps-ID's
--strip-componenten NUMMER
Verwijder het opgegeven aantal voorlooppadelementen.
Padnamen met minder elementen zullen stil zijn
overgeslagen.
--stdout schrijf alle geëxtraheerde gegevens naar stdout
--sparse maak gaten in het uitvoerbare bestand van allemaal nul
brokken

Omschrijving
Deze opdracht extraheert de inhoud van een archief. Standaard is het hele archief
uitgepakt, maar een subset van bestanden en mappen kan worden geselecteerd door een lijst met door te geven PATH's
als argumenten. De bestandsselectie kan verder worden beperkt met behulp van de --uitsluiten optie.

Zie de uitvoer van de opdracht "borg help patronen" voor meer hulp bij het uitsluiten van patronen.

Voorbeelden
# Pak het hele archief uit
$ borg extract /pad/naar/repo::mijn-bestanden

# Extraheer het hele archief en geef bestanden weer tijdens het verwerken
$ borg extract -v --list /pad/naar/repo::mijn-bestanden

# Pak de map "src" uit
$ borg extract /pad/naar/repo::mijn-bestanden home/GEBRUIKERSNAAM/src

# Pak de map "src" uit, maar sluit objectbestanden uit
$ borg extract /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# Herstel een onbewerkt apparaat (mag op dat moment niet actief/in gebruik/aangekoppeld zijn)
$ borg extract --stdout /path/to/repo::my-sdx | dd van=/dev/sdx bs=10M

Opmerking: momenteel, extract altijd schrijft in de actueel werkzaam directory ("."),
dus zorg ervoor dat je cd naar de juiste plaats voordat u belt borg extract.

CREDIT BEKIJK

gebruik: borg check [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [--alleen repository] [--alleen archieven]
[--reparatie] [--ruimte besparen] [--laatste N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Controleer de consistentie van de opslagplaats

positionele argumenten:
REPOSITORY_OR_ARCHIVE
repository of archief om de consistentie van

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
--alleen repository alleen repository-controles uitvoeren
--archives-only voert alleen archiefcontroles uit
--reparatiepoging om gevonden inconsistenties te herstellen
--save-space werkt langzamer, maar gebruikt minder ruimte
--last N alleen laatste N archieven controleren (Standaard: alle)
-P VOORVOEGSEL, --voorvoegsel VOORVOEGSEL
houd alleen rekening met archiefnamen die met dit voorvoegsel beginnen

Omschrijving
Het check-commando verifieert de consistentie van een repository en de bijbehorende archieven.

Eerst worden de onderliggende databestanden van de repository gecontroleerd:

· Voor alle segmenten is de segmentmagie (header) aangevinkt

· Voor alle objecten die in de segmenten zijn opgeslagen, zijn alle metagegevens (bijv. crc en grootte) en alle gegevens
lezen. De gelezen gegevens worden gecontroleerd op grootte en CRC. Bitrot en andere soorten per ongeluk
schade kan op deze manier worden opgespoord.

· Als we ons in de reparatiemodus bevinden en een integriteitsfout wordt gedetecteerd voor een segment, proberen we om
haal zoveel mogelijk objecten uit het segment.

· In de reparatiemodus zorgt het ervoor dat de index consistent is met de gegevens die zijn opgeslagen in de
segmenten.

· Als u een externe repo-server gebruikt via ssh:, wordt de repo-controle uitgevoerd op de repo-server
zonder noemenswaardig netwerkverkeer te veroorzaken.

· De repositorycontrole kan worden overgeslagen met de optie --archives-only.

Ten tweede wordt de consistentie en correctheid van de archiefmetadata gecontroleerd:

· Is het repo-manifest aanwezig? Zo niet, dan wordt het opnieuw opgebouwd uit metadata-chunks uit het archief (dit
vereist het lezen en decoderen van alle metadata en data).

· Controleer of de metadata-chunk van het archief aanwezig is. zo niet, verwijder het archief uit het manifest.

· Controleer voor alle bestanden (items) in het archief, voor alle chunks waarnaar door deze bestanden wordt verwezen, of
chunk aanwezig is (als dat niet het geval is en we zijn in de reparatiemodus, vervang het dan door een chunk van dezelfde grootte)
nullen). Dit vereist het lezen van archief- en bestandsmetadata, maar geen data.

· Als we in reparatiemodus zijn en alle archieven hebben gecontroleerd: verwijder verweesde chunks van
de repo.

· als u een externe repo-server gebruikt via ssh:, wordt de archiefcontrole uitgevoerd op de client
machine (omdat als codering is ingeschakeld, de controles moeten worden gedecodeerd en dit
gebeurt altijd aan de clientzijde, omdat sleuteltoegang vereist is).

· De archiefcontroles kunnen tijdrovend zijn, ze kunnen worden overgeslagen met de
--repository-only optie.

CREDIT RENAME

gebruik: borg hernoemen [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--extern pad PATH]
ARCHIEF NIEUWENAAM

De naam van een bestaand archief wijzigen

positionele argumenten:
ARCHIEF archief om te hernoemen
NEWNAME de nieuwe archiefnaam om te gebruiken

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")

Omschrijving
Deze opdracht hernoemt een archief in de repository.

Voorbeelden
$ borg create /path/to/repo::archiefnaam ~
$ borglijst /pad/naar/repo
archiefnaam ma, 2016-02-15 19:50:19

$ borg hernoemen /pad/naar/repo::archiefnaam nieuwe naam
$ borglijst /pad/naar/repo
nieuwe naam ma, 2016-02-15 19:50:19

CREDIT LIJST

gebruik: borg lijst [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [--kort] [--lijstformaat LISTFORMAT]
[-P VOORKEUR]
[REPOSITORY_OR_ARCHIVE]

Lijst archief of repository inhoud

positionele argumenten:
REPOSITORY_OR_ARCHIVE
repository/archief om de inhoud van . weer te geven

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
--korte alleen bestands-/mapnamen afdrukken, niets anders
--lijst-formaat LISTFORMAT
specificeer formaat voor archiefbestandslijst (standaard:
"{mode} {user:6} {group:6} {size:8d} {isomtime}
{path}{extra}{NEWLINE}") Er bestaat een speciale "{formatkeys}"
om beschikbare sleutels weer te geven
-P VOORVOEGSEL, --voorvoegsel VOORVOEGSEL
houd alleen rekening met archiefnamen die met dit voorvoegsel beginnen

Omschrijving
Dit commando geeft een overzicht van de inhoud van een repository of een archief.

Voorbeelden
$ borglijst /pad/naar/repo
maandag ma, 2016-02-15 19:15:11
repo ma, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nieuwe naam ma, 2016-02-15 19:50:19
...

$ borglijst /pad/naar/repo::root-2016-02-15
drwxr-xr-x root root 0 ma, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 ma, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 do, 2014-11-13 00:08:51 bin/bash
lrwxrwxrwx root root 0 vr, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 vr, 2015-03-27 20:24:22 bin/bzdiff
...

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

# kijk wat er is gewijzigd tussen archieven, op basis van de wijzigingstijd, grootte en bestandspad van het bestand
$ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archiefA
$ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archiefB
$ diff -y /tmp/lijst.archiveA /tmp/lijst.archiveB
1422781200 0 . 1422781200 0 .
1422781200 0 code 1422781200 0 code
1422781200 0 code/mijnproject 1422781200 0 code/mijnproject
1422781200 1416192 code/mijnproject/bestand.ext | 1454664653 1416192 code/mijnproject/bestand.ext
...

CREDIT VERWIJDEREN

gebruik: borg delete [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [-p] [-s] [-c] [--ruimte opslaan]
[DOELWIT]

Een bestaande repository of archief verwijderen

positionele argumenten:
TARGET-archief of repository om te verwijderen

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
-p, --progress show voortgangsweergave tijdens het verwijderen van een enkel archief
-s, --stats print statistieken voor het verwijderde archief
-c, --cache-only verwijder alleen de lokale cache voor de gegeven repository
--save-space werkt langzamer, maar gebruikt minder ruimte

Omschrijving
Dit commando verwijdert een archief uit de repository of de volledige repository. Schijf
ruimte wordt dienovereenkomstig teruggewonnen. Als u de volledige repository verwijdert, wordt de lokale cache voor
het (indien aanwezig) wordt ook verwijderd.

Voorbeelden
# verwijder een enkel back-uparchief:
$ borg verwijderen /pad/naar/repo::maandag

# verwijder de hele repository en de gerelateerde lokale cache:
$ borg verwijderen /pad/naar/repo
Je hebt gevraagd om de repository *inclusief* alle archieven die het bevat volledig te VERWIJDEREN:
repo ma, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nieuwe naam ma, 2016-02-15 19:50:19
Typ 'JA' als je dit begrijpt en verder wilt gaan: JA

CREDIT SNOEIEN

gebruik: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [-n] [-s] [--lijst]
[--houd-binnen BINNEN] [-H UUR] [-d DAGELIJKS] [-w WEKELIJKS]
[-m MAANDELIJKS] [-y JAARLIJKS] [-P PREFIX] [--save-space]
[OPSLAGPLAATS]

Snoei repository-archieven volgens gespecificeerde regels

positionele argumenten:
REPOSITORY repository om te snoeien

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
-n, --dry-run verander de repository niet
-s, --stats print statistieken voor het verwijderde archief
--lijst output uitgebreide lijst van archieven die het bewaart/snoeit
--bewaar-binnen BINNEN bewaar alle archieven binnen dit tijdsinterval
-HUURLIJK, --houd-uur UURLIJK
aantal te bewaren archieven per uur
-d DAGELIJKS, --houd-dagelijks DAGELIJKS
aantal dagelijkse archieven om te bewaren
-w WEKELIJKS, --houd-wekelijks WEKELIJKS
aantal wekelijkse archieven dat moet worden bewaard
-m MAANDELIJKS, --houd-maandelijks MAANDELIJKS
aantal maandelijkse archieven dat moet worden bewaard
-y JAARLIJKS, --houd-jaarlijks JAARLIJKS
aantal jaarlijkse archieven dat moet worden bewaard
-P VOORVOEGSEL, --voorvoegsel VOORVOEGSEL
houd alleen rekening met archiefnamen die met dit voorvoegsel beginnen
--save-space werkt langzamer, maar gebruikt minder ruimte

Omschrijving
Het prune-commando snoeit een repository door archieven te verwijderen die niet overeenkomen met een van de
gespecificeerde bewaarmogelijkheden. Deze opdracht wordt normaal gesproken gebruikt door geautomatiseerde back-upscripts
een bepaald aantal historische back-ups willen bewaren.

"-d 7" betekent bijvoorbeeld dat u de laatste back-up op elke dag bewaart, tot 7 meest recente
dagen met back-ups (dagen zonder back-ups tellen niet mee). De regels worden toegepast vanaf uur
tot jaarlijks, en back-ups die door eerdere regels zijn geselecteerd, tellen niet mee voor die van later
reglement. De tijd die elke back-up voltooit, wordt gebruikt voor snoeidoeleinden. Data en tijden
worden geïnterpreteerd in de lokale tijdzone, en weken gaan van maandag tot zondag. a . specificeren
negatief aantal te bewaren archieven betekent dat er geen limiet is.

De optie "--keep-within" heeft een argument van de vorm " ", waar char "H" is,
"d", "w", "m", "y". Bijvoorbeeld, "--keep-within 2d" betekent het bewaren van alle archieven die
gemaakt in de afgelopen 48 uur. Met "1m" wordt "31d" bedoeld. De archieven bewaard bij
deze optie telt niet mee voor de totalen gespecificeerd door andere opties.

Als een prefix is ​​ingesteld met -P, worden alleen archieven die met de prefix beginnen in aanmerking genomen
voor verwijdering en alleen die archieven tellen mee voor de totalen gespecificeerd door de regels.
Anders, allen archieven in de repository zijn kandidaten voor verwijdering!

Voorbeelden
Wees voorzichtig, snoeien is een potentieel gevaarlijke opdracht, het zal back-uparchieven verwijderen.

De standaardinstelling van snoeien is om van toepassing te zijn op: allen archief in de bewaarplaats tenzij je het beperkt
bewerking naar een subset van de archieven met behulp van --voorvoegsel. Tijdens gebruik --voorvoegsel, wees voorzichtig om
kies een goed voorvoegsel - gebruik bijvoorbeeld geen voorvoegsel "foo" als u niet ook wilt overeenkomen
"foob".

Het wordt sterk aanbevolen om altijd te rennen snoeien --oefening ... eerst zodat je zult zien wat het is
zou doen zonder dat het echt iets zou doen.

# Bewaar 7 einde van de dag en 4 extra einde van de week archieven.
# Voer een test uit zonder daadwerkelijk iets te verwijderen.
$ borg snoeien --dry-run --keep-daily=7 --keep-weekly=4 /path/to/repo

# Hetzelfde als hierboven, maar alleen van toepassing op archiefnamen die beginnen met "foo":
$ borg snoeien --keep-daily=7 --keep-weekly=4 --prefix=foo /pad/naar/repo

# Bewaar 7 einde van de dag, 4 extra einde van de week archieven,
# en een einde van de maand archief voor elke maand:
$ borg snoeien --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /pad/naar/repo

# Bewaar alle back-ups van de afgelopen 10 dagen, 4 extra archieven aan het einde van de week,
# en een einde van de maand archief voor elke maand:
$ borg snoeien --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /path/to/repo

CREDIT INFO

gebruik: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--extern pad PATH]
ARCHIEF

Archiefdetails weergeven, zoals gebruikte schijfruimte

positionele argumenten:
ARCHIEF archief om informatie weer te geven over

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")

Omschrijving
Deze opdracht geeft wat gedetailleerde informatie weer over het opgegeven archief.

Voorbeelden
$ borg info /pad/naar/repo::root-2016-02-15
Naam: wortel-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Hostnaam: mijnhostnaam
Gebruikersnaam: root
Tijd (start): ma, 2016-02-15 19:36:29
Tijd (einde): ma, 2016-02-15 19:39:26
Opdrachtregel: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
Aantal bestanden: 38100

Origineel formaat Gecomprimeerd formaat Gedupliceerd formaat
Dit archief: 1.33 GB 613.25 MB 571.64 MB
Alle archieven: 1.63 GB 853.66 MB 584.12 MB

Unieke brokjes Totaal brokjes
Brokkenindex: 36858 48844

CREDIT MOUNT

gebruik: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-f] [-o OPTIES]
REPOSITORY_OR_ARCHIVE MOUNTPOINT

Koppel archief of een volledige repository als een FUSE-bestandssysteem

positionele argumenten:
REPOSITORY_OR_ARCHIVE
repository/archief om te mounten
MOUNTPOINT waar het bestandssysteem moet worden gemount

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
-f, --voorgrond blijf op de voorgrond, niet demoniseren
-o OPTIES Extra montage opties

Omschrijving
Deze opdracht koppelt een archief aan als een FUSE-bestandssysteem. Dit kan handig zijn om te browsen en
individuele bestanden archiveren of herstellen. Tenzij de --voorgrond optie krijgt het commando
zal op de achtergrond draaien totdat het bestandssysteem is niet gemonteerd.

Voorbeelden
$ borg mount /pad/naar/repo::root-2016-02-15 /tmp/mymountpoint
$ ls /tmp/mijnmountpoint
bin boot etc home lib lib64 verloren+gevonden media mnt opt ​​root sbin srv tmp usr var
$ fusermount -u /tmp/mijnmountpoint

CREDIT WACHTZIN WIJZIGEN

gebruik: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--geen bestanden-cache] [--umask M]
[--extern pad PATH]
[OPSLAGPLAATS]

Wachtwoordzin voor repositorysleutelbestand wijzigen

positionele argumenten:
OPSLAGPLAATS

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")

Omschrijving
De sleutelbestanden die worden gebruikt voor repository-codering zijn optioneel beveiligd met een wachtwoordzin. Dit
commando kan worden gebruikt om deze wachtwoordzin te wijzigen.

Voorbeelden
# Maak een met sleutelbestand beveiligde repository
$ borg init --encryption=sleutelbestand -v /pad/naar/repo
Repository initialiseren op "/path/to/repo"
Voer een nieuwe wachtwoordzin in:
Voer dezelfde wachtwoordzin nogmaals in:
Onthoud uw wachtwoordzin. Zonder zijn uw gegevens niet toegankelijk.
Toets "/root/.config/borg/keys/mnt_backup" aangemaakt.
Bewaar deze sleutel goed. Zonder zijn uw gegevens niet toegankelijk.
Brokkencache synchroniseren...
Archieven: 0, zonder cache Idx: 0, zonder verouderde Idx: 0, zonder cache Idx: 0.
Gereed.

# Wijzig de wachtwoordzin van het sleutelbestand
$ borg wijzigingswachtwoord -v /pad/naar/repo
Voer wachtwoordzin in voor sleutel /root/.config/borg/keys/mnt_backup:
Voer een nieuwe wachtwoordzin in:
Voer dezelfde wachtwoordzin nogmaals in:
Onthoud uw wachtwoordzin. Zonder zijn uw gegevens niet toegankelijk.
Sleutel bijgewerkt

CREDIT DIENEN

gebruik: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--extern pad PATH] [--beperken-tot-pad PATH]

Begin in servermodus. Deze opdracht wordt meestal niet handmatig gebruikt.

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
--beperken-tot-pad PATH
beperk de toegang tot de opslagplaats tot PATH

Omschrijving
Met deze opdracht wordt een repository-serverproces gestart. Dit commando wordt meestal niet gebruikt
handmatig.

Voorbeelden
borg serve heeft speciale ondersteuning voor geforceerde ssh-commando's (zie geautoriseerde_sleutels voorbeeld
hieronder): het zal detecteren dat u zo'n geforceerd commando gebruikt en de waarde van de . extraheren
--beperken-tot-pad optie(s). Het zal dan het originele commando ontleden dat afkomstig was van de
klant, zorgt ervoor dat het ook is borg dienen en dwing padbeperking(en) af zoals gegeven door
het gedwongen commando. Op die manier kunnen andere opties die door de klant worden gegeven (zoals --info or --umasker)
worden bewaard (en worden niet opgelost door het geforceerde commando).

# Sta toe dat een SSH-sleutelpaar alleen borg uitvoert en alleen toegang heeft tot /path/to/repo.
# Gebruik de belangrijkste opties om onnodige en potentieel gevaarlijke SSH-functionaliteit uit te schakelen.
# Dit zal helpen om een ​​geautomatiseerd back-upsysteem op afstand te beveiligen.
$ kat ~/.ssh/geautoriseerde_sleutels
command="borg serve --restrict-to-path /path/to/repo",no-pty,no-agent-forwarding,no-port-forwarding,no-X11-forwarding,no-user-rc ssh-rsa AAAAB3[...]

CREDIT UPGRADE

gebruik: borg upgrade [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--pad op afstand PATH] [-p] [-n] [-i]
[OPSLAGPLAATS]

een repository upgraden van een vorige versie

positionele argumenten:
REPOSITORY pad naar de te upgraden repository

optionele argumenten:
-h, --help toon dit helpbericht en sluit af
--kritiek werk op logniveau KRITIEK
--fout bij werken op logniveau ERROR
--waarschuwing werk op logniveau WAARSCHUWING (standaard)
--info, -v, --verbose
werk op logniveau INFO
--debug werk op log niveau DEBUG
--lock-wait N wacht op het slot, maar max. N seconden (standaard: 1).
--show-rc toon/log de retourcode (rc)
--no-files-cache laad/update de bestandsmetadata-cache die werd gebruikt om
onveranderde bestanden detecteren
--umask M zet umask op M (lokaal en op afstand, standaard: 0077)
--remote-path PATH stelt extern pad in op uitvoerbaar (standaard: "borg")
-p, --progress show voortgangsweergave tijdens het upgraden van de repository
-n, --dry-run verander de repository niet
-i, --inplace rewrite repository op zijn plaats, zonder kans om te gaan
terug naar oudere versies van de repository.

Omschrijving
Upgrade een bestaande Borg-repository. Dit ondersteunt momenteel het omzetten van een zolder
repository naar Borg en helpt ook bij het converteren van Borg 0.xx naar 1.0.

Momenteel kunnen alleen LOKALE opslagplaatsen worden geüpgraded (uitgave #465).

Het zal de magische snaren in de segmenten van de repository veranderen om overeen te komen met de nieuwe Borg-magie
snaren. De sleutelbestanden gevonden in $ATTIC_KEYS_DIR of ~/.zolder/sleutels/ zal ook worden omgezet
en gekopieerd naar $BORG_KEYS_DIR of ~/.config/borg/sleutels.

De cachebestanden worden geconverteerd, van $ATTIC_CACHE_DIR of ~/.cache/zolder naar $BORG_CACHE_DIR
or ~/.cache/borg, maar de cache-indeling tussen Borg en Attic is gewijzigd, dus het is mogelijk
de eerste back-up na de conversie duurt langer dan verwacht vanwege de hersynchronisatie van de cache.

Upgrade zou in staat moeten zijn om te hervatten als het wordt onderbroken, hoewel het over het algemeen nog steeds zal herhalen
segmenten. Als je helemaal opnieuw wilt beginnen, gebruik dan borg verwijderen over de gekopieerde repository naar
zorg ervoor dat de cachebestanden ook worden verwijderd:
borg verwijder borg

Tenzij --in situ is opgegeven, maakt het upgradeproces eerst een reservekopie van de
repository, in REPOSITORY.upgrade-DATETIME, met behulp van hardlinks. Dit duurt langer dan in
upgrades plaatsen, maar is veel veiliger en geeft voortgangsinformatie (in tegenstelling tot cp -naar de).
Zodra u tevreden bent met de conversie, kunt u de reservekopie veilig vernietigen.

WAARSCHUWING: Als u de upgrade uitvoert, wordt de huidige kopie onbruikbaar met oudere
versie, zonder de mogelijkheid om terug te gaan naar eerdere versies. Dit kan PERMANENT SCHADE AAN UW
OPSLAGPLAATS! Zolder KAN BORG REPOSITORIES NIET LEZEN, omdat de magische snaren zijn veranderd. Jij
zijn gewaarschuwd.

Voorbeelden
# Upgrade de borg-repository naar de meest recente versie.
$ borg upgrade -v /pad/naar/repo
een hardlink-kopie maken in /path/to/repo.upgrade-2016-02-15-20:51:55
zolderopslag openen met borg en ombouwen
geen sleutelbestand gevonden voor repository
repo-index /pad/naar/repo/index.0 converteren
1 segmenten converteren...
borg 0.xx converteren naar borgstroom
geen sleutelbestand gevonden voor repository

DIVERSE KLANTENSERVICE

borg hulp patronen
Uitsluitingspatronen ondersteunen vier afzonderlijke stijlen, fnmatch, shell, reguliere expressies en
pad voorvoegsels. Indien gevolgd door een dubbele punt (':') worden de eerste twee tekens van een patroon gebruikt
als stijlkiezer. Expliciete stijlselectie is nodig wanneer een niet-standaardstijl is
gewenst of wanneer het gewenste patroon begint met twee alfanumerieke tekens gevolgd door a
dubbele punt (dwz aa:iets/*).

Fnmatch, kiezer FM:
Deze patronen gebruiken een variant van de shell-patroonsyntaxis, waarbij '*' overeenkomt met een willekeurig aantal
tekens, '?' overeenkomen met een enkel teken, '[...]' overeenkomen met een enkel teken
opgegeven, inclusief bereiken, en '[!...]' die overeenkomt met een willekeurig teken dat niet is opgegeven. Voor de
doel van deze patronen, het padscheidingsteken ('' voor Windows en '/' op andere systemen)
wordt niet speciaal behandeld. Wikkel meta-tekens tussen haakjes voor een letterlijke overeenkomst (bijv
[?] overeenkomen met het letterlijke karakter ?). Om een ​​pad overeen te laten komen met een patroon, moet het:
volledig overeenkomen van begin tot eind, of moet overeenkomen van het begin tot net voor een pad
scheidingsteken. Behalve het hoofdpad, zullen paden nooit eindigen in het padscheidingsteken wanneer:
matching wordt geprobeerd. Dus als een bepaald patroon eindigt in een padscheidingsteken, is een '*'
toegevoegd voordat er wordt geprobeerd te matchen.

Shell-stijl patronen, selector sch:
Net als fnmatch-patronen zijn deze vergelijkbaar met shell-patronen. Het verschil is dat de
patroon kan omvatten: ** / voor het matchen van nul of meer directoryniveaus, * voor het matchen van nul
of meer willekeurige tekens, met uitzondering van een padscheidingsteken.

Reguliere expressies, selector re:
Reguliere expressies vergelijkbaar met die in Perl worden ondersteund. In tegenstelling tot schaalpatronen
reguliere expressies zijn niet vereist om overeen te komen met het volledige pad en eventuele subtekenreeksen
is voldoende. Het wordt sterk aanbevolen om patronen aan het begin ('^'), aan de
einde ('$') of beide. Padscheidingstekens ('' voor Windows en '/' op andere systemen) in paden
worden altijd genormaliseerd naar een schuine streep ('/') voordat een patroon wordt toegepast. de gewone
expressiesyntaxis wordt beschreven in de Python documentatie For de re module.

Voorvoegsel pad, selector p.p.:
Deze patroonstijl is handig om hele submappen te matchen. Het patroon pp:/data/balk
lucifers /data/balk en alles daarin.

Uitsluitingen kunnen worden doorgegeven via de opdrachtregeloptie --uitsluiten. Bij gebruik van binnenuit
shell de patronen moeten worden aangehaald om ze te beschermen tegen uitzetting.

De --Uitsluiten van optie staat het laden van uitsluitingspatronen uit een tekstbestand toe met één
patroon per regel. Regels leeg of beginnend met het hekje ('#') na het verwijderen
witruimte aan beide uiteinden worden genegeerd. Het optionele voorvoegsel van de stijlkiezer wordt ook ondersteund
voor patronen die uit een bestand zijn geladen. Vanwege witruimte-verwijderingspaden met witruimte aan de
begin of einde kan alleen worden uitgesloten met reguliere expressies.

Voorbeelden:

# Sluit '/home/user/file.o' uit maar niet '/home/user/file.odt': $ borg create -e '
*
.o' back-up /

# Sluit '/home/user/junk' en '/home/user/subdir/junk' uit, maar # niet
'/home/user/importantjunk' of '/etc/junk': $ borg create -e '/huis/
*
/junk' back-up /

# Sluit de inhoud van '/home/user/cache' uit, maar niet de map zelf: $ borg create
-e /home/gebruiker/cache/back-up /

# Het bestand '/home/user/cache/important' is niet back-up: $ borg create -e
/home/gebruiker/cache/back-up / /home/gebruiker/cache/belangrijk

# De inhoud van mappen in '/ Home' worden niet geback-upt wanneer hun naam # eindigt op
'.tmp' $ borg create --exclude 're:^/huis/[^/]+.tmp/' back-up /

# Uitsluitingen laden uit bestand $ cat >exclude.txt < /huis//rommel * .tmp
fm:aa:iets/ opnieuw:^/huis/[^/].tmp/sh:/huis/
*
/.thumbnails EOF $ borg create --exclude-from include.txt back-up /

DEBUG COMMANDO'S

Er zijn nog enkele commando's (allemaal beginnend met "debug-") die allemaal niet bestemde For
een . en mogelijk zeer gevaarlijk indien verkeerd gebruikt.

Ze bestaan ​​om de foutopsporingsmogelijkheden te verbeteren zonder directe toegang tot het systeem, bijvoorbeeld voor het geval
u ooit een ernstige storing tegenkomt. Gebruik ze alleen als u weet wat u doet of
als een vertrouwde Borg-ontwikkelaar je vertelt wat je moet doen.

EXTRA OPMERKINGEN

Hier zijn diversen. opmerkingen over onderwerpen die misschien niet voldoende gedetailleerd worden behandeld in het gebruik
pagina.

item vlaggen
borg en je merk te creëren -v --lijst geeft een uitgebreide lijst van alle bestanden, mappen en andere bestanden weer
systeemitems die het in overweging nam (ongeacht of ze inhoudswijzigingen hadden of niet). voor elk
item, wordt voorafgegaan door een vlag van één letter die het type en/of de status van het item aangeeft.

Als u alleen geïnteresseerd bent in een subset van die uitvoer, kunt u bijv --filter=AME en
het toont alleen reguliere bestanden met de A-, M- of E-status (zie hieronder).

Een hoofdletter vertegenwoordigt de status van een normaal bestand ten opzichte van de "bestanden"
cache (niet relatief aan de repo -- dit is een probleem als de bestandscache niet wordt gebruikt).
Metadata wordt in ieder geval opgeslagen en voor 'A' en 'M' worden ook nieuwe data chunks opgeslagen. Voor
'U' alle data chunks verwijzen naar reeds bestaande chunks.

· 'A' = normaal bestand, toegevoegd (zie ook a_status_oddity in de FAQ)

· 'M' = normaal bestand, gewijzigd

· 'U' = normaal bestand, ongewijzigd

· 'E' = normaal bestand, er is een fout opgetreden tijdens het openen/lezen dit filet

Een kleine letter betekent een ander bestandstype dan een gewoon bestand, meestal alleen
slaat hun metadata op:

· 'd' = map

· 'b' = apparaat blokkeren

· 'c' = char-apparaat

· 'h' = normaal bestand, hardlink (naar reeds geziene inodes)

· 's' = symbolische link

· 'f' = fifo

Andere vlaggen gebruikt zijn onder meer:

· 'i' = back-upgegevens zijn gelezen van standaardinvoer (stdin)

· '-' = droogloop, item was niet gebackupt

· '?' = ontbrekende statuscode (als je dit ziet, dien dan een bugrapport in!)

--chunker-params
De chunker-params beïnvloeden hoe invoerbestanden in stukjes (brokken) worden geknipt die vervolgens
overwogen voor ontdubbeling. Ze hebben ook een grote impact op het gebruik van bronnen (RAM en schijf)
ruimte) aangezien de hoeveelheid benodigde middelen (ook) wordt bepaald door de totale hoeveelheid
chunks in de repository (zie Indexen / caches geheugen gebruik voor details).

--chunker-params=10,23,16,4095 resulteert in een fijnmazige deduplicatie en creëert een grote
hoeveelheid brokken en gebruikt dus veel middelen om ze te beheren. Dit is goed voor
relatief kleine datavolumes en als de machine een goede hoeveelheid vrije RAM en schijf heeft
ruimte.

--chunker-params=19,23,21,4095 (standaard) resulteert in een grofkorrelige deduplicatie en
creëert een veel kleinere hoeveelheid brokken en gebruikt dus minder middelen. Dit is goed voor
relatief grote datavolumes en als de machine een relatief lage hoeveelheid vrij RAM heeft en
schijf ruimte.

Als je al een aantal archieven in een repository hebt gemaakt en je de chunker-parameters wijzigt,
dit heeft natuurlijk gevolgen voor deduplicatie, omdat de brokken anders worden gesneden.

In het ergste geval (alle bestanden zijn groot en zijn tussen de back-ups door aangeraakt), wordt dit opgeslagen
alle inhoud weer in de repository.

Meestal is het echter niet zo erg:

· meestal worden de meeste bestanden niet aangeraakt, dus het zal gewoon de oude chunks hergebruiken die het al heeft
in de repo

· bestanden kleiner dan de (zowel oude als nieuwe) minimale chunkgrootte resulteren in slechts één chunk
hoe dan ook, dus de resulterende chunks zijn hetzelfde en deduplicatie is van toepassing

Als je van chunker-parameter wisselt om bronnen te sparen voor een bestaande repo die er al een heeft
back-uparchieven, zult u na verloop van tijd een toenemend effect zien, wanneer steeds meer bestanden
zijn aangeraakt en opnieuw opgeslagen met de grotere chunksize en alle verwijzingen naar de
kleinere oudere brokken zijn verwijderd (door archieven te verwijderen/snoeien).

Als u direct een groot effect op het gebruik van hulpbronnen wilt zien, kunt u beter een nieuwe beginnen
repository bij het wijzigen van chunker-parameters.

Zie chunker_details voor meer informatie.

--lees-speciaal
De optie --lees-speciaal is niet bedoeld voor normaal, bestandssysteemniveau (volledig of
gedeeltelijk recursieve) back-ups. Je geeft deze optie alleen als je liever iets wilt doen
... speciaal -- en als je een aantal bestanden met de hand hebt uitgekozen die je op die manier wilt behandelen.

borg en je merk te creëren --lees-speciaal zal alle bestanden openen zonder enige speciale behandeling
volgens het bestandstype (de enige uitzondering hier zijn mappen: ze worden herhaald
naar binnen). Stel je eens voor wat er gebeurt als je dat doet hoe bestandsnaam --- de inhoud die u daar zult zien
is wat borg zal back-uppen voor die bestandsnaam.

Zo worden bijvoorbeeld symbolische links gevolgd, wordt de inhoud van het blokapparaat gelezen, benoemde leidingen
/ UNIX domein sockets worden gelezen.

Je moet voorzichtig zijn met wat je als bestandsnaam geeft bij gebruik --lees-speciaal, bijv. als
jij geeft /dev/nul, wordt uw back-up nooit beëindigd.

De metadata van de gegeven bestanden wordt opgeslagen zoals het zou worden opgeslagen zonder --lees-speciaal (bijv. zijn
naam, de grootte [kan 0 zijn], de modus, enz.) -- maar daarnaast ook de inhoud lezen
ervan zal ervoor worden bewaard.

Het herstellen van de inhoud van dergelijke bestanden wordt momenteel slechts één voor één ondersteund via --stdout
optie (en je moet stdout omleiden naar waar het ook heen zal gaan, misschien rechtstreeks naar een
bestaand apparaatbestand naar keuze of indirect via dd).

Voorbeeld
Stel u voor dat u enkele momentopnamen hebt gemaakt van logische volumes (LV's) waarvan u een back-up wilt maken.

NOTITIE:
Voor sommige scenario's is dit een goede methode om "crash-achtige" consistentie te krijgen (ik noem het
crash-achtig omdat het hetzelfde is als je zou krijgen als je gewoon op de reset-knop drukt of
uw machine zou abrupt en volledig crashen). Dit is beter dan geen consistentie
helemaal niet en een goede methode voor sommige use-cases, maar waarschijnlijk niet goed genoeg als je hebt
databases draaien.

Vervolgens maakt u een back-uparchief van al deze snapshots. Het back-upproces ziet een
"bevroren" staat van de logische volumes, terwijl de processen in de originele volumes werken
ga door met het wijzigen van de gegevens die daar zijn opgeslagen.

Je voegt ook de uitvoer van toe lvdisplay naar uw back-up, zodat u de LV-groottes kunt zien voor het geval dat
je moet ze ooit opnieuw maken en herstellen.

Nadat de back-up is voltooid, verwijdert u de snapshots weer.

$ # maak hier snapshots
$ lvdisplay > lvdisplay.txt
$ borg create --read-special /pad/naar/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$ # verwijder snapshots hier

Laten we nu eens kijken hoe we sommige LV's van zo'n back-up kunnen herstellen.

$ borg extract /pad/naar/repo::arch lvdisplay.txt
$ # maak hier lege LV's met de juiste afmetingen (kijk in lvdisplay.txt).
$ # we gaan ervan uit dat je een lege root en home LV hebt gemaakt en deze nu overschrijven:
$ borg extract --stdout /path/to/repo::arch dev/vg0/root-snapshot > /dev/vg0/root
$ borg extract --stdout /path/to/repo::arch dev/vg0/home-snapshot > /dev/vg0/home

Alleen toevoegen mode
Een repository kan "append-only" worden gemaakt, wat betekent dat Borg nooit zal overschrijven of
vastgelegde gegevens verwijderen. Dit is handig voor scenario's waarin meerdere machines een back-up maken tot a
centrale back-upserver met behulp van borg dienen, aangezien een gehackte machine geen back-ups kan verwijderen
permanent.

Bewerk de repository om de modus voor alleen toevoegen te activeren config bestand en voeg een regel toe alleen_toevoegen=1
aan de [opslagplaats] sectie (of bewerk de regel als deze bestaat).

In de append-only modus maakt Borg een transactielogboek in de transacties bestand, waar
elke regel is een transactie en een UTC-tijdstempel.

Voorbeeld
Stel dat een aanvaller op afstand alle back-ups heeft verwijderd, maar uw repository was in append-only
modus. Een transactielogboek kan er in deze situatie als volgt uitzien:

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

Uit uw beveiligingslogboeken concludeert u dat de aanvaller om 15:54:00 toegang heeft gekregen en dat alle
back-ups waar verwijderd of vervangen door gecompromitteerde back-ups. Uit het logboek weet je dat
transacties 11 en later worden gecompromitteerd. Merk op dat de transactie-ID de naam is van de
laatste bestand in de transactie. Transactie 11 omvat bijvoorbeeld bestanden 6 tot en met 11.

Bij een echte aanval wil je waarschijnlijk de gecompromitteerde repository intact houden om te analyseren
wat de aanvaller probeerde te bereiken. Het is ook een goed idee om deze kopie te maken voor het geval dat
er gaat iets mis tijdens het herstel. Aangezien herstel wordt gedaan door enkele bestanden te verwijderen, is a
harde link kopie (cp -naar de) is voldoende.

De eerste stap om de repository te resetten naar transactie 5, de laatste compromisloze
transactie, is het verwijderen van de hints.N en index.N bestanden in de repository (deze twee bestanden
zijn altijd vervangbaar). In dit voorbeeld is N 13.

Verwijder of verplaats vervolgens alle segmentbestanden uit de segmentmappen in date / beginnend met
bestand 6:

rm-gegevens/**/{6..13}

Dat is alles.

Nadelen
Omdat gegevens alleen worden toegevoegd en niets wordt verwijderd, kunnen opdrachten als: snoeien or verwijderen zal niet vrijkomen
schijfruimte, ze taggen alleen gegevens als verwijderd in een nieuwe transactie.

Merk op dat u heen en weer kunt gaan tussen normaal en alleen toevoegen door te bewerken
het configuratiebestand, is het geen "enkele reis".

Verder overwegingen
Alleen toevoegen-modus wordt niet gerespecteerd door andere tools dan Borg. rm werkt nog steeds op de
opslagplaats. Zorg ervoor dat back-upclientmachines alleen toegang krijgen tot de repository via
borg dienen.

Zorg ervoor dat er geen externe toegang mogelijk is als de repository tijdelijk is ingesteld op normaal
modus voor bijvoorbeeld regelmatig snoeien.

Verdere beveiligingen kunnen worden geïmplementeerd, maar vallen buiten het bereik van Borgs. Bijvoorbeeld bestand
systeem snapshots of inpakken borg dienen om speciale machtigingen of ACL's in te stellen voor nieuwe gegevens
bestanden.

Gebruik borgbackup online met behulp van onworks.net-services