Changeset 77196 in vbox for trunk/src/VBox

Timestamp:

Feb 7, 2019 1:33:50 PM (6 years ago)

Author:

vboxsync

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

128689

Message:

Help text: explain about EFI Secure Boot and signing.
ticketref:18312: Unable to build Virtualbox 6.0 on Fedora 29
When a user tries to use VirtualBox on a Linux system with EFI Secure Boot
enabled, it sometimes fails in a non-obvious way due to unsigned kernel
modules. As it is rather tricky to detect this properly, mention it in the
help text which is shown when there are problems with the modules.

Location:

trunk/src/VBox

Files:

• Frontends/VirtualBox/src/main.cpp (modified) (2 diffs)
• Installer/linux/postinst-common.sh (modified) (1 diff)
• VMM/VMMR3/VM.cpp (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/main.cpp

@@ -87 +87 @@
 
 QString g_QStrHintLinuxNoDriver = QApplication::tr(
-    "The VirtualBox Linux kernel driver (vboxdrv) is either not loaded or "
-    "there is a permission problem with /dev/vboxdrv. Please reinstall the kernel "
-    "module by executing<br/><br/>"
+    "The VirtualBox Linux kernel driver is either not loaded or not set "
+    "up correctly. Please try setting it up again by executing<br/><br/>"
     "  <font color=blue>'/sbin/vboxconfig'</font><br/><br/>"
-    "as root."
+    "as root.<br/><br/>"
+    "If your system has EFI Secure Boot enabled you may also need to sign "
+    "the kernel modules (vboxdrv, vboxnetflt, vboxnetadp, vboxpci) before "
+    "you can load them. Please see your Linux system's documentation for "
+    "more information."
     );
 
@@ -106 +109 @@
     "successful. Executing<br/><br/>"
     "  <font color=blue>'/sbin/vboxconfig'</font><br/><br/>"
-    "may correct this. Make sure that you do not mix the "
-    "OSE version and the PUEL version of VirtualBox."
+    "may correct this. Make sure that you are not mixing builds "
+    "of VirtualBox from different sources."
     );
 

trunk/src/VBox/Installer/linux/postinst-common.sh

@@ -104 +104 @@
         echo "There were problems setting up VirtualBox.  To re-start the set-up process, run" >&2
         echo "  /sbin/vboxconfig" >&2
-        echo "as root." >&2
+        echo "as root.  If your system is using EFI Secure Boot you may need to sign the" >&2
+        echo "kernel modules (vboxdrv, vboxnetflt, vboxnetadp, vboxpci) before you can load" >&2
+        echo " them. Please see your Linux system's documentation for more information." >&2
     else
         start_init_script vboxdrv

trunk/src/VBox/VMM/VMMR3/VM.cpp

@@ -273 +273 @@
                 case VERR_SUPDRV_COMPONENT_NOT_FOUND:
                     pszError = N_("One of the kernel modules was not successfully loaded. Make sure "
-                                  "that no kernel modules from an older version of VirtualBox exist. "
-                                  "Then try to recompile and reload the kernel modules by executing "
+                                  "that VirtualBox is correctly installed, and if you are using EFI "
+                                  "Secure Boot that the modules are signed if necessary in the right "
+                                  "way for your host system.  Then try to recompile and reload the "
+                                  "kernel modules by executing "
                                   "'/sbin/vboxconfig' as root");
                     break;
@@ -339 +341 @@
 #ifdef RT_OS_LINUX
                     pszError = N_("VirtualBox kernel driver not loaded. The vboxdrv kernel module "
-                                  "was either not loaded or /dev/vboxdrv is not set up properly. "
-                                  "Re-setup the kernel module by executing "
+                                  "was either not loaded, /dev/vboxdrv is not set up properly, "
+                                  "or you are using EFI Secure Boot and the module is not signed "
+                                  "in the right way for your system.  If necessary, try setting up "
+                                  "the kernel module again by executing "
                                   "'/sbin/vboxconfig' as root");
 #else
@@ -380 +384 @@
                 case VERR_VM_DRIVER_NOT_INSTALLED:
 #ifdef RT_OS_LINUX
-                    pszError = N_("VirtualBox kernel driver not installed. The vboxdrv kernel module "
-                                  "was either not loaded or /dev/vboxdrv was not created for some "
-                                  "reason. Re-setup the kernel module by executing "
+                    pszError = N_("VirtualBox kernel driver not Installed. The vboxdrv kernel module "
+                                  "was either not loaded, /dev/vboxdrv is not set up properly, "
+                                  "or you are using EFI Secure Boot and the module is not signed "
+                                  "in the right way for your system.  If necessary, try setting up "
+                                  "the kernel module again by executing "
                                   "'/sbin/vboxconfig' as root");
 #else