Skip to content

build_multilib_wine (1) : man page

Jump to bottom
Robert Walker edited this page Jun 5, 2019 · 3 revisions

build_multilib_wine(1)

build_multilib_wine - monolithic BASH script to build multilib Wine, from source, on Debian or Ubuntu™

Synopsis

build_multilib_wine [ --colour=... ] [ --logging=... ] [ --log-compression... ] [--log-directory=... ] [ *OPTION (build phase) [ ... *OPTION (build phase) ] ] [--] [ src-fetch ] [ src-prepare ] [ src-configure ] [ src-compile ] [ src-install ] | build-all
build_multilib_wine [ --colour=... ] [--] generate-conf
build_multilib_wine [ --colour=... ] [ --logging=... ] [ --log-compression... ] [--log-directory=... ] [--] setup-chroot | upgrade-chroot
build_multilib_wine [ --colour=... ] [--] version


 *OPTION (build phase)

[ --build-directory directory ]
[ --patch-directory directory(1) [ ... --patch-directory directory(N) ] ]
[ --source-directory directory ]
[ --prefix directory ]
--wine-staging="no"  | "false" | "0"  [ --wine-branch=git-branch         | --wine-commit=commit-hash         | --wine-version=numeric-version ]
--wine-staging="yes" | "true"  | "1"  [ --wine-staging-branch=git-branch | --wine-staging-commit=commit-hash | --wine-staging-version=numeric-version ]

Description

This manual page describes the build_multilib_wine command.

The build_multilib_wine script can be used to build Wine, or Wine Staging, with the option to specify multiple directories of additional user patchsets. The script supports building Wine on the Debian and Ubuntu™ Linux distributions (Ubuntu™-derivatives, like Linux-Mint, are also supported). The script uses dual chroot (Schroot) environments (32-bit and 64-bit).

build_multilib_wine supports various simple commands. Note: build phase options can only be combined with build commands.

Exit status:

  • 0: if OK (successful execution),
  • 1: if any error occurs during execution.

Options

Global

  • --colour=[ "yes" | "no" | "true" | "false" | "1" | "0" ]
    Select whether terminal output and logs are colourised or not.

  • --logging=[ "yes" | "no" | "true" | "false" | "1" | "0" ]
    Select whether all terminal output is written to a time/date-stamped log file.

  • --log-compression=[ "bzip2" | "gzip" | "lzma" | "lzop" | "none" | "lz4" | "xz" ]
    Select whether all terminal output is written to a time/date-stamped log file.

  • --log-directory=directory
    Use the specified directory, to store the log file, for the current command.

Build Phases (only)

  • --wine-staging=[ "yes" | "no" | "true" | "false" | "1" | "0" ]
    Select whether to build Wine or Wine Staging.

  • --wine-branch=git-branch
    Select the Wine git branch to build.

  • --wine-commit=commit-hash
    Select a specific Wine git commit to build against.

  • --wine-version=numeric-version
    Select a specific Wine version to build.

  • --wine-staging-branch=git-branch
    Select the Wine Staging git branch to build.

  • --wine-staging-commit=commit-hash
    Select a specific Wine Staging git commit to build against.

  • --wine-staging-version=numeric-version
    Select a specific Wine Staging version to build.

  • --build-directory directory
    Select the root build directory (stores Wine build trees and log files)

  • --patch-directory directory(1) [ ... --patch-directory directory(N) ]
    Specify a directory (or directories) containing user patches.

  • --source-directory directory
    Select the root source directory (stores generic/stock patches, Wine and Wine Staging git trees).

  • --prefix directory
    Specify a target root directory, in which to install the multilib Wine build.
    Note: this must be a subdirectory of the user's "HOME" directory.
    The HOME directory is a writeable mountpoint, accessible within both Schroot environments.

Commands

  • generate-conf
    Generate a stock configuration file for build_multilib_wine. The default location for this newly created configuration file, is: "${HOME}/.config/build_multilib_wine/build_multilib_wine.conf"

  • setup-chroot
    Setup the 32-bit and 64-bit (Schroot) Chroot Environments. This command also installs the Debian / Ubuntu™ base development libraries for Wine, in the dual Chroot Environments.

    Note: this command runs as root.

  • upgrade-chroot
    Upgrade the packages installed to the 32-bit and 64-bit (Schroot) Chroot Environments.

    Note: this command runs as root.

  • version
    Display the script version and exit.

(1)-(5)

  • build-all
    Meta-command, alias for the sequence of commands:
    src-fetch src-prepare src-configure src-compile src-install
    (for further information, see below)

    Note: this command runs as root.

(1)

  • src-fetch
    Run the (git) source fetch phase, for wine, and wine-staging, git trees.
    Note: this command runs as root.

(2)

  • src-prepare
    Run source prepare phase. During this phase, base patches are applied and (BASH/sed) configuration file alterations are made. In addition, during this phase, the Wine Staging patchset and any (specified) user patchsets are applied.

    Note: this command runs as root.

(3)

  • src-configure
    Run source configure phase. This phase is executed once in 32-bit Chroot environment: wine32-tools ; and once in the 64-bit Chroot environment: wine64
    Note: running the configure phase for the 32-bit Chroot: wine32 ; is deferred to the end of the next (src-compile) phase.

    Note: this command runs as root.

(4)

  • src-compile
    Run source compile phase. This phase is executed once in 32-bit Chroot environment: wine32-tools ; and once in the 64-bit Chroot environment: wine64 The (deferred) configure phase for the 32-bit Chroot directory: wine32 ; is run first in this phase. Then the build directory: wine32 ; is compiled.

    Note: this command runs as root.

(5)

  • src-install
    Run source install phase. This phase is executed once for the 32-bit Chroot environment: wine32 ; and once for the 64-bit Chroot environment directory: wine64
    Note: the install prefix must be a subdirectory of the user's HOME directory. This is because the HOME directory is a writeable mountpoint, accessible within both Schroot environments.

    Note: this command runs as root.

Author

Written by Robert Walker <[email protected]>

Reporting Bugs

Please report issues at: Github: bobwya/build-multilib-wine Issues

See Also

build_multilib_wine.conf(5).

Clone this wiki locally