The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

glacier ls - list vaults or archives

SYNOPSIS

glacier ls [-SUcdlhtr] [--cached] [--human-readable] [--sort=none|name|time|size] [--reverse] [--time-style=default|full-iso|long-iso|iso|locale|+FORMAT] [VAULT] [FILE...]

DESCRIPTION

Displays information about vaults and files.

Used without arguments, displays the list of existing vaults.

With one argument, lists files in the named vault, unless -d is also specified, in which case, lists information about this vault only.

With two or more arguments, lists files in VAULT with names matching FILE arguments. The latter can contain version numbers and globbing patterns. See glacier(1), section On file versioning, for the information about file versioning scheme.

OPTION

-S
--sort=size

Sort by file size, largest first.

-U
--sort=none

Don't sort names.

-c, --cached

Display cached inventory content.

-d, --directory

List just the names of vaults, rather than listing their contents. This is the default if no arguments are supplied.

-l

Print additional information. For vaults: total size, number of archives in vault, creation date, and the vault name. For files: file size, total number of stored versions, creation date, and the file name.

-t
--sort=time

Sort by modification time, newest first.

-h, --human-readable

Append a size letter to each size (K, M, or G). Powers of 1024 are used, so that M stands for 1,048,576 bytes.

--sort=KEY

Sort output according to KEY, which is one of: none, name, time, size. Default is name.

-r, --reverse

Reverse the sort order. E.g. with -t, list youngest files first.

--time-style=STYLE

List timestamps in style STYLE. The STYLE should be one of the following:

+FORMAT

List timestamps using FORMAT, which is interpreted as the format argument to strftime(3) function.

default

Default format. For timestamps not older than 6 month: month, day, hour and minute, e.g.: "May 23 15:00". For older timestamps: month, day, and year, e.g.: "May 23 2017".

full-iso

List timestamps in full using ISO 8601 date, time, and time zone format with nanosecond precision, e.g., "2017-05-23 15:53:10.633308971 +0000". This style is equivalent to "+%Y-%m-%d %H:%M:%S.%N %z".

long-iso

List ISO 8601 date and time in minutes, e.g., "2017-05-23 15:53". Equivalent to "+%Y-%m-%d %H:%M".

iso

GNU ls-compatible "iso": ISO 8601 dates for non-recent timestamps (e.g., "2017-05-23"), and ISO 8601 month, day, hour, and minute for recent timestamps (e.g., "03-30 23:45"). Timestamp is considered "recent", if it is not older than 6 months ago.

locale

List timestamps in a locale-dependent form. This is equivalent to +%c.

SEE ALSO

glacier(1), strftime(3).