Changeset 64216 in vbox

Timestamp:

Oct 12, 2016 6:46:04 AM (8 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

111215

Message:

8530: Documentation: improve automated instructions for building kernel modules: further refine the description of how to build kernel modules in the manual, and add back some information about networking which was removed in the last change: the user should not be told unnecessary details, but some details are useful to know.

File:

• trunk/doc/manual/en_US/user_Installation.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_Installation.xml

@@ -360 +360 @@
       very tightly into the system.  To do this it installs a "driver"
       module called <computeroutput>vboxdrv</computeroutput> which does
-      a lot of the work. Without this kernel module, you can still use the
+      a lot of that work into the system kernel, which is the part of
+      the operating system which controls your processor and physical
+      hardware. Without this kernel module, you can still use the
       VirtualBox manager to configure virtual machines, but they will not
       start. It also installs network drivers called
       <computeroutput>vboxnetflt</computeroutput> and
       <computeroutput>vboxnetadp</computeroutput> which let virtual machines
-      make more use of your computer's network capabilities.</para>
-
-      <para>The modules will be built automatically during installation or
-      after kernel updates if your Linux system is prepared for building
-      external kernel modules.</para>
-
-      <para>Most Linux distributions can be set up simply by installing
-      the right packages - normally, these will be the GNU compiler
+      make more use of your computer's network capabilities and are needed
+      for any virtual machine networking beyond the basic "NAT" mode.</para>
+
+      <para>Since distributing driver modules separately from the kernel
+      is not something which Linux supports well, we create the modules
+      on the system where they will be used.  This usually means first
+      installing software packages from the distribution which are needed
+      for the "build" process.  Normally, these will be the GNU compiler
       (GCC), GNU Make (make) and packages containing "header files" for
       your kernel - and making sure that all system updates are