7.2.1 cat

Dump the contents of a file to standard output.

Syntax

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

Command Options

The options for the cat command are:

• file-name: Specifies the name of the file being output.

• --aio: Specifies the number of asynchronous I/O channels used to process the command. Asynchronous I/O enables the command to initiate I/O operations and continue executing other tasks without waiting (blocking) for the I/Os to complete. The default value is 4, which generally provides an optimal balance of performance and resource utilization.

• -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

• -T, --trace: Optionally enables tracing, with the trace level (trace-level) set to 1 (minimum tracing), 2 (medium tracing), or 3 (maximum tracing). If the trace level is not specified, then minimum tracing is enabled by default.

  The trace file is written to the first accessible location in the following list:

  1. If the $ADR_BASE environment variable is set:

     $ADR_BASE/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  2. /var/log/oracle/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  3. /tmp/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

Examples

Example 7-1 Dump the contents of an Exascale file

The following example dumps the contents of the file at @my-data/my-file to standard output.

$ xsh cat @my-data/my-file