home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / disks / tools / vdisk / vdisk_fr.doc < prev    next >
Text File  |  1997-06-22  |  18KB  |  372 lines
  1. $VER: vdisk_fr.doc 2.7 (22.6.97)        (C) 1994-1997 par Etienne Vogt
  2.  
  3.  
  4. INTRODUCTION
  5.  
  6.  vdisk.device est un pilote de disque RAM récupérable. Il est né il y a 2 ans
  7. sous la forme d'une version modifiée d'ASDG-RAM (le premier RAM disque récupérable
  8. écrit par Perry S. Kivolowitz). Ces versions (1.3 à 1.12) n'ont jamais été
  9. distribuées.
  10.  A partir de la version 2.0 , il a été entièrement recodé, avec de nombreuses
  11. fonctions nouvelles :
  12.  
  13.  - Jusqu'à 16 unités de taille virtuellement illimitée (512 Mo)
  14.  - Allocation et déallocation dynamique de la mémoire.
  15.  - Supporte tous les systèmes de fichiers AmigaDOS.
  16.  - Résiste aux plus lourds crash systèmes tant que ses propres données ne sont
  17.    pas endommagées.
  18.  - En cas de non récupération, la cause peut être déterminée à l'aide d'une
  19. commande de support.
  20.  
  21.  VDisk requiert AmigaDOS 2.04 ou supérieur (V37). Il a été testé de manière
  22. intensive sur les configurations suivantes :
  23.  
  24.  - A500 68000 ECS , 1 Mo Chip 2 Mo Fast 1.5 Mb fausse fast , WB 3.1
  25.    20 Mo IDE-XT + 170 Mo SCSI HDs
  26.  - A3000 68030 ECS, 2 Mo Chip 8 Mo Fast , WB 2.04 -> 3.1
  27.    100 Mo + 1 Go SCSI HDs
  28.  - A500 68040(PP&S) ECS , 1 Mo Chip 2 Mo Fast16 8 Mo Fast32 , WB 2.04
  29.    50 Mo SCSI HD
  30.  - A4000 68040 AGA, 2 Mo Chip 8 Mo Fast , WB 3.0
  31.    120 Mo + 500 Mo IDE HDs
  32.  - A4000 68040 AGA, 2 Mb Chip 8 Mb Fast , WB 3.0
  33.    250 Mo IDE HD + 1Go SCSI-II HDs
  34.  - A1200 68EC020 AGA, 2 Mb Chip 5 Mb Fast , WB 3.0
  35.    60 Mo IDE HD + 100 Mo SCSI HDs
  36.  - A4000T 68060(Phase5) AGA, 2 Mb Chip 8 Mb Fast , WB 3.1
  37.    1Gb SCSI-II HD
  38.  
  39.  VDisk est développé independamment de StatRam (un autre ram disque basé sur
  40. ASDG-RAM, ecrit par Richard Waspe et Nicola Salmoria)
  41.  
  42.  
  43. DISTRIBUTION
  44.  
  45.  VDisk est un logiciel sous Copyright librement distribuable (FreeWare).
  46.  Neanmoins certaines restrictions du logiciel ASDG-RAM sont maintenues :
  47.  
  48.  Ce logiciel :
  49.  
  50.  - Ne peut être copié que sous la forme archivée originale, telle qu'il a
  51.    été placé sur le serveur aminet par l'auteur.
  52.  - Ne peut être distribué par aucun revendeur de matériel ou de logiciel.
  53.  - Ne peut être vendu sous quelque forme que ce soit.
  54.  - Doit contenir l'information de Copyright suivante :
  55.  
  56.    vdisk.device, Copyright 1994 by Etienne Vogt.
  57.    Inspired from asdg.vdisk.device, Copyright 1987 by Perry S. Kivolowitz
  58.     (ASDG Incorporated)
  59.  
  60.  Spécifiquement :
  61.  
  62.   Aucun fabriquant ou revendeur de matériel d'expansion Amiga ou de logiciel
  63.  ne peut distribuer ce logiciel de quelque façon que ce soit. Aucun revendeur
  64.  de logiciels domaine public ne peut également le distribuer (vu qu'il n'est
  65.  pas domaine public).
  66.   les seuls moyens de distribution acceptables sont les réseaux, bbs's et
  67.  groupes d'utilisateurs. La distribution DOIT ÊTRE GRATUITE, à l'exception
  68.  du prix du média et d'une somme raisonnable couvrant les frais de port et
  69.  de gestion.
  70.  
  71.   Ce logiciel ne doit plus être placé sur un CD aminet, cela tant que le droit
  72.  à un CD gratuit pour les auteurs ne sera pas rétabli.
  73.  
  74.  
  75. ABSENCE DE GARANTIE
  76.  
  77.   Ce logiciel est fourni "tel quel" sans aucune garantie ni explicite ni
  78.  implicite. En utilisant ce logiciel, vous acceptez tous les risques quant à
  79.  sa qualité ou ses performances.
  80.  
  81.  
  82. INSTALLATION
  83.  
  84.  - Copiez le fichier 'vdisk.device' dans votre répertoire DEVS: Ne modifiez
  85.    pas le nom de ce fichier.
  86.  
  87.  - Copiez les commandes de support CleanRamDisk, DeleteRamDisk, VDStat dans
  88.    votre répertoire C: ou tout autre répertoire accessible par votre chemin
  89.    d'accès standard. Vous pouvez aussi copier les fichiers .info .
  90.  
  91.  - Si vous avez le système 2.1 ou supérieur, copiez le fichier VD0 dans votre
  92.    répertoire DEVS:DOSDrivers . Vous pouvez changer le nom de ce fichier si
  93.    vous le desirez. Vous pouvez également l'éditer afin de changer certains
  94.    paramètres du RAM disque récupérable, comme sa taille maximale (voir plus
  95.    loin).
  96.  
  97.  - Si vous avez le système 2.0 , concatenez le fichier VD0.mountlist avec votre
  98.    fichier DEVS:MountList. Vous pouvez changer le nom de l'en-tête de l'enregis-
  99.    trement de mount si vous le desirez. Vous pouvez également éditer cet enre-
  100.    gistrement pour changer certains paramètres du RAM disque récupérable (voir
  101.    plus loin). Verifiez auparavant que vous n'avez pas dejà un enregistrement
  102.    du même nom dans votre fichier mountlist (particulièrement si vous utilisiez
  103.    l'ancien ASDG-RAM.)
  104.    Ajoutez une commande 'Mount VD0:' à votre fichier S:User-Startup. Si vous
  105.    n'avez qu'un Mo de mémoire ou moins, il est recommandé de placer cette
  106.    commande au début de votre Startup-Sequence pour minimiser les risques
  107.    de non-récupération.
  108.  
  109.  - Si vous en êtes toujours au système 1.x, il serait peut-être temps de penser
  110.    à évoluer...
  111.  
  112.  - Après cela, rebootez votre Amiga. Si tout est correct, une icône nommée
  113.    VD-RAM-00 devrait apparaitre sur votre Workbench.
  114.  
  115.    NOTE : Si vous installez une nouvelle version de vdisk.device, vous *DEVEZ*
  116.       entrer une commande 'DeleteRamDisk' sur chaque unité active avant de
  117.       rebooter le système, ou toute sorte de choses bizarres peuvent se
  118.       produire.
  119.       Voyez les commandes de support plus loin.
  120.  
  121.  
  122. CHANGEMENT DES PARAMETRES DE MOUNT
  123.  
  124.   ATTENTION : La modification d'un paramètre de Mount autre que celles decrites
  125.           ci-dessous entrainera un disfonctionnement du vdisk.device et
  126.           pourra réveiller le GOUROU avec le numéro d'alerte $50000005 !
  127.           Après TOUT changement d'un paramètre d'une unité active, vous
  128.           DEVEZ entrer une commande 'DeleteRamDisk' sur cette unité avant
  129.           de rebooter le système sous peine de comportements imprévisibles.
  130.  
  131.  - Nom de périphérique AmigaDOS : Contrairement à l'asdg-ram d'origine, vous
  132.    pouvez donner le nom que vous voulez au RAM disque récupérable. Vous n'avez
  133.    qu'a changer le nom du fichier de mount (OS 2.1+) ou de l'enregistrement
  134.    mountlist (OS 2.0). Le nom par défaut est VD0 . Il est recommandé d'utiliser
  135.    comme dernier caractère du nom un chiffre égal au numéro d'unité.
  136.  
  137.  - Unit : Ceci est le numéro d'unité. Vous pouvez avoir plusieurs RAM disques
  138.    récupérables en ayant différents fichiers de mount avec différentes valeurs
  139.    de ce paramètre. Les numéros valides sont 0 à 15, pour un total de 16 unités.
  140.  
  141.  - Flags : Ceci sert à spécifier des options. Vous pouvez les combiner en
  142.    ajoutant leurs valeurs respectives (ex. Flags = 3 pour activer le
  143.    nettoyage automatique et la 2ème tentative d'allocation mémoire).
  144.     Une valeur de 1 pour Flags (bit 0 actif) active le nettoyage automatique de
  145.    l'unité correspondante. Ceci signifie que la mémoire utilisée par le RAM
  146.    disque diminue automatiquement lorsque vous effacez des fichiers. Un effet
  147.    secondaire est que vous ne pouvez pas utiliser d'outils comme Disksalv pour
  148.    récupérer les fichiers effacés. Si le nettoyage automatique est désactivé,
  149.    vous devez utiliser la commande CleanRamDisk pour libérer la mémoire après
  150.    avoir effacé des fichiers. Le nettoyage peut néanmoins se produire si le
  151.    système manque de mémoire. Il est recommandé de laisser le nettoyage
  152.    automatique activé.
  153.     Une valeur de 2 (bit 1 actif) active la 2ème tentative d'allocation de
  154.    mémoire. Lorsqu'une allocation mémoire échoue, une 2ème tentative sera
  155.    effectuée avec des conditions moins restrictives (toute mémoire publique
  156.    disponible sera utilisée). Cela n'est utile que si vous avez spécifié des
  157.    conditions particulières d'allocation mémoire dans le champ BufMemType et
  158.    que vous ne souhaitez pas qu'une erreur soit générée si ce type de mémoire
  159.    est épuisée.
  160.  
  161.  - HighCyl : Est utilisé pour spécifier la taille maximale que le RAM disque
  162.    récupérable est autorisé à utiliser. Quand cette limite est atteinte, AmigaDOS
  163.    affiche une requête 'Le volume VD-RAM-00 est plein.'. Notez que contrairement
  164.    à RAD, vdisk.device n'alloue de la mémoire que lorsque des fichiers sont
  165.    stockés dedans.
  166.    Ne donnez pas une valeur trop élévée à ce paramètre ! Si vous manquez de
  167.    mémoire avant d'atteindre la taille maximale, AmigaDOS affichera une requête
  168.    'Volume VD-RAM-00 a une erreur d'écriture...' et l'integrité des fichiers
  169.    sera compromise !!!
  170.    La valeur recommandée pour la taille maximale est un quart du total de
  171.    Fast RAM.
  172.    Le paramètre HighCyl doit être une VALEUR IMPAIRE. HighCyl + 1 représente
  173.    le nombre de 'pistes virtuelles' utilisables par le RAM disque. Une piste
  174.    virtuelle a une taille de 8 Ko (16 secteurs de 512 octets).
  175.    La valeur par défaut de 63 correspond donc à une taille maximale de
  176.    (63 + 1) * 8 = 512 Ko. Pour un disque RAM de 2 Mo, vous specifierez ainsi
  177.    une valeur HighCyl de 255. La valeur maximale théoriquement possible est
  178.    65533 (correspondant à 512 Mo). Souvenez-vous que cette valeur *DOIT*
  179.    être impaire !
  180.  
  181.  - Buffers : Ceci est le nombre de mémoires tampons utilisées par le système
  182.    de fichiers pour accélérer les accès disque. Pour un disque RAM, cela risque
  183.    en fait de le ralentir, donc il vaut mieux ne pas modifier cette valeur.
  184.  
  185.  - BufMemType : Strictement parlant, ce paramètre indique le type de mémoire
  186.    utilisé par le système de fichiers pour ses tampons internes. Pour vdisk,
  187.    cela affecte également le type de mémoire allouée pour stocker les données.
  188.    Vous pouvez combiner differents attributs en ajoutant leurs valeurs
  189.    respectives.
  190.    Une valeur de 1 (MEMF_PUBLIC) spécifie de la mémoire publique (partagée
  191.    et non virtuelle). Ce type de mémoire est toujours utilisé.
  192.    Une valeur de 2 (MEMF_CHIP) correspond à la mémoire chip et n'est pas
  193.    recommandée.
  194.    Une valeur de 4 (MEMF_FAST) correspond à la mémoire fast.
  195.    Une valeur de 256 (MEMF_LOCAL) correspond à de la mémoire située sur
  196.    la carte mère et censée survivre à un reset. Cet attribut peut être
  197.    utile si vdisk perd son contenu après un reboot.
  198.    Une valeur de 512 (MEMF_24BITDMA) correspond à de la mémoire accessible
  199.    avec des adresses 24 bits. Mais cela ne garantit pas nécessairement de
  200.    la mémoire 16 bits.
  201.    Une valeur de 1024 (MEMF_KICK) correspond à de la mémoire accessible lors
  202.    de l'initialisation du système. Cet attribut n'est défini qu'à partir du
  203.    KickStart 3.0
  204.     La valeur par défaut est 5 qui correspond à de la mémoire fast publique.
  205.  
  206.  - DosType : Le type de système de fichiers utilisé. Les valeurs possibles sont :
  207.     0x444f5300 : Old File System (Ancien système de fichiers). Lent et sans
  208.          réelle utilité vu que vdisk.device possède ses propres
  209.          sommes de contrôle.
  210.     0x444f5301 : Fast File System (Système de fichiers rapide). La valeur par
  211.          défaut.
  212.     0x444f5302 : International Old File System (Version internationale de
  213.          l'ancien système de fichiers). OS 2.1 +
  214.     0x444f5303 : International Fast File System (Version internationale du
  215.          système de fichiers rapide). OS 2.1 +
  216.     0x444f5304 : Directory Caching Old File System (Ancien système de fichiers
  217.          avec cache répertoire). OS 3.0 +
  218.     0x444f5305 : Directory Caching Fast File System (Système de fichiers rapide
  219.          avec cache répertoire). OS 3.0 +
  220.    Le mode international peut être utilisé sous AmigaDOS 2.1 et supérieur.
  221.    Le mode cache répertoire n'est pas recommandé car il ralentit les accès au
  222.    disque RAM.
  223.  
  224.  - Activate : Indique à la commande mount de démarrer le périphérique immédia-
  225.    tement lorqu'il est mis à 1. S'il est mis à 0, vous devez ajouter à votre
  226.    Startup une commande qui accède au disque RAM pour le lancer réellement.
  227.  
  228.  
  229. COMMANDES DE SUPPORT
  230.  
  231.  CleanRamDisk :
  232.  
  233.    Cette commande est utilisée pour forcer une unité vdisk à libérer la mémoire
  234.   occupée par des fichiers effacés. Elle n'est généralement pas nécessaire
  235.   lorsque le nettoyage automatique est activé.
  236.    Cette commande peut être utilisée du Workbench (sans ses options). Selectionnez
  237.   l'icône du RAM disque, puis double-cliquez sur l'icône CleanRamDisk.
  238.  
  239.   Usage : CleanRamDisk DEVICE,UNIT/K/N,NOFREECHIP/S,REBUILD/S,FREEBOOT/S
  240.  
  241.   DEVICE : Le nom de périphérique AmigaDOS (ex. VD0: )
  242.   UNIT : Alternative au nom de périphérique AmigaDOS. Ce mot clé permet de
  243.      spécifier le numéro d'unité. (ex. UNIT 0)
  244.   NOFREECHIP : Lorsque BufMemType vaut 1, CleanRamDisk essaie normalement de
  245.            reloger les pistes situées en mémoire Chip vers la mémoire
  246.            Fast. Cette option supprime ce comportement.
  247.   REBUILD : Lorqu'une unité de disque RAM a des erreurs de lecture (généralement
  248.         causées par un logiciel défectueux qui utilise de la mémoire qu'il
  249.         n'a pas allouée), son contenu sera perdu au prochain reboot (qui
  250.         risque alors de se produire rapidement).
  251.         Cette option force un recalcul de toutes les sommes de contrôle
  252.         internes de façon à ce que l'unité soit maintenue en vie après
  253.         réinitialisation. Les données elles-mêmes ne sont pas réparées,
  254.         mais cela permet d'en sauver une grande partie.
  255.   FREEBOOT : Si quelque chose a été ecrit dans les blocs de démarrage du
  256.          disque RAM (normalement inutilisés), la piste 0 reste vérouillée
  257.          en mémoire. Cette option marque les blocs de démarrage comme
  258.          inutilisés, de façon à pouvoir libérer la piste 0.
  259.  
  260.  DeleteRamDisk :
  261.  
  262.    Cette commande efface une unité de disque RAM entièrement (Comme RemRAD
  263.   pour le disque RAD). Toute la mémoire utilisée est libérée et le système
  264.   de fichiers est inhibé (Une icône VD0:BUSY apparait sur le Workbench).
  265.    Cette commande peut être appelée du Workbench. Selectionnez l'icône du
  266.   disque RAM, puis double-cliquez sur l'icône DeleteRamDisk. Une requête vous
  267.   demandera confirmation.
  268.    Vous *DEVEZ* utiliser cette commande lorsque vous changez un paramètre de
  269.   mount d'une unité active. Vous devez également effacer toutes les unités
  270.   active lorsque vous installez une nouvelle version du vdisk.device.
  271.  
  272.   Usage : DeleteRamDisk DEVICE,UNIT/K/N
  273.  
  274.   DEVICE : Le nom de périphérique AmigaDOS (ex. VD0: )
  275.   UNIT : Alternativement, vous pouvez indiquer le numéro d'unité (ex. UNIT 0)
  276.  
  277.  VDStat :
  278.  
  279.    Cette commande est utilisée pour afficher des informations sur une unité
  280.   de disque RAM dont le contenu a été perdu après un reboot. Elle est
  281.   essentiellement prévue pour des tests et n'est pas utilisable du Workbench.
  282.    L'erreur de récupération numéro 2 (Root Structure not found) apparait
  283.   toujours à la mise sous tension.
  284.  
  285.   Usage : VDStat DEVICE,UNIT/K/N,FULL/S
  286.  
  287.   DEVICE : Le nom de périphérique AmigaDOS (ex. VD0: )
  288.   UNIT : Alternativement, vous pouvez indiquer le numéro d'unité (ex. UNIT 0)
  289.   FULL : Cette option affiche davantage d'information. Elle est prévue pour
  290.      les tests de mise au point.
  291.  
  292.   Codes d'erreurs de récupération :
  293.  
  294.   1 (Deleted Unit / Unité effacée) : Cette erreur apparait après reboot lorsqu'
  295.     une unité à été effacée par la commande DeleteRamDisk.
  296.   2 (Root Structure not found / Structure racine non trouvée) : Cette erreur
  297.     apparait toujours à la mise sous tension. Elle peut également se produire
  298.     si quelque chose d'autre (comme RAD) alloue de la mémoire en ordre inverse
  299.     avant le démarrage du vdisk.device. Pour l'éviter, il faut monter une unité
  300.     vdisk avant toute unité ramdrive. D'autres  possibilités sont qu'un programme
  301.     défectueux ait sauvagement ecrasé le haut de la mémoire ou que de la mémoire
  302.     non resistante au reset soit présente (voir les problêmes connus).
  303.     Cette erreur indique la perte de toutes les unités.
  304.   3 (Bad Root Structure Checksum / Somme de contrôle de la structure racine
  305.      incorrecte) : La structure racine a été endommagée par un programme
  306.     défectueux ou un problême de mémoire. Toutes les unités ont été perdues.
  307.   4 (Bad sector checksum / Somme de contrôle secteur incorrecte) : les données
  308.     ont été endommagées par un programme défectueux ou un problême de mémoire.
  309.   5 (Track not found / Piste non trouvée) : Peut se produire si la taille
  310.     maximale a été reglée à une valeur trop élevée, si la mémoire est fortement
  311.     fragmentée, ou si un programme défectueux est parti écrire n'importe où.
  312.   6 (Reallocation Failure / Echec réallocation) : Tout semble correct, mais la
  313.     mémoire n'a pu être réallouée par AllocAbs(). Cela indique un dysfonction-
  314.     nement sérieux et est accompagné d'une alerte jaune numéro $50010003.
  315.     Si vous avez accès à InterNet, envoyez-moi un rapport de bug (adresse à la
  316.     fin du fichier).
  317.   7 (Unit Structure not found / Structure Unité non trouvée) : La structure
  318.     unité a été écrasée par un programme défectueux ou un problême de mémoire.
  319.   8 (Bad Unit Structure Checksum / Somme de contrôle de structure unité incorrecte) :
  320.     La structure unité a endommagée par un programme défectueux ou un problême de
  321.     mémoire.
  322.   9 (Unknown Error / Erreur inconnue) : Comment l'avez-vous obtenue, celle-là ?
  323.  
  324.  
  325. CHANGEMENTS
  326.  
  327.  V 2.4 :    Première version diffusée.
  328.  
  329.  V 2.5 :      - vdisk retente les allocations mémoires qui ont échouées avec
  330.         MEMF_PUBLIC lorsque BufMemType demandait l'allocation d'un type
  331.         de mémoire spécifique. Cela diminue les risques de voir
  332.         apparaitre des erreurs en écriture.
  333.           - Documentation en français incluse suite à de nombreuses demandes.
  334.  
  335.  V 2.6 :      - Le bidouillage permettant une utilisation sure de la mémoire
  336.         en $C00000 a été entièrement réécrit. Il n'y a plus de problême
  337.         de fragmentation.
  338.           - La structure racine est maintenant allouée en MEMF_KICK
  339.         (MEMF_LOCAL pour OS 2). Ceci devrait aider vdisk à survivre
  340.         au reboot sur certains systèmes avec mémoire 32 bit non
  341.         autoconfig.
  342.           - Ajout de l'option AllocRetry aux flags pour spécifier une
  343.         2ème tentative d'allocation mémoire.
  344.           - vdisk autorise maintenant un flush mémoire lorsqu'il essaie
  345.         d'allouer de la mémoire.
  346.  
  347.  V 2.7          - Correction d'un bug stupide qui faisait planter les 68000 quand
  348.         un numéro d'unité impair était utilisé.
  349.  
  350.  
  351. PROBLEMES CONNUS
  352.  
  353.  Il semble que certaines cartes accélératrices ont de la mémoire 32 bit dont
  354. le contenu est perdu après un reset. Ceci cause la perte des fichiers stockés
  355. dans vdisk.
  356.  Si cela se produit, vous pouvez essayer de regler le parametre BufMemType à
  357. 1024 (pour OS 3+) ou à 256 (pour OS 2) pour empêcher vdisk d'utiliser ce
  358. type de mémoire. N'utilisez pas non plus l'option de 2ème tentative d'allocation
  359. mémoire dans les Flags.
  360.  
  361.  
  362. POUR CONTACTER L'AUTEUR
  363.  
  364.   Vous pouvez me contacter par courier electronique à l'adresse internet suivante :
  365.  vogt@mesiob.obspm.fr
  366.  
  367.   Les rapports de bug doivent inclure une description complète de la configuration
  368.  matérielle et logicielle, incluant tout utilitaire tournant en tache de fond.
  369.  
  370.  
  371.                     Etienne Vogt, 22/7/1997
  372.