-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathnspark.1
116 lines (101 loc) · 3.75 KB
/
nspark.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
.TH NSPARK 1 "\*(V)" "USER COMMANDS"
.SH NAME
nspark \- unpack Archimedes archives
.SH SYNOPSIS
.B nspark
[
.B options
]
archive
[
.B file ...
]
.SH DESCRIPTION
The current version of
.B nspark
is 1.7.8
.B Nspark
can unpack the specified Archimedes-format
.B archive,
list its contents or tests its integrity.
Nspark's main features are:
o Supports all archive methods used by !Spark 1 and 2. The old
version didn't support "Squashing" and used to handle "Compressed"
archives by using the UNIX uncompress program. The new version
supports both these and has them built-in, allowing easier
porting to other OS's.
o Supports ArcFS format archives.
o Supports Cyclic Redundancy Checking (CRC). The integrity of an
archive can now be checked without having to unarchive it.
o Supports verbose option to allow archive file details to be
displayed (time/date or exec/load address, size, type).
o Supports selective file unarchiving, so the whole archive needn't
be unarchived if not all the files are wanted).
o Supports user-prompting before overwriting a file, allowing the
user to either (1) overwrite the file, (2) overwrite all the
files, (3) unarchive the file to a different name, or (4) not to
unarchive the file at all.
o Supports file-stamping so the date and time of the file, when
unarchived, matches the date and time it was archived (not 4.2BSD
or SysV.2 as these systems lack vital library functions).
I have not included support for creating !Spark archives, and I am not
really sure if I need to as: (1) !Spark for RISC OS is cheap (#5.99
from David Pilling), (2) !SparkPlug can unpack archives created with
zip (which is available in source form for UNIX, VMS and MSDOS), and
(3) it's a lot of work. Let me know what you think.
.I Options:
.IP "-x" 10
Extract the given
.B file,
or all files if none are specified.
.IP "-u" 10
Equivalent to -x.
.IP "-t" 10
Test archive integrity by simulating extraction and checking the CRCs (Cyclic
Redundancy Checks).
.IP "-l" 10
List archive contents.
.IP "-q" 10
Quiet. Displays less information when listing, testing or extracting.
.IP "-f" 10
Force file overwrite if a file already exists with the same name as the one
being extracted. If not using -f then you are prompted whether you want to
overwrite the original, skip this file, give it a different name, or overwrite
this and all others that already exist.
.IP "-s" 10
No filestamp. Does not set the timestamp when extracting files.
.IP "-v" 10
Verbose. Gives full details when listing or extracting archives.
.IP "-p<pass>" 10
Password. Specifies the password used to garble the archive.
.IP "-R" 10
Retry if archive is corrupt. If a bad header is found then nspark will
search the archive until another header if found, rather than giving up.
.IP "-L<name>" 10
Set name of log file to
.B name.
.IP "-T" 10
Append file type to name, in the same way as Tar or NFS. For example
Text files (filetype &FFF) have ,fff appended when extracted.
.IP "-C" 10
Create lowercase filenames. Useful on machines where the case of filenames
is significant (eg. UNIX), this option forces all extracted filenames to be
lowercase.
.IP "-V" 10
Display version number.
.SH BUGS
The DOS version does not time/date stamp directories.
.SH NOTES
.B Nspark
is in the public domain.
It is currently being maintained by James Woodcock ([email protected]).
.SH SEE ALSO
arcfs(5), spark(5).
.SH AUTHOR
Andy Duplain, BT Customer Systems, Brighton, UK. ([email protected])
.SH CONTRIBUTORS
Improvements from version 1.5, including ArcFS support, by Andrew Brooks ([email protected]).
Manual pages originally supplied by Duncan ([email protected]).
Suggestions for improvement by Tom Tromey ([email protected]).
Windows NT support by Alun Jones ([email protected]).
Previously maintained by arb ([email protected]).