MYSQL-ZRM-LIST(1)

✨ MYSQL-ZRM-LIST(1) ✨

okay bestie, so mysql-zrm-list(1) is the little icon you run when you wanna know what backups even exist on this box. it's giving "show me the receipts" energy and honestly? we love her for it. 🎀

---

🌸 NAME 🌸

mysql-zrm-list — the utility that lists backups performed by ZRM for MySQL. that's it, that's the job, and she does it flawlessly. 💅

---

🦋 SYNOPSIS 🦋

mysql-zrm-list
                [--source-directory dir_name]
                [--backup-set name]
                [--index|--noindex]
                [--till-lastfull | --all-backups]
                [--options-file conf_file]
                [--tmpdir temp_directory]
                [--quiet|--no-quiet]
                [--verbose]
                [--help]

---

💖 DESCRIPTION 💖

so this utility is here to display the backup level, the name of the directory containing the backup, and the index of the last backup of the backup set you specified. three little facts, one slay little command. ✨

wanna see everything? use the --all-backups option and she'll list all available backup information. or if you're feeling a lil more selective, specify --till-lastfull to only list backup information since the last full backup. pick your fighter, both are valid. 💫

and here's the tea: use --index to display the index of that backup. use --noindex and she displays only the level of backup and the name of the directory containing the backup. that's it. no notes. 🙈

please please please go see the ZRM for MySQL documentation at http://mysql-backup.zmanda.com/ for details on how to configure and use ZRM for MySQL. it's the source of truth, iykyk. 🫶

---

👑 OPTIONS 👑

• --backup-set name — specify the backup-set for the backup run. the default value is BackupSet1, because of course it is.
• --source-directory dir_name — choose the directory containing a backup. point her at the goods. 📁
• --index|--noindex — choose whether to include index contents in the list. the default is --index. so if you don't say anything, you get the index, no cap.
• --all-backups | --till-lastfull — choose whether to list information for all available backups, or limit the listing to the .

ngl bestie, the original manpage literally stops right there at "the ." — that's not me being lazy, that's the text. i'm keeping it real and keeping it exact. 💀

• --options-file conf_file — set the file, along with the full pathname, that contains ZRM for MySQL command options, in the same format as in mysql-zrm.conf(5). yes, same format, she's consistent like that.
• --tmpdir temp_directory — full path of the directory for storing temporary files and directories on the backup host. the default is to use the system-specified temporary directory on the backup host, e.g. /tmp.
• --quiet|--no-quiet — choose quiet to suppress display of log messages on stdout. choose no-quiet to display the log messages to standard output (stdout). the default is --no-quiet, so she's chatty by default, main character energy fr fr. 🗣️
• --verbose — provide more detailed output in the log. verbose output is turned off by default.
• --help — displays the help message and exits. ⚠️ this command line only parameter cannot be specified in the configuration file. rules are rules.

---

🌈 FILES 🌈

• /var/lib/mysql-zrm — directory under which all backup data is stored. the whole stash lives here. 💜
• /etc/mysql-zrm/backup set name/mysql-zrm.conf — default location for the backup-set configuration file used by ZRM for MySQL.

---

⭐ RETURN VALUES ⭐

on success, zero is returned. on error, a non-zero value is returned. that's the vibe check: 0 = good, not-0 = something's up, go look. 😭

---

🔥 SEE ALSO 🔥

mysql-zrm(1), mysql-zrm-backup(1), mysql-zrm-manage-backup(1), mysql-zrm-restore(1), mysql-zrm-check(1), mysql-zrm-getconf(1), mysql-zrm-setconf(1), mysql-zrm-parse-binlogs(1), mysql-zrm-purge(1), mysql-zrm-extract-backup(1), mysql-zrm-verify-backup(1), mysql-zrm-abort-backup(1), mysql-zrm-scheduler(1), mysql-zrm-reporter(1), mysql-zrm.conf(5), mysqldump(1), mysqlbinlog(1), mysql(1), lvm(8), Zmanda Recovery Manager for MySQL (http://mysql-backup.zmanda.com/)

the whole friend group, all iconic, all worth a read. 🌸

---

🧚 AUTHOR 🧚

Zmanda Inc. (http://www.zmanda.com)

---

and that's the whole page, bestie!! brought to you by Zmanda, Inc., for ZRM for MySQL, and this gorgeous lil manual page is mysql-zrm-list(1). go forth and list those backups, you absolute legend. 🫶✨🍓