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
-s
option 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-l
option. -
-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_BASE
environment variable is set, the trace file is written to:$ADR_BASE/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trc
Otherwise, 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 ls
Example 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