324 lines
9.3 KiB
Groff
324 lines
9.3 KiB
Groff
|
.\" -*- nroff -*-
|
||
|
|
.TH WINE 1 "November 2007" "@PACKAGE_STRING@" "Windows On Unix"
|
||
|
|
.SH NAME
|
||
|
|
wine \- Windows-Programme auf Unix-Systemen ausführen
|
||
|
|
.SH ÜBERSICHT
|
||
|
|
.BI "wine " "Programm " "[Argumente ... ]"
|
||
|
|
.br
|
||
|
|
.B wine --help
|
||
|
|
.br
|
||
|
|
.B wine --version
|
||
|
|
.PP
|
||
|
|
Für das Übergeben von Kommandos an Windows-Programme siehe den
|
||
|
|
Abschnitt
|
||
|
|
.B
|
||
|
|
"Programm / Argumente"
|
||
|
|
in dieser Manpage.
|
||
|
|
.SH BESCHREIBUNG
|
||
|
|
.B wine
|
||
|
|
lädt und führt ein Windows-Programm aus. Dieses Programm kann ein
|
||
|
|
beliebiges DOS/Win3.1/Win32-Programm sein; es wird nur die
|
||
|
|
x86-Architektur unterstützt.
|
||
|
|
.PP
|
||
|
|
Um wine zu debuggen, nutzen Sie anstelledessen das Kommando
|
||
|
|
.B winedbg.
|
||
|
|
.PP
|
||
|
|
Um rein kommandozeilenbasierte Programme auszuführen, nutzen Sie
|
||
|
|
.B wineconsole
|
||
|
|
anstelle von
|
||
|
|
.B wine.
|
||
|
|
Wenn Sie nicht
|
||
|
|
.B wineconsole
|
||
|
|
für CLI-Programme nutzen, kann dies dazu führen, dass das Programm
|
||
|
|
nicht korrekt ausgeführt werden kann.
|
||
|
|
.PP
|
||
|
|
Wenn wine nur mit
|
||
|
|
.B --help
|
||
|
|
oder
|
||
|
|
.B --version
|
||
|
|
als Argument aufgerufen wird, wird
|
||
|
|
.B wine
|
||
|
|
nur einen kleinen Hilfetext oder die Version ausgeben und sich beenden.
|
||
|
|
.SH PROGRAMM/ARGUMENTE
|
||
|
|
Der Programmname kann auf DOS-Art (
|
||
|
|
.I
|
||
|
|
C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE
|
||
|
|
) oder auf UNIX-Art angegeben werden (
|
||
|
|
.I /msdos/windows/sol.exe
|
||
|
|
). Sie können Argumente an die Windows-Anwendung übergeben, indem Sie
|
||
|
|
sie einfach an den wine-Befehl anhängen (z. B.:
|
||
|
|
.I wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT
|
||
|
|
).
|
||
|
|
Sie müssen unter Umständen Sonderzeichen und/oder Leerzeichen
|
||
|
|
mit '\(rs' maskieren, wenn Sie wine über die Kommandokonsole aufrufen,
|
||
|
|
z.B.
|
||
|
|
.PP
|
||
|
|
wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe
|
||
|
|
.PP
|
||
|
|
.SH UMGEBUNGSVARIABLEN
|
||
|
|
.B wine
|
||
|
|
leitet die Umgebungsvariablen der Shell, in der es gestartet wurde, an
|
||
|
|
die Windows-Applikation weiter. Um eine für Ihre Applikation nötige
|
||
|
|
Variable zugänglich zu machen, folgen Sie der Anleitung Ihrer Shell zu
|
||
|
|
Umgebungsvariablen.
|
||
|
|
.TP
|
||
|
|
.I WINEPREFIX
|
||
|
|
Wenn gesetzt, wird dieser Ordner als Speicherort für die
|
||
|
|
Konfigurationsdateien von
|
||
|
|
.B wine
|
||
|
|
genutzt. Die Standardeinstellung ist
|
||
|
|
.I $HOME/.wine.
|
||
|
|
Dieser Ordner wird auch für den UNIX-Socket zur Kommunikation mit
|
||
|
|
.I wineserver.
|
||
|
|
genutzt. Alle
|
||
|
|
.B wine
|
||
|
|
-Prozesse, die den gleichen
|
||
|
|
.B wineserver
|
||
|
|
nutzen (z.B. Prozesse desselben Nutzers) teilen sich bestimmte Objekte
|
||
|
|
wie die Registry, Arbeitsspeicher und die Konfigurationsdateien. Mit
|
||
|
|
dem Setzen von
|
||
|
|
.I WINEPREFIX
|
||
|
|
beim Starten verschiedener
|
||
|
|
.B wine
|
||
|
|
-Prozesse ist es möglich, eine Anzahl vollkommen unabhängiger
|
||
|
|
.B wine
|
||
|
|
-Prozesse zu starten.
|
||
|
|
.TP
|
||
|
|
.I WINESERVER
|
||
|
|
Gibt den Ort der
|
||
|
|
.B wineserver
|
||
|
|
-Anwendung an. Wenn diese Variable nicht gesetzt ist, wird versucht,
|
||
|
|
.B @bindir@/wineserver
|
||
|
|
zu laden. Wenn auch dies nicht funktioniert, sucht
|
||
|
|
.B wine
|
||
|
|
in $PATH und anderen Orten nach wineserver.
|
||
|
|
.TP
|
||
|
|
.I WINELOADER
|
||
|
|
Gibt den Ort der
|
||
|
|
.B wine
|
||
|
|
-Anwendung an, die genutzt wird, um Windows-Programme zu laden. Wenn
|
||
|
|
diese Variable nicht gesetzt ist, wird versucht,
|
||
|
|
.B @bindir@/wineserver
|
||
|
|
zu laden. Wenn auch dies nicht funktioniert, wird in $PATH und anderen
|
||
|
|
Orten nach wine gesucht.
|
||
|
|
.TP
|
||
|
|
.I WINEDEBUG
|
||
|
|
Wählt die Stufe der Debug-Meldungen aus. Die Variable hat das Format
|
||
|
|
.RI [ Klasse ][+/-] Kanal [,[ Klasse2 ][+/-] Kanal2 ].
|
||
|
|
.RS +7
|
||
|
|
.PP
|
||
|
|
.I Klasse
|
||
|
|
ist optional und kann z.B. folgende Werte annehmen:
|
||
|
|
.B err, warn, fixme,
|
||
|
|
oder
|
||
|
|
.B trace.
|
||
|
|
Wenn
|
||
|
|
.I class
|
||
|
|
nicht angegeben ist, werden alle Debugmeldungen dieses Kanals
|
||
|
|
ausgegeben. Jeder Kanal gibt Meldungen einer bestimmten
|
||
|
|
.B wine.
|
||
|
|
-Komponente aus. Das folgende Zeichen kann entweder + oder - sein, je
|
||
|
|
nachdem ob der Kanal ein- oder ausgeschaltet werden soll. Wenn keine
|
||
|
|
.I Klasse
|
||
|
|
angegeben ist, kann das führende + weggelassen werden. In WINEDEBUG
|
||
|
|
sind keine Leerzeichen erlaubt.
|
||
|
|
.PP
|
||
|
|
Beispiele:
|
||
|
|
.TP
|
||
|
|
WINEDEBUG=warn+all
|
||
|
|
zeigt alle Nachrichten der Kategorie "warning" an (empfohlen zum
|
||
|
|
Debuggen).
|
||
|
|
.br
|
||
|
|
.TP
|
||
|
|
WINEDEBUG=warn+dll,+heap
|
||
|
|
schaltet alle DLL-Meldungen der Kategorie "warning" sowie jegliche
|
||
|
|
Heap-Meldungen an.
|
||
|
|
.br
|
||
|
|
.TP
|
||
|
|
WINEDEBUG=fixme-all,warn+cursor,+relay
|
||
|
|
schaltet alle FIXME-Nachrichten ab, Zeigernachrichten der Kategorie
|
||
|
|
"warning" an und schaltet alle Relay-Meldungen (API-Aufrufe) an.
|
||
|
|
.br
|
||
|
|
.TP
|
||
|
|
WINEDEBUG=relay
|
||
|
|
schaltet alle Relay-Nachrichten an. Für mehr Kontrolle über die im
|
||
|
|
Relaytrace angezeigten DLLs und Funktionen siehe den [Debug]-Abschnitt
|
||
|
|
der Wine-Konfigurationsdatei.
|
||
|
|
.PP
|
||
|
|
Für mehr Informationen zu den Debug-Meldungen siehe den Abschnitt
|
||
|
|
.I Running Wine
|
||
|
|
im Wine-Benutzerhandbuch.
|
||
|
|
.RE
|
||
|
|
.TP
|
||
|
|
.I WINEDLLPATH
|
||
|
|
Gibt den Pfad/die Pfade an, in denen wine nach eigenen DLLs und
|
||
|
|
Winelib-Anwendungen sucht. Die Einträge der Liste werden mit einem ":"
|
||
|
|
getrennt. Zusätzlich wird noch in
|
||
|
|
.B @dlldir@
|
||
|
|
gesucht.
|
||
|
|
.TP
|
||
|
|
.I WINEDLLOVERRIDES
|
||
|
|
Definiert die Bibliotheksüberschreibung und Ladereihenfolge der DLLs,
|
||
|
|
die beim Laden jeder DLL berücksichtigt wird. Die Standardwerte sind
|
||
|
|
in der Konfigurationsdatei enthalten. Derzeit gibt es zwei Typen von
|
||
|
|
DLLs, die in den Speicher eines Prozesses geladen werden können:
|
||
|
|
Native Windows-DLLs (
|
||
|
|
.I native
|
||
|
|
) und
|
||
|
|
.B wine
|
||
|
|
-interne DLLs (
|
||
|
|
.I builtin
|
||
|
|
). Der Typ kann mit dem ersten Buchstaben abgekürzt werden (
|
||
|
|
.I n, b
|
||
|
|
). Jede Anweisungssequenz muss mit einem Komma abgeschlossen werden.
|
||
|
|
.RS
|
||
|
|
.PP
|
||
|
|
Jede DLL kann ihre eigene Ladereihenfolge besitzen. Die
|
||
|
|
Ladereihenfolge bestimmt, welche DLL-Version als erste geladen werden
|
||
|
|
soll. Wenn die erste versagt, ist die nächste an der Reihe und so
|
||
|
|
weiter. Viele DLLs mit derselben Reihenfolge können durch Kommata
|
||
|
|
getrennt werden. Es ist auch möglich, mit dem Semikolon verschiedene
|
||
|
|
Reihenfolgen für verschiedene DLLs festzulegen.
|
||
|
|
.PP
|
||
|
|
Die Ladereihenfolge für eine 16bit-DLL wird immer durch die
|
||
|
|
Reihenfolge der 32bit-DLL bestimmt, die sie enthält. Diese 32bit-DLL
|
||
|
|
kann durch Ansehen des symbolischen Links der 16bit .dll.so-Datei
|
||
|
|
gefunden werden. Wenn zum Beispiel ole32.dll als "builtin" eingestellt
|
||
|
|
ist, wird storage.dll ebenfalls als "builtin" geladen, da die
|
||
|
|
32bit-DLL ole32.dll die 16bit-DLL storage.dll enthält.
|
||
|
|
.PP
|
||
|
|
Beispiele:
|
||
|
|
.TP
|
||
|
|
WINEDLLOVERRIDES="comdlg32,shell32=n,b"
|
||
|
|
.br
|
||
|
|
Versuche, die DLLs comdlg32 und shell32 als native Windows-DLLs zu
|
||
|
|
laden; wenn dies fehlschlägt, soll Wine die mitgebrachte Version
|
||
|
|
benutzen.
|
||
|
|
.TP
|
||
|
|
WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
|
||
|
|
.br
|
||
|
|
Versuche, die DLLs comdlg32 und shell32 als native Windows-DLLs zu
|
||
|
|
laden. Weiterhin, wenn eine Anwendung versucht, die DLL
|
||
|
|
c:\(rsfoo\(rsbar\(rsbaz.dll zu laden, soll wine die eingebaute DLL baz
|
||
|
|
verwenden.
|
||
|
|
.TP
|
||
|
|
WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n"
|
||
|
|
.br
|
||
|
|
Versuche, die mitgebrachte comdlg32-Bibliothek zu laden; wenn dies
|
||
|
|
fehlschlägt soll Wine die native comdlg32-DLL nutzen. Bei shell32 soll
|
||
|
|
immer die mitgebrachte Version verwendet werden; bei comctl32 immer
|
||
|
|
die native.
|
||
|
|
.RE
|
||
|
|
.TP
|
||
|
|
.I DISPLAY
|
||
|
|
Gibt das zu nutzende X11-Display an.
|
||
|
|
.TP
|
||
|
|
OSS sound driver configuration variables
|
||
|
|
.TP
|
||
|
|
.I AUDIODEV
|
||
|
|
Gerät für Audio-Ein-/Ausgabe festlegen. Standard:
|
||
|
|
.B /dev/dsp.
|
||
|
|
.TP
|
||
|
|
.I MIXERDEV
|
||
|
|
Audiomixer-Gerät festlegen. Standard:
|
||
|
|
.B /dev/mixer.
|
||
|
|
.TP
|
||
|
|
.I MIDIDEV
|
||
|
|
MIDI-Sequencergerät festlegen. Standard:
|
||
|
|
.B /dev/sequencer.
|
||
|
|
.SH DATEIEN
|
||
|
|
.TP
|
||
|
|
.I @bindir@/wine
|
||
|
|
Der
|
||
|
|
.B wine
|
||
|
|
-Programmstarter
|
||
|
|
.TP
|
||
|
|
.I @bindir@/wineconsole
|
||
|
|
Der
|
||
|
|
.B wine
|
||
|
|
-Programmstarter für Konsolenapplikationen (CLI)
|
||
|
|
.TP
|
||
|
|
.I @bindir@/wineserver
|
||
|
|
Der
|
||
|
|
.B wine
|
||
|
|
-Server
|
||
|
|
.TP
|
||
|
|
.I @bindir@/winedbg
|
||
|
|
Der
|
||
|
|
.B wine
|
||
|
|
-Debugger
|
||
|
|
.TP
|
||
|
|
.I @dlldir@
|
||
|
|
Der Ordner mit den gemeinsamen DLLs von
|
||
|
|
.B wine
|
||
|
|
.TP
|
||
|
|
.I $WINEPREFIX/dosdevices
|
||
|
|
Dieser Ordner enthält die DOS-Gerätezuweisungen. Jede Datei in diesem
|
||
|
|
Ordner ist ein Symlink auf die Unix-Gerätedatei, die dieses Gerät
|
||
|
|
bereitstellt. Wenn zum Beispiel COM1 /dev/ttyS0 repräsentieren soll,
|
||
|
|
wird der Symlink $WINEPREFIX/dosdevices/com1 -> /dev/ttyS0 benötigt.
|
||
|
|
.br
|
||
|
|
DOS-Laufwerke werden auch mit Symlinks angegeben. Wenn z.B. das
|
||
|
|
Laufwerk D: dem CD-ROM-Laufwerk entsprechen soll, das auf /mnt/cdrom
|
||
|
|
eingebunden ist, wird der Link $WINEPREFIX/dosdevices/d: -> /mnt/cdrom
|
||
|
|
benötigt. Es kann auch die Unix-Gerätedatei angegeben werden; der
|
||
|
|
einzige Unterschied ist der "::" anstelle dem einfachen ":" im Namen:
|
||
|
|
$WINEPREFIX/dosdevices/d:: -> /dev/hdc.
|
||
|
|
.SH AUTOREN
|
||
|
|
.B wine
|
||
|
|
ist dank der Arbeit vieler Entwickler verfügbar. Für eine Liste siehe
|
||
|
|
die Datei
|
||
|
|
.B AUTHORS
|
||
|
|
im obersten Ordner der Quellcodedistribution.
|
||
|
|
.SH COPYRIGHT
|
||
|
|
.B wine
|
||
|
|
kann unter den Bedingungen der LGPL genutzt werden; für eine Kopie der
|
||
|
|
Lizenz siehe die Datei
|
||
|
|
.B COPYING.LIB
|
||
|
|
im obersten Ordner der Quellcodedistribution.
|
||
|
|
.SH FEHLER
|
||
|
|
.PP
|
||
|
|
Statusberichte für viele Anwendungen sind unter
|
||
|
|
.I http://appdb.winehq.org
|
||
|
|
verfügbar. Bitte fügen Sie Anwendungen, die Sie mit Wine nutzen, der
|
||
|
|
Liste hinzu, sofern noch kein Eintrag existiert.
|
||
|
|
.PP
|
||
|
|
Fehler können unter
|
||
|
|
.I http://bugs.winehq.org
|
||
|
|
gemeldet werden. Wenn Sie einen Fehler melden möchten, lesen Sie
|
||
|
|
bitte vorher die Datei
|
||
|
|
.I documentation/bugs.sgml
|
||
|
|
im
|
||
|
|
.B wine
|
||
|
|
-Quellcode, um zu sehen, welche Informationen benötigt werden.
|
||
|
|
.PP
|
||
|
|
Probleme und Hinweise mit/zu dieser Manpage können auch auf
|
||
|
|
.I http://bugs.winehq.org
|
||
|
|
gemeldet werden.
|
||
|
|
.SH VERFÜGBARKEIT
|
||
|
|
Die aktuellste öffentliche Wine-Version kann auf
|
||
|
|
.I http://www.winehq.org/download
|
||
|
|
bezogen werden.
|
||
|
|
.PP
|
||
|
|
Ein Schnappschuss des Entwicklungscodes kann via GIT besorgt werden,
|
||
|
|
siehe dazu
|
||
|
|
.I
|
||
|
|
http://www.winehq.org/site/git
|
||
|
|
.PP
|
||
|
|
WineHQ, die Hauptseite der
|
||
|
|
.B wine
|
||
|
|
-Entwicklung, befindet sich auf
|
||
|
|
.I http://www.winehq.org.
|
||
|
|
Diese Website bietet viele Informationen und Ressourcen zu
|
||
|
|
.B wine.
|
||
|
|
.PP
|
||
|
|
Für nähere Informationen zur Entwicklung von
|
||
|
|
.B wine
|
||
|
|
können Sie sich als Abonnement bei der
|
||
|
|
.B wine
|
||
|
|
-Mailingliste auf
|
||
|
|
.I http://www.winehq.org/forums
|
||
|
|
eintragen.
|
||
|
|
.SH "SIEHE AUCH"
|
||
|
|
.BR wineserver (1),\ winedbg (1)
|