diff --git a/README.md b/README.md index 95f231d5..1094eb6c 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ permalink: borgmatic/index.html -borgmatic (formerly atticmatic) is a simple Python wrapper script for the +borgmatic is a simple Python wrapper script for the [Borg](https://borgbackup.readthedocs.org/en/stable/) backup software that initiates a backup, prunes any old backups according to a retention policy, and validates backups for consistency. The script supports specifying your @@ -162,7 +162,7 @@ borgmatic runs `on_error` hooks if an error occurs. An important security note about hooks: borgmatic executes all hook commands with the user permissions of borgmatic itself. So to prevent potential shell injection or privilege escalation, do not forget to set secure permissions -(chmod 0700) on borgmatic configuration files and scripts invoked by hooks. +(`chmod 0700`) on borgmatic configuration files and scripts invoked by hooks. See the sample generated configuration file mentioned above for specifics about hook configuration syntax. @@ -296,6 +296,20 @@ any number of them. This supports use cases like running consistency checks from a different cron job with a different frequency, or running pruning with a different verbosity level. +Additionally, borgmatic provides convenient flags for Borg's +[list](https://borgbackup.readthedocs.io/en/stable/usage/list.html) and +[info](https://borgbackup.readthedocs.io/en/stable/usage/info.html) +functionality: + + +```bash +borgmatic --list +borgmatic --info +``` + +You can include an optional `--json` flag with either `--list` or `--info` to +get the output formatted as JSON. + ## Autopilot