View source for Logical Volume Management Fields

=Internal=

* [[Vgs#-o|vgs]]
* [[Lvs#-o|lvs]]
* [[Pvs#-o|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 attributessee 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.