~serge-hallyn/ubuntu/raring/libvirt/libvirt-hugepages

« back to all changes in this revision

Viewing changes to tools/virt-host-validate.1

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-05-13 15:44:12 UTC
  • mfrom: (1.2.13)
  • Revision ID: package-import@ubuntu.com-20120513154412-fgmn5sxqdzgnzlx3
Tags: 0.9.12-0ubuntu1
* New upstream version:
  * Synchronize with debian packaging:
    - debian/control: Update build depends.
    - debian/libvirt-bin.postrm: Cleanup /var/log/libvirt
      on purge.
    - Bump standards verson (no changes).
    - debian/patches/Don-t-fail-if-we-can-t-setup-avahi.patch: Added
  * Dropped patches:
    - debian/patches/Debianize-libvirt-guests.patch
    - debian/patches/rewrite-lxc-controller-eof-handling-yet-again
    - debian/patches/ubuntu/libnl13.patch
    - debian/patches/ubuntu/fix-lxc-startup-error.patch
    - debian/patches/ubuntu/fix-bridge-fd.patch
    - debian/patches/ubuntu/skip-labelling-network-disks.patch
    - debian/patches/ubuntu/xen-xend-shutdown-detection.patch
    - debian/patches/ubuntu/xen-config-no-vfb-for-hvm.patch
    - debian/patches/debian/Disable-daemon-start-test.patch
    - debian/patches/debian/Disable-gnulib-s-test-nonplocking-pipe.sh.patch
    - debian/patches/ubuntu/9006-default-config-test-case.patch
    - debian/patches/fix-block-migration.patch
    - debian/patches/ubuntu/9022-qemu-unescape-HMP-commands-before-converting-them-to.patch
    - debian/patches/ubuntu/9023-qemu-change-rbd-auth_supported-separation-character-.patch
    - debian/patches/ubuntu/9024-qemu-allow-snapshotting-of-sheepdog-and-rbd-disks.patch
    - debian/patches/9025-qemu-change-rbd-auth_supported-separation-character-.patch
    - debian/patches/ubuntu/arm-gcc-workaround.patch
  * Rediffed:
    - debian/patches/Allow-libvirt-group-to-access-the-socket.patch
    - debian/patches/Disable-failing-virnetsockettest.patch
    - debian/patches/dnsmasq-as-priv-user
    - debian/patches/9002-better_default_uri_virsh.patch
  * debian/control: Add libnl-route-3-dev ass a build depends.
  * debian/patches/libnl3-build-fix.patch: Fix build with libnl3.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
 
2
.\"
 
3
.\" Standard preamble:
 
4
.\" ========================================================================
 
5
.de Sp \" Vertical space (when we can't use .PP)
 
6
.if t .sp .5v
 
7
.if n .sp
 
8
..
 
9
.de Vb \" Begin verbatim text
 
10
.ft CW
 
11
.nf
 
12
.ne \\$1
 
13
..
 
14
.de Ve \" End verbatim text
 
15
.ft R
 
16
.fi
 
17
..
 
18
.\" Set up some character translations and predefined strings.  \*(-- will
 
19
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
 
20
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
 
21
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
 
22
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
 
23
.\" nothing in troff, for use with C<>.
 
24
.tr \(*W-
 
25
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 
26
.ie n \{\
 
27
.    ds -- \(*W-
 
28
.    ds PI pi
 
29
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
 
30
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
 
31
.    ds L" ""
 
32
.    ds R" ""
 
33
.    ds C` ""
 
34
.    ds C' ""
 
35
'br\}
 
36
.el\{\
 
37
.    ds -- \|\(em\|
 
38
.    ds PI \(*p
 
39
.    ds L" ``
 
40
.    ds R" ''
 
41
'br\}
 
42
.\"
 
43
.\" Escape single quotes in literal strings from groff's Unicode transform.
 
44
.ie \n(.g .ds Aq \(aq
 
45
.el       .ds Aq '
 
46
.\"
 
47
.\" If the F register is turned on, we'll generate index entries on stderr for
 
48
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
 
49
.\" entries marked with X<> in POD.  Of course, you'll have to process the
 
50
.\" output yourself in some meaningful fashion.
 
51
.ie \nF \{\
 
52
.    de IX
 
53
.    tm Index:\\$1\t\\n%\t"\\$2"
 
54
..
 
55
.    nr % 0
 
56
.    rr F
 
57
.\}
 
58
.el \{\
 
59
.    de IX
 
60
..
 
61
.\}
 
62
.\"
 
63
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 
64
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 
65
.    \" fudge factors for nroff and troff
 
66
.if n \{\
 
67
.    ds #H 0
 
68
.    ds #V .8m
 
69
.    ds #F .3m
 
70
.    ds #[ \f1
 
71
.    ds #] \fP
 
72
.\}
 
73
.if t \{\
 
74
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 
75
.    ds #V .6m
 
76
.    ds #F 0
 
77
.    ds #[ \&
 
78
.    ds #] \&
 
79
.\}
 
80
.    \" simple accents for nroff and troff
 
81
.if n \{\
 
82
.    ds ' \&
 
83
.    ds ` \&
 
84
.    ds ^ \&
 
85
.    ds , \&
 
86
.    ds ~ ~
 
87
.    ds /
 
88
.\}
 
89
.if t \{\
 
90
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 
91
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 
92
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 
93
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 
94
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 
95
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 
96
.\}
 
97
.    \" troff and (daisy-wheel) nroff accents
 
98
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 
99
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 
100
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 
101
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 
102
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 
103
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 
104
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 
105
.ds ae a\h'-(\w'a'u*4/10)'e
 
106
.ds Ae A\h'-(\w'A'u*4/10)'E
 
107
.    \" corrections for vroff
 
108
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 
109
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 
110
.    \" for low resolution devices (crt and lpr)
 
111
.if \n(.H>23 .if \n(.V>19 \
 
112
\{\
 
113
.    ds : e
 
114
.    ds 8 ss
 
115
.    ds o a
 
116
.    ds d- d\h'-1'\(ga
 
117
.    ds D- D\h'-1'\(hy
 
118
.    ds th \o'bp'
 
119
.    ds Th \o'LP'
 
120
.    ds ae ae
 
121
.    ds Ae AE
 
122
.\}
 
123
.rm #[ #] #H #V #F C
 
124
.\" ========================================================================
 
125
.\"
 
126
.IX Title "VIRT-HOST-VALIDATE.C 1"
 
127
.TH VIRT-HOST-VALIDATE.C 1 "2012-02-03" "libvirt-0.9.9" "Virtualization Support"
 
128
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 
129
.\" way too many mistakes in technical documents.
 
130
.if n .ad l
 
131
.nh
 
132
.SH "NAME"
 
133
.Vb 1
 
134
\&  virt\-host\-validate \- validate host virtualization setup
 
135
.Ve
 
136
.SH "SYNOPSIS"
 
137
.IX Header "SYNOPSIS"
 
138
.Vb 1
 
139
\&  virt\-host\-validate [OPTIONS...] [HV\-TYPE]
 
140
.Ve
 
141
.SH "DESCRIPTION"
 
142
.IX Header "DESCRIPTION"
 
143
This tool validates that the host is configured in a suitable
 
144
way to run libvirt hypervisor drivers. If invoked without any
 
145
arguments it will check support for all hypervisor drivers it
 
146
is aware of. Optionally it can be given a particular hypervisor
 
147
type ('qemu' or 'lxc') to restrict the checks to those relevant
 
148
for that virtualization technology
 
149
.SH "OPTIONS"
 
150
.IX Header "OPTIONS"
 
151
.ie n .IP """\-v"", ""\-\-version""" 4
 
152
.el .IP "\f(CW\-v\fR, \f(CW\-\-version\fR" 4
 
153
.IX Item "-v, --version"
 
154
Display the command version
 
155
.ie n .IP """\-h"", ""\-\-help""" 4
 
156
.el .IP "\f(CW\-h\fR, \f(CW\-\-help\fR" 4
 
157
.IX Item "-h, --help"
 
158
Display the command line help
 
159
.ie n .IP """\-q"", ""\-\-quiet""" 4
 
160
.el .IP "\f(CW\-q\fR, \f(CW\-\-quiet\fR" 4
 
161
.IX Item "-q, --quiet"
 
162
Don't display details of individual checks being performed.
 
163
Only display output if a check does not pass.
 
164
.SH "EXIT STATUS"
 
165
.IX Header "EXIT STATUS"
 
166
Upon successful validation, an exit status of 0 will be set. Upon
 
167
failure a non-zero status will be set.
 
168
.SH "AUTHOR"
 
169
.IX Header "AUTHOR"
 
170
Daniel P. Berrange
 
171
.SH "BUGS"
 
172
.IX Header "BUGS"
 
173
Report any bugs discovered to the libvirt community via the
 
174
mailing list \f(CW\*(C`http://libvirt.org/contact.html\*(C'\fR or bug tracker \f(CW\*(C`http://libvirt.org/bugs.html\*(C'\fR.
 
175
Alternatively report bugs to your software distributor / vendor.
 
176
.SH "COPYRIGHT"
 
177
.IX Header "COPYRIGHT"
 
178
Copyright (C) 2012 by Red Hat, Inc.
 
179
.SH "LICENSE"
 
180
.IX Header "LICENSE"
 
181
virt-host-validate is distributed under the terms of the \s-1GNU\s0 \s-1GPL\s0 v2+.
 
182
This is free software; see the source for copying conditions. There
 
183
is \s-1NO\s0 warranty; not even for \s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0
 
184
\&\s-1PURPOSE\s0
 
185
.SH "SEE ALSO"
 
186
.IX Header "SEE ALSO"
 
187
\&\f(CWvirsh(1)\fR, \f(CW\*(C`virt\-pki\-validate\*(C'\fR, \f(CW\*(C`virt\-xml\-validate\*(C'\fR