blob: 42722f93379657f1b85a86981bc3d5f04587c6b8 [file] [log] [blame]
André Hentschel0f84fd22009-09-09 18:37:13 +020011. EINFÜHRUNG
Christian Britz43aadee2004-03-09 00:42:04 +00002
André Hentschel0f84fd22009-09-09 18:37:13 +02003Wine ist ein Programm, das es ermöglicht, Programme, die für Microsoft
André Hentschel9a027b12010-07-14 17:53:08 +02004Windows geschrieben wurden (inklusive DOS-, Windows 3.x-, Win32- und
5Win64-Binärdateien), unter Unix auszuführen. Es besteht aus einem Programm-
André Hentschel0f84fd22009-09-09 18:37:13 +02006Lader, der Microsoft Windows-Binärdateien lädt und ausführt, sowie
Christian Britz43aadee2004-03-09 00:42:04 +00007einer Library (Winelib genannt), die Aufrufe der Windows API unter
André Hentschel0f84fd22009-09-09 18:37:13 +02008Verwendung der entsprechenden Unix- oder X11-Gegenstücke implementiert.
André Hentschel9a027b12010-07-14 17:53:08 +02009Die Library kann auch benutzt werden, um Windows-Code nativ nach Unix
Christian Britz43aadee2004-03-09 00:42:04 +000010zu portieren.
11
André Hentschel0f84fd22009-09-09 18:37:13 +020012Wine ist Freie Software, die unter der GNU LGPL veröffentlicht wird;
Christian Britz43aadee2004-03-09 00:42:04 +000013Bitte lesen Sie die Details in der Datei LICENSE nach.
14
152. SCHNELLSTART
16
17Um den Quelltext zu kompilieren, empfiehlt es sich immer, den Wine-
André Hentschel0f84fd22009-09-09 18:37:13 +020018Installer für den Build und die Installation von Wine zu verwenden.
Christian Britz43aadee2004-03-09 00:42:04 +000019Rufen Sie dazu aus dem Wurzelverzeichnis des Wine-Quelltextes (das
André Hentschel0f84fd22009-09-09 18:37:13 +020020diese Datei enthält) das folgende Kommando auf:
Christian Britz43aadee2004-03-09 00:42:04 +000021
22./tools/wineinstall
23
Christian Britzb16569a2004-03-11 03:50:24 +000024Starten Sie Programme mit "wine [Optionen] Programm". Weitere
André Hentschel0f84fd22009-09-09 18:37:13 +020025Informationen und Problemlösungen entnehmen Sie bitte dem Rest dieser
Dimitrie O. Paun77cddfe2005-05-10 16:02:47 +000026Datei, der Man-Page von Wine und insbesondere der Vielzahl an
27Informationen, die Sie auf http://www.winehq.org finden.
Christian Britz43aadee2004-03-09 00:42:04 +000028
293. VORAUSSETZUNGEN
30
André Hentschel0f84fd22009-09-09 18:37:13 +020031Um Wine kompilieren und ausführen zu können, brauchen Sie eines der
Christian Britz43aadee2004-03-09 00:42:04 +000032folgenden Betriebssysteme:
33
34 Linux version 2.0.36 oder neuer
Gerald Pfeifer85079112009-01-05 13:35:42 +010035 FreeBSD 6.3 oder neuer
36 Solaris x86 9 oder neuer
Christian Britz43aadee2004-03-09 00:42:04 +000037 NetBSD-current
Gerald Pfeifer85079112009-01-05 13:35:42 +010038 Mac OS X 10.4 oder neuer
Christian Britz43aadee2004-03-09 00:42:04 +000039
André Hentschel0f84fd22009-09-09 18:37:13 +020040Da Wine Thread-Support auf Kernelebene benötigt, werden nur die oben
41aufgeführten Betriebssysteme unterstützt.
42Andere Betriebssysteme, die Kernel-Threads unterstützen, werden unter
43Umständen in der Zukunft unterstützt.
Christian Britz43aadee2004-03-09 00:42:04 +000044
45Linux-Info:
46 Obwohl Linux 2.2.x immer noch funktionieren sollte und Linux 2.0.x
André Hentschel0f84fd22009-09-09 18:37:13 +020047 vielleicht auch noch funktioniert ltere 2.0.x-Versionen verzeichneten
48 Abstürze im Zusammenhang mit Threads), sollte man am besten einen
Marcus Meissner48882d22006-09-13 10:57:33 +020049 aktuellen Kernel wie 2.4.x oder 2.6.x verwenden.
Christian Britz43aadee2004-03-09 00:42:04 +000050
51FreeBSD-Info:
André Hentschel9a027b12010-07-14 17:53:08 +020052 Wine läuft prinzipiell erst ab FreeBSD 6.3 oder 7.0 richtig, wobei für
53 FreeBSD 6.3 zusätzliche Patches erhältlich sind. Siehe dazu auch
54 http://wiki.freebsd.org/Wine für weitere Informationen.
Christian Britz43aadee2004-03-09 00:42:04 +000055
56Solaris-Info:
André Hentschel0f84fd22009-09-09 18:37:13 +020057 Höchstwahrscheinlich müssen Sie den Wine-Build mit der GNU-Toolchain
58 (gcc, gas etc.) durchführen. Warnung: Die Installation von gas stellt nicht
Christian Britz43aadee2004-03-09 00:42:04 +000059 sicher, dass es vom gcc auch verwendet wird. Den gcc neu zu kompilieren, nach
60 der Installation von gas, oder die Symbolischen Links von cc, as und ld
André Hentschel0f84fd22009-09-09 18:37:13 +020061 mit den GNU-Tools zu verknüpfen, soll ausreichend sein.
Christian Britz43aadee2004-03-09 00:42:04 +000062
63NetBSD-Info:
64 Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
65 SYSVMSG in Ihrem Kernel aktiviert haben.
66
André Hentschel748e3432009-06-15 19:26:02 +020067Mac OS X Info:
André Hentschel0f84fd22009-09-09 18:37:13 +020068 Sie benötigen mindestens Xcode 2.4 um richtig unter x86 kompilieren zu können.
André Hentschel748e3432009-06-15 19:26:02 +020069
André Hentschel0f84fd22009-09-09 18:37:13 +020070Unterstützte Dateisysteme:
André Hentschela72b3632010-03-18 18:41:55 +010071 Wine sollte auf den meisten Dateisystemen laufen. Ein paar
André Hentschel0f84fd22009-09-09 18:37:13 +020072 Kompatibilitäts-Probleme wurden auch gemeldet beim Dateizugriff über Samba.
André Hentschel9a027b12010-07-14 17:53:08 +020073 Weiterhin bietet NTFS nicht alle Dateisystemfunktionen, die von einigen
74 Programmen benötigt werden. Ein natives Linux Dateisystem wie ext3 wird
75 empfohlen.
Christian Britz43aadee2004-03-09 00:42:04 +000076
André Hentschel0f84fd22009-09-09 18:37:13 +020077Grundsätzliche Voraussetzungen:
78 Sie müssen die Include-Dateien für X11-Entwicklung installiert haben
Gerald Pfeifer85079112009-01-05 13:35:42 +010079 (Debian nennt diese xlib6g-dev, Red Hat XFree86-devel).
Christian Britz43aadee2004-03-09 00:42:04 +000080
André Hentschel0f84fd22009-09-09 18:37:13 +020081 Natürlich benötigen Sie auch "make" (höchstwahrscheinlich GNU make).
Christian Britz43aadee2004-03-09 00:42:04 +000082
André Hentschel9a027b12010-07-14 17:53:08 +020083 Des Weiteren benötigen Sie flex in der Version 2.5.33 oder höher und bison.
Christian Britz43aadee2004-03-09 00:42:04 +000084
Marcus Meissner19cb5a42006-09-13 11:40:31 +020085Optionale Support-Bibliotheken:
86 Der ./configure Aufruf zeigt am Ende optionale Bibliotheken an,
André Hentschel0f84fd22009-09-09 18:37:13 +020087 die von Wine benutzt werden können, aber auf dem System nicht vorhanden
André Hentschel9a027b12010-07-14 17:53:08 +020088 sind. Siehe http://wiki.winehq.org/Recommended_Package für Tipps zum
89 installieren fehlender Pakete.
Christian Britz43aadee2004-03-09 00:42:04 +000090
André Hentschel9a027b12010-07-14 17:53:08 +020091 Auf 64-Bit Plattformen, falls Sie Wine als 32-Bit kompilieren (Standard),
92 benötigen Sie die 32-bit Versionen dieser Bibliotheken;
93 siehe dazu http://wiki.winehq.org/WineOn64bit
94 Für ein reines 64-Bit Wine (oder ein gemischtes 32-Bit und 64-Bit Wine Setup),
95 siehe http://wiki.winehq.org/Wine64
André Hentschel748e3432009-06-15 19:26:02 +020096
Christian Britz43aadee2004-03-09 00:42:04 +0000974. KOMPILIEREN
98
André Hentschel0f84fd22009-09-09 18:37:13 +020099Wenn Sie sich dafür entscheiden, wineinstall nicht zu benutzen, führen Sie
100bitte die folgenden Kommandos für den Build von Wine aus:
Christian Britz43aadee2004-03-09 00:42:04 +0000101
102./configure
Christian Britz43aadee2004-03-09 00:42:04 +0000103make
104
105Das erledigt den Build des Programms "wine" und verschiedener Support-
André Hentschel0f84fd22009-09-09 18:37:13 +0200106Libraries / -Binärdateien.
107Das Programm "wine" lädt ausführbare Windows-Dateien und führt sie aus.
Christian Britz43aadee2004-03-09 00:42:04 +0000108Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte
109unter Unix zu kompilieren und zu verlinken.
110
André Hentschel0f84fd22009-09-09 18:37:13 +0200111Mit ./configure --help können Sie sich die Konfigurations-Optionen für
Christian Britz43aadee2004-03-09 00:42:04 +0000112die Kompilierung anzeigen lassen.
113
Christian Britz43aadee2004-03-09 00:42:04 +00001145. SETUP
115
André Hentschel0f84fd22009-09-09 18:37:13 +0200116Nachdem der Build von Wine korrekt durchgelaufen ist, können Sie das
André Hentschel9a027b12010-07-14 17:53:08 +0200117Kommando "make install" aufrufen; Dadurch werden das Wine-Programme und
118Bibliotheken, die Man-Page und andere benötigte Dateien installiert.
Christian Britz43aadee2004-03-09 00:42:04 +0000119
André Hentschel0f84fd22009-09-09 18:37:13 +0200120Vergessen Sie nicht, erst alle früheren Wine-Installationen zu entfernen.
121Führen Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder
Christian Britz43aadee2004-03-09 00:42:04 +0000122"make uninstall" aus.
123
Dimitrie O. Paun77cddfe2005-05-10 16:02:47 +0000124Die Konfigurations-Hinweise finden Sie im Support-Bereich
Christian Britz43aadee2004-03-09 00:42:04 +0000125von http://www.winehq.org.
126
127Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries:
André Hentschel0f84fd22009-09-09 18:37:13 +0200128libntdll.so") fügen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu
129und führen Sie ldconfig als root aus.
Christian Britz43aadee2004-03-09 00:42:04 +0000130
André Hentschel0f84fd22009-09-09 18:37:13 +02001316. AUSFÜHREN VON PROGRAMMEN
Christian Britz43aadee2004-03-09 00:42:04 +0000132
André Hentschel0f84fd22009-09-09 18:37:13 +0200133Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren
Christian Britz43aadee2004-03-09 00:42:04 +0000134Datei angeben oder nur einen Dateinamen.
135
André Hentschel0f84fd22009-09-09 18:37:13 +0200136Beispiel: Um Notepad auszuführen:
Christian Britz43aadee2004-03-09 00:42:04 +0000137
André Hentschel9a027b12010-07-14 17:53:08 +0200138 wine notepad (den Suchpfad, der in der Registry
139 wine notepad.exe angegeben wurde, benutzend)
Christian Britz43aadee2004-03-09 00:42:04 +0000140
André Hentschel9a027b12010-07-14 17:53:08 +0200141 wine c:\\windows\\notepad.exe (die Dateinamen-Syntax von DOS benutzend)
Christian Britz43aadee2004-03-09 00:42:04 +0000142
André Hentschel9a027b12010-07-14 17:53:08 +0200143 wine ~/.wine/drive_c/windows/notepad.exe (die Dateinamen-Syntax
144 von Unix benutzend)
Christian Britz43aadee2004-03-09 00:42:04 +0000145
André Hentschel9a027b12010-07-14 17:53:08 +0200146 wine notepad.exe lesmich.txt (Programmaufruf mit Parametern)
Christian Britz43aadee2004-03-09 00:42:04 +0000147
André Hentschel9a027b12010-07-14 17:53:08 +0200148Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugefügt, wenn ein
149 vollständiger Dateiname auf der Kommandozeile angegeben wird.
Christian Britz43aadee2004-03-09 00:42:04 +0000150
André Hentschel9a027b12010-07-14 17:53:08 +0200151Wine ist nicht perfekt, daher können manche Programme abstürzen.
152In diesem Fall bekommen Sie einen Log vom Absturz, den Sie beifügen sollten,
153wenn Sie den Fehler melden.
Christian Britz43aadee2004-03-09 00:42:04 +0000154
André Hentschel0f84fd22009-09-09 18:37:13 +02001557. WEITERFÜHRENDE INFORMATIONEN
Christian Britz43aadee2004-03-09 00:42:04 +0000156
André Hentschel9a027b12010-07-14 17:53:08 +0200157WWW: Eine große Anzahl an Informationen findet sich im WineHQ unter
158 http://www.winehq.org/ : Verschiedene Wine Guides,
159 Applikations-Datenbank, Fehlerverfolgungs-System.
160 Das ist vermutlich der beste Ausgangspunkt.
Christian Britz43aadee2004-03-09 00:42:04 +0000161
André Hentschel9a027b12010-07-14 17:53:08 +0200162FAQ: Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ
Christian Britz43aadee2004-03-09 00:42:04 +0000163
André Hentschel9a027b12010-07-14 17:53:08 +0200164Wiki: Das Wine-Wiki finden Sie unter http://wiki.winehq.org
Christian Britz43aadee2004-03-09 00:42:04 +0000165
166Mailing-Listen:
André Hentschel9a027b12010-07-14 17:53:08 +0200167 Es gibt mehrere Mailing-Listen für die Wine-User und -Entwickler;
168 Schauen Sie sich bitte dazu http://www.winehq.org/forums an.
Christian Britz43aadee2004-03-09 00:42:04 +0000169
André Hentschel9a027b12010-07-14 17:53:08 +0200170Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org
171 Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
172 bereits gemeldet oder behoben wurde, bevor Sie eine Fehlermeldung verfassen.
173
174IRC: Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter
175 irc.freenode.net gewährt.
176
177Git: Der aktuelle Wine-Entwicklungs-Zweig ist über Git verfügbar.
178 Besuchen Sie http://www.winehq.org/site/git für weitere Informationen.
André Hentschel748e3432009-06-15 19:26:02 +0200179
André Hentschel0f84fd22009-09-09 18:37:13 +0200180Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie den Patch bitte
André Hentschel9a027b12010-07-14 17:53:08 +0200181(vorzugsweise mit git-format-patch) an die Liste wine-patches@winehq.org, um ihn
182in die nächste Ausgabe aufnehmen zu können.
Christian Britz43aadee2004-03-09 00:42:04 +0000183
184--
185Alexandre Julliard
186julliard@winehq.org