borgbackup - Online nel cloud

PROGRAMMA:

NOME

borg - BorgBackup è un programma di backup deduplicato con compressione opzionale e
crittografia autenticata.

Borg consiste in una serie di comandi. Ogni comando accetta un numero di argomenti e
opzioni. Le sezioni seguenti descriveranno in dettaglio ciascun comando.

GENERALE

Tipologia of ceppo produzione
Il livello di registro della configurazione di registrazione incorporata è predefinito su AVVISO. Questo è perché
vogliamo che Borg sia per lo più silenzioso e che emetta solo avvisi, errori e messaggi critici.

Livelli di registro: DEBUG < INFO < AVVISO < ERRORE < CRITICO

Usa il - debug per impostare il livello di registro DEBUG - per ottenere debug, informazioni, avvisi, errori e livello critico
produzione.

Usa il --Informazioni (o -v or --verboso) per impostare il livello di registro INFO - per ottenere informazioni, avvisi, errori e
uscita di livello critico.

Usa il --avvertimento (predefinito) per impostare il livello di registro di AVVISO - per ottenere avvisi, errori e critici
uscita di livello.

Usa il --errore per impostare il livello di registro ERRORE - per ottenere l'errore e l'output del livello critico.

Usa il --critico per impostare il livello di registro CRITICO - per ottenere un output di livello critico.

Mentre puoi impostare misc. livelli di log, non aspettarti che ogni comando dia diversi
output su diversi livelli di registro: è solo una possibilità.

ATTENZIONE:
Le opzioni --critical e --error sono fornite per completezza, il loro utilizzo no
consigliato in quanto potresti perdere informazioni importanti.

ATTENZIONE:
Mentre alcune opzioni (come --statistiche or --elenco) emetterà più messaggi informativi, tu
è necessario utilizzare il livello di log INFO (o inferiore) per farli apparire nell'output del log. Utilizzo -v o
configurazione della registrazione.

Reso codici
Borg può uscire con i seguenti codici di ritorno (rc):

0 = successo (registrato come INFO)
1 = avviso (l'operazione ha raggiunto la fine normale, ma ci sono stati avvisi -
dovresti controllare il log, registrato come WARNING)
2 = errore (come un errore fatale, un'eccezione locale o remota, l'operazione
non ha raggiunto la fine normale, registrato come ERRORE)
128+N = ucciso dal segnale N (es. 137 == kill -9)

Se si utilizza --mostra-rc, anche il codice di ritorno viene registrato al livello indicato come ultimo
voce di registro.

Ambiente Variabili
Borg utilizza alcune variabili d'ambiente per l'automazione:

Generale:

BORG_REPO
Quando impostato, utilizzare il valore per fornire la posizione del repository predefinita. Se un
il comando ha bisogno di un parametro di archivio, puoi abbreviare come ::archivio. Se una
il comando ha bisogno di un parametro del repository, puoi lasciarlo via o
abbreviare come ::, se è richiesto un parametro posizionale.

BORG_PASSPHRASE
Quando impostato, usa il valore per rispondere alla domanda sulla passphrase per criptato
repository.

BORG_DISPLAY_PASSPHRASE
Quando è impostato, utilizzare il valore per rispondere a "visualizza la passphrase per
verifica" domanda quando si definisce una nuova passphrase per crittografato
repository.

BORG_LOGGING_CONF
Quando impostato, usa il nome file dato come INIconfigurazione di registrazione in stile.

BORG_RSH
Quando impostato, usa questo comando invece di SSH. Questo può essere usato per specificare ssh
opzioni, come un file di identità personalizzato SSH -i /percorso/di/chiave/privata. Vedere uomo
SSH per altre opzioni.

TMPDIR dove sono archiviati i file temporanei (potrebbe aver bisogno di molto spazio temporaneo per
alcune operazioni)

Alcuni automaticamente in Sistemi risponditori (Se impostato, di automaticamente rispondere conferma domande):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=n (o =si)
Per "Avviso: tentativo di accedere a un file non crittografato precedentemente sconosciuto
deposito"

BORG_RELOCATED_REPO_ACCESS_IS_OK=n (o =si)
Per "Avviso: il repository nella posizione ... era precedentemente situato in ..."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING=NO (o =SI)
Per "Attenzione: 'check --repair' è una funzione sperimentale che potrebbe risultare
nella perdita di dati".

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING=NO (o =SI)
Per "Hai richiesto di ELIMINARE completamente il repository Compreso contro tutti i
archivi che contiene:"

Nota: le risposte fanno distinzione tra maiuscole e minuscole. l'impostazione di un valore di risposta non valido potrebbe dare
la risposta predefinita o chiederti in modo interattivo, a seconda che i tentativi siano
consentiti (sono consentiti per impostazione predefinita). Quindi, per favore, prova i tuoi script in modo interattivo
prima di renderli uno script non interattivo.

Directory:

BORG_KEYS_DIR
Predefinito su '~/.Config/Borg/Keys'. Questa directory contiene chiavi per criptare
repository.

BORG_CACHE_DIR
Predefinito su '~/.cache/borg'. Questa directory contiene la cache locale e
potrebbe aver bisogno di molto spazio per gestire grandi repository).

Costruzione:

BORG_OPENSSL_PREFIX
Aggiunge la directory del file di intestazione OpenSSL data alle posizioni predefinite
(setup.py).

BORG_LZ4_PREFIX
Aggiunge la directory del file di intestazione LZ4 data alle posizioni predefinite (setup.py).

Nota bene:

· prestare molta attenzione quando si utilizzano i dicitori "sì", gli avvisi con prompt esistono per il tuo /
la sicurezza/protezione dei tuoi dati

· stai anche molto attento quando inserisci la tua passphrase in uno script, assicurati che lo abbia
permessi file appropriati (es. modalità 600, root:root).

Gestione Impiego
Borg potrebbe utilizzare molte risorse a seconda delle dimensioni del set di dati che sta trattando
con.

CPU: Non andrà oltre il 100% di 1 core poiché il codice è attualmente a thread singolo.
I livelli di compressione zlib e lzma particolarmente elevati utilizzano quantità significative di CPU
cicli.

Memorie (R.A.M):
L'indice dei blocchi e l'indice dei file vengono letti in memoria per motivi di prestazioni.
Compressione, spec. la compressione lzma con livelli elevati potrebbe richiedere quantità sostanziali
di memoria.

Temporaneo File:
La lettura di dati e metadati da un repository montato su FUSE consumerà circa il
stesso spazio dei blocchi deduplicati utilizzati per rappresentarli nel repository.

Cache File:
Contiene l'indice dei blocchi e l'indice dei file (più una raccolta compressa di
indici di blocco di archivio singolo).

Bocconcini indice:
Proporzionale alla quantità di blocchi di dati nel repository. Un sacco di pezzi nel tuo repository
implicano un grosso indice di blocchi. È possibile modificare i parametri del chunker (vedi create
opzioni).

File indice:
Proporzionale alla quantità di file nell'ultimo backup. Può essere spento (vedi
create options), ma il prossimo backup sarà molto più lento se lo fai.

Network:
Se il tuo repository è remoto, tutto deduplicato (e facoltativamente compresso/
crittografati) i dati ovviamente devono passare attraverso la connessione (ssh: repo url). Se tu
utilizzare un filesystem di rete montato localmente, inoltre vengono utilizzate alcune operazioni di copia
per il supporto delle transazioni, vai anche oltre la connessione. Se esegui il backup di più fonti
a un repository di destinazione, si verifica traffico aggiuntivo per la risincronizzazione della cache.

Se sei interessato a maggiori dettagli, leggi la documentazione interna.

Unità
Per visualizzare le grandezze, Borg si preoccupa di rispettare le consuete convenzioni di scala. Disco
le dimensioni sono visualizzate in decimale, usando potenze di dieci (quindi kB significa 1000 byte). Per memoria
utilizzo, binario prefissi sono utilizzati, e sono indicati utilizzando il IEC binario prefissi, utilizzando
potenze di due (quindi KiB significa 1024 byte).

Data ed Ora
Formattiamo data e ora in conformità a ISO-8601, ovvero: AAAA-MM-GG e HH:MM:SS (24h
orologio).

Per ulteriori informazioni a riguardo, vedere: https://xkcd.com/1179/

Se non diversamente specificato, mostriamo la data e l'ora locali. Internamente, immagazziniamo ed elaboriamo
data e ora come UTC.

BORGO INIT

utilizzo: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PATH] [-e {none,keyfile,repokey}]
[REPOSITIVO]

Inizializza un repository vuoto

argomenti posizionali:
REPOSITORY repository da creare

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
-e {none,keyfile,repokey}, --encryption {none,keyfile,repokey}
seleziona la modalità chiave di crittografia (predefinito: "repokey")

Descrizione
Questo comando inizializza un repository vuoto. Un repository è una directory del filesystem
contenente i dati deduplicati da zero o più archivi. La crittografia può essere abilitata su
tempo di inizializzazione del repository.

Esempi
# Repository locale (l'impostazione predefinita è utilizzare la crittografia in modalità repokey)
$ borg init /percorso/a/repo

# Repository locale (nessuna crittografia)
$ borg init --encryption=none /percorso/del/repo

# Repository remoto (accede a un borg remoto tramite ssh)
$ borg init utente@nomehost:backup

# Repository remoto (memorizza la chiave nella tua home directory)
$ borg init --encryption=file chiavi utente@nomehost:backup

Note importanti sulla crittografia:

Non è consigliabile disabilitare la crittografia. La crittografia del repository ti protegge ad es
contro il caso in cui un utente malintenzionato abbia accesso al tuo archivio di backup.

Ma attenzione alla chiave/passphrase:

Se vuoi la sicurezza "solo passphrase", usa il repoke modalità. La chiave verrà memorizzata
all'interno del repository (nel suo file "config"). Nello scenario di attacco sopra menzionato, il
l'attaccante avrà la chiave (ma non la passphrase).

Se vuoi la sicurezza "passphrase e avere la chiave", usa il file di chiavi modalità. La chiave sarà
essere memorizzato nella tua directory home (in .config/borg/keys). Nello scenario di attacco, il
l'attaccante che ha appena accesso al tuo repository non avrà la chiave (e nemmeno il
frase d'accesso).

Fare una copia di backup del file chiave (file di chiavi mode) o il file di configurazione del repository (repoke modalità) e
conservalo in un luogo sicuro, in modo da avere ancora la chiave nel caso venga danneggiato o perso. Anche
conservare la passphrase in un luogo sicuro. Il backup crittografato con quella chiave non lo farà
aiutarti in questo, ovviamente.

Assicurati di utilizzare una buona passphrase. Non troppo breve, non troppo semplice. La vera crittografia /
la chiave di decrittazione è crittografata con / bloccata dalla tua passphrase. Se un attaccante ti prende
chiave, non può sbloccarla e usarla senza conoscere la passphrase.

Fai attenzione ai caratteri speciali o non ascii nella tua passphrase:

· Borg elabora la passphrase come unicode (e la codifica come utf-8), quindi non ha
problemi a gestire anche i personaggi più strani.

· MA: ciò non si applica necessariamente alla configurazione del sistema operativo/VM/tastiera.

Quindi è meglio usare una passphrase lunga composta da semplici caratteri ascii piuttosto che una che includa
cose o caratteri non ascii difficili da inserire su una tastiera diversa
layout.

Puoi modificare la tua passphrase per i repository esistenti in qualsiasi momento, non influirà sul
chiave di crittografia/decrittografia o altri segreti.

BORGO CREA

utilizzo: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [-s] [-p] [--list]
[--filter STATUSCHARS] [-e PATTERN]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--exclude-if-present NOMEFILE] [--keep-tag-files]
[-c SECONDI] [-x] [--numeric-proprietario]
[--timestamp aaaa-mm-ggThh:mm:ss]
[--parametri-chunker CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESSIONE] [--read-special] [-n]
PERCORSO ARCHIVIO [PERCORSO ...]

Crea nuovo archivio

argomenti posizionali:
ARCHIVE nome dell'archivio da creare (deve essere anche un valido
nome della directory)
PATH percorsi per l'archiviazione

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
-s, --stats stampa le statistiche per l'archivio creato
-p, --progress mostra lo stato di avanzamento durante la creazione dell'archivio,
che mostra le dimensioni originale, compressa e deduplicata,
seguito dal Numero di file visti e dal percorso
in elaborazione, impostazione predefinita: False
--list output elenco dettagliato di elementi (file, directory, ...)
--filter STATUSCHARS visualizza solo gli elementi con i caratteri di stato indicati
-e MODELLO, --exclude MODELLO
escludere percorsi corrispondenti a PATTERN
--exclude-from EXCLUDEFILE
leggi i pattern di esclusione da EXCLUDEFILE, uno per riga
--exclude-caches esclude le directory che contengono un file CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-if-present NOMEFILE
escludere le directory che contengono il file specificato
--keep-tag-files mantiene i file di tag delle cache/directory escluse
-c SECONDI, --checkpoint-interval SECONDI
scrivi checkpoint ogni SECONDI secondi (predefinito: 300)
-x,-un sistema di file
rimani nello stesso file system, non incrociare i punti di montaggio
--numeric-owner memorizza solo identificatori numerici di utenti e gruppi
--timestamp aaaa-mm-ggThh:mm:ss
specificare manualmente la data/ora di creazione dell'archivio (UTC).
in alternativa, fornire un file/directory di riferimento.
--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
specificare i parametri del chunker. predefinito: 19,23,21,4095
--ignore-inode ignora i dati inode nella cache dei metadati del file usata per
rilevare i file non modificati.
-C COMPRESSIONE, --compressione COMPRESSIONE
seleziona algoritmo di compressione (e livello): nessuno == no
compressione (predefinito), lz4 == lz4, zlib == zlib
(livello predefinito 6), zlib,0 .. zlib,9 == zlib (con
livello 0..9), lzma == lzma (livello predefinito 6), lzma,0 ..
lzma,9 == lzma (con livello 0..9).
--read-special apre e legge file speciali come se fossero normali
file
-n, --dry-run non crea un archivio di backup

Descrizione
Questo comando crea un archivio di backup contenente tutti i file trovati in modo ricorsivo
attraversando tutti i percorsi specificati. L'archivio non consumerà quasi spazio su disco per i file o
parti di file che sono già state archiviate in altri archivi.

Per accelerare l'estrazione di backup su sshf e file system di rete simili che non lo fanno
fornire informazioni corrette sull'inode è possibile utilizzare il flag --ignore-inode. Questo potenzialmente
riduce l'affidabilità del rilevamento delle modifiche, evitando di leggere sempre tutti i file su
questi file system.

Vedere l'output del comando "borg help patterns" per ulteriori informazioni sui pattern di esclusione.

Esempi
# Backup ~ / Documenti in un archivio chiamato "my-documents"
$ borg crea /percorso/del/repo::miei-documenti ~ / Documenti

# uguale, ma elenca dettagliatamente tutti i file mentre li elaboriamo
$ borg create -v --list /percorso/di/repo::miei-documenti ~ / Documenti

# Backup ~ / Documenti ed ~/sorgente ma escludi i file pyc
$ borg crea /percorso/del/repo::my-files \
~ / Documenti \
~/sorgente \
--exclude '*.pyc'

# Backup delle directory home escluse le miniature delle immagini (cioè solo
# /casa/*/.thumbnails è escluso, no /casa/*/*/.miniature)
$ borg crea /percorso/del/repo::my-files / Home \
--exclude 're:^/casa/[^/]+/\.miniature/'

# Fai lo stesso usando un modello in stile shell
$ borg crea /percorso/del/repo::my-files / Home \
--exclude 'sh:/casa/*/.miniature'

# Esegui il backup del filesystem di root in un archivio chiamato "root-YYYY-MM-DD"
# usa la compressione zlib (buona, ma lenta) - l'impostazione predefinita è nessuna compressione
$ borg create -C zlib,6 /percorso/del/repo::root-{ora:%Y-%m-%d} / --one-file-system

# Fare un grande sforzo nella deduplicazione granulare fine (gestione di grossi blocchi
# sovraccarico, richiede molta RAM e spazio su disco, vedere la formula in interni
# docs - stessi parametri di borg < 1.0 o attic):
$ borg create --chunker-params 10,23,16,4095 /percorso/del/repo::small /smallstuff

# Backup di un dispositivo raw (non deve essere attivo/in uso/montato in quel momento)
$ dd se=/dev/sdx bs=10M | borg create /path/to/repo::my-sdx -

# Nessuna compressione (impostazione predefinita)
$ borg crea /percorso/del/repo::arch ~

# Super veloce, bassa compressione
$ borg create --compression lz4 /percorso/del/repo::arch ~

# Meno veloce, compressione maggiore (N = 0..9)
$ borg create --compression zlib,N /percorso/del/repo::arch ~

# Compressione ancora più lenta, ancora più alta (N = 0..9)
$ borg create --compression lzma,N /percorso/del/repo::arch ~

# Tag di formato disponibili per il nome dell'archivio:
# {now}, {utcnow}, {fqdn}, {hostname}, {utente}, {pid}
# aggiungi nome host breve, nome utente di backup e unixtime corrente (secondi dall'epoca)
$ borg crea /percorso/del/repo::{nomehost}-{utente}-{ora:%s} ~

BORGO ESTRATTO

utilizzo: borg extract [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [--list] [-n] [-e PATTERN]
[--exclude-from EXCLUDEFILE] [--proprietario-numerico]
[--strip-components NUMERO] [--stdout] [--sparse]
ARCHIVIO [PERCORSO [PERCORSO ...]]

Estrai il contenuto dell'archivio

argomenti posizionali:
ARCHIVIO archivio da estrarre
PATH percorsi da estrarre; i modelli sono supportati

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
--list output elenco dettagliato di elementi (file, directory, ...)
-n, --dry-run non modifica alcun file
-e MODELLO, --exclude MODELLO
escludere percorsi corrispondenti a PATTERN
--exclude-from EXCLUDEFILE
leggi i pattern di esclusione da EXCLUDEFILE, uno per riga
--numeric-owner obbedisce solo agli identificatori numerici dell'utente e del gruppo
--strip-components NUMERO
Rimuove il numero specificato di elementi del percorso iniziale.
I nomi di percorso con meno elementi saranno silenziosi
saltato.
--stdout scrive tutti i dati estratti su stdout
--sparse crea buchi nel file sparse di output da tutto zero
pezzi

Descrizione
Questo comando estrae il contenuto di un archivio. Per impostazione predefinita, l'intero archivio è
estratto ma è possibile selezionare un sottoinsieme di file e directory passando un elenco di PERCORSI
come argomenti. La selezione del file può essere ulteriormente limitata utilizzando il pulsante --escludere opzione.

Vedere l'output del comando "borg help patterns" per ulteriori informazioni sui pattern di esclusione.

Esempi
# Estrai l'intero archivio
$ borg estrarre /percorso/al/repo::my-files

# Estrai l'intero archivio ed elenca i file durante l'elaborazione
$ borg extract -v --list /percorso/del/repo::my-files

# Estrai la directory "src"
$ borg extract /percorso/del/repo::my-files home/USERNAME/src

# Estrai la directory "src" ma escludi i file oggetto
$ borg extract /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# Ripristina un dispositivo raw (non deve essere attivo/in uso/montato in quel momento)
$ borg extract --stdout /path/to/repo::my-sdx | dd di=/dev/sdx bs=10M

Nota: attualmente, estratto sempre scrive ai miglioramenti , il corrente lavoro elenco ("."),
quindi assicurati di cd nel posto giusto prima di chiamare borg estratto.

BORGO CONTROLLO

utilizzo: borg check [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [--solo-repository] [--solo-archivi]
[--ripara] [--save-space] [--last N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Controlla la consistenza del repository

argomenti posizionali:
REPOSITORY_OR_ARCHIVE
repository o archivio per verificarne la consistenza

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
--repository-only esegue solo controlli del repository
--archives-only esegue solo controlli sugli archivi
--riparazione tentativo di riparare eventuali incongruenze trovate
--save-space funziona più lentamente, ma usa meno spazio
--last N controlla solo gli ultimi N archivi (predefinito: tutti)
-P PREFISSO, --prefisso PREFISSO
considera solo i nomi degli archivi che iniziano con questo prefisso

Descrizione
Il comando check verifica la consistenza di un repository e degli archivi corrispondenti.

Innanzitutto, vengono controllati i file di dati del repository sottostante:

· Per tutti i segmenti è selezionata la magia del segmento (intestazione)

· Per tutti gli oggetti memorizzati nei segmenti, tutti i metadati (ad es. crc e dimensioni) e tutti i dati sono
leggere. I dati letti vengono controllati per dimensione e CRC. Bit rot e altri tipi di accidentale
i danni possono essere rilevati in questo modo.

· Se siamo in modalità di riparazione e viene rilevato un errore di integrità per un segmento, proviamo a
recuperare quanti più oggetti possibile dal segmento.

· In modalità di riparazione, si assicura che l'indice sia coerente con i dati memorizzati nel
segmenti.

· Se si utilizza un server repository remoto tramite ssh:, il controllo del repository viene eseguito sul server del repository
senza causare un traffico di rete significativo.

· Il controllo del repository può essere saltato utilizzando l'opzione --archives-only.

In secondo luogo, viene verificata la coerenza e la correttezza dei metadati dell'archivio:

· È presente il manifest repo? In caso contrario, viene ricostruito da blocchi di metadati di archivio (questo
richiede la lettura e la decrittografia di tutti i metadati e i dati).

· Controllare se è presente un blocco di metadati di archivio. in caso contrario, rimuovere l'archivio dal manifest.

· Per tutti i file (elementi) nell'archivio, per tutti i blocchi a cui fanno riferimento questi file, controlla se
è presente un pezzo (in caso contrario e siamo in modalità di riparazione, sostituirlo con un pezzo della stessa dimensione di
zero). Ciò richiede la lettura dei metadati dell'archivio e del file, ma non dei dati.

· Se siamo in modalità di riparazione e abbiamo controllato tutti gli archivi: elimina i blocchi orfani da
il repo.

· se si utilizza un server repository remoto tramite ssh:, il controllo dell'archivio viene eseguito sul client
macchina (perché se la crittografia è abilitata, i controlli richiederanno la decrittografia e questo
viene sempre fatto lato client, perché sarà richiesto l'accesso con la chiave).

· I controlli dell'archivio possono richiedere molto tempo, possono essere saltati utilizzando il
--opzione solo repository.

BORGO RINOMINARE

utilizzo: borg rename [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO]
ARCHIVIO NUOVONOME

Rinomina un archivio esistente

argomenti posizionali:
ARCHIVIO archivio da rinominare
NEWNAME il nuovo nome dell'archivio da usare

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")

Descrizione
Questo comando rinomina un archivio nel repository.

Esempi
$ borg create /percorso/al/repo::nomearchivio ~
$ borg list /percorso/al/repo
nomearchivio Lun, 2016-02-15 19:50:19

$ borg rinomina /percorso/del/repo::nomearchivio nuovonome
$ borg list /percorso/al/repo
nuovo nome Lun, 2016-02-15 19:50:19

BORGO ELENCO

utilizzo: borg list [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PATH] [--short] [--list-format LISTFORMAT]
[-P PREFISSO]
[REPOSITORY_OR_ARCHIVE]

Elenca i contenuti dell'archivio o del repository

argomenti posizionali:
REPOSITORY_OR_ARCHIVE
repository/archivio per elencare i contenuti di

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
--short stampa solo i nomi di file/directory, nient'altro
--list-format FORMATOELENCO
specificare il formato per l'elenco dei file di archivio (predefinito:
"{modalità} {utente:6} {gruppo:6} {dimensione:8d} {isomtime}
{path}{extra}{NEWLINE}") "{formatkeys}" speciale esiste
per elencare le chiavi disponibili
-P PREFISSO, --prefisso PREFISSO
considera solo i nomi degli archivi che iniziano con questo prefisso

Descrizione
Questo comando elenca il contenuto di un repository o di un archivio.

Esempi
$ borg list /percorso/al/repo
lunedì lun, 2016-02-15 19:15:11
repo Lun, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nuovo nome Lun, 2016-02-15 19:50:19
...

$ lista borg /percorso/del/repo::root-2016-02-15
drwxr-xr-x root root 0 lun, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 Lun, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 gio, 2014-11-13 00:08:51 bin/bash
lrwxrwxrwx root root 0 Ven, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Ven, 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 utente utente 0 Dom, 2015-02-01 11:00:00 .
drwxrwxr-x utente utente 0 dom, 2015-02-01 11:00:00 codice
drwxrwxr-x utente utente 0 Dom, 2015-02-01 11:00:00 codice/mioprogetto
-rw-rw-r-- utente utente 1416192 Dom, 2015-02-01 11:00:00 code/myproject/file.ext
...

# vedere cosa è cambiato tra gli archivi, in base al tempo di modifica del file, alla dimensione e al percorso del file
$ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archivioA
$ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archivioB
$ diff -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0 . 1422781200 0 .
1422781200 0 codice 1422781200 0 codice
1422781200 0 codice/mioprogetto 1422781200 0 codice/mioprogetto
1422781200 1416192 codice/mioprogetto/file.ext | 1454664653 1416192 codice/mioprogetto/file.ext
...

BORGO DELETE

utilizzo: borg delete [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [-p] [-s] [-c] [--salva-spazio]
[BERSAGLIO]

Elimina un repository o un archivio esistente

argomenti posizionali:
Archivio o repository TARGET da eliminare

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
-p, --progress mostra la visualizzazione dello stato di avanzamento durante l'eliminazione di un singolo archivio
-s, --stats stampa le statistiche per l'archivio cancellato
-c, --cache-only elimina solo la cache locale per il dato repository
--save-space funziona più lentamente, ma usa meno spazio

Descrizione
Questo comando elimina un archivio dal repository o dall'intero repository. Disco
lo spazio viene recuperato di conseguenza. Se elimini il repository completo, la cache locale per
anche esso (se presente) viene eliminato.

Esempi
# elimina un singolo archivio di backup:
$ borg elimina /percorso/del/repo::lunedì

# cancella l'intero repository e la relativa cache locale:
$ borg elimina /percorso/a/repo
Hai richiesto di ELIMINARE completamente il repository *inclusi* tutti gli archivi che contiene:
repo Lun, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nuovo nome Lun, 2016-02-15 19:50:19
Digita "S" se hai capito e vuoi continuare: S

BORGO FESSO

utilizzo: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [-n] [-s] [--list]
[--keep-entro ENTRO] [-H ORARIA] [-d GIORNALIERO] [-w SETTIMANALE]
[-m MENSILE] [-y ANNUALE] [-P PREFISSO] [--salva-spazio]
[REPOSITIVO]

Elimina gli archivi del repository in base alle regole specificate

argomenti posizionali:
REPOSITORY repository da sfoltire

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
-n, --dry-run non cambia repository
-s, --stats stampa le statistiche per l'archivio cancellato
--list output elenco dettagliato degli archivi che conserva/pota
--keep-withIN WITHIN mantiene tutti gli archivi entro questo intervallo di tempo
-H ORARIA, --keep-hourly HOURLY
numero di archivi orari da conservare
-d GIORNALIERO, --keep-daily GIORNALIERO
numero di archivi giornalieri da conservare
-w SETTIMANALE, --keep-settimanale SETTIMANALE
numero di archivi settimanali da conservare
-m MENSILE, --keep-mensile MENSILE
numero di archivi mensili da conservare
-y ANNUALE, --keep-annuale ANNUALE
numero di archivi annuali da conservare
-P PREFISSO, --prefisso PREFISSO
considera solo i nomi degli archivi che iniziano con questo prefisso
--save-space funziona più lentamente, ma usa meno spazio

Descrizione
Il comando prune elimina un repository eliminando gli archivi che non corrispondono a nessuno dei
opzioni di conservazione specificate. Questo comando è normalmente utilizzato dagli script di backup automatici
voler conservare un certo numero di backup storici.

Ad esempio, "-d 7" significa mantenere l'ultimo backup ogni giorno, fino ai 7 più recenti
giorni con backup (i giorni senza backup non contano). Le regole si applicano da ogni ora
a annuale e i backup selezionati dalle regole precedenti non contano per quelli successivi
regole. Il tempo di completamento di ogni backup viene utilizzato per l'eliminazione. Date e orari
sono interpretati nel fuso orario locale e le settimane vanno dal lunedì alla domenica. Specificando a
numero negativo di archivi da conservare significa che non c'è limite.

L'opzione "--keep-within" accetta un argomento della forma " ", dove char è "H",
"d", "w", "m", "y". Ad esempio, "--keep-entro 2d" significa conservare tutti gli archivi che erano
creato nelle ultime 48 ore. "1m" significa "31d". Gli archivi custoditi con
questa opzione non viene conteggiata per i totali specificati da qualsiasi altra opzione.

Se un prefisso è impostato con -P, vengono considerati solo gli archivi che iniziano con il prefisso
per la cancellazione e solo quegli archivi contano ai fini dei totali specificati dalle regole.
Altrimenti, contro tutti i gli archivi nel repository sono candidati per la cancellazione!

Esempi
Fai attenzione, prune è un comando potenzialmente pericoloso, rimuoverà gli archivi di backup.

L'impostazione predefinita di prune è di applicarsi a contro tutti i archivio in , il deposito a meno che non lo limiti
operazione su un sottoinsieme degli archivi utilizzando --prefisso. Quando si usa --prefisso, stai attento a
scegli un buon prefisso - ad es. non usare un prefisso "pippo" se non vuoi anche corrispondere
"foba".

Si consiglia vivamente di correre sempre fesso --funzionamento a secco ... prima così vedrai di cosa si tratta
farebbe senza in realtà fare nulla.

# Conserva 7 archivi di fine giornata e 4 archivi di fine settimana aggiuntivi.
# Eseguire una prova senza cancellare nulla.
$ borg prune --dry-run --keep-daily=7 --keep-weekly=4 /percorso/a/repo

# Come sopra ma si applica solo ai nomi degli archivi che iniziano con "foo":
$ borg prune --keep-daily=7 --keep-weekly=4 --prefix=foo /percorso/a/repo

# Conserva 7 archivi di fine giornata, 4 archivi aggiuntivi di fine settimana,
# e un archivio di fine mese per ogni mese:
$ borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /percorso/a/repo

# Conserva tutti i backup degli ultimi 10 giorni, 4 archivi aggiuntivi di fine settimana,
# e un archivio di fine mese per ogni mese:
$ borg prune --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /percorso/a/repo

BORGO INFO

utilizzo: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO]
ARCHIVIO

Mostra i dettagli dell'archivio come lo spazio su disco utilizzato

argomenti posizionali:
ARCHIVIO archivio per visualizzare informazioni su

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")

Descrizione
Questo comando visualizza alcune informazioni dettagliate sull'archivio specificato.

Esempi
$ borg info /percorso/del/repo::root-2016-02-15
Nome: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Nome host: mionomehost
Nome utente: root
Orario (inizio): Lun, 2016-02-15 19:36:29
Tempo (fine): Lun, 2016-02-15 19:39:26
Riga di comando: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
Numero di file: 38100

Dimensione originale Dimensione compressa Dimensione deduplicata
Questo archivio: 1.33 GB 613.25 MB 571.64 MB
Tutti gli archivi: 1.63 GB 853.66 MB 584.12 MB

Pezzi unici Pezzi totali
Indice del pezzo: 36858 48844

BORGO MONTARE

utilizzo: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [-f] [-o OPZIONI]
REPOSITORY_OR_ARCHIVE MOUNTPPOINT

Monta un archivio o un intero repository come filesystem FUSE

argomenti posizionali:
REPOSITORY_OR_ARCHIVE
repository/archivio da montare
MOUNTPOINT dove montare il filesystem

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
-f, --foreground resta in primo piano, non demonizza
-o OPZIONI Opzioni di montaggio extra

Descrizione
Questo comando monta un archivio come filesystem FUSE. Questo può essere utile per la navigazione e
archiviare o ripristinare singoli file. A meno che non --primo piano all'opzione viene dato il comando
verrà eseguito in background finché il filesystem non sarà smontato.

Esempi
$ borg mount /percorso/del/repo::root-2016-02-15 /tmp/miomountpoint
$ ls /tmp/miopuntomontaggio
bin boot etc home lib lib64 perso+trovato media mnt opt ​​root sbin srv tmp usr var
$ montefusore -u /tmp/miopunto di montaggio

BORGO CAMBIO PASSFRASE

utilizzo: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--nessuna-cache-file] [--umask M]
[--percorso-remoto PERCORSO]
[REPOSITIVO]

Modifica la passphrase del file chiave del repository

argomenti posizionali:
REPOSITORY

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")

Descrizione
I file chiave utilizzati per la crittografia del repository sono facoltativamente protetti da passphrase. Questo
comando può essere utilizzato per modificare questa passphrase.

Esempi
# Crea un repository protetto da file chiave
$ borg init --encryption=keyfile -v /percorso/del/repo
Inizializzazione del repository in "/path/to/repo"
Inserisci la nuova passphrase:
Inserisci di nuovo la stessa passphrase:
Ricorda la tua passphrase. I tuoi dati saranno inaccessibili senza di essa.
Digitare "/root/.config/borg/keys/mnt_backup" creato.
Tieni questa chiave al sicuro. I tuoi dati saranno inaccessibili senza di essa.
Sincronizzazione della cache dei blocchi in corso...
Archivi: 0, con Idx memorizzato nella cache: 0, con Idx obsoleto: 0, senza Idx memorizzato nella cache: 0.
Donate.

# Cambia la passphrase del file chiave
$ borg change-passphrase -v /percorso/del/repo
Inserisci la passphrase per la chiave /root/.config/borg/keys/mnt_backup:
Inserisci la nuova passphrase:
Inserisci di nuovo la stessa passphrase:
Ricorda la tua passphrase. I tuoi dati saranno inaccessibili senza di essa.
Chiave aggiornata

BORGO SERVIRE

utilizzo: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-percorso-remoto] [--limita-percorso-percorso]

Avvia in modalità server. Questo comando di solito non viene utilizzato manualmente.

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
--restrict-to-path PERCORSO
limitare l'accesso al repository a PATH

Descrizione
Questo comando avvia un processo del server di repository. Questo comando di solito non viene utilizzato
manualmente.

Esempi
borg serve ha un supporto speciale per i comandi forzati ssh (vedi Authorized_keys esempio
sotto): rileverà che si utilizza tale comando forzato ed estrarrà il valore di
--limita-al-percorso opzioni). Quindi analizzerà il comando originale proveniente da
cliente, si assicura che sia anche borg servire e imporre restrizioni di percorso come indicato da
il comando forzato. In questo modo, altre opzioni fornite dal cliente (come --Informazioni or --umask)
sono conservati (e non sono fissati dal comando forzato).

# Consenti a una coppia di chiavi SSH di eseguire solo borg e di avere accesso solo a /path/to/repo.
# Utilizzare le opzioni chiave per disabilitare funzionalità SSH non necessarie e potenzialmente pericolose.
# Ciò contribuirà a proteggere un sistema di backup remoto automatizzato.
$ gatto ~ / .ssh / authorized_keys
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[...]

BORGO UPGRADE

utilizzo: aggiornamento borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--percorso-remoto PERCORSO] [-p] [-n] [-i]
[REPOSITIVO]

aggiornare un repository da una versione precedente

argomenti posizionali:
REPOSITORY percorso del repository da aggiornare

argomenti facoltativi:
-h, --help mostra questo messaggio di aiuto ed esce
--critical lavoro a livello di log CRITICAL
--error funziona a livello di log ERROR
--warning funziona a livello di log WARNING (predefinito)
--info, -v, --verbose
lavorare a livello di log INFO
--debug funziona a livello di log DEBUG
--lock-wait N attende il blocco, ma max. N secondi (predefinito: 1).
--show-rc mostra/registra il codice di ritorno (rc)
--no-files-cache non carica/aggiorna la cache dei metadati del file usata per
rileva i file non modificati
--umask M imposta umask su M (locale e remoto, predefinito: 0077)
--remote-path PATH imposta il percorso remoto su eseguibile (predefinito: "borg")
-p, --progress mostra la visualizzazione dello stato di avanzamento durante l'aggiornamento del repository
-n, --dry-run non cambia repository
-i, --inplace riscrive il repository sul posto, senza possibilità di andare
torna alle versioni precedenti del repository.

Descrizione
Aggiorna un repository Borg esistente. Questo attualmente supporta la conversione di un attico
repository in Borg e aiuta anche a convertire Borg 0.xx in 1.0.

Attualmente, è possibile aggiornare solo i repository LOCALI (edizione #465).

Cambierà le stringhe magiche nei segmenti del repository in modo che corrispondano alla nuova magia Borg
stringhe. I file di chiavi trovati in $ATTIC_KEYS_DIR o ~/.soffitta/chiavi/ sarà anche convertito
e copiato in $BORG_KEYS_DIR o ~/.config/borg/keys.

I file della cache vengono convertiti, da $ATTIC_CACHE_DIR o ~/.cache/attico a $BORG_CACHE_DIR
or ~/.cache/borg, ma il layout della cache tra Borg e Attic è cambiato, quindi è possibile
il primo backup dopo la conversione richiede più tempo del previsto a causa della risincronizzazione della cache.

L'aggiornamento dovrebbe essere in grado di riprendere se interrotto, anche se continuerà a ripetersi su tutto
segmenti. Se vuoi ricominciare da zero, usa borg delete sul repository copiato in
assicurati che anche i file della cache vengano rimossi:
borg elimina borg

Salvo che --a posto è specificato, il processo di aggiornamento crea prima una copia di backup del
repository, in REPOSITORY.upgrade-DATETIME, utilizzando hardlink. Questo richiede più tempo di in
posiziona gli aggiornamenti, ma è molto più sicuro e fornisce informazioni sui progressi (al contrario di cp Al).
Una volta che sei soddisfatto della conversione, puoi tranquillamente distruggere la copia di backup.

ATTENZIONE: l'esecuzione dell'aggiornamento in atto renderà la copia corrente inutilizzabile con le versioni precedenti
versione, senza possibilità di tornare alle versioni precedenti. Questo può DANNEGGIARE PERMANENTEMENTE IL TUO
DEPOSITO! Attic NON PU LEGGERE I DEPOSITI BORG, poiché le stringhe magiche sono cambiate. Voi
sono stati avvertiti.

Esempi
# Aggiorna il repository borg alla versione più recente.
$ borg upgrade -v /percorso/al/repo
fare una copia hardlink in /path/to/repo.upgrade-2016-02-15-20:51:55
apertura del repository dell'attico con borg e conversione
nessun file chiave trovato per il repository
conversione dell'indice del repository /percorso/in/repo/index.0
conversione di 1 segmento...
conversione di borg 0.xx in corrente di borg
nessun file chiave trovato per il repository

VARIE AIUTO

borg Aiuto modelli
I modelli di esclusione supportano quattro stili separati, fnmatch, shell, espressioni regolari e
prefissi di percorso. Se seguito da due punti (':') vengono utilizzati i primi due caratteri di un modello
come selettore di stile. La selezione esplicita dello stile è necessaria quando uno stile non predefinito è
desiderato o quando il motivo desiderato inizia con due caratteri alfanumerici seguiti da a
due punti (cioè aa:qualcosa/*).

Fnmatch, selettore fm:
Questi pattern usano una variante della sintassi del pattern shell, con '*' che corrisponde a qualsiasi numero di
caratteri, '?' corrispondenza di qualsiasi singolo carattere, '[...]' corrispondenza di qualsiasi singolo carattere
specificato, compresi gli intervalli, e '[!...]' corrispondente a qualsiasi carattere non specificato. Per il
scopo di questi modelli, il separatore di percorso ('' per Windows e '/' su altri sistemi)
non è trattato in modo speciale. Avvolgere i metacaratteri tra parentesi per una corrispondenza letterale (ad es
[?] per abbinare il carattere letterale ?). Affinché un percorso corrisponda a un modello, deve
corrispondere completamente dall'inizio alla fine, o deve corrispondere dall'inizio a poco prima di un percorso
separatore. Ad eccezione del percorso radice, i percorsi non finiranno mai nel separatore di percorso quando
si tenta la corrispondenza. Quindi, se un dato modello termina con un separatore di percorso, un '*' è
aggiunto prima di tentare la corrispondenza.

Motivi a conchiglia, selettore SH:
Come i modelli fnmatch, questi sono simili ai modelli shell. La differenza è che il
il modello può includere ** / per la corrispondenza di zero o più livelli di directory, * per abbinare lo zero
o più caratteri arbitrari ad eccezione di qualsiasi separatore di percorso.

Espressioni regolari, selettore re:
Sono supportate le espressioni regolari simili a quelle trovate in Perl. A differenza dei modelli a conchiglia
le espressioni regolari non sono necessarie per abbinare il percorso completo e qualsiasi corrispondenza di sottostringa
è sufficiente. Si consiglia vivamente di ancorare i modelli all'inizio ('^'), al
fine ('$') o entrambi. Separatori di percorso ('' per Windows e '/' su altri sistemi) nei percorsi
sono sempre normalizzati su una barra ('/') prima di applicare un pattern. Il regolare
la sintassi dell'espressione è descritta nella Python documentazione per , il re modulo.

Percorso prefisso, selettore p.p.:
Questo stile di pattern è utile per abbinare intere sottodirectory. Il modello pp:/dati/barra
fiammiferi /dati/bar e tutto ciò che contiene.

Le esclusioni possono essere passate tramite l'opzione della riga di comando --escludere. Se usato dall'interno di a
shell i modelli dovrebbero essere citati per proteggerli dall'espansione.

I --exclude-da l'opzione consente di caricare i modelli di esclusione da un file di testo con uno
modello per riga. Righe vuote o che iniziano con il cancelletto ('#') dopo la rimozione
gli spazi bianchi su entrambe le estremità vengono ignorati. È supportato anche il prefisso del selettore di stile opzionale
per i modelli caricati da un file. A causa dei percorsi di rimozione degli spazi bianchi con spazi bianchi al
inizio o fine possono essere esclusi solo utilizzando le espressioni regolari.

Consigli d'uso:

# Esclude '/home/user/file.o' ma non '/home/user/file.odt': $ borg create -e '
*
.o' backup /

# Esclude '/home/user/junk' e '/home/user/subdir/junk' ma # non
'/home/user/importantjunk' o '/etc/junk': $ borg create -e '/casa/
*
/backup "spazzatura" /

# Esclude il contenuto di '/home/user/cache' ma non la directory stessa: $ borg create
-e /home/utente/cache/backup /

# Il file '/home/user/cache/important' è non backup: $ borg create -e
/home/utente/cache/ backup / /home/utente/cache/importante

# Il contenuto delle directory in '/ Home' non viene eseguito il backup quando il loro nome # finisce con
'.tmp' $ borg create --exclude 're:^/casa/[^/]+.tmp/' backup /

# Carica esclusioni dal file $ cat >exclude.txt < /casa//Rifiuto *. Tmp
fm:aa:qualcosa/ ri:^/casa/[^/].tmp/sh:/casa/
*
/.thumbnails EOF $ borg crea --exclude-fromexclude.txt backup /

DEBUG COMANDI

Ci sono altri comandi (tutti che iniziano con "debug-") che sono tutti non destinato per
normale uso ed potenzialmente molto pericoloso se usato in modo errato.

Esistono per migliorare le capacità di debug senza accesso diretto al sistema, ad esempio nel caso
ti sei mai imbattuto in qualche grave malfunzionamento. Usali solo se sai cosa stai facendo o
se uno sviluppatore Borg fidato ti dice cosa fare.

SUPPLEMENTARI NOTE

Qui ci sono vari. note su argomenti che potrebbero non essere trattati in modo sufficientemente dettagliato nell'uso
.

Articolo bandiere
borg creare -v --elenco emette un elenco dettagliato di tutti i file, directory e altri file
elementi di sistema che ha considerato (indipendentemente dal fatto che abbiano o meno modifiche al contenuto). Per ciascuno
articolo, antepone un contrassegno a una lettera che indica il tipo e/o lo stato dell'articolo.

Se sei interessato solo a un sottoinsieme di quell'output, puoi dare ad es --filtro=AME ed
mostrerà solo i file normali con lo stato A, M o E (vedi sotto).

Un carattere maiuscolo rappresenta lo stato di un normale file relativo ai "file"
cache (non relativo al repository: questo è un problema se la cache dei file non viene utilizzata).
I metadati vengono comunque memorizzati e per 'A' e 'M' vengono memorizzati anche nuovi blocchi di dati. Per
'U' tutti i blocchi di dati si riferiscono a blocchi già esistenti.

· 'A' = file normale, aggiunto (vedi anche a_status_oddity nelle FAQ)

· 'M' = file normale, modificato

· 'U' = file normale, invariato

· 'E' = file normale, si è verificato un errore durante l'accesso/la lettura questo filetto

Un carattere minuscolo indica un tipo di file diverso da un file normale, borg di solito solo
memorizza i loro metadati:

· 'd' = directory

· 'b' = dispositivo di blocco

· 'c' = dispositivo char

· 'h' = file normale, hardlink (a inode già visti)

· 's' = collegamento simbolico

· 'f' = fifo

Altri flag utilizzati includono:

· 'i' = i dati di backup sono stati letti dall'input standard (stdin)

· '-' = prova a secco, articolo era non backup

· '?' = codice di stato mancante (se lo vedi, per favore segnala un bug!)

--chunker-params
I parametri del chunker influenzano il modo in cui i file di input vengono tagliati in pezzi (blocchi) che vengono poi
considerato per la deduplica. Hanno anche un grande impatto sull'utilizzo delle risorse (RAM e disco
spazio) poiché la quantità di risorse necessarie è (anche) determinata dalla quantità totale di
pezzi nel repository (vedi Indici / caches memoria uso per dettagli).

--chunker-params=10,23,16,4095 si traduce in una deduplica a grana fine e crea un grande
quantità di blocchi e quindi utilizza molte risorse per gestirli. Questo va bene per
volumi di dati relativamente piccoli e se la macchina ha una buona quantità di RAM e disco liberi
spazio.

--chunker-params=19,23,21,4095 (predefinito) si traduce in una deduplica a grana grossa e
crea una quantità molto più piccola di blocchi e quindi utilizza meno risorse. Questo va bene per
volumi di dati relativamente grandi e se la macchina ha una quantità relativamente bassa di RAM libera e
spazio sul disco.

Se hai già creato degli archivi in ​​un repository e poi cambi i parametri del chunker,
questo ovviamente influisce sulla deduplica poiché i pezzi verranno tagliati in modo diverso.

Nel peggiore dei casi (tutti i file sono grandi e sono stati toccati tra i backup), questo memorizzerà
tutto il contenuto nel repository di nuovo.

Di solito, però, non è così male:

· di solito la maggior parte dei file non viene toccata, quindi riutilizzerà semplicemente i vecchi pezzi che ha già
nel repository

· i file più piccoli della dimensione minima del blocco (sia vecchio che nuovo) risultano in un solo blocco
comunque, quindi i blocchi risultanti sono gli stessi e verrà applicata la deduplicazione

Se cambi i parametri del chunker per risparmiare risorse per un repository esistente che ne ha già alcuni
archivi di backup, vedrai un effetto crescente nel tempo, quando sempre più file
sono stati toccati e conservati di nuovo utilizzando il chunksize più grande ed tutti i riferimenti al
i pezzi più vecchi più piccoli sono stati rimossi (eliminando / sfoltendo gli archivi).

Se vuoi vedere un grande effetto immediato sull'utilizzo delle risorse, è meglio che inizi una nuova
repository quando si modificano i parametri del chunker.

Per maggiori dettagli, vedere chunker_details.

--leggi-speciale
L'opzione --leggi-speciale non è inteso per il normale livello di filesystem (completo o
backup parzialmente ricorsivi). Dai questa opzione solo se vuoi fare qualcosa piuttosto
... speciale - e se hai selezionato manualmente alcuni file che vuoi trattare in quel modo.

borg creare --leggi-speciale aprirà tutti i file senza fare alcun trattamento speciale
in base al tipo di file (l'unica eccezione qui sono le directory: saranno ricorse
in). Immagina cosa succede se lo fai gatto Nome del file --- il contenuto che vedrai lì
è ciò che borg eseguirà il backup per quel nome file.

Quindi, ad esempio, verranno seguiti i collegamenti simbolici, verrà letto il contenuto del dispositivo a blocchi, denominato pipe
/ Verranno letti i socket di dominio UNIX.

Devi stare attento a ciò che dai come nome file quando usi --leggi-speciale, ad esempio se
tu dai / sviluppo / zero, il backup non verrà mai interrotto.

I metadati dei file forniti vengono salvati come verrebbero salvati senza --leggi-speciale (ad es
nome, la sua dimensione [potrebbe essere 0], la sua modalità, ecc.) - ma in aggiunta, anche il contenuto letto
da esso sarà salvato per esso.

Il ripristino del contenuto di tali file è attualmente supportato solo uno alla volta tramite --stdout
opzione (e devi reindirizzare stdout dove mai andrà, magari direttamente in an
file del dispositivo esistente di tua scelta o indirettamente tramite dd).

Esempio
Immagina di aver creato alcune istantanee dei volumi logici (LV) di cui desideri eseguire il backup.

NOTA:
Per alcuni scenari, questo è un buon metodo per ottenere una consistenza "crash" (lo chiamo
simile a un arresto anomalo perché è lo stesso che otterresti se premi semplicemente il pulsante di ripristino o
la tua macchina andrebbe in crash bruscamente e completamente). Questo è meglio di nessuna coerenza
per niente e un buon metodo per alcuni casi d'uso, ma probabilmente non abbastanza buono se lo hai
database in esecuzione.

Quindi crei un archivio di backup di tutte queste istantanee. Il processo di backup vedrà un
stato "congelato" dei volumi logici, mentre i processi lavorano nei volumi originali
continuare a modificare i dati ivi memorizzati.

Aggiungi anche l'output di lvdisplay al tuo backup, così puoi vedere le dimensioni LV nel caso
hai mai bisogno di ricrearli e ripristinarli.

Al termine del backup, rimuovi nuovamente gli snapshot.

$ # crea istantanee qui
$ lvdisplay > lvdisplay.txt
$ borg create --read-special /percorso/del/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$ # rimuovi le istantanee qui

Ora, vediamo come ripristinare alcuni LV da un tale backup.

$ estratto borg /percorso/del/repo::arch lvdisplay.txt
$ # crea qui LV vuoti con le dimensioni corrette (guarda in lvdisplay.txt).
$ # assumiamo che tu abbia creato una radice vuota e un LV home e sovrascrivilo ora:
$ 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

Solo aggiunta modo
Un repository può essere reso "append-only", il che significa che Borg non sovrascriverà mai o
eliminare i dati impegnati. Questo è utile per gli scenari in cui più macchine eseguono il backup a
server di backup centrale utilizzando borg servire, poiché una macchina hackerata non può eliminare i backup
permanentemente.

Per attivare la modalità di sola aggiunta, modifica il repository config file e aggiungi una riga append_only=1
Vai all’email [deposito] sezione (o modificare la riga se esiste).

In modalità di sola aggiunta Borg creerà un registro delle transazioni nel Transazioni file, dove
ogni riga è una transazione e un timestamp UTC.

Esempio
Supponiamo che un utente malintenzionato abbia eliminato in remoto tutti i backup, ma il tuo repository fosse solo in append
modalità. Un registro delle transazioni in questa situazione potrebbe essere simile a questo:

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

Dai tuoi log di sicurezza concludi che l'attaccante ha ottenuto l'accesso alle 15:54:00 e tutti i
i backup sono stati eliminati o sostituiti da backup compromessi. Dal log lo sai
le transazioni 11 e successive sono compromesse. Si noti che l'ID della transazione è il nome del
ultimo file nella transazione. Ad esempio, la transazione 11 comprende i file da 6 a 11.

In un vero attacco probabilmente vorrai mantenere intatto il repository compromesso da analizzare
ciò che l'attaccante ha cercato di ottenere. È anche una buona idea fare questa copia per ogni evenienza
qualcosa va storto durante il ripristino. Poiché il ripristino viene eseguito eliminando alcuni file, a
copia hard link (cp Al) è sufficiente.

Il primo passo per reimpostare il repository alla transazione 5, l'ultimo senza compromessi
transazione, è quello di rimuovere il suggerimenti.N ed indice.N file nel repository (questi due file
sono sempre sacrificabili). In questo esempio N è 13.

Quindi rimuovere o spostare tutti i file di segmento dalle directory dei segmenti in dati / Iniziare con
cartella 6:

dati rm/**/{6..13}

Questo è tutto.

svantaggi
Poiché i dati vengono solo aggiunti e nulla viene eliminato, comandi come fesso or delete non libererò
spazio su disco, contrassegnano semplicemente i dati come eliminati in una nuova transazione.

Nota che puoi andare avanti e indietro tra l'operazione normale e quella di sola aggiunta modificando
il file di configurazione, non è un "viaggio di sola andata".

Inoltre Considerazioni
La modalità di sola aggiunta non è rispettata da strumenti diversi da Borg. rm funziona ancora sul
deposito. Assicurati che le macchine client di backup possano accedere al repository solo tramite
borg servire.

Assicurati che non sia possibile alcun accesso remoto se il repository è temporaneamente impostato su normale
modalità per, ad esempio, potatura regolare.

Ulteriori protezioni possono essere implementate, ma sono al di fuori dell'ambito dei Borg. Ad esempio, file
istantanee o wrapping del sistema borg servire per impostare permessi speciali o ACL su nuovi dati
File.

Utilizzare borgbackup online utilizzando i servizi onworks.net