C.3. Selection Criteria Fields
C.3. Selection Criteria Fields This section describes the logical and physical volume selection criteria fields you can specify. Table C.5, "Logical Volume Fields" describes the logical volume fields and their field types. Table C.5. Logical Volume Fields Logical Volume Field Description Field Type lv_uuid Unique identifier string lv_name Name (logical volumes created for internal use are enclosed in brackets) string lv_full_name Full name of logical volume including its volume group, namely VG/LV string lv_path Full pathname for logical volume (blank for internal logical volumes) string lv_dm_path Internal device mapper pathname for logical volume (in /dev/mapper directory) string lv_parent For logical volumes that are components of another logical volume, the parent logical volume string lv_layout logical volume layout string list lv_role logical volume role string list lv_initial_image_sync Set if mirror/RAID images underwent initial resynchronization number lv_image_synced Set if mirror/RAID image is synchronized number lv_merging Set if snapshot logical volume is being merged to origin number lv_converting Set if logical volume is being converted number lv_allocation_policy logical volume allocation policy string lv_allocation_locked Set if logical volume is locked against allocation changes number lv_fixed_minor Set if logical volume has fixed minor number assigned number lv_merge_failed Set if snapshot merge failed number lv_snapshot_invalid Set if snapshot logical volume is invalid number lv_skip_activation Set if logical volume is skipped on activation number lv_when_full For thin pools, behavior when full string lv_active Active state of the logical volume string lv_active_locally Set if the logical volume is active locally number lv_active_remotely Set if the logical volume is active remotely number lv_active_exclusively Set if the logical volume is active exclusively number lv_major Persistent major number or -1 if not persistent number lv_minor Persistent minor number or -1 if not persistent number lv_read_ahead Read ahead setting in current units size lv_size Size of logical volume in current units size lv_metadata_size For thin and cache pools, the size of the logical volume that holds the metadata size seg_count Number of segments in logical volume number origin For snapshots, the origin device of this logical volume string origin_size For snapshots, the size of the origin device of this logical volume size data_percent For snapshot and thin pools and volumes, the percentage full if logical volume is active percent snap_percent For snapshots, the percentage full if logical volume is active percent metadata_percent For thin pools, the percentage of metadata full if logical volume is active percent copy_percent For RAID, mirrors and pvmove, current percentage in-sync percent sync_percent For RAID, mirrors and pvmove, current percentage in-sync percent raid_mismatch_count For RAID, number of mismatches found or repaired number raid_sync_action For RAID, the current synchronization action being performed string raid_write_behind For RAID1, the number of outstanding writes allowed to writemostly devices number raid_min_recovery_rate For RAID1, the minimum recovery I/O load in kiB/sec/disk number raid_max_recovery_rate For RAID1, the maximum recovery I/O load in kiB/sec/disk number move_pv For pvmove, source physical volume of temporary logical volume created by pvmove string convert_lv For lvconvert, name of temporary logical volume created by lvconvert string mirror_log For mirrors, the logical volume holding the synchronization log string data_lv For thin and cache pools, the logical volume holding the associated data string metadata_lv For thin and cache pools, the logical volume holding the associated metadata string pool_lv For thin volumes, the thin pool logical volume for this volume string lv_tags Tags, if any string list lv_profile Configuration profile attached to this logical volume string lv_time Creation time of the logical volume, if known string lv_host Creation host of the logical volume, if known string lv_modules Kernel device-mapper modules required for this logical volume string list Table C.6, "Logical Volume Device Combined Info and Status Fields" describes the logical volume device fields that combine both logical device info and logical device status. Table C.6. Logical Volume Device Combined Info and Status Fields Logical Volume Field Description Field Type lv_attr Selects according to both logical volume device info as well as logical volume status. string Table C.7, "Logical Volume Device Info Fields" describes the logical volume device info fields and their field types. Table C.7. Logical Volume Device Info Fields Logical Volume Field Description Field Type lv_kernel_major Currently assigned major number or -1 if logical volume is not active number lv_kernel_minor Currently assigned minor number or -1 if logical volume is not active number lv_kernel_read_ahead Currently-in-use read ahead setting in current units size lv_permissions logical volume permissions string lv_suspended Set if logical volume is suspended number lv_live_table Set if logical volume has live table present number lv_inactive_table Set if logical volume has inactive table present number lv_device_open Set if logical volume device is open number Table C.8, "Logical Volume Device Status Fields" describes the logical volume device status fields and their field types. Table C.8. Logical Volume Device Status Fields Logical Volume Field Description Field Type cache_total_blocks Total cache blocks number cache_used_blocks Used cache blocks number cache_dirty_blocks Dirty cache blocks number cache_read_hits Cache read hits number cache_read_misses Cache read misses number cache_write_hits Cache write hits number cache_write_misses Cache write misses number lv_health_status logical volume health status string Table C.9, "Physical Volume Label Fields" describes the physical volume label fields and their field types. Table C.9. Physical Volume Label Fields Physical Volume Field Description Field Type pv_fmt Type of metadata string pv_uuid Unique identifier string dev_size Size of underlying device in current units size pv_name Name string pv_mda_free Free metadata area space on this device in current units size pv_mda_size Size of smallest metadata area on this device in current units size Table C.5, "Logical Volume Fields" describes the physical volume fields and their field types. Table C.10. Pysical Volume Fields Physical Volume Field Description Field Type pe_start Offset to the start of data on the underlying device number pv_size Size of physical volume in current units size pv_free Total amount of unallocated space in current units size pv_used Total amount of allocated space in current units size pv_attr Various attributes string pv_allocatable Set if this device can be used for allocation number pv_exported Set if this device is exported number pv_missing Set if this device is missing in system number pv_pe_count Total number of physical extents number pv_pe_alloc_count Total number of allocated physical extents number pv_tags Tags, if any string list pv_mda_count Number of metadata areas on this device number pv_mda_used_count Number of metadata areas in use on this device number pv_ba_start Offset to the start of PV Bootloader Area on the underlying device in current units size pv_ba_size Size of PV Bootloader Area in current units size Table C.11, "Volume Group Fields" describes the volume group fields and their field types. Table C.11. Volume Group Fields Volume Group Field Description Field Type vg_fmt Type of metadata string vg_uuid Unique identifier string vg_name Name string vg_attr Various attributes string vg_permissions Volume group permissions string vg_extendable Set if volume group is extendable number vg_exported Set if volume group is exported number vg_partial Set if volume group is partial number vg_allocation_policy Volume group allocation policy string vg_clustered Set if volume group is clustered number vg_size Total size of volume group in current units size vg_free Total amount of free space in current units size vg_sysid System ID of the volume group indicating which host owns it string vg_systemid System ID of the volume group indicating which host owns it string vg_extent_size Size of physical extents in current units size vg_extent_count Total number of physical extents number vg_free_count Total number of unallocated physical extents number max_lv Maximum number of logical volumes allowed in volume group or 0 if unlimited number max_pv Maximum number of physical volumes allowed in volume group or 0 if unlimited number pv_count Number of physical volumes number lv_count Number of logical volumes number snap_count Number of snapshots number vg_seqno Revision number of internal metadata - incremented whenever it changes number vg_tags Tags, if any string list vg_profile Configuration profile attached to this volume group string vg_mda_count Number of metadata areas on this volume group number vg_mda_used_count Number of metadata areas in use on this volume group number vg_mda_free Free metadata area space for this volume group in current units size vg_mda_size Size of smallest metadata area for this volume group in current units size vg_mda_copies Target number of in use metadata areas in the volume group number Table C.12, "Logical Volume Segment Fields" describes the logical volume segment fields and their field types. Table C.12. Logical Volume Segment Fields Logical Volume Segment Field Description Field Type segtype Type of logical volume segment string stripes Number of stripes or mirror legs number stripesize For stripes, amount of data placed on one device before switching to the size stripe_size For stripes, amount of data placed on one device before switching to the size regionsize For mirrors, the unit of data copied when synchronizing devices size region_size For mirrors, the unit of data copied when synchronizing devices size chunksize For snapshots, the unit of data used when tracking changes size chunk_size For snapshots, the unit of data used when tracking changes size thin_count For thin pools, the number of thin volumes in this pool number discards For thin pools, how discards are handled string cachemode For cache pools, how writes are cached string zero For thin pools, if zeroing is enabled number transaction_id For thin pools, the transaction id number thin_id For thin volumes, the thin device id number seg_start Offset within the logical volume to the start of the segment in current units size seg_start_pe Offset within the logical volume to the start of the segment in physical extents. number seg_size Size of segment in current units size seg_size_pe Size of segment in physical extents size seg_tags Tags, if any string list seg_pe_ranges Ranges of physical extents of underlying devices in command line format string devices Underlying devices used with starting extent numbers string seg_monitor dmeventd monitoring status of the segment string cache_policy The cache policy (cached segments only) string cache_settings Cache settings/parameters (cached segments only) string list Table C.13, "Pysical Volume Segment Fields" describes the physical volume segment fields and their field types. Table C.13. Pysical Volume Segment Fields Physical Volume Segment Field Description Field Type pvseg_start Physical extent number of start of segment number pvseg_size Number of extents in segment number Table C.14, "Selection Criteria Synonyms" lists the synonyms you can use for field values. These synonyms can be used in selection criteria as well as for values just like their original values. In this table, a field value of "" indicates a blank string, which can be matched by specifying -S 'field_name=""'. In this table, a field indicated by 0 or 1 indicates a binary value. You can specify a --binary option for reporting tools which causes binary fields to display 0 or 1 instead of what is indicated in this table as "some text" or "". Table C.14. Selection Criteria Synonyms Field Field Value Synonyms pv_allocatable allocatable 1 pv_allocatable "" 0 pv_exported exported 1 pv_exported "" 0 pv_missing missing 1 pv_missing "" 0 vg_extendable extendable 1 vg_extendable "" 0 vg_exported exported 1 vg_exported "" 0 vg_partial partial 1 vg_partial "" 0 vg_clustered clustered 1 vg_clustered "" 0 vg_permissions writeable rw, read-write vg_permissions read-only r, ro vg_mda_copies unmanaged unknown, undefined, undef, -1 lv_initial_image_sync initial image sync sync, 1 lv_initial_image_sync "" 0 lv_image_synced image synced synced, 1 lv_image_synce "" 0 lv_merging merging 1 lv_merging "" 0 lv_converting converting 1 lv_converting "" 0 lv_allocation_locked allocation locked locked, 1 lv_allocation_locked "" 0 lv_fixed_minor fixed minor fixed, 1 lv_fixed_minor "" 0 lv_active_locally active locally active, locally, 1 lv_active_locally "" 0 lv_active_remotely active remotely active, remotely, 1 lv_active_remotely "" 0 lv_active_exclusively active exclusively active, exclusively, 1 lv_active_exclusively "" 0 lv_merge_failed merge failed failed, 1 lv_merge_failed "" 0 lv_snapshot_invalid snapshot invalid invalid, 1 lv_snapshot_invalid "" 0 lv_suspended suspended 1 lv_suspended "" 0 lv_live_table live table present live table, live, 1 lv_live_table "" 0 lv_inactive_table inactive table present inactive table, inactive, 1 lv_inactive_table "" 0 lv_device_open open 1 lv_device_open "" 0 lv_skip_activation skip activation skip, 1 lv_skip_activation "" 0 zero zero 1 zero "" 0 lv_permissions writeable rw, read-write lv_permissions read-only r, ro lv_permissions read-only-override ro-override, r-override, R lv_when_full error error when full, error if no space lv_when_full queue queue when full, queue if no space lv_when_full "" undefined cache_policy "" undefined seg_monitor "" undefined lv_health_status "" undefined C.3.1. Specifying Time Values When specifying time values for LVM selection, you can use either a standardized time specification format or a more free-form specification, as described in Section C.3.1.1, "Standard time selection format" and Section C.3.1.2, "Freeform time selection format" . You can specify the way time values are displayed with the report/time format configuration option in the /etc/lvm/lvm.conf configuration file. Information on specifying this option is provided in the lvm.conf file. When specifying time values, you can use the comparison operator aliases since , after , until , and before , as described in Table C.3, "Selection Criteria Comparison Operators" . C.3.1.1. Standard time selection format You can specify time values for LVM selection in the following format. Table C.15, "Time Specification Formats" summarizes the formats you can use when specifying these time values. Table C.15. Time Specification Formats Field Field Value date YYYY-MM-DD YYYY-MM, auto DD=1 YYYY, auto MM=01 and DD=01 time hh:mm:ss hh:mm, auto ss=0 hh, auto mm=0, auto ss=0 timezone (always with + or - sign) +hh:mm or -hh:mm +hh or -hh The full date/time specification is YYYY-MM-DD hh:mm:ss. Users are able to leave date/time parts from right to left. Whenever these parts are left out, a range is assumed automatically with second granularity. For example: "2015-07-07 9:51" means range of "2015-07-07 9:51:00" - "2015-07-07 9:51:59" "2015-07" means range of "2015-07-01 0:00:00" - "2015-07-31 23:59:59" "2015" means range of "2015-01-01 0:00:00" - "2015-12-31 23:59:59" The following examples show the date/time specification as used in selection criteria. C.3.1.2. Freeform time selection format You can specify the date/time specification in LVM selection criteria using the following entitles. weekday names ("Sunday" - "Saturday" or abbreviated as "Sun" - "Sat") labels for points in time ("noon", "midnight") labels for a day relative to current day ("today", "yesterday") points back in time with relative offset from today (N is a number) ( "N" "seconds"/"minutes"/"hours"/"days"/"weeks"/"years" "ago") ( "N" "secs"/"mins"/"hrs" ... "ago") ( "N" "s"/"m"/"h" ... "ago") time specification either in hh:mm:ss format or with AM/PM suffixes month names ("January" - "December" or abbreviated as "Jan" - "Dec") The following examples the show the freeform date/time specificaiton as used in selection criteria.
date time timezone lvs -S 'time since "2015-07-07 9:51"' lvs -S 'time = "2015-07"" lvs -S 'time = "2015"' lvs -S 'time since "yesterday 9AM"' lvs -S 'time since "Feb 3 years 2 months ago"' lvs -S 'time = "February 2015"' lvs -S 'time since "Jan 15 2015" && time until yesterday' lvs -S 'time since "today 6AM"'