restic/doc/man/restic-backup.1

.TH "restic backup" "1" "Jan 2017" "generated by `restic generate`" "" 
.nh
.ad l


.SH NAME
.PP
restic\-backup \- Create a new backup of files and/or directories


.SH SYNOPSIS
.PP
\fBrestic backup [flags] FILE/DIR [FILE/DIR] ...\fP


.SH DESCRIPTION
.PP
The "backup" command creates a new snapshot and saves the files and directories
given as the arguments.


.SH OPTIONS
.PP
\fB\-e\fP, \fB\-\-exclude\fP=[]
    exclude a \fB\fCpattern\fR (can be specified multiple times)

.PP
\fB\-\-exclude\-caches\fP[=false]
    excludes cache directories that are marked with a CACHEDIR.TAG file

.PP
\fB\-\-exclude\-file\fP=[]
    read exclude patterns from a \fB\fCfile\fR (can be specified multiple times)

.PP
\fB\-\-exclude\-if\-present\fP=[]
    takes filename[:header], exclude contents of directories containing filename (except filename itself) if header of that file is as provided (can be specified multiple times)

.PP
\fB\-\-files\-from\fP=""
    read the files to backup from file (can be combined with file args)

.PP
\fB\-f\fP, \fB\-\-force\fP[=false]
    force re\-reading the target files/directories (overrides the "parent" flag)

.PP
\fB\-h\fP, \fB\-\-help\fP[=false]
    help for backup

.PP
\fB\-\-hostname\fP=""
    set the \fB\fChostname\fR for the snapshot manually. To prevent an expensive rescan use the "parent" flag

.PP
\fB\-x\fP, \fB\-\-one\-file\-system\fP[=false]
    exclude other file systems

.PP
\fB\-\-parent\fP=""
    use this parent snapshot (default: last snapshot in the repo that has the same target files/directories)

.PP
\fB\-\-stdin\fP[=false]
    read backup from stdin

.PP
\fB\-\-stdin\-filename\fP="stdin"
    file name to use when reading from stdin

.PP
\fB\-\-tag\fP=[]
    add a \fB\fCtag\fR for the new snapshot (can be specified multiple times)

.PP
\fB\-\-time\fP=""
    time of the backup (ex. '2012\-11\-01 22:08:41') (default: now)

.PP
\fB\-\-with\-atime\fP[=false]
    store the atime for all files and directories


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB\-\-cacert\fP=[]
    path to load root certificates from (default: use system certificates)

.PP
\fB\-\-cache\-dir\fP=""
    set the cache directory

.PP
\fB\-\-cleanup\-cache\fP[=false]
    auto remove old cache directories

.PP
\fB\-\-json\fP[=false]
    set output mode to JSON for commands that support it

.PP
\fB\-\-limit\-download\fP=0
    limits downloads to a maximum rate in KiB/s. (default: unlimited)

.PP
\fB\-\-limit\-upload\fP=0
    limits uploads to a maximum rate in KiB/s. (default: unlimited)

.PP
\fB\-\-no\-cache\fP[=false]
    do not use a local cache

.PP
\fB\-\-no\-lock\fP[=false]
    do not lock the repo, this allows some operations on read\-only repos

.PP
\fB\-o\fP, \fB\-\-option\fP=[]
    set extended option (\fB\fCkey=value\fR, can be specified multiple times)

.PP
\fB\-p\fP, \fB\-\-password\-file\fP=""
    read the repository password from a file (default: $RESTIC\_PASSWORD\_FILE)

.PP
\fB\-q\fP, \fB\-\-quiet\fP[=false]
    do not output comprehensive progress report

.PP
\fB\-r\fP, \fB\-\-repo\fP=""
    repository to backup to or restore from (default: $RESTIC\_REPOSITORY)


.SH SEE ALSO
.PP
\fBrestic(1)\fP
Update manpages and auto-completion 2017-09-26 11:16:08 +00:00			.TH "restic backup" "1" "Jan 2017" "generated by `restic generate`" ""
Add generated manual pages 2017-08-05 09:42:37 +00:00			`.nh`
			`.ad l`


			`.SH NAME`
			`.PP`
Update manpages This is a programmatic change; just ran `restic man-page` 2017-09-11 19:05:51 +00:00			`restic\-backup \- Create a new backup of files and/or directories`
Add generated manual pages 2017-08-05 09:42:37 +00:00

			`.SH SYNOPSIS`
			`.PP`
			`\fBrestic backup [flags] FILE/DIR [FILE/DIR] ...\fP`


			`.SH DESCRIPTION`
			`.PP`
			`The "backup" command creates a new snapshot and saves the files and directories`
			`given as the arguments.`


			`.SH OPTIONS`
			`.PP`
			`\fB\-e\fP, \fB\-\-exclude\fP=[]`
			`exclude a \fB\fCpattern\fR (can be specified multiple times)`

Add option to exclude directories with a tagfile The option is named --exclude-if-present and accepts a parameter filename[:content]. Directories are excluded and their contents is not backed up if they contain a file with the specified name and, optionally, that starts with the specified content. The tagfile itself is never excluded. There is also a shortcut --exclude-caches that works in the same way as the likewise-named option of tar(1): Directories are recognized as cache if they contain a file named "CACHEDIR.TAG. Closes #317. 2017-08-19 20:44:18 +00:00			`.PP`
			`\fB\-\-exclude\-caches\fP[=false]`
			`excludes cache directories that are marked with a CACHEDIR.TAG file`

Add generated manual pages 2017-08-05 09:42:37 +00:00			`.PP`
			`\fB\-\-exclude\-file\fP=[]`
			`read exclude patterns from a \fB\fCfile\fR (can be specified multiple times)`

Add option to exclude directories with a tagfile The option is named --exclude-if-present and accepts a parameter filename[:content]. Directories are excluded and their contents is not backed up if they contain a file with the specified name and, optionally, that starts with the specified content. The tagfile itself is never excluded. There is also a shortcut --exclude-caches that works in the same way as the likewise-named option of tar(1): Directories are recognized as cache if they contain a file named "CACHEDIR.TAG. Closes #317. 2017-08-19 20:44:18 +00:00			`.PP`
Update manual pages 2017-09-10 13:33:20 +00:00			`\fB\-\-exclude\-if\-present\fP=[]`
			`takes filename[:header], exclude contents of directories containing filename (except filename itself) if header of that file is as provided (can be specified multiple times)`
Add option to exclude directories with a tagfile The option is named --exclude-if-present and accepts a parameter filename[:content]. Directories are excluded and their contents is not backed up if they contain a file with the specified name and, optionally, that starts with the specified content. The tagfile itself is never excluded. There is also a shortcut --exclude-caches that works in the same way as the likewise-named option of tar(1): Directories are recognized as cache if they contain a file named "CACHEDIR.TAG. Closes #317. 2017-08-19 20:44:18 +00:00
Add generated manual pages 2017-08-05 09:42:37 +00:00			`.PP`
			`\fB\-\-files\-from\fP=""`
			`read the files to backup from file (can be combined with file args)`

			`.PP`
			`\fB\-f\fP, \fB\-\-force\fP[=false]`
			`force re\-reading the target files/directories (overrides the "parent" flag)`

			`.PP`
			`\fB\-h\fP, \fB\-\-help\fP[=false]`
			`help for backup`

			`.PP`
backup: Do not print hostname in help text This is necessary so that the manpage generation is deterministic and we can test if the man pages are up to date when the CI tests run. 2017-08-05 09:54:59 +00:00			`\fB\-\-hostname\fP=""`
Add note about rescan to hostname flag (fixes #1221) 2017-09-22 12:29:04 +00:00			`set the \fB\fChostname\fR for the snapshot manually. To prevent an expensive rescan use the "parent" flag`
Add generated manual pages 2017-08-05 09:42:37 +00:00
			`.PP`
			`\fB\-x\fP, \fB\-\-one\-file\-system\fP[=false]`
			`exclude other file systems`

			`.PP`
			`\fB\-\-parent\fP=""`
			`use this parent snapshot (default: last snapshot in the repo that has the same target files/directories)`

			`.PP`
			`\fB\-\-stdin\fP[=false]`
			`read backup from stdin`

			`.PP`
			`\fB\-\-stdin\-filename\fP="stdin"`
			`file name to use when reading from stdin`

			`.PP`
			`\fB\-\-tag\fP=[]`
			`add a \fB\fCtag\fR for the new snapshot (can be specified multiple times)`

manual updated 2017-09-09 10:10:38 +00:00			`.PP`
			`\fB\-\-time\fP=""`
			`time of the backup (ex. '2012\-11\-01 22:08:41') (default: now)`

Update manpages and auto-completion 2017-12-27 21:31:03 +00:00			`.PP`
			`\fB\-\-with\-atime\fP[=false]`
			`store the atime for all files and directories`

Add generated manual pages 2017-08-05 09:42:37 +00:00
			`.SH OPTIONS INHERITED FROM PARENT COMMANDS`
Update manpages and auto-completion 2017-11-26 18:46:16 +00:00			`.PP`
			`\fB\-\-cacert\fP=[]`
			`path to load root certificates from (default: use system certificates)`

doc: Update manpages 2017-09-24 21:13:04 +00:00			`.PP`
			`\fB\-\-cache\-dir\fP=""`
			`set the cache directory`

Update manpages and auto-completion 2017-12-27 21:31:03 +00:00			`.PP`
			`\fB\-\-cleanup\-cache\fP[=false]`
			`auto remove old cache directories`

Add generated manual pages 2017-08-05 09:42:37 +00:00			`.PP`
			`\fB\-\-json\fP[=false]`
			`set output mode to JSON for commands that support it`

Update manpages and auto-completion 2017-11-26 18:46:16 +00:00			`.PP`
			`\fB\-\-limit\-download\fP=0`
			`limits downloads to a maximum rate in KiB/s. (default: unlimited)`

			`.PP`
			`\fB\-\-limit\-upload\fP=0`
			`limits uploads to a maximum rate in KiB/s. (default: unlimited)`

doc: Update manpages 2017-09-24 21:13:04 +00:00			`.PP`
			`\fB\-\-no\-cache\fP[=false]`
			`do not use a local cache`

Add generated manual pages 2017-08-05 09:42:37 +00:00			`.PP`
			`\fB\-\-no\-lock\fP[=false]`
			`do not lock the repo, this allows some operations on read\-only repos`

			`.PP`
			`\fB\-o\fP, \fB\-\-option\fP=[]`
			`set extended option (\fB\fCkey=value\fR, can be specified multiple times)`

			`.PP`
			`\fB\-p\fP, \fB\-\-password\-file\fP=""`
			`read the repository password from a file (default: $RESTIC\_PASSWORD\_FILE)`

			`.PP`
			`\fB\-q\fP, \fB\-\-quiet\fP[=false]`
			`do not output comprehensive progress report`

			`.PP`
			`\fB\-r\fP, \fB\-\-repo\fP=""`
			`repository to backup to or restore from (default: $RESTIC\_REPOSITORY)`


			`.SH SEE ALSO`
			`.PP`
			`\fBrestic(1)\fP`