7.2.1 cat

Dump the contents of a file to standard output.

Syntax

cat [{ -w | --wallet } wallet-location ]
    [{ -T | --trace } trace-level ]
    [ --aio=naio ] filename

Command Options

The options for the cat command are:

  • filename: Specifies the file being output.

  • -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
  • --aio: Optionally specifies the number of async I/Os to use. The default value is 4.

Examples

Example 7-1 Dump the contents of an Exascale file

The following example dumps the contents of the file at @MYDATA/myfile to standard output.

$ xsh cat @MYDATA/myfile