obnam - En ligne dans le Cloud

PROGRAMME:

Nom

obnam - créer, restaurer et manipuler des sauvegardes

SYNOPSIS

Obnam [--always-restore-setuid] [--no-always-restore-setuid] [--point de contrôle=TAILLE]
[--grossier-taille-du-sac=TAILLE] [--chunk-cache-taille=TAILLE] [--chunk-taille=TAILLE]
[--chunkids-par-groupe=NUM] [--Nom du client=NOM DU CLIENT] [--compresser avec=PROGRAMME]
[--config=DOSSIER] [--dump-config] [--dump-setting-names] [--generate-manpage=MODÈLE] [-h]
[--Aidez-moi] [--aide-à tous] [--list-config-files] [--version] [--no-default-configs]
[--crash-limite=COMPTEUR] [--âge critique=L'âge] [--dédupliquer=MODE] [--dir-sac-taille=TAILLE]
[--dir-cache-taille=TAILLE] [--dump-memory-profil=MÉTHODE] [--dump-repo-file-métadonnées]
[--no-dump-repo-file-metadata] [--chiffrer-avec=CHIFFREMENT-AVEC] [--exclure=EXCLURE]
[--exclure-les caches] [--no-exclude-caches] [--exclure de=DOSSIER] [--fsck-fix]
[--no-fsck-fix] [--fsck-ignore-morceaux] [--no-fsck-ignore-morceaux]
[--fsck-ignore-client=Nom] [--fsck-dernière-génération-seulement] [--no-fsck-dernière-génération-uniquement]
[--fsck-rm-inutilisé] [--no-fsck-rm-inutilisé] [--fsck-skip-sommes de contrôle]
[--no-fsck-skip-sommes de contrôle] [--fsck-skip-répertoires] [--no-fsck-skip-répertoires] [--fsck-skip-fichiers]
[--no-fsck-skip-files] [--fsck-skip-générations] [--no-fsck-skip-générations]
[--fsck-skip-par-client-b-trees] [--no-fsck-skip-per-client-b-trees]
[--fsck-skip-shared-b-trees] [--no-fsck-skip-shared-b-trees] [--fuse-opt=FUSE]
[--génération=GÉNÉRATION] [--gnupghome=ACCUEIL REP] [--idpath-bits=IDPATH-BITS]
[--idpath-profondeur=IDPATH-PROFONDEUR] [--idpath-skip=IDPATH-SKIP] [--comprendre=COMPRENDRE]
[--garder=GARDER] [--détails-clés] [--pas de détails clés] [--identifiant de clé=ID CLÉ] [--leave-points de contrôle]
[--no-leave-points de contrôle] [--lock-timeout=TIMEOUT] [--Journal=DOSSIER] [--log-keep=N]
[--niveau de journal=NIVEAU] [--log-max=TAILLE] [--log-mode=MODE] [--lru-taille=TAILLE]
[--memory-dump-intervalle=SECONDS] [--node-taille=TAILLE] [--un-système-de-fichiers]
[--aucun-système-de-fichiers] [--output=DOSSIER] [--faire semblant] [- à sec] [--pas d'action] [--sans faire semblant]
[--pas de tirage à sec] [--non-non-acte] [--faire semblant=TIMESTAMP] [--pure-paramiko]
[--no-pur-paramiko] [--silencieux] [--silencieux] [--no-silencieux] [--non-silencieux] [-rURL]
[--dépôt=URL] [--format-dépôt=Format] [--racine=URL] [--sftp-délai=SFTP-RETARD]
[--petits-fichiers-dans-btree] [--pas de petits fichiers dans btree] [--ssh-commande=EXÉCUTABLE]
[--ssh-host-keys-check=VALEURE] [--clé-ssh=NOM DE FICHIER] [--ssh-hôtes-connus=NOM DE FICHIER]
[--strict-ssh-host-keys] [--no-strict-ssh-host-keys] [--bits-clés-symétriques=BITS]
[--test-échec-correspondance=REGEXP] [--à=À] [--tracer=TRACE] [--upload-queue-size=TAILLE]
[--verbeux] [--non-verbeux] [--verify-aléatoirement=N] [--warn-âge=L'âge] [--faible-aléatoire]
[--no-faible-aléatoire]

Obnam [Options] _fermer à clé
Obnam [Options] touche d'ajout [CLIENT-Nom] ...
Obnam [Options] sauvegarde [ANNUAIRE|URL] ...
Obnam [Options] clés-client
Obnam [Options] clients
Obnam [Options] différence [GÉNÉRATION1]GÉNÉRATION2
Obnam [Options] dépôt de vidage
Obnam [Options] forcer le verrouillage
Obnam [Options] Oubliez [GÉNÉRATION] ...
Obnam [Options] fsck
Obnam [Options] générations
Obnam [Options] génies
Obnam [Options] aider
Obnam [Options] aide-tout
Obnam [Options] kdirstat [DOSSIER] ...
Obnam [Options] liste-erreurs
Obnam [Options] listes-formats
Obnam [Options] clés-liste
Obnam [Options] liste-niveaux supérieurs
Obnam [Options] ls [DOSSIER] ...
Obnam [Options] monter [TRAITEMENT]
Obnam [Options] nagios-dernière-sauvegarde-age
Obnam [Options] supprimer-client [CLIENT-Nom] ...
Obnam [Options] supprimer-clé [CLIENT-Nom] ...
Obnam [Options] restaurer [ANNUAIRE] ...
Obnam [Options] Vérifier [ANNUAIRE] ...

DESCRIPTION

Obnam crée, restaure, manipule et gère les sauvegardes. Il peut stocker
sauvegardes sur un disque local ou sur un serveur via sftp. Chaque génération de sauvegarde ressemble à un
instantané, mais est vraiment incrémentiel : l'utilisateur n'a pas à se soucier de savoir s'il s'agit d'un
sauvegarde complète ou non. Seules les données modifiées sont sauvegardées et si une partie des données est déjà
sauvegardées dans un autre fichier, ces données sont réutilisées.

L'endroit où les données sauvegardées sont placées s'appelle le référentiel de sauvegarde. Un référentiel
peut être, par exemple, un répertoire sur un serveur sftp, ou un répertoire sur un disque dur USB. UNE
un seul référentiel peut contenir des sauvegardes de plusieurs clients. Leurs données vont s'entremêler
comme s'ils utilisaient des référentiels séparés, mais si un client sauvegarde un fichier, les autres
peut réutiliser les données.

Obnam la syntaxe de la ligne de commande consiste en un commander éventuellement suivi d'arguments. Les
les commandes sont listées ci-dessous.

· sauvegarde fait une nouvelle sauvegarde. La première fois qu'il est exécuté, il effectue une sauvegarde complète, après
qu'un incrémentiel.

· restaurer est le contraire d'une sauvegarde. Il copie les données sauvegardées à partir de la sauvegarde
référentiel dans un répertoire cible. Vous pouvez tout restaurer en une génération, ou
juste les fichiers sélectionnés.

· CLIENTS répertorie les clients qui sont sauvegardés dans le référentiel.

· Les générations répertorie chaque génération de sauvegarde pour un client donné, ainsi que quelques métadonnées
sur la génération.

· génies répertorie l'identifiant de chaque génération de sauvegarde pour un client donné. Non
d'autres informations sont affichées. Cela peut être utile pour les scripts.

· ls répertorie le contenu d'une génération donnée, semblable à ls -LAR.

· kdirstat répertorie le contenu d'une génération donnée, dans un format compatible
les kdirstat format de fichier cache, qui peut ensuite être utilisé pour visualiser le
contenu d'une sauvegarde.

· vérifier compare les données de la sauvegarde avec les données réelles de l'utilisateur et s'assure qu'elles sont
identique. Il est très utile de l'exécuter immédiatement après une sauvegarde, pour vérifier qu'elle
effectivement fonctionné. Il peut être exécuté à tout moment, mais si les données utilisateur ont changé,
la vérification échoue même si la sauvegarde est OK.

· oublier supprime les générations de sauvegarde qui ne sont plus souhaitées, afin qu'elles n'utilisent pas
espace disque. Notez qu'après la suppression d'une génération de sauvegarde, les données ne peuvent pas être
plus restauré. Vous pouvez soit spécifier les générations à supprimer en les listant
sur la ligne de commande, ou utilisez le --garder option pour spécifier une politique pour ce qu'il faut garder
(tout le reste sera supprimé).

· fsck vérifie la cohérence interne du référentiel de sauvegarde. Il vérifie que
tous les clients, générations, répertoires, fichiers et tout le contenu des fichiers existent toujours dans
le référentiel de sauvegarde. L'exécution peut prendre un certain temps.

· forcer le verrouillage supprime un fichier de verrouillage pour un client dans le référentiel. Vous devriez seulement
forcer un verrou si vous êtes sûr que personne n'accède aux données de ce client dans le
dépôt. Un verrou suspendu peut arriver, par exemple, si obnam perd son réseau
connexion au référentiel de sauvegarde.

· clés-client répertorie la clé de chiffrement associée à chaque client.

· liste-clés répertorie les clés qui peuvent accéder au référentiel, et quel niveau supérieur
répertoires auxquels chaque clé peut accéder. Certains des répertoires de premier niveau sont partagés
entre clients, d'autres sont spécifiques à un client.

· liste-niveaux supérieurs c'est comme liste-clés, mais répertorie les niveaux supérieurs et les clés auxquelles il est possible d'accéder
Eux.

· ajouter-clé ajoute une clé de chiffrement au référentiel. Par défaut, la clé est ajoutée
uniquement aux répertoires de premier niveau partagés, mais il peut également être ajouté à des
clients : liste les noms des clients sur la ligne de commande. La clé est donnée avec
le --identifiant de clé option. Celui qui a accès à la clé secrète correspondant à la clé
id peut accéder au référentiel de sauvegarde (les niveaux supérieurs partagés plus les clients spécifiés).

· supprimer-clé supprime une clé des répertoires de niveau supérieur partagés, ainsi que tous les clients
spécifié sur la ligne de commande.

· nagios-dernière-sauvegarde-âge est un contrôle qui se termine avec un retour différent de zéro si un âge de sauvegarde
dépasse un certain seuil. Il peut être utilisé comme plug-in de vérification pour nagios.
Des seuils peuvent être donnés au --warn-âge ainsi que --âge critique options.

· diff compare deux générations et répertorie les fichiers qui diffèrent entre elles. Chaque sortie
La ligne sera préfixée soit par un signe plus (+) pour les fichiers qui ont été ajoutés, soit par un signe moins
signe (-) pour les fichiers qui ont été supprimés ou un astérisque (*) pour les fichiers qui ont
modifié. Si un seul ID de génération est spécifié sur la ligne de commande qui
génération sera comparée à son prédécesseur direct. Si deux pièces d'identité ont été
spécifié, tous les changements entre ces deux générations seront répertoriés.

· monter rend le référentiel de sauvegarde disponible via un système de fichiers FUSE en lecture seule. Chaque
La génération de sauvegarde est visible sous forme de sous-répertoire, nommé d'après l'ID de génération.
Cela signifie que vous pouvez consulter les données sauvegardées à l'aide d'outils normaux, tels que votre fichier GUI
gestionnaire, ou des outils de ligne de commande tels que ls(1), diff(1), et cp(1). Vous ne pouvez pas faire
nouvelles sauvegardes avec la sous-commande mount, mais vous pouvez facilement restaurer les données.

Vous devez disposer des utilitaires FUSE et être autorisé à utiliser FUSE pour
travail. Les détails varient selon les systèmes d'exploitation ; dans Debian, installez le
paquet fusible et ajoutez-vous au fusible groupe (vous devrez peut-être vous déconnecter et revenir
à nouveau).

Fabrication sauvegardes
Lorsque vous exécutez une sauvegarde, Obnam télécharge les données dans le référentiel de sauvegarde. Les données sont divisées
en morceaux, et si un morceau existe déjà dans le référentiel de sauvegarde, il n'est pas téléchargé
de nouveau. Ceci permet Obnam pour traiter les fichiers qui ont été modifiés ou renommés depuis la
précédente exécution de sauvegarde. Il permet également à plusieurs clients de sauvegarde d'éviter de télécharger le même
Les données. Si, par exemple, tout le monde au bureau a un exemplaire des mêmes brochures commerciales,
une seule copie doit être stockée dans le référentiel de sauvegarde.

Chaque exécution de sauvegarde est un génération . En outre, Obnam seront sélectionnés point de contrôle Les générations
de temps en temps. Ceux-ci sont exactement comme les générations normales, mais ne sont pas garantis
être un instantané complet des données en direct. Si l'exécution de la sauvegarde doit être interrompue dans le
milieu, la prochaine exécution de sauvegarde peut continuer à partir du dernier point de contrôle, évitant ainsi d'avoir à
recommencer à zéro.

Si une exécution de sauvegarde supprime un répertoire racine de sauvegarde, les anciennes générations le conserveront toujours :
rien ne change dans les anciennes générations simplement parce qu'il y en a une nouvelle. Si la racine était
abandonné par erreur, il peut être rajouté et la prochaine exécution de sauvegarde réutilisera l'existant
données dans le référentiel de sauvegarde, et ne sauvegardera que les métadonnées du fichier (noms de fichiers,
autorisations, etc.).

Vérification sauvegardes
À quoi sert un système de sauvegarde sur lequel vous ne pouvez pas compter ? Comment pouvez-vous compter sur quelque chose que vous ne pouvez pas
test? Les Obnam vérifier La commande vérifie que les données du référentiel de sauvegarde correspondent à la réalité
données d'utilisateur. Il récupère un ou plusieurs fichiers du référentiel et les compare au
données d'utilisateur. C'est essentiellement la même chose que de faire une restauration, puis de comparer les fichiers restaurés
avec les fichiers originaux en utilisant cmp(1), mais plus facile à utiliser.

Par défaut, la vérification se produit sur tous les fichiers. Vous pouvez également spécifier les fichiers à
vérifiés en les listant sur la ligne de commande. Vous devez spécifier les chemins complets vers le
fichiers, non relatifs au répertoire courant.

La sortie répertorie les fichiers qui échouent à la vérification pour une raison quelconque. Si vous vérifiez tout,
il est probable que certains fichiers (par exemple, les répertoires parents de la racine de sauvegarde) aient changé
sans que ce soit un problème. Notez que vous devrez spécifier le chemin complet vers le
fichiers ou répertoires à vérifier, non relatifs à la racine de sauvegarde. Vous devez encore
spécifiez au moins une des racines de sauvegarde sur la ligne de commande ou via le --racine option donc
cet obnam trouvera le système de fichiers, s'il s'agit d'un système distant.

URL syntaxe
Chaque fois qu'obnam accepte une URL, il peut s'agir soit d'un chemin local, soit d'un Sftp URL. Un sftp
L'URL a la forme suivante :

sftp: //[utilisateur@]domaine[:port]/chemin

De domaine est un nom de domaine Internet normal pour un serveur, utilisateur est ton nom d'utilisateur là-dessus
serveur, port est un numéro de port facultatif, et chemin est un chemin d'accès côté serveur. Comme
bzr(1), mais contrairement à la norme d'URL sftp, le chemin d'accès est absolu, sauf s'il commence par
/~/ auquel cas il est relatif au répertoire personnel de l'utilisateur sur le serveur.

Voir la section EXEMPLE pour des exemples d'URL.

Vous pouvez utiliser Sftp URL pour le référentiel, ou les données en direct (racine), mais notez qu'en raison de
limites du protocole et sa mise en œuvre dans le paramico bibliothèque, certaines choses
ne fonctionnera pas très bien pour accéder aux données en direct sur Sftp. Plus important encore, la manipulation
de liens physiques est plutôt sous-optimale. Pour l'accès aux données en direct, vous ne devez pas terminer l'URL
avec /~/ et devrait ajouter un point à la fin dans ce cas particulier.

Génération caractéristiques
Lorsque vous n'utilisez pas la dernière génération, vous devrez spécifier celle dont vous avez besoin. Cette
sera fait avec le --génération option, qui prend une spécification de génération comme
argument. La spécification est soit le mot Nouveautés, c'est-à-dire la dernière génération
(également la valeur par défaut), ou un nombre. Voir le Les générations commande pour voir quelles sont les générations
disponibles et quels sont leurs nombres.

Politique en en gardant ainsi que enlever sauvegarde Les générations
La oublier la commande peut suivre une politique pour en conserver automatiquement certaines et supprimer d'autres sauvegardes
générations. La politique est définie avec le --garder=POLITIQUE option.

POLITIQUE est une liste de règles séparées par des virgules. Chaque règle se compose d'un nombre et d'une période.
Les périodes sont h, d, w, met y, pour l'heure, le jour, la semaine, le mois et l'année.

Une politique de 30d signifie conserver la dernière sauvegarde pour chaque jour où une sauvegarde a été effectuée, et
conserver les 30 dernières sauvegardes de ce type. Toute sauvegarde correspondant à une règle de politique est conservée, et toute
les sauvegardes intermédiaires seront supprimées, de même que toutes les sauvegardes plus anciennes que la plus ancienne sauvegarde conservée.

Par exemple, supposons que les sauvegardes soient effectuées toutes les heures, à l'heure : à 00h00, 01h00, 02h00,
et ainsi de suite jusqu'à 23h00. Si la oublier la commande est exécutée à 23h15, avec la politique ci-dessus, elle
conservera la sauvegarde effectuée à 23h00 chaque jour et supprimera toutes les autres sauvegardes ce jour-là.
Il supprimera également les sauvegardes de plus de 30 jours.

Si des sauvegardes sont effectuées tous les deux jours, à midi, oublier conserverait les 30 dernières sauvegardes, soit 60
jours de sauvegardes, avec la politique ci-dessus.

Notez qu'obnam n'inspectera que les horodatages dans le référentiel de sauvegarde et ne s'en souciera pas
quelle est l'heure actuelle. Cela signifie que si vous arrêtez de faire de nouvelles sauvegardes, le
ceux qui existent ne seront pas supprimés automatiquement. En substance, obnam prétend l'heure actuelle
est juste après la dernière sauvegarde lorsque oublier est exécuté.

Les règles peuvent être données dans n'importe quel ordre, mais seront triées par ordre croissant de période de temps
avant d'être appliqué. (C'est une erreur de donner deux règles pour la même période.) Une sauvegarde
la génération est conservée si elle correspond à une règle.

Par exemple, supposons la même fréquence de sauvegarde que ci-dessus, mais une politique de 30j,52w. Ce
conservera la sauvegarde quotidienne la plus récente pour chaque jour pendant trente jours, ainsi que l'hebdomadaire le plus récent
sauvegarde pendant 52 semaines. Parce que les sauvegardes horaires seront supprimées quotidiennement, avant qu'elles n'aient un
chance d'être sauvé par une règle hebdomadaire, l'effet est que la sauvegarde de 23h00 pour chaque
jour est enregistré pendant un mois et la sauvegarde de 23h00 le dimanche est enregistrée pendant un an.

Si, à la place, vous utilisez une politique de 72h,30j,52w, Obnam conserverait les 72 dernières sauvegardes horaires,
et la dernière sauvegarde de chaque jour calendaire pendant 30 jours, et la dernière sauvegarde de chaque calendrier
semaine pendant 52 semaines. Si la fréquence de sauvegarde était une fois par jour, Obnam garderait la sauvegarde
de chaque heure calendaire pour laquelle une sauvegarde a été effectuée, pour 72 de ces sauvegardes. En d'autres termes,
il conserverait effectivement les 72 dernières sauvegardes quotidiennes.

Cela semble déroutant ? Pensez à quel point le développeur était confus lors de l'écriture du code.

Si aucune politique n'est donnée, oublier gardera tout.

Une politique typique pourrait être 72h,7j,5w,12m, ce qui signifie : conserver les 72 dernières sauvegardes horaires, les
les 7 dernières sauvegardes quotidiennes, les 5 dernières sauvegardes hebdomadaires et les 12 dernières sauvegardes mensuelles. Si la
les sauvegardes sont systématiquement exécutées sur une base horaire, cela impliquera de conserver des sauvegardes horaires
pendant trois jours, des sauvegardes quotidiennes pendant une semaine, des sauvegardes hebdomadaires pendant un mois et des sauvegardes mensuelles
pour un an.

Le fonctionnement de la politique est un peu compliqué. Courir oublier les --faire semblant Option de
assurez-vous de supprimer les bons.

En utilisant chiffrement
Obnam peut crypter toutes les données qu'il écrit dans le référentiel de sauvegarde. Il utilise gpg(1) faire
le cryptage. Vous devez créer une paire de clés en utilisant gpg --gen-clé (ou utiliser un existant
un), puis dites Obnam à ce sujet en utilisant le --chiffrer-avec option. Vous pouvez éventuellement
utiliser un répertoire personnel séparé en utilisant le --gnupghome option. Par défaut, la valeur par défaut
répertoire pour gpg(1) sera utilisé.

configuration fichiers
Obnam recherchera les fichiers de configuration dans un certain nombre d'emplacements. Voir la section FICHIERS
pour une liste. Tous ces fichiers ensemble sont traités comme un seul gros fichier avec le contenu de tous
fichiers concaténés.

Les fichiers sont au format INI, et seuls les [configuration] section est utilisée (toutes les autres sections sont
ignoré).

Les noms longs des options sont utilisés comme clés pour les variables de configuration. Tout paramètre qui
peut être défini à partir de la ligne de commande peut être défini dans un fichier de configuration, dans le [configuration]
.

Par exemple, les options de la ligne de commande suivante :

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

peut être remplacé par le fichier de configuration suivant :

[configuration]
référentiel : /backup
exclure : .wav$

(Vous pouvez utiliser soit foo=valeur or toto : Plus-value syntaxe dans les fichiers.)

La seule chose inhabituelle à propos des fichiers est la façon dont les options qui peuvent être utilisées plusieurs fois sont
exprimé. Toutes les valeurs sont placées sur une seule ligne logique, séparées par des virgules (et
éventuellement des espaces aussi). Par exemple:

[configuration]
exclure = foo, bar, \.mp3$

Ce qui précède a trois valeurs pour le exclure option : tous les fichiers qui contiennent les mots foo or
barre n'importe où dans le chemin d'accès complet, ou des fichiers dont les noms se terminent par un point et
mp3 (car les exclusions sont des expressions régulières).

Une longue ligne logique peut être divisée en plusieurs lignes physiques, en commençant une nouvelle ligne à
espace blanc et indentation des lignes de continuation :

[configuration]
exclure = foo,
bar,
\.mp3$

L'exemple ci-dessus ajoute trois modèles d'exclusion.

Multiple CLIENTS ainsi que verrouillage
Obnam prend en charge le partage d'un référentiel entre plusieurs clients. Les clients peuvent partager le
contenu du fichier (morceaux), de sorte que si le client A sauvegarde un fichier volumineux et que le client B a le
même fichier, alors B n'a pas besoin de télécharger le fichier volumineux dans le référentiel une deuxième fois.
Pour que cela fonctionne sans confusion, les clients utilisent un protocole de verrouillage simple qui permet
un seul client à la fois pour modifier les structures de données partagées. Les serrures n'empêchent pas
accès en lecture seule en même temps : cela vous permet de restaurer pendant que quelqu'un d'autre est
sauvegarde.

Parfois, une opération en lecture seule se produit pour accéder à une structure de données en même temps qu'elle
est en cours de modification. Cela peut entraîner un crash. Cela n'entraînera pas de données corrompues, ou
restaurations incorrectes. Cependant, vous devrez peut-être redémarrer l'opération en lecture seule après un
crash.

OPTIONS

--always-restore-setuid
restaurer les bits setuid/setgid dans les fichiers restaurés, même s'ils ne sont pas root ou sauvegardés
avait un propriétaire différent de celui de l'utilisateur en cours de restauration

--no-always-restore-setuid
opposé de --always-restore-setuid

--Nom du client=NOM DU CLIENT
nom du client (par défaut le nom d'hôte)

--compresser avec=PROGRAMME
utiliser PROGRAM pour compresser le référentiel avec (un parmi aucun, dégonfler)

--âge critique=L'âge
pour nagios-last-backup-age : âge maximum (par défaut en heures) pour le plus récent
sauvegarde avant que les statistiques ne soient critiques. Accepte un spécificateur d'unité de caractère (s,m,h,d pour
secondes, minutes, heures et jours.

--dump-repo-file-métadonnées
vider les métadonnées sur les fichiers ?

--no-dump-repo-file-metadata
opposé de --dump-repo-file-metadata

--generate-manpage=MODÈLE
SUPPRESSION DE L'AIDE

--génération=GÉNÉRATION
quelle génération restaurer

-h, --Aidez-moi
afficher ce message d'aide et quitter

--garder=GARDER
politique pour quelles générations garder en oubliant

--lock-timeout=TIMEOUT
lors du verrouillage dans le référentiel de sauvegarde, attendez TIMEOUT secondes pour qu'un verrou existant
partir avant d'abandonner

--output=DOSSIER
écrire la sortie dans FILE, au lieu de la sortie standard

--faire semblant, - à sec, --pas d'action
ne change rien (fonctionne uniquement avec la sauvegarde, l'oubli et la restauration, et
peut seulement simuler un comportement approximativement réel)

--sans faire semblant, --pas de tirage à sec, --non-non-acte
à l'opposé de --pretend

--silencieux, --silencieux
être silencieux : afficher uniquement les messages d'erreur, aucune mise à jour de la progression

--no-silencieux, --non-silencieux
opposé de --quiet

-r, --dépôt=URL
nom du référentiel de sauvegarde (peut être un chemin d'accès ou une URL prise en charge)

--format-dépôt=Format
utiliser FORMAT pour les nouveaux référentiels ; l'un des "6", "albatros vert"

--à=À
où restaurer ou monter FUSE ; pour les restaurations, doit être vide ou ne doit pas exister

--verbeux
soyez bavard : dites plus à l'utilisateur ce qui se passe et assurez-vous généralement que l'utilisateur
est conscient de ce qui se passe ou au moins que quelque chose se passe et fait également
assurez-vous que leur écran reçoit des mises à jour fréquemment et qu'il y a des changements qui se produisent
tout le temps pour qu'ils ne s'ennuient pas et qu'ils soient en fait frustrés par
se laisser distraire par tant de mises à jour qu'ils se déplaceront dans le désert de Gobi pour
vivre sous un rocher

--non-verbeux
opposé de --verbose

--verify-aléatoirement=N
vérifier N fichiers au hasard à partir de la sauvegarde (la valeur par défaut est zéro, ce qui signifie tout)

--version
afficher le numéro de version du programme et quitter

--warn-âge=L'âge
pour nagios-last-backup-age : âge maximum (par défaut en heures) pour le plus récent
sauvegarde avant que l'état soit un avertissement. Accepte un spécificateur d'unité de caractère (s,m,h,d pour
secondes, minutes, heures et jours.

Support up
--point de contrôle=TAILLE
faire un point de contrôle après une TAILLE donnée

--dédupliquer=MODE
trouver des données en double dans les données sauvegardées et les stocker une seule fois ; trois modes sont
disponible : ne jamais dédupliquer, vérifier qu'aucune collision de hachage ne se produit, ou (le
par défaut) accepter fatalement le risque de collisions

--exclure=EXCLURE
expression régulière pour les chemins à exclure de la sauvegarde (peut être utilisé plusieurs
fois)

--exclure-les caches
exclure les répertoires (et leurs sous-répertoires) qui contiennent un fichier CACHEDIR.TAG (voir
http://www.brynosaurus.com/cachedir/spec.html pour ce qu'il doit contenir, et
http://liw.fi/cachedir/ pour un outil d'aide)

--no-exclude-caches
opposé de --exclude-caches

--exclure de=DOSSIER
lire les modèles d'exclusion de FILE

--comprendre=COMPRENDRE
expression régulière pour les chemins à inclure à partir de la sauvegarde même si elle correspond à un
règle d'exclusion (peut être utilisé plusieurs fois)

--leave-points de contrôle
laisser les générations de points de contrôle à la fin d'une exécution de sauvegarde réussie

--no-leave-points de contrôle
opposé de --leave-checkpoints

--un-système-de-fichiers
exclure les répertoires (et leurs sous-répertoires) qui se trouvent dans un système de fichiers différent

--aucun-système-de-fichiers
opposé de --one-file-system

--racine=URL
quoi sauvegarder

--petits-fichiers-dans-btree
ceci n'est disponible que pour la compatibilité descendante ; ne l'utilisez pas et retirez-le
à partir de votre configuration

--pas de petits fichiers dans btree
opposé de --small-files-in-btree

configuration fichiers ainsi que Paramétres
--config=DOSSIER
ajouter FILE aux fichiers de configuration

--dump-config
écrire toute la configuration actuelle

--dump-setting-names
SUPPRESSION DE L'AIDE

--aide-à tous
afficher toutes les options

--list-config-files
SUPPRESSION DE L'AIDE

--no-default-configs
effacer la liste des fichiers de configuration à lire

Développement of Obnam lui-même
--crash-limite=COMPTEUR
planter artificiellement le programme après que les fichiers COUNTER ont été écrits dans le référentiel ; cette
est utile pour les crash tests de l'application, et ne doit pas être activé pour de vrai
utilisation; mis à 0 pour désactiver (désactivé par défaut)

--faire semblant=TIMESTAMP
prétendre que c'est TIMESTAMP (AAAA-MM-JJ HH:MM:SS); ce n'est utile que pour tester
des fins

--sftp-délai=SFTP-RETARD
ajouter un délai artificiel (en millisecondes) à tous les transferts SFTP

--test-échec-correspondance=REGEXP
assistant de test de développement : simulez les échecs lors de la sauvegarde pour les fichiers qui correspondent
les expressions régulières données

--tracer=TRACE
ajouter aux modèles de nom de fichier pour lesquels la journalisation du débogage de trace se produit

Chiffrement
--chiffrer-avec=CHIFFREMENT-AVEC
Clé PGP avec laquelle chiffrer les données dans le référentiel de sauvegarde

--gnupghome=ACCUEIL REP
répertoire personnel pour GPG

--détails-clés
afficher des ID utilisateur supplémentaires pour toutes les clés

--pas de détails clés
opposé de --key-details

--identifiant de clé=ID CLÉ
Identifiant de clé PGP à ajouter/supprimer du référentiel de sauvegarde

--bits-clés-symétriques=BITS
taille de la clé symétrique, en bits

--faible-aléatoire
utilisez /dev/urandom au lieu de /dev/random pour générer des clés symétriques

--no-faible-aléatoire
opposé de --weak-random

Intégrité vérification (fsck)
--fsck-fix
fsck devrait-il essayer de résoudre les problèmes ? Implique --fsck-rm-unused

--no-fsck-fix
opposé de --fsck-fix

--fsck-ignore-morceaux
ignorer les morceaux lors de la vérification de l'intégrité du référentiel (supposer que tous les morceaux existent et sont
corriger)

--no-fsck-ignore-morceaux
opposé de --fsck-ignore-chunks

--fsck-ignore-client=Nom
ne pas vérifier les données du référentiel pour le NOM cient

--fsck-dernière-génération-seulement
vérifier uniquement la dernière génération pour chaque client

--no-fsck-dernière-génération-uniquement
opposé de --fsck-last-generation-only

--fsck-rm-inutilisé
fsck doit-il supprimer les morceaux inutilisés ?

--no-fsck-rm-inutilisé
opposé de --fsck-rm-unused

--fsck-skip-sommes de contrôle
ne pas vérifier les sommes de contrôle des fichiers

--no-fsck-skip-sommes de contrôle
opposé de --fsck-skip-checksums

--fsck-skip-répertoires
ne rien vérifier sur les répertoires et leurs fichiers

--no-fsck-skip-répertoires
opposé de --fsck-skip-dirs

--fsck-skip-fichiers
ne rien vérifier sur les fichiers

--no-fsck-skip-files
opposé de --fsck-skip-files

--fsck-skip-générations
ne pas vérifier les générations

--no-fsck-skip-générations
opposé de --fsck-skip-generations

--fsck-skip-par-client-b-trees
ne pas vérifier les arbres B par client

--no-fsck-skip-per-client-b-trees
opposé de --fsck-skip-per-client-b-trees

--fsck-skip-shared-b-trees
ne pas vérifier les arbres B partagés

--no-fsck-skip-shared-b-trees
opposé de --fsck-skip-shared-b-trees

Journal
--Journal=DOSSIER
écrire les entrées de journal dans FILE (la valeur par défaut est de ne pas écrire du tout les fichiers journaux) ; utiliser "syslog"
pour se connecter au journal système, "stderr" pour se connecter à la sortie d'erreur standard ou "aucun" pour
désactiver la journalisation

--log-keep=N
conserver les N derniers journaux (10)

--niveau de journal=NIVEAU
log au NIVEAU, l'un des débogage, info, avertissement, erreur, critique, fatal (par défaut : info)

--log-max=TAILLE
faire pivoter les journaux plus grands que SIZE, zéro pour jamais (par défaut : 0)

--log-mode=MODE
définir les autorisations des nouveaux fichiers journaux sur MODE (octal ; par défaut 0600)

Montage avec FUSE
--fuse-opt=FUSE
options pour passer directement à Fuse

Performance
--dump-memory-profil=MÉTHODE
faire des vidages de profilage de mémoire à l'aide de METHOD, qui est l'un des suivants : none, simple ou meliae
(par défaut : simple)

--memory-dump-intervalle=SECONDS
faire des vidages de profilage de mémoire à au moins SECONDES d'intervalle

Performance peaufinage
--chunk-taille=TAILLE
taille des morceaux de données de fichiers sauvegardés

--chunkids-par-groupe=NUM
encoder NUM identifiants de blocs par groupe

--idpath-bits=IDPATH-BITS
taille du niveau d'identification de bloc

--idpath-profondeur=IDPATH-PROFONDEUR
profondeur de mappage d'identifiant de bloc

--idpath-skip=IDPATH-SKIP
chunk id mappage des bits les plus bas sauter

--lru-taille=TAILLE
taille du cache LRU pour les nœuds B-tree

--node-taille=TAILLE
taille des nœuds B-tree sur le disque ; n'affecte que les nouveaux arbres B, vous devrez donc peut-être supprimer un
client ou référentiel pour changer cela pour les référentiels existants

--upload-queue-size=TAILLE
longueur de la file d'attente de téléchargement pour les nœuds B-tree

Dépôt le format albatros-vert
--grossier-taille-du-sac=TAILLE
taille maximale approximative du sac combinant de nombreux objets en morceaux

--chunk-cache-taille=TAILLE
taille du cache en mémoire pour les objets de bloc de données de fichier

--dir-sac-taille=TAILLE
approximage taille maximale des sacs combinant de nombreux objets DIR

--dir-cache-taille=TAILLE
taille du cache en mémoire pour les objets DIR

SSH / SFTP
--pure-paramiko
n'utilisez pas openssh même s'il est disponible, utilisez uniquement paramiko à la place

--no-pur-paramiko
opposé de --pure-paramiko

--ssh-commande=EXÉCUTABLE
exécutable alternatif à utiliser à la place de "ssh" (le chemin complet est autorisé, non
des arguments peuvent être ajoutés)

--ssh-host-keys-check=VALEURE
Si « oui », exigez que la clé de l'hôte ssh soit connue et correcte pour être acceptée.
Si "non", ne l'exigez pas. Si « demander », l'utilisateur est invité de manière interactive à accepter
nouveaux hôtes. La valeur par défaut ("ssh-config") consiste à s'appuyer sur les paramètres du sous-jacent
Client SSH

--clé-ssh=NOM DE FICHIER
utiliser FILENAME comme clé privée ssh RSA pour l'accès sftp (la valeur par défaut est d'utiliser des clés
connu de ssh-agent)

--ssh-hôtes-connus=NOM DE FICHIER
nom de fichier du fichier d'hôtes connus de l'utilisateur

--strict-ssh-host-keys
OBLIGATOIRE, utilisez plutôt --ssh-host-keys-check

--no-strict-ssh-host-keys
opposé de --strict-ssh-host-keys

Option valeurs
La TAILLE valeur dans les options mentionnées ci-dessus spécifie une taille en octets, avec en option
suffixes pour indiquer les kilo-octets (k), les kibioctets (Ki), les mégaoctets (M), les mebioctets (Mi),
gigaoctets (G), gibioctets (Gi), téraoctets (T), tibioctets (Ti). Les suffixes sont case-
insensible.

EXIT STATUT

Obnam sortira avec zéro si tout s'est bien passé, et différent de zéro sinon.

ENVIRONNEMENT

Obnam transmettra l'environnement qu'il obtient de son parent, sans modification. Cela fait
n'obéit à aucune variable d'environnement inhabituelle, mais il obéit aux variables habituelles lors de l'exécution
programmes externes, création de fichiers temporaires, etc.

Utiliser obnam en ligne en utilisant les services onworks.net