rawtaz and GitHub
e8b4d8d8bc
Merge pull request #2998 from greatroar/env-docs
...
Systematize documentation of environment variables
2020-10-24 22:49:31 +02:00
fgma and Michael Eischer
5695f9ebd2
vss: Implement VSS support for Windows
...
The VSS support works for 32 and 64-bit windows, this includes a check that
the restic version matches the OS architecture as required by VSS. The backup
operation will fail the user has not sufficient permissions to use VSS.
Snapshotting volumes also covers mountpoints but skips UNC paths.
2020-10-24 11:35:57 +02:00
greatroar
ae179ee63e
Systematize documentation of environment variables
...
Cache locations were documented inconsistently in three places.
The backup docs mentioned PATH being used to find fusermount, which is
never run by restic backup. It now mentions ssh and rclone, which are
used by backends.
The notion of a "system-wide" environment variable makes no sense.
TMPDIR is now mentioned because it allows for optimization and may
have security implications.
2020-10-22 09:57:30 +02:00
Michael Eischer
c18b119a9b
Document new option --repository-file
2020-10-01 00:50:27 +02:00
Andreas Oberritter and Michael Eischer
97f7855de3
Add new option --repository-file (default: $RESTIC_REPOSITORY_FILE)
...
As an alternative to -r, this allows to read the repository URL
from a file in order to prevent certain types of information leaks,
especially for URLs containing credentials.
Fixes #1458 , fixes #2900 .
2020-10-01 00:50:26 +02:00
yoshiera
ac4b8c98ac
Support excluding files by size
2020-09-19 19:52:09 +08:00
Alexander Weiss and Michael Eischer
9867c4bbb4
Add flag --iexclude-file to backup
2020-08-28 21:04:41 +02:00
rawtaz and Leo R. Lundgren
b43ab67a22
doc: Add missing environment variables
2020-08-24 00:49:34 +02:00
NoNE and Leo R. Lundgren
da6a34e044
doc: Add more explanation for --one-file-system option
2020-08-21 19:19:13 +02:00
josephrocca and GitHub
bd36731119
--verbose 2 to --verbose=2
...
`--verbose 2` seems to be incorrect here (gives an error/warning that "the `2` directory does not exist, skipping")
2020-08-04 08:39:43 +10:00
David Sommer and Leo R. Lundgren
5729d967f5
backup: Return exit status code 3 when failing to read source data
...
The backup command used to return a zero exit code as long as a snapshot
could be created successfully, even if some of the source files could not
be read (in which case the snapshot would contain the rest of the files).
This made it hard for automation/scripts to detect failures/incomplete
backups by looking at the exit code. Restic now returns the following exit
codes for the backup command:
- 0 when the command was successful
- 1 when there was a fatal error (no snapshot created)
- 3 when some source data could not be read (incomplete snapshot created)
2020-07-20 22:19:01 +02:00
darkdragon-001 and Leo R. Lundgren
c6b74962df
Update 040_backup.rst
...
Changes proposed in #2763 :
- Adding `RESTIC_CACHE_DIR` environment variables (introduced in #2425 for Unix and #2607 for Mac, Win).
- Adding used system-wide environment variables with links to the corresponding section.
2020-07-12 00:31:56 +02:00
rawtaz and GitHub
9dba7a2577
doc: Add note on tilde expansion in exclude files
...
Explains to the reader that tilde expansion does not work in exclude files, and that they should instead use the $HOME variable.
2020-04-18 12:47:47 +02:00
rawtaz and GitHub
b6f01ffbe6
Merge pull request #2394 from bugvillage/doc-backup-passwd
...
add description env var RESTIC_PASSWORD_COMMAND
2019-11-20 23:26:55 +01:00
rawtaz and GitHub
3a5c9aadad
Merge pull request #2444 from chanibal/patch-2
...
Docs: fixed escaping of argument in documentation
2019-11-18 21:45:00 +01:00
Leo R. Lundgren
37770b1d82
doc: Improve include patterns info
...
Clarifies and adds information on how to specify include patterns.
2019-11-18 02:23:01 +01:00
rawtaz and Leo R. Lundgren
02fea4f76a
doc: Improve exclude patterns info
...
Improves grammar, clarifies and adds information on how to specify exclude patterns.
2019-11-18 01:59:50 +01:00
Krzysztof Bociurko and GitHub
f7317a9287
Docs: fixed escaping of argument in documentation
...
Issue was visible as `foo`` in https://restic.readthedocs.io/en/latest/040_backup.html
2019-10-16 19:03:40 +02:00
bugvillage
b3e727f40d
fixing typo/align around RESTIC_PASSWORD_COMMAND
2019-09-07 15:30:23 +02:00
bugvillage
17feccd998
add description env var RESTIC_PASSWORD_COMMAND
...
The environment variable RESTIC_PASSWORD_COMMAND works but has
not been documented yet. e.g. it could contain a command that
would fetch the password from a local user keyring
enhances: https://github.com/restic/restic/pull/2094
2019-09-07 14:00:53 +02:00
Alexander Neumann
95434cff16
Merge pull request 2156 from kayrus/swift-app-cred
...
Swift: introduce application credential auth support
2019-03-16 12:17:17 +01:00
Heiko Bornholdt
db8f5864fc
Add --ignore-inode option to backup cmd
...
revised version of https://github.com/restic/restic/pull/2047
2019-03-10 21:24:29 +01:00
Alexander Neumann
7519c73987
Clarify documentation on --exclude-if-present
2019-02-22 15:22:29 +01:00
Martin Michlmayr
a2f30cde4c
Fix typos
2019-02-17 15:31:07 +00:00
kayrus
6ebcfe7c18
Swift: introduce application credential auth support
2019-02-14 14:19:05 +01:00
Alexander Neumann
56e5467096
Merge pull request 2032 from j6s/feature.case-insensitive-exclude
...
Add options for case insensitive includes & excludes
2019-02-10 12:40:33 +01:00
Alexander Neumann
fed25714a4
Merge pull request 2139 from restic/fail-zero-bytes-stdin
...
Return error when reading zero byte from stdin
2019-02-10 12:34:05 +01:00
Alexander Neumann
6f69ae1b8d
Add docs, changelog file
2019-01-06 14:52:20 +01:00
Chris Howie
05222b7343
--one-file-system unsupported on Windows
2018-11-27 11:14:47 -05:00
Johannes Hertenstein and Alexander Neumann
8a97bb8661
Add documentation for insensitive includes & excludes
2018-11-25 13:32:16 +01:00
Joe Groocock and Alexander Neumann
09e9b74cbd
Allow --files-from multiple times
...
Fixes https://github.com/restic/restic/issues/2085
2018-11-25 12:55:03 +01:00
Alexander Neumann
0c0a8e3d2b
docs: Explain recognizing modified files
2018-10-02 14:21:08 +02:00
Moritz Dietz and GitHub
99ae913414
Update B2 env variable information
...
* Fixed the B2 environment variables as they had the same description
* Added the variables for the newly introduced Application Key support #1906
2018-08-29 21:05:57 +02:00
Thomas Damgaard and Alexander Neumann
df78896e59
doc: Add list of environment variables
2018-08-28 22:18:47 +02:00
Alexander Neumann
31176d212b
doc: Add explanation for "processed" vs "added"
2018-08-18 14:26:57 +02:00
Alexander Neumann
025ec9dff5
Allow excluding files with $ via --exclude-file
...
Previously it wasn't possbile to exclude files with a literal dollar
sign (`$`) via exclude files, now users can write `$$` for that.
2018-06-22 20:46:04 +02:00
Clemens Bergmann and GitHub
ff785924de
Clarify live status display
...
When I backup one of my filesystems which has a lot of Hard Links (Backup directory of burp) the live status shows me 4.5 TB but it only takes up 1.2 TB of space in the repository. This is confusing because my repo is on S3 and I feared a huge Bill. This change should clarify this.
2018-06-15 12:41:48 +02:00
Johannes Ernst
a1536f38fa
Fixed typo and grammar per feedback on PR.
2018-06-13 00:24:42 +00:00
Johannes Ernst
888f52afd1
Added documentation about what happens if you run out of space
...
during a backup, based on conversation on the forum:
https://forum.restic.net/t/limited-backup-destination-space/733/6
2018-06-11 21:20:08 +00:00
Alexander Neumann
8943741a0b
Fix code block
2018-05-08 20:36:58 +02:00
Alexander Neumann
c3cc5d7cee
Update docs
2018-04-28 22:08:11 +02:00
rawtaz and GitHub
1e2f23d77a
Add "Including and Exluding Files" heading in docs
...
Adds "Including and Exluding Files" heading in the backup section in the docs.
[ci skip]
2018-04-11 21:14:26 +02:00
Oliver Gerlich
e361cc3807
040_backup.rst: add note regarding paths in --files-from argument
2018-03-18 20:51:04 +01:00
Oliver Gerlich
1bee3e01fa
040_backup.rst: fix typo
2018-03-18 17:06:21 +01:00
Oliver Gerlich
624a2d8305
040_backup.rst: quote wildcard characters
...
This doesn't really matter for --exclude in most cases, but it avoids
spreading bad ideas.
2018-03-18 17:05:53 +01:00
rawtaz and GitHub
fbb08c14de
Note that multiple --exclude-file may be used.
2018-02-14 22:05:52 +01:00
rawtaz and GitHub
5abd133e26
Restructure and complement exclude options doc
2018-02-14 02:03:04 +01:00
Andreas Metzler
d780ec4bce
doc: Improvements for --exclude
...
Describe exclude pattern handling, adding multiple examples.
Closes #396
2017-12-24 15:39:18 +01:00
Alexander Neumann
eb9e2bc79a
manual: Document diff command
2017-12-03 18:33:35 +01:00
Alexander Neumann
ffbc68aa2e
Document access time handling
2017-11-28 21:36:20 +01:00