wine.txt

   1 AUTHOR: Leslie Polzer <leslie.polzer@gmx.net>
   2
   3 DATE: 2003-09-14
   4
   5 LICENSE: GNU Free Documentation License Version 1.2
   6
   7 SYNOPSIS: Compiling and configuring WINE
   8
   9 DESCRIPTION:
  10 This guide documents how to compile and install WINE on an LFS system.
  11
  12 PREREQUISITES:
  13 An installed version of Microsoft Windows.
  14
  15 HINT:
  16
  17 Contents
  18 --------
  19 1. What is WINE?
  20 2. Requirements
  21         2.1 Overview
  22         2.2 Installation notes
  23 3. Getting, configuring and compiling WINE
  24 4. Postconfiguration
  25 5. Running applications with WINE
  26 6. Troubleshooting
  27 7. References and pointers
  28
  29
  30 1. What is WINE?
  31 ----------------
  32 WINE is, as stated on its website, a free implementation of Windows for
  33 Unix - in other words a program that enables you to run Windows
  34 applications on your Unix-Box quite comfortably.
  35 WINE also comes with a library called WineLib with which you are able to
  36 compile source-code using Windows system calls, but since open-source is
  37 not a big issue in the Windows world (most open-source stuff there comes
  38 from ported Unix apps anyway) we won't discuss it here.
  39
  40 IMPORTANT: I assume that you have a native Microsoft Windows installation on
  41 a separate partition and that it is mounted.
  42 I do not have any experience with a full Windows replacement and won't give
  43 you instructions on how to do this, because I don't like talking or even
  44 giving advice about topics I am not competent enough with.
  45
  46
  47 2. Requirements
  48 ---------------
  49
  50
  51 2.1 Overview
  52 ------------
  53 - X11R6, most likely the XFree86 implementation - see the xfree86* hints.
  54 - Freetype2, if you want True Type support, which I assume.
  55 - OpenGL libraries and header files (that is, if you want OpenGL support!);
  56         NVidia-users read nvidia_glx.txt, others install the Mesa libs:
  57         http://prdownloads.sourceforge.net/mesa3d/MesaLib-4.0.4.tar.bz2?download
  58
  59
  60 2.2 Installation notes
  61 ----------------------
  62 Modify the file
  63
  64         include/freetype/config/ftoption.h
  65
  66 in the Freetype2 source tree:
  67
  68 Change the line
  69
  70         #undef  TT_CONFIG_OPTION_BYTECODE_INTERPRETER
  71
  72 to
  73
  74         #define TT_CONFIG_OPTION_BYTECODE_INTERPRETER
  75
  76 and compile Freetype2 with the usual
  77
  78 ./configure --prefix=/usr/X11R6 --with-gnu-ld
  79 make
  80 make install
  81 ldconfig
  82
  83 Be root when executing the last two commands.
  84
  85
  86 3. Getting, configuring and compiling WINE
  87 ------------------------------------------
  88 Get the latest snapshot from
  89
  90         http://www.ibiblio.org/pub/Linux/ALPHA/wine/development/
  91
  92 Unpack with
  93
  94         tar xvfz Wine-xxxxxxxx.tar.gz
  95
  96 and cd to directory Wine-xxxxxxxx.
  97
  98
  99 Now there is more than one way to do the installation.
 100 You can either do configuring and compiling for yourself
 101 or use tools/wineinstall. The latter method is more convenient,
 102 because it automatically creates a configuration file and
 103 is able to find your Windows partition (if it is mounted).
 104
 105 I will use a combination to get the best of both worlds :)
 106 First, type
 107
 108 ./configure --help
 109
 110 read the available options and pick what you need.
 111 Run configure again with these options and check whether
 112 all you want (most notably Freetype2 and OpenGL) was found.
 113 To get really sure that OpenGL support will be build, type
 114
 115         cat include/config.h | grep OPENGL
 116
 117 If the output of this command doesn't say
 118
 119         #define HAVE_OPENGL 1
 120
 121 OpenGL won't be built and there's a problem to fix!
 122
 123 NOTE: Remember to delete config.cache when re-configuring.
 124
 125 If you are content with the output of configure, enter
 126 the directory tools and open the file 'wineinstall'
 127 with your favorite editor. Skip the big comment block at the
 128 beginning and look at the configuration defaults. You may want
 129 to change 'CONFARGS' to reflect your desired configure options
 130 (e.g. --enable-opengl) and 'prefix' to select the installation
 131 prefix. If it is requested, I will provide sed statements and a
 132 small script for this.
 133
 134 Bear with me, we're almost done:
 135 Go back to the toplevel source dir, execute
 136
 137         tools/wineinstall
 138
 139 answer a few questions and get some coffee.
 140
 141
 142 4. Postconfiguration
 143 --------------------
 144 Impatient people like me can go straight to step 5 and try
 145 to start a simple application like Solitaire. If it doesn't
 146 work or you want to know more about WINE configuration, you
 147 can always return to this step.
 148
 149 Review the file ~/.wine/config with your favorite editor.
 150 If you do not have this file (probably because you installed
 151 WINE without wineinstall), copy
 152
 153         WINESOURCEDIR/documentation/samples/config
 154
 155 to ~/.wine/config
 156
 157 Comments in the config file are denoted with a semi-colon (;),
 158 statements are terminated by a newline.
 159 First section is about drives. Syntax example:
 160
 161         [Drive C]
 162         "Path" = "/mnt/win"
 163         "Type" = "hd"
 164         "Filesystem" = "vfat"
 165
 166 You should use fstype 'vfat' for hard-disk partitions and
 167 fstype 'win95' for Floppy disk and CD-ROM drives. I can't tell
 168 you what type of fs you need to use with NTFS partitions, probably
 169 it doesn't work with those as NTFS kernel support is still
 170 considered experimental.
 171
 172 Next section is [wine] and contains essential configuration information.
 173 Configuration format is like the one above:
 174
 175         "Variable" = "Value"
 176
 177 The relevant variables are:
 178
 179 windows - your Windows install directory, e.g.
 180         "windows" = "C:\\win98"
 181
 182 system - your Windows system directory, e.g.
 183         "system" = "C:\\win98\\system"
 184
 185 path - application search path, should be at the very least:
 186         "path" = "C:\\win98\\system;C:\\win98;C:\\win98\\command"
 187
 188 temp - a directory for temporary files, most likely this:
 189         "temp" = "/tmp"
 190
 191
 192 If you want to know more about the configuration of WINE,
 193 refer to reference [1].
 194
 195
 196 5. Running applications with WINE
 197 ---------------------------------
 198 WINE is quite easy to use once it is installed the right way:
 199
 200
 201 wine ping (using the path-variable)
 202 wine ping.exe
 203 wine c:\\win98\\ping.exe (assuming "C" is mapped to the windows partition)
 204 wine /mnt/win/win98/ping.exe
 205
 206 You can pass commandline parameters like this:
 207
 208 wine ping.exe -- -t localhost
 209
 210 Use CTRL-C to interrupt as usual.
 211
 212
 213 6. Troubleshooting
 214 ------------------
 215 Problem: Freetype-related files fail to compile
 216 Solution: Remove _all_ old and conflicting versions of Freetype
 217         (both libraries and header files).
 218         Please note that XFree86 also brings a version of Freetype with
 219         it. You can find its files in /usr/X11R6/lib and /usr/X11R6/include.
 220
 221 Any more questions go to leslie.polzer@gmx.net.
 222
 223
 224 7. References and pointers
 225 --------------------------
 226 [1] The WINE homepage: http://www.winehq.org/
 227 [2] Which applications work with WINE?
 228         The Codeweavers AppDB: http://appdb.winehq.org/appbrowse.php
 229 [3] The WINE FAQ: http://www.winehq.org/FAQ/
 230 [4] Linux Half-Life: lhl.linuxgames.com
 231 [5] Starcraft under WINE:
 232         http://www.linuxgames.com/starcraft.php3
 233         http://koti.mbnet.fi/~hoppq/sc-howto.html
 234
 235
 236 CHANGELOG:
 237 [2003-09-14]
 238  * Initial release