Commands‎ > ‎

Ls

Lists contents of a backup.

  $ hb ls [-c backupdir] [-l] [-r version] [--onerev]
         [-a] [--alldirs] [pattern1 pattern2 ...]
         
Without options, the ls command lists all files in the most recent version.

The -l option gives a detailed listing similar to ls -l, including the file modification time, backup time, and version number.

The -r option selects a specific version to display.  This will list files that are backed up at this version or an earlier version.  With -r1, some of the files may be from version 1 and some may be from version zero.  To display only the files backed up in version 1, add the --onerev option.

The -a option displays all versions of matching files.  For example, the file /etc/hosts might be backed up in versions 2 and 3.  Without -a, only the most recent version is listed.  With -a, all versions are listed.  A directory may be backed up in several versions, but even with -a, only the most recent version is displayed.  To see all versions of a directory, add the --alldirs option.

File selection strings (patterns) can be used to display only matching files.  Matches are found using a simple pathname match: pathnames that contain a pattern are listed.  * wildcards (match anything) and ? wildcards (match one character) can be used, but must be quoted with single quotes on the command line.

Comments