Scroll to navigation

dmmp_path_status_get(3) Device Mapper Multipath API - libdmmp Manual dmmp_path_status_get(3)

NAME

dmmp_path_status_get - Retrieve the path status.

SYNOPSIS

uint32_t dmmp_path_status_get (struct dmmp_path *dmmp_p);

ARGUMENTS

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

DESCRIPTION

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.

dmmp_path_status_get March 2018