1
0
forked from pool/virtualbox
virtualbox/README.build
Larry Finger d3fa2d0e39 Accepting request 729117 from home:lwfinger:branches:Virtualization
Added file "README.build" with instructions for me and any eventual successors.
- Version update to 6.0.12 (released September 03 2019 by Oracle)
This is a maintenance release. The following items were fixed and/or added:
OCI export: handle empty disk image correctly
API: fix potential crash when using the medium I/O functionality
VBoxManage: fixed documentation of VBoxManage modifyvm uarttype documentation (bug #18759)
Network: scrub inbound TCP URG pointer, working around incorrect OOB handling
USB: Improved identification of power-saved devices on Windows hosts
Audio: in the AC97 work around buggy guest drivers which reprogram the sampling rate, breaking audio in and/or audio out
Linux host and guest: fix kernel module build for SLES 12 SP4 kernel
3D: fixed state saving and loading when the VBoxVGA graphics adapter is used with 3D enabled (bug #18802, 6.0.10 regression)
Windows guests: fixed mouse cursor visibility updating
Windows guests: fixed graphics corruption in Windows 10 search menu with VBoxSVGA adapter
Windows guests: fixed dwm.exe crashes related to the WDDM driver for VBoxSVGA adapter when the VM has lots of RAM
MacOS Guest Additions fail to start in 6.0.10 (bug #18793)
Windows guests: fixed crashes when using shared folders (bug #18766)
Linux guests: unprivileged users unable to create files inside shared folders (bug #18737)
Linux guests: improve compatibility of vboxvideo.ko kernel module build logic (bug #18869)

OBS-URL: https://build.opensuse.org/request/show/729117
OBS-URL: https://build.opensuse.org/package/show/Virtualization/virtualbox?expand=0&rev=502
2019-09-07 19:41:40 +00:00

46 lines
2.6 KiB
Plaintext

Instructions for creating a separate VirtualBox project and building the packages
Although it is possible to modify a project at the openSUSE Build System (OBS),
I have found it to be more convenient to use the various osc commands to create a
local copy, edit it on my own computer to fix any problems, and then push the result
to OBS.
A. Create a new sub-project:
1. Branch the package:
osc branch Virtualization virtualbox
2. Checkout the package using the "osc co" command listed
B. Build the project:
1. Use "osc build" to build. This step is rather compute intensive and
takes about an hour on my Toshiba laptop with a dual-core Intel Core i7 CPU
with hyper-threading, 12 GB RAM, and an SSD.
2. The build results are stored in the /var/tmp/build-root tree. These files
can occupy a lot of disc space, particularly when one builds several flavors.
To keep from running out of space on the / partition, I mount /var/tmp on
a separate partition. At present, I have used about 43 GiB in that partition.
3. Special flavors:
When a new kernel is released, there may be several API changes that affect
builds of the kernel modules used by VirtualBox. In Factory, the project that
contains the latest kernels is "Kernel-HEAD-standard". To run a test build with
this kernel, use the command "osc build Kernel-HEAD-standard". When switching
between kernel projects, use of the "--clean" switch is advised, otherwise
strange "missing library" messages will result.
4. On occasion, there may be breakage in the build when there is an update with
python or Qt. Use the "--alternative-project=<xxx>" switch to force usage of
the revised component.
C. Steps to take with a new release:
1. When Orable releases a new version, you will need to download then new tarball
from https://download.virtualbox.org/virtualbox/. While downloading the file, I
also get the new UserManual.pdf.
2. openSUSE makes some changes to the tarball by running the command
bash ./virtualbox-patch-source.sh <name of tarball just downloaded>
This command unpacks the tar file, makes some modifications to the source, and
recreates the tar file with "patched" in its name. Any further modifications
are made by patches that are applied during the build process. Do NOT make any
further changes to the tar file.
3. Edit the "Version" line near the start of virtualbox.spec to select the new version.
4. Use "osc rm <old version>" and "osc add <new version>" to get the new file into
osc. The local build will work without these changes, but the remote operations
will fail.`