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
This commit is contained in:
Graham Perrin 2021-10-22 00:31:36 +02:00 committed by Guido Falsi
parent 3b28378023
commit 352af02b38
6 changed files with 77 additions and 43 deletions

View File

@ -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/

View File

@ -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
}
]

View File

@ -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/

View File

@ -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
}
]

View File

@ -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/

View File

@ -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/