pvpath(8)

NAME

pvpath - change or query path attributes of a physical
multipathed volume

SYNOPSIS

pvpath -h
pvpath [-d] [-v] [-c] -qa
pvpath [-d] [-v] [-q [-c] ] [-p<#>  [-e  {y|n}]  [-w  <#>]
       ...]  <physical volume>

DESCRIPTION

pvpath allows to change the state of defined paths and the
way these paths are used for load balancing.

OPTIONS

-a, --all

This option is only valid for queries. If given the
query will print information for all multipathed
physical volumes.

-c, --columns

Changes the output of the query into something less
readable by humans but better parseable by scripts.

-d, --debug

Enables additional debugging output (if compiled
with DEBUG).

-h, --help

Print a usage message on standard output and exit
successfully.

-e, --enable {y|n}

Enables or disables the current path.

-p, --path <number of path [0...15]>

Selects the current path. Options that change a
path apply to the current path only.

-q, --query

Enables informational output about the physical
volumes. If this option is used together with
options that change the path(s) the output reflects
the state after the changes took place.

-v, --verbose

Gives verbose runtime information about pvchange's
activities.

-w, --weight <weight [0...255]>

Sets the weight of the current path. Load balancing
is done only over paths that have the same weight.
Paths with higher weight are used only if there are
no paths with a lower weight left.

< physical volume >

The physical volume may be provided in the follow
ing forms:

1. as the fully qualified nodename of the primary
path (e.g. /dev/sda1)

2. as a pair of volume group name and physical vol
ume number (eg. vg01 1). Volume group numbers are
in the range 1...255.

Example

"pvpath -p1 -en /dev/sda1" disables path number 1 of the
given physical volume.

"pvpath -q vg01 1" queries the state of all paths of the
first physical volume of the volume group named "vg01"

DIAGNOSTICS

pvpath returns an exit code of 0 for success and > 0 for
error:

1 no physical volume name(s) on command line
2 no physical volume names found
3 error changing physical volume in kernel
4 error writing physical volume

95 driver/module not in kernel
96 invalid I/O protocol version
97 error locking logical volume manager
98 invalid lvmtab (run vgscan(8))
99 invalid command line

See also

lvm(8)

AUTHOR

Stefan Bader <Stefan.Bader@de.ibm.com>

Stefan Bader LVM TOOLS PVPATH(8)