Marco Schuster | fab0aee | 2007-12-11 17:18:14 +0100 | [diff] [blame] | 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) |