LVM(FULLREPORT)

📦
version 2.03.44 · 14 versions
, in arch rolling

💖 LVM(FULLREPORT) 💖

okay so bestie, welcome to the manual page for lvm fullreport — brought to you by Red Hat, Inc. 🎀 this is the part 1 of the glow-up, more is coming, stay with me ✨

✨ NAME ✨

lvm fullreport — Display full report 👑

🌸 SYNOPSIS 🌸

lvm fullreport
       [ option_args ]
       [ position_args ]

🦋 DESCRIPTION 🦋

so lvm fullreport gives you formatted output about PVs, PV segments, VGs, LVs and LV segments. all of it. together. at once. 💅

and here's the slay part: the info is all gathered together for each VG (under a per-VG lock 🔒) so it's actually consistent. no cap.

because like… if you gather that same info from separate calls to vgs, pvs, and lvs? it can be inconsistent if things change between commands 😭 the vibes get messy. so don't do that. do this instead.

⭐ USAGE ⭐

lvm fullreport
       [ -a|--all ]
       [ -o|--options String ]
       [ -O|--sort String ]
       [ -S|--select String ]
       [ --aligned ]
       [ --binary ]
       [ --configreport log|vg|lv|pv|pvseg|seg ]
       [ --foreign ]
       [ --headings none|abbrev|full|0|1|2 ]
       [ --ignorelockingfailure ]
       [ --logonly ]
       [ --nameprefixes ]
       [ --noheadings ]
       [ --nosuffix ]
       [ --readonly ]
       [ --reportformat basic|json|json_std ]
       [ --rows ]
       [ --separator String ]
       [ --shared ]
       [ --unbuffered ]
       [ --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
       [ --unquoted ]
       [ COMMON_OPTIONS ]
       [ VG ... ]

and then, the common options for lvm, the shared besties that show up everywhere 🫶

Common options for lvm:
       [ -d|--debug ... ]
       [ -h|--help ]
       [ -q|--quiet ... ]
       [ -t|--test ]
       [ -v|--verbose ... ]
       [ -y|--yes ]
       [ --commandprofile String ]
       [ --config String ]
       [ --devices PV ]
       [ --devicesfile String ]
       [ --driverloaded y|n ]
       [ --journal String ]
       [ --lockopt String ]
       [ --longhelp ]
       [ --nohints ]
       [ --nolocking ]
       [ --profile String ]
       [ --version ]

💅 OPTIONS 💅

so many little flags, all iconic, let's go through every single one together 🍓

  • --aligned — use it with --separator and it lines your output columns up all neat and pretty ✨
  • -a, --all — this one does a LOT, okay:
    • show info about internal LVs. these are the components of normal LVs — mirrors and such — that you can't access independently, like, you literally can't mount them. 🙈
    • list all VGs. this is equivalent to not specifying any VGs at all.
    • show info about devices that haven't been initialized by LVM, i.e. they are not PVs.
  • --binary — for columns that have exactly two valid values, report binary values "0" or "1" instead of the descriptive literal values. (not counting the "unknown" value, which means the value couldn't be determined — that one stays weird, bestie 💀)
  • --commandprofile String — the command profile to use for command configuration. see lvm.conf(5) for more about profiles 👑
  • --config String — config settings for the command. these override the lvm.conf(5) settings. the String arg uses the same format as lvm.conf(5), or it can use section/field syntax. see lvm.conf(5) for more about config 🌈
  • --configreport log|vg|lv|pv|pvseg|seg — see lvmreport(7). that's the whole vibe on this one ✨
  • -d, --debug ... — set the debug level. repeat it anywhere from 1 to 6 times to crank up the detail of messages sent to the log file and/or syslog (if configured) 🔥
  • --devices PV — restricts which devices are visible and accessible to the command. devices not listed will appear to be missing 😭 this option can be repeated, or it accepts a comma-separated list of devices. it overrides the devices file. periodt.
  • --devicesfile String — a file listing devices that LVM should use. the file must exist in /etc/lvm/devices/ and is managed with the lvmdevices(8) command. this overrides the lvm.conf(5) devices/devicesfile and devices/use_devicesfile settings.
  • --driverloaded y|n — if you set it to no, the command will not attempt to use device-mapper. for testing and debugging 🧚
  • --foreign — report/display foreign VGs that would otherwise be skipped. see lvmsystemid(7) for more about foreign VGs 👑
  • --headings none|abbrev|full|0|1|2 — the type of headings to use in report output:
    • none or 0: no headings, at all, zero
    • abbrev or 1: column name abbreviations
    • full or 2: full column names
  • -h, --help — display help text 🫶
  • --ignorelockingfailure — lets a command keep going with read-only metadata operations after locking failures. (yes bestie, it just… keeps going 💀)
  • --journal String — record information in the systemd journal. this info is in addition to whatever the lvm.conf log/journal setting already enables:
    • command: record information about the command
    • output: record the default command output
    • debug: record full command debugging
  • --lockopt String — used to pass options for special cases to lvmlockd. see lvmlockd(8) for more information 🔒
  • --logonly — suppress the command report and display only the log report.
  • --longhelp — display long help text. the long one. the extended cut 💅
  • --nameprefixes — add an "LVM2_" prefix plus the field name to the output. useful with --noheadings to produce a list of field=value pairs that can be used to set environment variables (for example, in udev rules) ✨
  • --noheadings — suppress the headings line that's normally the first line of output. super useful if you're grepping the output 🔍
  • --nohints — do not use the hints file to locate devices for PVs. a command may read more devices to find PVs when hints aren't used. the command will still perform standard hint file invalidation where appropriate. it's giving responsible 🌸
  • --nolocking — disable locking. use with caution — concurrent commands may produce incorrect results 😭 don't say we didn't warn you.
  • --nosuffix — suppress the suffix on output sizes. use with --units (except h and H) if you're processing the output 🎀
  • -o, --options String — comma-separated, ordered list of fields to display in columns. the String arg syntax is: [+|-|#]Field1[,Field2 ...]
    • the prefix + will append the specified fields to the default fields
    • - will remove the specified fields from the default fields
    • # will compact the specified fields (removing them when empty for all rows)
    • use -o help to view the list of all available fields 👀
    • use separate lists of fields to add, remove or compact by repeating the -o option: -o+field1,field2 -o-field3,field4 -o#field5. these lists are evaluated from left to right.
    • use field name lv_all to view all LV fields, vg_all all VG fields, pv_all all PV fields, seg_all all LV segment fields, and pvseg_all all PV segment fields.
    • see the lvm.conf(5) report section for more config options. see lvmreport(7) for more information about reporting 📊
  • --profile String — an alias for --commandprofile or --metadataprofile, depending on the command. iykyk 💅
  • -q, --quiet ... — suppress output and log messages. overrides --debug and --verbose. repeat it once to also suppress any prompts with answer 'no' 🤫
  • --readonly — prevent the command from making changes, including activation and metadata updates. (see --permission r for read only LVs.) 🔒
  • --reportformat basic|json|json_std — overrides the current output format for reports, which is defined globally by the report/output_format setting in lvm.conf(5).
    • basic is the original format with columns and rows. if there's more than one report per command, each report is prefixed with the report name for identification.
    • json produces report output in JSON format.
    • json_std produces report output in JSON format which is more compliant with the JSON standard. ✨
    • see lvmreport(7) for more information.
  • --rows — output columns as rows. yes, it just flips the whole thing sideways, and honestly? iconic 🔄
  • -S, --select String — select objects for processing and reporting based on specified criteria. the criteria syntax is described by --select help and lvmreport(7). for reporting commands, one row is displayed for each object matching the criteria. see --options help for selectable object fields. rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. for non-reporting commands which process LVM entities, the selection is used to choose items to process 🎯
  • --separator String — the string to use to separate each column. useful if you're grepping the output 🍓
  • --shared — report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. see lvmlockd(8) for more about shared VGs 🔗
  • -O, --sort String — comma-separated ordered list of columns to sort by. replaces the default selection. precede any column with - for a reverse sort on that column ⬇️
  • -t, --test — run in test mode. commands will not update metadata. this is implemented by disabling all metadata writing but nevertheless returning success to the calling function. this may lead to unusual error messages in multi-stage operations if a tool relies on reading back metadata it believes has changed but hasn't 😭 so like… test mode lies a little. be aware.
  • --unbuffered — produce output immediately without sorting or aligning the columns properly. chaos mode, no alignment, raw vibes 💀
  • --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E — all sizes are output in these units:
    • human-(r)eadable with '<' rounding indicator
    • (h)uman-readable
    • (b)ytes
    • (s)ectors
    • (k)ilobytes
    • (m)egabytes
    • (g)igabytes
    • (t)erabytes
    • (p)etabytes
    • (e)xabytes
    • capitalise to use multiples of 1000 (S.I.) instead of 1024
    • custom units can be specified, e.g. --units 3M ✨
  • --unquoted — when used with --nameprefixes, output values in the field=value pairs are not quoted.
  • -v, --verbose ... — set verbose level. repeat from 1 to 4 times to increase the detail of messages sent to stdout and stderr 📢
  • --version — display version information 👑
  • -y, --yes — do not prompt for confirmation interactively but always assume the answer is yes. use with extreme caution 🚨 (for automatic no, see -qq.)

💖 VARIABLES 💖

okay so these are the lil placeholder-y variables that can show up all over the tool's options, and you need to know what they mean or nothing makes sense, bestie 🫶

  • VG — a Volume Group name. that's it, that's the whole thing. if you wanna know what counts as a valid name, go read lvm(8), it's giving "the rules live over there" ✨
  • String — literally just a string, no cap. the actual tea on what content is allowed lives in the description of whichever option is using it, so go read that option's blurb 📖
  • Size[UNIT] — the iconic one. Size is an input number and the [UNIT] bit is optional, so you can leave it off and be fine 💅
important!! input units are always treated as base two values, no matter how you capitalize them. like, k and K both mean 1024. capital letters do NOT secretly switch you to decimal over here, periodt 🚫

the default input unit is the one shown there by its letter, followed by |UNIT. and UNIT is just the menu of other units you're allowed to type in:

  • b|B — bytes
  • s|S — sectors of 512 bytes
  • k|K — KiB
  • m|M — MiB
  • g|G — GiB
  • t|T — TiB
  • p|P — PiB
  • e|E — EiB
⚠️ don't get this confused with the output control --units, okay?? over there capital letters mean multiple of 1000. different vibe, different rules, do not mix them up 😭

🌸 ENVIRONMENT VARIABLES 🌸

the environment variables that lvm cares about are all documented in lvm(8), so that's your reading assignment 📚

for example — and this one is a genuine lifesaver — LVM_VG_NAME can generally be swapped in for a VG parameter whenever one is required. so instead of typing the volume group name over and over, you just set it once and let the environment carry you 🧚✨

⭐ SEE ALSO ⭐

the whole friend group, in order, no one left out 👑:

and that's a wrap on part 2, bestie!! 🎀 this whole page is from LVM TOOLS 2.03.44(2), dated 2026-10-27, living its best life in section 8 of the manual, filed under LVM(FULLREPORT) 💖 go forth and read your volume groups, you absolute icon 🌈👑

📦 where this page comes from