WINE(1)

NOM
wine - exécuter des programmes Windows sur Unix

SYNOPSIS
wine PROGRAMME [ARGUMENTS ... ]
wine --help
wine --version

Pour des instructions sur le passage d'arguments aux programmes Windows, veuillez lire la section PROGRAMME/ARGUMENTS de la page de manuel.

DESCRIPTION
wine charge et exécute le programme indiqué, qui peut être un exécutable DOS, Windows 3.x ou Win32 (binaires x86 uniquement).

Pour déboguer wine, utilisez plutôt winedbg.

Pour exécuter des applications en ligne de commande (programmes Windows console), préférez wineconsole. Cela permet d'afficher la sortie dans une fenêtre séparée (nécessite X11). Si vous n'utilisez pas wineconsole pour les programmes en ligne de commande, le support console sera très limité et votre programme peut ne pas fonctionner correctement.

Lorsque wine est invoqué avec --help ou --version pour seul argument, il affichera seulement un petit message d'aide ou, respectivement, sa version, puis se terminera.

PROGRAMME/ARGUMENTS
Le nom du programme peut être spécifié au format DOS (C:\\WINDOWS\\SOL.EXE) ou au format Unix (/msdos/windows/sol.exe). Vous pouvez passer des arguments au programme exécuté en les ajoutant à la fin de la ligne de commande invoquant wine (par exemple : wine notepad C:\\TEMP\\LISEZMOI.TXT). Notez que vous devrez protéger les caractères spéciaux (et les espaces) en utilisant un '\' lorsque vous invoquez Wine depuis un shell, par exemple :

wine C:\\Program\ Files\\MyPrg\\test.exe

VARIABLES D'ENVIRONNEMENT
wine rend les variables d'environnement du shell depuis lequel wine est lancé accessibles au processus Windows/DOS exécuté. Utilisez donc la syntaxe appropriée pour votre shell pour déclarer les variables d'environnement dont vous avez besoin.

WINEPREFIX
    Si définie, le contenu de cette variable est pris comme le nom du répertoire où wine stocke ses données (la valeur par défaut est $HOME/.wine). Ce répertoire est également utilisé pour identifier le socket utilisé pour communiquer avec wineserver. Tous les processus wine utilisant le même wineserver (c'est-à-dire le même utilisateur) partagent certains éléments comme la base de registre, la mémoire partagée et les objets du noyau. En donnant à WINEPREFIX une valeur spécifique pour différents processus wine, il est possible d'exécuter plusieurs sessions de wine totalement indépendantes.

WINESERVER
    Spécifie le chemin et le nom de l'exécutable wineserver. Si cette variable n'est pas définie, Wine essaiera de charger /bin/wineserver ou, à défaut, un fichier nommé wineserver dans le chemin système ou quelques autres emplacements potentiels.

WINELOADER
    Spécifie le chemin et le nom de l'exécutable wine à utiliser pour exécuter de nouveaux processus Windows. S'il n'est pas défini, Wine essaiera de charger /bin/wine ou, à défaut, un fichier nommé "wine" dans le chemin système ou quelques autres emplacements potentiels.

WINEDEBUG
    Active ou désactive les messages de débogage. La syntaxe est la suivante : [classe][+/-]canal[,[classe2][+/-]canal2].

    classe est optionnel et peut avoir une des valeurs suivantes : err, warn, fixme ou trace. Si classe n'est pas spécifié, tous les messages de débogage pour le canal spécifié seront activés. Chaque canal imprimera des messages à propos d'un composant particulier de wine. Le caractère suivant peut être + ou - pour activer/désactiver le canal spécifié. Si aucune classe n'est spécifiée, le caractère + peut être omis. Notez que les espaces ne sont pas autorisées dans cette chaîne de caractères.

    Exemples :

    WINEDEBUG=warn+all
        activera tous les messages d'avertissement (recommandé pour le débogage).

    WINEDEBUG=warn+dll,+heap
        activera tous messages d'avertissement sur les DLL, et tous les messages sur le tas.

    WINEDEBUG=fixme-all,warn+cursor,+relay
        désactivera tous les messages FIXME, activera les messages d'avertissement sur le composant cursor et activera tous les messages du canal relay (appels de l'API).

    WINEDEBUG=relay
        activera tous les messages du canal relay. Pour un contrôle plus fin sur l'inclusion et l'exclusion des fonctions et DLL des traces relay, référez-vous à la section [Debug] du fichier de configuration de Wine.

    Pour plus d'informations sur les messages de débogage, référez-vous au chapitre Exécution de Wine du guide de l'utilisateur de Wine.

WINEDLLPATH
    Spécifie le(s) chemin(s) où chercher les DLL intégrées et les applications Winelib. C'est une liste de répertoires séparés par des « : ». En plus des répertoires spécifiés dans WINEDLLPATH, Wine utilisera aussi le répertoire /lib/wine.

WINEDLLOVERRIDES
    Définit le type de remplacement et l'ordre de chargement des DLL utilisées lors du processus de chargement d'une DLL. Deux types de bibliothèques peuvent actuellement être chargés dans l'espace d'adressage d'un processus : les DLL natives de Windows (native), et les DLL fournies par wine (builtin). Le type peut être abrégé avec la première lettre du type (n, b). La bibliothèque peut également être désactivée (''). Chaque séquence d'ordre doit être séparé par une virgule.

    Chaque DLL peut avoir son ordre de chargement propre. L'ordre de chargement détermine quelle version de la DLL doit être chargée dans l'espace d'adressage. Si la première tentative échoue, la suivante est essayée et ainsi de suite. Plusieurs bibliothèques avec le même ordre de chargement peuvent être séparées par une virgule. Il est également possible de spécifier différents ordres de chargements pour différentes bibliothèques en séparant les entrées par « ; ».

    L'ordre de chargement pour une DLL 16-bit est toujours défini par l'ordre de chargement de la DLL 32-bit qui la contient (qui peut être identifié en observant le lien symbolique du fichier .dll.so 16-bit). Par exemple, si ole32.dll est configurée comme builtin, storage.dll sera également chargée comme builtin puisque la DLL 32-bit ole32.dll contient la DLL 16-bit storage.dll.

    Exemples :

    WINEDLLOVERRIDES="comdlg32,shell32=n,b"
        Tente de charger comdlg32 et shell32 comme des DLL windows natives en premier, puis essaie la version fournie si le chargement de la version native échoue.

    WINEDLLOVERRIDES="comdlg32,shell32=n;c:\\foo\\bar\\baz=b"
        Tente de charger les bibliothèques windows natives comdlg32 et shell32. De plus, si une application demande le chargement de c:\foo\bar\baz.dll, chargera la bibliothèque fournie baz.

    WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
        Tente de charger la bibliothèque fournie comdlg32 en premier, puis essaie la version native ensuite si le chargement de la version fournie échoue. Dans tous les cas, la version fournie de shell32 et la version native de comctl32 sera chargée. Oleaut32 sera désactivée.

DISPLAY
    Spécifie l'affichage X11 à utiliser.

Variables de configuration du pilote audio OSS

AUDIODEV
    Définit le périphérique pour les entrées/sorties audio. La valeur par défaut est /dev/dsp.

MIXERDEV
    Définit le périphérique pour les contrôles du mixer. La valeur par défaut est /dev/mixer.

MIDIDEV
    Définit le périphérique pour le séquenceur MIDI. La valeur par défaut est /dev/sequencer.

FICHIERS

/bin/wine
    Le chargeur de programme de wine.

/bin/wineconsole
    Le chargeur de programme pour les applications en mode console (CUI).

/bin/wineserver
    Le serveur wine.

/bin/winedbg
    Le débogueur de wine.

/lib/wine
    Répertoire contenant les bibliothèques partagées de wine.

$WINEPREFIX/dosdevices
    Répertoire contenant le mapping des périphériques DOS. Chaque fichier dans ce répertoire est un lien symbolique vers le fichier périphérique Unix qui implémente un périphérique donné. Par exemple, si COM1 est mappé sur /dev/ttyS0, vous aurez un lien symbolique de la forme $WINEPREFIX/dosdevices/com1 -> /dev/ttyS0.
    Les lecteurs DOS sont aussi définis à l'aide de liens symboliques ; par exemple, si le lecteur D: correspond au CDROM monté sur /mnt/cdrom, vous aurez un lien symbolique $WINEPREFIX/dosdevices/d: -> /mnt/cdrom. Le périphérique Unix correspondant à un lecteur DOS peut être spécifié de la même façon, à l'exception du fait qu'il faut utiliser « :: » à la place de « : ». Dans l'exemple précédent, si le lecteur CDROM est monté depuis /dev/hdc, le lien symbolique correspondant sera $WINEPREFIX/dosdevices/d:: -> /dev/hdc.

AUTEURS
wine est disponible grâce au travail de nombreux développeurs. Pour une liste des auteurs, référez-vous au fichier AUTHORS à la racine de la distribution source.

COPYRIGHT
wine peut être distribué sous les termes de la licence LGPL. Une copie de cette licence se trouve dans le fichier COPYING.LIB à la racine de la distribution source.

ANOMALIES

Un rapport sur la compatibilité de nombreuses applications est disponible sur http://appdb.winehq.org. N'hésitez pas à y ajouter des entrées pour les applications que vous exécutez en ce moment.

Les rapports d'anomalie peuvent être postés sur le Bugzilla de Wine http://bugs.winehq.org. Si vous souhaitez envoyer un rapport d'anomalie, veuillez vous référer à http://wiki.winehq.org/Bugs dans les sources de wine pour voir quelles informations sont nécessaires.

Les problèmes et suggestions concernant cette page du manuel peuvent également être rapportés sur http://bugs.winehq.org.

DISPONIBILITÉ
La version publique la plus récente de wine peut être téléchargée depuis http://www.winehq.org/download.

Le dernier développement du code peut être obtenu par git. Pour des informations détaillées, veuillez vous référer à http://www.winehq.org/site/git.

WineHQ, le quartier général du développement de wine est situé sur http://www.winehq.org. Le site Web contient de nombreuses informations sur wine.

Pour plus d'informations sur le développement de wine, vous pouvez vous inscrire aux mailing-lists de wine sur http://www.winehq.org/forums.

VOIR AUSSI
wineserver(1), winedbg(1)