github.com/advanderveer/restic@v0.8.1-0.20171209104529-42a8c19aaea6/doc/man/restic-forget.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\-forget \- Remove snapshots from the repository
     9  
    10  
    11  .SH SYNOPSIS
    12  .PP
    13  \fBrestic forget [flags] [snapshot ID] [...]\fP
    14  
    15  
    16  .SH DESCRIPTION
    17  .PP
    18  The "forget" command removes snapshots according to a policy. Please note that
    19  this command really only deletes the snapshot object in the repository, which
    20  is a reference to data stored there. In order to remove this (now unreferenced)
    21  data after 'forget' was run successfully, see the 'prune' command.
    22  
    23  
    24  .SH OPTIONS
    25  .PP
    26  \fB\-l\fP, \fB\-\-keep\-last\fP=0
    27      keep the last \fB\fCn\fR snapshots
    28  
    29  .PP
    30  \fB\-H\fP, \fB\-\-keep\-hourly\fP=0
    31      keep the last \fB\fCn\fR hourly snapshots
    32  
    33  .PP
    34  \fB\-d\fP, \fB\-\-keep\-daily\fP=0
    35      keep the last \fB\fCn\fR daily snapshots
    36  
    37  .PP
    38  \fB\-w\fP, \fB\-\-keep\-weekly\fP=0
    39      keep the last \fB\fCn\fR weekly snapshots
    40  
    41  .PP
    42  \fB\-m\fP, \fB\-\-keep\-monthly\fP=0
    43      keep the last \fB\fCn\fR monthly snapshots
    44  
    45  .PP
    46  \fB\-y\fP, \fB\-\-keep\-yearly\fP=0
    47      keep the last \fB\fCn\fR yearly snapshots
    48  
    49  .PP
    50  \fB\-\-keep\-tag\fP=[]
    51      keep snapshots with this \fB\fCtaglist\fR (can be specified multiple times)
    52  
    53  .PP
    54  \fB\-\-host\fP=""
    55      only consider snapshots with the given \fB\fChost\fR
    56  
    57  .PP
    58  \fB\-\-hostname\fP=""
    59      only consider snapshots with the given \fB\fChostname\fR (deprecated)
    60  
    61  .PP
    62  \fB\-\-tag\fP=[]
    63      only consider snapshots which include this \fB\fCtaglist\fR in the format \fB\fCtag[,tag,...]\fR (can be specified multiple times)
    64  
    65  .PP
    66  \fB\-\-path\fP=[]
    67      only consider snapshots which include this (absolute) \fB\fCpath\fR (can be specified multiple times)
    68  
    69  .PP
    70  \fB\-c\fP, \fB\-\-compact\fP[=false]
    71      use compact format
    72  
    73  .PP
    74  \fB\-g\fP, \fB\-\-group\-by\fP="host,paths"
    75      string for grouping snapshots by host,paths,tags
    76  
    77  .PP
    78  \fB\-n\fP, \fB\-\-dry\-run\fP[=false]
    79      do not delete anything, just print what would be done
    80  
    81  .PP
    82  \fB\-\-prune\fP[=false]
    83      automatically run the 'prune' command if snapshots have been removed
    84  
    85  .PP
    86  \fB\-h\fP, \fB\-\-help\fP[=false]
    87      help for forget
    88  
    89  
    90  .SH OPTIONS INHERITED FROM PARENT COMMANDS
    91  .PP
    92  \fB\-\-cacert\fP=[]
    93      path to load root certificates from (default: use system certificates)
    94  
    95  .PP
    96  \fB\-\-cache\-dir\fP=""
    97      set the cache directory
    98  
    99  .PP
   100  \fB\-\-json\fP[=false]
   101      set output mode to JSON for commands that support it
   102  
   103  .PP
   104  \fB\-\-limit\-download\fP=0
   105      limits downloads to a maximum rate in KiB/s. (default: unlimited)
   106  
   107  .PP
   108  \fB\-\-limit\-upload\fP=0
   109      limits uploads to a maximum rate in KiB/s. (default: unlimited)
   110  
   111  .PP
   112  \fB\-\-no\-cache\fP[=false]
   113      do not use a local cache
   114  
   115  .PP
   116  \fB\-\-no\-lock\fP[=false]
   117      do not lock the repo, this allows some operations on read\-only repos
   118  
   119  .PP
   120  \fB\-o\fP, \fB\-\-option\fP=[]
   121      set extended option (\fB\fCkey=value\fR, can be specified multiple times)
   122  
   123  .PP
   124  \fB\-p\fP, \fB\-\-password\-file\fP=""
   125      read the repository password from a file (default: $RESTIC\_PASSWORD\_FILE)
   126  
   127  .PP
   128  \fB\-q\fP, \fB\-\-quiet\fP[=false]
   129      do not output comprehensive progress report
   130  
   131  .PP
   132  \fB\-r\fP, \fB\-\-repo\fP=""
   133      repository to backup to or restore from (default: $RESTIC\_REPOSITORY)
   134  
   135  
   136  .SH SEE ALSO
   137  .PP
   138  \fBrestic(1)\fP