source: vital-to8-sdk/sap/sapfs.txt @ 1

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

Import initial

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.