wine − exécuter des programmes Windows sous Unix

wine [options_wine] [--] programme [arguments ... ]

Pour obtenir des instructions sur la façon de passer des arguments à des programmes Windows, voyez s.v.p. la section PROGRAMME/ARGUMENTS de cette page de manuel.

wine programme charge et exécute le programme spécifié, où programme est un exécutable DOS, Windows 3.x ou Win32 (binaires x86 uniquement).

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

Pour exécuter des programmes CUI (Console User Interface, c.-à -d. des applications Windows en mode console), utilisez wineconsole au lieu de wine. Cela affichera toute la sortie dans des fenêtres séparées (cela nécessite l’utilisation de X11). Ne pas utiliser wineconsole pour les programmes CUI équivaut à ne fournir qu’un support console très limité, et votre programme pourrait dès lors ne pas fonctionner correctement.

wine peut actuellement exécuter un nombre croissant d’applications écrites pour toutes sortes de versions de Windows >= Win2.0, comme p.ex. Win3.1, Win95/98 ou NT. Les applications anciennes ou simples fonctionnent mieux que celles plus récentes ou complexes. L’utilisation des composants de Windows ME ou de Windows 2000 avec Wine est problématique ; ne pas les employer, ou n’utiliser que ceux des versions plus anciennes de Windows pose moins de problèmes. Un grand pourcentage de l’API a été implémenté, bien qu’il reste encore beaucoup de travail à effectuer.

Lisez le fichier README de la distribution des sources de Wine et la page de manuel de wine.conf pour savoir ce dont Wine a besoin, et comment on peut l’installer à partir des sources.

--debugmsg [xxx]#nom[,[xxx1]#nom1][,<+|->relay=yyy1[:yyy2]]

Activer ou désactiver les messages de débogage.

xxx est optionnel et peut valoir err, warn, fixme ou trace. Si xxx n’est pas spécifié, tous les messages de débogage relatifs au canal spécifié sont activés. Chaque canal affichera les messages provenant d’un composant particulier de wine. Le signe « # » est requis et peut être soit « + », soit « − ». Notez qu’il n’y a pas d’espace après la virgule séparant les noms. yyy est soit le nom d’une DLL dans sa totalité, soit celui d’une entrée isolée de l’API que vous voulez inclure ou exclure de la liste de relais. La casse n’a pas d’importance. Vous pouvez faire la même chose pour fouiner.

Exemples :

--debugmsg warn+all activera tous les messages d’avertissement (recommandé pour le débogage)
--debugmsg warn+dll,+heap activera tous les messages d’avertissement concernant les DLLs et le tas.
--debugmsg fixme-all,warn+cursor,+relay désactivera tous les messages FIXME, activera les messages d’avertissement relatifs au curseur, et activera tous les messages relais (appels à l’API).
--debugmsg -relay=rtlleavecriticalsection:RtlEnterCriticalSection activera tous les messages relais à l’exception de RtlLeaveCriticalSection et RtlEnterCriticalSection.
--debugmsg +relay=advapi32 activera tous les messages relais dans le code ADVAPI32. N’utilisez jamais --debugmsg +all seul ! Beaucoup trop d’informations sont produites, et Wine se plantera beaucoup trop facilement, embrouillant ainsi les utilisateurs inexpérimentés.

La liste complète des possibilités est : all, accel, advapi, animate, aspi, atom, avifile, bitblt, bitmap, caret, cdrom, class, clipboard, clipping, combo, comboex, comm, commctrl, commdlg, console, crtdll, cursor, datetime, dc, ddeml, ddraw, debug, debugstr, delayhlp, dialog, dinput, dll, dosfs, dosmem, dplay, driver, dsound, edit, elfdll, enhmetafile, event, exec, file, fixup, font, gdi, global, graphics, header, heap, hook, hotkey, icmp, icon, imagehlp, imagelist, imm, int, int10, int16, int17, int19, int21, int31, io, ipaddress, joystick, key, keyboard, loaddll, ldt, listbox, listview, local, mci, mcianim, mciavi, mcicda, mcimidi, mciwave, mdi, menu, message, metafile, midi, mmaux, mmio, mmsys, mmtime, module, monthcal, mpr, msacm, msg, msvideo, nativefont, nonclient, ntdll, odbc, ole, opengl, pager, palette, pidl, print, process, profile, progress, prop, propsheet, psapi, psdrv, ras, rebar, reg, region, relay, resource, richedit, scroll, segment, seh, selector, sendmsg, server, setupapi, setupx, shell, snoop, sound, static, statusbar, storage, stress, string, syscolor, system, tab, tape, tapi, task, text, thread, thunk, timer, toolbar, toolhelp, tooltips, trackbar, treeview, ttydrv, tweak, typelib, updown, ver, virtual, vxd, wave, win, win16drv, win32, winedbg, wing, wininet, winsock, winspool, wnet, x11 et x11drv.

Pour plus d’informations sur les messages de débogage, lisez le fichier documentation/running.sgml dans la distribution des sources (à CORRIGER : périmé).

--dll nom[,nom[,...]]={native|so|builtin}[,{n|s|b}[,...]]

Sélectionne le type de surcharge et l’ordre de chargement des DLLs utilisées lors du processus de chargement. Le comportement par défaut est défini dans le fichier de configuration. Il y a actuellement trois types de bibliothèques qui peuvent être chargées dans l’espace d’adressage d’un processus : les DLLs windows natives (native), les bibliothèques ELF natives (so) et les DLLs internes de wine (builtin). Le type peut être abrégé par la première lettre du type (n,s,b). Les séquences d’ordres doivent être séparées par des virgules.
Chaque DLL peut avoir son propre ordre de chargement. L’ordre de chargement détermine quelle version de la DLL on essaie de charger dans l’espace d’adressage. Si le chargement de la première échoue, on essaie la suivante et ainsi de suite. Plusieurs bibliothèques de même ordre de chargement peuvent être séparées par des virgules. Il est également possible d’utiliser plusieurs fois l’option --dll, afin de spécifier des ordres de chargement différents pour des bibliothèques différentes.

Exemples :
--dll comdlg32,commdlg=n,b
Essayer de charger comdlg32 et commdlg comme des DLLs windows natives ; charger la version intégrée en cas d’échec.
--dll shell,shell32=n --dll c:\\foo\\bar\\baz=b Essayer de charger les bibliothèques shell et shell32 comme des DLLs windows natives. De plus, si une application requiert le chargement de c:\foo\bar\baz.dll, alors charger la bibliothèque intégrée baz.
--dll comdlg32,commdlg=b,n --dll shell,shell32=b --dll comctl32,commctrl=n
Essayer de charger comdlg32 et commdlg comme des DLLs intégrées, ou employer les versions natives en cas d’échec ; toujours charger les DLLs shell32/shell intégrées et les DLLs comctl32/commctrl natives.
Note : il est sage de garder des paires de DLLs (comdlg32/commdlg, shell/shell32, etc.) ayant exactement le même ordre de chargement. Cela évitera des discordances au moment de l’exécution. Voyez également le format du fichier de configuration plus bas.

Le nom du programme peut être spécifié dans le format DOS (C:\\WINDOWS\\SOL.EXE) ou dans le format Unix (/msdos/windows/sol.exe). Vous pouvez passer des arguments au programme à exécuter en les ajoutant à la fin de la ligne de commandes invoquant wine (comme p.ex. wine notepad C:\\TEMP\\README.TXT). Notez que vous devez protéger les caractères spéciaux avec un « \ » (et des espaces) quand vous invoquez Wine à partir d’un shell, comme p.ex. dans

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

Le traitement de la ligne de commandes s’effectue comme suit : d’abord, wine vérifie si des options de wine susmentionnées ont été spécifiées. Celles−ci sont enlevées de la ligne de commandes, qui est alors transmise au programme windows. Vous pouvez utiliser le paramètre -- pour indiquer à wine d’arrêter le traitement de la ligne de commandes. C’est nécessaire si un programme windows comprend une option qui est habituellement interprétée (et donc enlevée de la ligne de commandes) par wine. Par exemple, si vous voulez lancer wine avec les options --dll riched32=n et que wine exécute le programme monapp.exe avec les arguments --display 3d unfichier, alors vous pourriez utiliser la ligne de commandes suivante pour invoquer wine :

wine --dll riched32=n -- monapp.exe --display 3d unfichier

Notez que par contraste avec les versions précédentes de wine, vous ne devez pas passer le nom du programme et ses options en un seul argument à wine. Pour exécuter plus d’un programme windows, exécutez simplement wine une fois avec le nom de chaque programme comme argument.

wine donne accès aux variables d’environnement du shell à partir duquel wine a été lancé aux processus windows/dos démarrés. Utilisez donc la syntaxe appropriée à votre shell pour entrer les variables d’environnement dont vous avez besoin.

WINEPREFIX

Si cette variable est définie, son contenu représente le nom du répertoire où wine stocke ses données ($HOME/.wine par défaut). Ce répertoire contient également la socket qui est utilisée pour communiquer avec le wineserver (serveur wine). Tous les processus wine utilisant le même wineserver (c.-à -d. le même utilisateur) partagent certaines choses comme le registre, la mémoire partagée, et le fichier de configuration. En donnant différentes valeurs à WINEPREFIX pour différents processus wine, il est possible d’exécuter plusieurs processus wine réellement indépendants.

WINESERVER

Spécifie le chemin et le nom du binaire wineserver. Si cette variable n’est pas définie, Wine essaiera de charger /opt/bin/wineserver et, en cas d’échec, recherchera un fichier nommé « wineserver » dans le PATH et dans quelques autres emplacements vraisemblables.

WINELOADER

Spécifie le chemin et le nom du binaire wine à utiliser pour lancer de nouveaux processus Windows. Si cette variable n’est pas définie, Wine essaiera de charger /opt/bin/wine et, en cas d’échec, recherchera un fichier nommé « wine » dans le PATH et dans quelques autres emplacements vraisemblables.

WINEDLLPATH

Spécifie le(s) chemin(s) de recherche des DLLs intégrées et des applications Winelib. C’est une liste de répertoires séparés par des « : ». En plus de tous les répertoires spécifiés dans WINEDLLPATH, Wine recherchera également dans /opt/lib/wine.

DISPLAY

Spécifie l’affichage X11 à utiliser.

wine s’attend à un fichier de configuration ($WINEPREFIX/config (~/.wine/config)), qui doit se conformer au format spécifié dans la page de manuel de wine.conf(5). Voyez le fichier documentation/samples/config dans l’archive des sources de Wine pour un exemple de fichier de configuration.

wine est disponible grâce au travail de nombreux développeurs. Pour obtenir une liste des auteurs, veuillez lire le fichier AUTHORS dans le répertoire racine de la distribution des sources.

wine peut être distribué selon les termes de la licence LGPL. Une copie de la licence se trouve dans le fichier LICENSE situé dans le répertoire racine de la distribution des sources.

Un compte-rendu sur l’état de prise en charge d’un grand nombre d’applications peut être trouvé sur http://www.winehq.com/Apps. Veuillez ajouter des entrées à cette liste pour les applications que vous utilisez actuellement.

Les rapports de bogues peuvent être envoyés au Bugzilla de Wine sur http://bugs.winehq.com. Si vous voulez poster un rapport de bogue, lisez au préalable le fichier documentation/bugs.sgml dans les sources de wine pour savoir quelles informations sont nécessaires.

Pour rapporter des problèmes et/ou suggestions concernant cette page de manuel, visitez également http://bugs.winehq.com.

La version publique la plus récente de wine peut être obtenue via FTP depuis ibiblio.org dans le répertoire /pub/Linux/ALPHA/Wine/development. Les publications se font dans le format « Wine-yyyymmdd.tar.gz », ou « Wine-yyyymmdd.diff.gz » pour le fichier diff relatif à la version précédente. Le même répertoire contient le contenu pré−construit de la documentation dans divers formats (wine-doc.xxx.gz).

Le dernier instantané du code peut être obtenu via CVS. Pour des informations sur la façon de procéder, voyez s.v.p. http://www.winehq.com/development/ .

WineHQ, le quartier général du développement de wine, peut être trouvé sur http://www.winehq.com/. Ce site web contient un tas d’informations concernant wine.

Le groupe de discussion sur wine est comp.emulators.ms-windows.wine. Il est utilisé pour discuter de divers aspects de wine relatifs à (l’aide à ) l’utilisateur final.

Pour plus d’informations sur le développement de wine, vous pouvez souscrire aux listes de diffusion de wine sur http://www.winehq.com/development/#ml.

/opt/bin/wine

Le chargeur de programmes de wine.

/opt/bin/wineconsole

Le chargeur de programmes de wine pour les applications CUI (console).

/opt/bin/wineserver

Le serveur wine.

/opt/bin/winedbg

Le débogueur de wine.

/opt/bin/wineclipsrv

Le serveur de presse-papiers de wine.

/opt/lib/wine

Le répertoire contenant les bibliothèques partagées de wine.

~/.wine/config

Le fichier de configuration spécifique à l’utilisateur.

~/.wine

Le répertoire contenant les données spécifiques à l’utilisateur gérées par wine.

wine.conf(5)

Frédéric Delanoy <delanoy_f at yahoo.com>, 2002.