dmmp_path_status_get(3)

dmmp_path_status_get3

Retrieve the path status.

Usage

uint32_t dmmp_path_status_get (struct dmmp_path *dmmp_p);

Arguments

dmmp_p

Pointer of 'struct dmmp_path'. If this pointer is NULL, your program will be terminated by assert.

Overview

The valid path statuses are:

* DMMP_PATH_STATUS_UNKNOWN

* DMMP_PATH_STATUS_DOWN

Path is down and you shouldn't try to send commands to it.

* DMMP_PATH_STATUS_UP

Path is up and I/O can be sent to it.

* DMMP_PATH_STATUS_SHAKY

Only emc_clariion checker when path not available for "normal" operations.

* DMMP_PATH_STATUS_GHOST

Only hp_sw and rdac checkers. Indicates a "passive/standby" path on active/passive HP arrays. These paths will return valid answers to certain SCSI commands (tur, read_capacity, inquiry, start_stop), but will fail I/O commands. The path needs an initialization command to be sent to it in order for I/Os to succeed.

* DMMP_PATH_STATUS_PENDING

Available for all async checkers when a check IO is in flight.

* DMMP_PATH_STATUS_TIMEOUT

Only tur checker when command timed out.

* DMMP_PATH_STATUS_DELAYED

If a path fails after being up for less than delay_watch_checks checks, when it comes back up again, it will not be marked as up until it has been up for delay_wait_checks checks. During this time, it is marked as "delayed".

Return

uint32_t.

Releases

4 releases since Debian 10 (Buster); the text changed 3 times.

  1. 10
  2. 11
  3. 12
  4. Arch

From multipath-tools 0.15.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.