Commands‎ > ‎

Ls

Lists contents of a backup.

  $ hb ls [-c backupdir] [-l] [-v] [-r version] [-1]
         [-a] [-d] [pattern]
         
Without options, the ls command lists all files in the most recent version.

The -l (el) option gives a detailed listing similar to ls -l, including the file modification time, backup time, and version number.  See the example below for details.

The -v option must be used with -l, and shows even more detail.  See the example below.

The -r option selects a specific version to display and 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 -1 (one) 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 -d option.

A file selection pattern will display only matching files.  Matches are found using Unix "glob" rules: * wildcards (match anything) and ? wildcards (match one character) can be used, but must be quoted with single quotes on the command line.  Or, a complete or partial pathname may be used without wildcards.  If the pathname begins with a slash, ls assumes that you want the pathname beginning at the root.  If you're not sure where a pathname is located, omit the leading slash.

Directories are only listed 1 level deep by default.  If you want to list all files under a directory, similar to the Unix find command, add /* (in single quotes!) to the end of the pattern.

EXAMPLES

$ hb ls -c hb -l
HashBackup build #1666 Copyright 2009-2016 HashBackup, LLC
Backup directory: /hb
Most recent backup version: 0
Showing most recent version
   0 drwxrwxr-t   44    0   80     1564 2016-10-12 00:30:04 2016-10-12 13:27:46 /  (parent, partial)

The fields are:
- version number
- Unix permissions
- number of links
- user id
- group id
- file size
- date modified (mtime)
- date backed up
- path name
- HashBackup notes

$ hb ls -c hb -lv
HashBackup build #1666 Copyright 2009-2016 HashBackup, LLC
Backup directory: /hb
Most recent backup version: 0
Showing most recent version
   0 drwxrwxr-t   44    0   80     1564 2016-10-12 00:30:04 2016-10-12 13:27:46 /  (parent, partial)
            2 2016-10-12 00:30:04          1
...
   0 -rw-r--r--    1  501   20      511 2016-10-12 13:27:39 2016-10-12 13:27:46 /hb/inex.conf
      5700934 2016-10-12 13:27:39          6                              [dc4094a430afa32b82247a118b23e56c64ee095a]

The fields are the same for the first line, then:
- inode number
- inode change time (ctime)
- HashBackup file id
- file hash
Comments