[Kos-cvs] kos INSTALL,1.9,1.10 ChangeLog,1.54,1.55

thomas at kos.enix.org thomas at kos.enix.org
Thu Jan 6 23:09:37 CET 2005


Update of /home/kos/cvs/kos
In directory the-doors:/tmp/cvs-serv27917

Modified Files:
	INSTALL ChangeLog 
Log Message:
2005-01-06  Thomas Petazzoni  <thomas at crazy.kos.nx>

        * INSTALL: Contents removed and replaced by a link to the PS/PDF
        testingen/testingfr documentation.



Index: INSTALL
===================================================================
RCS file: /home/kos/cvs/kos/INSTALL,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- INSTALL	14 Apr 2002 17:56:45 -0000	1.9
+++ INSTALL	6 Jan 2005 22:09:35 -0000	1.10
@@ -5,602 +5,16 @@
                              INSTALLATION
 
 
-1 Téléchargement des sources
-
-   KOS  est distribué sous les termes de la license GPL, ses sources sont
-   donc librement disponibles sur Internet.
-
-1.1 Snapshots
-
-   Pour  ceux  qui  ne  souhaitent  pas  utiliser  CVS,  nous  mettons  à
-   disposition sur notre site :
-     * des snapshots des sources, à compiler soi-même ;
-     * une  image  de  disquette  1.44M  et  de disque dur 10M sous forme
-       compressée   (gz  ou  zip),  pour  tester  directement  sans  rien
-       installer/compiler.
-
-   Ces  snapshots  sont  mis  à  jour  quotidiennement  et réflètent donc
-   l'avancée du développement de KOS .
-
-   Si  vous  avez  récupéré  directement les images de la disquette et du
-   disque  dur, vous pouvez directement passer aux sections concernant le
-   test de KOS .
-
-1.2 CVS
-
-   Si  vous  souhaitez  disposer des dernières modifications, vous pouvez
-   utiliser CVS. Un client CVS est disponible en standard dans toute
-   bonne distribution Linux, et des clients existent sous Windows.
-
-   Une fois CVS correctement installé, vous pouvez l'utiliser :
-
-cvs -d :pserver:anonymous at kos.enix.org:/var/cvs/kos login
-
-   Le mot de passe est vide, appuyez simplement sur Entrée.
-
-cvs -z3 -d :pserver:anonymous at kos.enix.org:/var/cvs/kos co kos kos-sys
-
-   Cette  commande  permet  de  récupérer  les  sources  de  KOS  qui  se
-   trouveront  dans  les  sous-répertoires kos/ et kos/sys/ du répertoire
-   courant.  N'utilisez  cette commande que pour récupérer les sources la
-   première fois ! Pour mettre à jour ces sources, utilisez simplement :
-
-cd kos ; cvs update -dP
-cd kos-sys ; cvs update -dP
-
-
-2 Compilation de KOS sous Unix (Linux, *BSD...)
-
-2.1 Prérequis
-
-   Pour compiler KOS vous avez besoin de :
-
-    1. Environnement Unix (sh, sed, mkdir, dd ...),
-    2. GNU Make 3.77 ou plus récent,
-    3. Gcc 2.7.2.3 ou plus récent,
-    4. GNU binutils 2.9.1.0.23 ou plus récents,
-    5. Mtools
-    6. GNU Grub 0.5.96 ou plus récent
-
-   Nous  supposerons  ces différents programmes correctement installés et
-   configurés.  Ils  sont  en  général disponibles en standard dans toute
-   bonne  distribution d'Unix libre, mais la section 9 de ce document
-   donnera  une  liste  d'adresses  Internet  indiquant  où l'on peut les
-   télécharger.
-
-   Pour  le  moment,  nous  n'avons  essayé  de  compiler KOS que sur les
-   architectures suivantes :
-
-    1. Linux sur processeur x86
-    2. Solaris sur Sparc, en cross compilation
-
-2.2 Compilation
-
-   Placez-vous   dans  le  répertoire  où  vous  avez  disposé  les  sous
-   répertoires  kos/  et  kos-sys/  (après  utilisation  de CVS, ou après
-   décompression d'un snapshot des sources).
-
-   Tapez alors :
-
-cd kos ; make clean all     # compilation chargeur + noyau
-cd kos-sys ; make clean all # compilation applications utilisateur
-
-  2.2.1 Image de disquette
-
-   Pour  créer une image de disquette (pour tester sur une machine réelle
-   par disquette, ou dans un émulateur), utilisez la commande :
-
-cd kos ; make grub
-
-   L'image de disquette produite est grub/fd.img : elle contient grub, le
-   chargeur  KOS  ,  et  les  modules.  Elle est prête à booter une vraie
-   machine,  ou  à être utilisée sous bochs, plex86 ou VMWare. De la même
-   manière, il est possible de générer l'image de disque dur (10M, FAT) :
-
-cd kos-sys ; make hd
-
-  2.2.2 Image de disque dur de test
-
-   L'application  de  test  kos-sys/apps/test/test  est  destinée  à être
-   placée  sur  un  vrai disque dur (partition FAT d'un disque IDE) à cet
-   emplacement  : /bin/init/test. Cependant, il est possible de fabriquer
-   une image de disque dur pour tester sous bochs par exemple :
-
-cd kos-sys ; make hd
-
-
-3 Compilation sous Windows
-
-3.1 Prérequis
-
-   Il  est théoriquement possible de compiler KOS sous Windows, mais pour
-   celà vous devez disposer de programmes non disponibles en standard :
-
-    1. Cygwin32, version 1.1.1 ou plus récente
-    2. Rawrite (DOS)
-    3. Un  compilateur  générant  des  fichiers ELF reposant sur Binutils
-       2.9.1.0.23 ou plus récent, par exemple celui de RTEMS.
-
-   Tout   d'abord,   installez   Cygwin,   en  suivant  les  instructions
-   disponibles  dans le README sur serveur FTP de Cygwin. Ensuite, lancez
-   Cygwin, en utilisant le fichier cygnus.bat suivant :
-
- at echo off
-set make_mode=unix
-set path=c:\windows\cygnus\cygwin-1.1\bin;%PATH%
-bash
-
-   Ensuite,  installez  le  compilateur  ELF  via  la  commande suivante,
-   exécutée à la racine du système Cygwin (cd /) :
-
-tar xvzf cygwin-elf.tar.gz
-
-   Remarque  :  sous  Cygwin, la racine (``/'') correspond à l'endroit où
-   vous  avez  installé  Cygwin. Pour accéder aux lecteurs ``normaux'' de
-   Windows,  il  suffit  de  faire  ``cd  //c''  pour  accéder  à  C:. Ce
-   comportement  peut  être  modifié en utilisant la commande mount ou en
-   éditant la base de registre.
-
-3.2 Compilation
-
-   La  méthode  pour  compiler  KOS sous Windows est assez semblable à la
-   méthode pour compiler KOS sous Unix.
-
-   Il  faudra d'abord compiler le chargeur et les modules, via make clean
-   all.
-
-   Ensuite,  on  pourra  créer une image de disquette Grub en copiant les
-   modules  et le chargeur sur une disquette avec un Grub préinstallé. En
-   effet, Grub n'est pas utilisable sous Windows, il faut alors ruser.
-
-   La  solution  la  plus  simple pour crééer une image de disquette sous
-   Windows,  est  de  télécharger  depuis  le  site  de  KOS une image de
-   disquette,  que l'on copiera sur une disquette à l'aide de rawrite, ou
-   a  laquelle  on  accedera  en  utilisant  les  mtools (URL en annexe),
-   disponibles sous Windows.
-
-   Il  suffira  alors  de  copier  les  modules  et le loader fraîchement
-   compilés  sur la disquette directement avec Windows, ou sur l'image de
-   disquette  en utilisant les mtools, à l'emplacement prévu à cet effet.
-   Vous  pourrez  aussi personnaliser le fichier menu.lst de la disquette
-   pour ne charger que certains modules, ou pour ajouter vos modules.
-
-   Vous devrez également créer un répertoire C:/bin/init/ (partition FAT)
-   et y placer kos-sys/apps/test/test.
-
-   Si  vous  avez utilisé une disquette, celle-ci est prête à être testée
-   sur  une  machine  réelle.  Si vous avez utilisé l'image de disquette,
-   alors  celle-ci est prête pour être bootée dans un émulateur, Bochs ou
-   VMWare par exemple.
-
-
-4 Tester sur une machine réelle
-
-   KOS  est un système d'exploitation complet, on peut donc le tester sur
-   une machine réelle.
-
-4.1 Avec une disquette
-
-   Vous  devez  disposer  d'une  disquette  1.44  Mo  soit  après l'avoir
-   compilée  vous-même,  soit  après  l'avoir  récupérée  sur la page des
-   snapshots.
-
-   Il  faudra  transférer  l'image  de  cette  disquette  sur  une  vraie
-   disquette avec la commande suivante :
-
-dd if=kos/grub/fd.img of=/dev/fd0 bs=18k conv=sync
-
-   Enfin,  il  vous  faudra  transférer l'application test de kos-sys que
-   vous  aurez compilée vous-même ou récupérée sur la page des snapshosts
-   de  KOS  ,  vers  C:/bin/init/test  (partition  FAT  d'un  disque  IDE
-   obligatoirement).
-
-   Il ne vous reste alors plus qu'à rebooter sur la disquette pour tester
-   KOS  et l'application de test. Au boot de grub, changez éventuellement
-   l'emplacement  de  la partition où se trouve le programme de test (par
-   défaut : hda0) en modifiant la valeur du paramètre passé au noyau :
-wolfgang:root="/dev/part/hda0"
-
-4.2 Par réseau
-
-   KOS  utilise  le  bootloader  Grub. Avec les versions récentes de Grub
-   (0.90.x),   il  est  possible  de  charger  les  éléments  du  système
-   d'exploitation  (chargeur,  modules)  via  le  réseau. Typiquement, on
-   dispose  d'une  machine de test, et d'une machine serveur, reliées par
-   une connexion Ethernet.
-
-   Nous  n'avons  pas  testé  le  boot  par réseau avec des machines sous
-   Windows.  Si des serveurs bootp et tftp existent sous DOS/win32, alors
-   les manipulations suivantes sont valables.
-
-   Dans  la  suite,  nous  indiquons  la marche à suivre en environnement
-   Unix.  Cette  étape  remplace  l'étape  de création de la disquette de
-   boot :   il   vous   faut   quand  même  transférer  le  programme  de
-   kos-sys/apps/test/test   vers  C:/bin/init/test  (partition  FAT  d'un
-   disque IDE obligatoirement).
-
-  4.2.1 Configuration de la machine serveur
-
-   Sur la machine serveur, vous devez disposer d'un serveur bootp et d'un
-   serveur  tftp.  Reportez vous à la documentation de votre distribution
-   pour savoir comment installer ces deux serveurs.
-
-   Vous  devrez  ensuite  éditer  le  fichier  inetd.conf  et rajouter ou
-   modifier les deux lignes suivantes :
-
-bootps  dgram  udp  wait  root  /usr/sbin/bootpd \
- bootpd -i -t 120
-
-tftp  dgram  udp wait.1000 nobody /usr/sbin/tcpd \
- /usr/sbin/in.tftpd tftpd -s /home/kos/src/kos
-
-   Où /home/kos/src/kos est le chemin où se trouvent les sources de KOS .
-
-   Bootp  sert à affecter une adresse IP à la machine cliente (machine de
-   test),  et  Tftp  sert  à  transférer  les  fichiers.  Pour  que Bootp
-   reconnaisse  votre  machine  cliente,  il  faut  créer  (ou éditer) le
-   fichier /etc/bootpab de la manière suivante :
-
-.default:\
-        ht=ethernet:\
-        sm=255.255.255.0:\   # Network Mask du réseau de test
-        gw=192.168.1.1:\     # IP de la passerelle
-        sa=192.168.1.4:\     # IP du serveur Tftp
-        hn:to=3600:\
-        bs=auto:\
-        vm=auto:
-
-test:\                       # Nom de la machine de test
-        ha=0000B4A24D02:\    # Adresse MAC
-        ip=192.168.1.3:\     # Adresse IP
-        tc=.default:
-
-test2:\                      # Nom de la machine de test
-        ha=0000B4A24E5C:\    # Adresse MAC
-        ip=192.168.1.5:\     # Adresse IP
-        tc=.default:
-
-   Remarque :  vous pouvez obtenir l'adresse MAC de la carte réseau de la
-   machine  de  test grâce à la commande ifconfig exécutée sur la machine
-   de test.
-
-   Redémarrez ensuite le démon inetd sur le serveur par la commande :
-
-/etc/init.d/inetd restart
-
-OU
-
-killall -HUP inetd
-
-   Enfin,  pour  pouvoir démarrer KOS , vous devez l'avoir compilé sur la
-   machine serveur. Pour celà, un simple make suffit !
-
-  4.2.2 Configuration de la machine cliente
-
-   Vous   devez   installer   Grub   sur  la  machine  cliente,  afin  de
-   ``télécharger''  les  différents éléments du système depuis la machine
-   serveur.  Pour l'installation de Grub reportez-vous à la documentation
-   de  votre  distribution. En tout cas, sachez que Grub est un EXCELLENT
-   remplaçant  de LILO ! Pour information, nous configurons grub avec une
-   ligne du style :
-./configure --enable-ns8390
-
-   Le résultat est un Grub qui reconnaitra les carte Ethernet NE2000 PCI.
-   (La  commande  ./configure  -help  vous  donnera la liste complète des
-   options disponibles, et notamment des cartes réseau supportées).
-
-   Ajoutez  alors  simplement  les  lignes  suivantes  dans le fichier de
-   configuration de Grub, typiquement /boot/grub/menu.lst :
-
-title KOS
-bootp
-kernel (nd)/home/kos/src/kos/loader/loader.img wolfgang:root="/dev/part/hda0"
-module (nd)/home/kos/src/kos/grub/kos.a.gz
-
-   Le chemin /home/kos/src/kos correspond à l'emplacement des sources sur
-   la  machine  serveur,  et  à  au  chemin fourni à tftp dans le fichier
-   /etc/inetd.conf.  wolfgang:root="/dev/part/hda0" indique l'emplacement
-   de la partition IDE sur laquelle se trouve l'application de test.
-
-   Réinstallez  Grub  via la commande grub-install, ou directement via la
-   commande install du shell /sbin/grub.
-
-   À  noter  que  vous pouvez très bien télécharger également le menu.lst
-   par  le  réseau,  ce  qui évite de réecrire sur la disquette ou sur le
-   disque à chaque fois que vous rajoutez un module. Pour cela, il suffit
-   que le /boot/grub/menu.lst de la disquette ou du disque contienne :
-bootp
-default 0
-timeout 0
-
-title menu.lst distant
-configfile (nd)/home/kos/src/kos/menu.lst
-
-
-5 Débugger sur une machine réelle via ligne série
-
-   Cette  possibilité n'est intéressante que dans le cas où on dispose de
-   2  machines :  la machine de test, et la machine de développement. Sur
-   machine  de  développement,  il est possible d'obtenir des messages de
-   debug  plus  importants que ceux disponibles sur l'écran de la machine
-   de  test.  En  effet,  KOS  comprend  un  mini-driver série permettant
-   d'afficher des messages de debug sur une autre machine.
-
-   Pour relier ces machines, vous avez besoin d'un câble Null Modem.
-
-   Pour  activer  le  debugging sur ligne série pour le loader, éditez le
-   fichier  loader/config.h,  et  vérifiez  que  DEBUG_ON_SERIAL est bien
-   définie, et que les constantes DEBUG_SERIAL_PORT et DEBUG_SERIAL_SPEED
-   correspondent à votre configuration.
-
-   Pour activer le debugging sur ligne série pour les modules (et donc le
-   noyau),  éditez  le fichier modules/config.h. Il fonctionne de la meme
-   manière que loader/config.h.
-
-   Remarque :  Il  est possible d'avoir le debugging sur ligne série dans
-   le loader et pas dans le noyau, ou l'inverse. Il n'est pas obligatoire
-   d'avoir les deux simultanément.
-
-   Ensuite,  sur l'autre machine auquelle est reliée le câble, sous Unix,
-   tapez :
-
-stty speed < /dev/ttyS0
-cat /dev/ttyS0
-
-   pour  que  les messages de debug s'affichent. Bien sûr, si votre câble
-   est branché sur COM2, utiliser /dev/ttyS1 !
-
-   Conseil   :   prévoyez   un   terminal  avec  suffisamment  de  lignes
-   d'historique,  car  la  quantité  de  messages  de  debug  est  plutôt
-   importante  (avec  xterm  ou  rxvt  c'est  l'option  -sl qui permet de
-   spécifier le nombre de lignes à conserver).
-
-
-6 Tester dans un émulateur
-
-   Pour tester KOS , nous utilisons la plupart du temps un émulateur, qui
-   évite  d'avoir  à rebooter une machine très fréquemment, surtout si on
-   en  a  qu'une  seule  !  D'autre  part,  l'utilisation  d'un émulateur
-   (surtout  quand il est open source) est vraiment très pratique pour le
-   debugging.
-
-   Nous  utilisons  l'émulateur Bochs, que nous préférons à Plex86. Bochs
-   est  bien  sûr  téléchargeable  sur  Internet,  des  versions binaires
-   existent  pour  Linux  et Windows, et les sources sont disponibles car
-   c'est  un  projet sous licence GPL. Vous pouvez aussi utiliser VMWare,
-   disponible sous Windows et Linux à l'adresse
-   http://www.vmware.com.
-
-6.1 Compilation et installation de Bochs
-
-   Si  vous avez téléchargé une version binaire, vous pouvez passer cette
-   section qui concerne la compilation et l'installation.
-
-   Pour compiler Bochs, c'est assez simple :
-
-./configure --with-x11 \
-            --enable-debugger \
-            --enable-disasm \
-            --enable-port-e9-hack \
-            --disable-control-panel
-make
-
-     * -with-x11  permet de sélectionner X11 comme interface d'affichage.
-       Vous pouvez aussi utiliser -with-win32 pour Windows.
-     * -enable-debugger  -enable-disasm permet d'aactiver le débuggeur et
-       le désassembleur.
-     * -enable-port-e9-hack  permet  d'activer  un  petit hack permettant
-       d'obtenir  des  messages  de  debug  dans  le terminal ayant lancé
-       Bochs. Extremement pratique !
-     * -disable-control-panel  indique qu'on ne doit pas vous demander de
-       personnaliser votre fichier de configuration à chaque lancement de
-       bochs.
-
-   Pour installer Bochs (sous Unix), je vous recommande :
-
-./install-x11-fonts
-ln -s bochs /usr/bin/bochs
-
-6.2 Configuration de Bochs
-
-  6.2.1 Configuration de base
-
-   Bochs  dispose  maintenant d'une interface en mode texte permettant de
-   configurer  la  plupart  des paramètres importants. Toutefois, je vais
-   vous présenter les lignes à modifier par rapport au .bochsrc fourni en
-   standard.
-
-romimage: file=/home/kos/bochs/bios/BIOS-bochs-latest, address=0xf0000
-megs: 8
-vgaromimage: /home/kos/bochs/bios/VGABIOS-elpin-2.40
-floppya: 1_44=/home/kos/src/kos/grub/fd.img, status=inserted
-diskc: file="/home/kos/src/kos-sys/hd10M.img", cyl=306, heads=4, spt=17
-boot: a
-log: bochsout.txt
-
-   Evidemment  n'oubliez  pas  de  personnaliser ces lignes pour qu'elles
-   correspondent à votre configuration.
-
-  6.2.2 Fabrication de votre propre image de disque dur
-
-   Avec  Bochs,  il  est  possible  d'émuler  le  controleur IDE, et donc
-   d'avoir  dans le système qui tourne dans l'émulateur des disques durs.
-   Sur  la  machine  hôte  (sur laquelle tourne l'émulateur), ces disques
-   durs sont des fichiers. Si les images de 10M constituées par défaut ne
-   vous conviennent pas, voilà comment procéder.
-
-   Il  faut  tout  d'abord  décider la taille du disque dur, en termes de
-   nombre  de  cylindres, de nombre de têtes et de nombre de secteurs par
-   pistes.  Quelques  exemples  de  configuration  sont  données  dans le
-   .bochsrc par défaut.
-
-   Pour l'exemple, on utilisera les valeurs :
-
-                          nombre de cylindres      306
-                            nombre de tetes         4
-                      nombre de secteurs par piste 17
-
-   On calcule la taille totale du disque dur :
-
-   taille en secteurs = nombre de cylindres * nombre de tetes * nombre de
-                             secteurs par piste
-
-   Pour  notre  exemple,  on  a  un disque dur de 306*4*17 secteurs, soit
-   20808  secteurs.  Chaque  secteur  faisant  512 octets, notre image de
-   disque doit faire 10653696 octets, soit exactement 10 Mega-octets.
-
-   Pour créer cette image :
-dd if=/dev/zero of=image bs=512 count=20808
-
-   Ensuite,  il  faut  configurer Bochs pour qu'il reconnaisse ce nouveau
-   disque dur en ajoutant la ligne :
-diskc: file=/chemin/complet/image, cyl=306, heads=4, spt=17
-
-   Le  driver IDE de KOS devrait normalement reconnaître la présence d'un
-   disque  dur en Primary Master. Il faut maintenant le partitionner pour
-   pouvoir y créer des systèmes de fichiers, et y placer des fichiers.
-
-   Pour  partitionner un simple fdisk image permettra de créer toutes les
-   partitions  que  l'on  souhaite  dans  l'image.  Attention, seules les
-   partitions FAT seront formatables et accessibles ultérieurement.
-
-   Pour  formater  les  partitions  FAT et y copier des fichiers, il faut
-   utiliser   les   mtools.   Ajoutez   la   ligne   suivante   a   votre
-   /etc/mtools.conf :
-
-drive c: file="/chemin/complet/image" partition=1
-
-   En changeant bien sur le partition=1 par le numéro de la partition FAT
-   à utiliser dans l'image de disque.
-
-   On  peut  ensuite  formater  la  partition  via un mformat c:. On peut
-   ensuite  copier  des  fichiers,  créer  des répertoires, supprimer des
-   fichiers en utilisant respectivement les commandes mcopy, mmd et mdel.
-   Se  réferer  à  la  documentation  de mtools pour l'utilisation de ces
-   commandes.
-
-6.3 Utilisation de Bochs
-
-   Pour  utiliser Bochs à partir des sources de KOS , utilisez simplement
-   la commande :
-
-make bochs
-
-   Ceci  lance  la  compilation  de  kos, génère l'image de disquette, et
-   lance Bochs. Ça ne fonctionnera bien sûr que sous Unix, car make bochs
-   utilise Grub pour crééer une image de disquette.
-
-   Si  vous ne voulez pas tenter de / ou ne pouvez pas (si vous êtes sous
-   Windows  par exemple) tout recompiler avant chaque lancement de Bochs,
-   utiliser simplement la commande :
-
-bochs
-
-6.4 Installation et utilisation de VMWare
-
-   Nous  ne  détaillerons pas la procédure d'installation de VMWare, elle
-   st   complètement  automatisée  par  le  script  vmware-install.pl  se
-   trouvant dans l'archive.
-
-   Nous  ne  détaillerons  pas  non plus la procédure de configuration de
-   VMWare  :  il suffit d'indiquer que le lecteur de disquette correspond
-   au fichier grub/fd.img dans les sources de KOS .
-
-
-7 Débugger dans un émulateur
-
-7.1 Le port-e9-hack de Bochs
-
-   L'option  -enable-port-e9-hack  permet  d'avoir  les messages de debug
-   dans le terminal qui a lancé Bochs.
-
-   Pour  activer l'envoi des messages de debugging pour le loader, éditez
-   le fichier loader/config.h et vérifiez que la constante DEBUG_ON_BOCHS
-   est bien définie.
-
-   Pour  activer  l'envoi  des messages de debugging pour les modules (le
-   noyau), faites de même pour le fichier modules/config.h.
-
-   Remarque :  Il  n'est  pas  obligatoire  d'avoir  le debugging dans le
-   loader  et  dans  les  modules simultanément : toutes les combinaisons
-   sont possibles !
-
-   Ce  petit  hack  très  utile  permet  d'obtenir  une  grande  quantité
-   d'informations,  et  je  vous  conseillerai  donc  d'avoir un terminal
-   conservant  de  nombreuses  lignes  d'historique, comme c'était le cas
-   pour le debugging via ligne série.
-
-7.2 Les sources de Bochs
-
-   Bochs  étant sous licence GPL, ses sources sont disponibles et surtout
-   modifiables.  On  peut  donc  modifier  le  comportement de la machine
-   virtuelle, et obtenir de nombreuses informations sur ce qui se déroule
-   en interne du processeur.
-
-7.3 Le debugger de Bochs
-
-   Bochs  dispose  d'un  debugger  qui  permet de placer des breakpoints,
-   d'éxécuter  pas  à  pas,  etc...  Vous  trouverez  plus d'informations
-   concernant les possibilités du debugger dans la documentation de Bochs
-   (fournie avec les sources).
-
-7.4 Debugging avec VMWare
-
-   Même  si  VMWare  ne  dispose  pas d'un équivalent au port-e9-hack, il
-   permet  de  faire  des  choses intéressantes avec les ports séries. En
-   effet il est possible d'indiquer à l'émulateur si l'on souhaite que le
-   port série de l'OS client corresponde à un fichier, à un port série ou
-   à  un  TTY  sur  l'OS  hote. Ces options sont disponibles pour 4 ports
-   séries.
-
-   On  peut  donc  configurer KOS pour avoir les messages de debug sur la
-   ligne  série,  puis  configurer  VMWare pour qu'il les envoie au choix
-   dans un fichier, sur un TTY, ou sur un port série réel. Le plus simple
-   étant d'envoyer la sortie dans un fichier.
-
-   VMWare ne possède pas de debugger.
-
-                               8 Reporter un bug
-
-   Pour reporter un bug, c'est assez simple : il faut être le plus précis
-   possible. Précisez :
-
-     * Le    système   que   vous   utilisez   pour   compiler   (système
-       d'exploitation, compilateur, avec les numéros de versions...).
-     * Le  système  que  vous  utilisez  pour  tester  KOS . Si c'est sur
-       machine réelle, indiquer le type de processeur, la quantité de RAM
-       et  le  matériel  présent  dans  la  machine. Si c'est avec Bochs,
-       précisez la version.
-     * Indiquez  précisement  quelles sont les conditions d'apparition du
-       bug  (systématique,  aléatoire...),  et quels sont les messages de
-       debug affichés.
-
-   Ces  différentes  informations  nous  sont extremement précieuses pour
-   améliorer  KOS  .  Vous  pouvez  bien  sûr nous aider en proposant vos
-   propres  patchs  corrigeant  les  éventuels  bugs  que  vous auriez pu
-   trouver.
+The installation documentation is now available as a pretty-formatted
+document.
 
-                                9 Diverses URLs
+If you are an english-speaking person, you might want to read :
+ - http://kos.enix.org/~d2/snapshots/kos_current/doc/testingen.pdf
+ - http://kos.enix.org/~d2/snapshots/kos_current/doc/testingen.ps
 
-    1. http://kos.enix.org : Le site officiel du projet KOS .
-    2. http://www.cvshome.org :  Le  site  officiel  de  CVS, où vous
-       trouverez  des  clients  pour  tous  les  systèmes ainsi que de la
-       documentation.
-    3. http://www.gnu.org/software/grub/grub.html :  Le site officiel
-       de  Grub, où vous pourrez télécharger les sources (CVS ou archive)
-       ainsi que de la documentation.
-    4. http://www.gnu.org/software/gcc/gcc.html : Le site officiel de
-       GCC.
-    5. http://www.cygwin.com : Le site officiel de Cygwin.
-    6. ftp://ftp.rtems.com/pub/rtems/releases/4.5.0/c_tools/cygwin/tg
-       z/i386-rtems/ :   Site   FTP   où   vous  pourrez  télécharger  le
-       compilateur ELF pour Cygwin. Ce compilateur est aussi disponible à
-       l'adresse    http://kos.enix.org/~d2/cygwin-elf.tar.gz   (plus
-       léger).
-    7. http://kos.enix.org/~d2/mtools-3.9.6-w32.tar.gz :  Les  mtools
-       pour  Windows,  compilés  assez  peu proprement. Ils permettent de
-       lire/écrire  des  images de disquettes, mais pas de vrais disques.
-       Peu importe car Windows sait le faire !
-    8. http://bochs.sourceforge.net :Le site officiel de Bochs
-    9. http://www.vmware.com : Le site officiel de VMWare
+If you are a french-speaking person, you might want to read :
+ - http://kos.enix.org/~d2/snapshots/kos_current/doc/testingfr.pdf
+ - http://kos.enix.org/~d2/snapshots/kos_current/doc/testingfr.ps
 
+You can also have a look at the "KOS documentation" page on the
+Website, http://kos.enix.org/documentations.php.

Index: ChangeLog
===================================================================
RCS file: /home/kos/cvs/kos/ChangeLog,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -d -r1.54 -r1.55
--- ChangeLog	6 Jan 2005 20:15:57 -0000	1.54
+++ ChangeLog	6 Jan 2005 22:09:35 -0000	1.55
@@ -1,5 +1,8 @@
 2005-01-06  Thomas Petazzoni  <thomas at crazy.kos.nx>
 
+	* INSTALL: Contents removed and replaced by a link to the PS/PDF
+	testingen/testingfr documentation.
+
 	* modules/tty/_vt100.c: VT100 driver is now responsible to move
 	the cursor. Some whitespace cleanup also. Cursor is not working
 	perfectly yet, but you can sometimes see it under Qemu ;-)



More information about the Kos-cvs mailing list