MPATHPERSIST(8)             System Manager's Manual            MPATHPERSIST(8)

<?><?><?> (NAME)
       mpathpersist - <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> SCSI <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> dm.

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       mpathpersist [OPTIONS] device

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> SCSI <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (Device Mapper Multipath)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> reservation_key
       <?><?><?><?> <?><?> <?><?><?><?> /etc/multipath.conf <?><?><?><?><?>
       <?><?><?> <?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> multipathd <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> mpathpersist <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       sg_persist <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> sg_persist (8) <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -verbose|-v level
              <?><?><?> <?><?><?><?><?><?> (Verbosity):

              0      <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (Critical).

              1      <?><?><?><?><?><?><?><?> <?><?><?> (Error).

              2      <?><?><?><?><?><?><?><?> <?><?><?><?><?> (Warning).

              3      <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
                     (Informational).

              4      <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?> (trace) <?><?><?><?>.

       --device=DEVICE|-d DEVICE
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> DEVICE.

       --batch-file=DEVICE|-f FILE
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> FILE. <?><?><?>
              "<?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (BATCH FILES)"
              <?><?> <?><?><?> <?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.

       --help|-h
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --hex|-H
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> (hex).

       --in|-i
              <?><?><?><?><?><?><?> <?><?><?><?><?> PR In.

       --out|-o
              <?><?><?><?><?><?><?> <?><?><?><?><?> PR Out.

       --param-alltgpt|-Y
              <?><?><?><?><?><?><?> PR Out <?><?> <?><?><?><?><?> 'ALL_TG_PT'.

       --param-aptpl|-Z
              <?><?><?><?><?><?><?> PR Out <?><?> <?><?><?><?><?> 'APTPL'.

       --read-keys|-k
              <?><?><?><?><?> PR In: <?><?><?><?><?><?> <?><?><?><?><?><?>
              (Read Keys).

       --param-rk=RK|-K RK
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> PR Out
              (<?><?><?><?><?> RK <?><?> <?><?><?><?><?> <?><?> <?>
              <?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?>).

       --param-sark=SARK|-S SARK
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> PR Out (<?><?><?><?><?> SARK <?><?>
              <?><?><?><?><?> <?><?> <?><?><?>).

       --preempt|-P
              <?><?><?><?><?> PR Out: <?><?><?> <?><?> <?><?><?><?> (Preempt).

       --clear|-C
              <?><?><?><?><?> PR Out: <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> (Clear registrations).

       --preempt-abort|-A
              <?><?><?><?><?> PR Out: <?><?><?> <?><?> <?><?><?><?> <?>
              <?><?><?> (Preempt and Abort).

       --prout-type=TYPE|-T TYPE
              <?><?><?> <?><?><?><?><?> PR Out.

       --read-full-status|-s
              <?><?><?><?><?> PR In: <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> (Read Full Status).

       --read-keys|-k
              <?><?><?><?><?> PR In: <?><?><?><?><?><?> <?><?><?><?><?><?>
              (Read Keys).

       --read-reservation|-r
              <?><?><?><?><?> PR In: <?><?><?><?><?><?> <?><?><?><?> (Read
              Reservation).

       --register|-G
              <?><?><?><?><?> PR Out: <?><?><?><?><?><?><?> (Register).

       --register-ignore|-I
              <?><?><?><?><?> PR Out: <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?> (Register and Ignore).

       --release|-L
              <?><?><?><?><?> PR Out: <?><?><?><?><?><?><?><?> (Release).

       --report-capabilities|-c
              <?><?><?><?><?> PR In: <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (Report Capabilities).

       --reserve|-R
              <?><?><?><?><?> PR Out: <?><?><?><?> (Reserve).

       --transport-id=TIDS|-X TIDS
              <?><?><?><?><?><?><?><?><?> TransportID
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?>.

       --alloc-length=LEN|-l LEN
              <?><?><?><?><?> PR In: <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?>. LEN <?><?> <?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?> 0 <?><?> 8192 <?><?><?>.

<?><?><?><?> (EXAMPLE)
       <?><?><?> <?><?><?><?> "123abc" <?><?><?><?> <?><?><?><?><?><?>
       /dev/mapper/mpath9:
              mpathpersist --out --register --param-sark=123abc
              /dev/mapper/mpath9

       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       /dev/mapper/mpath9:
              mpathpersist -i -k /dev/mapper/mpath9

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       /dev/mapper/mpath9 <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>:
              mpathpersist --out --reserve --param-rk=123abc --prout-type=8 -d
              /dev/mapper/mpath9

       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       /dev/mapper/mpath9:
              mpathpersist -i -s -d /dev/mapper/mpath9

       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> prout-type <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>):
              mpathpersist --out --release --param-rk=123abc --prout-type=8 -d
              /dev/mapper/mpath9

       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> 0):
              mpathpersist --out --register-ignore -K 123abc -S 0
              /dev/mapper/mpath9

       <?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> I_T (<?><?><?><?><?><?><?> I_T
       nexus):
              mpathpersist -oCK 123abc /dev/mapper/mpath9

<?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (BATCH FILES)
       <?><?><?><?><?> --batch-file (-f) <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> mpathpersist
       <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> mpathpersist <?><?><?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>) <?><?><?><?>
       mpathpersist <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       (<?><?><?><?><?> <?><?> TAB) <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> "mpathpersist" <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>. <?><?><?><?><?> "#"<?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?> <?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       mpathpersist <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> -f
       <?> -v<?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>. <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -f <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>.
       <?><?><?><?><?> -v <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (multipath map)
       <?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -d.
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?>. <?><?><?> mpathpersist <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?>. <?><?><?><?><?> <?><?><?><?> mpathpersist
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> 0 <?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> -f <?><?> <?><?> <?><?><?><?><?>
       mpathpersist <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>.

       <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?>.

              # This is an mpathpersist input file.
              # Short and long forms of the same command
              -i -k /dev/dm-1 # short form, this comment is ignored
              mpathpersist --in --read-keys --device=/dev/dm-1

              # Mixing of long and short options, variable white space
                --out  --register    -S  abcde     /dev/dm-1

              # Mixing of commands for different maps
              -ir /dev/dm-0
              -ir /dev/dm-1

              mpathpersist --out --param-rk abcde --reserve --prout-type 5 /dev/dm-1
              # This should now show a reservation
              -ir /dev/dm-1
              -oCK abcde /dev/dm-1
              --in --read-reservation /dev/dm-1

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       multipath(8), multipathd(8), sg_persist(8).

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       multipath-tools <?><?><?><?> Christophe Varoqui
       <christophe.varoqui@opensvc.com> <?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

Linux                             2021-11-12                   MPATHPERSIST(8)