显示LV的信息
命令语法格式
lvdisplay [ option_args ] [ position_args ]
[ -c|–colon ]
[ -C|–columns ]
[ -H|–history ]
[ -m|–maps ]
[ -o|–options String ]
[ -O|–sort String ]
[ -S|–select String ]
[ –aligned ]
[ –binary ]
[ –configreport log|vg|lv|pv|pvseg|seg ]
[ –foreign ]
[ –ignorelockingfailure ]
[ –ignoreskippedcluster ]
[ –logonly ]
[ –noheadings ]
[ –nosuffix ]
[ –readonly ]
[ –reportformat basic|json ]
[ –segments ]
[ –separator String ]
[ –shared ]
[ –unbuffered ]
[ –units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
[ COMMON_OPTIONS ]
[ VG|LV|Tag … ]
命令描述
命令lvdisplay显示LV的属性,如大小,读/写状态,快照信息等。
命令lvs(8)是使用更紧凑和可配置的输出格式显示相同信息和更多信息的优选替代方案。
命令支持的选项及含义
–aligned
与–separator一起使用,以使输出列对齐。
-a|–all
显示有关内部LV的信息。 这些是普通LV的组件,比如镜像,它们不是可独立访问的,例如,不可挂载。
–binary
使用二进制值“0”或“1”代替具有两个有效值的列的描述性文字值(不计算“unknown”值,表示无法确定该值)。
-c|–colon
生成冒号分隔输出,以便在脚本或程序中更容易解析。 另见vgs(8),它提供了对输出的更多控制。
-C|–columns
以列显示输出,相当于vgs(8)。 列出的选项与vgs(8)中给出的选项相同。
–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
抑制命令报告,并仅显示日志报告。
-m|–maps
显示LE到PV和PE的映射。 要将PE映射到LE,请使用:pvs --segments -o+lv_name,seg_start_pe,segtype
–noheadings
抑制标题行,通常是第一行输出。在grep输出时很有用。
–nosuffix
抑制输出大小的后缀。 如果处理输出,请使用–units(h和H除外)
-o|–options String
以逗号分隔的有序列表,用于指定显示的列。参数Stirng的语法为:[+|-|#] 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段列。
–readonly
以特殊的只读模式运行该命令,该模式将读取磁盘元数据,而无需进行任何锁定。 这可用于在虚拟机运行时查看虚拟机映像使用的内部元数据。当未配置或运行集群锁定时,它还可用于查看集群VG的元数据。 不会尝试与device-mapper内核驱动程序通信,因此该选项无法报告LV是否实际在使用中。
–reportformat basic|json
覆盖报告的当前输出格式,该格式由lvm.conf中的report/output_format设置全局定义。basic是包含列和行的原始格式。 如果每个命令有多个报告,则每个报告都以报告名称为前缀进行标识。 json以JSON格式生成报告输出。 有关更多信息,请参阅lvmreport(7)。
–segments
???
-S|–select String
根据指定的条件选择要处理和报告的对象。 标准语法由–select help和lvmreport(7)描述。 对于报告命令,将为符合条件的每个对象显示一行。 有关可选对象字段,请参阅–options help。 可以使用附加的“selected”字段(-o选中)显示行,如果行与选择匹配则显示1,否则显示0。 对于处理LVM实体的非报告命令,该选择用于选择要处理的项目。
–separator String
使用String分隔每列。在grep输出时很有用。
–shared
报告/显示在主机上没有使用lvmlockd时将跳过的共享VG。 有关共享VG的更多信息,请参阅lvmlockd(8)。
-O|–sort String
以逗号分隔的有序排序列表。 替换默认选择。 在任何列前面“-”对该列进行反向排序。
–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 with ‘<‘ rounding indicator, (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的公共选项
-y|–yes
不要以交互方式提示确认,但总是假设答案是肯定的。 使用时要格外小心。 (对于自动no,请参阅-qq。)
-v|–verbose …
设置详细级别。 重复1到4次以增加发送到标准输出和标准错误的消息的详细信息。
-t|–test
在测试模式下运行。 命令不会更新元数据。 这是通过禁用所有元数据写入,但仍然将成功返回到调用函数来实现的。 如果工具依赖于读回它认为已更改但尚未更改的元数据,则可能会在多阶段操作中导致异常错误消息。
-q|–quiet …
抑制输出和日志消息。 覆盖–debug和–verbose。 重复一次也可以通过回答“no”来抑制任何提示。
-h|–help
显示帮助信息。
-d|–debug …
设置调试级别。 重复1到6次以增加发送到日志文件和/或syslog(如果已配置)的消息的详细信息。
–version
显示版本信息并退出。
–profile String
选项–commandprofile或–metadataprofile的别名,具体取决于命令。
–longhelp
显示长帮助文本。
–driverloaded y|n
如果设置为no,则该命令不会尝试使用device-mapper。 用于测试和调试。
–config String
配置命令的设置。 这些覆盖lvm.conf设置。参数String使用与lvm.conf相同的格式,或者可以使用section/field语法。 有关config的更多信息,请参阅lvm.conf(5)。
–commandprofile String
用于命令配置的命令配置文件。 有关配置文件的更多信息,请参阅lvm.conf(5)。
命令行参数
VG
VG的名称。关于有效的VG名参考lvm(8)手册。
LV
逻辑卷名称。 有效名称请参见lvm(8)。 LV位置参数通常包括VG名和LV名,例如,VG/LV。
Tag
标签名称。 有关标签名称和使用标签代替VG,LV,PV的信息,请参阅lvm(8)。
String
有关String的内容的信息,请参阅选项说明。
Size[UNIT]
参数Size是接受可选单位UNIT的输入数字。 无论大小写如何,输入单位UNIT始终被视为基数两个值,例如 ‘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。 (这不应该与输出控制–units混淆,大写字母表示1000的倍数。)
相关环境变量
有关lvm使用的环境变量的信息,请参阅lvm(8)。 例如,LVM_VG_NAME通常可以替换所需的VG参数。
相关手册
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 lvdisplay, Version 2.02.176-4.1
更新日志
- 12/05/2018 创建文章