1. EINFÜHRUNG Wine ist ein Programm, das es ermöglicht, Programme, die für Microsoft Windows geschrieben wurden (inklusive DOS-, Windows 3.x- und Win32- Binärdateien), unter Unix auszuführen. Es besteht aus einem Programm- Lader, der Microsoft Windows-Binärdateien lädt und ausführt, sowie einer Library (Winelib genannt), die Aufrufe der Windows API unter Verwendung der entsprechenden Unix- oder X11-Gegenstücke implementiert. Die Library kann auch benutzt werden, um Win32-Code nativ nach Unix zu portieren. Wine ist Freie Software, die unter der GNU LGPL veröffentlicht wird; Bitte lesen Sie die Details in der Datei LICENSE nach. 2. SCHNELLSTART Um den Quelltext zu kompilieren, empfiehlt es sich immer, den Wine- Installer für den Build und die Installation von Wine zu verwenden. Rufen Sie dazu aus dem Wurzelverzeichnis des Wine-Quelltextes (das diese Datei enthält) das folgende Kommando auf: ./tools/wineinstall Starten Sie Programme mit "wine [Optionen] Programm". Weitere Informationen und Problemlösungen entnehmen Sie bitte dem Rest dieser Datei, der Man-Page von Wine, den Dateien im Dokumentations-Verzeichnis des Wine-Quelltextes (siehe "DOKUMENTATION") und insbesondere der Vielzahl an Informationen, die Sie auf http://www.winehq.org finden. 3. VORAUSSETZUNGEN Um Wine kompilieren und ausführen zu können, brauchen Sie eines der folgenden Betriebssysteme: Linux version 2.0.36 oder neuer FreeBSD 4.x oder FreeBSD 5-CURRENT oder neuer Solaris x86 2.5 oder neuer NetBSD-current Da Wine Thread-Support auf Kernelebene benötigt, werden nur die oben aufgeführten Betriebssysteme unterstützt. Andere Betriebssysteme, die Kernel-Threads unterstützen, werden unter Umständen in der Zukunft unterstützt. Linux-Info: Obwohl Linux 2.2.x immer noch funktionieren sollte und Linux 2.0.x vielleicht auch noch funktioniert (ältere 2.0.x-Versionen verzeichneten Abstürze im Zusammenhang mit Threads), sollte man am besten einen aktuellen Kernel wie 2.4.x verwenden. FreeBSD-Info: Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und SYSVMSG in Ihrem Kernel aktiviert haben. Weitere Informationen finden Sie im Ports-Tree: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/ Solaris-Info: Höchstwahrscheinlich müssen Sie den Wine-Build mit der GNU-Toolchain (gcc, gas etc.) durchführen. Warnung: Die Installation von gas stellt nicht sicher, dass es vom gcc auch verwendet wird. Den gcc neu zu kompilieren, nach der Installation von gas, oder die Symbolischen Links von cc, as und ld mit den GNU-Tools zu verknüpfen, soll ausreichend sein. NetBSD-Info: Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und SYSVMSG in Ihrem Kernel aktiviert haben. Unterstützte Dateisysteme: Wine sollte auf den meisten Dateisystemen laufen. Jedoch wird Wine nicht starten, wenn umsdos für das Verzeichnis /tmp benutzt wird. Ein paar Kompatibilitäts-Probleme wurden auch gemeldet beim Dateizugriff über Samba. Ausserdem können wir, da NTFS derzeit nur sicher für Lesezugriffe genutzt werden kann, den Einsatz von NTFS nicht empfehlen; Windows-Programme benötigen fast immer Schreibzugriffe. Kopieren Sie NTFS-Dateien an einen Ort, an dem Sie Schreibrechte haben. Grundsätzliche Voraussetzungen: Sie müssen die Include-Dateien für X11-Entwicklung installiert haben (Debian nennt diese xlib6g-dev, RedHat XFree86-devel). Vorausgesetzte Build-Tools: Auf x86-Systemen wird der gcc >= 2.7.2 benötigt. Versionen vor 2.7.2.3 können Probleme damit haben, wenn bestimmte Dateien mit Optimierungen kompiliert werden, oft im Zusammenhang mit Problemen mit der Verwaltung von Header-Dateien. pgcc arbeitet derzeit nicht mit Wine. Die Ursache dieses Problems ist unbekannt. Natürlich benötigen Sie auch "make" (höchstwahrscheinlich GNU make). Des Weiteren benötigen Sie flex in der Version 2.5 oder höher und bison. Wenn Sie RedHat oder Debian benutzen, installieren Sie bitte die flex- und bison-Pakete. Optionale Support-Libraries: Wenn Sie CUPS Drucker-Unterstützung haben wollen, installieren Sie bitte die Pakete cups und cups-devel. Für die automatische Verarbeitung der Test-Skripte brauchen Sie auch den Entwicklungs-Headersupport aus libperl (in Debian das Paket libperl-dev). Die Voraussetzungen für das selbständige Durchführen des Builds der Dokumentation entnehmen Sie bitte dem Abschnitt "DOKUMENTATION". 4. KOMPILIEREN Wenn Sie sich dafür entscheiden, wineinstall nicht zu benutzen, führen Sie bitte die folgenden Kommandos für den Build von Wine aus: ./configure make depend make Das erledigt den Build des Programms "wine" und verschiedener Support- Libraries / -Binärdateien. Das Programm "wine" lädt ausführbare Windows-Dateien und führt sie aus. Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte unter Unix zu kompilieren und zu verlinken. Mit ./configure --help können Sie sich die Konfigurations-Optionen für die Kompilierung anzeigen lassen. Um mit Hilfe einer Patch-Datei auf ein neueres Release zu aktualisieren, wechsen Sie erst mit cd in das Wurzelverzeichnis dieses Releases (das, welches diese README-Datei enthält). Geben Sie dann "make clean" ein und patchen Sie das Release mit dem Kommando: gunzip -c patch-file | patch -p1 wobei "patch-file" der Name der Patch-Datei ist (etwas wie Wine-yymmdd.diff.gz). Sie können dann erneut "./configure" und danach "make depend && make" aufrufen. 5. SETUP Nachdem der Build von Wine korrekt durchgelaufen ist, können Sie das Kommando "make install" aufrufen; Dadurch werden das Wine-Programm, die Man-Page und einige andere benötigte Dateien installiert. Vergessen Sie nicht, erst alle früheren Wine-Installationen zu entfernen. Führen Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder "make uninstall" aus. Wenn Sie die mit dem Wine-Quelltext gelieferte Dokumentation lesen wollen, schauen Sie sich bitte den Abschnitt "DOKUMENTATION" an. Wine benötigt eine Konfigurations-Datei namens "config" in Ihrem ~/.wine-Verzeichnis. Das Format dieser Datei wird in der Man-Page der Konfigurations-Datei erklärt (documentation/wine.conf.man). Die Datei documentation/samples/config enthält eine beispielhafte Konfigurations-Datei, die angepasst und an die oben erwähnte Stelle kopiert werden muss. Vergessen Sie nicht, lebenswichtige Registry-Einträge anzulegen, indem Sie winedefault.reg mittels programms/regedit anwenden. Details entnehmen Sie bitte dem Verzeichnis documentation. Weitere Konfigurations-Hinweise finden Sie im Support-Bereich von http://www.winehq.org. Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries: libntdll.so") fügen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu und führen Sie ldconfig als root aus. Um zu prüfen, ob Ihre Umgebung passend eingerichtet ist, um Wine erfolgreich laufen zu lassen, können Sie das Kommando "./tools/winecheck | less" ausführen. Es wird Ihnen eine Punktzahl in Prozent mitgeteilt, welche die "Korrektheit der Wine-Konfiguration" darstellt. Da dieses Programm immer noch im Alpha-Stadium ist, führt es aber keinen wirklich umfassenden Test durch, die Ergebnisse der Überprüfungsollten sollten also nur als erster Prüfschritt betrachtet werden. In der Man-Page zu wine.conf können Sie nachlesen, wie Sie zum reinen Text-Modus wechseln können, wenn gewünscht. 6. AUSFÜHREN VON PROGRAMMEN Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren Datei angeben oder nur einen Dateinamen. Beispiel: Um Solitaire auszuführen: wine sol (den Suchpfad, der in der Konfiguartions-Datei wine sol.exe angegeben wurde, benutzend) wine c:\\windows\\sol.exe (die Dateinamen-Syntax von DOS benutzend) wine /usr/windows/sol.exe (die Dateinamen-Syntax von Unix benutzend) wine -- sol.exe /parameter1 -parameter2 parameter3 (Programmaufruf mit Parametern) Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugefügt, wenn ein vollständiger Dateiname auf der Kommandozeile angegeben wird. Die Entwicklung von Wine ist noch nicht abgeschlossen, daher können einige Programme abstürzen. Vorausgesetzt, dass Sie winedbg korrekt entsprechend documentation/debugger.sgml einrichten, werden Sie dann in einem Debugger landen, um das Problem untersuchen und beheben zu können. Weitere Informationen zu diesem Thema entnehmen Sie bitte der Datei documentation/debugging.sgml. Sie sollten Backups von allen wichtigen Dateien machen, auf die Sie Wine Zugriff gewähren, oder spezielle Kopien für Wine anlegen, da Benutzer einige Fälle gemeldet haben, in denen Dateien zerstört wurden. Führen Sie zum Beispiel NICHT den Explorer aus, wenn Sie kein geeignetes Backup haben, da er manchmal Verzeichnise verstümmelt / umbenennnt. Selbst andere MS-Applikationen wie z.B der Messenger sind nicht sicher, da sie unter Umständen den Explorer aufrufen. Diese spezielle Beschädigung (!$!$!$!$.pfr) kann zumindest teilweise durch http://home.nexgo.de/andi.mohr/download/decorrupt_explorer behoben werden. 7. DOKUMENTATION Im Verzeichnis documentation/ befindet sich einiges an Dokumentation (verschiedene Wine-Guides usw.). Sie sind auch im WineHQ verfügbar. Wenn Sie die SGML-Dateien dort verarbeiten möchten, können Sie das Kommando "make doc" im Verzeichnis documentation/ ausführen. Dafür wird das Paket "sgml tools" vorausgesetzt (für db2html, db2ps, db2pdf): Debian: docbook-utils Mandrake: sgml-tools-A.B.C-DDmdk SuSE: docbktls-A.BB.C-DD 8. WEITERFÜHRENDE INFORMATIONEN WWW: Eine große Anzahl an Informationen findet sich im WineHQ unter http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank, Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt. FAQ: Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ Usenet: Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter comp.emulators.ms-windows.wine. Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie können Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken. Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche Informationen benötigt werden. IRC: Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gewährt. CVS: Der aktuelle Wine-Entwicklungs-Tree ist über CVS verfügbar. Besuchen Sie http://www.winehq.org/cvs für weitere Informationen. Mailing-Listen: Es gibt mehrere Mailing-Listen für die Wine-Entwickler; Schauen Sie sich bitte dazu http://www.winehq.org/forums an. Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie den Patch bitte (im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die nächste Ausgabe aufnehmen zu können. -- Alexandre Julliard julliard@winehq.org Übersetzung von Christian Britz (Deutschland) Auf die Übersetzung bezogene Fehlermeldungen, Anregungen und Kommentare senden Sie bite an: cbritz@gmx.net