Le HOWTO dosemu

�dit� par Mike Deisher (deisher@dspsun.eas.asu.edu)

   v0.60pl3, 17 Avril 1995
     _________________________________________________________________

   _Ceci est la traduction fran�aise _

     Traduction : Thomas Parmelan <tom@darshiva.efrei.fr>

   de la "Foire Aux Questions" (FAQ) / document HOWTO pour dosemu. La
   version la plus � jour du document original est disponible dans
   dspsun.eas.asu.edu:/pub/dosemu.
     _________________________________________________________________

1. Introduction

1.1 Qu'est-ce que dosemu?

   D'apr�s le manuel : "dosemu est un programme utilisant certaines
   fonctionnalit�s du noyau Linux et du processeur 80386 afin de faire
   tourner MS-DOS dans une `bo�te DOS'. La bo�te DOS est une combinaison
   d'astuces mat�rielles et logicielles, et est capable :
     * de virtualiser toutes les entr�es/sorties et les instructions de
       contr�le du processeur
     * de supporter la taille de mot et les modes d'adressage du "mode
       r�el" de la famille de processeurs iAPX86, tout en s'ex�cutant
       dans l'environnement du "mode prot�g�"
     * de d�tourner et d'�muler tous les appels syst�me du DOS et du BIOS
       n�cessaires au bon fonctionnement, avec des performances correctes
     * de simuler l'environnement mat�riel que les programmes DOS ont
       l'habitude de contr�ler
     * de fournir des services MS-DOS � travers des services Linux; par
       exemple, dosemu peut fournir un disque virtuel qui est en fait un
       r�pertoire Linux."

1.2 Quelle est la derni�re version de dosemu et o� la trouver?

   La derni�re version est dosemu 0.60. Elle est disponible par ftp sur :

        tsx-11.mit.edu:/pub/linux/ALPHA/dosemu/
        dspsun.eas.asu.edu:/pub/dosemu/

   Cependant, des pr�-versions sont disponibles pour les d�veloppeurs et
   les alpha-testeurs sur :

        tsx-11.mit.edu:/pub/linux/ALPHA/dosemu/Development
        dspsun.eas.asu.edu:/pub/dosemu/Development/

   et ont des noms de la forme pre0.61.*.tgz. Ce code a l'avantage d'�tre
   compatible avec les noyaux Linux les plus r�cents. Il inclut �galement
   de nouvelles fonctionnalit�s Il ne faut cependant pas oublier que ceci
   est du code ALPHA : il peut y avoir des bogues s�rieux et tr�s peu de
   documentation pour les nouvelles fonctionnalit�s.

1.3 Comment suivre le d�veloppement?

   Si vous voulez suivre le d�veloppement de dosemu, souscrivez � la
   liste de distribution linux-msdos-digest. Pour souscrire, il suffit
   d'envoyer un mail � Majordomo@vger.rutgers.edu avec, dans le corps du
   message, la ligne suivante :

    subscribe linux-msdos-digest votre_nom@votre.adresse.email

   Si jamais vous d�sirez vous d�sabonner de la liste, vous pouvez
   envoyer un mail � Majordomo@vger.rutgers.edu avec la commande suivante
   dans le corps de votre message :

    unsubscribe linux-msdos-digest votre_nom@votre.adresse.email

1.4 Quelle est la documentation disponible pour dosemu?

   Le manuel de dosemu (dosemu.texinfo) �crit par Robert Sanders n'a pas
   �t� mis � jour depuis un certain temps, mais il reste encore une bonne
   source d'informations. Il est distribu� avec dosemu.

   Le DANG, ou "_dosemu Novice's Altering Guide_", explique le
   fonctionnement interne de dosemu. Il est �crit pour les aventureux,
   ceux qui veulent modifier eux-m�mes le source. Il est maintenu par
   Alistair MacDonald (am20@unix.york.ac.uk) et est post� r�guli�rement
   dans la liste de distribution MSDOS de Linux Activists.

   La liste EMU (EMUsuccess.txt) est une liste de tous les programmes qui
   ont �t� essay�s avec succ�s sous dosemu. Elle est post�e de temps �
   autres dans la liste de distribution. La derni�re version est
   disponible par ftp dans dspsun.eas.asu.edu:/pub/dosemu.

   Et, bien s�r, il y a le HOWTO dosemu. Mais vous le saviez d�j�,
   n'est-ce pas? Il est post� r�guli�rement dans la liste de distribution
   MSDOS de Linux Activists. La version la plus � jour est disponible
   dans dspsun.eas.asu.edu:/pub/dosemu.

1.5 Comment soumettre des corrections ou additions � ce HOWTO?

   La meilleure m�thode est d'�diter le fichier dosemu-HOWTO-xx.x.sgml
   afin d'y incorporer les changements, de cr�er un fichier diff comme
   ceci

                diff fichier-original nouveau-fichier

   et de l'envoyer � deisher@dspsun.eas.asu.edu. Ce n'est pas grave si
   vous ne connaissez pas SGML. Les changements et nouvelles informations
   seront accept�es sous toutes les formes, cr�er un fichier diff rend
   simplement le travail plus facile au coordinateur. :-)

   [ Note : Cette version fran�aise n'est qu'une traduction du document
   original. Addresser les corrections et suggestions d'ordre technique �
   deisher@dspsun.eas.asu.edu; signaler les erreurs de traduction �
   Thomas.Parmelan@darshiva.efrei.fr. ]

1.6 Un petit message de Greg ...

   Sauf mention contraire, les auteurs d�tiennent les copyrights sur les
   HOWTO Linux. Les HOWTO Linux, ou des extraits des HOWTO Linux, peuvent
   �tre reproduits et distribu�s, sur n'importe quel m�dia physique ou
   �lectronique, tant que cette notice de copyright reste pr�sente sur
   toutes les copies. La redistribution commerciale est autoris�e et
   encourag�e ; cependant, l'auteur d�sire �tre mis au courant de telles
   distributions.

   Toute traduction, synth�se ou travail d�riv� d'un HOWTO Linux doit
   �tre couvert par cette notice de copyright. C'est-�-dire que vous
   pouvez r�aliser un travail d�riv� d'un HOWTO Linux, mais que vous ne
   pouvez pas imposer des restrictions suppl�mentaires sur sa
   distribution. Des exceptions � cette r�gle peuvent �tre accord�es dans
   certains cas ; contacter le coordinateur des HOWTO Linux � l'adresse
   donn�e plus bas.

   En bref, nous d�sirons promouvoir la circulation de ces informations
   autant que possible. Cependant, nous d�sirons �galement garder le
   copyright sur ces HOWTOs, et aimerions �tre pr�venus de leur
   redistribution.

   Si vous avez des questions, contactez Greg Hankins, le coordinateur
   des HOWTO LInux, � gregh@cc.gatech.edu.

     NDT: En ce qui concerne les traductions fran�aises, contacter
     Xavier Cazin, le coordinateur fran�ais, � xc@itp.fr.

   .

   Voici le texte original du copyright, pour r�f�rence :

   Unless otherwise stated, Linux HOWTO documents are copyrighted by
   their respective authors. Linux HOWTO documents may be reproduced and
   distributed in whole or in part, in any medium physical or electronic,
   as long as this copyright notice is retained on all copies. Commercial
   redistribution is allowed and encouraged; however, the author would
   like to be notified of any such distributions.

   All translations, derivative works, or aggregate works incorporating
   any Linux HOWTO documents must be covered under this copyright notice.
   That is, you may not produce a derivative work from a HOWTO and impose
   additional restrictions on its distribution. Exceptions to these rules
   may be granted under certain conditions; please contact the Linux
   HOWTO coordinator at the address given below.

   In short, we wish to promote dissemination of this information through
   as many channels as possible. However, we do wish to retain copyright
   on the HOWTO documents, and would like to be notified of any plans to
   redistribute the HOWTOs.

   If you have questions, please contact Greg Hankins, the Linux HOWTO
   coordinator, at gregh@cc.gatech.edu.

2. Compiler et installer dosemu

2.1 O� sont les instructions d'installation?

   Les instructions d'installation sont dans le fichier QuickStart
   pr�sent dans la distribution.

2.2 Les 10 Erreurs Stupides les plus courantes � l'installation

   (08/04/95)

    1. Oublier de lire le QuickStart Guide;
    2. Essayer de compiler avec un noyau post�rieur au 1.1.45;
    3. Ne pas avoir les sources du bon noyau dans /usr/src/linux;
    4. Utiliser dosemu avec un noyau n'ayant pas le support pour les IPC;
    5. Compiler avec un gcc ant�rieur � 2.5.8 ou une libc ant�rieure �
       4.5.21;
    6. Oublier d'�diter le fichier /etc/dosemu.conf;
    7. Oublier de lancer "FDISK /mbr" sur son hdimage;
    8. Lancer DOSEMU avec un acc�s partition lorsque ces partitions sont
       d�j� mont�es;
    9. Ne pas compiler dosemu avec suffisamment de privil�ges (root).
   10. Essayer de lancer DOSEMU sur le syst�me multi-utilisateurs d'un
       fournisseur de connectivit� IP.

2.3 Comment cr�er un ex�cutable simple (pas de librairie) ?

   Marty Leisner (leisner@sdsp.mc.xerox.com, 08/04/95

   Si vous voulez un ex�cutable QMAGIC, il faut d�finir STATIC dans le
   Makefile; sinon il y aura une combinaison librairie/ex�cutable.

2.4 Comment cr�er des binaires ELF ?

   Marty Leisner (leisner@sdsp.mc.xerox.com, 08/04/95

   Pour cr�er un binaire ELF, d�finir ELF dans le Makefile. Compiler et
   installer la librairie slang s�par�ment. slang fonctionne tr�s bien en
   librairie ELF partag�e.

2.5 Comment compiler dosemu sur une machine ayant peu de m�moire ?

   Marty Leisner (leisner@sdsp.mc.xerox.com, 08/04/95

   Si vous �tes � court de place dans le swap, vous pouvez ajouter la
   ligne

    CFLAGS+=-fno-inline

   apr�s la d�finition de CFLAGS dans dpmi/Makefile. Attention � bien
   v�rifier que vous avez activ� votre swap: j'ai d�j� exp�riment� des
   plantages quand Linux manque de swap.

2.6 Comment acc�lerer la compilation ?

   Marty Leisner (leisner@sdsp.mc.xerox.com, 08/04/95

   L'optimisation par d�faut est -O2. Il suffit de changer le Makefile
   afin d'utiliser -O (compilation un peu plus rapide, ex�cutable
   l�g�rement plus petit).

2.7 Comment compiler de mani�re non-interactive ?

   En d�finissant do_DEBUG dans le Makefile, vous aurez -Wall -g, une
   compilation non-interactive et sans tex.

2.8 Autres astuces de compilation de Marty ...

   Il faut avoir compil� le noyau sur son propre syst�me pour avoir la
   version courante. Sinon, il faut modifier � la main KERNEL_VERSION
   dans le Makefile racine. Le nombre est de la forme nmmmppp, o� n est
   le num�ro de version, mmm est le num�ro mineur de version, et ppp le
   num�ro de patch. Par exemple, le noyau 1.1.88 correspond � "1001088"
   et le noyau 1.2.1 � "1002001".

   Commencer toutes les compilations � partir du r�pertoire racine des
   sources. Dans ce r�pertoire, "make sous-repertoire" lancera make dans
   sous-repertoire. Chaque r�pertoire poss�de les cibles habituelles
   clean et realclean. clean efface les fichiers objets, realclean efface
   �galement les fichiers de d�pendance et quelques autres fichiers.

2.9 Faut-il compiler dosemu sous l'identit� "root" ?

   08/04/95

   Non. Il faut l'installer sous l'identit� "root", cependant.

   Marty Leisner (leisner@sdsp.mc.xerox.com) ajoute :

   Afin d'acc�der aux ports E/S (y compris la console), dosemu a besoin
   de tourner avec l'identit� "root". Lancer dosemu dans un xterm ou une
   fen�tre X et demander ensuite l'acc�s direct au mat�riel vous permet
   de tourner dosemu sous une identit� utilisateur. Les implications de
   s�curit� / setuid seront �tudi�es dans les versions de d�veloppement.

2.10 Le Makefile est dans une boucle infinie ...

   James B. MacLean (jmaclean@fox.nstn.ns.ca), 12/04/95

   Nous avons quelquefois remarqu� ceci, g�n�ralement lorsque la date
   d'un fichier est importante. Quelques personnes r�solvent le probl�me
   en mettant � jour leur noyau, d'autres (dont moi) en lancant les
   commandes :

        make realclean
        make most

3. Configuration du disque dur

3.1 Comment puis-je utiliser mon disque dur avec dosemu?

   Tout d'abord, montez votre partition DOS sur un r�pertoire Linux. Par
   exemple, on peut cr�er un r�pertoire tel que /dos sous Linux (mkdir -m
   755 /dos) et ajouter une ligne du type :

 /dev/hda1      /dos    msdos   umask=022

   � /etc/fstab. (Dans cet exemple, le disque DOS est mont� en lecture
   seule. Il est possible de le monter en lecture et �criture en
   rempla�ant "022" par "000", et en utilisant l'option -m 777 avec
   mkdir). Maintenant, mount /dos. Vous pouvez ensuite ajouter une ligne

 lredir d: linux\fs/dos

   au fichier AUTOEXEC.BAT de votre hdimage (voir plus bas les
   commentaires au sujet de LREDIR). Sur un syst�me multi-utilisateurs,
   on peut utiliser :

 lredir d: linux\fs\${home}

   o� _home_ est le nom d'une variable d'environnement contenant
   l'emplacement du r�pertoire dos (/dos dans cet exemple).

   ---------------------

   Tim Bird (Tim_R_Bird@Novell.COM) explique qu'il faut faire attention
   lorsque l'on utilise LREDIR dans l'autoexec.bat, car COMMAND.COM
   continue � lire dans l'autoexec.bat du disque redirig� � partir de
   l'endroit o� il en �tait rest� dans l'autoexec.bat du disque physique.
   Pour cette raison, il est plus s�r d'utiliser le m�me autoexec.bat
   pour les deux disques.

   ---------------------

   Robert D. Warren (rw11258@xx.acs.appstate.edu) expliquait le
   28/04/94 :

   Je boote � partir d'un fichier hdimage de moins d'1 Mo, et la derni�re
   ligne de mon config.sys dans le hdimage est :

        install=c:\lredir.exe LINUX\FS\home/dos

   Ceci ex�cute lredir juste avant de lancer l'interpr�teur de commandes.
   J'ai utilis� cela avec succ�s avec COMMAND.COM et 4DOS. Cela �limine
   le probl�me de l'offset li� � l'utilisation de lredir dans
   l'AUTOEXEC.BAT.

3.2 Puis-je utiliser un disque compress� avec stacker/double-space/super-store?

   Pour le moment, il n'est pas possible d'acc�der aux disques compress�s
   � partir des redirigeurs (lredir ou emufs). Cependant, de nombreuses
   personnes ont utilis� avec succ�s la technique consistant �
   d�commenter la ligne

 disk { wholedisk "dev/hda" } # 1ere partition du 1er disque

   du fichier de configuration de dosemu. D'autres utilisent la ligne

 disk { partition "dev/hda1" }

   Si votre partition DOS est d�j� mont�e et accessible en �criture
   lorsque vous lancez dosemu avec l'acc�s partition ou l'acc�s disque,
   dosemu affiche un message d'avertissement et ne se lance pas. Ceci
   �vite DOS et Linux d'�crire ind�pendamment l'un de l'autre sur votre
   disque, et de rendre votre partition DOS inutilisable (tout au moins
   les fichiers qui y r�sident).

   ---------------------

   Si LILO est install�, la proc�dure ci-dessus ne fonctionnera pas.
   Cependant...

   Thomas Mockridge (thomas@aztec.co.za) (8/5/94):

   Pour d�marrer dosemu avec LILO et Stacker 4.0 j'ai proc�d� de la
   mani�re suivante...

    1. dd le MBR vers un fichier (ou norton utility, etc., les premiers
       512 octets)
    2. D�marrer le DOS (le vrai), faire un fdisk /mbr, rendre la
       partition dos active avec fdisk.
    3. Copier le nouveau MBR vers un fichier.
    4. Remplacer le MBR original.
    5. Copier le second MBR vers /var/lib/dosemu/partition.hda? (suivant
       votre partition dos).
    6. Editer dosemu.conf

                disk {partition "/dev/hda? ?"}

    7. Lancer dosemu et voil�! Plus de LILO.

   ---------------------

   Holger Schemel (q99492@pbhrzx.uni-paderborn.de) expliquait le
   10/02/94 :

   Cela marche parfaitement sous dosemu avec MS-DOS 6.0. Si vous avez des
   probl�mes, il faut �diter le fichier DBLSPACE.INI pour mettre la
   lettre d'unit� de disque qui correspond � votre disque sous dosemu.

   ---------------------

   Darren J Moffat (moffatd@dcs.gla.ac.uk) expliquait le 27/03/94 :

   "...utilisez 6.2 si vous pouvez !! Assurez-vous d'avoir sous la main
   une disquette de boot avec LILO, car le DOS 6.2 change le MBR du
   disque de d�marrage."

4. Ports s�ries, parall�les et souris

4.1 O� sont les pilotes pour les souris (compatibles microsoft)?

   Tom Kimball (tk@pssparc2.oc.com) expliquait le 24/11/93 :

   De nombreuses personnes utilisent un autre pilote de souris. En voici
   quelques uns qui semblent fonctionner correctement :

 oak.oakland.edu:/pub/msdos/mouse/mouse701.zip (mscmouse)
 oak.oakland.edu:/pub/msdos/mouse/gmous102.zip (gmouse)

4.2 Pourquoi le pilote de ma souris ne fonctionne-t-il pas?

   Mark Rejhon (mdrejhon@magi.com), 07/04/95

   Si le pilote de souris "plante" lorsque vous le lancez (cela peut
   prendre de 30 � 60 secondes), et si vous attendez plus d'une minute
   avant qu'il soit charg�, essayer de pr�ciser sur la ligne de commande
   du pilote de souris, le port COM sur lequel votre souris est branch�e.

4.3 Pourquoi dosemu rend-il COM4 inaccessible?

   Rob Janssen (rob@pe1chl.ampr.org) expliquait le 24/03/94 :

   D'apr�s jmorriso@bogomips.ee.ubc.ca, "dosemu rend encore inaccessible
   le port COM4 (0x2e8, IRQ 5). 0x2e8 n'est pas list� dans ports{} dans
   la configuration. Je suis oblig� de lancer setserial /dev/cua3 irq 5
   lorsque dosemu est termin�."

   Ceci est d� au BIOS de la carte VGA. J'ai trouv� cela en utilisant la
   trace des ports d'E/S et en regardant � quel moment COM4 devenait
   inutilisable.

   Commentez la ligne allowvideoportaccess on dans le fichier de
   configuration et tout devrait rentrer dans l'ordre. Si vous avez des
   probl�mes vid�o, essayez de s�lectionner plus pr�cis�ment les ports
   autoris�s dans le fichier de configuration (par exemple, 40-43).

4.4 Comment utiliser dosemu et un shell � travers une liaison s�rie?

   John Taylor (taylor@pollux.cs.uga.edutt) expliquait le 25/05/94 :

   J'utilise Linux 1.1.13 et j'aimerais signaler une fonctionnalit�
   int�ressante qu'il faudrait, � mon avis, conserver. Avec la version
   52, il est possible d'utiliser le programme screen. � partir de
   screen, on peut invoquer dos -D-a. Le point int�ressant est que les
   commandes de screen fonctionnent encore ! Ainsi avec CTRL-A C il est
   possible d'ajouter un autre shell unix, et de passer de l'un � l'autre
   (DOS / UNIX). Ceci permet d'utiliser facilement dosemu � travers une
   liaison s�rie.

4.5 Comment faire fonctionner les ports parall�les ?

   Dennis Flaherty (dennisf@flaherty.elk.miles.com, 02/03/95

   Le fichier dosemu.conf permet de rediriger les imprimantes vers lpr ou
   vers des fichiers. Si vous d�sirez un acc�s direct au port, commentez
   ces lignes et ajoutez la ligne suivante:

    ports { 0x3b8 0x3b9 0x3ba 0x3bb 0x3bc 0x3bd 0x3be 0x3bf } # lpt0

   pour le port parall�le correspond � la carte moniteur (LPT0), ou les
   lignes

    ports { 0x378 0x379 0x37a 0x37b 0x37c 0x37d 0x37e 0x37f } # lpt1
    ports { 0x278 0x279 0x27a 0x27b 0x27c 0x27d 0x27e 0x27f } # lpt2

   pour LPT1 et LPT1, respectivement.

5. Multi-utilisateurs et sessions non-interactives

5.1 Est-il possible d'utiliser dosemu sur un syst�me multi-utilisateurs?

   Corey Sweeney (corey@amiganet.xnet.com) expliquait le 08/12/93 :

   Si plusieurs personnes doivent utiliser dosemu sur votre machine, il
   faut changer le r�pertoire de votre hdimage. Dans le fichier
   /etc/dosemu.conf, remplacez hdimage par /var/lib/dosemu/hdimage. Ainsi
   les utilisateurs n'ont pas � se soucier de leur r�pertoire courant
   lorsqu'ils lancent dosemu, et il n'est plus n�cessaire de d�placer
   hdimage � chaque installation d'une nouvelle version.

   Si vous faites cela pour un dosemu multi-utilisateurs, positionnez
   /var/lib/dosemu/hdimage en lecture seule pour tout le monde, sauf pour
   l'administrateur de dosemu.

   Notez qu'il est �galement possible d'utiliser la nouvelle
   fonctionnalit� emufs.sys pour monter un r�pertoire public et/ou un
   r�pertoire priv� (un sous-r�pertoire dans le r�pertoire racine de
   chaque utilisateur).

   [Note : Les utilisateurs peuvent aussi cr�er un fichier de
   configuration personnel ~/.dosrc (m�me format que /etc/dosemu.conf)
   pour ex�cuter leur propre version de dos.]

5.2 Comment ex�cuter des commandes DOS de mani�re non-interactive ?

   Dan Newcombe (newcombe@aa.csc.peachnet.edu) reporte (27/01/94) :

   Voici une id�e (non test�e) pour lancer une commande DOS depuis la
   ligne de commande (ou depuis un menu, etc...) sans modifier
   l'�mulateur actuel. [ Votre partition DOS est cens�e �tre d�j� mont�e
   sous Linux. ]

   Supposons que vous vouliez lancer wp60.exe avec le param�tre "wp60
   d:\doc\paper.txt". Il suffirait de lancer quelquechose comme "dosrun
   wp60 d:\doc\paper.txt". dosrun serait un script shell qui a)
   �dite/modifie/recr�e le fichier autoexec.bat sur votre partition DOS,
   et b) lance simplement dosemu (par exemple, "dos -C >/dev/null".
   L'�tape a) consisterait � garder tout ce qui est normalement dans
   votre autoexec.bat et � rajouter � la fin "wp60 d:\doc\paper.txt".

   Il faudrait auparavant modifier le config.sys situ� sur votre hdimage
   afin que dosemu utilise emufs pour acc�der � la partition DOS comme
   D:, positionner COMPSEC=D:\ (Je pense. Je n'ai pas de manuel DOS sous
   la main), et shell=c:\command.com /p.

   Le principe est le suivant: � chaque fois que vous lancerez
   l'�mulateur DOS, il recr�era un autoexec.bat sp�cifique � cette
   session. Ce qui le rend sp�cifique est cette derni�re ligne qui
   ex�cute le programme que vous voulez utiliser. Les modifications du
   hdimage sont n�cessaire pour indiquer � l'�mulateur et au DOS que vous
   voulez utiliser et booter depuis D:, qui sera en fait la vraie
   partition DOS.

   Si vous n'utilisez pas hdimage et acc�dez au syst�me de fichiers DOS
   directement au d�marrage de dosemu, alors ceci fonctionnera, et vous
   n'avez pas � vous soucier de la partie concernant le hdimage.

   ---------------------

   Daniel T. Schwager (danny@dragon.s.bawue.de) rapporte (02/07/94) :

   Vous pouvez utiliser plusieurs dosemu.conf (et plusieurs images de
   boot avec plusieurs autoexec.bat) en lan�ant dosemu comme ceci :

$ dos -F my_quicken_q_exe_dosemu.conf

   ---------------------

   Dietmar Braun (braun@math20.mathematik.uni-bielefeld.de) rapporte
   (04/07/94) :

   Cela est facile si l'on utilise le redirigeur de dosemu. Il est
   possible de rediriger une lettre d'unit� DOS vers un chemin linux
   donn� par une variable d'environnement.

   Ainsi, j'ai un script shell appel� "DOS" qui contient

 mkdir /tmp/dos.$$;
 DOSTMP=/tmp/dos.$$; export DOSTMP

   et un petit truc pour faire fonctionner "echo $* >
   $DOSTMP/startup.bat" (en fait, un petit programme C qui convertit '/'
   en '\', termine les lignes correctement pour DOS (CR/LF) et ajoute ^Z
   � la fin du fichier), cr�e les fichiers de d�marrage et les liens dans
   ce r�pertoire, et lance dosemu. Dans l'autoexec.bat, l'unit� C: est
   redirig�e depuis le hdimage vers ce r�pertoire temporaire, qui
   contient des liens pour $HOME et $PWD.

   Ainsi, si je veux voir mes fichiers r�duits en 8.3 je tape "DOS dir".
   Comme cela, j'ai un DOS multi-utilisateurs (je n'ai pas de partition
   DOS, et rediriger vers Linux pr�serve les permissions utilisateur) et
   multi-t�ches (les sessions dosemu sont compl�tement ind�pendantes).
   J'ai fait cela un jour pour utiliser un programme DOS pour mon
   imprimante. En fait, l'entr�e df de mon printcap est un r�alit� un
   programme DOS !

6. dosemu and Netware

6.1 Comment acc�der � Netware depuis dosemu?

   James B. MacLean (jmaclean@fox.nstn.ns.ca) expliquait le 28/11/94 :

   dosemu supporte maintenant pdipx (un pilote de paquets IPX) et pdether
   (qui utilise les sp�cifications MLID de Novell) pour acc�der � un
   r�seau Novell � travers le pilote de paquets int�gr�. Ce pilote
   utilise l'interruption 0x60, et respecte les r�gles du pilote normal.
   Cela �tant dit, n'essayez pas encore d'utiliser des outils TCP/IP DOS.
   Pour utiliser Netware, il faut :
    1. cd ./net
    2. cp libpacket.c.single libpacket.c
    3. cp pktnew.c.single pktnew.c
    4. recompiler dosemu
    5. lancer dosemu
    6. lancer pdether comme expliqu� dans sa documentation (pdipx est une
       autre possibilit�)
    7. Lancer netx.
    8. Utiliser l'acc�s Netware :-)

   Si vous avez besoin d'un acc�s sp�cial � votre NIC, lisez
   attentivement ce qui suit. Par d�faut, dosemu ne re�oit pas
   d'interruptions du noyau. Ceci dit, j'ai un pilote (Silly Interrupt
   Generator), � compiler dans le noyau, que dosemu ou d'autres
   programmes peuvent utiliser pour acc�der � l'interruption
   correspondant � votre NIC. Je l'ai utilis� avec dosemu pour acc�der �
   un r�seau Novell Lite lorsque le pilote de paquet n'�tait pas
   disponible.

   Si vous �tes int�ress�s, envoyez-moi un courrier �lectronique
   (jmaclean@fox.nstn.ns.ca) et je vous donnerai des explications.

   Vous voulez plusieurs acc�s � Novell depuis dosemu?
    1. Compiler la pr�-]version courante de dosemu
    2. Suivre les indications de ./v-net/dosnet.README
    3. Reprendre au point 5 ci-dessus.

6.2 Netware-HOWTO

   Le Netware-HOWTO de Lauri Tischler (ltischler@fipower.pp.fi) est
   maintenant un document � part enti�re. Il est inclus dans la
   distribution dosemu et est bien s�r disponible sur les sites archivant
   les HOWTOs, par exemple http://sunsite.unc.edu/mdw/linux.html

     NDT: Pour nous autres francophones, il vaut mieux aller sur
     http://www.loria.fr/linux/.

   .

7. dosemu et X-Window

7.1 Est-il possible d'utiliser dosemu sur une console tout en utilisant X?

   Ronald Schalk (R.Schalk@uci.kun.nl) expliquait le 17/01/94 :

   Oui, sans aucun probl�me. Il suffit de se rappeler qu'il faut utiliser
   Ctrl-Alt-<Fn> pour acc�der � une console virtuelle, et qu'il est alors
   possible de lancer n'importe quelle application Linux (dosemu est une
   application Linux). J'ai quasiment en permanence WP 5.1 dans une
   session dos.

   [Note : Utiliser Ctrl-Alt-F7 pour revenir � X � partir de dosemu.]

7.2 Est-il possible d'utiliser dosemu dans une fen�tre X ?

   Mark Rejhon (mdrejhon@magi.com), 08/04/95

   Si vous avez install� X, avez compil� dosemu, et r�ussissez �
   l'utiliser en dehors de X-Window, il devrait suffire de lancer
   directement "xdos" ou "dos -X" pour obtenir une fen�tre dosemu. Si
   cela ne marche pas, v�rifier que :

    1. dosemu a �t� compil� avec le support X (X_SUPPORT=1 dans le
       Makefile) ;
    2. les fontes VGA ont �t� install�es. Il suffit de lancer le script
       xinstallvgafont dans le r�pertoire source de dosemu :

        sh xinstallvgafont

    3. les codes claviers sont corrects. Dans un xterm, taper:

         xmodmap -e "keycode 22 = 0xff08"
         xmodmap -e "keycode 107 = 0xffff"

       Ces commandes corrigent les touches Backspace et Delete ;
    4. les options relatives � X ont �t� configur�es correctement dans
       /etc/dosemu.conf.

   Une autre m�thode est de lancer dosemu � l'int�rieur d'un color_xterm,
   mais cela n'est pas recommand� car la plupart des color_xterm ne sont
   pas capables de g�rer correctement toutes les ressources complexes
   d'affichage de dosemu. Cette m�thode ne n�cessite pas l'option de
   compilation X_SUPPORT. Si vous voulez vraiment faire comme ceci, voici
   les instructions:

    1. Installer ansi_xterm. Il est disponible sur
       tsx-11.mit.edu:/pub/linux/ALPHA/dosemu/Development/ansi-xterm-R6.t
       ar.gz ;
    2. Installer les fontes VGA. Il suffit de lancer le script
       xinstallvgafont dans le r�pertoire source de dosemu :

        sh xinstallvgafont

    3. Configurer les codes clavier. Dans un xterm, taper:

         xmodmap -e "keycode 22 = 0xff08"
         xmodmap -e "keycode 107 = 0xffff"

       Ces commandes corrigent les touches Backspace et Delete ;
    4. Configuer les options de terminal dans /etc/dosemu.conf

   Marty Leisner (leisner@sdsp.mc.xerox.com), 31/03/95

   J'utilise xrdb pour utiliser les ressources suivantes :

dosxterm*Font:          vga
dosxterm*geometry:      80x25
dosxterm*saveLines:     25

   ou bien je fais un alias dosxterm correspondant �

xterm -fn vga -title dosxterm -geometry 80x25 -sl 25

   Pour utiliser la m�thode xrdb, il suffit de taper :

xterm -name dosxterm

7.3 L'�mulation ansi fonctionne-t-elle correctement ?

   Marty Leisner (leisner@sdsp.mc.xerox.com), 31/03/95

   Oui. J'utilise nnansi.com sous X-Window. Les modes 25, 43 et 50 lignes
   fonctionnent correctement, bien que le mode 50 lignes soit difficile �
   lire sur un �cran 1024x768 (� moins d'utiliser des fontes plus petites
   ou un �cran plus grand). Le mode 43 lignes retaille le xterm pour
   utiliser 43 lignes.

8. dosemu et MS-Windows 3.1

8.1 Est-il possible de lancer MS-Windows 3.1 sous dosemu ?

   D'apr�s le fichier README :

****************************************************************
*    ATTENTION !!!  ATTENTION !!!  ATTENTION!!!  ATTENTION !!! *
*                                                              *
*  Danger ! Ceci n'est pas completement supporte et de         *
*  nombreux bogues connus sont presents ! La plupart des gros  *
*  programmes ne fonctionneront sans doute pas !!!             *
*                                                              *
*  Soyez prets pour des plantages systeme si vous essayez !!!  *
*                                                              *
*    ATTENTION !!!  ATTENTION !!!  ATTENTION!!!  ATTENTION !!! *
****************************************************************

   Bon, vous �tes toujours l� ? Bien. Il est possible de lancer WINOS2
   (la version modifi�e de Windows 3.1 utilis�e par OS/2) sous dosemu.
   F�licitations � Lutz et Dong !

   De nombreux probl�mes sont connus. Windows est enclin aux plantages et
   peut vous faire perdre des donn�es. Les gros programmes ne se chargent
   pas. La souris risque d'�tre tr�s peu maniable, etc. En d'autres
   termes, ceci n'est pas pr�t pour une utilisation normale. De
   nombreuses cartes graphiques posent probl�me (vous pouvez obtenir un
   tr�s bel �cran blanc). Vos groupes de programmes peuvent dispara�tre.
   En un mot, c'est une horreur.

   D'un autre c�t�, si vous mourrez d'envie de voir le logo Windows
   s'afficher sous Linux et que vous avez lu attentivement tout ceci, et
   que vous promettez de ne pas bombarder les d�veloppeurs de dosemu de
   messages du type "MS Word 6.0 ne fonctionne pas !" ...

    1. Prendre les distributions sources de Linux et dosemu ;
    2. D�compresser la distribution dosemu ;
    3. Appliquer le patch dpmi/kernel.diff � vos sources du noyau ;
    4. Recompiler le noyau ;
    5. Compiler dosemu ;
    6. Se procurer WINOS2.ZIP sur tsx-11.mit.edu ;
    7. D�compresser le contenu de WINOS2.ZIP dans votre r�pertoire
       WINDOWS/SYSTEM ;
    8. Red�marrer avec le nouveau noyau ;
    9. Lancer dosemu (apr�s avoir v�rifi� que DPMI est "ON") ;
   10. Croiser les doigts.

   Bonne chance !

   _RAPPEL: CECI N'EST PAS RECOMMAND� ! NOUS NE VOUS CONSEILLONS PAS DE
   FAIRE CECI !!!_

9. Vid�o et son

9.1 Peut-on utiliser les jeux 32-bits sous dosemu ?

   Mark Rejhon (mdrejhon@magi.com), 08/04/95

   Avec les am�liorations concernant le DPMI qui ont �t� int�gr�es � la
   version 0.60, il est maintenant possible de faire tourner quelques
   jeux 32 bits sous dosemu. Si le jeu est compatible avec OS/2, il y a
   de fortes chances pour qu'il fonctionne sous dosemu (exemples de jeux
   32 bits : Descent, Dark Forces, Mortal Kombat 2, Rise of The Triad,
   ont tous �t� test�s avec les versions r�centes de dosemu).

   Avant d'essayer quoi que ce soit, il faut avoir configur� le clavier
   en mode direct

     NDT: _raw mode_

   et autoris� les graphiques VGA dans /etc/dosemu.conf. Si vous avez
   d�j� r�ussi � lancer des programmes graphiques sous dosemu, et que
   vous �tes pr�t � prendre le risque d'un plantage syst�me (puisque vous
   laissez dosemu acc�der directement � la carte vid�o, ce qui peut
   laisser celle-ci dans un �tat instable dont il est difficile de
   ressortir), alors allez-y, lancez votre jeu !

   Attention cependant, il faut d�sactiver le son du jeu. (Il faudra que
   quelqu'un programme une �mulation de carte son pour �viter cela). Le
   jeu sera peut-�tre un peu lent, �tant donn� que Linux est multi-t�ches
   et ne poss�de pas de timer � haute fr�quence. Alors, le jeu peut
   fonctionner de 5 � 100 % de sa vitesse normale. En g�n�ral, il s'agit
   de 50 % pour les versions r�centes de dosemu, et cela devrait
   augmenter.

   Qui sait, cela pourrait m�me fonctionner. N'h�siter pas � envoyer un
   message au coordinateur de EMUsuccess.txt si votre jeu fonctionne
   correctement sous dosemu  !

9.2 En quittant dosemu, j'obtiens un �cran rempli de caract�res bizarres.

   08/04/95

   Le probl�me est que la police de l'�cran texte VGA n'est pas sauv�e.
   Procurez vous le kit svgalib. La version courante est dans

    sunsite.unc.edu:/pub/Linux/libs/graphics/svgalib125.tar.gz

   Ce kit est sans doute �galement disponible sous forme pr�compil�e dans
   votre distribution Linux pr�f�r�e (par exemple, _Slackware_). Utilisez
   savetextmode pour sauver les param�tres du mode courant vers un
   fichier dans /tmp avant de lancer dosemu. En sortant de dosemu, lancez
   textmode pour les restaurer.

9.3 Comment utiliser dosemu avec ma carte vid�o Trident/Actix/etc?

   [L'�cran vacille, affiche le message du BIOS vid�o, puis plus rien.]

   Andrew Tridgell (tridge@nimbus.anu.edu.au) expliquait le 29/01/94 :

   Avec les versions pr�c�dentes, j'ai d�couvert que cela fonctionnait en
   utilisant :

 ports { 0x42 }

   mais quelquefois, ma machine se plantait pendant que le BIOS vid�o
   s'ex�cutait dans dosemu. La raison est que l'on permet au BIOS VGA de
   re-programmer l'horloge, ce qui interagit avec Linux.

   Cela m'a conduit � impl�menter readonly et masking dans dosemu, et je
   crois qu'ils sont toujours dans la derni�re version. Maintenant,
   j'utilise :

 ports { readonly 0x42 }

   et dosemu se lance plus lentement, mais plus s�rement.

   ---------------------

   Tim Shnaider (tims@kcbbs.gen.nz) expliquait aussi le 18/01/94 :

   L'une des solutions pour corriger ce probl�me est d'utiliser le
   programme GETROM afin de copier le BIOS vid�o vers un fichier, et
   d'�diter le fichier de configuration dans le r�pertoire /etc/dosemu.
   Voici la ligne que j'utilise pour la vid�o :

 video { vga console graphics chipset trident memsize 1024 vbios_file
 /etc/dosemu/vbios }

   o� vbios est le fichier g�n�r� par la commande

 getrom > vbios

   ---------------------

   Douglas Gleichman (p86884@tcville.edsg.hac.com) explique (01/09/94)
   que (avec une ATI Graphics Ultra) :

   Pour dosemu 0.52 il faut ajouter cette ligne � dosemu.conf :

 ports { 0x1ce 0x1cf 0x238 0x23b 0x23c 0x23f 0x9ae8 0x9ae9 0x9aee 0x9aef }

   Le programme d'auto-test de la carte indiquera une erreur, mais les
   programmes graphiques fonctionneront correctement.

9.4 Pourquoi les programmes livr�s avec ma carte son ne fonctionnent-ils pas
sous dosemu?

   Hannu Savolainen (hsavolai@cs.Helsinki.FI) expliquait le 21/03/94 :

   dosemu et les programmes DOS s'ex�cutent sous le contr�le d'un syst�me
   d'exploitation en mode prot�g�. Cela signifie que la m�moire n'est pas
   projet�e de la mani�re attendue par le programme. S'il r�ussit, d'une
   mani�re ou d'une autre, � commencer un enregistrement bas� sur la DMA
   de la SB, le son enregistr� n'arrive pas jusqu'� l'application. Il ne
   fait que d�truire des informations quelque part dans la m�moire du
   syst�me.

   James B. MacLean (jmaclean@fox.nstn.ns.ca) explique (19/06/94) :

   D�sol� de vous d�cevoir, mais � l'heure actuelle dosemu ne supporte
   pas directement les interceptions d'interruptions ou DMA g�n�ralement
   n�cessaires � l'utilisation d'une carte son sous dosemu :-(.

   Cela devrait cependant arriver dans un futur proche, cependant :-)

10. Autres mat�riels

10.1 Comment faire fonctionner mon p�riph�rique xxxxx avec dosemu?

   Corey Sweeney (corey@bbs.xnet.com) expliquait le 30/05/94 :

   Voici un compte rendu de mes tentatives pour faire fonctionner des
   p�riph�riques avec dosemu. J'ai r�ussi � faire fonctionner
   correctement mon syst�me de courrier vocal, et mon scanner fonctionne
   � moiti�. Voici ce qu'il faut faire :

    1. Regarder dans le manuel si la carte utilise des ports. Si oui, les
       inclure dans la ligne "ports" du fichier de configuration.
       Attention au fait que, quelquefois, plusieurs ports sont utilis�s
       mais seul le premier est document�.
    2. Essayer. Si cela ne marche pas, ou en l'absence de manuel (ou si
       celui-ci est aussi int�ressant que mon manuel AT&T :), lancer
       dosemu par "dos -D+i 2> /tmp/io.debug". Lancer les logiciels
       d�di�s au p�riph�rique utilis�, et sortir de dosemu. Regarder dans
       /tmp/io.debug tous les num�ros de ports. Essayer de les ajouter au
       fichier de configuration et essayer � nouveau.
    3. Si cela ne marche toujours pas, le p�riph�rique utilise peut-�tre
       des interruptions. Trouver l'interruption en question et installer
       le paquetage SIG.tgz (Silly Interrupt Generator) disponible sur
       tsx-11.mit.edu apr�s avoir lu les instructions.

   Et c'est tout...

   Question : Et si ma carte utilise le DMA?
   R�ponse : Dommage.

11. Probl�mes et solutions

11.1 dosemu s'est plant� et je ne peux plus rien taper

   Daniel Barlow(jo95004@sable.ox.ac.uk), 08/04/95

   Si vous ne pouvez pas vous connecter depuis le r�seau ou sur un autre
   terminal, il y a de fortes chances pour que vous soyez oblig�
   d'appuyer sur le bouton Reset. Si vous r�ussisez tout de m�me �
   obtenir un shell utilisable, lancez "kbd_mode -a" pour sortir le
   clavier du mode direct, et/ou "stty sane" sur la console pour voir ce
   que vous tapez.

   Le plus simple est de se faire un script pour lancer dosemu, qui lance
   automatiquement "kbd_mode -a" juste apr�s dosemu. Quand dosemu se
   plante, le script r�cup�re la main et ex�cute la commande "kbd_mode
   -a".

11.2 J'ai mis de l'EMS dans dosemu.conf, mais cela ne fait rien.

   Rob Janssen (rob@pe1chl.ampr.org) (11/07/94) :

   N'oubliez pasde charger ems.sys depuis le config.sys.

11.3 Comment me d�barasser de tous ces messages "disk change"?

   (11/08/94)

   Installez klogd.

 sunsite.unc.edu:/pub/Linux/system/Daemons/sysklogd1.2.tgz

11.4 Pourquoi dosemu refuse-t-il de se lancer une deuxi�me fois apr�s �tre
revenu en mode console?

   Aldy Hernandez (aldy@sauron.cc.andrews.edu) (7/8/94) :

   Vous devriez d�sactiver le cache de votre carte vid�o et/ou de votre
   BIOS.

11.5 Pourquoi dosemu fonctionne-t-il dans un xterm mais pas sur la console?

   JyiJiin Luo (jjluo@casbah.acns.nwu.edu) expliquait le 19/04/94 :

   J'ai eu exactement le m�me probl�me. J'ai d�couvert que tout le cache
   de la m�moire vid�o devait �tre invalid�. Maintenant, dosemu
   fonctionne parfaitement.

11.6 Comment acc�l�rer dosemu?

   Dans certains cas, il peut �tre utile de jouer avec le param�tre
   HogThreshold dans dosemu.conf.

   Daniel Barlow(jo95004@sable.ox.ac.uk), 08/04/95

   HogThreshold devrait �tre positionn� environ � la moiti� du nombre de
   BogoMips donn� au d�marrage du syt�me.

11.7 Mon lecteur de CD-ROM � quelquefois des probl�mes pour acc�der � certains
fichiers sous dosemu.

   Vinod G Kulkarni (vinod@cse.iitb.ernet.in) expliquait le 07/04/94 :

   Quand un CDROM est mont� depuis Linux et utilis� depuis dosemu
   (lecteur redirig�), il peut y avoir quelques probl�mes. Le pilote de
   CDROM (iso9660) du noyau tente de d�terminer le type de fichier
   (binaire ou texte). S'il ne r�ussit pas, il essaye de d�terminer ce
   type en utilisant une m�thode heuristique. Cette m�thode �choue dans
   certains cas, g�n�ralement quand un fichier texte est trait� comme un
   fichier binaire (je ne sais pas si c'est un bogue ou une
   fonctionnalit�).

   Quoi qu'il en soit, il en r�sulte que la copie d'une tel fichier
   depuis le CDROM (depuis Linux lui-m�me, et pas n�cessairement depuis
   dosemu) g�n�re un fichier cible g�n�ralement plus gros que le fichier
   source. (Des espaces sont ajout�s avant ^J,^M.) C'est pourquoi un
   programme tournant sous dosemu produit des messages d'erreurs ou se
   plante, ce qui peut �tre pris, � tort ("t"), pour un probl�me de
   dosemu.

   Rob Janssen (pe1chl@rabo.nl) (10/08/94) :

   La solution � ce probl�me est de d�sactiver la conversion. Utiliser
   l'option "-o conv=binary" � la commande mount pour le CDROM, ou la
   sp�cifier dans /etc/fstab :

/dev/cdrom /cdrom iso9660 conv=binary,ro

   Aucune modification du noyau n'est n�cessaire.

11.8 Comment obtenir des informations de d�boguage?

   Daniel Barlow(jo95004@sable.ox.ac.uk), 08/04/95

   En ce qui concerne dosemu0.60, les informations de d�boguage sont
   stock�s dans un fichier pr�cis� en argument sur la ligne de commande.
   Utiliser "dos -D+a -o /tmp/debug" pour stocker tous les informations
   de d�boguage dans /tmp/debug. Il ne devrait plus y avoir besoin de
   rediriger stderr.

11.9 Pourquoi les caract�res que j'entre au clavier sont-ils affich�s ddeeuuxx
fois?

   Nick Holloway (alfie@dcs.warwick.ac.uk) expliquait le 22/02/94 :

   Apr�s avoir lanc� dos et apr�s avoir chang� quelques param�tres avec
   stty, j'avais des caract�res en double. Je peux maintenant en
   expliquer la raison !

   Cela arrive uniquement lorsque dos est lanc� sur la console avec
   istrip positionn�. Je pense que l'explication est que les codes
   clavier bruts sont modifi�s par istrip, de telle mani�re que les
   �v�nement "rel�chement d'une touche" sont vus comme des �v�nements
   "appui sur une touche".

   Donc, il faut que istrip ne soit pas positionn� pour utiliser les
   codes claviers sur une console (ce ne serait pas une bonne id�e pour
   les lignes tty).

12. Si vous voulez participer au projet dosemu

12.1 Qui est le coordinateur de dosemu?

   (3/18/94)

   dosemu a �t� con�u d'apr�s le travail de Matthias Lautner et Robert
   Sanders. James B. MacLean (jmaclean@fox.nstn.ns.ca) est le
   coordinateur pour les prochaines versions de dosemu.

12.2 Historique de dosemu

   Version   Date              Personne
   0.1       3 Septembre 1992  Matthias Lautner
   0.2       13 Septembre 1992 Matthias Lautner
   0.3       ???               Matthias Lautner
   0.4       26 Novembre 1992  Matthias Lautner
   0.47      27 Janvier 1993   Robert Sanders
   0.47.7    5 F�vrier 1993    Robert Sanders
   0.48      16 F�vrier 1993   Robert Sanders
   0.48pl1   18 F�vrier 1993   Robert Sanders
   0.49      20 Mai 1993       Robert Sanders
   0.49pl2   18 Novembre 1993  James MacLean
   0.49pl3   30 Novembre 1993  James MacLean
   0.49pl3.3 3 D�cembre 1993   James MacLean
   0.50      4 Mars 1994       James MacLean
   0.50pl1   18 Mars 1994      James MacLean
   0.52      16 Juin 1994      James MacLean
   0.60      9 Avril 1995      James MacLean

12.3 J'aimerais participer. Qui dois-je contacter?

   Le projet dosemu est un travail d'�quipe. Si vous souhaitez y
   participer, lisez le DPR (dosemu Project Registry). Il est disponible
   par ftp dans dspsun.eas.asu.edu:/pub/dosemu.