git: 352af02b3892 - main - emulators/virtualbox-ose: Update description and message files
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 21 Oct 2021 22:32:59 UTC
The branch main has been updated by madpilot:
URL: https://cgit.FreeBSD.org/ports/commit/?id=352af02b389202ac426ecf026ac65bff7c61bd41
commit 352af02b389202ac426ecf026ac65bff7c61bd41
Author: Graham Perrin <grahamperrin@gmail.com>
AuthorDate: 2021-10-21 22:31:36 +0000
Commit: Guido Falsi <madpilot@FreeBSD.org>
CommitDate: 2021-10-21 22:32:36 +0000
emulators/virtualbox-ose: Update description and message files
- Add updated information about supported versions, installation
commands and mitigation for a known issue.
- Removed reference to the wiki page.
Reviewed on github:
https://github.com/freebsd/freebsd-ports/pull/115
PR: 254412
---
.../virtualbox-ose-additions-legacy/pkg-descr | 18 ++++++++----
.../virtualbox-ose-additions-legacy/pkg-message | 23 +++++++--------
emulators/virtualbox-ose-additions/pkg-descr | 11 ++++----
emulators/virtualbox-ose-additions/pkg-message | 33 +++++++++++++++-------
emulators/virtualbox-ose-legacy/pkg-descr | 22 +++++++++++----
emulators/virtualbox-ose/pkg-descr | 13 +++++----
6 files changed, 77 insertions(+), 43 deletions(-)
diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-descr b/emulators/virtualbox-ose-additions-legacy/pkg-descr
index e93c940f7f4a..7b949a04f2c4 100644
--- a/emulators/virtualbox-ose-additions-legacy/pkg-descr
+++ b/emulators/virtualbox-ose-additions-legacy/pkg-descr
@@ -1,9 +1,15 @@
-These additions are for installation inside a FreeBSD guest.
+VirtualBox Guest Additions provide closer integration between host and
+guest, and improve the performance of guest systems.
-VirtualBox is a family of powerful x86 virtualization products for
-enterprise as well as home use. Not only is VirtualBox an extremely
-feature rich, high performance product for enterprise customers, it
-is also the only professional solution that is freely available as
-Open Source Software under the terms of the GNU General Public License.
+Non-legacy additions i.e. emulators/virtualbox-ose-additions are
+recommended for most use cases.
+
+Where legacy (5.2.x) is a requirement, this FreeBSD-provided package
+can be installed in the FreeBSD guest machine.
+
+<https://www.virtualbox.org/wiki/Changelog-5.2> emphasises that
+5.2.x is no longer supported by Oracle.
+
+Additions are not intended for use on Host machines.
WWW: https://www.virtualbox.org/
diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-message b/emulators/virtualbox-ose-additions-legacy/pkg-message
index e8b5c6a5edfa..035001f3083e 100644
--- a/emulators/virtualbox-ose-additions-legacy/pkg-message
+++ b/emulators/virtualbox-ose-additions-legacy/pkg-message
@@ -1,23 +1,24 @@
[
{ type: install
message: <<EOM
-VirtualBox Guest Additions were installed.
+VirtualBox Guest Additions are installed.
+To enable the required services:
-You need to enable the vboxguest startscript to load the kernel module and
-vboxservice to use host time synchronization.
+# sysrc vboxguest_enable="YES"
+# sysrc vboxservice_enable="YES"
-vboxguest_enable="YES"
-vboxservice_enable="YES"
+To start the services, restart the system.
-You also have to add all X11 users that want to use any of the additional
-features (clipboard sharing, window scaling) to the wheel group.
+For features such as window scaling and clipboard sharing, membership of
+the wheel group is required. With username jerry as an example:
-% pw groupmod wheel -m jerry
+# pw groupmod wheel -m jerry
-Reboot the machine to load the needed kernel modules.
-
-For detailed informations please visit http://wiki.freebsd.org/VirtualBox
+The settings dialogue for FreeBSD guests encourages use of the VMSVGA
+graphics controller. Whilst this might suit installations of FreeBSD
+without a desktop environment (a common use case), it may be inappropriate
+where legacy Guest Additions are installed.
EOM
}
]
diff --git a/emulators/virtualbox-ose-additions/pkg-descr b/emulators/virtualbox-ose-additions/pkg-descr
index e93c940f7f4a..54c521686dd9 100644
--- a/emulators/virtualbox-ose-additions/pkg-descr
+++ b/emulators/virtualbox-ose-additions/pkg-descr
@@ -1,9 +1,8 @@
-These additions are for installation inside a FreeBSD guest.
+VirtualBox Guest Additions provide closer integration between host and
+guest, and improve the performance of guest systems.
-VirtualBox is a family of powerful x86 virtualization products for
-enterprise as well as home use. Not only is VirtualBox an extremely
-feature rich, high performance product for enterprise customers, it
-is also the only professional solution that is freely available as
-Open Source Software under the terms of the GNU General Public License.
+This FreeBSD provided package can be installed in FreeBSD guest machines.
+
+Additions are not intended for use on Host machines.
WWW: https://www.virtualbox.org/
diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message
index e8b5c6a5edfa..221b43a1fee4 100644
--- a/emulators/virtualbox-ose-additions/pkg-message
+++ b/emulators/virtualbox-ose-additions/pkg-message
@@ -1,23 +1,36 @@
[
{ type: install
message: <<EOM
-VirtualBox Guest Additions were installed.
+VirtualBox Guest Additions are installed.
+To enable and start the required services:
-You need to enable the vboxguest startscript to load the kernel module and
-vboxservice to use host time synchronization.
+# sysrc vboxguest_enable="YES"
+# sysrc vboxservice_enable="YES"
-vboxguest_enable="YES"
-vboxservice_enable="YES"
+To start the services, restart the system.
-You also have to add all X11 users that want to use any of the additional
-features (clipboard sharing, window scaling) to the wheel group.
+In some situations, a panic will occur when the kernel module loads.
+Having no more than one virtual CPU might mitigate the issue.
-% pw groupmod wheel -m jerry
+For features such as window scaling and clipboard sharing, membership of
+the wheel group is required. With username jerry as an example:
-Reboot the machine to load the needed kernel modules.
+# pw groupmod wheel -m jerry
-For detailed informations please visit http://wiki.freebsd.org/VirtualBox
+The settings dialogue for FreeBSD guests encourages use of the VMSVGA
+graphics controller. Whilst this might suit installations of FreeBSD
+without a desktop environment (a common use case), it is not appropriate
+where Guest Additions are installed.
+
+Where Guest Additions are installed:
+
+1. prefer VBoxSVGA
+
+2. do not enable 3D acceleration (doing so will invisibly
+ lose the preference for VBoxSVGA)
+
+– you may ignore the yellow alert that encourages use of VMSVGA.
EOM
}
]
diff --git a/emulators/virtualbox-ose-legacy/pkg-descr b/emulators/virtualbox-ose-legacy/pkg-descr
index e9481f3a81fa..a2210840eadd 100644
--- a/emulators/virtualbox-ose-legacy/pkg-descr
+++ b/emulators/virtualbox-ose-legacy/pkg-descr
@@ -1,7 +1,19 @@
-VirtualBox is a family of powerful x86 virtualization products for
-enterprise as well as home use. Not only is VirtualBox an extremely
-feature rich, high performance product for enterprise customers, it
-is also the only professional solution that is freely available as
-Open Source Software under the terms of the GNU General Public License.
+Oracle VM VirtualBox is a hosted hypervisor for x86 virtualisation.
+Supported guests include BSD, Haiku, Linux, OS/2, ReactOS, Solaris and
+Windows.
+
+emulators/virtualbox-ose is recommended for most use cases.
+
+emulators/virtualbox-ose-legacy is for exceptional legacy (5.2.x) cases.
+
+<https://www.virtualbox.org/wiki/Changelog-5.2> emphasises that
+5.2.x is no longer supported by Oracle.
+
+Guest Additions are available:
+
+ emulators/virtualbox-ose-additions-legacy
+
+For the Extension Pack: FreeBSD is not a supported host platform.
+Installation of the Pack will not extend the feature set.
WWW: https://www.virtualbox.org/
diff --git a/emulators/virtualbox-ose/pkg-descr b/emulators/virtualbox-ose/pkg-descr
index e9481f3a81fa..2d5160615694 100644
--- a/emulators/virtualbox-ose/pkg-descr
+++ b/emulators/virtualbox-ose/pkg-descr
@@ -1,7 +1,10 @@
-VirtualBox is a family of powerful x86 virtualization products for
-enterprise as well as home use. Not only is VirtualBox an extremely
-feature rich, high performance product for enterprise customers, it
-is also the only professional solution that is freely available as
-Open Source Software under the terms of the GNU General Public License.
+Oracle VM VirtualBox is a hosted hypervisor for x86 virtualisation.
+Supported guests include BSD, Haiku, Linux, OS/2, ReactOS, Solaris and
+Windows.
+
+Guest Additions are available from: emulators/virtualbox-ose-additions
+
+For the Extension Pack: FreeBSD is not a supported host platform.
+Installation of the Pack will not extend the feature set.
WWW: https://www.virtualbox.org/