<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
 
<br><tt>This is the help page for the new dminfo extension:</tt><tt></tt>
<p><tt>-------------------------------------------------------------------</tt><tt></tt>
<p><tt>NAME</tt>
<br><tt>  dminfo - device mapper (dm) information</tt><tt></tt>
<p><tt>SYNOPSIS</tt>
<br><tt>  dminfo [-b bio | -d | -l | -q | -s | -t]</tt><tt></tt>
<p><tt>DESCRIPTION</tt>
<br><tt>  This command displays information about device-mapper mapped</tt>
<br><tt>  devices (dm devices).</tt>
<br><tt>  If no argument is entered, displays lists of existing dm
devices.</tt>
<br><tt>  It's same as -l option.</tt><tt></tt>
<p><tt>    -b bio  displays the information of the
dm device which the bio</tt>
<br><tt>           
is submitted in.  If the bio isn't for dm devices,</tt>
<br><tt>           
results will be error.</tt>
<br><tt>        -d  displays dependency
information for existing dm devices.</tt>
<br><tt>        -l  displays lists
of existing dm devices.</tt>
<br><tt>        -q  displays queued
I/O information for each target of</tt>
<br><tt>           
existing dm devices.</tt>
<br><tt>        -s  displays status
information for each target of existing</tt>
<br><tt>           
dm devices.</tt>
<br><tt>        -t  displays table
information for each target of existing</tt>
<br><tt>           
dm devices.</tt><tt></tt>
<p><tt>EXAMPLE</tt>
<br><tt>  Display lists of dm devices.  "MAP_DEV" is the address
of the</tt>
<br><tt>  struct mapped_device.  "DM_TABLE" is the address of
the struct</tt>
<br><tt>  dm_table.  "TARGETS" is the number of targets which
are in</tt>
<br><tt>  the struct dm_table.</tt><tt></tt>
<p><tt>    crash> dminfo</tt>
<br><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  8    c4866c80         
c4866280          1       
vg0-snap0</tt>
<br><tt>    253  6    f6a04a80         
f6a04580          1       
vg0-lv0-real</tt>
<br><tt>    253  0    c4840380         
c4841880          1       
mp0</tt>
<br><tt>    253  5    f7c50c80         
c488e480          1       
via_cbeheddbdd</tt>
<br><tt>    253  7    c4866a80         
c4866380          1       
vg0-snap0-cow</tt>
<br><tt>    253  4    d441e280         
c919ed80          1       
dummy1</tt>
<br><tt>    253  3    f5dc4280         
cba81d80          1       
dummy0</tt>
<br><tt>    253  2    f7c53180         
c4866180          1       
vg0-lv0</tt>
<br><tt>    253  1    f746d280         
f746cd80          1       
mp0p1</tt><tt></tt>
<p><tt>  Display the dm device information which the bio is submitted
in.</tt>
<br><tt>  The bio (ceacee80) is a clone of the bio (ceacee00) which
is</tt>
<br><tt>  submitted in the dm-3 (dummy0).  And the bio (ceacee00)
is a clone</tt>
<br><tt>  of the bio (ceaced80) which is submitted in the dm-4 (dummy1),
too.</tt>
<br><tt>  The bio (ceaced80) is the original bio.</tt><tt></tt>
<p><tt>    crash> dminfo -b ceacee80</tt>
<br><tt>    DM_BIO_ADDRESS    MAJ  MIN 
MAP_DEV           DEVNAME</tt>
<br><tt>    ceacee00         
253  3    f5dc4280         
dm-3</tt>
<br><tt>    crash> dminfo -b ceacee00</tt>
<br><tt>    DM_BIO_ADDRESS    MAJ  MIN 
MAP_DEV           DEVNAME</tt>
<br><tt>    ceaced80         
253  4    d441e280         
dm-4</tt>
<br><tt>    crash> dminfo -b ceaced80</tt>
<br><tt>    dminfo: invalid kernel virtual address: 64 
type: "GET_VALUE: dm_io.bio"</tt><tt></tt>
<p><tt>  Display dependency information for each target.</tt>
<br><tt>  The vg0-snap0 depends on thd dm-6 (vg0-lv0-real) and the
dm-7</tt>
<br><tt>  (vg0-snap0-cow)</tt><tt></tt>
<p><tt>    crash> dminfo -d</tt>
<br><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  8    c4866c80         
c4866280          1       
vg0-snap0</tt>
<br><tt>      MAJ  MIN  GENDISK          
COUNT  DEVNAME</tt>
<br><tt>      253  7    c4866980         
1      dm-7</tt>
<br><tt>      253  6    f6a04280         
1      dm-6</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  6    f6a04a80         
f6a04580          1       
vg0-lv0-real</tt>
<br><tt>      MAJ  MIN  GENDISK          
COUNT  DEVNAME</tt>
<br><tt>      8    0   
f7f24c80          1     
sda</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  7    c4866a80         
c4866380          1       
vg0-snap0-cow</tt>
<br><tt>      MAJ  MIN  GENDISK          
COUNT  DEVNAME</tt>
<br><tt>      8    0   
f7f24c80          1     
sda</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  2    f7c53180         
c4866180          1       
vg0-lv0</tt>
<br><tt>      MAJ  MIN  GENDISK          
COUNT  DEVNAME</tt>
<br><tt>      253  6    f6a04280         
1      dm-6</tt><tt></tt>
<p><tt>  Display queued I/O information for each target.</tt>
<br><tt>  The information is displayed under the "PRIVATE_DATA" column.</tt><tt></tt>
<p><tt>    crash> dminfo -q</tt>
<br><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  5    f7c50c80         
c488e480          1       
via_cbeheddbdd</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8961080         
mirror       (reads) (writes) (quiesced)
(recovered)</tt><tt></tt>
<p><tt>      --------------------------------------------------------------</tt>
<br><tt>       "reads/writes" are members
of the struct mirror_set, and</tt>
<br><tt>       "quiesced/recovered" are members
of the struct region_hash.</tt>
<br><tt>       If the list is empty, the
member is bracketed by "()".</tt>
<br><tt>      --------------------------------------------------------------</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  0    c4840380         
c4841880          1       
mp0</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8802080         
multipath    queue_size:0</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  1    f746d280         
f746cd80          1       
mp0p1</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8821080         
linear       No queue info</tt><tt></tt>
<p><tt>  Display status information for each target.</tt>
<br><tt>  The information is displayed under the "PRIVATE_DATA" column.</tt><tt></tt>
<p><tt>    crash> dminfo -s</tt>
<br><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  0    c4840380         
c4841880          1       
mp0</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8802080         
multipath    queue_if_no_path:0 hwh:none nr_pgs:1</tt>
<br><tt>        PG  PG_STATUS 
NR_PATHS  PATHS</tt>
<br><tt>        1   active    
2         8:16(A,0) 8:32(A,0)</tt><tt></tt>
<p><tt>      --------------------------------------------------------------</tt>
<br><tt>       Format of "PATHS": <major>:<minor>(<status>,<fail_count>)</tt>
<br><tt>         Status: A:active,
F:faulty</tt>
<br><tt>         Fail_count: the
value of the struct pgpath.fail_count</tt>
<br><tt>      --------------------------------------------------------------</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  5    f7c50c80         
c488e480          1       
via_cbeheddbdd</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8961080         
mirror       in_sync:1 dev:8:16(A,0),8:32(A,0)</tt><tt></tt>
<p><tt>      --------------------------------------------------------------</tt>
<br><tt>       Format of "dev": <major>:<minor>(<status>,<error_count>)</tt>
<br><tt>         Status: A:active,
D:degraded</tt>
<br><tt>         Error_count: the
value of the struct mirror.error_count</tt>
<br><tt>      --------------------------------------------------------------</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  1    f746d280         
f746cd80          1       
mp0p1</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8821080         
linear       No status info</tt><tt></tt>
<p><tt>  Display table information for each target.</tt>
<br><tt>  The information is displayed under the "PRIVATE_DATA" column.</tt><tt></tt>
<p><tt>    crash> dminfo -t</tt>
<br><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  8    c4866c80         
c4866280          1       
vg0-snap0</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f89b4080         
snapshot     orig:253:6 cow:253:7 type:P chunk_size:16</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  6    f6a04a80         
f6a04580          1       
vg0-lv0-real</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f890f080         
linear       begin:0 len:204800 dev:8:5 offset:384</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  0    c4840380         
c4841880          1       
mp0</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8802080         
multipath    queue_if_no_path:0 hwh:none nr_pgs:1</tt>
<br><tt>        PG  PATH_SELECTOR 
NR_PATHS  PATHS</tt>
<br><tt>        1   round-robin   
2         8:16 8:32</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  5    f7c50c80         
c488e480          1       
via_cbeheddbdd</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8961080         
mirror       log:core dev:8:16(0),8:32(0)</tt><tt></tt>
<p><tt>      --------------------------------------------------------------</tt>
<br><tt>       Format of "dev": <major>:<minor>(<offset>)</tt>
<br><tt>         Offset: the value
of the struct mirror.offset</tt>
<br><tt>      --------------------------------------------------------------</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  7    c4866a80         
c4866380          1       
vg0-snap0-cow</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f899d080         
linear       begin:0 len:8192 dev:8:5 offset:205184</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  2    f7c53180         
c4866180          1       
vg0-lv0</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8bbc080         
snapshot-origin  orig_dev:253:6</tt><tt></tt>
<p><tt>    MAJ  MIN  MAP_DEV          
DM_TABLE          TARGETS 
MAPNAME</tt>
<br><tt>    253  1    f746d280         
f746cd80          1       
mp0p1</tt>
<br><tt>      TARGET           
TARGET_TYPE  PRIVATE_DATA</tt>
<br><tt>      f8821080         
linear       begin:0 len:2040192 dev:253:0
offset:63</tt>
<br><tt></tt> 
<br> </html>