7.2.6 ls

List file/directory details.

Syntax

ls [ -h ] [ -l ] [ -r ] [ -t ] [ -a ] [ -1 ] [ -s ] [ -d | --detail ] 
   [{ -w | --wallet } wallet-location ] [ -D | --debug ] 
   [ 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 of the 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: Specifies the path to the Exascale wallet directory.

• -D, --debug: Enables debug mode.

Examples

Example 7-8 List the contents of an Exascale vault

The following example lists the files contained in the @MYDATA vault.

$ xsh ls @MYDATA