github.com/advanderveer/restic@v0.8.1-0.20171209104529-42a8c19aaea6/doc/man/restic-backup.1 (about)

     1  .TH "restic backup" "1" "Jan 2017" "generated by `restic generate`" "" 
     2  .nh
     3  .ad l
     4  
     5  
     6  .SH NAME
     7  .PP
     8  restic\-backup \- Create a new backup of files and/or directories
     9  
    10  
    11  .SH SYNOPSIS
    12  .PP
    13  \fBrestic backup [flags] FILE/DIR [FILE/DIR] ...\fP
    14  
    15  
    16  .SH DESCRIPTION
    17  .PP
    18  The "backup" command creates a new snapshot and saves the files and directories
    19  given as the arguments.
    20  
    21  
    22  .SH OPTIONS
    23  .PP
    24  \fB\-e\fP, \fB\-\-exclude\fP=[]
    25      exclude a \fB\fCpattern\fR (can be specified multiple times)
    26  
    27  .PP
    28  \fB\-\-exclude\-caches\fP[=false]
    29      excludes cache directories that are marked with a CACHEDIR.TAG file
    30  
    31  .PP
    32  \fB\-\-exclude\-file\fP=[]
    33      read exclude patterns from a \fB\fCfile\fR (can be specified multiple times)
    34  
    35  .PP
    36  \fB\-\-exclude\-if\-present\fP=[]
    37      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)
    38  
    39  .PP
    40  \fB\-\-files\-from\fP=""
    41      read the files to backup from file (can be combined with file args)
    42  
    43  .PP
    44  \fB\-f\fP, \fB\-\-force\fP[=false]
    45      force re\-reading the target files/directories (overrides the "parent" flag)
    46  
    47  .PP
    48  \fB\-h\fP, \fB\-\-help\fP[=false]
    49      help for backup
    50  
    51  .PP
    52  \fB\-\-hostname\fP=""
    53      set the \fB\fChostname\fR for the snapshot manually. To prevent an expensive rescan use the "parent" flag
    54  
    55  .PP
    56  \fB\-x\fP, \fB\-\-one\-file\-system\fP[=false]
    57      exclude other file systems
    58  
    59  .PP
    60  \fB\-\-parent\fP=""
    61      use this parent snapshot (default: last snapshot in the repo that has the same target files/directories)
    62  
    63  .PP
    64  \fB\-\-stdin\fP[=false]
    65      read backup from stdin
    66  
    67  .PP
    68  \fB\-\-stdin\-filename\fP="stdin"
    69      file name to use when reading from stdin
    70  
    71  .PP
    72  \fB\-\-tag\fP=[]
    73      add a \fB\fCtag\fR for the new snapshot (can be specified multiple times)
    74  
    75  .PP
    76  \fB\-\-time\fP=""
    77      time of the backup (ex. '2012\-11\-01 22:08:41') (default: now)
    78  
    79  
    80  .SH OPTIONS INHERITED FROM PARENT COMMANDS
    81  .PP
    82  \fB\-\-cacert\fP=[]
    83      path to load root certificates from (default: use system certificates)
    84  
    85  .PP
    86  \fB\-\-cache\-dir\fP=""
    87      set the cache directory
    88  
    89  .PP
    90  \fB\-\-json\fP[=false]
    91      set output mode to JSON for commands that support it
    92  
    93  .PP
    94  \fB\-\-limit\-download\fP=0
    95      limits downloads to a maximum rate in KiB/s. (default: unlimited)
    96  
    97  .PP
    98  \fB\-\-limit\-upload\fP=0
    99      limits uploads to a maximum rate in KiB/s. (default: unlimited)
   100  
   101  .PP
   102  \fB\-\-no\-cache\fP[=false]
   103      do not use a local cache
   104  
   105  .PP
   106  \fB\-\-no\-lock\fP[=false]
   107      do not lock the repo, this allows some operations on read\-only repos
   108  
   109  .PP
   110  \fB\-o\fP, \fB\-\-option\fP=[]
   111      set extended option (\fB\fCkey=value\fR, can be specified multiple times)
   112  
   113  .PP
   114  \fB\-p\fP, \fB\-\-password\-file\fP=""
   115      read the repository password from a file (default: $RESTIC\_PASSWORD\_FILE)
   116  
   117  .PP
   118  \fB\-q\fP, \fB\-\-quiet\fP[=false]
   119      do not output comprehensive progress report
   120  
   121  .PP
   122  \fB\-r\fP, \fB\-\-repo\fP=""
   123      repository to backup to or restore from (default: $RESTIC\_REPOSITORY)
   124  
   125  
   126  .SH SEE ALSO
   127  .PP
   128  \fBrestic(1)\fP