From 0fad9eaee43ae35170f3234bb8f5bf848c36a6ef Mon Sep 17 00:00:00 2001 From: Dave Wysochanski Date: Mon, 15 Jun 2009 17:09:32 +0000 Subject: [PATCH] Cleanup pvs, vgs, and lvs "-o" section in man pages (rhbz 500861). MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit http://bugzilla.redhat.com/show_bug.cgi?id=500861 - Update list of fields/columns for each command (a few missing). - Update list order to match "-o help" output (easier to verify field list) - Add "{pv|vg|lv}_all" description. - Move "-o help" sentence above column/field list. New sample man page for lvs (pvs and vgs are similar): -o, --options Comma-separated ordered list of columns. Precede the list with ’+’ to append to the default selection of columns instead of replacing it. Use -o lv_all to select all logical volume columns, and -o seg_all to select all logical segment columns. Use -o help to view the full list of columns available. Column names include: lv_uuid, lv_name, lv_attr, lv_major, lv_minor, lv_read_ahead, lv_kernel_major, lv_kernel_minor, lv_kernel_read_ahead, lv_size, seg_count, origin, ori- gin_size, snap_percent, copy_percent, move_pv, convert_lv, lv_tags, mirror_log, modules, segtype, stripes, stripesize, regionsize, chunksize, seg_start, seg_start_pe, seg_size, seg_tags, seg_pe_ranges, devices. With --segments, any "seg_" prefixes are optional; otherwise any "lv_" prefixes are optional. Columns mentioned in vgs (8) can also be chosen. The lv_attr bits are: --- man/lvs.8.in | 20 ++++++++++++-------- man/pvs.8.in | 16 +++++++++++----- man/vgs.8.in | 16 +++++++++++----- 3 files changed, 34 insertions(+), 18 deletions(-) diff --git a/man/lvs.8.in b/man/lvs.8.in index a053e2cea..644caf800 100644 --- a/man/lvs.8.in +++ b/man/lvs.8.in @@ -36,18 +36,22 @@ if processing the output. .TP .I \-o, \-\-options Comma-separated ordered list of columns. Precede the list with '+' to append -to the default selection of columns instead of replacing it. Column names are: -lv_uuid, lv_name, lv_attr, lv_major, lv_minor, lv_kernel_major, lv_kernel_minor, -lv_size, seg_count, origin, snap_percent, -copy_percent, move_pv, lv_tags, origin_size, -segtype, stripes, -stripesize, chunksize, seg_start, seg_size, seg_tags, devices, -regionsize, mirror_log, modules. +to the default selection of columns instead of replacing it. +.IP +Use \fb-o lv_all\fP to select all logical volume columns, and \fb-o seg_all\fP to select all +logical segment columns. +.IP +Use \fb-o help\fP to view the full list of columns available. +.IP +Column names include: +lv_uuid, lv_name, lv_attr, lv_major, lv_minor, lv_read_ahead, lv_kernel_major, lv_kernel_minor, +lv_kernel_read_ahead, lv_size, seg_count, origin, origin_size, snap_percent, copy_percent, move_pv, +convert_lv, lv_tags, mirror_log, modules, segtype, stripes, stripesize, regionsize, chunksize, seg_start, +seg_start_pe, seg_size, seg_tags, seg_pe_ranges, devices. .IP With \-\-segments, any "seg_" prefixes are optional; otherwise any "lv_" prefixes are optional. Columns mentioned in \fBvgs (8)\fP can also be chosen. -Use \fb-o help\fP to view the full list of fields available. .IP The lv_attr bits are: .RS diff --git a/man/pvs.8.in b/man/pvs.8.in index 4a667fcc2..5124f9790 100644 --- a/man/pvs.8.in +++ b/man/pvs.8.in @@ -36,14 +36,20 @@ if processing the output. .TP .I \-o, \-\-options Comma-separated ordered list of columns. Precede the list with '+' to append -to the default selection of columns. Column names are: pv_fmt, pv_uuid, -pv_size, dev_size, pv_free, pv_used, pv_name, pv_attr, pv_pe_count, -pv_pe_alloc_count, pv_tags, pvseg_start, pvseg_size, pe_start, -pv_mda_count, pv_mda_free, and pv_mda_size. +to the default selection of columns. +.IP +Use \fb-o pv_all\fP to select all physical volume columns, and \fb-o pvseg_all\fP +to select all physical segment columns. +.IP +Use \fb-o help\fP to view the full list of columns available. +.IP +Column names include: pv_fmt, pv_uuid, dev_size, pv_name, pv_mda_free, +pv_mda_size, pe_start, pv_size, pv_free, pv_used, pv_attr, pv_pe_count, +pv_pe_alloc_count, pv_tags, pv_mda_count, pvseg_start, and pvseg_size. +.IP With --segments, any "pvseg_" prefixes are optional; otherwise any "pv_" prefixes are optional. Columns mentioned in \fBvgs (8)\fP can also be chosen. The pv_attr bits are: (a)llocatable and e(x)ported. -Use \fb-o help\fP to view the full list of fields available. .TP .I \-\-segments Produces one line of output for each contiguous allocation of space on each diff --git a/man/vgs.8.in b/man/vgs.8.in index fa42f6fd5..7df9f285d 100644 --- a/man/vgs.8.in +++ b/man/vgs.8.in @@ -36,14 +36,20 @@ if processing the output. .TP .I \-o, \-\-options Comma-separated ordered list of columns. Precede the list with '+' to append -to the default selection of columns. Column names are: vg_fmt, vg_uuid, -vg_name, vg_attr, vg_size, vg_free, vg_sysid, vg_extent_size, vg_extent_count, -vg_free_count, max_lv, max_pv, pv_count, lv_count, snap_count, vg_seqno, -vg_tags, vg_mda_count, vg_mda_free, and vg_mda_size. +to the default selection of columns. +.IP +Use \fb-o vg_all\fP to select all volume group columns. +.IP +Use \fb-o help\fP to view the full list of columns available. +.IP +Column names include: vg_fmt, vg_uuid, vg_name, vg_attr, vg_size, vg_free, +vg_sysid, vg_extent_size, vg_extent_count, vg_free_count, max_lv, max_pv, +pv_count, lv_count, snap_count, vg_seqno, vg_tags, vg_mda_count, vg_mda_free, +and vg_mda_size. +.IP Any "vg_" prefixes are optional. Columns mentioned in either \fBpvs (8)\fP or \fBlvs (8)\fP can also be chosen, but columns cannot be taken from both at the same time. -Use \fb-o help\fP to view the full list of fields available. .IP The vg_attr bits are: .RS -- 2.43.5