Building cxoffice-wine from source - Virtual Machines & Debian/KDE | Request for Comments

202506_b5c2845d-290a-44cd-ae2e-0f902f6d5173

Audience

• Users that are new to building cxoffice-wine from source
• Users experienced in building cxoffice-wine from source
• cxoffice-wine developers

References

Introduction

This text documents a step-by-step procedure for building cxoffice-wine reproducibly from source.
To that end separate Virtual Machines running out-of-the box Debian/KDE are used.
All packages mentioned are from the default Debian repositories.

Special Thanks

My thanks to all the authors and contributors to the publications referenced in this text.

Intended outcome

The aim is to provide an easy to follow QuickStart instruction on how to build cxoffice-wine from the source code provided by CodeWeavers, just like a number of the referenced publications intend to do for Wine.

In this procedure, a container approach similar to REF05 is used with the difference being the use of Virtual Machines and completely separate set-ups for the 64-bit and 32-bit build environments. This allows for independent debugging of the set-ups without having to worry about dependency issues, as well as cloning of (intermediate) known-good states, making debugging easier.

In case something goes wrong, the ISSUES listed and output messages included (for erroneous as well as some for normal behaviour) may help with identifying the cause.

Finally, a LookUpTable is given at the end of this text which details configure-script messages/warnings, and commands to address those.

As the environments consist of out-of-the box Debian, the procedure should work for Debian and derivatives.

It would be appreciated, if readers could

• comment on any bugs in this text

• comment on any improvements/simplifications that could be made

• comment on whether they can reproduce any or all of the issues listed

• comment on other issues they experience (ideally with potential fixes/workarounds)

• improve the cxoffice-wine source code .tar.gz and the configure-script to address some of the ISSUES, if they have the means to do so

• publish a best practice on how to work around ISSUE06 on a Multi-Arch installation

  ISSUE06 seems to be the single issue that makes building on Multi-Arch messy, any recommendations would help

Versions

• Debian 12.10.0 with KDE

• VirtualBox 7.1.8 with GuestAdditions

• cxoffice 25.0.1 (identifies as wine-10.0)

Issues found

• ISSUE01:

  distversion.h missing from /mnt/RAMdisk/sources/wine/programs/winedbg/ causing make to fail, as reported by Marton Sari in REF02.

  The issue was raised as (requires login) https://www.codeweavers.com/support/tickets/browse/?ticket_id=1470720.

  ../wine/programs/winedbg/resource.h:23: error: distversion.h: No such file or directory
  ../wine/programs/winedbg/crashdlg.c:29: note: resource.h was first included here
  config.status: error: could not create Makefile

• ISSUE02:

  Running configure for wine.wow64 with --with-wine64 but without --with-wine-tools fails.

  ./config.status: 534: ../wine.win64/tools/makedep: Exec format error
  config.status: error: could not create Makefile

• ISSUE03:

  When using a relative path for configure like --with-wine64=../wine.win64, then as a result the generated Makefile points to a non-existing directory, namely ../../wine.win64 instead of ../wine.win64.

  Note: configure also appears to dislike '~/'.

  rm -f loader/wine64 && cp -pR ../../wine.win64/loader/wine64 loader/wine64
  rm -f loader/wine64-preloader && cp -pR ../../wine.win64/loader/wine64-preloader loader/wine64-preloader
  rm -f ../wine.win64/loader/wine && cp -pR /home/vbox/RAMdisk/sources/wine.wow64/loader/wine ../wine.win64/loader/wine
  rm -f ../wine.win64/loader/wine-preloader && cp -pR /home/vbox/RAMdisk/sources/wine.wow64/loader/wine-preloader ../wine.win64/loader/wine-preloader
  cp: cannot stat '../../wine.win64/loader/wine64': No such file or directory
  cp: cannot stat '../../wine.win64/loader/wine64-preloader': No such file or directory
  cp: cannot stat '/home/vbox/RAMdisk/sources/wine.wow64/loader/wine-preloader': No such file or directory
  cp: cannot stat '/home/vbox/RAMdisk/sources/wine.wow64/loader/wine': No such file or directory
  make: *** [Makefile:1468: loader/wine64] Error 1
  make: *** Waiting for unfinished jobs....
  make: *** [Makefile:1468: loader/wine64-preloader] Error 1
  make: *** [Makefile:1470: ../wine.win64/loader/wine] Error 1
  make: *** [Makefile:1472: ../wine.win64/loader/wine-preloader] Error 1

• ISSUE04:

  configure attempts to copy non-existing files wine and wine-preloader.

  rm -f loader/wine64 && cp -pR /home/vbox/RAMdisk/sources/wine.win64/loader/wine64 loader/wine64
  rm -f loader/wine64-preloader && cp -pR /home/vbox/RAMdisk/sources/wine.win64/loader/wine64-preloader loader/wine64-preloader
  rm -f /home/vbox/RAMdisk/sources/wine.win64/loader/wine && cp -pR /home/vbox/RAMdisk/sources/wine.wow64/loader/wine /home/vbox/RAMdisk/sources/wine.win64/loader/wine
  rm -f /home/vbox/RAMdisk/sources/wine.win64/loader/wine-preloader && cp -pR /home/vbox/RAMdisk/sources/wine.wow64/loader/wine-preloader /home/vbox/RAMdisk/sources/wine.win64/loader/wine-preloader
  cp: cannot stat '/home/vbox/RAMdisk/sources/wine.wow64/loader/wine': No such file or directory
  cp: cannot stat '/home/vbox/RAMdisk/sources/wine.wow64/loader/wine-preloader': No such file or directory
  make: *** [Makefile:1470: /home/vbox/RAMdisk/sources/wine.win64/loader/wine] Error 1
  make: *** Waiting for unfinished jobs....
  make: *** [Makefile:1472: /home/vbox/RAMdisk/sources/wine.win64/loader/wine-preloader] Error 1

• ISSUE05:

  wine.wow64 make install on the target fails, if the wine.wow64 make install on the 32-bit build system was omitted earlier.

  gcc -c -o dlls/msvcr70/mathf.o ../wine/dlls/msvcrt/mathf.c -Idlls/msvcr70 -I../wine/dlls/msvcr70 \
    -I../wine/dlls/msvcrt -Iinclude -I../wine/include -I../wine/include/msvcrt -D_MSVCR_VER=70 \
    -D__WINESRC__ -D_CRTIMP= -Wall -pipe -fcf-protection=none -fvisibility=hidden -fno-stack-protector \
    -fno-strict-aliasing -Wdeclaration-after-statement -Wempty-body -Wignored-qualifiers -Winit-self \
    -Wlogical-op -Wno-packed-not-aligned -Wpointer-arith -Wshift-overflow=2 -Wstrict-prototypes \
    -Wtype-limits -Wunused-but-set-parameter -Wvla -Wwrite-strings -Wno-misleading-indentation \
    -gdwarf-4 -fno-PIC -fasynchronous-unwind-tables -D_WIN32 -fno-builtin -fshort-wchar -Wno-format \
    -fno-omit-frame-pointer -g -O2
  ../wine/dlls/msvcrt/mathf.c:62:7: error: conflicting types for ￢ﾀﾘpowf￢ﾀﾙ; have ￢ﾀﾘfloat(float,  float)￢ﾀﾙ
     62                          | float powf(float x, float y) { return pow(x, y); }
        |       ^~~~
  ../wine/dlls/msvcrt/mathf.c:39:15: note: previous declaration of ￢ﾀﾘpowf￢ﾀﾙ with type ￢ﾀﾘfloat(float,  float)￢ﾀﾙ
     39                          | float __cdecl powf(float, float);
        |               ^~~~
  make: *** [Makefile:126958: dlls/msvcr70/mathf.o] Error 1

• ISSUE06:

  Installing libgstreamer-plugins-base1.0-dev:i386 and libgstreamer-plugins-base1.0-dev fails on Multi-Arch systems.

  According to Helmut Grohne REF06, this is because of GstAudio-1.0.gir.

  The following packages have unmet dependencies:
   libgstreamer-plugins-base1.0-dev : Conflicts: libgstreamer-plugins-base1.0-dev:i386 but 1.22.0-3+deb12u4 is to be installed
   libgstreamer-plugins-base1.0-dev:i386 : Conflicts: libgstreamer-plugins-base1.0-dev but 1.22.0-3+deb12u4 is to be installed

• ISSUE07:

  According to REF07 oss4-dev is not supported by Debian.

  OSS4 packages are, as of March 2020, present only in DebianUnstable and DebianOldOldStable.

• ISSUE08:

  Installing libpcsclite-dev:i386 on a Multi-Arch system fails due to Python dependency conflicts.

  This odd issue occurs when using

  sudo apt-get install libpcsclite-dev:i386
  
  The following packages have unmet dependencies:
   python3 : PreDepends: python3-minimal (= 3.11.2-1+b1) but it is not going to be installed
      Depends: python3.11 (>= 3.11.2-1~) but it is not going to be installed
  E: Error, pkgProblemResolver::Resolve generated breaks, this may be caused by held packages.

  Warning:

  It was also noticed that when libpcsclite-dev was already installed on the Multi-Arch system, installing libpcsclite-dev:i386 results in apt-get trying to remove a large number of files, potentially wrecking the system.

  Using this command instead seems to work around the issue

  sudo apt-get install libpcsclite-dev:i386 libpcsclite-dev

Prerequisites

1. Host with RAMdisk mounted as /mnt/RAMdisk/ and used as SharedDrive, containing

   • cxoffice-wine source code from REF01

   • distversion.h from REF02, included in Appendix "Reprint of distversion.h" of this text

   • 64-bit Windows test program

     E.g. "HelloWorld64.exe" built from VisualStudio's default console program "helloworld"

   • 32-bit Windows test program

     E.g. "HelloWorld32.exe" built from VisualStudio's default console program "helloworld"

2. VirtualBox Virtual Machines

   • 8 cores in this example, adjust as required

   • Debian & KDE

   • user "vbox"

   • no previous cxoffice-wine or Wine installation and

   • SharedDrive mounted as /home/vbox/RAMdisk

   with

   1. VM-64: Virtual Machine, amd64

      Packages added as part of the GuestAdditions installation

      sudo apt-get install gcc make perl linux-headers-6.1.0.37-amd64 synaptic

   2. VM-32: Virtual Machine, i386

      Packages added as part of the GuestAdditions installation

      sudo apt-get install gcc make perl linux-headers-6.1.0.37-686-pae synaptic

   3. VM-Tgt: Virtual Machine with standard CrossOver installation

      As per REF08

   4. VM-Bi: Virtual Machine, Multi-Arch, optional

      Not used for the build procedure, but to verify the validity of the LookUpTable Multi-Arch content

      Packages added as part of the GuestAdditions installation

      sudo apt-get install gcc make perl linux-headers-6.1.0.37-amd64 synaptic

      Added i386 architecture

      sudo dpkg --add-architecture i386
      sudo apt update

Initial steps

Host

1. Change to SharedDrive

   cd /mnt/RAMdisk/

2. Extract source code

   tar -xf crossover-sources-25.0.1.tar.gz

3. Copy distversion.h to winedbg directory to work around ISSUE01

   cp distversion.h sources/wine/programs/winedbg/

4. Create build directories

   cd sources/
   
   mkdir wine.win64 wine.win32 wine.wow64

VM-64 & VM-32

1. Install Debian development packages as per LookUpTable

   Commands 02 through 28 (g++ to libgstreamer-plugins-base1.0-dev).

VM-Tgt

1. Install gcc-mingw-w64 to enable make install step

   sudo apt-get install gcc-mingw-w64

   Without gcc-mingw-w64 the make install step on the target fails with

   STRIPPROG="strip" ../wine/tools/install-sh  server/wineserver /usr/local/bin/wineserver
   tools/winebuild/winebuild -w --implib -o dlls/aclui/libaclui.a -m64 --export ../wine/dlls/aclui/aclui.spec
   tools/winebuild/winebuild -w --implib -o dlls/aclui/x86_64-windows/libaclui.a --without-dlltool -b x86_64-w64-mingw32 --export \
     ../wine/dlls/aclui/aclui.spec
   winebuild : No such file or directory
   make: *** [Makefile:1624: dlls/aclui/x86_64-windows/libaclui.a] Error 1

VM-Bi, if interested in verifying LookUpTable Multi-Arch content

1. Install Debian development packages as per LookUpTable

   Commands 01 to 28 (gcc-multilib to libgstreamer-plugins-base1.0-dev)

Building 64-bit cxoffice-wine

VM-64

These steps are per REF03, REF04 "64-bit version" and REF05 "Build 64-bit Wine".

1. Change to wine.win64 build directory on SharedDrive

   cd $HOME/RAMdisk/sources/wine.win64/

2. Run configure

   ../wine/configure --enable-win64

3. Build cxoffice-wine 64-bit

   make -j8

4. Check that cxoffice-wine 64-bit was built correctly

   WINEARCH=win64 WINEPREFIX=$HOME/wine.win64.noinst ./wine64 winecfg
   
   wine: created the configuration directory '/home/vbox/wine.win64.noinst'
   002c:fixme:actctx:parse_depend_manifests Could not find dependent assembly L"Microsoft.Windows.Common-Controls" (6.0.0.0)
   002c:fixme:shell:create_link failed to connect to mount manager
   002c:fixme:shell:create_link failed to connect to mount manager
   wine: could not load ntdll.so: /home/vbox/RAMdisk/sources/wine.win64/dlls/ntdll/ntdll.so: wrong ELF class: ELFCLASS64
   002c:fixme:msg:pack_message msg 14 (WM_ERASEBKGND) not supported yet
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0128:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0128:err:setupapi:do_file_copyW Unsupported style(s) 0x10

   and

   WINEARCH=win64 WINEPREFIX=$HOME/wine.win64.noinst ./wine64 $HOME/RAMdisk/HelloWorld64.exe
   
   Hello World!

Building 32-bit cxoffice-wine

VM-32

These steps are as per REF04 "chroot or container" (wine32-tools) and REF05 "Build 32-bit Wine" (wine32-tools).

1. Change to wine.win32 build directory on SharedDrive

   cd $HOME/RAMdisk/sources/wine.win32/

2. Run configure

   ../wine/configure

3. Build cxoffice-wine 32-bit

   make -j8

4. Check that cxoffice-wine 32-bit was built correctly

   WINEARCH=win32 WINEPREFIX=$HOME/wine.win32.noinst ./wine winecfg
   
   wine: created the configuration directory '/home/vbox/wine.win32.noinst'
   002c:fixme:actctx:parse_depend_manifests Could not find dependent assembly L"Microsoft.Windows.Common-Controls" (6.0.0.0)
   002c:fixme:shell:create_link failed to connect to mount manager
   002c:fixme:shell:create_link failed to connect to mount manager
   002c:fixme:msg:pack_message msg 14 (WM_ERASEBKGND) not supported yet
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0120:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0120:err:setupapi:do_file_copyW Unsupported style(s) 0x10

   and

   WINEARCH=win32 WINEPREFIX=$HOME/wine.win32.noinst ./wine $HOME/RAMdisk/HelloWorld32.exe
   
   Hello World!

Building 64/32-bit cxoffice-wine

VM-32, continued

1. Change to wine.wow64 build directory on SharedDrive

   cd $HOME/RAMdisk/sources/wine.wow64/

Attempt build of cxoffice-wine as per REF03 - fails with ISSUE02

1. Run configure using option --with-wine64 only

   ../wine/configure --with-wine64=../wine.win64

Attempt build of cxoffice-wine as per REF04 "chroot or container" (wine32-combo) - fails with ISSUE03

1. Run configure using options --with-wine64 and --with-wine-tools and relative paths ("../")

   ../wine/configure --with-wine64=../wine.win64 --with-wine-tools=../wine.win32

2. Build cxoffice-wine

   make -j8

Attempt build of cxoffice-wine as per REF05 "Build 32-bit Wine" (wine32) - fails with ISSUE04

1. Run configure using options --with-wine64 and --with-wine-tools and absolute paths ("$HOME/")

   ../wine/configure --with-wine64=$HOME/RAMdisk/sources/wine.win64 --with-wine-tools=$HOME/RAMdisk/sources/wine.win32

2. Build cxoffice-wine

   make -j8

Build cxoffice-wine as per REF05 "Build 32-bit Wine" (wine32), but with manual modifications to Makefile

1. Run configure using options --with-wine64 and --with-wine-tools and absolute paths ("$HOME/")

   ../wine/configure --with-wine64=$HOME/RAMdisk/sources/wine.win64 --with-wine-tools=$HOME/RAMdisk/sources/wine.win32

2. Edit Makefile to comment out the steps for copying wine and wine-preloader (lines 1470 & 1472)

   /home/vbox/RAMdisk/sources/wine.win64/loader/wine:
   #   rm -f $@ && $(LN_S) /home/vbox/RAMdisk/sources/wine.wow64/loader/wine $@
   /home/vbox/RAMdisk/sources/wine.win64/loader/wine-preloader:
   #   rm -f $@ && $(LN_S) /home/vbox/RAMdisk/sources/wine.wow64/loader/wine-preloader $@

3. Build cxoffice-wine

   make -j8

4. Copy wine and wine-preloader, which seems to be what Makefile intended

   rm -f /home/vbox/RAMdisk/sources/wine.win64/loader/wine && cp -pR /home/vbox/RAMdisk/sources/wine.wow64/loader/wine /home/vbox/RAMdisk/sources/wine.win64/loader/wine
   
   rm -f /home/vbox/RAMdisk/sources/wine.win64/loader/wine-preloader && cp -pR /home/vbox/RAMdisk/sources/wine.wow64/loader/wine-preloader /home/vbox/RAMdisk/sources/wine.win64/loader/wine-preloader

5. Install cxoffice-wine

   Without this step the installation on the target fails with ISSUE05.

   sudo make install

6. Check that cxoffice-wine 32-bit installation worked

   WINEARCH=win32 WINEPREFIX=$HOME/wine.wow64.inst32 wine winecfg
   
   err:environ:read_nls_file failed to load /usr/local/bin/../share/wine/nls/locale.nls
   err:environ:read_nls_file failed to load /usr/local/bin/../share/wine/nls/l_intl.nls
   wine: created the configuration directory '/home/vbox/wine.wow64.inst32'
   wine: could not exec wineserver

7. Uninstall cxoffice-wine

   sudo make uninstall
   
   rmdir: failed to remove '/usr/local/lib': Directory not empty
   make: [Makefile:274293: uninstall] Error 1 (ignored)

VM-Tgt

1. Change to wine.wow64 build directory on SharedDrive

   cd $HOME/RAMdisk/sources/wine.wow64/

2. Install cxoffice-wine 32-bit

   sudo make install

3. Change to wine.win64 build directory on SharedDrive

   cd $HOME/RAMdisk/sources/wine.win64/

4. Install cxoffice-wine 64-bit

   sudo make install

5. Check that cxoffice-wine 32-bit installation worked

   WINEARCH=win32 WINEPREFIX=$HOME/wine.wow64.inst32 wine winecfg
   
   wine: created the configuration directory '/home/vbox/wine.wow64.inst32'
   002c:fixme:actctx:parse_depend_manifests Could not find dependent assembly L"Microsoft.Windows.Common-Controls" (6.0.0.0)
   002c:fixme:shell:create_link failed to connect to mount manager
   002c:fixme:shell:create_link failed to connect to mount manager
   002c:fixme:msg:pack_message msg 14 (WM_ERASEBKGND) not supported yet
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0120:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0120:err:setupapi:do_file_copyW Unsupported style(s) 0x10

   and

   WINEARCH=win32 WINEPREFIX=$HOME/wine.wow64.inst32 wine $HOME/RAMdisk/HelloWorld32.exe
   
   Hello World!

6. Check that cxoffice-wine 64-bit installation worked

   WINEARCH=win64 WINEPREFIX=$HOME/wine.wow64.inst64 wine winecfg
   
   wine: created the configuration directory '/home/vbox/wine.wow64.inst64'
   002c:fixme:actctx:parse_depend_manifests Could not find dependent assembly L"Microsoft.Windows.Common-Controls" (6.0.0.0)
   002c:fixme:shell:create_link failed to connect to mount manager
   002c:fixme:shell:create_link failed to connect to mount manager
   010c:fixme:msg:pack_message msg 14 (WM_ERASEBKGND) not supported yet
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0130:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   002c:err:setupapi:do_file_copyW Unsupported style(s) 0x10
   0130:err:setupapi:do_file_copyW Unsupported style(s) 0x10

   and

   WINEARCH=win64 WINEPREFIX=$HOME/wine.wow64.inst64 wine $HOME/RAMdisk/HelloWorld64.exe
   
   Hello World!

Fin

Addendum - Reprint of distversion.h REF02

    /* ---------------------------------------------------------------
    *   distversion.c
    *
    * Copyright 2013, CodeWeavers, Inc.
    *
    * Information from DISTVERSION which needs to find
    * its way into the wine tree.
    * --------------------------------------------------------------- */

    #define WINDEBUG_WHAT_HAPPENED_MESSAGE "This can be caused by a problem in the program or a deficiency in Wine. You may want to check <a href=\"http://www.codeweavers.com/compatibility/\">http://www.codeweavers.com/compatibility/</a> for tips about running this application."

    #define WINDEBUG_USER_SUGGESTION_MESSAGE "If this problem is not present under Windows and has not been reported yet, you can save the detailed information to a file using the \"Save As\" button, then <a href=\"http://www.codeweavers.com/support/tickets/enter/\">file a bug report</a> and attach that file to the report."

Addendum - LookUpTable

This LookUpTable lists

• Commands needed to install the packages required to address configure-script messages/warnings (number_name)
• Messages/warnings addressed by that particular command (number_Msg-index)

Observed issues:

• libgstreamer-plugins-base1.0-dev on Multi-Arch causes ISSUE06
• OSS4 is not included in this LookUpTable because of ISSUE07
• libpcsclite-dev:i386 on Multi-Arch may cause issues, see ISSUE08

Recommendation:

Use apt-get install --simulate first before modifying a system, this may avoid some grief with dependency conflicts and inadvertently removed packages.

well, this guide is really detailed and thats good since people can easily follow it