| blob | 7ead4a4f731f657f91f0851782e95a2f9e4784a5 |
1 .\" -*- nroff -*-
2 .TH WINE 1 "November 2007" "@PACKAGE_STRING@" "Windows On Unix"
3 .SH NAME
4 wine \- Windows-Programme auf Unix-Systemen ausführen
5 .SH ÜBERSICHT
6 .BI "wine " "Programm " "[Argumente ... ]"
7 .br
8 .B wine --help
9 .br
10 .B wine --version
11 .PP
12 Für das Übergeben von Kommandos an Windows-Programme siehe den
13 Abschnitt
14 .B
15 "Programm / Argumente"
16 in dieser Manpage.
17 .SH BESCHREIBUNG
18 .B wine
19 lädt und führt ein Windows-Programm aus. Dieses Programm kann ein
20 beliebiges DOS/Win3.1/Win32-Programm sein; es wird nur die
21 x86-Architektur unterstützt.
22 .PP
23 Um wine zu debuggen, nutzen Sie anstelledessen das Kommando
24 .B winedbg.
25 .PP
26 Um rein kommandozeilenbasierte Programme auszuführen, nutzen Sie
27 .B wineconsole
28 anstelle von
29 .B wine.
30 Wenn Sie nicht
31 .B wineconsole
32 für CLI-Programme nutzen, kann dies dazu führen, dass das Programm
33 nicht korrekt ausgeführt werden kann.
34 .PP
35 Wenn wine nur mit
36 .B --help
37 oder
38 .B --version
39 als Argument aufgerufen wird, wird
40 .B wine
41 nur einen kleinen Hilfetext oder die Version ausgeben und sich beenden.
42 .SH PROGRAMM/ARGUMENTE
43 Der Programmname kann auf DOS-Art (
44 .I
45 C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE
46 ) oder auf UNIX-Art angegeben werden (
47 .I /msdos/windows/sol.exe
48 ). Sie können Argumente an die Windows-Anwendung übergeben, indem Sie
49 sie einfach an den wine-Befehl anhängen (z. B.:
50 .I wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT
51 ).
52 Sie müssen unter Umständen Sonderzeichen und/oder Leerzeichen
53 mit '\(rs' maskieren, wenn Sie wine über die Kommandokonsole aufrufen,
54 z.B.
55 .PP
56 wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe
57 .PP
58 .SH UMGEBUNGSVARIABLEN
59 .B wine
60 leitet die Umgebungsvariablen der Shell, in der es gestartet wurde, an
61 die Windows-Applikation weiter. Um eine für Ihre Applikation nötige
62 Variable zugänglich zu machen, folgen Sie der Anleitung Ihrer Shell zu
63 Umgebungsvariablen.
64 .TP
65 .I WINEPREFIX
66 Wenn gesetzt, wird dieser Ordner als Speicherort für die
67 Konfigurationsdateien von
68 .B wine
69 genutzt. Die Standardeinstellung ist
70 .I $HOME/.wine.
71 Dieser Ordner wird auch für den UNIX-Socket zur Kommunikation mit
72 .I wineserver.
73 genutzt. Alle
74 .B wine
75 -Prozesse, die den gleichen
76 .B wineserver
77 nutzen (z.B. Prozesse desselben Nutzers) teilen sich bestimmte Objekte
78 wie die Registry, Arbeitsspeicher und die Konfigurationsdateien. Mit
79 dem Setzen von
80 .I WINEPREFIX
81 beim Starten verschiedener
82 .B wine
83 -Prozesse ist es möglich, eine Anzahl vollkommen unabhängiger
84 .B wine
85 -Prozesse zu starten.
86 .TP
87 .I WINESERVER
88 Gibt den Ort der
89 .B wineserver
90 -Anwendung an. Wenn diese Variable nicht gesetzt ist, wird versucht,
91 .B @bindir@/wineserver
92 zu laden. Wenn auch dies nicht funktioniert, sucht
93 .B wine
94 in $PATH und anderen Orten nach wineserver.
95 .TP
96 .I WINELOADER
97 Gibt den Ort der
98 .B wine
99 -Anwendung an, die genutzt wird, um Windows-Programme zu laden. Wenn
100 diese Variable nicht gesetzt ist, wird versucht,
101 .B @bindir@/wineserver
102 zu laden. Wenn auch dies nicht funktioniert, wird in $PATH und anderen
103 Orten nach wine gesucht.
104 .TP
105 .I WINEDEBUG
106 Wählt die Stufe der Debug-Meldungen aus. Die Variable hat das Format
107 .RI [ Klasse ][+/-] Kanal [,[ Klasse2 ][+/-] Kanal2 ].
108 .RS +7
109 .PP
110 .I Klasse
111 ist optional und kann z.B. folgende Werte annehmen:
112 .B err, warn, fixme,
113 oder
114 .B trace.
115 Wenn
116 .I class
117 nicht angegeben ist, werden alle Debugmeldungen dieses Kanals
118 ausgegeben. Jeder Kanal gibt Meldungen einer bestimmten
119 .B wine.
120 -Komponente aus. Das folgende Zeichen kann entweder + oder - sein, je
121 nachdem ob der Kanal ein- oder ausgeschaltet werden soll. Wenn keine
122 .I Klasse
123 angegeben ist, kann das führende + weggelassen werden. In WINEDEBUG
124 sind keine Leerzeichen erlaubt.
125 .PP
126 Beispiele:
127 .TP
128 WINEDEBUG=warn+all
129 zeigt alle Nachrichten der Kategorie "warning" an (empfohlen zum
130 Debuggen).
131 .br
132 .TP
133 WINEDEBUG=warn+dll,+heap
134 schaltet alle DLL-Meldungen der Kategorie "warning" sowie jegliche
135 Heap-Meldungen an.
136 .br
137 .TP
138 WINEDEBUG=fixme-all,warn+cursor,+relay
139 schaltet alle FIXME-Nachrichten ab, Zeigernachrichten der Kategorie
140 "warning" an und schaltet alle Relay-Meldungen (API-Aufrufe) an.
141 .br
142 .TP
143 WINEDEBUG=relay
144 schaltet alle Relay-Nachrichten an. Für mehr Kontrolle über die im
145 Relaytrace angezeigten DLLs und Funktionen siehe den [Debug]-Abschnitt
146 der Wine-Konfigurationsdatei.
147 .PP
148 Für mehr Informationen zu den Debug-Meldungen siehe den Abschnitt
149 .I Running Wine
150 im Wine-Benutzerhandbuch.
151 .RE
152 .TP
153 .I WINEDLLPATH
154 Gibt den Pfad/die Pfade an, in denen wine nach eigenen DLLs und
155 Winelib-Anwendungen sucht. Die Einträge der Liste werden mit einem ":"
156 getrennt. Zusätzlich wird noch in
157 .B @dlldir@
158 gesucht.
159 .TP
160 .I WINEDLLOVERRIDES
161 Definiert die Bibliotheksüberschreibung und Ladereihenfolge der DLLs,
162 die beim Laden jeder DLL berücksichtigt wird. Die Standardwerte sind
163 in der Konfigurationsdatei enthalten. Derzeit gibt es zwei Typen von
164 DLLs, die in den Speicher eines Prozesses geladen werden können:
165 Native Windows-DLLs (
166 .I native
167 ) und
168 .B wine
169 -interne DLLs (
170 .I builtin
171 ). Der Typ kann mit dem ersten Buchstaben abgekürzt werden (
172 .I n, b
173 ). Jede Anweisungssequenz muss mit einem Komma abgeschlossen werden.
174 .RS
175 .PP
176 Jede DLL kann ihre eigene Ladereihenfolge besitzen. Die
177 Ladereihenfolge bestimmt, welche DLL-Version als erste geladen werden
178 soll. Wenn die erste versagt, ist die nächste an der Reihe und so
179 weiter. Viele DLLs mit derselben Reihenfolge können durch Kommata
180 getrennt werden. Es ist auch möglich, mit dem Semikolon verschiedene
181 Reihenfolgen für verschiedene DLLs festzulegen.
182 .PP
183 Die Ladereihenfolge für eine 16bit-DLL wird immer durch die
184 Reihenfolge der 32bit-DLL bestimmt, die sie enthält. Diese 32bit-DLL
185 kann durch Ansehen des symbolischen Links der 16bit .dll.so-Datei
186 gefunden werden. Wenn zum Beispiel ole32.dll als "builtin" eingestellt
187 ist, wird storage.dll ebenfalls als "builtin" geladen, da die
188 32bit-DLL ole32.dll die 16bit-DLL storage.dll enthält.
189 .PP
190 Beispiele:
191 .TP
192 WINEDLLOVERRIDES="comdlg32,shell32=n,b"
193 .br
194 Versuche, die DLLs comdlg32 und shell32 als native Windows-DLLs zu
195 laden; wenn dies fehlschlägt, soll Wine die mitgebrachte Version
196 benutzen.
197 .TP
198 WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
199 .br
200 Versuche, die DLLs comdlg32 und shell32 als native Windows-DLLs zu
201 laden. Weiterhin, wenn eine Anwendung versucht, die DLL
202 c:\(rsfoo\(rsbar\(rsbaz.dll zu laden, soll wine die eingebaute DLL baz
203 verwenden.
204 .TP
205 WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n"
206 .br
207 Versuche, die mitgebrachte comdlg32-Bibliothek zu laden; wenn dies
208 fehlschlägt soll Wine die native comdlg32-DLL nutzen. Bei shell32 soll
209 immer die mitgebrachte Version verwendet werden; bei comctl32 immer
210 die native.
211 .RE
212 .TP
213 .I DISPLAY
214 Gibt das zu nutzende X11-Display an.
215 .TP
216 OSS sound driver configuration variables
217 .TP
218 .I AUDIODEV
219 Gerät für Audio-Ein-/Ausgabe festlegen. Standard:
220 .B /dev/dsp.
221 .TP
222 .I MIXERDEV
223 Audiomixer-Gerät festlegen. Standard:
224 .B /dev/mixer.
225 .TP
226 .I MIDIDEV
227 MIDI-Sequencergerät festlegen. Standard:
228 .B /dev/sequencer.
229 .SH DATEIEN
230 .TP
231 .I @bindir@/wine
232 Der
233 .B wine
234 -Programmstarter
235 .TP
236 .I @bindir@/wineconsole
237 Der
238 .B wine
239 -Programmstarter für Konsolenapplikationen (CLI)
240 .TP
241 .I @bindir@/wineserver
242 Der
243 .B wine
244 -Server
245 .TP
246 .I @bindir@/winedbg
247 Der
248 .B wine
249 -Debugger
250 .TP
251 .I @dlldir@
252 Der Ordner mit den gemeinsamen DLLs von
253 .B wine
254 .TP
255 .I $WINEPREFIX/dosdevices
256 Dieser Ordner enthält die DOS-Gerätezuweisungen. Jede Datei in diesem
257 Ordner ist ein Symlink auf die Unix-Gerätedatei, die dieses Gerät
258 bereitstellt. Wenn zum Beispiel COM1 /dev/ttyS0 repräsentieren soll,
259 wird der Symlink $WINEPREFIX/dosdevices/com1 -> /dev/ttyS0 benötigt.
260 .br
261 DOS-Laufwerke werden auch mit Symlinks angegeben. Wenn z.B. das
262 Laufwerk D: dem CD-ROM-Laufwerk entsprechen soll, das auf /mnt/cdrom
263 eingebunden ist, wird der Link $WINEPREFIX/dosdevices/d: -> /mnt/cdrom
264 benötigt. Es kann auch die Unix-Gerätedatei angegeben werden; der
265 einzige Unterschied ist der "::" anstelle dem einfachen ":" im Namen:
266 $WINEPREFIX/dosdevices/d:: -> /dev/hdc.
267 .SH AUTOREN
268 .B wine
269 ist dank der Arbeit vieler Entwickler verfügbar. Für eine Liste siehe
270 die Datei
271 .B AUTHORS
272 im obersten Ordner der Quellcodedistribution.
273 .SH COPYRIGHT
274 .B wine
275 kann unter den Bedingungen der LGPL genutzt werden; für eine Kopie der
276 Lizenz siehe die Datei
277 .B COPYING.LIB
278 im obersten Ordner der Quellcodedistribution.
279 .SH FEHLER
280 .PP
281 Statusberichte für viele Anwendungen sind unter
282 .I http://appdb.winehq.org
283 verfügbar. Bitte fügen Sie Anwendungen, die Sie mit Wine nutzen, der
284 Liste hinzu, sofern noch kein Eintrag existiert.
285 .PP
286 Fehler können unter
287 .I http://bugs.winehq.org
288 gemeldet werden. Wenn Sie einen Fehler melden möchten, lesen Sie
289 bitte vorher die Datei
290 .I documentation/bugs.sgml
291 im
292 .B wine
293 -Quellcode, um zu sehen, welche Informationen benötigt werden.
294 .PP
295 Probleme und Hinweise mit/zu dieser Manpage können auch auf
296 .I http://bugs.winehq.org
297 gemeldet werden.
298 .SH VERFÜGBARKEIT
299 Die aktuellste öffentliche Wine-Version kann auf
300 .I http://www.winehq.org/download
301 bezogen werden.
302 .PP
303 Ein Schnappschuss des Entwicklungscodes kann via GIT besorgt werden,
304 siehe dazu
305 .I
306 http://www.winehq.org/site/git
307 .PP
308 WineHQ, die Hauptseite der
309 .B wine
310 -Entwicklung, befindet sich auf
311 .I http://www.winehq.org.
312 Diese Website bietet viele Informationen und Ressourcen zu
313 .B wine.
314 .PP
315 Für nähere Informationen zur Entwicklung von
316 .B wine
317 können Sie sich als Abonnement bei der
318 .B wine
319 -Mailingliste auf
320 .I http://www.winehq.org/forums
321 eintragen.
322 .SH "SIEHE AUCH"
323 .BR wineserver (1),\ winedbg (1)