1. INTRODUCTION Wine est un programme qui permet d'ex�cuter les logiciels �crits pour Microsoft Windows (comprenant les ex�cutables DOS, Windows 3.x et Win32) sur un Unix. Il est compos� d'un chargeur qui charge et ex�cute un binaire Microsoft Windows, ainsi que d'une librairie (appel�e Winelib) qui impl�mente les appels de l'API de Windows par leur �quivalent Unix ou X11. Cette librairie peut �galement �tre utilis�e pour porter du code Win32 vers un ex�cutable Unix natifs. Wine est un logiciel libre, distribu� sous GNU LGPL; lisez le fichier LICENCE pour les d�tails. 2. D�MARRAGE RAPIDE M�me si vous compilez � partir des sources, il est recommand� d'utiliser l'Installateur de Wine pour construire et installer Wine. � partir du r�pertoire le plus �lev� des sources de Wine (qui contient ce fichier), ex�cutez : ./tools/wineinstall Pour ex�cuter les programmes, tapez "wine [options] programme". Pour des informationS compl�mentaires et des r�solutions de probl�mes, lisez le reste de ce fichier, les pages "man" de Wine, et surtout les nombreuses informations que vous trouverez sur http://www.winehq.org. 3. CONFIGURATION N�CESSAIRE Pour compiler et ex�cuter Wine, vous devez avoir un des syst�mes d'exploitation qui suit : Linux version 2.0.36 ou sup�rieur FreeBSD 4.x or FreeBSD 5-CURRENT ou sup�rieur Solaris x86 2.5 ou sup�rieur NetBSD-current �tant donn� que Wine n�cessite une impl�mentation des "threads" au niveau du noyau, seuls les syst�mes d'exploitation mentionn�s ci-haut sont support�s. D'autres syst�mes d'exploitation qui impl�mentent les "threads" noyau peuvent �tre support�s dans le futur. Information Linux : Bien que Linux 2.2.x devrait encore fontionner et que Linux 2.0.x pourrait encore marcher (des versions plus anciennes de 2.0.x avaient des plantages d� aux "threads"), il est pr�f�rable d'avoir un noyau r�cent tel que 2.4.x. Information FreeBSD : Wine devrait pouvoir �tre compil� sur FreeBSD 4.x et FreeBSD 5.x, mais les versions ant�rieures � FreeBSD 5.3 ne fonctionneront g�n�ralement pas. Plus d'information est situ�e dans l'arbre de ports : ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/ Information Solaris : Il est plus que probable que vous devrez construire Wine avec la cha�ne d'outils GNU (gcc, gas, etc.). Avertissement : intaller gas n'assure pas qu'il sera utilis� par gcc. Recompliler gcc apr�s l'installation de gas ou cr�er un lien symbolique de cc, as et ld vers les outils GNU semble n�cessaire. Information NetBSD : Assurez-vous d'avoir les options USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG enclanch�es dans votre noyau. Syst�mes de fichier support�s : Wine devrait fonctionner sur la plupart des syst�mes de fichier. Cependant Wine s'arr�tera au d�marrage si umsdos est utilis� pour le r�pertoire /tmp. Quelques probl�mes de compatibilit� ont aussi �t� rapport�s sur l'utilisation des fichiers acc�d�s au travers de Samba. Egalement, puisque NTFS ne peut �tre utilis� en s�curit� qu'avec un acc�s en lecture seul pour le moment, nous recommandons de ne pas utiliser NTFS, parce que les programmes Windows on besoin des acc�s en �criture presque partout. Si vous avez des fichier NTFS, copiez les vers une localisation accessible en �criture. Configuration requise de base : Vous avez besoin d'avoir les fichiers "include" de X11 install�s (appel�s xlib6g-dev pour Debian et XFree86-devel pour RedHat). Configuration requise des outils de compilation : Sur les syst�me x86, gcc >= 2.7.2 est n�cessaire. Les versions inf�rieures � la 2.7.2.3 peuvent cr�er des ennuis losrque certains fichiers sont compil�s avec l'optimisation, souvent d� � des probl�mes de gestion d'en-t�te de fichier. pgcc ne fonctionne pas actuellement avec Wine. La cause de ce probl�me est inconnue. �videmment, vous aurez besoin de "make" (tr�s probablement GNU make). Vous aurez �galement besoin de flex version 2.5 ou sup�rieure et bison. Si vous utilisez RedHat ou Debian, installez les paquets flex et bison. Librairies optionnelles : Si vous voulez un support d'impression � l'aide de CUPS, SVP installez � la fois les packages cups et cups-devel. 4. COMPILATION Au cas o� vous choisissez de ne pas utiliser wineinstall, ex�cuter les com- mandes suivantes pour construire Wine : ./configure make depend make Cela va constuire le programme "wine" et de nombreux binaires/librairies de support. Le programme "wine" chargera et ex�cutera les ex�cutables Windows. La librairie "libwine" ("Winelib") peut �tre utilis�e pour compiler et lier le code source Windows sous Unix. Pour voir les options de compilation, tapez ./configure --help. Pour mettre � jour une nouvelle version en utilisant les fichiers patch, tout d'abord aller dans le r�pertoire de plus haut niveau de la version actuelle (celui qui contient ce fichier README.fr). Ensuite faire un "make clean", et patcher la version avec : gunzip -c patch-file | patch -p1 Avec "patch-file" qui est le nom du fichier de patche (quelque chose de similaire � Wine-yymmdd.diff.gz). Vous pouvez r�ex�cuter "./configure", et ensuite taper "make depend && make". 5. SETUP Un fois que Wine a �t� construit correctement, vous pouvez tapez "make install"; cela installera l'ex�cutable wine, les pages man Wine et quelques autres fichiers n�cessaires. N'oubliez pas de d�sinsatller toutes les installations pr�c�dantes de wine. Essayez soit "dpkg -r wine", "rpm -e wine" ou "make uninstall" avant d'installer. Naviguez dans la section Support � http://www.winehq.org/ pour pd'astuces de configuration. En cas d'erreur de chargement de librairie (par exemple "Error while loading shared libraries: libntdll.so"), assurez vous d'ajouter le chemin des librairies � /etc/ld.so.conf et ex�cuter ldconfig en tant que root. 6. EX�CUTER DES PROGRAMMES Lorsque l'on invoque Wine, vous pouvez sp�cifier le chemin entier vers l'ex�cutable ou seulement le nom de fichier. Pour ex�cuter Solitaire par exemple : wine sol (en utilisant le chemin d'acc�s sp�cifi� wine sol.exe dans le fichier "config" pour localiser le fichier) wine c:\\windows\\sol.exe (en utilisant la syntaxe de fichiers DOS) wine /usr/windows/sol.exe (en utilisant la syntaxe de fichiers Unix) wine sol.exe /parametre1 -parametre2 parametre3 (en appelant le programme avec des param�tres) Note: le chemin du fichier sera �galement additionn� au chemin par d�faut lorsque le nom entier est �crit sur la ligne de commande. Wine n'est pas encore complet, ainsi quelque programmes peuvent planter. Selon que vous avez install� correctement winedbg d'apr�s documentation/debugger.sgml, vous entrerez dans le d�bogueur vous permettant d'enqu�ter et de r�soudre le probl�me. Pour plus d'information sur la mani�re de le faire, veuillez lire le fichier documentation/debugging.sgml. Vous devriez sauvegarder tous vos fichier important auquels vous donnez acc�s � Wine ou utiliser une copie sp�ciale pour Wine, puisque dans certain cas des utilisateurs ont rapport� des corruptions de fichiers. Ne PAS �x�cuter l'Explorateur, par exemple, si vous n'avez pas une copie propre, puisque il renomme/corrompt parfois plusieurs r�pertoires. M�me certaines application MS telle Messenger par exemple ne sont pas s�res puisqu'elle peuvent lancer l'Explorateur dans certains cas. Certaines corruptions particuli�res telle (!$!$!$!$.pfr) peut du moins �tre partiellement fix�e en utilisant la m�thode d�crite par http://home.nexgo.de/andi.mohr/download/decorrupt_explorer 7. OPTENIR PLUS D'INFORMATIONS WWW: Baucoup d'informations � propos de Wine sont disponibles sur WineHQ � http://www.winehq.org/ : divers Guides Wine, base de donn�e d'applications, suivit de bogues. C'est probablement le meilleur point de d�part. FAQ: La Foire Aux Questions de Wine est localis�e � : http://www.winehq.org/FAQ Usenet: Vous pouvez parler des probl�mes ou r�solutions en relation avec Wine ou optenir de l'aide sur comp.emulators.ms-windows.wine. Bugs: Rapportez les bogues � Wine Bugzilla � http://bugs.winehq.org SVP cherchez tout d'abord dans la base de donn�e de bugzilla pour contr�ler que le probl�me n'est pas d�j� d�couvert avant de poster un rapport de bogue. Vous pouvez �galement rapporter des rapports de bogue � comp.emulators.ms-windows.wine. SVP lisez le fichier documentation/bugs.sgml pour conna�tre les informations n�cessaires. IRC: L'aide en ligne est disponible sur le cannal #WineHQ sur irc.freenode.net. CVS: L'arbre de d�veloppement actuel de Wine est disponible au travers de CVS. Allez sur http://www.winehq.org/cvs pour plus d'informations Mailing lists: Il existe de multiples mailing lists pour les d�veloppeurs de Wine; repportez-vous � http://www.winehq.org/forums pour de plus amples informations. Si vous ajoutez quelquechose ou fixez un bogue, envoyez un patch (dans le format 'diff -u' ) � la liste de diffusion wine-patches@winehq.org pour son inclusion dans la prochaine version. -- Alexandre Julliard julliard@winehq.org