7.2.7 ls
List file/directory details.
Syntax
ls [ -h ] [ -l ] [ -r ] [ -t ] [ -a ] [ -1 ] [ -s ] [ -d | --detail ]
[{ -w | --wallet } wallet-location ] [{ -T | --trace } trace-level ]
[ name ]Command Options
The options for the ls command are:
-
name: Specifies the file or vault that is the subject of the command.
If no name is specified, the command lists all accessible vaults. If the name is a specific file, the command lists details for the specified file.
If the specified name is a vault name and the
-soption is not specified, the command lists all of the files in the vault.A wildcard (
%) is permitted when specifying either a vault name or file name. -
-h: Displays output values in a human readable format (for example,10M,22K,300G, and so on). This options is used in conjunction with the-loption. -
-l: Displays a longer listing including file size and creation date. -
-r: Reverses the sort order. -
-t: Sort by creation time instead of alphabetically. -
-a: Displays hidden/special entries. -
-1: List one entry on each line of output. -
-s: Displays vault statistics instead of the vault contents.This option applies only when the name value specifies a vault name. The option is ignored when the name value specifies a file name.
-
-d,--detail: Displays a detailed listing of attributes. -
-w,--wallet: Optionally specifies the path to the Exascale wallet directory. -
-T,--trace: Optionally enables tracing and sets the trace level to1(minimum tracing),2(medium tracing), or3(maximum tracing).If the
$ADR_BASEenvironment variable is set, the trace file is written to:$ADR_BASE/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trcOtherwise, the trace file is written to:
/tmp/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trc
Examples
Example 7-10 List all Exascale vaults
The following example lists all vaults visible to the Exascale user associated with the XSH command invocation.
$ xsh lsExample 7-11 List the contents of an Exascale vault
The following example lists the files contained in the
@MYDATA vault.
$ xsh ls @MYDATA
Parent topic: XSH Command Reference