「vgs(8)」-

  LINUX MANUAL PAGES

显示VG的信息

命令语法格式

vgs [ option_args ] [ position_args ]

vgs [ –all ] [ –options String ] [ –select String ] [ –sort String ] [ –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 unit] [ –unquoted ] [ COMMON_OPTIONS ] [ VG|Tag … ]

命令描述

命令vgs生成关于VG输出信息,这些信息被格式化显示。

命令支持的选项及含义

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

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

-a|–all
显示所有的VG。等同于不指定任何VG。

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

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

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

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

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

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

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

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

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

–nolocking
禁用锁定。

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

-o|–options String
以逗号分隔的有序列表,用于在列中b显示。参数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
将列以行的形式进行输出。

-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)手册。

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参数。

注意事项

以下是vg_attr位:

1 Permissions: (w)riteable, (r)ead-only

2 Resi(z)eable

3 E(x)ported

4 (p)artial: one or more physical volumes belonging to the volume group are missing from the system

5 Allocation policy: (c)ontiguous, c(l)ing, (n)ormal, (a)nywhere

6 (c)lustered, (s)hared

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

相关手册

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 vgs, Version 2.02.176-4.1

更新日志

  • 08/31/2018 创建文章