| blob | ebcb744ab639976d649cc265e686f5eaab06d7b9 |
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 .I 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 .I WINESERVER
87 Gibt den Ort der
88 .B wineserver
89 -Anwendung an. Wenn diese Variable nicht gesetzt ist, wird versucht,
90 .B @bindir@/wineserver
91 zu laden. Wenn auch dies nicht funktioniert, sucht
92 .B wine
93 in $PATH und anderen Orten nach wineserver.
94 .TP
95 .I WINELOADER
96 Gibt den Ort der
97 .B wine
98 -Anwendung an, die genutzt wird, um Windows-Programme zu laden. Wenn
99 diese Variable nicht gesetzt ist, wird versucht,
100 .B @bindir@/wineserver
101 zu laden. Wenn auch dies nicht funktioniert, wird in $PATH und anderen
102 Orten nach wine gesucht.
103 .TP
104 .I WINEDEBUG
105 Wählt die Stufe der Debug-Meldungen aus. Die Variable hat das Format
106 .RI [ Klasse ][+/-] Kanal [,[ Klasse2 ][+/-] Kanal2 ].
107 .RS +7
108 .PP
109 .I Klasse
110 ist optional und kann z.B. folgende Werte annehmen:
111 .BR err ,
112 .BR warn ,
113 .BR fixme ,
114 oder
115 .BR trace .
116 Wenn
117 .I class
118 nicht angegeben ist, werden alle Debugmeldungen dieses Kanals
119 ausgegeben. Jeder Kanal gibt Meldungen einer bestimmten
120 .BR wine .
121 -Komponente aus. Das folgende Zeichen kann entweder + oder - sein, je
122 nachdem ob der Kanal ein- oder ausgeschaltet werden soll. Wenn keine
123 .I Klasse
124 angegeben ist, kann das führende + weggelassen werden. In WINEDEBUG
125 sind keine Leerzeichen erlaubt.
126 .PP
127 Beispiele:
128 .TP
129 WINEDEBUG=warn+all
130 zeigt alle Nachrichten der Kategorie "warning" an (empfohlen zum
131 Debuggen).
132 .br
133 .TP
134 WINEDEBUG=warn+dll,+heap
135 schaltet alle DLL-Meldungen der Kategorie "warning" sowie jegliche
136 Heap-Meldungen an.
137 .br
138 .TP
139 WINEDEBUG=fixme-all,warn+cursor,+relay
140 schaltet alle FIXME-Nachrichten ab, Zeigernachrichten der Kategorie
141 "warning" an und schaltet alle Relay-Meldungen (API-Aufrufe) an.
142 .br
143 .TP
144 WINEDEBUG=relay
145 schaltet alle Relay-Nachrichten an. Für mehr Kontrolle über die im
146 Relaytrace angezeigten DLLs und Funktionen siehe den [Debug]-Abschnitt
147 der Wine-Konfigurationsdatei.
148 .PP
149 Für mehr Informationen zu den Debug-Meldungen siehe den Abschnitt
150 .I Running Wine
151 im Wine-Benutzerhandbuch.
152 .RE
153 .TP
154 .I WINEDLLPATH
155 Gibt den Pfad/die Pfade an, in denen wine nach eigenen DLLs und
156 Winelib-Anwendungen sucht. Die Einträge der Liste werden mit einem ":"
157 getrennt. Zusätzlich wird noch in
158 .B @dlldir@
159 gesucht.
160 .TP
161 .I WINEDLLOVERRIDES
162 Definiert die Bibliotheksüberschreibung und Ladereihenfolge der DLLs,
163 die beim Laden jeder DLL berücksichtigt wird. Die Standardwerte sind
164 in der Konfigurationsdatei enthalten. Derzeit gibt es zwei Typen von
165 DLLs, die in den Speicher eines Prozesses geladen werden können:
166 Native Windows-DLLs
167 .RI ( native ),
168 und
169 .B wine
170 -interne DLLs
171 .RI ( builtin ).
172 Der Typ kann mit dem ersten Buchstaben abgekürzt werden
173 .RI ( n ", " b ).
174 Jede Anweisungssequenz muss mit einem Komma abgeschlossen werden.
175 .RS
176 .PP
177 Jede DLL kann ihre eigene Ladereihenfolge besitzen. Die
178 Ladereihenfolge bestimmt, welche DLL-Version als erste geladen werden
179 soll. Wenn die erste versagt, ist die nächste an der Reihe und so
180 weiter. Viele DLLs mit derselben Reihenfolge können durch Kommata
181 getrennt werden. Es ist auch möglich, mit dem Semikolon verschiedene
182 Reihenfolgen für verschiedene DLLs festzulegen.
183 .PP
184 Die Ladereihenfolge für eine 16bit-DLL wird immer durch die
185 Reihenfolge der 32bit-DLL bestimmt, die sie enthält. Diese 32bit-DLL
186 kann durch Ansehen des symbolischen Links der 16bit .dll.so-Datei
187 gefunden werden. Wenn zum Beispiel ole32.dll als "builtin" eingestellt
188 ist, wird storage.dll ebenfalls als "builtin" geladen, da die
189 32bit-DLL ole32.dll die 16bit-DLL storage.dll enthält.
190 .PP
191 Beispiele:
192 .TP
193 WINEDLLOVERRIDES="comdlg32,shell32=n,b"
194 .br
195 Versuche, die DLLs comdlg32 und shell32 als native Windows-DLLs zu
196 laden; wenn dies fehlschlägt, soll Wine die mitgebrachte Version
197 benutzen.
198 .TP
199 WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
200 .br
201 Versuche, die DLLs comdlg32 und shell32 als native Windows-DLLs zu
202 laden. Weiterhin, wenn eine Anwendung versucht, die DLL
203 c:\(rsfoo\(rsbar\(rsbaz.dll zu laden, soll wine die eingebaute DLL baz
204 verwenden.
205 .TP
206 WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n"
207 .br
208 Versuche, die mitgebrachte comdlg32-Bibliothek zu laden; wenn dies
209 fehlschlägt soll Wine die native comdlg32-DLL nutzen. Bei shell32 soll
210 immer die mitgebrachte Version verwendet werden; bei comctl32 immer
211 die native.
212 .RE
213 .TP
214 .I DISPLAY
215 Gibt das zu nutzende X11-Display an.
216 .TP
217 OSS sound driver configuration variables
218 .TP
219 .I AUDIODEV
220 Gerät für Audio-Ein-/Ausgabe festlegen. Standard:
221 .BR /dev/dsp .
222 .TP
223 .I MIXERDEV
224 Audiomixer-Gerät festlegen. Standard:
225 .BR /dev/mixer .
226 .TP
227 .I MIDIDEV
228 MIDI-Sequencergerät festlegen. Standard:
229 .BR /dev/sequencer .
230 .SH DATEIEN
231 .TP
232 .I @bindir@/wine
233 Der
234 .B wine
235 -Programmstarter
236 .TP
237 .I @bindir@/wineconsole
238 Der
239 .B wine
240 -Programmstarter für Konsolenapplikationen (CLI)
241 .TP
242 .I @bindir@/wineserver
243 Der
244 .B wine
245 -Server
246 .TP
247 .I @bindir@/winedbg
248 Der
249 .B wine
250 -Debugger
251 .TP
252 .I @dlldir@
253 Der Ordner mit den gemeinsamen DLLs von
254 .B wine
255 .TP
256 .I $WINEPREFIX/dosdevices
257 Dieser Ordner enthält die DOS-Gerätezuweisungen. Jede Datei in diesem
258 Ordner ist ein Symlink auf die Unix-Gerätedatei, die dieses Gerät
259 bereitstellt. Wenn zum Beispiel COM1 /dev/ttyS0 repräsentieren soll,
260 wird der Symlink $WINEPREFIX/dosdevices/com1 -> /dev/ttyS0 benötigt.
261 .br
262 DOS-Laufwerke werden auch mit Symlinks angegeben. Wenn z.B. das
263 Laufwerk D: dem CD-ROM-Laufwerk entsprechen soll, das auf /mnt/cdrom
264 eingebunden ist, wird der Link $WINEPREFIX/dosdevices/d: -> /mnt/cdrom
265 benötigt. Es kann auch die Unix-Gerätedatei angegeben werden; der
266 einzige Unterschied ist der "::" anstelle dem einfachen ":" im Namen:
267 $WINEPREFIX/dosdevices/d:: -> /dev/hdc.
268 .SH AUTOREN
269 .B wine
270 ist dank der Arbeit vieler Entwickler verfügbar. Für eine Liste siehe
271 die Datei
272 .B AUTHORS
273 im obersten Ordner der Quellcodedistribution.
274 .SH COPYRIGHT
275 .B wine
276 kann unter den Bedingungen der LGPL genutzt werden; für eine Kopie der
277 Lizenz siehe die Datei
278 .B COPYING.LIB
279 im obersten Ordner der Quellcodedistribution.
280 .SH FEHLER
281 .PP
282 Statusberichte für viele Anwendungen sind unter
283 .I http://appdb.winehq.org
284 verfügbar. Bitte fügen Sie Anwendungen, die Sie mit Wine nutzen, der
285 Liste hinzu, sofern noch kein Eintrag existiert.
286 .PP
287 Fehler können unter
288 .I http://bugs.winehq.org
289 gemeldet werden. Wenn Sie einen Fehler melden möchten, lesen Sie
290 bitte vorher
291 .I http://wiki.winehq.org/Bugs
292 im
293 .B wine
294 -Quellcode, um zu sehen, welche Informationen benötigt werden.
295 .PP
296 Probleme und Hinweise mit/zu dieser Manpage können auch auf
297 .I http://bugs.winehq.org
298 gemeldet werden.
299 .SH VERFÜGBARKEIT
300 Die aktuellste öffentliche Wine-Version kann auf
301 .I http://www.winehq.org/download
302 bezogen werden.
303 .PP
304 Ein Schnappschuss des Entwicklungscodes kann via GIT besorgt werden,
305 siehe dazu
306 .I
307 http://www.winehq.org/site/git
308 .PP
309 WineHQ, die Hauptseite der
310 .B wine
311 -Entwicklung, befindet sich auf
312 .IR http://www.winehq.org .
313 Diese Website bietet viele Informationen und Ressourcen zu
314 .BR wine .
315 .PP
316 Für nähere Informationen zur Entwicklung von
317 .B wine
318 können Sie sich als Abonnement bei der
319 .B wine
320 -Mailingliste auf
321 .I http://www.winehq.org/forums
322 eintragen.
323 .SH "SIEHE AUCH"
324 .BR wineserver (1),\ winedbg (1)