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>SAPfs</h3>
12
13<ul>
14<li><a href="#introduction">Introduction</a><br></li>
15<li><a href="#how_works">How the program works</a><br></li>
16<li><a href="#program_commands">Program commands</a><br></li>
17</ul>
18
19<h5>Introduction<a name="introduction"></a></h5>
20
21<p>The SAP archiving system, designed by Alexander Pukall, is the tool used by Teo emulator to handle flexibly and securely 3"5 or 5"25 disks formatted Thomson. The main idea is to reproduce Thomson physical disks as files "images", storable on hard disk and directly readable by emulators: all operations read / write are thus performed on these images and not on the original disks.</p>
22
23<p>This system allows to easily copy disks, to spread any digital medium and ultimately ensures the preservation of their data beyond the life of the physical medium.</p>
24
25<p>The SAPfs utility allows to make standard system file operations on SAP archives: creation, formatting, checking, dump binary, directory, extracting files, adding files and deleting files.</p>
26
27<h5>How the program works<a name="how_works"></a></h5>
28
29<p>SAPfs works in batch mode: a command, possibly followed by one or more arguments, must be passed in command line.</p>
30
31<h5>Program commands<a name="program_commands"></a></h5>
32
33<p>One of the following must be passed as first argument:</p>
34
35<p><strong>-h, --help</strong><br>
36Display help.<br>
37ex: sapfs --help</p>
38
39<p><strong>-v, --version</strong><br>
40Display the program version.<br>
41ex: sapfs --version</p>
42
43<p><strong>-w, --verify archive [track] [sector]</strong><br>
44Check the SAP archive and displays error details for each bad sector.<br>
45<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
46<span style="padding-left:30px"><em><code>track</code></em> : track number which the verification will be limited to</span><br>
47<span style="padding-left:30px"><em><code>sector</code></em> : sector number (from 1 to 16)</span><br>
48ex: sapfs --verify foo.sap<br>
49ex: sapfs --verify foo.sap 10</p>
50
51<p><strong>-u, --dump archive [track] [sector]</strong><br>
52Make a binary dump of the SAP archive.<br>
53<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
54<span style="padding-left:30px"><em><code>track</code></em> : track number which the verification will be limited to</span><br>
55<span style="padding-left:30px"><em><code>sector</code></em> : sector number (from 1 to 16)</span><br>
56ex: sapfs --dump foo.sap 20 2<br>
57ex: sapfs --dump foo.sap 10</p>
58
59<p><strong>-t, --list archive</strong><br>
60Display the directory of the SAP archive<br>
61<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
62ex: sapfs --list foo.sap</p>
63
64<p><strong>-i, --info archive file</strong><br>
65Display informations about a file of the SAP archive. Case is sensitive.<br>
66<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
67<span style="padding-left:30px"><em><code>file</code></em> : name of the file to display informations from</span><br>
68ex: sapfs --info foo.sap AUTO.BAT</p>
69
70<p><strong>-x, --extract archive file [file...]</strong><br>
71Extract one or more files from SAP archive. Wildcards '*' and '?' can be used for the file name. Case is sensitive.<br>
72<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
73<span style="padding-left:30px"><em><code>file</code></em> : name(s) of the file(s) to extract</span><br>
74ex: sapfs --extract foo.sap BAR.BIN<br>
75ex: sapfs --extract foo.sap Prog.BAS Prog.BIN<br>
76ex: sapfs --extract foo.sap *.DAT</p>
77
78<p><strong>--extract-all archive</strong><br>
79Extract all files from SAP archive.<br>
80<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
81ex:  sapfs --extract-all foo.sap</p>
82
83<p><strong>-a, --add archive file_or_folder [file_or_folder...]</strong><br>
84Add one or more files to the SAP archive. Case is sensitive.<br>
85<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
86<span style="padding-left:30px"><em><code>file_or_folder</code></em> : name(s) of the file(s) or folder(s) to add</span><br>
87ex: sapfs --add foo.sap BAR.BIN<br>
88ex: sapfs --add foo.sap Prog.BAS Prog.BIN</p>
89
90<p><strong>-d, --delete archive file [file...]</strong><br>
91Delete one or more files to the SAP archive. Wildcards '*' and '?' can be used for the file name. Case is sensitive.<br>
92<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
93<span style="padding-left:30px"><em><code>file</code></em> : name(s) of the file(s) to delete</span><br>
94ex: sapfs --delete foo.sap B?R.BIN<br>
95ex: sapfs --delete foo.sap thom.bas son.bas<br>
96ex: sapfs --delete foo.sap LEVEL*.DAT</p>
97
98<p><strong>-c, --create archive [nb_of_tracks] [density]</strong><br>
99Create an empty formatted SAP archive.<br>
100<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
101<span style="padding-left:30px"><em><code>nb_of_tracks</code></em> : number of tracks (40 or 80, default 80)</span><br>
102<span style="padding-left:30px"><em><code>density</code></em> : 1 = simple density, 2 = double density (default)</span><br>
103ex: sapfs --create foo.sap<br>
104ex: sapfs --create foo.sap 40</p>
105
106<p><strong>-f, --format archive [nb_of_tracks] [density]</strong><br>
107Format a SAP archive.<br>
108<span style="padding-left:30px"><em><code>archive</code></em> : full name of the SAP archive</span><br>
109<span style="padding-left:30px"><em><code>nb_of_tracks</code></em> : number of tracks (40 or 80, default 80)</span><br>
110<span style="padding-left:30px"><em><code>density</code></em> : 1 = simple density, 2 = double density (default)</span><br>
111ex: sapfs --format foo.sap<br>
112ex: sapfs --format foo.sap 40</p>
113
114<p><strong>-k, --copy archive1 archive2 [track] [sector]</strong><br>
115Duplicate a SAP archive.<br>
116<span style="padding-left:30px"><em><code>archive1</code></em> : full name of the SAP archive to copy from</span><br>
117<span style="padding-left:30px"><em><code>archive2</code></em> : full name of the SAP archive to copy to</span><br>
118<span style="padding-left:30px"><em><code>track</code></em> : track number which the copy will be limited to</span><br>
119<span style="padding-left:30px"><em><code>sector</code></em> : sector number (from 1 to 16)</span><br>
120ex: sapfs --copy foo.sap bar.sap 65<br>
121ex: sapfs --copy foo.sap bar.sap 20 3</p>
122
123<p><strong>-m, --move archive1 track sector archive2 track sector</strong><br>
124Copy the contents of a sector.<br>
125<span style="padding-left:30px"><em><code>archive1</code></em> : full name of the SAP archive to copy from</span><br>
126<span style="padding-left:30px"><em><code>archive2</code></em> : full name of the SAP archive to copy to</span><br>
127<span style="padding-left:30px"><em><code>track</code></em> : track number</span><br>
128<span style="padding-left:30px"><em><code>sector</code></em> : sector number (from 1 to 16)</span><br>
129ex:  sapfs --move foo.sap 12 4 bar.sap 26 16</p>
130</td></tr></table>
131</body>
132</html>
133