docs/downloads.html.in

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html>
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4   <body>
   5     <h1>Downloads</h1>
   6
   7     <ul id="toc"></ul>
   8
   9     <h2><a id="releases">Project modules</a></h2>
  10
  11     <p>
  12       The libvirt project maintains a number of inter-related modules beyond
  13       the core C library/daemon.
  14     </p>
  15
  16     <table class="top_table downloads">
  17       <thead>
  18         <tr>
  19           <th>Module</th>
  20           <th>Releases</th>
  21           <th>GIT Repo</th>
  22           <th>GIT Mirrors</th>
  23           <th>Resources</th>
  24         </tr>
  25       </thead>
  26       <tbody>
  27         <tr>
  28           <td>libvirt</td>
  29           <td>
  30             <a href="https://libvirt.org/sources/">libvirt</a>
  31           </td>
  32           <td>
  33             <a href="https://libvirt.org/git/?p=libvirt.git;a=summary">libvirt</a>
  34           </td>
  35           <td>
  36             <a href="https://gitlab.com/libvirt/libvirt">gitlab</a>
  37             <a href="https://github.com/libvirt/libvirt">github</a>
  38           </td>
  39           <td>
  40             <a href="html/index.html">api ref</a>
  41             <a href="news.html">changes</a>
  42           </td>
  43         </tr>
  44         <tr>
  45           <th colspan="7">Language bindings</th>
  46         </tr>
  47         <tr>
  48           <td>C#</td>
  49           <td>
  50             <a href="https://libvirt.org/sources/csharp/">libvirt</a>
  51           </td>
  52           <td>
  53             <a href="https://libvirt.org/git/?p=libvirt-csharp.git;a=summary">libvirt</a>
  54           </td>
  55           <td>
  56             <a href="https://gitlab.com/libvirt/libvirt-csharp">gitlab</a>
  57             <a href="https://github.com/libvirt/libvirt-csharp">github</a>
  58           </td>
  59           <td></td>
  60         </tr>
  61         <tr>
  62           <td>Go</td>
  63           <td>
  64             <a href="https://libvirt.org/sources/go/">libvirt</a>
  65           </td>
  66           <td>
  67             <a href="https://libvirt.org/git/?p=libvirt-go.git;a=summary">libvirt</a>
  68           </td>
  69           <td>
  70             <a href="https://gitlab.com/libvirt/libvirt-go">gitlab</a>
  71             <a href="https://github.com/libvirt/libvirt-go">github</a>
  72           </td>
  73           <td>
  74             <a href="https://godoc.org/github.com/libvirt/libvirt-go">api ref</a>
  75           </td>
  76         </tr>
  77         <tr>
  78           <td>Java</td>
  79           <td>
  80             <a href="https://libvirt.org/sources/java/">libvirt</a>
  81           </td>
  82           <td>
  83             <a href="https://libvirt.org/git/?p=libvirt-java.git;a=summary">libvirt</a>
  84           </td>
  85           <td>
  86             <a href="https://gitlab.com/libvirt/libvirt-java">gitlab</a>
  87             <a href="https://github.com/libvirt/libvirt-java">github</a>
  88           </td>
  89           <td></td>
  90         </tr>
  91         <tr>
  92           <td>OCaml</td>
  93           <td>
  94             <a href="https://libvirt.org/sources/ocaml/">libvirt</a>
  95           </td>
  96           <td>
  97             <a href="https://libvirt.org/git/?p=libvirt-ocaml.git;a=summary">libvirt</a>
  98           </td>
  99           <td>
 100             <a href="https://gitlab.com/libvirt/libvirt-ocaml">gitlab</a>
 101             <a href="https://github.com/libvirt/libvirt-ocaml">github</a>
 102           </td>
 103           <td></td>
 104         </tr>
 105         <tr>
 106           <td>Perl (Sys::Virt)</td>
 107           <td>
 108             <a href="https://metacpan.org/release/Sys-Virt/">cpan</a>
 109           </td>
 110           <td>
 111             <a href="https://libvirt.org/git/?p=libvirt-perl.git;a=summary">libvirt</a>
 112           </td>
 113           <td>
 114             <a href="https://gitlab.com/libvirt/libvirt-perl">gitlab</a>
 115             <a href="https://github.com/libvirt/libvirt-perl">github</a>
 116           </td>
 117           <td>
 118             <a href="https://metacpan.org/release/Sys-Virt/">api ref</a>
 119             <a href="https://libvirt.org/git/?p=libvirt-perl.git;a=blob;f=Changes;hb=HEAD">changes</a>
 120           </td>
 121         </tr>
 122         <tr>
 123           <td>PHP</td>
 124           <td>
 125             <a href="https://libvirt.org/sources/php/">libvirt</a>
 126           </td>
 127           <td>
 128             <a href="https://libvirt.org/git/?p=libvirt-php.git;a=summary">libvirt</a>
 129           </td>
 130           <td>
 131             <a href="https://gitlab.com/libvirt/libvirt-php">gitlab</a>
 132             <a href="https://github.com/libvirt/libvirt-php">github</a>
 133           </td>
 134           <td></td>
 135         </tr>
 136         <tr>
 137           <td>Python</td>
 138           <td>
 139             <a href="https://libvirt.org/sources/python/">libvirt</a>
 140             <a href="https://pypi.python.org/pypi/libvirt-python">pypi</a>
 141           </td>
 142           <td>
 143             <a href="https://libvirt.org/git/?p=libvirt-python.git;a=summary">libvirt</a>
 144           </td>
 145           <td>
 146             <a href="https://gitlab.com/libvirt/libvirt-python">gitlab</a>
 147             <a href="https://github.com/libvirt/libvirt-python">github</a>
 148           </td>
 149           <td></td>
 150         </tr>
 151         <tr>
 152           <td>Ruby</td>
 153           <td>
 154             <a href="https://libvirt.org/sources/ruby/">libvirt</a>
 155           </td>
 156           <td>
 157             <a href="https://libvirt.org/git/?p=ruby-libvirt.git;a=summary">libvirt</a>
 158           </td>
 159           <td>
 160             <a href="https://gitlab.com/libvirt/ruby-libvirt">gitlab</a>
 161             <a href="https://github.com/libvirt/ruby-libvirt">github</a>
 162           </td>
 163           <td></td>
 164         </tr>
 165         <tr>
 166           <td>Rust</td>
 167           <td>
 168             <a href="https://libvirt.org/sources/rust/">libvirt</a>
 169           </td>
 170           <td>
 171             <a href="https://libvirt.org/git/?p=libvirt-rust.git;a=summary">libvirt</a>
 172           </td>
 173           <td>
 174             <a href="https://gitlab.com/libvirt/libvirt-rust">gitlab</a>
 175             <a href="https://github.com/libvirt/libvirt-rust">github</a>
 176           </td>
 177           <td></td>
 178         </tr>
 179         <tr>
 180           <th colspan="7">Integration modules</th>
 181         </tr>
 182         <tr>
 183           <td>GLib / GConfig / GObject</td>
 184           <td>
 185             <a href="https://libvirt.org/sources/glib/">libvirt</a>
 186           </td>
 187           <td>
 188             <a href="https://libvirt.org/git/?p=libvirt-glib.git;a=summary">libvirt</a>
 189           </td>
 190           <td>
 191             <a href="https://gitlab.com/libvirt/libvirt-glib">gitlab</a>
 192             <a href="https://github.com/libvirt/libvirt-glib">github</a>
 193           </td>
 194           <td></td>
 195         </tr>
 196         <tr>
 197           <td>Go XML</td>
 198           <td>
 199             <a href="https://libvirt.org/sources/go/">libvirt</a>
 200           </td>
 201           <td>
 202             <a href="https://libvirt.org/git/?p=libvirt-go-xml.git;a=summary">libvirt</a>
 203           </td>
 204           <td>
 205             <a href="https://gitlab.com/libvirt/libvirt-go-xml">gitlab</a>
 206             <a href="https://github.com/libvirt/libvirt-go-xml">github</a>
 207           </td>
 208           <td>
 209             <a href="https://godoc.org/github.com/libvirt/libvirt-go-xml">api ref</a>
 210           </td>
 211         </tr>
 212         <tr>
 213           <td>D-Bus</td>
 214           <td>
 215             <a href="https://libvirt.org/sources/dbus/">libvirt</a>
 216           </td>
 217           <td>
 218             <a href="https://libvirt.org/git/?p=libvirt-dbus.git;a=summary">libvirt</a>
 219           </td>
 220           <td>
 221             <a href="https://gitlab.com/libvirt/libvirt-dbus">gitlab</a>
 222             <a href="https://github.com/libvirt/libvirt-dbus">github</a>
 223           </td>
 224           <td></td>
 225         </tr>
 226         <tr>
 227           <td>Console Proxy</td>
 228           <td>
 229             <a href="https://libvirt.org/sources/consoleproxy/">libvirt</a>
 230           </td>
 231           <td>
 232             <a href="https://libvirt.org/git/?p=libvirt-console-proxy.git;a=summary">libvirt</a>
 233           </td>
 234           <td>
 235             <a href="https://gitlab.com/libvirt/libvirt-console-proxy">gitlab</a>
 236             <a href="https://github.com/libvirt/libvirt-console-proxy">github</a>
 237           </td>
 238           <td></td>
 239         </tr>
 240         <tr>
 241           <td>CIM provider</td>
 242           <td>
 243             <a href="https://libvirt.org/sources/CIM/">libvirt</a>
 244           </td>
 245           <td>
 246             <a href="https://libvirt.org/git/?p=libvirt-cim.git;a=summary">libvirt</a>
 247           </td>
 248           <td>
 249             <a href="https://gitlab.com/libvirt/libvirt-cim">gitlab</a>
 250             <a href="https://github.com/libvirt/libvirt-cim">github</a>
 251           </td>
 252           <td></td>
 253         </tr>
 254         <tr>
 255           <td>CIM utils</td>
 256           <td>
 257             <a href="https://libvirt.org/sources/CIM/">libvirt</a>
 258           </td>
 259           <td>
 260             <a href="https://libvirt.org/git/?p=libcmpiutil.git;a=summary">libvirt</a>
 261           </td>
 262           <td>
 263             <a href="https://gitlab.com/libvirt/libcmpiutil">gitlab</a>
 264             <a href="https://github.com/libvirt/libcmpiutil">github</a>
 265           </td>
 266           <td></td>
 267         </tr>
 268         <tr>
 269           <td>SNMP</td>
 270           <td>
 271             <a href="https://libvirt.org/sources/snmp/">libvirt</a>
 272           </td>
 273           <td>
 274             <a href="https://libvirt.org/git/?p=libvirt-snmp.git;a=summary">libvirt</a>
 275           </td>
 276           <td>
 277             <a href="https://gitlab.com/libvirt/libvirt-snmp">gitlab</a>
 278             <a href="https://github.com/libvirt/libvirt-snmp">github</a>
 279           </td>
 280           <td></td>
 281         </tr>
 282         <tr>
 283           <td>Application Sandbox</td>
 284           <td>
 285             <a href="https://libvirt.org/sources/sandbox/">libvirt</a>
 286           </td>
 287           <td>
 288             <a href="https://libvirt.org/git/?p=libvirt-sandbox.git;a=summary">libvirt</a>
 289           </td>
 290           <td>
 291             <a href="https://gitlab.com/libvirt/libvirt-sandbox">gitlab</a>
 292             <a href="https://github.com/libvirt/libvirt-sandbox">github</a>
 293           </td>
 294           <td></td>
 295         </tr>
 296         <tr>
 297           <th colspan="7">Testing</th>
 298         </tr>
 299         <tr>
 300           <td>TCK</td>
 301           <td>
 302             <a href="https://libvirt.org/sources/tck/">libvirt</a>
 303           </td>
 304           <td>
 305             <a href="https://libvirt.org/git/?p=libvirt-tck.git;a=summary">libvirt</a>
 306           </td>
 307           <td>
 308             <a href="https://gitlab.com/libvirt/libvirt-tck">gitlab</a>
 309             <a href="https://github.com/libvirt/libvirt-tck">github</a>
 310           </td>
 311           <td></td>
 312         </tr>
 313         <tr>
 314           <td>Test API</td>
 315           <td></td>
 316           <td>
 317             <a href="https://libvirt.org/git/?p=libvirt-test-API.git;a=summary">libvirt</a>
 318           </td>
 319           <td>
 320             <a href="https://gitlab.com/libvirt/libvirt-test-API">gitlab</a>
 321             <a href="https://github.com/libvirt/libvirt-test-API">github</a>
 322           </td>
 323           <td></td>
 324         </tr>
 325         <tr>
 326           <td>Jenkins Config</td>
 327           <td></td>
 328           <td>
 329             <a href="https://libvirt.org/git/?p=libvirt-jenkins-ci.git;a=summary">libvirt</a>
 330           </td>
 331           <td>
 332             <a href="https://gitlab.com/libvirt/libvirt-jenkins-ci">gitlab</a>
 333             <a href="https://github.com/libvirt/libvirt-jenkins-ci">github</a>
 334           </td>
 335           <td></td>
 336         </tr>
 337         <tr>
 338           <td>CIM Test</td>
 339           <td></td>
 340           <td>
 341             <a href="https://libvirt.org/git/?p=cimtest.git;a=summary">libvirt</a>
 342           </td>
 343           <td>
 344             <a href="https://gitlab.com/libvirt/cimtest">gitlab</a>
 345             <a href="https://github.com/libvirt/cimtest">github</a>
 346           </td>
 347           <td></td>
 348         </tr>
 349         <tr>
 350           <th colspan="7">Documentation</th>
 351         </tr>
 352         <tr>
 353           <td>Publican Brand</td>
 354           <td></td>
 355           <td>
 356             <a href="https://libvirt.org/git/?p=libvirt-publican.git;a=summary">libvirt</a>
 357           </td>
 358           <td>
 359             <a href="https://gitlab.com/libvirt/libvirt-publican">gitlab</a>
 360             <a href="https://github.com/libvirt/libvirt-publican">github</a>
 361           </td>
 362           <td></td>
 363         </tr>
 364         <tr>
 365           <td>App Development Guide</td>
 366           <td></td>
 367           <td>
 368             <a href="https://libvirt.org/git/?p=libvirt-appdev-guide.git;a=summary">libvirt</a>
 369           </td>
 370           <td>
 371             <a href="https://gitlab.com/libvirt/libvirt-appdev-guide">gitlab</a>
 372             <a href="https://github.com/libvirt/libvirt-appdev-guide">github</a>
 373           </td>
 374           <td></td>
 375         </tr>
 376         <tr>
 377           <td>App Development Guide Python</td>
 378           <td></td>
 379           <td>
 380             <a href="https://libvirt.org/git/?p=libvirt-appdev-guide-python.git;a=summary">libvirt</a>
 381           </td>
 382           <td>
 383             <a href="https://gitlab.com/libvirt/libvirt-appdev-guide-python">gitlab</a>
 384             <a href="https://github.com/libvirt/libvirt-appdev-guide-python">github</a>
 385           </td>
 386           <td></td>
 387         </tr>
 388         <tr>
 389           <td>virsh Command Reference</td>
 390           <td></td>
 391           <td>
 392             <a href="https://libvirt.org/git/?p=libvirt-virshcmdref.git;a=summary">libvirt</a>
 393           </td>
 394           <td>
 395             <a href="https://gitlab.com/libvirt/libvirt-virshcmdref">gitlab</a>
 396             <a href="https://github.com/libvirt/libvirt-virshcmdref">github</a>
 397           </td>
 398           <td></td>
 399         </tr>
 400       </tbody>
 401     </table>
 402
 403     <h2>Primary download site</h2>
 404
 405     <p>
 406       Most modules have releases made available for download on the project
 407       site via HTTPS. Some modules are instead made available at alternative
 408       locations, for example, the Perl binding is made available only on CPAN.
 409     </p>
 410
 411     <ul>
 412       <li><a href="https://libvirt.org/sources/">libvirt.org HTTPS server</a></li>
 413     </ul>
 414
 415     <h2><a id="schedule">Primary release schedule</a></h2>
 416
 417     <p>
 418       The core libvirt module follows a time based plan, with releases made
 419       once a month on the 1st of each month give or take a few days. The only
 420       exception is at the start of the year where there are two 6 weeks gaps
 421       (first release in the middle of Jan, then skip the Feb release), giving
 422       a total of 11 releases a year. The Python and Perl modules will aim to
 423       release at the same time as the core libvirt module. Other modules have
 424       independent ad-hoc releases with no fixed time schedule.
 425     </p>
 426
 427     <h2><a id="numbering">Release numbering</a></h2>
 428
 429     <p>
 430       Since libvirt 2.0.0, a time based version numbering rule
 431       is applied to the core library releases. As such, the changes
 432       in version number have do not have any implications with respect
 433       to the scope of features or bugfixes included, the stability of
 434       the code, or the API / ABI compatibility (libvirt API / ABI is
 435       guaranteed stable forever). The rules applied for changing the
 436       libvirt version number are:
 437     </p>
 438
 439     <dl>
 440       <dt><code>major</code></dt>
 441       <dd>incremented by 1 for the first release of the year (the
 442         Jan 15th release)</dd>
 443       <dt><code>minor</code></dt>
 444       <dd>reset to 0 with every major increment, otherwise incremented by 1
 445         for each monthly release from git master</dd>
 446       <dt><code>micro</code></dt>
 447       <dd>always 0 for releases from git master, incremented by 1
 448         for each stable maintenance release</dd>
 449     </dl>
 450
 451     <p>
 452       Prior to 2.0.0, the major/minor numbers were incremented
 453       fairly arbitrarily, and maintenance releases appended a
 454       fourth digit. The language bindings will aim to use the
 455       same version number as the most recent core library API
 456       they support. The other modules have their own distinct
 457       release numbering sequence, though they generally aim
 458       to follow the above rules for incrementing major/minor/micro
 459       digits.
 460     </p>
 461
 462     <h2><a id="maintenance">Maintenance releases</a></h2>
 463     <p>
 464       In the git repository are several stable maintenance branches
 465       for the core library, matching the
 466       pattern <code>v<i>major</i>.<i>minor</i>-maint</code>;
 467       these branches are forked off the corresponding
 468       <code>v<i>major</i>.<i>minor</i>.0</code> formal
 469       release, and may have further releases of the
 470       form <code>v<i>major</i>.<i>minor</i>.<i>micro</i></code>.
 471       These maintenance branches should only contain bug fixes, and no
 472       new features, backported from the master branch, and are
 473       supported as long as at least one downstream distribution
 474       expresses interest in a given branch.  These maintenance
 475       branches are considered during CVE analysis. In contrast
 476       to the primary releases which are made once a month, there
 477       is no formal schedule for the maintenance releases, which
 478       are made whenever there is a need to make available key
 479       bugfixes to downstream consumers. The language bindings
 480       and other modules generally do not provide stable branch
 481       releases.
 482     </p>
 483
 484     <p>
 485       For more details about contents of maintenance releases, see
 486       <a href="http://wiki.libvirt.org/page/Maintenance_Releases">the
 487       wiki page</a>.
 488     </p>
 489
 490     <h2><a id="git">GIT source repository</a></h2>
 491
 492     <p>
 493       All modules maintained by the libvirt project have their primary
 494       source available in the <a href="https://libvirt.org/git/">project GIT server</a>.
 495       Each module can be cloned anonymously using:
 496     </p>
 497
 498     <pre>
 499 git clone https://libvirt.org/git/[module name].git</pre>
 500
 501     <p>
 502       The <code>git://</code> protocol is also available if desired, but
 503       <code>https://</code> is encouraged, since it is more reliable when
 504       faced with strict firewalls.
 505     </p>
 506
 507     <pre>
 508 git clone git://libvirt.org/[module name].git</pre>
 509
 510     <p>
 511       In addition to this primary repository, there are the following read-only git
 512       repositories which mirror the master one. Note that we currently do not
 513       use the full set of features on these mirrors (e.g. pull requests on
 514       GitHub, so please don't use them). All patch review and discussion only
 515       occurs on the <a href="contact.html">libvir-list</a> mailing list. Also
 516       note that some repositories listed below allow HTTP checkouts too.
 517     </p>
 518
 519     <pre>
 520 <a href="https://github.com/libvirt/">https://github.com/libvirt/</a>
 521 <a href="https://gitlab.com/libvirt/libvirt">https://gitlab.com/libvirt/</a></pre>
 522
 523   </body>
 524 </html>