mirror of
https://gitlab.winehq.org/wine/wine.git
synced 2024-11-19 17:06:04 -07:00
bd0656b6e2
Bump minimum version from 8.0 to 12.4, the minimum release supported upstream. Streamline the FreeBSD section.
167 lines
5.2 KiB
Text
167 lines
5.2 KiB
Text
1. INTRODUCTION
|
|
|
|
Wine is a program which allows running Microsoft Windows programs
|
|
(including DOS, Windows 3.x, Win32, and Win64 executables) on Unix.
|
|
It consists of a program loader which loads and executes a Microsoft
|
|
Windows binary, and a library (called Winelib) that implements Windows
|
|
API calls using their Unix, X11 or Mac equivalents. The library may also
|
|
be used for porting Windows code into native Unix executables.
|
|
|
|
Wine is free software, released under the GNU LGPL; see the file
|
|
LICENSE for the details.
|
|
|
|
|
|
2. QUICK START
|
|
|
|
From the top-level directory of the Wine source (which contains this file),
|
|
run:
|
|
|
|
./configure
|
|
make
|
|
|
|
Then either install Wine:
|
|
|
|
make install
|
|
|
|
Or run Wine directly from the build directory:
|
|
|
|
./wine notepad
|
|
|
|
Run programs as "wine program". For more information and problem
|
|
resolution, read the rest of this file, the Wine man page, and
|
|
especially the wealth of information found at https://www.winehq.org.
|
|
|
|
|
|
3. REQUIREMENTS
|
|
|
|
To compile and run Wine, you must have one of the following:
|
|
|
|
Linux version 2.0.36 or later
|
|
FreeBSD 12.4 or later
|
|
Solaris x86 9 or later
|
|
NetBSD-current
|
|
Mac OS X 10.8 or later
|
|
|
|
As Wine requires kernel-level thread support to run, only the operating
|
|
systems mentioned above are supported. Other operating systems which
|
|
support kernel threads may be supported in the future.
|
|
|
|
FreeBSD info:
|
|
See https://wiki.freebsd.org/Wine for more information.
|
|
|
|
Solaris info:
|
|
You will most likely need to build Wine with the GNU toolchain
|
|
(gcc, gas, etc.). Warning : installing gas does *not* ensure that it
|
|
will be used by gcc. Recompiling gcc after installing gas or
|
|
symlinking cc, as and ld to the gnu tools is said to be necessary.
|
|
|
|
NetBSD info:
|
|
Make sure you have the USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG options
|
|
turned on in your kernel.
|
|
|
|
Mac OS X info:
|
|
You need Xcode/Xcode Command Line Tools or Apple cctools. The
|
|
minimum requirements for compiling Wine are clang 3.8 with the
|
|
MacOSX10.10.sdk and mingw-w64 v8. The MacOSX10.14.sdk and later can
|
|
only build wine64.
|
|
|
|
|
|
Supported file systems:
|
|
Wine should run on most file systems. A few compatibility problems
|
|
have also been reported using files accessed through Samba. Also,
|
|
NTFS does not provide all the file system features needed by some
|
|
applications. Using a native Unix file system is recommended.
|
|
|
|
Basic requirements:
|
|
You need to have the X11 development include files installed
|
|
(called xorg-dev in Debian and libX11-devel in Red Hat).
|
|
|
|
Of course you also need "make" (most likely GNU make).
|
|
|
|
You also need flex version 2.5.33 or later and bison.
|
|
|
|
Optional support libraries:
|
|
Configure will display notices when optional libraries are not found
|
|
on your system. See https://wiki.winehq.org/Recommended_Packages for
|
|
hints about the packages you should install. On 64-bit platforms,
|
|
you have to make sure to install the 32-bit versions of these
|
|
libraries.
|
|
|
|
|
|
4. COMPILATION
|
|
|
|
To build Wine, do:
|
|
|
|
./configure
|
|
make
|
|
|
|
This will build the program "wine" and numerous support libraries/binaries.
|
|
The program "wine" will load and run Windows executables.
|
|
The library "libwine" ("Winelib") can be used to compile and link
|
|
Windows source code under Unix.
|
|
|
|
To see compile configuration options, do ./configure --help.
|
|
|
|
For more information, see https://wiki.winehq.org/Building_Wine
|
|
|
|
|
|
5. SETUP
|
|
|
|
Once Wine has been built correctly, you can do "make install"; this
|
|
will install the wine executable and libraries, the Wine man page, and
|
|
other needed files.
|
|
|
|
Don't forget to uninstall any conflicting previous Wine installation
|
|
first. Try either "dpkg -r wine" or "rpm -e wine" or "make uninstall"
|
|
before installing.
|
|
|
|
Once installed, you can run the "winecfg" configuration tool. See the
|
|
Support area at https://www.winehq.org/ for configuration hints.
|
|
|
|
|
|
6. RUNNING PROGRAMS
|
|
|
|
When invoking Wine, you may specify the entire path to the executable,
|
|
or a filename only.
|
|
|
|
For example: to run Notepad:
|
|
|
|
wine notepad (using the search Path as specified in
|
|
wine notepad.exe the registry to locate the file)
|
|
|
|
wine c:\\windows\\notepad.exe (using DOS filename syntax)
|
|
|
|
wine ~/.wine/drive_c/windows/notepad.exe (using Unix filename syntax)
|
|
|
|
wine notepad.exe readme.txt (calling program with parameters)
|
|
|
|
Wine is not perfect, so some programs may crash. If that happens you
|
|
will get a crash log that you should attach to your report when filing
|
|
a bug.
|
|
|
|
|
|
7. GETTING MORE INFORMATION
|
|
|
|
WWW: A great deal of information about Wine is available from WineHQ at
|
|
https://www.winehq.org/ : various Wine Guides, application database,
|
|
bug tracking. This is probably the best starting point.
|
|
|
|
FAQ: The Wine FAQ is located at https://www.winehq.org/FAQ
|
|
|
|
Wiki: The Wine Wiki is located at https://wiki.winehq.org
|
|
|
|
Gitlab: Wine development is hosted at https://gitlab.winehq.org
|
|
|
|
Mailing lists:
|
|
There are several mailing lists for Wine users and developers;
|
|
see https://www.winehq.org/forums for more information.
|
|
|
|
Bugs: Report bugs to Wine Bugzilla at https://bugs.winehq.org
|
|
Please search the bugzilla database to check whether your
|
|
problem is already known or fixed before posting a bug report.
|
|
|
|
IRC: Online help is available at channel #WineHQ on irc.libera.chat.
|
|
|
|
--
|
|
Alexandre Julliard
|
|
julliard@winehq.org
|