2024-09-07 20:31:48 +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-09-08 15:52:10 +00:00
|
|
|
.TH "BORG-REPO-SPACE" 1 "2024-09-08" "" "borg backup tool"
|
2024-09-07 20:31:48 +00:00
|
|
|
.SH NAME
|
2024-09-08 15:52:10 +00:00
|
|
|
borg-repo-space \- Manage reserved space in repository
|
2024-09-07 20:31:48 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.sp
|
2024-09-08 15:52:10 +00:00
|
|
|
borg [common options] repo\-space [options]
|
2024-09-07 20:31:48 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.sp
|
|
|
|
|
This command manages reserved space in a repository.
|
|
|
|
|
.sp
|
|
|
|
|
Borg can not work in disk\-full conditions (can not lock a repo and thus can
|
|
|
|
|
not run prune/delete or compact operations to free disk space).
|
|
|
|
|
.sp
|
|
|
|
|
To avoid running into dead\-end situations like that, you can put some objects
|
|
|
|
|
into a repository that take up some disk space. If you ever run into a
|
|
|
|
|
disk\-full situation, you can free that space and then borg will be able to
|
|
|
|
|
run normally, so you can free more disk space by using prune/delete/compact.
|
|
|
|
|
After that, don\(aqt forget to reserve space again, in case you run into that
|
|
|
|
|
situation again at a later time.
|
|
|
|
|
.sp
|
|
|
|
|
Examples:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
# Create a new repository:
|
2024-09-08 15:52:10 +00:00
|
|
|
$ borg repo\-create ...
|
2024-09-07 20:31:48 +00:00
|
|
|
# Reserve approx. 1GB of space for emergencies:
|
2024-09-08 15:52:10 +00:00
|
|
|
$ borg repo\-space \-\-reserve 1G
|
2024-09-07 20:31:48 +00:00
|
|
|
|
|
|
|
|
# Check amount of reserved space in the repository:
|
2024-09-08 15:52:10 +00:00
|
|
|
$ borg repo\-space
|
2024-09-07 20:31:48 +00:00
|
|
|
|
|
|
|
|
# EMERGENCY! Free all reserved space to get things back to normal:
|
2024-09-08 15:52:10 +00:00
|
|
|
$ borg repo\-space \-\-free
|
2024-09-07 20:31:48 +00:00
|
|
|
$ borg prune ...
|
|
|
|
|
$ borg delete ...
|
|
|
|
|
$ borg compact \-v # only this actually frees space of deleted archives
|
2024-09-08 15:52:10 +00:00
|
|
|
$ borg repo\-space \-\-reserve 1G # reserve space again for next time
|
2024-09-07 20:31:48 +00:00
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Reserved space is always rounded up to use full reservation blocks of 64MiB.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.sp
|
|
|
|
|
See \fIborg\-common(1)\fP for common options of Borg commands.
|
|
|
|
|
.SS optional arguments
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.BI \-\-reserve \ SPACE
|
|
|
|
|
Amount of space to reserve (e.g. 100M, 1G). Default: 0.
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-free
|
|
|
|
|
Free all reserved space. Don\(aqt forget to reserve space later again.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.sp
|
|
|
|
|
\fIborg\-common(1)\fP
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
The Borg Collective
|
|
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
|
.
|
