Sync usage with man page.
[netbsd-mini2440.git] / external / gpl2 / lvm2 / dist / man / pvdisplay.8.in
blobefa3894e6ee89771479bd93063be8a69c7661d6f
1 .TH PVDISPLAY 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
2 .SH NAME
3 pvdisplay \- display attributes of a physical volume
4 .SH SYNOPSIS
5 .B pvdisplay
6 [\-c|\-\-colon]
7 [\-d|\-\-debug] [\-h|\-?|\-\-help]
8 [\-\-ignorelockingfailure]
9 [\-\-maps]
10 [\-\-nosuffix]
11 [\-s|\-\-short]
12 [\-\-units hsbkmgtHKMGT]
13 [\-v[v]|\-\-verbose [\-\-verbose]]
14 [\-\-version]
15 [PhysicalVolumePath [PhysicalVolumePath...]]
16 .br
18 .br
19 .B pvdisplay \-\-columns | \-C
20 [\-\-aligned]
21 [\-a|\-\-all]
22 [\-d|\-\-debug] [\-h|\-?|\-\-help]
23 [\-\-ignorelockingfailure]
24 [\-\-noheadings]
25 [\-\-nosuffix]
26 [\-o|\-\-options [+]Field[,Field]]
27 [\-O|\-\-sort [+|-]Key1[,[+|-]Key2[,...]]]
28 [\-\-separator Separator]
29 [\-\-unbuffered]
30 [\-\-units hHbBsSkKmMgGtTpPeE]
31 [\-v[v]|\-\-verbose [\-\-verbose]]
32 [\-\-version]
33 [PhysicalVolumePath [PhysicalVolumePath...]]
34 .SH DESCRIPTION
35 pvdisplay allows you to see the attributes of one or more physical volumes
36 like size, physical extent size, space used for the volume group descriptor
37 area and so on.
39 \fBpvs\fP (8) is an alternative that provides the same information 
40 in the style of \fBps\fP (1).
41 .SH OPTIONS
42 See \fBlvm\fP for common options and \fBpvs\fP for options given with
43 \fB\-\-columns\fP.
44 .TP
45 .I \-c, \-\-colon
46 Generate colon separated output for easier parsing in scripts or programs.
47 N.B. \fBpvs\fP (8) provides considerably more control over the output.
48 .nf
50 The values are:
52 * physical volume device name
53 * volume group name
54 * physical volume size in kilobytes
55 * internal physical volume number (obsolete)
56 * physical volume status
57 * physical volume (not) allocatable
58 * current number of logical volumes on this physical volume
59 * physical extent size in kilobytes
60 * total number of physical extents
61 * free number of physical extents
62 * allocated number of physical extents
64 .fi
65 .TP
66 .I \-s, \-\-short
67 Only display the size of the given physical volumes.
68 .TP
69 .I \-m, \-\-maps
70 Display the mapping of physical extents to logical volumes and
71 logical extents.
72 .TP
73 .I \-\-columns | \-C
74 Display output in columns, the equivalent of \fBpvs\fP (8).  See
75 \fBpvs (8)\fP for a description of other options with this form of
76 \fBpvdisplay\fP.
77 .SH SEE ALSO
78 .BR lvm (8),
79 .BR pvcreate (8),
80 .BR lvcreate (8),
81 .BR vgcreate (8)