Logical Volume Management Fields

Internal

• vgs
• lvs
• pvs

Logical Volume Fields

• lv_all - All fields in this section.
• lv_uuid - Unique identifier.
• lv_name - Name. LVs created for internal use are enclosed in brackets.
• lv_full_name - Full name of LV including its VG, namely VG/LV.
• lv_path - Full pathname for LV. Blank for internal LVs.
• lv_dm_path - Internal device-mapper pathname for LV (in /dev/mapper directory).
• lv_parent - For LVs that are components of another LV, the parent LV.

Logical Volume Device Info and Status Combined Fields

• lv_all - All fields in this section.
• lv_attr - Various attributes - see man page.

Logical Volume Fields

• lv_all - All fields in this section.
• lv_layout - LV layout.
• lv_role - LV role.
• lv_initial_image_sync - Set if mirror/RAID images underwent initial resynchronization.
• lv_image_synced - Set if mirror/RAID image is synchronized.
• lv_merging - Set if snapshot LV is being merged to origin.
• lv_converting - Set if LV is being converted.
• lv_allocation_policy - LV allocation policy.
• lv_allocation_locked - Set if LV is locked against allocation changes.
• lv_fixed_minor - Set if LV has fixed minor number assigned.
• lv_merge_failed - Set if snapshot merge failed.
• lv_snapshot_invalid - Set if snapshot LV is invalid.
• lv_skip_activation - Set if LV is skipped on activation.
• lv_when_full - For thin pools, behavior when full.
• lv_active - Active state of the LV.
• lv_active_locally - Set if the LV is active locally.
• lv_active_remotely - Set if the LV is active remotely.
• lv_active_exclusively - Set if the LV is active exclusively.
• lv_major - Persistent major number or -1 if not persistent.
• lv_minor - Persistent minor number or -1 if not persistent.
• lv_read_ahead - Read ahead setting in current units.
• lv_size - Size of LV in current units.
• lv_metadata_size - For thin and cache pools, the size of the LV that holds the metadata.
• seg_count - Number of segments in LV.
• origin - For snapshots and thins, the origin device of this LV.
• origin_uuid - For snapshots and thins, the UUID of origin device of this LV.
• origin_size - For snapshots, the size of the origin device of this LV.
• lv_ancestors - LV ancestors ignoring any stored history of the ancestry chain.
• lv_full_ancestors - LV ancestors including stored history of the ancestry chain.
• lv_descendants - LV descendants ignoring any stored history of the ancestry chain.
• lv_full_descendants - LV descendants including stored history of the ancestry chain.

Logical Volume Device Status Fields

   lv_all                 - All fields in this section.
   data_percent           - For snapshot, cache and thin pools and volumes, the percentage full if LV is active.
   snap_percent           - For snapshots, the percentage full if LV is active.
   metadata_percent       - For cache and thin pools, the percentage of metadata full if LV is active.
   copy_percent           - For Cache, RAID, mirrors and pvmove, current percentage in-sync.
   sync_percent           - For Cache, RAID, mirrors and pvmove, current percentage in-sync.

 Logical Volume Fields
 ---------------------
   lv_all                 - All fields in this section.
   raid_mismatch_count    - For RAID, number of mismatches found or repaired.
   raid_sync_action       - For RAID, the current synchronization action being performed.
   raid_write_behind      - For RAID1, the number of outstanding writes allowed to writemostly devices.
   raid_min_recovery_rate - For RAID1, the minimum recovery I/O load in kiB/sec/disk.
   raid_max_recovery_rate - For RAID1, the maximum recovery I/O load in kiB/sec/disk.
   move_pv                - For pvmove, Source PV of temporary LV created by pvmove.
   move_pv_uuid           - For pvmove, the UUID of Source PV of temporary LV created by pvmove.
   convert_lv             - For lvconvert, Name of temporary LV created by lvconvert.
   convert_lv_uuid        - For lvconvert, UUID of temporary LV created by lvconvert.
   mirror_log             - For mirrors, the LV holding the synchronisation log.
   mirror_log_uuid        - For mirrors, the UUID of the LV holding the synchronisation log.
   data_lv                - For thin and cache pools, the LV holding the associated data.
   data_lv_uuid           - For thin and cache pools, the UUID of the LV holding the associated data.
   metadata_lv            - For thin and cache pools, the LV holding the associated metadata.
   metadata_lv_uuid       - For thin and cache pools, the UUID of the LV holding the associated metadata.
   pool_lv                - For thin volumes, the thin pool LV for this volume.
   pool_lv_uuid           - For thin volumes, the UUID of the thin pool LV for this volume.
   lv_tags                - Tags, if any.
   lv_profile             - Configuration profile attached to this LV.
   lv_lockargs            - Lock args of the LV used by lvmlockd.
   lv_time                - Creation time of the LV, if known
   lv_time_removed        - Removal time of the LV, if known
   lv_host                - Creation host of the LV, if known.
   lv_modules             - Kernel device-mapper modules required for this LV.
   lv_historical          - Set if the LV is historical.

 Logical Volume Device Info Fields
 ---------------------------------
   lv_all                 - All fields in this section.
   lv_kernel_major        - Currently assigned major number or -1 if LV is not active.
   lv_kernel_minor        - Currently assigned minor number or -1 if LV is not active.
   lv_kernel_read_ahead   - Currently-in-use read ahead setting in current units.
   lv_permissions         - LV permissions.
   lv_suspended           - Set if LV is suspended.
   lv_live_table          - Set if LV has live table present.
   lv_inactive_table      - Set if LV has inactive table present.
   lv_device_open         - Set if LV device is open.

 Logical Volume Device Status Fields
 -----------------------------------
   lv_all                 - All fields in this section.
   cache_total_blocks     - Total cache blocks.
   cache_used_blocks      - Used cache blocks.
   cache_dirty_blocks     - Dirty cache blocks.
   cache_read_hits        - Cache read hits.
   cache_read_misses      - Cache read misses.
   cache_write_hits       - Cache write hits.
   cache_write_misses     - Cache write misses.
   kernel_cache_settings  - Cache settings/parameters as set in kernel, including default values (cached segments only).
   kernel_cache_policy    - Cache policy used in kernel.
   lv_health_status       - LV health status.
   kernel_discards        - For thin pools, how discards are handled in kernel.
   lv_check_needed        - For thin pools and cache volumes, whether metadata check is needed.

 Physical Volume Label Fields
 ----------------------------
   pv_all                 - All fields in this section.
   pv_fmt                 - Type of metadata.
   pv_uuid                - Unique identifier.
   dev_size               - Size of underlying device in current units.
   pv_name                - Name.
   pv_major               - Device major number.
   pv_minor               - Device minor number.
   pv_mda_free            - Free metadata area space on this device in current units.
   pv_mda_size            - Size of smallest metadata area on this device in current units.
   pv_ext_vsn             - PV header extension version.

 Physical Volume Fields
 ----------------------
   pv_all                 - All fields in this section.
   pe_start               - Offset to the start of data on the underlying device.
   pv_size                - Size of PV in current units.
   pv_free                - Total amount of unallocated space in current units.
   pv_used                - Total amount of allocated space in current units.
   pv_attr                - Various attributes - see man page.
   pv_allocatable         - Set if this device can be used for allocation.
   pv_exported            - Set if this device is exported.
   pv_missing             - Set if this device is missing in system.
   pv_pe_count            - Total number of Physical Extents.
   pv_pe_alloc_count      - Total number of allocated Physical Extents.
   pv_tags                - Tags, if any.
   pv_mda_count           - Number of metadata areas on this device.
   pv_mda_used_count      - Number of metadata areas in use on this device.
   pv_ba_start            - Offset to the start of PV Bootloader Area on the underlying device in current units.
   pv_ba_size             - Size of PV Bootloader Area in current units.
   pv_in_use              - Set if PV is used.
   pv_duplicate           - Set if PV is an unchosen duplicate.

 Volume Group Fields
 -------------------
   vg_all                 - All fields in this section.
   vg_fmt                 - Type of metadata.
   vg_uuid                - Unique identifier.
   vg_name                - Name.
   vg_attr                - Various attributes - see man page.
   vg_permissions         - VG permissions.
   vg_extendable          - Set if VG is extendable.
   vg_exported            - Set if VG is exported.
   vg_partial             - Set if VG is partial.
   vg_allocation_policy   - VG allocation policy.
   vg_clustered           - Set if VG is clustered.
   vg_size                - Total size of VG in current units.
   vg_free                - Total amount of free space in current units.
   vg_sysid               - System ID of the VG indicating which host owns it.
   vg_systemid            - System ID of the VG indicating which host owns it.
   vg_lock_type           - Lock type of the VG used by lvmlockd.
   vg_lock_args           - Lock args of the VG used by lvmlockd.
   vg_extent_size         - Size of Physical Extents in current units.
   vg_extent_count        - Total number of Physical Extents.
   vg_free_count          - Total number of unallocated Physical Extents.
   max_lv                 - Maximum number of LVs allowed in VG or 0 if unlimited.
   max_pv                 - Maximum number of PVs allowed in VG or 0 if unlimited.
   pv_count               - Number of PVs in VG.
   vg_missing_pv_count    - Number of PVs in VG which are missing.
   lv_count               - Number of LVs.
   snap_count             - Number of snapshots.
   vg_seqno               - Revision number of internal metadata.  Incremented whenever it changes.
   vg_tags                - Tags, if any.
   vg_profile             - Configuration profile attached to this VG.
   vg_mda_count           - Number of metadata areas on this VG.
   vg_mda_used_count      - Number of metadata areas in use on this VG.
   vg_mda_free            - Free metadata area space for this VG in current units.
   vg_mda_size            - Size of smallest metadata area for this VG in current units.
   vg_mda_copies          - Target number of in use metadata areas in the VG.

 Logical Volume Segment Fields
 -----------------------------
   seg_all                - All fields in this section.
   segtype                - Type of LV segment.
   stripes                - Number of stripes or mirror legs.
   stripe_size            - For stripes, amount of data placed on one device before switching to the next.
   region_size            - For mirrors, the unit of data copied when synchronising devices.
   chunk_size             - For snapshots, the unit of data used when tracking changes.
   thin_count             - For thin pools, the number of thin volumes in this pool.
   discards               - For thin pools, how discards are handled.
   cache_mode             - For cache pools, how writes are cached.
   zero                   - For thin pools and volumes, if zeroing is enabled.
   transaction_id         - For thin pools, the transaction id and creation transaction id for thins.
   thin_id                - For thin volume, the thin device id.
   seg_start              - Offset within the LV to the start of the segment in current units.
   seg_start_pe           - Offset within the LV to the start of the segment in physical extents.
   seg_size               - Size of segment in current units.
   seg_size_pe            - Size of segment in physical extents.
   seg_tags               - Tags, if any.
   seg_pe_ranges          - Ranges of Physical Extents of underlying devices in command line format (deprecated, use seg_le_ranges for common format).
   seg_le_ranges          - Ranges of Logical Extents of underlying devices in command line format.
   seg_metadata_le_ranges - Ranges of Logical Extents of underlying metadata devices in command line format.
   devices                - Underlying devices used with starting extent numbers.
   metadata_devices       - Underlying metadata devices used with starting extent numbers.
   seg_monitor            - Dmeventd monitoring status of the segment.
   cache_policy           - The cache policy (cached segments only).
   cache_settings         - Cache settings/parameters (cached segments only).

 Physical Volume Segment Fields
 ------------------------------
   pvseg_all              - All fields in this section.
   pvseg_start            - Physical Extent number of start of segment.
   pvseg_size             - Number of extents in segment.

Special Fields

• selected - Set if item passes selection criteria.