「lvs(8)」-

  LINUX MANUAL PAGES

显示LV信息

命令语法格式

lvs [ option_args ] [ position_args ]

命令描述

命令lvs生成关于LV的格式化输出。

使用方法

lvs
[ -H|–history ]
[ -a|–all ]
[ -o|–options String ]
[ -S|–select String ]
[ -O|–sort String ]
[ –segments ]
[ –aligned ]
[ –binary ]
[ –configreport log|vg|lv|pv|pvseg|seg ]
[ –foreign ]
[ –ignorelockingfailure ]
[ –ignoreskippedcluster ]
[ –logonly ]
[ –nameprefixes ]
[ –noheadings ]
[ –nolocking ]
[ –nosuffix ]
[ –readonly ]
[ –reportformat basic|json ]
[ –rows ]
[ –separator String ]
[ –shared ]
[ –trustcache ]
[ –unbuffered ]
[ –units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
[ –unquoted ]
[ COMMON_OPTIONS ]
[ VG|LV|Tag … ]

命令支持的选项及含义

–aligned
与–separator一起使用,以对齐输出列。

–separator String
用于分隔每列的字符串。使用grep处理输出时很有用。

-a|–all
显示有关内部LV的信息。 这些是正常LV的组件,例如镜像,它们不是可独立访问的,例如, 不可安装。

–binary
使用二进制值“0”或“1”,以此代替具有两个有效值的列的描述性文字值(不计算“unknown”值,其表示无法确定该值)。

–configreport log|vg|lv|pv|pvseg|seg
参考lvmreport(7)手册。

–foreign
报告/显示否则将被跳过的外部VG。 有关外部VG的更多信息,请参阅lvmsystemid(7)手册。

-H|–history
在输出中包含历史LV。(除非在启用lvm.conf中的metadata/record_lvs_history的情况下删除LV,否则此操作无效。)

–ignorelockingfailure
锁定失败后,允许命令在只读元数据操作下继续执行。

–ignoreskippedcluster
如果在没有集群锁定的情况下运行该命令,并且跳过了集群VG,则用于避免使用非零状态代码退出。

–logonly
抑制命令报告,并仅显示日志报告。

–nameprefixes
在输出中添加“LVM2_”前缀和字段名称。 与–noheadings一起时有用,以生成可用于设置环境变量的field=value的列表(例如,在udev规则中)。

–unquoted
与–nameprefixes一起使用时,不会引用field=value对中的输出值。

–noheadings
抑制标题行,通常是第一行输出。使用grep处理输出时很有用。

–nolocking
禁用锁定。

–nosuffix
抑制输出大小的后缀。 如果处理输出,请使用–units(h和H除外)。

-o|–options String
以逗号分隔的有序列表,用于在列中显示。参数String的语法为:[+|-|#]Field1[,Field2 ...]。前缀”+“将指定的字段附加到默认字段中,”-“将从默认字段中删除指定的字段,”#“将压缩指定的字段 (在所有行为空时删除它们。)。使用-o help查看所有可用字段的列表。 通过重复-o选项使用单独的字段列表来添加、删除、压缩:-o+field1,field2 -o-field3,field4 -o#field5。 这些列表从左到右进行评估。 使用字段名称lv_all查看所有LV字段;vg_all所有VG字段;pv_all所有PV字段;pvseg_all所有PV段字段;seg_all所有LV段字段;pvseg_all所有PV段列。 有关更多配置选项,请参阅lvm.conf报告部分。 有关报告的更多信息,请参阅lvmreport(7)。

–readonly
以特殊的只读模式运行该命令,该模式将读取磁盘元数据,而无需进行任何锁定。 这可用于在虚拟机运行时查看虚拟机映像使用的内部元数据。 当未配置集群锁定或正在运行时,它还可用于查看集群VG的元数据。 不会尝试与device-mapper内核驱动程序通信,因此该选项无法报告LV是否实际在使用中。

–reportformat basic|json
覆盖报告的当前输出格式,该格式由lvm.conf中的report/output_format设置全局定义。其中:

  • basic是包含列和行的原始格式。 如果每个命令有多个报告,则每个报告都以报告名称为前缀进行标识。
  • json以JSON格式生成报告输出。

有关更多信息,请参阅lvmreport(7)。

–rows
将列以行的形式进行输出。

–segments
使用强调段信息的默认列。

-S|–select String
根据指定的条件,选择要处理和报告的对象。标准语法由–select help和lvmreport(7)描述。 对于报告命令,将为符合条件的每个对象显示一行。 有关可选对象字段,请参阅--options help。 可以使用附加的“selected”字段(-o selected)显示行,如果行与选择匹配则显示”1“,否则显示”0“。 对于处理LVM实体的非报告命令,该选择用于选择要处理的项目。

–shared
在主机上未使用lvmlockd时,报告/显示将跳过的共享VG。 有关共享VG的更多信息,请参阅lvmlockd(8)。

-O|–sort String
以逗号分隔的有序的要被排序的列表。 替换默认选择。 在任何列前面添加”-“对该列进行反向排序。

–trustcache
在命令处理期间避免某些设备扫描。 不使用。

–unbuffered
立即生成输出,无需正确排序或对齐列。

–units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
所有尺寸都以这些单位输出:human-(r)eadable且带有'<‘四舍五入指示,(h)uman-readable,(b)ytes,(s)ectors,(k)ilobytes,(m)egabytes,(g )igabytes,(t)erabytes,(p)etabytes,(e)xabytes。

大写使用1000的倍数(S.I.),而不是1024。可以指定自定义单位,例如--units 3M

在LVM中的公共选项

–driverloaded y|n
如果设置为no,则该命令不会尝试使用device-mapper。该选项用于测试和调试。

–profile String
选项–commandprofile或–metadataprofile的别名,具体取决于命令。

–commandprofile String
配置命令的命令配置文件。 有关配置文件的更多信息,请参阅lvm.conf(5)。

–config String
配置命令的设置。这些覆盖lvm.conf设置。参数String使用与lvm.conf相同的格式,或者可以使用section/field形式的语法。有关配置的更多信息,请参阅lvm.conf(5)。

-t|–test
在测试模式下运行。命令不会更新元数据。 这是通过禁用所有元数据写入,但仍然将成功返回到调用函数来实现的。 如果工具依赖于读回它认为已更改但尚未更改的元数据,则可能会在多阶段操作中导致异常错误消息。

-y|–yes
不要以交互方式提示确认,但总是假设答案是”yes“。 使用时要格外小心。 (对于自动回复”no“,请参阅-qq。)

-d|–debug …
设置调试级别。重复1到6次可以增加发送到日志文件或syslog(如果已配置)的消息的细节。

-q|–quiet …
抑制输出和日志消息。 覆盖–debug和–verbose选项。 重复一次会通过响应“no”来抑制任何提示。

-v|–verbose …
设置详细级别。 重复1到4次可以增加发送到标准输出和标准错误的消息的细节。

-h|–help
显示帮助信息。

–longhelp
显示很长的帮助信息,然后退出。

–version
显示版本信息。

变量

VG
卷组名。参考lvm(8)手册。

LV
逻辑卷名称。 有效名称请参见lvm(8)。 LV位置arg通常包括VG名称和LV名称,例如,VG/LV。

Tag
标签名。 有关标签名称和使用标签代替VG、LV、PV的信息,请参阅lvm(8)。

String
有关字符串内容的信息,请参阅选项说明。

Size[UNIT]
Size是接受可选单位的输入数字。不要与输出控制–units混淆,输出控制中大写字母表示1000的倍数。无论大小写如何,输入单位始终被视为基数两个值,例如 ‘k’和’K’都指1024。默认输入单位由字母指定,后跟”|UNIT“。 UNIT代表其他可能的输入单元:bBsSkKmMgGtTpPeE。 b|B是字节,s|S是512字节的扇区,k|K是千字节,m|M是兆字节,g|G是千兆字节,t|T是太字节,p|P是petabytes,e|E是exabytes。

相关环境变量

有关lvm使用的环境变量的信息,请参阅lvm(8)。例如,LVM_VG_NAME通常可以替换所需的VG参数。

注意事项

列lv_attr的位如下:

1 Volume type: (C)ache, (m)irrored, (M)irrored without initial sync, (o)rigin, (O)rigin with merging snapshot, (r)aid, (R)aid without

initial sync, (s)napshot, merging (S)napshot, (p)vmove, (v)irtual, mirror or raid (i)mage, mirror or raid (I)mage out-of-sync, mir‐

ror (l)og device, under (c)onversion, thin (V)olume, (t)hin pool, (T)hin pool data, raid or pool m(e)tadata or pool metadata spare.

2 Permissions: (w)riteable, (r)ead-only, (R)ead-only activation of non-read-only volume

3 Allocation policy: (a)nywhere, (c)ontiguous, (i)nherited, c(l)ing, (n)ormal This is capitalised if the volume is currently locked

against allocation changes, for example during pvmove(8).

4 fixed (m)inor

5 State: (a)ctive, (h)istorical, (s)uspended, (I)nvalid snapshot, invalid (S)uspended snapshot, snapshot (m)erge failed, suspended

snapshot (M)erge failed, mapped (d)evice present without tables, mapped device present with (i)nactive table, thin-pool (c)heck

needed, suspended thin-pool (C)heck needed, (X) unknown

6 device (o)pen, (X) unknown

7 Target type: (C)ache, (m)irror, (r)aid, (s)napshot, (t)hin, (u)nknown, (v)irtual. This groups logical volumes related to the same

kernel target together. So, for example, mirror images, mirror logs as well as mirrors themselves appear as (m) if they use the

original device-mapper mirror kernel driver; whereas the raid equivalents using the md raid kernel driver all appear as (r). Snap‐

shots using the original device-mapper driver appear as (s); whereas snapshots of thin volumes using the new thin provisioning

driver appear as (t).

8 Newly-allocated data blocks are overwritten with blocks of (z)eroes before use.

9 Volume Health, where there are currently three groups of attributes identified:

Common ones for all Logical Volumes: (p)artial, (X) unknown.

(p)artial signifies that one or more of the Physical Volumes this Logical Volume uses is missing from the system. (X) unknown sig‐

nifies the status is unknown.

Related to RAID Logical Volumes: (r)efresh needed, (m)ismatches exist, (w)ritemostly.

(r)efresh signifies that one or more of the Physical Volumes this RAID Logical Volume uses had suffered a write error. The write

error could be due to a temporary failure of that Physical Volume or an indication that it is failing. The device should be

refreshed or replaced. (m)ismatches signifies that the RAID logical volume has portions of the array that are not coherent. Incon‐

sistencies are detected by initiating a “check” on a RAID logical volume. (The scrubbing operations, “check” and “repair”, can be

performed on a RAID logical volume via the ‘lvchange’ command.) (w)ritemostly signifies the devices in a RAID 1 logical volume

that have been marked write-mostly. (R)emove after reshape signifies freed striped raid images to be removed.

Related to Thin pool Logical Volumes: (F)ailed, out of (D)ata space, (M)etadata read only.

(F)ailed is set if thin pool encounters serious failures and hence no further I/O is permitted at all. The out of (D)ata space is

set if thin pool has run out of data space. (M)etadata read only signifies that thin pool encounters certain types of failures but

it’s still possible to do reads at least, but no metadata changes are allowed.

Related to Thin Logical Volumes: (F)ailed.

(F)ailed is set when related thin pool enters Failed state and no further I/O is permitted at all.

10 s(k)ip activation: this volume is flagged to be skipped during activation.

含义如上所述,括号中的值为在输出中显示的位。

相关手册

lvm(8) lvm.conf(5) lvmconfig(8)

pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8) pvresize(8) pvs(8) pvscan(8)

vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgconvert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimportclone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8) vgs(8) vgscan(8) vgsplit(8)

lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvreduce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)

lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeactivate(8) lvmdump(8)

dmeventd(8) lvmetad(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8) cmirrord(8) lvmdbusd(8)

lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)

参考文献

  • man 8 lvs, Version 2.02.176-4.1

更新日志

  • 08/31/2018 创建文章