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 to 1 (minimum tracing), 2 (medium tracing), or 3 (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