mirror of
https://github.com/borgbackup/borg.git
synced 2026-09-01 14:13:19 +02:00
94 lines
2.6 KiB
Groff
94 lines
2.6 KiB
Groff
.\" Man page generated from reStructuredText
|
|
.\" by the Docutils 0.22.4 manpage writer.
|
|
.
|
|
.
|
|
.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
|
|
..
|
|
.TH "borg-benchmark-cpu" "1" "2026-08-29" "" "borg backup tool"
|
|
.SH Name
|
|
borg-benchmark-cpu \- Benchmark CPU-bound operations.
|
|
.SH SYNOPSIS
|
|
.sp
|
|
borg [common options] benchmark cpu [options]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
This command benchmarks miscellaneous CPU\-bound Borg operations.
|
|
.sp
|
|
It creates input data in memory, runs the operation and then displays throughput.
|
|
To reduce outside influence on the timings, please make sure to run this with:
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
an otherwise as idle as possible machine
|
|
.IP \(bu 2
|
|
enough free memory so there will be no slow down due to paging activity
|
|
.UNINDENT
|
|
.sp
|
|
By default all benchmarks run. Give one or more of \-\-chunking, \-\-hashing,
|
|
\-\-encrypting, \-\-compressing, \-\-msgpacking to run only those.
|
|
.sp
|
|
Some algorithms use multiple threads only above a size threshold, so the
|
|
hashes and the compressors are measured at more than one buffer size: the
|
|
hashes at 64MiB (roughly pack\-sized) and 2MiB (a typical borg chunk), both above
|
|
blake3\(aqs threshold, the compressors at 2MiB and 128kiB, which is below
|
|
zstd\(aqs. Within a section every row processes the same total number of
|
|
bytes \- 1 GiB, or 10 MiB for the compressors \- so the throughput column is
|
|
comparable between rows.
|
|
.sp
|
|
The compressors work on synthetic text\-like data that compresses about 4x
|
|
at zstd,3. Random data would be the worst possible input: no codec can
|
|
compress it, so all of them would take their incompressible fast path and
|
|
the levels would barely differ.
|
|
.SH OPTIONS
|
|
.sp
|
|
See \fIborg\-common(1)\fP for common options of Borg commands.
|
|
.SS options
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-json
|
|
format output as JSON
|
|
.TP
|
|
.B \-\-chunking
|
|
benchmark the chunkers
|
|
.TP
|
|
.B \-\-hashing
|
|
benchmark the hashes / MACs
|
|
.TP
|
|
.B \-\-encrypting
|
|
benchmark the encryption modes
|
|
.TP
|
|
.B \-\-compressing
|
|
benchmark the compressors
|
|
.TP
|
|
.B \-\-msgpacking
|
|
benchmark msgpack item packing
|
|
.UNINDENT
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fIborg\-common(1)\fP
|
|
.SH Author
|
|
The Borg Collective
|
|
.\" End of generated man page.
|