1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 5<title>Teo</title> 6<link rel="stylesheet" type="text/css" href="doc.css"> 7</head> 8<body> 9<table width="100%"><tr><td> 10 11<h3>SAP2</h3> 12 13<ul> 14<li><a href="#introduction">Introduction</a></li> 15<li><a href="#how_works">Fonctionnement du programme</a></li> 16<li><a href="#interactive_mode">Commandes du programme en mode interactif</a></li> 17<li><a href="#batch_mode">Commandes du programme en mode batch</a></li> 18<li><a href="#kown_problems">Problèmes connus</a></li> 19</ul> 20 21<h5>Introduction<a name="introduction"></a></h5> 22 23<p>Le système d'archivage SAP, conçu par Alexandre Pukall, est l'outil utilisé par les émulateurs Thomson pour manipuler de façon souple et sécurisée les disquettes 3"5 ou 5"25 au format Thomson. L'idée directrice de SAP est de reproduire les disquettes physiques Thomson sous forme de fichiers "images", stockables sur disque dur et lisibles directement par les émulateurs: toutes les opérations de lecture/écriture sont ainsi réalisées sur ces images et non pas sur les disquettes originales.</p> 24 25<p>Ce système permet de copier facilement les disquettes, de les diffuser par tout moyen numérique et assure in fine la préservation de leurs données au delà de la durée de vie du support physique.</p> 26 27<p>L'utilitaire SAP est le pont qui permet de faire le lien entre les deux modes de stockage. La version originale en a été écrite par Alexandre Pukall lui-même; la version étendue SAP2 présentée ci-dessous, disponible pour MS-DOS et Linux, en reprend intégralement les fonctionnalités.</p> 28 29<h5>Fonctionnement du programme<a name="how_works"></a></h5> 30 31<p>SAP2 peut fonctionner selon deux modes: si aucun argument ne lui est passé sur la ligne de commandes, il entre en mode interactif et propose un menu des commandes disponibles; si au moins un argument lui est passé sur la ligne de commandes, il entre en mode batch et décode l'argument pour éxécuter la commande spécifiée.</p> 32 33<h5>Commandes du programme en mode interactif<a name="interactive_mode"></a></h5> 34 35<p>Les commandes se répartissent en trois catégories: transfert TO-->PC, transfert PC-->TO et autres commandes.</p> 36 37<h6>Transfert TO-->PC</h6> 38 39<p><strong>Commande 1: Visualiser le contenu d'une disquette Thomson</strong><a name="dir_floppy"></a></a><br> 40Cette commande peut être utile <em>avant</em> de lancer le processus d'archivage proprement dit: elle affiche le répertoire d'une disquette 3"5 ou 5"25 au format Thomson introduite dans un des lecteurs (elle réalise l'équivalent de la commande DIR du BASIC).</p> 41 42<p><strong>Commande 2: Créer une archive SAP vide</strong><a name="create_sap"></a></a><br> 43Cette commande peut être éxécutée sans disquettes au format Thomson. Elle crée une archive SAP vide et formatée (elle réalise l'équivalent de la commande DSKINI du BASIC sur une archive SAP nouvellement créée), soit au format 3"5 (80 pistes, 320 ko), soit au format 5"25 DD (40 pistes, 160 ko) ou 5"25 SD (40 pistes, 80 ko).</p> 44 45<p><strong>Commande 3: Archiver une disquette Thomson vers une archive SAP</strong><a name="archive_sap"></a></a><br> 46Cette commande est la véritable commande d'archivage: elle lit le contenu de la disquette 3"5 ou 5"25 au format Thomson introduite dans un des lecteurs du PC et le restitue sous la forme d'une archive SAP sur le disque dur du PC. Elle détecte les secteurs illisibles ou défectueux et active le mécanisme que le format SAP définit dans ce cas.</p> 47 48<h6>Transfert PC-->TO</h6> 49 50<p><strong>Commande 4: Visualiser le contenu d'une archive SAP</strong><a name="dir_sap"></a></a><br> 51Cette commande peut être utile <em>avant</em> de lancer le processus de désarchivage proprement dit: elle affiche la liste des fichiers contenus dans l'archive SAP spécifiée. </p> 52 53<p><strong>Commande 5: Formater une disquette 3"5 ou 5"25 au format Thomson</strong><a name="format_floppy"></a><br> 54Le désarchivage (commande 6) d'une archive SAP vers une disquette 3"5 ou 5"25 ne peut être réalisé que si la disquette est au <em>préalable</em> formatée au format Thomson. Cette commande permet d'appliquer ce formatage à une disquette 3"5 ou 5"25 introduite dans un des lecteurs du PC; si la disquette est une disquette 3"5 - 1.44 Mo, il est nécessaire d'occulter l'encoche de droite (recto et verso) avec un morceau de scotch.</p> 55 56<p><strong>Commande 6: Désarchiver une archive SAP vers une disquette Thomson</strong><a name="unarchive_sap"></a></a><br> 57Cette commande est la véritable commande de désarchivage: elle lit le contenu d'une archive SAP et l'écrit sur la disquette 3"5 ou 5"25 au format Thomson introduite dans un des lecteurs du PC. Attention: (voir commande 5) la disquette doit être au <em>préalable</em> formatée au format Thomson.</p> 58 59<h6>Autres commandes</h6> 60 61<p><strong>Commande 7: Quitter</strong><br> 62Comme son nom ne l'indique pas ;-) elle permet de quitter le programme.</p> 63 64<h5>Commandes du programme en mode batch<a name="batch_mode"></a></h5> 65 66<p>Une des commandes suivantes doit être passée à SAP2 comme premier argument:</p> 67 68<p><strong>-h, --help</strong><br> 69Affiche l'aide en ligne du programme.<br> 70ex: sap2 --help</p> 71 72<p><strong>-v, --version</strong><br> 73Affiche la version du programme.<br> 74ex: sap2 --version</p> 75 76<p><strong>-t, --list archive</strong><br> 77Affiche la liste des fichiers de l'archive SAP.<br> 78<span style="padding-left:30px"><em><code>archive</code></em> : nom complet de l'archive SAP<br> 79ex: sap2 --list foo.sap<br> 80<a href="#dir_sap">voir la commande 4 du mode interactif</a></p> 81 82<p><strong>-p, --pack archive lecteur [densité]</strong><br> 83Archive une disquette Thomson vers une archive SAP. Si le lecteur est un 5"25, la densité peut être spécifiée.<br> 84<span style="padding-left:30px"><em><code>archive</code></em> : nom complet de l'archive SAP</span><br> 85<span style="padding-left:30px"><em><code>lecteur</code></em> : de 0 à 3</span><br> 86<span style="padding-left:30px"><em><code>densité</code></em> : 1 = simple densité, 2 = double densité (par défaut)</span><br> 87ex: sap2 --pack foo.sap 0<br> 88<a href="#archive_sap">voir la commande 3 du mode interactif</a></p> 89 90<p><strong>-u, --unpack archive lecteur [densité]</strong><br> 91Désarchive une archive SAP vers une disquette Thomson. Si le lecteur est un 5"25, la densité peut être spécifiée.<br> 92<span style="padding-left:30px"><em><code>archive</code></em> : nom complet de l'archive SAP</span><br> 93<span style="padding-left:30px"><em><code>lecteur</code></em> : de 0 à 3</span><br> 94<span style="padding-left:30px"><em><code>densité</code></em> : 1 = simple densité, 2 = double densité (par défaut)</span><br> 95ex: sap2 --unpack foo.sap 0<br> 96<a href="#unarchive_sap">voir la commande 6 du mode interactif</a></p> 97 98<p><strong>-c, --create archive.sap [nb pistes] [densité]</strong><br> 99Crée une archive SAP vide.<br> 100<span style="padding-left:30px"><em><code>archive</code></em> : nom complet de l'archive SAP</span><br> 101<span style="padding-left:30px"><em><code>nb_pistes</code></em> : 40 ou 80 (80 par défaut)</span><br> 102<span style="padding-left:30px"><em><code>densité</code></em> : 1 = simple densité, 2 = double densité (par défaut)</span><br> 103ex: sap2 --create foo.sap<br> 104ex: sap2 --create foo.sap 40<br> 105<a href="#create_sap">voir la commande 2 du mode interactif</a></p> 106 107<p><strong>-d, --dir lecteur [densité]</strong><br> 108Affiche le contenu de la disquette Thomson. Si le lecteur est un 5"25, la densité peut être spécifiée.<br> 109<span style="padding-left:30px"><em><code>lecteur</code></em> : de 0 à 3</span><br> 110<span style="padding-left:30px"><em><code>densité</code></em> : 1 = simple densité, 2 = double densité (par défaut)</span><br> 111ex: sap2 --dir 0<br> 112<a href="#dir_floppy">voir la commande 1 du mode interactif</a></p> 113 114<p><strong>-f, --format lecteur [densité] [entrelacement]</strong><br> 115Formate une disquette 3"5 ou 5"25 au format Thomson.<br> 116<span style="padding-left:30px"><em><code>lecteur</code></em> : de 0 à 3</span><br> 117<span style="padding-left:30px"><em><code>densité</code></em> : 1 = simple densité, 2 = double densité (par défaut)</span><br> 118<span style="padding-left:30px"><em><code>entrelacement</code></em> : de 1 à 15 (7 par défaut)</span><br> 119ex: sap2 --format 0 6<br> 120ex: sap2 --format 1<br> 121<a href="#format_floppy">voir la commande 5 du mode interactif</a></p> 122 123<h5>Problèmes connus<a name="kown_problems"></a></h5> 124 125<ul> 126<li>la version MS-DOS peut fonctionner sous Windows 95 et 98; néanmoins, et notamment si un logiciel anti-virus tourne en tâche de fond, il peut être nécessaire de redémarrer l'ordinateur et d'ouvrir une session MS-DOS pure.</li> 127<li>la version MS-DOS de SAP ne permet pas d'archiver à partir ou de désarchiver vers la face 1 d'une disquette Thomson; il s'agit d'une impossibilité définitive due à une incompatibilité entre le DOS TO et le BIOS PC. A contrario, la version Linux n'est pas concernée par ce problème.</li> 128<li>la version MS-DOS de SAP ne permet pas d'accéder aux disquettes 5"25 simple densité; il s'agit là encore d'une impossibilité définitive due aux limitations du BIOS PC. A contrario, la version Linux n'est pas concernée par ce problème.</li> 129<li>il se peut que MS-DOS ne puisse plus reformater au format standard une disquette formatée au format Thomson.</li> 130</ul> 131</td></tr></table> 132</body> 133</html> 134