@database "ReadRDB.guide" @remark @remark "$VER: ReadRDB.guide 0.7 (19.11.99) Gérard Cornu @Index INDEX @node main "ReadRDB 0.5 ©1995-96 Gérard Cornu - Sommaire" @{b}ReadRDB 0.7 - Sommaire @{ub} - (19-Nov-99) par @{" Gérard Cornu " link author} @{" Copyright " link copyright} @{" Distribution " link distribution} @{" Besoins " link requirement} @{" Introduction " link introduction} @{" Installation " link installation} @{" Utiliser ReadRDB " link using} @{" Adresse de l'auteur " link author} @{" Restrictions d'usage " link restrictions} @{" Garantie " link warranty} @{" Historique " link history} @{" Index " link index} @endnode @node copyright "ReadRDB copyright and other boring stuff" @prev main @next distribution @{b}ReadRDB@{ub} - version 0.7 19-Nov-99 ©1995 @{" Gérard Cornu " link author} - Compilé avec SAS/C ® 6.58. ReadRDB, ainsi que tous les fichiers d'accompagnement, sont ©1995-99 Gérard Cornu. ReadRDB est basé sur le fichier source @{" Readrdsk.c " link readrdsk}. @endnode @node warranty "NO warranty for ReadRDB" @prev restrictions @next thanks PAS DE GARANTIE ~~~~~~~~~~~~~~~ Ce logiciel n'est accompagné d'aucune garantie. Bien que l'auteur ai essayé d'éviter les erreurs (!), il ne peut garantir que le logiciel décris dans ce document est sûr à 100%. Vous utilisez donc ce logiciel à vos propres risques (et périls!). L'auteur ne peut être tenu respon- sable d'aucun dommage causé par l'utilisation de ce logiciel. @endnode @node distribution "ReadRDB distribution" @prev copyright @next requirement DISTRIBUTION ~~~~~~~~~~~~ Ce logiciel est librement distribuable. Il peut être inclus sur tout support utilisé pour la distribution de logiciels librement distri- buables, comme les collections de disques du Domaine Public, CD-ROMs, serveurs FTP ou BBS. De façon à assurer l'intégrité de ce logiciel, les distributeurs doivent re-distribuer l'ensemble complet des fichiers originaux. L'auteur ne peut être tenu responsable si ce logiciel est devenu inutilisable à cause de modifications survenues au contenu de la distribution ou à des fichiers même de la distribution. Il n'y a pas de limites imposées sur le coût de la distribution, par ex: pour le support, comme les disquettes, bandes magnétiques ou disques compacts, ou le traitement de la duplication. Il s'est avéré que de telles limites allaient â l'encontre de l'idée de logiciels librement distribuables, par ex: plutôt que de réduire le prix du disque en deça de la limite, les logiciels étaient purement et simplement enlevés du disque à distribuer. Bien que l'auteur n'impose aucune limite sur la distribution de ce logiciel, il voudrait exprimer ses opinions personnelles sur le sujet: * Ce logiciel devrait être mis librement et gratuitement à la disposition de quiquonque, chaque fois que cela est possible. * Si vous vous êtes procuré ce logiciel dans des conditions normales, par l'intermédiaire d'un revendeur de Domaine Public, à un prix supérieur à 25 Francs (ou 5 Dollars), vous avez définitivement payé trop cher. S'il vous plait, n'encouragez plus ce moyen inconvenant de faire du profit et changer pour un distributeur meilleur marché, dès que possible. @endnode @node restrictions "Usage restrictions for ReadRDB" @prev author @next warranty RESTRICTIONS D'UTILISATION ~~~~~~~~~~~~~~~~~~~~~~~~~~ Aucun programme, document, fichier de données ou code source faisant partie de ce logiciel, ni en entier ni en partie, ne peut être utilisé sur une machine qui est employée * pour la recherche, le développement, la construction, le test ou la production d'armes ou toute autre application militaire. Ceci comprend également toute machine qui est utilisée dans l'éducation à toutes fins énoncées ci-dessus. * par des personnes qui acceptent, soutiennent ou exercent toute violence à l'encontre d'autre personnes, (par ex. contre des citoyens originaires de pays étrangers). @endnode @node requirement "ReadRDB requirements" @prev distribution Important! ~~~~~~~~~~ ReadRDB a besoin du système 2.04 ou supérieur. Il a été développé et testé sous KickStart 40.68 et WB 44.2. Je ne vois aucune raison pourquoi il ne marcherait pas sur les versions supérieures. Étant donné la nature de cet utilitaire, un ou plusieurs disques durs employant le système du @{" Rigid Disk Block " link rdb} spécifié par Commodore ne seront pas de trop! @endnode @node installation "Installing ReadRDB" @next introduction Installation de ReadRDB: ~~~~~~~~~~~~~~~~~~~~~~~ Cliquez simplement sur l'icône d'installation de votre choix. Ceci suppose que vous avez le programme "Installer" dans un répertoire se trouvant dans votre chemin de commandes (path ;-) Vous préférez une installation manuelle? (tout aussi rapide!), copiez simplement ReadRDB dans un répertoire se trouvant dans votre chemin de commandes. @endnode @node introduction "Introduction to ReadRDB" @prev installation INTRODUCTION @{" (Préambule...) " link preambule} ~~~~~~~~~~~~ ReadRDB vous permet de sauvegarder le @{" Rigid Disk Block " link rdb} d'un disque dur dans un fichier, en tant que copie de sauvegarde, et ensuite de ré-écrire ce RDB sur le disque dur. Une bonne chose à faire, si vous voulez être un peu plus tranquille au sujet de vos disques durs (uniquement!), est de sauvegarder chaque RDB de chacun de vos disques durs sur une ou plusieurs disquettes, ainsi qu'une copie du programme "ReadRDB". Peut-être qu'un jour vous vous remercierez de l'avoir fait. (Cela m'est arrivé plusieurs fois déjà!). Un programme du type virus ou trojan, ou simplement une mauvaise manipulation lors de l'utilisation d'HDToolBox ou autre utilitaire d'installation de disques durs peuvent endommager ou même détruire votre RDB. Si cela se produit et vous n'avez pas de copie de sauvegarde de votre RDB, la seule façon de vous en sortir est de ré-installer le disque dur. Pas très marrant, n'est-ce pas ;-) Lisez tout de même ce petit @{" avertissement " link warning}. @endnode @node preambule "Sur la localisation et tout ce cinéma ;-)" J'ai commencé à "bosser" sur ReadRDB en anglais, comme d'habitude, et je n'ai pas pensé un instant à la localisation. Et maintenant que j'en suis là je n'ai pas envie de faire marche arrière et de localiser ReadRDB. De plus c'est un programme plutôt simple et je suis en train de vous traduire la doc, c'est déjà pas si mal! Vous pouvez remercier Jérôme Chesnot pour m'avoir plus ou moins poussé à traduire la doc en français, si cela n'avait tenu qu'à moi... ;) @endnode @node warning "Warning!" AVERTISSEMENT ~~~~~~~~~~~~~ Faites très ATTENTION lorsque vous utilisez l'option @{" WRITE " link cli} de "READRDB", due à sa fonction, qui est d'écrire un @{" RDB " link rdb} sauvegardé sur un fichier, par dessus celui d'un disque dur, il est possible de rendre un disque dur totalement inutilisable par AmigaDOS. Ceci peut se produire si par exemple vous écrivez le RDB d'un disque dur sur un autre disque dur. Une façon d'éviter ce problème est de nommer vos RDB sauvegardés avec le nom de la marque et du modèle du disque dur concerné. Ne vous laissez tout de même pas impressionner par cet avertissement, si vous utilisez ReadRDB en réfléchissant à ce que vous faites (;-) vous ne devriez pas rencontrer de problème. Qui sait, vous pourrez peut-être le remercier le jour ou vous aurez pu 'restoré' votre RDB si celui de votre disque dur est corrompu ou détruit par quoi que ce soit. J'ai dû le faire plusieurs fois déjà, et je remercie Randell Jesup, l'auteur de @{" Readrdsk.c" link readrdsk}. @endnode @node readrdsk "Readrdsk.c" "Readrdsk.c" est la source d'un petit utilitaire que j'ai trouvé sur Usenet il y a déjà pas mal de temps (début 1991!). ReadRDB est basée sur cette source. Randell Jesup est l'auteur de Readrdsk.c, et a été "Le Gardien d'AmigaDos" chez Commodore Engineering. @endnode @node rdb "Rigid Disk Block" @prev introduction RDB: ~~~ Le RDB, ou Rigid Disk Block, est une spécification élaborée par Commodore, qui définie des blocs de données sur un disque dur, de facon à décrire ce disque. Ces blocs sont crées et modifiés par des utilitaires d'installation de disques durs tels que HDToolBox, et ils sont lus et utilisés par le code de la ROM du pilote de périphérique (device driver). Ces blocs contiennent des informations sur le disque, telles que le nombre et la taille des blocs, le nombre de pistes, de cylindres, la list des blocs endommagés (BadBlockList), des données concernant les partitions, le 'filesystem' et l'initialisation du disque. Ces blocs ne sont pas accessibles normalement par l'utilisateur puisqu'ils n'apparaissent sur aucune unité DOS. Pour plus d'information sur le RDB et les autres 'hardblocks', consultez le "RKRM Libraries", 3ème édition (ISBN 0-201-56774-1), pages 769 à 776. (Ou les pages 538 à 545 de la seconde édition de "RKRM Libraries & Devices"). @endnode @node using "Using ReadRDB" Utilisation de ReadRDB ~~~~~~~~~~~~~~~~~~~~~~ ReadRDB est un utilitaire pour le Shell uniquement. @{" Template " link template} @{" Exemples " link examples} @{" Information supplémentaire " link info} @endnode @node template "The template for ReadRDB" La @{" template " link silly} est la suivante: @{" D=DEVICE/K,U=UNIT/K/N,WRITE/S,FILE,H=HELP/S " link cli} Le prochain paragraphe est seulement pour ceux qui ne lisent pas leur manuel ;-): /K signifie que le mot clé doit être donné avec le paramètre. /N le paramètre est numérique. /S le paramètre fonctionne comme un interrupteur. = le signe égal indique que les deux formes (celle avant et celle après le signe égal!) du mot clé sont équivalentes, et chacune sera acceptée. Le premier paramètre, D ou @{" DEVICE " link cli}, doit être suivi du nom de votre pilote d'unités SCSI (device driver name). Ce paramètre est optionnel, par défaut le nom est "scsi.device". Le second paramètre, U ou @{" UNIT " link cli 10}, doit être suivi du numéro de l'unité SCSI. Ce paramètre est également optionnel, l'unité par défaut est l'unité 6 (six!). Quand au troisième paramètre, @{" WRITE " link cli 17}, il ne doit être employé que si vous voulez remplacer le @{" RDB " link rdb} du disque concerné, par celui sauvegardé dans un fichier. Cet argument est un commutateur optionnel. Par défaut l'action est de lire le RDB et de le sauvegarder dans un fichier. Si vous avez une seconde, lisez ce petit @{" avertissement " link warning}. Le quatrième paramètre, @{" FILE " link cli 24}, doit être suivi du nom du fichier (y compris le chemin, s'il ne s'agit pas du répertoire courant) qui contiendra le @{" RDB " link rdb} de l'unité spécifiée, si l'option @{" WRITE " link cli 17} n'est PAS spécifiée, ou par le nom du fichier contenant le RDB que vous souhaitez écrire par dessus le RDB existant sur le disque si l'option WRITE est également spécifiée. Ce paramètre est optionel si l'option WRITE n'est PAS stipulée, et dans ce cas le nom du fichier par défaut est "T:RDB_nomdudevicescsi_numerodel'unité". D'un autre côté, si l'option WRITE est spécifiée le paramètre FILE est OBLIGATOIRE. Le 5ème paramètre, @{" HELP " link cli 30}, vous donnera quelques indications, en anglais (oeuf course!) sur la manière d'utiliser ReadRDB. Le paramètre FORCE a été supprimé, il ne devrait plus être nécessaire! @endnode @node silly "Pourquoi y veut qu'j'traduise cette doc le Jérôme... ;-)" Vous savez c'qui dit mon dico anglais/français (et dans l'aut'sens!), Le Robert & Collins Senior (!), pour le mot "template"? ....(Computer) patron Quand j'dis qu'il devrait être interdit de traduire les termes anglais informatique.... ;-) @endnode @node cli "Grrrrrrr......." Aller, j'vais êt'sympa, j'vais traduire! DEVICE: unité physique de périphérique (c'est-y pas beau ça ;-) Peut-être, mais ici c'est du pilote du 'device' qu'on parle, c'est à dire le logiciel qui gère ce device, et non pas du 'device' lui-même! Cela peut être par exemple: scsi.device, cybppc.device, gvpscsi.device, hddisk.device, etc... UNIT : unité (elle était dure celle là!!!!) Le @{" numéro de l'unité " link unit} (SCSI Target ID) concernée, qui devrait avoir une valeur de 0 à 6. La valeur 7 étant généralement celle du contrôleur SCSI. WRITE : écrire (bof!) Option à utiliser seulement si vous désirez @{" écraser " link warning} le RDB de l'unité concernée par un RDB préalablement sauvegardé par ReadRDB. FILE : fichier (quand même!) Doit inclure le chemin complet si le fichier ne concerne pas le répertoire courant. HELP : aide (j'vous parle pas ce celle là!) @{" Bon, revenons à nos moutons (ou n'était-ce pas notre 'patron' ;-) " link using} @endnode @node unit "Comment j'sais quelle est le numéro d'unité de mon dur... ;-)" Si vous ne connaissez pas le numéro d'unité de votre disque dur, lancé HDToolBox (NON, pas par la f'nêtre!) et une fois que monsieur aura ouvert la sienne (de f'nêtre!) vous devriez voir quelque chose dans ce style: Hard Drives in System Interface Address LUN ... SCSI x ^ | Le numéro de l'unité du disque est le chiffre affiché ici, dans la colonne "Address". Si vous avez utilisé un autre utilitaire lors de l'installation de votre disque dur, il devrait également vous donner quelque part le numéro d'unité. @endnode @node examples "Exemples" Exemples: ~~~~~~~~ Supposons que votre disque dur utilise un pilote SCSI nommé "cybppc.device" et soit adressé en tant qu'unité 88: Si vous souhaitez sauvegarder le @{" RDB " link rdb} de ce disque dur sur un fichier nommé "DF1:RDBs/IBM_36GB", la syntax sera la suivante: ReadRDB DEVICE=cybppc.device UNIT=88 FILE=DF1:RDBs/IBM_36GB Si vous souhaitez maintenant remplacer (écraser!) le RDB de ce disque dur par celui sauvegardé dans ce même fichier: ReadRDB DEVICE=cybppc.device UNIT=88 WRITE FILE=DF1:RDBs/IBM_36GB @endnode @node info "Information supplémentaire (et gratuite ;-)" ReadRDB donne également des informations contenues dans le @{" RDB " link rdb}. La première partie concerne 'l'agencement' du disque. Cet agencement n'est pas la disposition physique réelle du disque, mais un équivalent élaboré par l'utilitaire utilisé lors de l'installation, qui est utilisé par le pilote (device driver). Par exemple il peut être indiqué 1 pour le nombre de têtes, mais physiquement le disque peut avoir réellement 4 têtes (de lecture/écriture!). Ceci est fait dans le but de simplifier l'agencement utilisé par le pilote. Mais la taille totale, qui est égale à: (cylindres * secteurs * têtes) * octets par bloc correspondra à la taille réelle du disque. Ensuite ReadRDB vous dira si 'reselection' est autorisée ou non pour ce disque. Certains pilotes SCSI ne supportent pas correctement 'reselection'. Si vous avez des problèmes (blocages) avec plusieurs disques durs connectés sur le même contrôleur, vous pouvez essayer 'd'interdire' 'reselection' sur TOUS ces disques SCSI. Vous pouvez le faire (il peut le faire ;-) avec "Prod_Prep" et les scripts l'accompagnant. Prod_Prep se trouve normalement sur la disquette "Install" qui fait partie de vos disquettes Workbench. Ceci peut être utile en attendant la nouvelle ROM pour votre contrôleur, que vous avez commandée ;-) Pour terminer, ReadRDB va vérifier si les 'drapeaux' suivants de 'rdb_Flags' sont établis: Ces 'drapeaux' (flags) sont définis comme suit dans le fichier 'include' "devices/hardblocks.h" de Commodore: RDBFF_LAST aucun disque n'existe pour être configuré après celui-ci sur ce contrôleur. RDBFF_LASTLUN aucun LUN après celui-ci n'existe pour être configuré à cette adresse SCSI (unité, 'SCSI Target ID') RDBFF_LASTTID aucune adresse SCSI (unité, 'Target ID') après celle-ci n'existe pour être configuré sur ce bus SCSI. RDBFF_SYNCH ce disque supporte le mode synchrone PEUT ÊTRE DANGEREUX D'UTILISÉ SI LE DISQUE NE LE SUPPORTE PAS! @endnode @node author "ReadRDB author" @prev main @next main Envoyez toutes suggestions, rapports de 'bug', compliments ;-), chocolat NOIR (75% minimum ;-), tabac Bergerac Affiné, logiciels librement distribuables ou originaux, disques durs de 36 Go (les 18 Go seront acceptés ;), scanners couleurs au format A3 en 48 bits et demi, lecteurs et graveurs de CDROM (SCSI 2 Seulement ;-), disques CDROM, tape-streamers de 10 Go mini, AMIGA 9999 avec microprocesseur RISC à 16 Ghz, etc..., etc... OU SIMPLEMENT UNE CARTE POSTALE à: Gérard CORNU 11 avenue Edouard Aynard 69130 ECULLY FRANCE. @{" (CMP) " link wpc} Email: gcornu@serveur.dtr.fr Passez une bonne journée! ...moi aussi!!! @endnode @node wpc "W.P.C." @prev author @next main Communauté Mondiale des Peuples ;-) @endnode @node smiley "Pour ceux qui manquent d'humour ... ;-)" ****** ****** **** **** **** **** **** **** **** **** **************** **** **************** **** **** **** **** **** **** **** **** ****** **** ****** **** **** @endnode @NODE INDEX "Index" Index created by AGIX 1.2 (5.8.94) Copyright © Ralph Seichter modifié et reformaté par Gérard Cornu ;-) @{" Adresse de l'auteur " link author} @{" Avertissement " link warning} @{" Besoins " link requirement} @{" Copyright " link copyright} @{" DEVICE " link cli} @{" Distribution " link distribution} @{" Exemples " link examples} @{" FILE " link cli} @{" Garantie " link warranty} @{" Gérard Cornu " link author} @{" HELP " link cli} @{" Information supplémentaire " link info} @{" Installation " link installation} @{" Introduction " link introduction} @{" RDB " link rdb} @{" Readrdsk.c " link readrdsk} @{" Restrictions d'usage " link restrictions} @{" Rigid Disk Block " link rdb} @{" template " link silly} @{" Template (bis ;-) " link template} @{" UNIT " link unit} @{" Utiliser ReadRDB " link using} @{" WRITE " link cli} @endnode @node history "History" 0.7 Maintenant ReadRDB scanne les premiers RDB_LOCATION_LIMIT blocs pour un RDB, et récupère la taille du RDB par rdb_HighRDSKBlock. Si aucun nom de fichier n'est donné pour lire un RDB, ReadRDB nomme le fichier "T:RDB_nomduscsidevice_numérodel'unité" et ajoute un commentaire avec les infos du fabricant du disque si disponibles, suivit du nom du device scsi et du numéro de l'unité.. L'option FORCE a été supprimmée, elle ne devrait plus être nécessaire! 0.6 Version interne. 0.5 La correction de la 'bug' dans la version 0.2, en fait en introduisait une nouvelle: impossibilité de ré-écrire un RDB sous AmigaOS 2.x :-( Merci à "Sheer Panic" pour m'le dire!. 0.4 Ajout du switch FORCE. Suggéré par Roman Patzner. Merci Roman. 0.3 Version privée. 0.2 Correction de la 'bug' empêchant, sous l'OS 39.x, de ré-écrire un RDB. 0.1 Première version publique @endnode