bup-save - manuel de référence, options, exemples de commandes


NOM

bup-save - créer un nouveau jeu de sauvegarde bup

SYNOPSIS

bup save [-r host:path] <-t|-c|-n name> [-#] [-f indexfile] [-v] [-q] [--smaller=maxsize] <paths...>;

DESCRIPTION

bup save enregistre le contenu des fichiers ou des chemins donnés dans un nouveau jeu de sauvegarde et nomme éventuellement ce jeu de sauvegarde.

Notez que pour vous référer à votre jeu de sauvegarde ultérieurement (c'est-à-dire pour la restauration), vous devez soit spécifier --name (le cas normal), soit enregistrer l'arborescence ou l'ID de validation imprimé par --tree ou --commit.

Avant d'essayer d'enregistrer des fichiers à l'aide de bup save, vous devez d'abord mettre à jour l'index à l'aide de bup index. Les raisons de séparer les deux étapes sont décrites dans la page de manuel de bup-index(1).

Par défaut, les métadonnées seront enregistrées pour chaque chemin et les métadonnées de tous les répertoires parents non indexés des chemins indexés seront extraites directement du système de fichiers. Cependant, si --strip, --strip-path ou --graft est spécifié, les métadonnées ne seront pas enregistrées pour le répertoire racine (/). Voir bup-restore(1) pour plus d'informations sur la gestion des métadonnées.

OPTIONS

-r, --remote=host:path

enregistrer le jeu de sauvegarde sur le serveur distant donné. Si path est omis, utilise le chemin par défaut sur le serveur distant (vous devez toujours inclure le `:'). La connexion au serveur distant se fait en SSH. Si vous souhaitez spécifier le port, l'utilisateur ou la clé privée à utiliser pour la connexion SSH, nous vous recommandons d'utiliser le fichier ~/.ssh/config.

-t, --tree

après avoir créé le jeu de sauvegarde, imprimez l'identifiant de l'arborescence git de la sauvegarde résultante.

-c, --commit

après avoir créé le jeu de sauvegarde, imprimez l'identifiant de validation git de la sauvegarde résultante.

-n, --name=name

après avoir créé le jeu de sauvegarde, créez une branche git nommée name afin que la sauvegarde soit accessible à l'aide de ce nom. Si nom existe déjà, la nouvelle sauvegarde sera considérée comme un descendant de l'ancien nom. (Ainsi, vous pouvez continuellement créer de nouveaux jeux de sauvegarde avec le même nom, et afficher ultérieurement l'historique de ce jeu de sauvegarde pour voir comment les fichiers ont changé au fil du temps.)

-d, --date=date

spécifiez la date de la sauvegarde, en secondes depuis l'époque, au lieu de l'heure actuelle.

-f, --indexfile=indexfile

utilisez un nom de fichier d'index différent au lieu de $BUP_DIR/bupindex.

-v, --verbose

augmenter la verbosité (peut être utilisé plus d'une fois). Avec un -v, imprime chaque nom de répertoire au fur et à mesure qu'il est sauvegardé. Avec deux -v, imprime également chaque nom de fichier.

-q, --quiet

désactiver les messages de progression.

--smaller=maxsize

ne sauvegardez pas les fichiers >= maxsize octets. Vous pouvez l'utiliser pour exécuter des sauvegardes incrémentielles fréquentes de vos petits fichiers, qui peuvent généralement être sauvegardés rapidement, et ignorer les gros (comme les images de machines virtuelles) qui prennent plus de temps. Ensuite, vous pouvez sauvegarder les fichiers volumineux moins fréquemment. Utilisez un suffixe comme k, M ou G pour spécifier des multiples de 1024, 1024*1024, 1024*1024*1024 respectivement.

--bwlimit=bytes/sec

ne transmettez pas plus de octets/sec octets par seconde au serveur. C'est bon pour que vos sauvegardes n'absorbent pas toute la bande passante de votre réseau. Utilisez un suffixe comme k, M ou G pour spécifier des multiples de 1024, 1024*1024, 1024*1024*1024 respectivement.

--strip

supprime le chemin donné à partir de tous les fichiers et répertoires.

Un répertoire /root/chroot/etc enregistré avec « bup save -n chroot --strip /root/chroot » sera enregistré sous /etc. Notez qu'actuellement, les métadonnées ne seront pas enregistrées pour le répertoire racine (/) lorsque cette option est spécifiée.

--strip-path=path-prefix

supprime le préfixe de chemin donné path-prefix de tous les fichiers et répertoires.

Un répertoire /root/chroot/webserver/etc enregistré avec « bup save -n webserver --strip-path=/root/chroot /root/chroot/webserver/etc » serait enregistré sous /webserver/etc. Notez qu'actuellement, les métadonnées ne seront pas enregistrées pour le répertoire racine (/) lorsque cette option est spécifiée.

--graft=old_path=new_path

un point de greffe old_path=new_path (peut être utilisé plusieurs fois).

Un répertoire /root/chroot/a/etc enregistré avec "bup save -n chroot --graft /root/chroot/a=/chroot/a " sera enregistré sous /chroot/ a/etc. Notez qu'actuellement, les métadonnées ne seront pas enregistrées pour le répertoire racine (/) lorsque cette option est spécifiée.

-#, --compress=#

réglez le niveau de compression sur # (une valeur comprise entre 0 et 9, où 9 est la valeur la plus élevée et 0 signifie qu'il n'y a pas de compression). La valeur par défaut est 1 (compression rapide et souple)

EXEMPLES

$ bup index -ux /etc
Indexing: 1981, done.

$ bup save -r myserver: -n my-pc-backup --bwlimit=50k /etc
Reading index: 1981, done.
Saving: 100.00% (998/998k, 1981/1981 files), done.



$ ls /home/joe/chroot/httpd
bin var

$ bup index -ux /home/joe/chroot/httpd
Indexing: 1337, done.

$ bup save --strip -n joes-httpd-chroot /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.

$ bup ls joes-httpd-chroot/latest/
bin/
var/


$ bup save --strip-path=/home/joe/chroot -n joes-chroot \
     /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.

$ bup ls joes-chroot/latest/
httpd/


$ bup save --graft /home/joe/chroot/httpd=/http-chroot \
     -n joe
     /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.

$ bup ls joe/latest/
http-chroot/

VOIR ÉGALEMENT

bup-index(1), bup-split(1), bup-on(1), bup-restore(1), ssh_config(5)

BUP

Fait partie de la suite bup(1).

AUTEURS

Avery Pennarun apenwarr@gmail.com.