vgs(8)
Display information about volume groups in LVM (Logical Volume Manager).
Synopsis
vgs [OPTION]... [VolumeGroupName]...Description
vgs lists all volume groups or specified volume groups with their attributes. It provides a quick overview of VG status, size, free space, and logical volume count. This is part of the LVM2 toolset for managing logical volumes.
By default, output is displayed in a columnar format with commonly used attributes. You can customize the columns displayed and format the output for scripting or further processing.
Common options
| Flag | What it does |
|---|---|
-o, --options | Specify output columns; e.g., -o name,size,free shows name, total size, and free space |
-a, --all | Include volume groups that are exported or inactive |
-S, --select | Filter volume groups by selection criteria, e.g., -S 'size > 10G' |
--noheadings | Suppress column headings from output |
--rows | Display output one field per line instead of columnar format |
--units | Specify output unit for size fields (h, b, s, k, m, g, t); default is 'k' |
--separator | Use a custom separator for output fields instead of spaces |
-v, --verbose | Show additional detailed information |
Examples
List all volume groups with default columns (name, size, free space, #LV, etc.)
vgsDisplay only volume group name, total size, and free space
vgs -o name,size,freeList all volume groups with sizes displayed in gigabytes
vgs --units gShow only volume groups larger than 10 gigabytes
vgs -S 'size > 10G'Output volume groups without headers, using colon as field separator (useful for parsing)
vgs --noheadings --separator :Display information about the specific volume group named 'myvg'
vgs myvgDisplay volume groups in row format, one field per line for readability
vgs --rowsList all volume groups including exported and inactive ones
vgs -a