~ubuntu-branches/ubuntu/natty/libvirt/natty

« back to all changes in this revision

Viewing changes to docs/virshcmdref.html

  • Committer: Bazaar Package Importer
  • Author(s): Serge Hallyn
  • Date: 2011-02-23 09:05:46 UTC
  • mfrom: (1.2.8 upstream) (3.4.25 sid)
  • Revision ID: james.westby@ubuntu.com-20110223090546-4pwmrrt7h51hr3l3
Tags: 0.8.8-1ubuntu1
* Resynchronize and merge from Debian unstable. Remaining changes:
  - debian/patches:
    * 9000-delayed_iff_up_bridge.patch
    * 9001-dont_clobber_existing_bridges.patch
    * 9002-better_default_uri_virsh.patch
    * 9003-better-default-arch.patch
    * 9004-libvirtd-group-name.patch
    * 9005-increase-unix-socket-timeout.patch
    * 9006-default-config-test-case.patch
    * 9007-fix-daemon-conf-ftbfs.patch
    * 9011-move-ebtables-script.patch
    * 9014-skip-nodeinfotest.patch
    * 9020-lp545795.patch
    * 9021-fix-uint64_t.patch
  - debian/patches/series:
    * Disable qemu-disable-network.diff.patch
  - debian/control:
    * set ubuntu maintainer
    * Build-Depends:
      - swap libxen to libxen3, qemu to qemu-kvm, and open-iscsi to
        open-iscsi-utils in Build-Depends
      - remove virtualbox Build-Depends
      - add libxml2 and libapparmor-dev Build-Depends
    * convert Vcs-Git to Xs-Debian-Vcs-Git
    * libvirt-bin Depends: move netcat-openbsd, bridge-utils, dnsmasq-base
      (>= 2.46-1), and iptables from Recommends to Depends
    * libvirt-bin Recommends: move qemu to Suggests
    * libvirt-bin Suggests: add apparmor
    * libvirt0 Recommands: move lvm2 to Suggests
  - keep debian/libvirt-bin.apport
  - keep debian/libvirt-bin.cron.daily
  - debian/libvirt-bin.dirs:
    * add apparmor, cron.daily, and apport dirs
  - debian/libvirt-bin.examples:
    * add debian/libvirt-suspendonreboot
  - debian/libvirt-bin.install:
    * add /etc/apparmor.d files
    * add apport hook
  - debian/libvirt-bin.manpages:
    * add debian/libvirt-migrate-qemu-disks.1
  - debian/libvirt-bin.postinst:
    * replace libvirt groupname with libvirtd
    * add each admin user to libvirtd group
    * call apparmor_parser on usr.sbin.libvirtd and
      usr.lib.libvirt.virt-aa-helper
    * call 'libvirt-migrate-qemu-disks -a' after
      libvirt-bin has started if migrating from
      older than 0.8.3-1ubuntu1
  - debian/libvirt-bin.postrm:
    * replace libvirt groupname with libvirtd
    * remove usr.sbin.libvirtd and
      usr.lib.libvirt.virt-aa-helper
  - keep added files under debian/:
    * libvirt-bin.upstart
    * libvirt-migrate-qemu-disks
    * libvirt-migrate-qemu-disks.1
    * libvirt-suspendonreboot
    * apparmor profiles
  - debian/README.Debian:
    * add 'Apparmor Profile' section
    * add 'Disk migration' section
  - debian/rules:
    * don't build with vbox since virtualbox-ose is in universe
    * add --with-apparmor to DEB_CONFIGURE_EXTRA_FLAGS
    * set DEB_DH_INSTALLINIT_ARGS to '--upstart-only'
    * set DEB_MAKE_CHECK_TARGET to 'check'
    * remove unneeded binary-install/libvirt-bin:: and clean::
      sections (they only deal with sysvinit stuff)
    * add build/libvirt-bin:: section to install
      - apparmor files
      - apport hooks
      - libvirt-migrate-qemu-disks
* The following Ubuntu packaging changes occurred during the divergence
  between Debian and Ubuntu. These changes are not new, but included here
  for completeness: (0.8.5-0ubuntu1 - 0.8.5-0ubuntu5):
  - Have upstart job source /etc/default/libvirt-bin.  This is only a
    temporary fix until upstart provides proper default override support
    through /etc/init/libvirt-bin.override (or any other mechanism).
    (LP: 708172)
  - debian/apparmor/usr.sbin.libvirtd: use PUx instead of Ux for executables
    (LP: 573315)
  - Rebuild with python 2.7 as the python default.
  - debian/libvirt-bin.cron.daily: use shell globbing to enumerate xml files.
    Based on patch thanks to Henryk Plötz (LP: 655176)
* Dropped the following patches included/fixed upstream:
  - 9010-dont-disable-ipv6.patch
  - 9022-build-cleanup-declaration-of-xen-tests.patch
  - 9023-vah-require-uuid.patch
  - 9009-autodetect-nc-params.patch
    * rolled into Debian's
      Autodetect-if-the-remote-nc-command-supports-the-q-o.patch
* Updated the following patches:
  - 9011-move-ebtables-script.patch:
    * LOCALSTATEDIR is defined in configmake.h
  - 9000-9006: added DEP-3 tags
  - 9002-better_default_uri_virsh.patch: updated (context changed)
* New patches:
  - 9022-drop-booton-when-kernel-specified.patch (LP: #720426)
  - 9023-fix-lxc-console-hangup.patch (LP: #668369)
  - 9024-skip-broken-commandtest.patch
* debian/patches/series:
  - don't apply Disable-CHECKSUM-rule.patch: our iptables can do this
  - don't apply Debian-specific Debianize-libvirt-guests.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
3
<html xmlns="http://www.w3.org/1999/xhtml">
 
4
<!--
 
5
        This file is autogenerated from virshcmdref.html.in
 
6
        Do not edit this file. Changes will be lost.
 
7
      -->
 
8
  <head>
 
9
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 
10
    <link rel="stylesheet" type="text/css" href="main.css" />
 
11
    <link rel="SHORTCUT ICON" href="32favicon.png" />
 
12
    <title>libvirt: Virsh Command Reference</title>
 
13
    <meta name="description" content="libvirt, virtualization, virtualization API" />
 
14
  </head>
 
15
  <body>
 
16
    <div id="header">
 
17
      <div id="headerLogo"></div>
 
18
      <div id="headerSearch">
 
19
        <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
 
20
            <input id="query" name="query" type="text" size="12" value="" />
 
21
            <input id="submit" name="submit" type="submit" value="Search" />
 
22
          </div></form>
 
23
      </div>
 
24
    </div>
 
25
    <div id="body">
 
26
      <div id="menu">
 
27
        <ul class="l0"><li>
 
28
            <div>
 
29
              <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
 
30
            </div>
 
31
          </li><li>
 
32
            <div>
 
33
              <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
 
34
            </div>
 
35
          </li><li>
 
36
            <div>
 
37
              <a title="Applications known to use libvirt" class="inactive" href="apps.html">Applications</a>
 
38
            </div>
 
39
          </li><li>
 
40
            <div>
 
41
              <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
 
42
            </div>
 
43
          </li><li>
 
44
            <div>
 
45
              <a title="Information for users, administrators and developers" class="active" href="docs.html">Documentation</a>
 
46
              <ul class="l1"><li>
 
47
                  <div>
 
48
                    <a title="How to compile libvirt" class="inactive" href="compiling.html">Compiling</a>
 
49
                  </div>
 
50
                </li><li>
 
51
                  <div>
 
52
                    <a title="Information about deploying and using libvirt" class="inactive" href="deployment.html">Deployment</a>
 
53
                  </div>
 
54
                </li><li>
 
55
                  <div>
 
56
                    <a title="Overview of the logical subsystems in the libvirt API" class="inactive" href="intro.html">Architecture</a>
 
57
                  </div>
 
58
                </li><li>
 
59
                  <div>
 
60
                    <a title="Description of the XML formats used in libvirt" class="inactive" href="format.html">XML format</a>
 
61
                  </div>
 
62
                </li><li>
 
63
                  <div>
 
64
                    <a title="Hypervisor specific driver information" class="inactive" href="drivers.html">Drivers</a>
 
65
                  </div>
 
66
                </li><li>
 
67
                  <div>
 
68
                    <a title="Reference manual for the C public API" class="inactive" href="html/index.html">API reference</a>
 
69
                  </div>
 
70
                </li><li>
 
71
                  <div>
 
72
                    <a title="Bindings of the libvirt API for other languages" class="inactive" href="bindings.html">Language bindings</a>
 
73
                  </div>
 
74
                </li><li>
 
75
                  <div>
 
76
                    <a title="Working on the internals of libvirt API, driver and daemon code" class="inactive" href="internals.html">Internals</a>
 
77
                  </div>
 
78
                </li><li>
 
79
                  <div>
 
80
                    <a title="A guide and reference for developing with libvirt" class="inactive" href="devguide.html">Development Guide</a>
 
81
                  </div>
 
82
                </li><li>
 
83
                  <div>
 
84
                    <span class="active">Virsh Commands</span>
 
85
                  </div>
 
86
                </li></ul>
 
87
            </div>
 
88
          </li><li>
 
89
            <div>
 
90
              <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
 
91
            </div>
 
92
          </li><li>
 
93
            <div>
 
94
              <a title="Frequently asked questions" class="inactive" href="http://wiki.libvirt.org/page/FAQ">FAQ</a>
 
95
            </div>
 
96
          </li><li>
 
97
            <div>
 
98
              <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
 
99
            </div>
 
100
          </li><li>
 
101
            <div>
 
102
              <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
 
103
            </div>
 
104
          </li><li>
 
105
            <div>
 
106
              <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
 
107
            </div>
 
108
          </li><li>
 
109
            <div>
 
110
              <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
 
111
            </div>
 
112
          </li></ul>
 
113
      </div>
 
114
      <div id="content">
 
115
        <h1>Virsh Command Reference</h1>
 
116
        <ul><li>
 
117
            <a href="#description">Description</a>
 
118
          </li><li>
 
119
            <a href="#viewing">Viewing Online</a>
 
120
          </li><li>
 
121
            <a href="#downloading">Downloading</a>
 
122
          </li><li>
 
123
            <a href="#git">DocBook source GIT repository</a>
 
124
          </li></ul>
 
125
        <h2>
 
126
          <a name="description" id="description">Description</a>
 
127
        </h2>
 
128
        <p>
 
129
      The new <b>Virsh Command Reference</b>, for documenting the commands
 
130
      in virsh, has recently been started.  Only covering the Virtual
 
131
      Networking commands initially, it will expand to cover all virsh
 
132
      commands over time.
 
133
    </p>
 
134
        <p>
 
135
      If you would like to assist, content contributions are gladly accepted.
 
136
      Please email <a href="mailto:jclift@redhat.com">Justin Clift</a>
 
137
      directly, or get in contact through any of the
 
138
      <a href="contact.html">official libvirt mailing lists</a>.
 
139
    </p>
 
140
        <p> </p>
 
141
        <h2>
 
142
          <a name="viewing" id="viewing">Viewing Online</a>
 
143
        </h2>
 
144
        <p>
 
145
      The latest version can be viewed directly online:
 
146
    </p>
 
147
        <ul><li>
 
148
        <a href="http://libvirt.org/sources/virshcmdref/html/">Standard HTML format, multiple pages</a>
 
149
      </li><li>
 
150
        <a href="http://libvirt.org/sources/virshcmdref/html-single/">HTML format, one long page</a>
 
151
      </li></ul>
 
152
        <p> </p>
 
153
        <h2>
 
154
          <a name="downloading" id="downloading">Downloading</a>
 
155
        </h2>
 
156
        <p>
 
157
      The latest version of the Virsh Command Reference can be downloaded:
 
158
    </p>
 
159
        <ul><li>
 
160
        Standard HTML format, multiple pages
 
161
        (<a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1-html-multi-page.tar.gz">.tar.gz</a>)
 
162
        (<a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1-html-multi-page.tar.bz2">.tar.bz2</a>)
 
163
        (<a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1-html-multi-page.zip">.zip</a>)
 
164
      </li><li>
 
165
        HTML format, one long page
 
166
        (<a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1-html-single.tar.gz">.tar.gz</a>)
 
167
        (<a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1-html-single.tar.bz2">.tar.bz2</a>)
 
168
        (<a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1-html-single.zip">.zip</a>)
 
169
      </li><li>
 
170
        <a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1.pdf">PDF format</a>
 
171
      </li><li>
 
172
        <a href="http://libvirt.org/sources/virshcmdref/Virsh_Command_Reference-0.8.7-1.epub">ePub format</a>
 
173
      </li></ul>
 
174
        <h2>
 
175
          <a name="git" id="git">DocBook source GIT repository</a>
 
176
        </h2>
 
177
        <p>
 
178
      The DocBook source is maintained in a <a href="http://git-scm.com/">git</a> repository available on
 
179
      <a href="http://libvirt.org/git/">libvirt.org</a>:
 
180
    </p>
 
181
        <pre>
 
182
git clone git://libvirt.org/libvirt-virshcmdref.git
 
183
</pre>
 
184
        <p>
 
185
      It can also be browsed online:
 
186
    </p>
 
187
        <pre>
 
188
<a href="http://libvirt.org/git/?p=libvirt-virshcmdref.git">http://libvirt.org/git/?p=libvirt-virshcmdref.git</a>
 
189
</pre>
 
190
        <p> </p>
 
191
      </div>
 
192
    </div>
 
193
    <div id="footer">
 
194
      <p id="sponsor">
 
195
            Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
 
196
    </div>
 
197
  </body>
 
198
</html>