BARMAN-LIST-FILES(1)

📦
version 3.20.1 · 7 versions
, in epel 10, fedora 43, fedora 44

💖 barman-list-files — the manual page, but make it a group chat 💖

okay so bestie, welcome to barman-list-files 💅 this is a Barman sub-command and it's literally here to show you every single file inside a specific backup. yes, every file. and if you don't feel like typing out a whole BACKUP_ID, you can use a shortcut instead — iconic behaviour, honestly. 🎀

✨ SYNOPSIS ✨

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

🌸 DESCRIPTION 🌸

So what does it do? It lists all the files in a specific backup. That's it, that's the job. 🫶

And the bestie-coded part: you can use a shortcut instead of BACKUP_ID (more on that in a sec, keep reading 💖).

🦋 PARAMETERS 🦋

  • SERVER_NAME — the name of the server in the barman node. yep, that one. ✨
  • BACKUP_ID — the id of the backup in the barman catalog. (or a shortcut, because we're lazy in a cute way 🎀)
  • -h / --help — shows you a help message and dips out. gives you the info about how to use the command. no cap, super useful when you forget everything. 💀
  • --target — this one decides which specific files get listed. the possible values are:
    • standalone (this is the default, bestie 💅) — lists the base backup files, including the required WAL files.
    • data — lists just the data files.
    • wal — lists 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. (iykyk 🌈)
    • full — same as data + wal. the whole combo meal. 🍓
  • --list-empty-directories — adds empty directories to the listing. they deserve representation too. 🙈

👑 SHORTCUTS 👑

Use shortcuts instead of BACKUP_ID — saves your fingers, saves your vibe check:

  • first / oldest — the oldest available backup for the server, in chronological order. the grandparent of backups. 🌸
  • last / latest — the most recent available backup for the server, in chronological order. main character energy. ⭐
  • last-full / latest-full — the most recent full backup taken with methods rsync or postgres.
  • last-failed — the most recent backup that failed, in chronological order. not me crying over this one 😭💀

💜 Author 💜

EnterpriseDB

© Copyright EnterpriseDB UK Limited 2011-2026

and that's the whole page, bestie!! this was Barman version 3.20, dated Sep 29, 2026 — go forth and list those files, you absolute legend 🔥👑✨

📦 where this page comes from