Date: Thu, 21 Oct 2021 22:32:59 GMT From: Guido Falsi <madpilot@FreeBSD.org> To: ports-committers@FreeBSD.org, dev-commits-ports-all@FreeBSD.org, dev-commits-ports-main@FreeBSD.org Subject: git: 352af02b3892 - main - emulators/virtualbox-ose: Update description and message files Message-ID: <202110212232.19LMWxmG020030@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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/
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202110212232.19LMWxmG020030>