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