Skip to content

Command l (List file(s))

Franco Corbelli edited this page Sep 2, 2023 · 1 revision

Two operating mode
Slightly different from ZPAQ: the -not = voodoo is no more present

Examples Diff against 7.15

only one parameter (.zpaq) => list the content

zpaqfranz l z:\1.zpaq

optional folder(s) => compare .zpaq contents against files on disk

zpaqfranz l z:\1.zpaq c:\nz\
When used with optional folders, compare specified files and directories with the same files on disk (verify). For each file or directory, show the comparison result, last modified date, uncompressed size, Windows attributes or Unix/Linux permissions, and the saved name. If the internal and external versions of the file differ, then show both.
The comparison result is reported in the first column as = if the last-modified date, attributes (if saved), and size are identical, # if different, - if the external file does not exist, or + if the internal file does not exist. With -force, the contents are compared, but not the dates or attributes. Contents are compared by reading the files, computing SHA-1 hashes and comparing with the stored hashes. In either case, replacing list with add will show exactly what changes would be made to the archive.

Attribute

In Unix/Linux, permissions are listed as a file type d for directory or blank for a regular file, followed by a 4 digit octal number as per chmod(1). In Windows, attributes are as follows: Read-only, Hidden, System, unused (blank), Directory, Archive, device, normal File, Temporary, sparse file, reparse point, Compressed, offline, not content Iindexed, Encrypted, integrity stream, virtual, no scrub data.

Switches

-all [N]

List all saved versions and not just the latest version, including versions where the file is marked as deleted. Each version is shown in a separate numbered directory beginning with 0001|. Absolute paths are first converted to relative paths. In Windows, the : on the drive letter is removed. For example, foo and /foo are shown as 0001/foo. C:/foo and C:foo are shown as 0001|C/foo. The date shown on the root directory of each version is the date of the update. The root directory listing also shows the number of updates and deletions in that version and the compressed size. When a file is deleted, it is shown with the dates and attributes blank with size 0. N selects the number of digits in the directory name. The default is 4.

-n X -limit X

Sort by size desc, show first X results

-minsize X -maxsize X

Filter for minsize or maxsize (bytes)

-find foo

Filter (case insensitive) like |grep -i foo

-replace pluto

With -find pippo => replace pippo with pluto

-checksum

Show CRC-32/SHA-1/XXH3, if any

-summary

More compact output for CRC-32/hash

-key password

This option is required for all commands operating on an encrypted archive.

-not [file]...

Do not list files that match any file by name. file may contain wildcards * and ? that match any string or character respectively, including /. A match to a directory also matches all of its contents. In Windows, matches are not case sensitive, and \ matches /. In Unix/Linux, arguments with wildcards must be quoted to protect them from the shell.

-only file...

List any files unless they match at least one argument. The rules for matching wildcards are the same as -not. The default is * which matches everything. If a file matches an argument to both -only and -not, then -not takes precedence.

-until date | [-]version

List by version (even negative) or by date.

A date is specified as a 4 digit year (1900 to 2999), 2 digit month (01 to 12), 2 digit day (01 to 31), optional 2 digit hour (00 to 23, default 23), optional 2 digit minute (00 to 59, default 59), and optional 2 digit seconds (00 to 59, default 59). Dates and times are always universal time zone (UT), not local time. Numbers up to 9999999 are interpreted as version numbers rather than dates. Dates may contain spaces and punctuation characters for readability but are ignored.

-comment foo

List version foo, if possible

Clone this wiki locally