- Add a complete, sorted listed of IOCTLS implemented in the file.
[wine/hacks.git] / documentation / README.de
blob1803805f01455087d2d6dfa3eadfafee04c04427
1 1. EINFÜHRUNG
3 Wine ist ein Programm, das es ermöglicht, Programme, die für Microsoft
4 Windows geschrieben wurden (inklusive DOS-, Windows 3.x- und Win32-
5 Binärdateien), unter Unix auszuführen. Es besteht aus einem Programm-
6 Lader, der Microsoft Windows-Binärdateien lädt und ausführt, sowie
7 einer Library (Winelib genannt), die Aufrufe der Windows API unter
8 Verwendung der entsprechenden Unix- oder X11-Gegenstücke implementiert.
9 Die Library kann auch benutzt werden, um Win32-Code nativ nach Unix
10 zu portieren.
12 Wine ist Freie Software, die unter der GNU LGPL veröffentlicht wird; 
13 Bitte lesen Sie die Details in der Datei LICENSE nach.
15 2. SCHNELLSTART
17 Um den Quelltext zu kompilieren, empfiehlt es sich immer, den Wine-
18 Installer für den Build und die Installation von Wine zu verwenden.
19 Rufen Sie dazu aus dem Wurzelverzeichnis des Wine-Quelltextes (das
20 diese Datei enthält) das folgende Kommando auf:
22 ./tools/wineinstall
24 Starten Sie Programme mit "wine [Optionen] Programm". Weitere 
25 Informationen und Problemlösungen entnehmen Sie bitte dem Rest dieser
26 Datei, der Man-Page von Wine, den Dateien im Dokumentations-Verzeichnis
27 des Wine-Quelltextes (siehe "DOKUMENTATION") und insbesondere der
28 Vielzahl an Informationen, die Sie auf http://www.winehq.org finden.
30 3. VORAUSSETZUNGEN
32 Um Wine kompilieren und ausführen zu können, brauchen Sie eines der
33 folgenden Betriebssysteme:
35   Linux version 2.0.36 oder neuer
36   FreeBSD 4.x oder FreeBSD 5-CURRENT oder neuer
37   Solaris x86 2.5 oder neuer
38   NetBSD-current
40 Da Wine Thread-Support auf Kernelebene benötigt, werden nur die oben
41 aufgeführten Betriebssysteme unterstützt.
42 Andere Betriebssysteme, die Kernel-Threads unterstützen, werden unter
43 Umständen in der Zukunft unterstützt.
45 Linux-Info:
46   Obwohl Linux 2.2.x immer noch funktionieren sollte und Linux 2.0.x
47   vielleicht auch noch funktioniert (ältere 2.0.x-Versionen verzeichneten
48   Abstürze im Zusammenhang mit Threads), sollte man am besten einen
49   aktuellen Kernel wie 2.4.x verwenden.
51 FreeBSD-Info:
52   Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
53   SYSVMSG in Ihrem Kernel aktiviert haben. Weitere Informationen finden Sie
54   im Ports-Tree: ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
56 Solaris-Info:
57   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
59   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
61   mit den GNU-Tools zu verknüpfen, soll ausreichend sein.
63 NetBSD-Info:
64   Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
65   SYSVMSG in Ihrem Kernel aktiviert haben.
67 Unterstützte Dateisysteme:
68   Wine sollte auf den meisten Dateisystemen laufen. Jedoch wird Wine nicht
69   starten, wenn umsdos für das Verzeichnis /tmp benutzt wird. Ein paar
70   Kompatibilitäts-Probleme wurden auch gemeldet beim Dateizugriff über Samba.
71   Ausserdem können wir, da NTFS derzeit nur sicher für Lesezugriffe genutzt
72   werden kann, den Einsatz von NTFS nicht empfehlen; Windows-Programme
73   benötigen fast immer Schreibzugriffe.
74   Kopieren Sie NTFS-Dateien an einen Ort, an dem Sie Schreibrechte haben.
76 Grundsätzliche Voraussetzungen:
77   Sie müssen die Include-Dateien für X11-Entwicklung installiert haben
78   (Debian nennt diese xlib6g-dev, RedHat XFree86-devel).
80 Vorausgesetzte Build-Tools:
81   Auf x86-Systemen wird der gcc >= 2.7.2 benötigt.
82   Versionen vor 2.7.2.3 können Probleme damit haben, wenn bestimmte Dateien
83   mit Optimierungen kompiliert werden, oft im Zusammenhang mit Problemen mit
84   der Verwaltung von Header-Dateien. pgcc arbeitet derzeit nicht mit Wine.
85   Die Ursache dieses Problems ist unbekannt.
87   Natürlich benötigen Sie auch "make" (höchstwahrscheinlich GNU make).
89   Des Weiteren benötigen Sie flex in der Version 2.5 oder höher und bison.
90   Wenn Sie RedHat oder Debian benutzen, installieren Sie bitte die flex-
91   und bison-Pakete.
93 Optionale Support-Libraries:
94   Wenn Sie CUPS Drucker-Unterstützung haben wollen, installieren Sie bitte
95   die Pakete cups und cups-devel.
97 Die Voraussetzungen für das selbständige Durchführen des Builds der
98 Dokumentation entnehmen Sie bitte dem Abschnitt "DOKUMENTATION".
100 4. KOMPILIEREN
102 Wenn Sie sich dafür entscheiden, wineinstall nicht zu benutzen, führen Sie
103 bitte die folgenden Kommandos für den Build von Wine aus:
105 ./configure
106 make depend
107 make
109 Das erledigt den Build des Programms "wine" und verschiedener Support-
110 Libraries / -Binärdateien.
111 Das Programm "wine" lädt ausführbare Windows-Dateien und führt sie aus.
112 Die Library "libwine" ("WineLib") kann benutzt werden, um Windows-Quelltexte
113 unter Unix zu kompilieren und zu verlinken.
115 Mit ./configure --help können Sie sich die Konfigurations-Optionen für
116 die Kompilierung anzeigen lassen.
118 Um mit Hilfe einer Patch-Datei auf ein neueres Release zu aktualisieren,
119 wechsen Sie erst mit cd in das Wurzelverzeichnis dieses Releases (das,
120 welches diese README-Datei enthält). Geben Sie dann "make clean" ein
121 und patchen Sie das Release mit dem Kommando:
123     gunzip -c patch-file | patch -p1
125 wobei "patch-file" der Name der Patch-Datei ist (etwas wie
126 Wine-yymmdd.diff.gz). Sie können dann erneut "./configure" und danach
127 "make depend && make" aufrufen.
129 5. SETUP
131 Nachdem der Build von Wine korrekt durchgelaufen ist, können Sie das
132 Kommando "make install" aufrufen; Dadurch werden das Wine-Programm, die
133 Man-Page und einige andere benötigte Dateien installiert.
135 Vergessen Sie nicht, erst alle früheren Wine-Installationen zu entfernen.
136 Führen Sie vor der Installation entweder "dpkg -r wine", "rpm -e wine" oder
137 "make uninstall" aus.
139 Wenn Sie die mit dem Wine-Quelltext gelieferte Dokumentation lesen wollen,
140 schauen Sie sich bitte den Abschnitt "DOKUMENTATION" an.
142 Wine benötigt eine Konfigurations-Datei namens "config" in Ihrem
143 ~/.wine-Verzeichnis. Das Format dieser Datei wird in der Man-Page der
144 Konfigurations-Datei erklärt (documentation/wine.conf.man).
145 Die Datei documentation/samples/config enthält eine beispielhafte
146 Konfigurations-Datei, die angepasst und an die oben erwähnte Stelle
147 kopiert werden muss.
149 Weitere Konfigurations-Hinweise finden Sie im Support-Bereich
150 von http://www.winehq.org.
152 Im Falle von Library-Ladefehlern (z.B. "Error while loading shared libraries:
153 libntdll.so") fügen Sie bitte den Library-Pfad zur Datei /etc/ld.so.conf hinzu 
154 und führen Sie ldconfig als root aus.
156 6. AUSFÜHREN VON PROGRAMMEN
158 Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren
159 Datei angeben oder nur einen Dateinamen.
161 Beispiel: Um Solitaire auszuführen:
163         wine sol                   (den Suchpfad, der in der Konfiguartions-Datei 
164         wine sol.exe               angegeben wurde, benutzend)
166         wine c:\\windows\\sol.exe  (die Dateinamen-Syntax von DOS benutzend)
168         wine /usr/windows/sol.exe  (die Dateinamen-Syntax von Unix benutzend)
170         wine sol.exe /parameter1 -parameter2 parameter3
171                                    (Programmaufruf mit Parametern)
173 Hinweis: Der Pfad zur Datei wird auch zum Pfad hinzugefügt, wenn ein vollständiger
174          Dateiname auf der Kommandozeile angegeben wird.
176 Die Entwicklung von Wine ist noch nicht abgeschlossen, daher können einige
177 Programme abstürzen. Vorausgesetzt, dass Sie winedbg korrekt entsprechend 
178 documentation/debugger.sgml einrichten, werden Sie dann in einem Debugger landen,
179 um das Problem untersuchen und beheben zu können.
180 Weitere Informationen zu diesem Thema entnehmen Sie bitte der Datei
181 documentation/debugging.sgml.
183 Sie sollten Backups von allen wichtigen Dateien machen, auf die Sie Wine 
184 Zugriff gewähren, oder spezielle Kopien für Wine anlegen, da Benutzer einige
185 Fälle gemeldet haben, in denen Dateien zerstört wurden. Führen Sie zum Beispiel
186 NICHT den Explorer aus, wenn Sie kein geeignetes Backup haben, da er manchmal
187 Verzeichnise verstümmelt / umbenennnt. Selbst andere MS-Applikationen wie z.B
188 der Messenger sind nicht sicher, da sie unter Umständen den Explorer aufrufen.
189 Diese spezielle Beschädigung (!$!$!$!$.pfr) kann zumindest teilweise durch
190 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer behoben werden.
192 7. DOKUMENTATION
194 Im Verzeichnis documentation/ befindet sich einiges an Dokumentation (verschiedene
195 Wine-Guides usw.). Sie sind auch im WineHQ verfügbar.
197 Wenn Sie die SGML-Dateien dort verarbeiten möchten, können Sie das Kommando
198 "make doc" im Verzeichnis documentation/ ausführen.
199 Dafür wird das Paket "sgml tools" vorausgesetzt (für db2html, db2ps, db2pdf):
200 Debian:         docbook-utils
201 Mandrake:       sgml-tools-A.B.C-DDmdk
202 SuSE:           docbktls-A.BB.C-DD
204 8. WEITERFÜHRENDE INFORMATIONEN
206 WWW:    Eine große Anzahl an Informationen findet sich im WineHQ unter
207         http://www.winehq.org/ : Verschiedene Wine Guides, Applikations-Datenbank,
208         Fehlerverfolgungs-System. Das ist vermutlich der beste Ausgangspunkt.
210 FAQ:    Die FAQ zu Wine befindet sich unter http://www.winehq.org/FAQ
212 Usenet: Hilfe und Diskussionen zu auf Wine bezogenen Problemen finden Sie unter
213         comp.emulators.ms-windows.wine.
215 Fehler: Melden Sie Fehler bitte an Wine-Bugzilla unter http://bugs.winehq.org
216         Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
217         bereits gemeldet wurde, bevor Sie eine Fehlermeldung verfassen. Sie 
218         können Fehlermeldungen auch an comp.emulators.ms-windows.wine schicken.
219         Lesen Sie bitte die Datei documentation/bugs.sgml um zu sehen, welche
220         Informationen benötigt werden.
222 IRC:    Online-Hilfe wird Ihnen im Chat-Kanal #WineHQ unter irc.freenode.net gewährt.
224 CVS:    Der aktuelle Wine-Entwicklungs-Tree ist über CVS verfügbar.
225         Besuchen Sie http://www.winehq.org/cvs für weitere Informationen.
227 Mailing-Listen:
228         Es gibt mehrere Mailing-Listen für die Wine-Entwickler; Schauen Sie
229         sich bitte dazu http://www.winehq.org/forums an.
231 Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie den Patch bitte 
232 (im 'diff -u'-Format) an die Liste wine-patches@winehq.org, um ihn in die nächste
233 Ausgabe aufnehmen zu können.
236 Alexandre Julliard
237 julliard@winehq.org
239 Übersetzung von Christian Britz (Deutschland)
240 Auf die Übersetzung bezogene Fehlermeldungen,
241 Anregungen und Kommentare senden Sie bite an:
242 cbritz@gmx.net