LinuxCommandLibrary

lvdisplay

Display logical volume information

TLDR

Display information about all logical volumes

$ sudo lvdisplay
copy

Display information about all logical volumes in volume group vg1
$ sudo lvdisplay [vg1]
copy

Display information about logical volume lv1 in volume group vg1
$ sudo lvdisplay [vg1/lv1]
copy

SYNOPSIS

lvdisplay [options] [LogicalVolumePath [LogicalVolumePath...]]

PARAMETERS

-a|--all
    Display information about all logical volumes. This is the default behavior if no LogicalVolumePath is specified.

-c|--config report
    Output information in a configurable report format.

-d|--debug
    Provide additional debugging output.

-h|--help
    Display help text and exit.

-m|--maps
    Display mapping of logical extents to physical volumes.

-n|--nameprefix
    Add a name prefix to all output.

-o|--options Fields
    Specify which fields to display in the output. Use lvdisplay --help to see a full list of available fields.

-O|--readonly
    Display only read-only logical volumes.

-s|--segments
    Display segment information.

-S|--select Condition
    Display only logical volumes that match the selection condition.

-t|--tree
    Display output as a tree.

-v|--verbose
    Provide verbose output.

-V|--version
    Display version information and exit.

LogicalVolumePath
    The path to the logical volume to display information for. Can be /dev// or /.

DESCRIPTION

The lvdisplay command provides detailed information about Logical Volumes (LVs) within a Linux Logical Volume Management (LVM) system. It displays attributes such as LV name, UUID, size, status (active/inactive), allocation policy, current LE (Logical Extent) size, number of LVs and snapshots, and information about the physical volumes (PVs) contributing to the LV. lvdisplay is a crucial tool for system administrators to monitor, troubleshoot, and manage LVM storage. The output includes details about thin provisioning, mirroring, and other advanced LVM features, enabling effective capacity planning and performance tuning.

Without any options, lvdisplay will show information on all logical volumes found on the system. You can specify logical volume names, UUID's or tags to limit the output. The command reads LVM metadata from configuration files and the kernel. It interacts with the LVM library to provide a consolidated view of the logical volume infrastructure.

CAVEATS

The command relies on proper LVM configuration and metadata. Incorrect configuration can lead to inaccurate or incomplete output.

OUTPUT FORMAT

The output of lvdisplay can be customized using the -o option to specify the desired fields. The default output includes important metadata, such as LV name, size, status, and attributes. Understanding the output fields is essential for effective LVM management.

FILTERING WITH SELECT

The -S option allows filtering logical volumes based on various criteria, such as size, status, or attributes. This is particularly useful when managing a large number of LVs and needing to quickly identify those that meet specific conditions.

HISTORY

lvdisplay is part of the LVM2 suite, which has been under active development since the early 2000s. It evolved to provide more comprehensive logical volume management capabilities compared to older LVM implementations. It has been refined over time to support new features like thin provisioning and RAID levels. The command is now a standard utility on most Linux distributions with LVM support.

SEE ALSO

Copied to clipboard