source: vital-to8-sdk/sap/sap2.txt

Last change on this file was 1, checked in by svn, 6 years ago

Import initial

File size: 8.8 KB
Line 
11. Introduction
2---------------
3Le système d'archivage SAP, conçu par Alexandre Pukall, est l'outil utilisé
4par les émulateurs Thomson pour manipuler de façon souple et sécurisée les
5disquettes 3"5 ou 5"25 au format Thomson. L'idée directrice de SAP est de
6reproduire les disquettes physiques Thomson sous forme de fichiers "images",
7stockables sur disque dur et lisibles directement par les émulateurs: toutes
8les opérations de lecture/écriture sont ainsi réalisées sur ces images et
9non pas sur les disquettes originales.
10
11Ce système permet de copier facilement les disquettes, de les diffuser par
12tout moyen numérique et assure in fine la préservation de leurs données au
13delà de la durée de vie du support physique.
14
15L'utilitaire SAP est le pont qui permet de faire le lien entre les deux
16modes de stockage. La version originale en a été écrite par Alexandre Pukall
17lui-même; la version étendue SAP2 présentée ci-dessous, disponible pour
18MSDOS et Linux, en reprend intégralement les fonctionnalités.
19
20
212. Comment l'obtenir ?
22----------------------
23En le téléchargeant depuis la page Web:
24http://nostalgies.thomsonistes.org/utilitaires.html
25
26
273. Fonctionnement du programme
28------------------------------
29SAP2 peut fonctionner selon deux modes: si aucun argument ne lui est passé
30sur la ligne de commandes, il entre en mode interactif et propose un menu des
31commandes disponibles; si au moins un argument lui est passé sur la ligne de
32commandes, il entre en mode batch et décode l'argument pour éxécuter la
33commande spécifiée.
34
35
364. Commandes du programme en mode interactif
37--------------------------------------------
38Les commandes se répartissent en trois catégories: transfert TO-->PC,
39transfert PC-->TO et autres commandes.
40
41  4.1 Transfert TO-->PC
42  ---------------------
43  Commande 1: Visualiser le contenu d'une disquette Thomson
44    Cette commande peut être utile *avant* de lancer le processus
45    d'archivage proprement dit: elle affiche le répertoire d'une
46    disquette 3"5 ou 5"25 au format Thomson introduite dans un des
47    lecteurs (elle réalise l'équivalent de la commande DIR du BASIC).
48
49  Commande 2: Créer une archive SAP vide
50    Cette commande peut être éxécutée sans disquettes au format Thomson.
51    Elle crée une archive SAP vide et formatée (elle réalise l'équivalent
52    de la commande DSKINI du BASIC sur une archive SAP nouvellement créée),
53    soit au format 3"5 (80 pistes, 320 ko), soit au format 5"25 DD (40 pistes,
54    160 ko) ou 5"25 SD (40 pistes, 80 ko).
55
56  Commande 3: Archiver une disquette Thomson vers une archive SAP
57    Cette commande est la véritable commande d'archivage: elle lit le
58    contenu de la disquette 3"5 ou 5"25 au format Thomson introduite dans un
59    des lecteurs du PC et le restitue sous la forme d'une archive SAP sur le
60    disque dur du PC. Elle détecte les secteurs illisibles ou défectueux et
61    active le mécanisme que le format SAP définit dans ce cas.
62
63
64  4.2 Transfert PC-->TO
65  ---------------------
66  Commande 4: Visualiser le contenu d'une archive SAP
67    Cette commande peut être utile *avant* de lancer le processus de
68    désarchivage proprement dit: elle affiche la liste des fichiers
69    contenus dans l'archive SAP spécifiée.
70
71  Commande 5: Formater une disquette 3"5 ou 5"25 au format Thomson
72    Le désarchivage (commande 6) d'une archive SAP vers une
73    disquette 3"5 ou 5"25 ne peut être réalisé que si la disquette est
74    au *préalable* formatée au format Thomson. Cette commande permet
75    d'appliquer ce formatage à une disquette 3"5 ou 5"25 introduite dans
76    un des lecteurs du PC; si la disquette est une disquette 3"5 - 1.44 Mo,
77    il est nécessaire d'occulter l'encoche de droite (recto et verso) avec
78    un morceau de scotch.
79
80  Commande 6: Désarchiver une archive SAP vers une disquette Thomson
81    Cette commande est la véritable commande de désarchivage: elle lit le
82    contenu d'une archive SAP et l'écrit sur la disquette 3"5 ou 5"25 au
83    format Thomson introduite dans un des lecteurs du PC. Attention: (voir
84    commande 5) la disquette doit être au *préalable* formatée au format
85    Thomson.
86
87
88  4.3 Autres commandes
89  --------------------
90  Commande 7: Quitter
91    Comme son nom ne l'indique pas ;-) elle permet de quitter le programme.
92
93
945. Commandes du programme en mode batch
95---------------------------------------
96Une des commandes suivantes doit être passée à SAP2 comme premier argument:
97
98  -h, --help
99                    affiche l'aide en ligne du programme.
100                    ex:  sap2 --help
101
102  -v, --version
103                    affiche la version du programme.
104                    ex:  sap2 --version
105
106  -t, --list archive.sap
107                    affiche la liste des fichiers de l'archive SAP dont le
108                    nom complet est spécifié comme second argument.
109                    ex:  sap2 --list foo.sap
110                    [voir la commande 4 du mode interactif]
111
112  -p, --pack archive.sap lecteur [densité]
113                    archive une disquette Thomson vers une archive SAP dont
114                    le nom complet est spécifié comme deuxième argument; le
115                    numéro du lecteur dans lequel est inséré la disquette
116                    est spécifié comme troisième argument; si ce lecteur est
117                    un 5"25, la densité peut être spécifiée comme troisième
118                    argument (1 ou 2, 2 par défault).
119                    ex:  sap2 --pack foo.sap 0
120                    [voir la commande 3 du mode interactif]
121
122  -u, --unpack archive.sap lecteur [densité]
123                    désarchive une archive SAP, dont le nom complet est
124                    spécifié comme deuxième argument, vers une disquette
125                    Thomson insérée dans le lecteur dont le numéro est
126                    spécifié comme troisième argument; si ce lecteur est
127                    un 5"25, la densité peut être spécifiée comme troisième
128                    argument (1 ou 2, 2 par défault).
129                    ex:  sap2 --unpack foo.sap 0
130                    [voir la commande 6 du mode interactif]
131
132  -c, --create archive.sap [nb pistes] [densité]
133                    crée une archive SAP vide dont le nom complet est
134                    spécifié comme second argument; le format peut être
135                    spécifié comme troisième argument sous la forme du
136                    nombre de pistes (40 ou 80, 80 par défaut) et comme
137                    quatrième argument sous la forme de la densité (1 ou
138                    2, 2 par défault).
139                    ex:  sap2 --create foo.sap
140                         sap2 --create foo.sap 40
141                    [voir la commande 2 du mode interactif]
142
143  -d, --dir lecteur [densité]
144                    affiche le contenu de la disquette Thomson insérée dans
145                    le lecteur dont le numéro est spécifié comme second
146                    argument (0=lecteur A face 0, 1=lecteur A face 1,
147                    2=lecteur B face 0, 3=lecteur B face 1); si ce lecteur
148                    est un 5"25, la densité peut être spécifiée comme
149                    troisième argument (1 ou 2, 2 par défault).
150                    ex:  sap2 --dir 0
151                    [voir la commande 1 du mode interactif]
152
153  -f, --format lecteur [densité] [entrelacement]
154                    formate une disquette 3"5 ou 5"25 au format Thomson,
155                    insérée dans le lecteur dont le numéro est spécifié
156                    comme second argument; si ce lecteur est un 5"25, la
157                    densité peut être spécifiée comme troisième argument
158                    (1 ou 2, 2 par défault); le facteur d'entrelacement du
159                    formatage peut être spécifié comme quatrième argument
160                    (7 par défault).
161                    ex:  sap2 --format 0 6
162                         sap2 --format 1
163                    [voir la commande 5 du mode interactif]
164
165
1666. Problèmes connus
167-------------------
168- la version MSDOS peut fonctionner sous Windows 95 et 98; néanmoins, et
169  notamment si un logiciel anti-virus tourne en tâche de fond, il peut être
170  nécessaire de redémarrer l'ordinateur et d'ouvrir une session MS-DOS pure.
171- la version MSDOS de SAP ne permet pas d'archiver à partir ou de
172  désarchiver vers la face 1 d'une disquette Thomson; il s'agit d'une
173  impossibilité définitive dûe à une incompatibilité entre le DOS TO et
174  le BIOS PC. A contrario, la version Linux n'est pas concernée par ce
175  problème.
176- la version MSDOS de SAP ne permet pas d'accéder aux disquettes 5"25 simple
177  densité; il s'agit là encore d'une impossibilité définitive dûe aux
178  limitations du BIOS PC. A contrario, la version Linux n'est pas concernée
179  par ce problème.
180- il se peut que MSDOS ne puisse plus reformater au format standard une
181  disquette formatée au format Thomson.
182
183
1847. Conclusion
185-------------
186J'espère que cette version de SAP répondra à vos attentes; n'hésitez pas à
187me faire part de vos remarques et suggestions.
188
189
190Eric Botcazou
191e-mail: <ebotcazou@libertysurf.fr>
Note: See TracBrowser for help on using the repository browser.