Child pages
  • The backups_list_user_files Script
For cPanel & WHM version 70

Skip to end of metadata
Go to start of metadata


The /usr/local/cpanel/scripts/backups_list_user_files script locates a user's backup files and returns all of the backup files in the Comma-Separated Value (CSV) format.

The /usr/local/cpanel/scripts/backups_list_user_files script

To query and return a list of backup files, run the following command as the root user:

/usr/local/cpanel/scripts/backups_list_user_files [arguments]


The /usr/local/cpanel/scripts/backups_list_user_files script accepts the following arguments:



Input valuesExample
--user=[username]The user whose backup files you wish to query.The cPanel account's username.--user=username

Returns the regular expression search results.


This argument only accepts one search value.

A valid string.



For example, the following command uses the --regexp argument to return results for the username user that match the example value:

/usr/local/cpanel/scripts/backups_list_user_files --user=username --regexp='example' |tail -n 8

The system will return the following output:

"Thu Jan  1 00:00:00 1970",0,incremental,"/nvdata","/backup/weekly/2018-03-26/accounts/username/homedir/nvdata",DIR
"Tue Feb 23 21:15:00 2016",183,incremental,"/nvdata.cache","/backup/weekly/2018-03-26/accounts/username/homedir/nvdata.cache",FILE
"Tue Feb 23 21:15:00 2016",31,incremental,"/nvdata/icFAA","/backup/weekly/2018-03-26/accounts/username/homedir/nvdata/icFAA",FILE
"Mon Aug  7 21:02:00 2017",59,incremental,"/nvdata/optionselect_filemanager","/backup/weekly/2018-03-26/accounts/username/homedir/nvdata/optionselect_filemanager",FILE
"Thu Jan  1 00:00:00 1970",0,incremental,"/nvdata","/backup/weekly/2018-04-02/accounts/username/homedir/nvdata",DIR
"Tue Feb 23 21:15:00 2016",183,incremental,"/nvdata.cache","/backup/weekly/2018-04-02/accounts/username/homedir/nvdata.cache",FILE
"Tue Feb 23 21:15:00 2016",31,incremental,"/nvdata/icFAA","/backup/weekly/2018-04-02/accounts/username/homedir/nvdata/icFAA",FILE
"Mon Aug  7 21:02:00 2017",59,incremental,"/nvdata/optionselect_filemanager","/backup/weekly/2018-04-02/accounts/username/homedir/nvdata/optionselect_filemanager",FILE

Backup file details

The following image displays an example backup file return in CSV format.

File creation date, in UTCThe file's creation date in Universal Time Coordinated (UTC).
File sizeThe backup file's size, in bytes.
The backup format type

One of these backup format types:

  • compressed — A compressed tar file.
  • uncompressed — An uncompressed tar file.
  • incremental — A full tree of files and directories.

The matching filename from the backup

The file's path, relative to the /home/username directory.
The file's archive or full pathFor compressed and uncompressed backups, the archive path in which the file resides. For incremental backups, the full path to the file.
The backup file's type

One of these backup file types:

  • FILE — A file.
  • DIR — A directory.
  • SYMLINK — A symlink.

Additional documentation