lvs(8)
Display information about logical volumes in a volume group.
Synopsis
lvs [option]... [LogicalVolume ...]Description
lvs lists all logical volumes (LVs) or specific ones you name. It queries the LVM metadata to show attributes like size, allocation status, open count, and origin (for snapshots). Output is highly customizable with formatting options.
By default, lvs displays one logical volume per line with essential columns. The command is part of the LVM2 toolset and works with device mapper underneath.
Common options
| Flag | What it does |
|---|---|
-a, --all | Show all logical volumes, including internal/hidden ones |
-o, --options LIST | Choose which columns to display (e.g., lv_name,lv_size,lv_status) |
-S, --select SELECTION | Filter output using expressions (e.g., lv_size>1G) |
-H, --headings yes|no | Show or hide column headers (default: yes) |
--noheadings | Suppress header line from output |
-v, --verbose | Show extra details and progress information |
--units b|B|s|S|k|K|m|M|g|G|t|T|p|P | Display sizes in specified unit (bytes, sectors, or SI/binary) |
--tree | Show logical volume relationships in tree format |
-r, --reportformat basic|json | Output format: basic (default) or JSON |
Examples
List all logical volumes with default columns (LV, VG, Attr, LSize, Pool, Origin, Data%, Meta%, Move, Log, Cpy%Sync, Convert)
lvsShow name, size, and status of logical volumes in myvolgroup
lvs -o lv_name,lv_size,lv_status myvolgroupList only LVs larger than 1GB with their name, size, and volume group
lvs -S 'lv_size>1G' -o lv_name,lv_size,vg_nameDisplay LV names and sizes in gigabytes without header
lvs --noheadings --units G -o lv_name,lv_sizeShow detailed information about a specific logical volume
lvs -v myvg/mydataDisplay logical volumes in myvg in tree format showing relationships
lvs --tree myvgOutput LV information as JSON including segment count
lvs --reportformat json -o lv_name,lv_size,seg_count