From df3ef9fea177a0b846f150dbcc010ce3d1c10046 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 10 Oct 2021 09:50:28 +0100 Subject: [PATCH 01/17] Update pkg-message for bugs 254266 and 254412 explains the appropriateness of VBoxSVGA. identifies a likely workaround for the kernel panicking at FreeBSD guest boot time. `sysrc vboxguest_enable="YES" && service vboxguest start` (above) might, in itself, cause a system crash, however this is an edge case. All things considered, I think it's good to string the commands together and so, not require a reboot of the guest. --- .../virtualbox-ose-additions/pkg-message | 32 +++++++++++++------ 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message index e8b5c6a5edfa3..264ab38cb34cf 100644 --- a/emulators/virtualbox-ose-additions/pkg-message +++ b/emulators/virtualbox-ose-additions/pkg-message @@ -1,23 +1,35 @@ [ { type: install message: < Date: Sun, 10 Oct 2021 10:09:56 +0100 Subject: [PATCH 02/17] Make the package description more explanatory Essentially: part of the first paragraph from under . Additional clarification that addition to hosts is not required. --- emulators/virtualbox-ose-additions/pkg-descr | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/emulators/virtualbox-ose-additions/pkg-descr b/emulators/virtualbox-ose-additions/pkg-descr index e93c940f7f4a3..66fec4b7a63fc 100644 --- a/emulators/virtualbox-ose-additions/pkg-descr +++ b/emulators/virtualbox-ose-additions/pkg-descr @@ -1,9 +1,10 @@ -These additions are for installation inside a FreeBSD guest. +For any serious and interactive use, the Oracleⓡ VM VirtualBoxⓡ +Guest Additions will make your life much easier by providing closer +integration between host and guest and improving the interactive +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. -WWW: https://www.virtualbox.org/ +Addition to host machines is not required. + +WWW: https://www.virtualbox.org/manual/UserManual.html#guestadditions From 945efe448f58db1987ca9e116bbdee74040d7a1d Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 10 Oct 2021 10:23:23 +0100 Subject: [PATCH 03/17] Make the package description more explanatory Primarily: part of the first paragraph from under . Emphasis on the legacy nature of this port; and the more general end of support, from Oracle, for 5.2.x. Additional clarification that addition to hosts is not required. --- .../virtualbox-ose-additions-legacy/pkg-descr | 22 +++++++++++++------ 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-descr b/emulators/virtualbox-ose-additions-legacy/pkg-descr index e93c940f7f4a3..0aaa5a3ae6959 100644 --- a/emulators/virtualbox-ose-additions-legacy/pkg-descr +++ b/emulators/virtualbox-ose-additions-legacy/pkg-descr @@ -1,9 +1,17 @@ -These additions are for installation inside a FreeBSD guest. +For any serious and interactive use, the Oracleⓡ VM VirtualBoxⓡ +Guest Additions will make your life much easier by providing closer +integration between host and guest and improving the interactive +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. -WWW: https://www.virtualbox.org/ +Where legacy (5.2.x) is a requirement, this FreeBSD-provided package +can be installed in the FreeBSD guest machine. + + emphasises that +5.2.x is no longer supported by Oracle. + +Addition to host machines is not required. + +WWW: https://www.virtualbox.org/manual/UserManual.html#guestadditions From df4f870eb5824eb8ba8e215f1f2879875ef5aa60 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 10 Oct 2021 10:33:45 +0100 Subject: [PATCH 04/17] Update the legacy package description Emphasis on the legacy nature of this port; and the more general end of support, from Oracle, for 5.2.x. --- emulators/virtualbox-ose-legacy/pkg-descr | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/emulators/virtualbox-ose-legacy/pkg-descr b/emulators/virtualbox-ose-legacy/pkg-descr index e9481f3a81fad..12b5e129dc4da 100644 --- a/emulators/virtualbox-ose-legacy/pkg-descr +++ b/emulators/virtualbox-ose-legacy/pkg-descr @@ -1,7 +1,15 @@ -VirtualBox is a family of powerful x86 virtualization products for -enterprise as well as home use. Not only is VirtualBox an extremely +Oracleⓡ 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 i.e. emulators/virtualbox-ose is recommended for most use cases. + +Where legacy (5.2.x) is a requirement, this FreeBSD-provided package +can be installed in the FreeBSD host machine. + + emphasises that +5.2.x is no longer supported by Oracle. + WWW: https://www.virtualbox.org/ From 41c24e72265f53fcb0f9ca6a97f824b9a1ab20c3 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 10 Oct 2021 10:50:49 +0100 Subject: [PATCH 05/17] Update legacy pkg-message, partly for bug 254266 Stringing together of commands, to not require a reboot of the guest following installation. explains the appropriateness of VBoxSVGA for non-legacy additions. I don't know (can not recall) enough about legacy additions to tell whether users should be directed to prefer something other than VMSVGA. identifies a likely workaround for the kernel panicking at FreeBSD guest boot time. Re: this bug may be less likely to bite with legacy additions, in my estimation it's reasonable for this package message to mention neither the bug, nor the workaround. --- .../pkg-message | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-message b/emulators/virtualbox-ose-additions-legacy/pkg-message index e8b5c6a5edfa3..9baa5b8b954cf 100644 --- a/emulators/virtualbox-ose-additions-legacy/pkg-message +++ b/emulators/virtualbox-ose-additions-legacy/pkg-message @@ -1,23 +1,24 @@ [ { type: install message: < Date: Sun, 17 Oct 2021 03:35:47 +0100 Subject: [PATCH 06/17] Make pkg-message advice more resilient to panics `sync` before `service vboxguest start` --- emulators/virtualbox-ose-additions/pkg-message | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message index 264ab38cb34cf..592d6b1350565 100644 --- a/emulators/virtualbox-ose-additions/pkg-message +++ b/emulators/virtualbox-ose-additions/pkg-message @@ -5,8 +5,8 @@ Oracleⓡ VirtualBoxⓡ Guest Additions are installed. To enable and start the required services: -# sysrc vboxguest_enable="YES" && service vboxguest start -# sysrc vboxservice_enable="YES" && service vboxservice start +# sysrc vboxguest_enable="YES" ; sync ; service vboxguest start +# sysrc vboxservice_enable="YES" ; service vboxservice start The vboxguest service will load a required kernel module. If a kernel panic (system crash) occurs, this may be avoided by From 571ebe9cc74e210c3f82f1ce0254f60028d96606 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 17 Oct 2021 04:56:20 +0100 Subject: [PATCH 07/17] Make legacy package message advice consistent Consistency with: https://github.com/freebsd/freebsd-ports/pull/115/commits/2cdeeef04cfaefaaec3fd32c119680fdaa769ae1#diff-01b82cb561ad6c59937469270ae848f3d63dc40228678b4a1ef02cdf48ecc889R8-R9 --- emulators/virtualbox-ose-additions-legacy/pkg-message | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-message b/emulators/virtualbox-ose-additions-legacy/pkg-message index 9baa5b8b954cf..dc4420eef9b87 100644 --- a/emulators/virtualbox-ose-additions-legacy/pkg-message +++ b/emulators/virtualbox-ose-additions-legacy/pkg-message @@ -5,8 +5,8 @@ Oracleⓡ VirtualBoxⓡ Guest Additions are installed. To enable and start the required services: -# sysrc vboxguest_enable="YES" && service vboxguest start -# sysrc vboxservice_enable="YES" && service vboxservice start +# sysrc vboxguest_enable="YES" ; sync ; service vboxguest start +# sysrc vboxservice_enable="YES" ; service vboxservice start The vboxguest service will load a required kernel module. From 266c327d18d9edf045f422d635ff879fa8b9e351 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 17 Oct 2021 21:00:50 +0100 Subject: [PATCH 08/17] =?UTF-8?q?Remove=20'Oracle'=20and=20=E2=93=A1=20fro?= =?UTF-8?q?m=20legacy=20package=20message?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- emulators/virtualbox-ose-additions-legacy/pkg-message | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-message b/emulators/virtualbox-ose-additions-legacy/pkg-message index dc4420eef9b87..e1c95a79ac4a7 100644 --- a/emulators/virtualbox-ose-additions-legacy/pkg-message +++ b/emulators/virtualbox-ose-additions-legacy/pkg-message @@ -1,7 +1,7 @@ [ { type: install message: < Date: Sun, 17 Oct 2021 21:09:31 +0100 Subject: [PATCH 09/17] Improve legacy package description MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove 'Oracle' and ⓡ. I don't know what was meant by 'interactive performance of guest systems'. Instead: 'performance of guest systems'. --- emulators/virtualbox-ose-additions-legacy/pkg-descr | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-descr b/emulators/virtualbox-ose-additions-legacy/pkg-descr index 0aaa5a3ae6959..2eeb2d7c92d1e 100644 --- a/emulators/virtualbox-ose-additions-legacy/pkg-descr +++ b/emulators/virtualbox-ose-additions-legacy/pkg-descr @@ -1,7 +1,5 @@ -For any serious and interactive use, the Oracleⓡ VM VirtualBoxⓡ -Guest Additions will make your life much easier by providing closer -integration between host and guest and improving the interactive -performance of guest systems. +VirtualBox Guest Additions provide closer integration between host and +guest, and improve the performance of guest systems. Non-legacy additions i.e. emulators/virtualbox-ose-additions are recommended for most use cases. @@ -14,4 +12,4 @@ can be installed in the FreeBSD guest machine. Addition to host machines is not required. -WWW: https://www.virtualbox.org/manual/UserManual.html#guestadditions +WWW: https://www.virtualbox.org/ From 509a45e685aa90d9737807f0eedfd88eea32fbbb Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 17 Oct 2021 21:18:17 +0100 Subject: [PATCH 10/17] =?UTF-8?q?=20Remove=20'Oracle'=20and=20=E2=93=A1=20?= =?UTF-8?q?from=20package=20message?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- emulators/virtualbox-ose-additions/pkg-message | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message index 592d6b1350565..2b6dda02dfead 100644 --- a/emulators/virtualbox-ose-additions/pkg-message +++ b/emulators/virtualbox-ose-additions/pkg-message @@ -1,7 +1,7 @@ [ { type: install message: < Date: Sun, 17 Oct 2021 21:24:23 +0100 Subject: [PATCH 11/17] Improve package description MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove 'Oracle' and ⓡ. I don't know what was meant by 'interactive performance of guest systems'. Instead: 'performance of guest systems'. --- emulators/virtualbox-ose-additions/pkg-descr | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/emulators/virtualbox-ose-additions/pkg-descr b/emulators/virtualbox-ose-additions/pkg-descr index 66fec4b7a63fc..252763d234d12 100644 --- a/emulators/virtualbox-ose-additions/pkg-descr +++ b/emulators/virtualbox-ose-additions/pkg-descr @@ -1,10 +1,8 @@ -For any serious and interactive use, the Oracleⓡ VM VirtualBoxⓡ -Guest Additions will make your life much easier by providing closer -integration between host and guest and improving the interactive -performance of guest systems. +VirtualBox Guest Additions provide closer integration between host and +guest, and improve the performance of guest systems. This FreeBSD-provided package can be installed in FreeBSD guest machines. Addition to host machines is not required. -WWW: https://www.virtualbox.org/manual/UserManual.html#guestadditions +WWW: https://www.virtualbox.org/ From 2ebbfebb72fb901c37ee7d66b5d6c92cd3c0da42 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Sun, 17 Oct 2021 21:29:05 +0100 Subject: [PATCH 12/17] =?UTF-8?q?Remove=20=E2=93=A1=20from=20the=20legacy?= =?UTF-8?q?=20package=20description?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- emulators/virtualbox-ose-legacy/pkg-descr | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/emulators/virtualbox-ose-legacy/pkg-descr b/emulators/virtualbox-ose-legacy/pkg-descr index 12b5e129dc4da..b466465d3d7a8 100644 --- a/emulators/virtualbox-ose-legacy/pkg-descr +++ b/emulators/virtualbox-ose-legacy/pkg-descr @@ -1,4 +1,4 @@ -Oracleⓡ VirtualBoxⓡ is a family of powerful x86 virtualization products +Oracle 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 From 34b647ff8371cf96387406ddc4db970c6f13bfe8 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Mon, 18 Oct 2021 05:10:26 +0100 Subject: [PATCH 13/17] Improve the legacy package description Less like marketing literature. A shortlist (non-comprehensive) of supported guests. macOS is not mentioned; if users of Apple hardware have an interest, they can refer to Oracle documentation to discover the state of things. A short paragraph for the Extension Pack. --- emulators/virtualbox-ose-legacy/pkg-descr | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/emulators/virtualbox-ose-legacy/pkg-descr b/emulators/virtualbox-ose-legacy/pkg-descr index b466465d3d7a8..3cbcee41e1608 100644 --- a/emulators/virtualbox-ose-legacy/pkg-descr +++ b/emulators/virtualbox-ose-legacy/pkg-descr @@ -1,15 +1,19 @@ -Oracle 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. -Non-legacy i.e. emulators/virtualbox-ose is recommended for most use cases. +emulators/virtualbox-ose is recommended for most use cases. -Where legacy (5.2.x) is a requirement, this FreeBSD-provided package -can be installed in the FreeBSD host machine. +emulators/virtualbox-ose-legacy is for exceptional legacy (5.2.x) cases. 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/ From 8dfdbfa30653e1fb29d1afcfa36a3ad9f7ea3c36 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Mon, 18 Oct 2021 05:19:45 +0100 Subject: [PATCH 14/17] Improve the primary package description Less like marketing literature. A shortlist (non-comprehensive) of supported guests. macOS is not mentioned; if users of Apple hardware have an interest, they can refer to Oracle documentation to discover the state of things. A short paragraph for the Extension Pack. --- emulators/virtualbox-ose/pkg-descr | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/emulators/virtualbox-ose/pkg-descr b/emulators/virtualbox-ose/pkg-descr index e9481f3a81fad..00b5a889853e2 100644 --- a/emulators/virtualbox-ose/pkg-descr +++ b/emulators/virtualbox-ose/pkg-descr @@ -1,7 +1,12 @@ -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: + + 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/ From 77cbe56234b4eb4d81739ded8beab0ad7b36ea91 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Mon, 18 Oct 2021 19:53:37 +0100 Subject: [PATCH 15/17] Exclude use of service(8) from legacy pkg-message --- emulators/virtualbox-ose-additions-legacy/pkg-message | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/emulators/virtualbox-ose-additions-legacy/pkg-message b/emulators/virtualbox-ose-additions-legacy/pkg-message index e1c95a79ac4a7..26cf8915c21d8 100644 --- a/emulators/virtualbox-ose-additions-legacy/pkg-message +++ b/emulators/virtualbox-ose-additions-legacy/pkg-message @@ -3,12 +3,12 @@ message: < Date: Mon, 18 Oct 2021 19:58:07 +0100 Subject: [PATCH 16/17] Exclude use of service(8) from pkg-message --- emulators/virtualbox-ose-additions/pkg-message | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message index 2b6dda02dfead..5c5dffb1cb1d1 100644 --- a/emulators/virtualbox-ose-additions/pkg-message +++ b/emulators/virtualbox-ose-additions/pkg-message @@ -5,12 +5,12 @@ VirtualBox Guest Additions are installed. To enable and start the required services: -# sysrc vboxguest_enable="YES" ; sync ; service vboxguest start -# sysrc vboxservice_enable="YES" ; service vboxservice start +# sysrc vboxguest_enable="YES" +# sysrc vboxservice_enable="YES" -The vboxguest service will load a required kernel module. If a -kernel panic (system crash) occurs, this may be avoided by -limiting the FreeBSD guest to one CPU. +To start the services, restart the system. If a kernel panic (system crash) +occurs during startup, this may be avoided by limiting the FreeBSD guest to +one CPU. For features such as window scaling and clipboard sharing, membership of the wheel group is required. With username jerry as an example: From e5b25c7b1bc21f31de24e4e184e09273841718c1 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Mon, 18 Oct 2021 21:15:50 +0100 Subject: [PATCH 17/17] pkg-message clarity re: startup panic situations --- emulators/virtualbox-ose-additions/pkg-message | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/emulators/virtualbox-ose-additions/pkg-message b/emulators/virtualbox-ose-additions/pkg-message index 5c5dffb1cb1d1..08a27d229335e 100644 --- a/emulators/virtualbox-ose-additions/pkg-message +++ b/emulators/virtualbox-ose-additions/pkg-message @@ -8,9 +8,10 @@ To enable and start the required services: # sysrc vboxguest_enable="YES" # sysrc vboxservice_enable="YES" -To start the services, restart the system. If a kernel panic (system crash) -occurs during startup, this may be avoided by limiting the FreeBSD guest to -one CPU. +To start the services, restart the system. + +In some situations, a panic will occur when the kernel module loads. +Having no more than one virtual CPU might mitigate the issue. For features such as window scaling and clipboard sharing, membership of the wheel group is required. With username jerry as an example: