improve documentation

This commit is contained in:
James Barnett
2017-01-30 20:22:01 -06:00
parent e7085c4f92
commit 25311a6397

View File

@@ -20,7 +20,6 @@ have to be sent.
snapper is required. snapper is required.
## Options ## Options
Usage: snap-sync [options] Usage: snap-sync [options]
@@ -35,6 +34,13 @@ snapper is required.
-u, --UUID <UUID> Specify the UUID of the mounted BTRFS subvolume to back up to. Otherwise will prompt. -u, --UUID <UUID> Specify the UUID of the mounted BTRFS subvolume to back up to. Otherwise will prompt.
If multiple mount points are found with the same UUID, will prompt user. If multiple mount points are found with the same UUID, will prompt user.
## First run
When you run `snap-sync` you will be prompted to choose a disk to back up to.
The first time you run `snap-sync` for a particular disk (new UUID) you will be
prompted to choose a backup location on that disk. If the directory you specify
does not exist, it will be created.
## Systemd unit and timer ## Systemd unit and timer
A systemd unit and timer are included. These are instantiated units. You need to A systemd unit and timer are included. These are instantiated units. You need to
@@ -47,7 +53,9 @@ place. Example:
The timer included is weekly. Edit both files to your taste. The timer included is weekly. Edit both files to your taste.
You can exclude a configuration from backup by setting `SNAP_SYNC_EXCLUDE=yes` You can exclude a configuration from backup by setting `SNAP_SYNC_EXCLUDE=yes`
in your snapper configuration file. in your snapper configuration file. Additionally you should run snap-sync at
least once for a new disk without using the service so you can be prompted for
the backup location.
## Example command line usage ## Example command line usage
@@ -90,6 +98,8 @@ to be sent.
### With UUID specified and no confirmations ### With UUID specified and no confirmations
This is essentially what the systemd service does.
# snap-sync --UUID 7360922b-c916-4d9f-a670-67fe0b91143c --noconfirm # snap-sync --UUID 7360922b-c916-4d9f-a670-67fe0b91143c --noconfirm
You selected the disk with UUID 7360922b-c916-4d9f-a670-67fe0b91143c. You selected the disk with UUID 7360922b-c916-4d9f-a670-67fe0b91143c.
The disk is mounted at /run/media/wes/backup. The disk is mounted at /run/media/wes/backup.