source: thomson/tools/sap/sapfs.txt@ 134f1c4

main
Last change on this file since 134f1c4 was 134f1c4, checked in by Adrien Destugues <pulkomandy@…>, 12 years ago

Add sapfs (Vital Motion modified code...)

git-svn-id: svn://localhost/thomson@21 85ae3b6b-dc8f-4344-a89d-598714f2e4e5

  • Property mode set to 100644
File size: 7.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 SAPfs permet de réaliser sur les archives SAP les opérations
16naturelles d'un système de fichiers: création, formatage, vérification, dump
17binaire, listage des fichiers, extraction de fichiers, ajout de fichiers et
18destruction de fichiers.
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------------------------------
29SAPfs fonctionne en mode batch: une commande éventuellement suivie d'un ou
30plusieurs arguments doit lui être passée sur la ligne de commandes.
31
32
334. Commandes du programme
34-------------------------
35Une des commandes suivantes doit être passée à SAPfs comme premier argument:
36
37 -h, --help
38 affiche l'aide en ligne du programme.
39 ex: sapfs --help
40
41 -v, --version
42 affiche la version du programme.
43 ex: sapfs --version
44
45 -w, --verify archive.sap [piste] [secteur]
46 vérifie l'archive SAP dont le nom complet est spécifié
47 comme second argument et affiche le détail des erreurs
48 pour chaque secteur défectueux; si un troisième argument
49 est spécifié, il est interprété comme le numéro de piste
50 à laquelle la vérification sera restreinte; si un
51 quatrième argument est spécifié, il est interprété comme
52 le numéro de secteur.
53 ex: sapfs --verify foo.sap
54 sapfs --verify foo.sap 10
55
56 -u, --dump archive.sap [piste] [secteur]
57 effectue un dump binaire de l'archive SAP dont le nom
58 complet est spécifié comme second argument; si un
59 troisième argument est spécifié, il est interprété
60 comme le numéro de piste à laquelle le dump sera
61 restreint; si un quatrième argument est spécifié, il
62 est interprété comme le numéro de secteur.
63 ex: sapfs --dump foo.sap 20 2
64 sapfs --dump foo.sap 10
65
66 -t, --list archive.sap
67 affiche la liste des fichiers de l'archive SAP dont le
68 nom complet est spécifié comme second argument.
69 ex: sapfs --list foo.sap
70
71 -i, --info archive.sap fichier
72 affiche les informations relatives à un fichier de
73 l'archive SAP dont le nom complet est spécifié comme
74 second argument; le nom de ce fichier est spécifié
75 comme troisième argument; la casse est prise en compte.
76 ex: sapfs --info foo.sap AUTO.BAT
77
78 -x, --extract archive.sap fichier [fichier...]
79 extrait un ou plusieurs fichiers de l'archive SAP dont
80 le nom complet est spécifié comme second argument; le
81 nom de ce(s) fichier(s) est spécifié comme troisième
82 argument (puis quatrième, cinquième, etc); le nom de
83 fichier peut contenir les wildcards '*' et '?'; la
84 casse est prise en compte.
85 ex: sapfs --extract foo.sap BAR.BIN
86 sapfs --extract foo.sap Prog.BAS Prog.BIN
87 sapfs --extract foo.sap *.DAT
88
89 --extract-all archive.sap
90 extrait tous les fichiers de l'archive SAP dont le nom
91 est spécifié comme second argument.
92 ex: sapfs --extract-all foo.sap
93
94 -a, --add archive.sap fichier [fichier...] [répertoire...]
95 ajoute un ou plusieurs fichiers à l'archive SAP dont le
96 nom est spécifié comme second argument; le nom de ce(s)
97 fichier(s) est spécifié comme troisième argument (puis
98 quatrième, cinquième, etc); si un nom de répertoire est
99 spécifié, tous les fichiers qui y sont contenus seront
100 ajoutés; la casse est prise en compte.
101 ex: sapfs --add foo.sap BAR.BIN
102 sapfs --add foo.sap Prog.BAS Prog.BIN
103
104 -d, --delete archive.sap fichier [fichier...]
105 détruit un ou plusieurs fichiers de l'archive SAP dont
106 le nom complet est spécifié comme second argument; le
107 nom de ce(s) fichier(s) est spécifié comme troisième
108 argument (puis quatrième, cinquième, etc); le nom de
109 fichier peut contenir les wildcards '*' et '?'; la
110 casse est prise en compte.
111 ex: sapfs --delete foo.sap B?R.BIN
112 sapfs --delete foo.sap thom.bas son.bas
113 sapfs --delete foo.sap LEVEL*.DAT
114
115 -c, --create archive.sap [nb pistes] [densité]
116 crée une archive SAP vide (mais formatée) dont le nom
117 complet est spécifié comme second argument; le format
118 peut être spécifié comme troisième argument sous la
119 forme du nombre de pistes (40 ou 80, 80 par défaut) et
120 comme quatrième argument sous la forme de la densité
121 (1 ou 2, 2 par défault).
122 ex: sapfs --create foo.sap
123 ex: sapfs --create foo.sap 40
124
125 -f, --format archive.sap [nb pistes] [densité]
126 formate l'archive SAP dont le nom complet est spécifié
127 comme second argument;; le format peut être spécifié
128 comme troisième argument sous la forme du nombre de
129 pistes (40 ou 80, 80 par défaut) et comme quatrième
130 argument sous la forme de la densité (1 ou 2, 2 par
131 défault).
132 ex: sapfs --format foo.sap
133 ex: sapfs --format foo.sap 40
134
135 -k, --copy archive1.sap archive2.sap [piste] [secteur]
136 copie le contenu de l'archive source dont le nom complet
137 est spécifié comme second argument vers l'archive
138 destination dont le nom complet est spécifié comme
139 troisième argument; si un quatrième argument est
140 spécifié, il est interprété comme le numéro de piste à
141 laquelle la copie sera restreinte; si un cinquième
142 argument est spécifié, il est interprété comme le numéro
143 de secteur.
144 ex: sapfs --copy foo.sap bar.sap 65
145 sapfs --copy foo.sap bar.sap 20 3
146
147 -m, --move archive1.sap piste secteur archive2.sap piste secteur
148 copie le contenu du secteur repéré par les trois premiers
149 arguments vers le secteur repéré par les trois derniers
150 arguments.
151 ex: sapfs --move foo.sap 12 4 bar.sap 26 16
152
153
1545. Problèmes connus
155-------------------
156Aucun pour le moment (je croise les doigts ;-)
157
158
1596. Conclusion
160-------------
161J'espère que cette version de SAPfs répondra à vos attentes; n'hésitez pas à
162me faire part de vos remarques et suggestions.
163
164
165Eric Botcazou
166e-mail: <ebotcazou@libertysurf.fr>
Note: See TracBrowser for help on using the repository browser.