Updated README

This commit is contained in:
Mike 2019-08-04 01:36:46 -07:00
parent 4f313473a6
commit 2d2f27178e

View File

@ -10,7 +10,13 @@ This can be very useful to detect files which may have been *accidentally delete
* Python library *humanfriendly* * Python library *humanfriendly*
``` sudo pip3 install humanfriendly ``` * ``` sudo pip3 install humanfriendly ```
* rsync
* ```sudo apt install rsync```
* ```sudo yum install rsync```
* etc
## How to Execute ## How to Execute
@ -30,18 +36,55 @@ You must at minimum specify the source and the backup directories. Following is
Specifies the path to your source directory Specifies the path to your source directory
### --source-remote-host < hostname or ip >
Specifies the remote host where your source directory resides
### --source-remote-user < username >
Specifies the user to connect as, when connecting to a remote host with *--source-remote-host*
### --backup-path < path > ### --backup-path < path >
Specifies the path to your backup directory Specifies the path to your backup directory
### --backup-remote-host < hostname or ip >
Specifies the remote host where your backup directory resides
### --backup-remote-user < username >
Specifies the user to connect as, when connecting to a remote host with *--backup-remote-host*
### --ssh-key < key path >
Specifies the SSH key to use, when connecting to remote hosts.
When omitted, and also connecting to a remote host, the default key for the current user will be used (probably).
### --use-rsync
Force this tool to use rsync for comparison. If not specified, directories and files will just be compared normally. In the future, the non-rsync mode might be removed.
### --rsync
Same as *--use-rsync*
### --no-clean ### --no-clean
Don't make any attempt to clean the generated report of redundant entries. This might be useful if you think the report isn't accurate. Don't make any attempt to clean the generated report of redundant entries. This might be useful if you think the report isn't accurate.
#### Example Call With Arguments #### Example Call With Arguments
Here's an example of how you might invoke the script: Here's an example of how you might invoke the script with two local directories:
```python3 /path/to/backup-diff.py --source-path "/my/source/directory/path" --backup-path "/my/backups/main-backup" ``` ```
python3 /path/to/backup-diff.py --source-path "/my/source/directory/path" --backup-path "/my/backups/main-backup"
```
Here's an example of how you might compare a local directory with a remote backup:
```
python3 /path/to/backup-diff.py --source-path "/my/local/source/directory/path" --backup-path "/path/on/remote/server/backups/main-backup" --backup-remote-host "example.com" --backup-remote-user "me123" --ssh-key "/path/to/my/ssh/key"
```