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