libvirt-doc 4.0.0-1ubuntu8 / usr / share / doc / libvirt-doc / drvuml.html

This file is indexed.

/usr/share/doc/libvirt-doc/drvuml.html is in libvirt-doc 4.0.0-1ubuntu8.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
  <!--
        This file is autogenerated from drvuml.html.in
        Do not edit this file. Changes will be lost.
      -->
  <!--
        This page was generated at Mon Nov 13 21:46:25 UTC 2017.
      -->
  <head>
    <meta charset="UTF-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1"/>
    <link rel="stylesheet" type="text/css" href="main.css"/>
    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png"/>
    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png"/>
    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png"/>
    <link rel="manifest" href="/manifest.json"/>
    <meta name="theme-color" content="#ffffff"/>
    <title>libvirt: User Mode Linux driver</title>
    <meta name="description" content="libvirt, virtualization, virtualization API"/>
    <script type="text/javascript">
      <!--
          
      function init() {
      window.addEventListener('scroll', function(e){
              var distanceY = window.pageYOffset || document.documentElement.scrollTop,
              shrinkOn = 94
              home = document.getElementById("home");
              links = document.getElementById("jumplinks");
              search = document.getElementById("search");
              body = document.getElementById("body");
              if (distanceY > shrinkOn) {
                  if (home.className != "navhide") {
                      body.className = "navhide"
                      home.className = "navhide"
                      links.className = "navhide"
                      search.className = "navhide"
                  }
              } else {
                  if (home.className == "navhide") {
                      body.className = ""
                      home.className = ""
                      links.className = ""
                      search.className = ""
                  }
              }
      });
      }
      window.onload = init();
           
          -->
    </script>
  </head>
  <body>
    <div id="body">
      <div id="content">
        <h1>User Mode Linux driver</h1>
        <p>
    The UML driver for libvirt allows use and management of paravirtualized
    guests built for User Mode Linux. UML requires no special support in
    the host kernel, so can be used by any user of any linux system, provided
    they have enough free RAM for their guest's needs, though there are
    certain restrictions on network connectivity unless the administrator
    has pre-created TAP devices.
    </p>
        <h2>
          <a id="project">Project Links</a>
          <a class="headerlink" href="#project" title="Permalink to this headline">ΒΆ</a>
        </h2>
        <ul>
          <li>
        The <a href="http://user-mode-linux.sourceforge.net/">User
        Mode Linux</a> paravirtualized kernel
      </li>
        </ul>
        <h2>Connections to UML driver</h2>
        <p>
    The libvirt UML driver follows the QEMU driver in providing two
    types of connection. There is one privileged instance per host,
    which runs as root. This is called the "system" instance, and allows
    full use of all host resources. Then, there is a per-user unprivileged
    "session", instance. This has more restricted capabilities, and may
    require the host administrator to setup certain resources ahead of
    time to allow full integration with the network. Example connection
    URIs are
    </p>
        <pre>
uml:///session                       (local access to per-user instance)
uml+unix:///session                  (local access to per-user instance)

uml:///system                        (local access to system instance)
uml+unix:///system                   (local access to system instance)
uml://example.com/system             (remote access, TLS/x509)
uml+tcp://example.com/system         (remote access, SASl/Kerberos)
uml+ssh://root@example.com/system    (remote access, SSH tunnelled)
</pre>
        <h2>Example XML configuration</h2>
        <p>
      User mode Linux driver only supports directly kernel boot at
      this time. A future driver enhancement may allow a paravirt
      bootloader in a similar style to Xen's pygrub. For now though,
      the UML kernel must be stored on the host and referenced
      explicitly in the "os" element. Since UML is a paravirtualized
      technology, the kernel "type" is set to "uml"
    </p>
        <p>
      There is not yet support for networking in the driver, but
      disks can be specified in the usual libvirt manner. The main
      variation is the target device naming scheme "ubd0", and
      bus type of "uml".
    </p>
        <p>
      Once booted the primary console is connected to a PTY, and
      thus accessible with "virsh console" or equivalent tools
    </p>
        <pre>
&lt;domain type='uml'&gt;
  &lt;name&gt;demo&lt;/name&gt;
  &lt;uuid&gt;b4433fc2-a22e-ffb3-0a3d-9c173b395800&lt;/uuid&gt;
  &lt;memory&gt;500000&lt;/memory&gt;
  &lt;currentMemory&gt;500000&lt;/currentMemory&gt;
  &lt;vcpu&gt;1&lt;/vcpu&gt;
  &lt;os&gt;
    &lt;type arch='x86_64'&gt;uml&lt;/type&gt;
    &lt;kernel&gt;/home/berrange/linux-uml-2.6.26-x86_64&lt;/kernel&gt;
  &lt;/os&gt;
  &lt;devices&gt;
    &lt;disk type='file' device='disk'&gt;
      &lt;source file='/home/berrange/FedoraCore6-AMD64-root_fs'/&gt;
      &lt;target dev='ubd0' bus='uml'/&gt;
    &lt;/disk&gt;
    &lt;console type='pty'/&gt;
  &lt;/devices&gt;
&lt;/domain&gt;
</pre>
      </div>
    </div>
    <div id="nav">
      <div id="home">
        <a href="index.html">Home</a>
      </div>
      <div id="jumplinks">
        <ul>
          <li>
            <a href="downloads.html">Download</a>
          </li>
          <li>
            <a href="contribute.html">Contribute</a>
          </li>
          <li>
            <a href="docs.html">Docs</a>
          </li>
        </ul>
      </div>
      <div id="search">
        <form action="search.php" enctype="application/x-www-form-urlencoded" method="get">
          <div>
            <input name="query" type="text" size="12" value=""/>
            <input name="submit" type="submit" value="Go"/>
          </div>
        </form>
      </div>
    </div>
    <div id="footer">
      <div id="contact">
        <h3>Contact</h3>
        <ul>
          <li>
            <a href="contact.html#email">email</a>
          </li>
          <li>
            <a href="contact.html#irc">irc</a>
          </li>
        </ul>
      </div>
      <div id="community">
        <h3>Community</h3>
        <ul>
          <li>
            <a href="https://twitter.com/hashtag/libvirt">twitter</a>
          </li>
          <li>
            <a href="https://plus.google.com/communities/109522598353007505282">google+</a>
          </li>
          <li>
            <a href="http://stackoverflow.com/questions/tagged/libvirt">stackoverflow</a>
          </li>
          <li>
            <a href="http://serverfault.com/questions/tagged/libvirt">serverfault</a>
          </li>
        </ul>
      </div>
      <div id="conduct">
            Participants in the libvirt project agree to abide by <a href="governance.html#codeofconduct">the project code of conduct</a></div>
      <br class="clear"/>
    </div>
  </body>
</html>

APT Browse - Built by Thomas Orozco.