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.
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.
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é).
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:rsrsfoorsrsbarrsrsbaz=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:rsfoorsbarrsbaz.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.
wine C:rsrsProgramrs FilesrsrsMonProgrsrstest.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.
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.
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.