bup-index - Online in de cloud

PROGRAMMA:

NAAM

bup-index - druk de index van het bup-bestandssysteem af en/of werk deze bij

KORTE INHOUD

bup index <-p|-m|-s|-u|--clear|--check> [-H] [-l] [-x] [--fake-valid] [--no-check-device ]
[--nep-ongeldig] [-f indexbestand] [--uitsluiten pad] [--Uitsluiten van bestandsnaam] [--exclusief-rx
patroon] [--exclusief-rx-van bestandsnaam] [-v]

PRODUCTBESCHRIJVING

bup index drukt de bup-bestandssysteemindex af en/of werkt deze bij, wat een cache is van de
bestandsnamen, attributen en sha-1-hashes van elk bestand en elke map in het bestandssysteem. De
bup-index is qua functie vergelijkbaar met de git(1) index, en is te vinden in
$BUP_DIR/bupindex.

Het maken van een back-up in bup bestaat uit twee stappen: vervolgens de index bijwerken met bup index
daadwerkelijk een back-up maken van de bestanden (of een subset van de bestanden) met bup save. De scheiding
bestaat om deze redenen:

1. Er is meer dan één manier om een ​​lijst met bestanden te genereren waarvan een back-up moet worden gemaakt. Voor
die u bijvoorbeeld wilt gebruiken inotify(7) of op de hoogte stellen(7).

2. Zelfs als u een back-up van bestanden maakt naar meerdere bestemmingen (voor extra redundantie), kan het bestand
namen, attributen en hashes zullen elke keer hetzelfde zijn. Zo kunt u de
problemen met het herhaaldelijk opnieuw genereren van de lijst met bestanden voor elke back-upset.

3. Mogelijk wilt u de gegevens die door bup index worden bijgehouden, voor andere doeleinden gebruiken (zoals te hard rijden).
andere programma's aanmaken die dezelfde informatie nodig hebben).

OPMERKINGEN

Op dit moment negeert bup Linux-attributen (vgl. kletsen(1) en lsattr(1)) op sommige
systemen (alle big-endian-systemen waarbij sizeof(long) < sizeof(int)). Dit komt omdat de
De Linux-kernel en FUSE zijn het momenteel niet eens over het type attr-systeemaanroepargumenten,
enzovoort, op big-endian-systemen is er geen manier om de resultaten te krijgen zonder het risico van stapeling
corruptie (http://lwn.net/Articles/575846/). In deze situaties zal bup een afdrukken
waarschuwing voor de eerste keer dat Linux-attrs relevant zijn tijdens een index-/opslaan-/herstelbewerking.

bup maakt aanpassingen voor de verwachte "worst-case" tijdstempelresolutie van het bestandssysteem --
momenteel één seconde; voorbeelden zijn onder meer VFAT, ext2, ext3, kleine ext4, enz. Sinds bup
kan de tijdstempelresolutie van het bestandssysteem niet kennen en kan er meerdere doorlopen
bestandssystemen tijdens een bepaalde run, gaat het er altijd van uit dat de resolutie mogelijk niet beter is
dan één seconde.

In de praktijk betekent dit dat indexupdates een beetje onnauwkeurig zijn, en dus veilig
kan af en toe wijzigingen in het bestandssysteem vastleggen die u niet had verwacht. Dat komt omdat, tijdens
een indexupdate, als bup een pad tegenkomt waarvan de werkelijke tijdstempels recenter zijn dan één
seconde voordat de update begon, zal bup de indextijdstempels voor dat pad instellen (mtime
en ctime) tot precies één seconde vóór de run, waardoor deze waarden effectief worden beperkt.

Dit zorgt ervoor dat latere wijzigingen in deze paden niet kunnen resulteren in tijdstempels die dat wel zijn
identiek aan die in de index. Als dat mogelijk was, zou Bup het over het hoofd kunnen zien
veranderingen.

U kunt het effect van dit gedrag in dit voorbeeld zien (neem aan dat minder dan één seconde
verstrijkt tussen de initiële aanmaak van het bestand en de eerste indexuitvoering):

$ touch src/1 src/2
# Een "slaap 1" hier zou de onverwachte redding vermijden.
$bup index src
$ bup save -n src src # Slaat 1 en 2 op.
$ datum > src/1
$bup index src
$ datum > src/2 # Niet geïndexeerd.
$ bup save -n src src # Maar src/2 wordt toch opgeslagen.

Strikt genomen zou bup de wijziging in src/2 niet moeten opmerken, maar dat doet het wel, vanwege de
hierboven beschreven accommodaties.

MODES

-u, --bijwerken
de index recursief bijwerken voor de opgegeven bestandsnamen en hun nakomelingen. Een of
er moeten meer bestandsnamen worden opgegeven. Als er geen modusoptie wordt gegeven, is dit de standaardinstelling.

-P, --afdrukken
druk de inhoud van de index af. Als er bestandsnamen zijn opgegeven, worden de opgegeven vermeldingen weergegeven
en hun nakomelingen. Als er geen bestandsnamen zijn opgegeven, worden de vermeldingen weergegeven die beginnen bij
de huidige werkmap (.).

-M, --gewijzigd
drukt alleen bestanden af ​​die als gewijzigd zijn gemarkeerd (dat wil zeggen: gewijzigd sinds de meest recente
back-up) in de index. Impliceert -p.

-Ja, --toestand
plaats vóór elke bestandsnaam een ​​statuscode (A, M, D of spatie). Impliceert -p. De
codes betekenen respectievelijk dat een bestand in de index wordt gemarkeerd als toegevoegd, gewijzigd,
verwijderd of ongewijzigd sinds de laatste back-up.

--rekening
Controleer de integriteit van het indexbestand zorgvuldig voor en na het updaten. Vooral nuttig voor
geautomatiseerde tests.

--Doorzichtig
wis de standaardindex.

OPTIES

-H, --hasj
Zet voor elk afgedrukt bestand de meest recent opgenomen hashcode vóór het bestand. De hashcode
wordt normaal gesproken gegenereerd door bup save. Voor objecten waarvan nog geen back-up is gemaakt,
de hash-code is 0000000000000000000000000000000000000000. Merk op dat de hash
code wordt afgedrukt, zelfs als bekend is dat het bestand is gewijzigd of verwijderd uit de index
(dat wil zeggen: het bestand op het bestandssysteem komt niet langer overeen met de opgenomen hash). Als dit is
Als u een probleem heeft, gebruikt u --status.

-ik, --lang
druk meer informatie over elk bestand af, in een vergelijkbaar formaat als de optie -l
ls(1).

-X, --xdev, --één-bestandssysteem
overschrijd echter niet de grenzen van het bestandssysteem bij het recurseren door het bestandssysteem
net als bij tar en rsync worden de mountpunten zelf nog steeds geïndexeerd. Alleen
van toepassing als u -u gebruikt.

--fake-geldig
markeer gespecificeerde bestandsnamen als up-to-date, zelfs als ze dat niet zijn. Dit kan handig zijn voor
testen, of om te voorkomen dat u onnodig back-ups maakt van bestanden waarvan u weet dat ze saai zijn.

--nep-ongeldig
markeer gespecificeerde bestandsnamen als niet up-to-date, waardoor de volgende "bup save"-run wordt geforceerd
Controleer de inhoud opnieuw.

-F, --indexbestand=indexbestand
gebruik een andere indexbestandsnaam in plaats van $BUP_DIR/bupindex.

--uitsluiten=pad
uitsluiten pad van de back-up (kan worden herhaald).

--exclusief-van=bestandsnaam
read --exclude paden van bestandsnaam, één pad per regel (kan worden herhaald). Negeren
volledig lege regels.

--exclude-rx=patroon
alle padovereenkomsten uitsluiten patroon, wat een reguliere expressie van Python moet zijn
(http://docs.python.org/library/re.html). Het patroon wordt vergeleken met de
volledig pad, zonder verankering, dus "x/y" komt overeen met "os/yard" of "box/yards". Naar
sluit de inhoud uit / tmp, maar niet de map zelf, gebruik dan "^/tmp/.". (misschien
herhaald)

Voorbeelden:

· '/foo$' - sluit elk bestand met de naam foo . uit

· '/foo/$' - sluit elke map met de naam foo . uit

· '/foo/.' - sluit de inhoud uit van een map met de naam foo

· '^/tmp/.' - sluit root-niveau uit / tmp's inhoud, maar niet / tmp zelf

--exclude-rx-from=bestandsnaam
lees --exclude-rx patterns from bestandsnaam, één patroon per regel (kan worden herhaald).
Negeer volledig lege regels.

--geen-check-apparaat
Markeer een invoer niet als ongeldig als het apparaatnummer (staat(2) st_dev) wijzigingen. Dit
kan handig zijn bij het indexeren van externe, automatisch aangekoppelde of (LVM) snapshotbestandssystemen.

-in, --uitgebreid
verhoog de loguitvoer tijdens de update (kan meer dan één keer worden gebruikt). Met één -v, afdrukken
elke directory zoals deze wordt bijgewerkt; met twee -v, druk elk bestand ook af.

Voorbeelden

bup-index -vux / Etc / var / usr

Gebruik bup-index online met behulp van onworks.net-services