1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-01-03 13:45:31 +00:00
borg/docs/man/borg-delete.1

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

126 lines
3.3 KiB
Groff
Raw Normal View History

2017-02-05 13:22:06 +00:00
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
2024-10-31 19:50:06 +00:00
.TH "BORG-DELETE" 1 "2024-10-31" "" "borg backup tool"
2022-06-23 23:19:19 +00:00
.SH NAME
borg-delete \- Delete archives
2017-02-05 13:22:06 +00:00
.SH SYNOPSIS
.sp
2024-09-26 05:57:01 +00:00
borg [common options] delete [options] [NAME]
2017-02-05 13:22:06 +00:00
.SH DESCRIPTION
.sp
2022-06-23 23:19:19 +00:00
This command deletes archives from the repository.
2018-07-12 20:00:19 +00:00
.sp
Important: When deleting archives, repository disk space is \fBnot\fP freed until
you run \fBborg compact\fP\&.
.sp
2021-02-06 00:32:54 +00:00
When in doubt, use \fB\-\-dry\-run \-\-list\fP to see what would be deleted.
.sp
2022-10-02 13:51:17 +00:00
You can delete multiple archives by specifying a matching pattern,
using the \fB\-\-match\-archives PATTERN\fP option (for more info on these patterns,
2022-07-03 23:21:50 +00:00
see \fIborg_patterns\fP).
2017-02-05 13:22:06 +00:00
.SH OPTIONS
.sp
See \fIborg\-common(1)\fP for common options of Borg commands.
2024-09-26 05:57:01 +00:00
.SS arguments
.INDENT 0.0
.TP
.B NAME
specify the archive name
.UNINDENT
2024-07-19 18:40:15 +00:00
.SS optional arguments
2017-02-05 13:22:06 +00:00
.INDENT 0.0
.TP
2022-06-23 23:19:19 +00:00
.B \-n\fP,\fB \-\-dry\-run
2018-07-12 20:00:19 +00:00
do not change repository
.TP
2022-06-23 23:19:19 +00:00
.B \-\-list
2021-02-06 00:32:54 +00:00
output verbose list of archives
2017-02-05 13:22:06 +00:00
.UNINDENT
.SS Archive filters
2017-02-05 13:22:06 +00:00
.INDENT 0.0
.TP
2022-10-02 13:51:17 +00:00
.BI \-a \ PATTERN\fR,\fB \ \-\-match\-archives \ PATTERN
2024-10-03 10:23:03 +00:00
only consider archives matching all patterns. see \(dqborg help match\-archives\(dq.
2017-02-05 13:22:06 +00:00
.TP
.BI \-\-sort\-by \ KEYS
2024-10-03 10:23:03 +00:00
Comma\-separated list of sorting keys; valid keys are: timestamp, archive, name, id, tags, host, user; default is: timestamp
2017-02-05 13:22:06 +00:00
.TP
.BI \-\-first \ N
consider first N archives after other filters were applied
.TP
.BI \-\-last \ N
consider last N archives after other filters were applied
2023-02-26 20:30:54 +00:00
.TP
.BI \-\-oldest \ TIMESPAN
consider archives between the oldest archive\(aqs timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.
.TP
.BI \-\-newest \ TIMESPAN
consider archives between the newest archive\(aqs timestamp and (newest \- TIMESPAN), e.g. 7d or 12m.
.TP
.BI \-\-older \ TIMESPAN
2024-02-20 16:12:43 +00:00
consider archives older than (now \- TIMESPAN), e.g. 7d or 12m.
2023-02-26 20:30:54 +00:00
.TP
.BI \-\-newer \ TIMESPAN
consider archives newer than (now \- TIMESPAN), e.g. 7d or 12m.
2017-02-05 13:22:06 +00:00
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
2024-09-26 05:57:01 +00:00
# delete all backup archives named \(dqkenny\-files\(dq:
$ borg delete \-a kenny\-files
2018-07-12 20:00:19 +00:00
# actually free disk space:
2022-06-23 23:19:19 +00:00
$ borg compact
2018-07-12 20:00:19 +00:00
2024-09-26 05:57:01 +00:00
# delete a specific backup archive using its unique archive ID prefix
$ borg delete aid:d34db33f
2022-09-10 14:03:27 +00:00
# delete all archives whose names begin with the machine\(aqs hostname followed by \(dq\-\(dq
2023-06-11 21:10:23 +00:00
$ borg delete \-a \(aqsh:{hostname}\-*\(aq
2018-07-12 20:00:19 +00:00
2022-09-10 14:03:27 +00:00
# delete all archives whose names contain \(dq\-2012\-\(dq
2023-06-11 21:10:23 +00:00
$ borg delete \-a \(aqsh:*\-2012\-*\(aq
2018-07-12 20:00:19 +00:00
# see what would be deleted if delete was run without \-\-dry\-run
2023-06-11 21:10:23 +00:00
$ borg delete \-\-list \-\-dry\-run \-a \(aqsh:*\-May\-*\(aq
2017-02-05 13:22:06 +00:00
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
2024-09-08 15:52:10 +00:00
\fIborg\-common(1)\fP, \fIborg\-compact(1)\fP, \fIborg\-repo\-delete(1)\fP
2017-02-05 13:22:06 +00:00
.SH AUTHOR
The Borg Collective
.\" Generated by docutils manpage writer.
.