---
name: "borg-common"
section: "1"
platform: "linux"
package: "borg"
version: "1.4.5-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/borg-common"
---

# borg-common(1)

Common options of Borg commands

## Name

borg-common - Common options of Borg commands

## SYNOPSIS

- **-h, --help**

  show this help message and exit

- **--critical**

  work on log level CRITICAL

- **--error**

  work on log level ERROR

- **--warning**

  work on log level WARNING (default)

- **--info, -v, --verbose**

  work on log level INFO

- **--debug**

  enable debug output, work on log level DEBUG

- **--debug-topic** *TOPIC*

  enable TOPIC debugging (can be specified multiple times). The logger path is borg.debug.\<TOPIC\> if TOPIC is not fully qualified.

- **-p, --progress**

  show progress information

- **--iec**

  format using IEC units (1KiB = 1024B)

- **--log-json**

  Output one JSON object per log line instead of formatted text.

- **--lock-wait** *SECONDS*

  wait at most SECONDS for acquiring a repository/cache lock (default: 1).

- **--bypass-lock**

  Bypass locking mechanism

- **--show-version**

  show/log the borg version

- **--show-rc**

  show/log the return code (rc)

- **--umask** *M*

  set umask to M (local only, default: 0077)

- **--remote-path** *PATH*

  use PATH as borg executable on the remote (default: "borg")

- **--remote-ratelimit** *RATE*

  deprecated, use **--upload-ratelimit** instead

- **--upload-ratelimit** *RATE*

  set network upload rate limit in kiByte/s (default: 0=unlimited)

- **--remote-buffer** *UPLOAD\_BUFFER*

  deprecated, use **--upload-buffer** instead

- **--upload-buffer** *UPLOAD\_BUFFER*

  set network upload buffer size in MiB. (default: 0=no buffer)

- **--consider-part-files**

  treat part files like normal files (e.g. to list/extract them)

- **--debug-profile** *FILE*

  Write execution profile in Borg format into FILE. For local use a Python-compatible file can be generated by suffixing FILE with ".pyprof".

- **--rsh** *RSH*

  Use this command to connect to the 'borg serve' process (default: 'ssh')

## SEE ALSO

*[borg-common(1)](/borg-common/1.md)*

## Author

The Borg Collective