7.2.12 lsblk

List volume details.

Syntax

lsblk [ -h ] [ -c cluster-ID ]
      [[ -a | --all ] [ -d | --detail ] | [ -1 | --long ]] 
      [ -p | --probe ] [ -1 ]
      [ volume-name ]...
      [{ -w | --wallet } wallet-location ] 
      [{ -T | --trace } trace-level ]
      [{ -j | --json } [ -n | --noopen] [ --compact ]]

Command Options

The options for the lsblk command are:

  • volume-name: Specifies the volume that is the subject of the command.

    If no volume-name is specified, the command lists all accessible volumes.

    A wildcard (%) is permitted when specifying a volume name.

  • -h: Displays output values in a human readable format (for example, 10M, 22K, 300G, and so on).

  • -c: Display volume information associated with the specified Exascale cluster ID.

  • -a, --all: Displays hidden/special entries.

  • -d, --detail: Displays a detailed listing of attributes.

  • -l, --long: Displays a longer listing in tabular form.

  • -p, --probe: Displays volume state output.

  • -1: List one entry on each line of output.

  • -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

  • -j, --json: Displays the output in JSON format.

  • -n, --noopen: Returns major, minor, device path, and cluster ID without opening the underlying devices. Only applicable with JSON output and in conjunction with the -c option.

  • --compact: Displays JSON formatted output in a compact format, without white space and line breaks.

Examples

Example 7-23 List all Exascale volumes

The following example lists all volumes visible to the Exascale user associated with the XSH command invocation. 

$ xsh lsblk

Example 7-24 List details about an Exascale volume

The following example displays detailed information about the vol1 volume in JSON format. 

$ xsh lsblk -d -j vol1

Parent topic: XSH Command Reference