---
name: "barman-list-files"
section: "1"
platform: "linux"
package: "barman-cli"
version: "3.13.3-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/barman-list-files"
---

# barman-list-files(1)

Barman Sub-Commands

## NAME

barman-list-files - Barman Sub-Commands

## SYNOPSIS

```
list-files
    [ { -h | --help } ]
    [ --target { data | full | standalone | wal } ]
    SERVER_NAME BACKUP_ID
```

## DESCRIPTION

List all files in a specific backup. You can use a shortcut instead of **BACKUP\_ID**.

## PARAMETERS

- **SERVER\_NAME**

  Name of the server in barman node

- **BACKUP\_ID**

  Id of the backup in barman catalog.

- **-h / --help**

  Show a help message and exit. Provides information about command usage.

- **--target**

  Define specific files to be listed. The possible values are:

  - •

    **standalone** (default): List the base backup files, including required WAL files.

  - •

    **data**: List just the data files.

  - •

    **wal**: List all the WAL files between the start of the base backup and the end of the log or the start of the following base backup (depending on whether the specified base backup is the most recent one available).

  - •

    **full**: same as **data** + **wal**.

## SHORTCUTS

Use shortcuts instead of **BACKUP\_ID**.

| | |
| --- | --- |
| **Shortcut** | **Description** |
| **first/oldest** | Oldest available backup for the server, in chronological order. |
| **last/latest** | Most recent available backup for the server, in chronological order. |
| **last-full/latest-full** | Most recent full backup taken with methods **rsync** or **postgres**. |
| **last-failed** | Most recent backup that failed, in chronological order. |

## AUTHOR

EnterpriseDB

## COPYRIGHT

© Copyright EnterpriseDB UK Limited 2011-2025