Home » Archimedes archive » Micro User » MU 1991-12.adf » PD-Stuff » ArcFSExtra/Hlp044_105

ArcFSExtra/Hlp044_105

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-12.adf » PD-Stuff
Filename: ArcFSExtra/Hlp044_105
Read OK: ✔
File size: 5DED bytes
Load address: 0000
Exec address: 0000
Duplicates

There are 2 duplicate copies of this file in the archive:

File contents
!Help file for ArcFS version 0.44 / 1.05
by M.Smith
28th October 1991

Many thanks to David Pilling, author of Spark and SparkPlug, for providing
me with the information to enable me to include support for Squashed (PK arc
compatible) and Compress formats. Spark is available directly from him,
currently for �5.99

ArcFS has filing system number 56. My thanks to Acorn for the allocation of
this filing system number and for the allocation of the SWI chunk base
(&437C0).

The version of ArcFSFiler supplied with this version of ArcFS (v0.21 /
v1.01) should work with all versions of Oak's SCSI Hard drive and may also
work with all versions of Ian Copestake Software's IDE Hard drive. I cannot
test this since I don't have either of these hard drives. Any feedback about
this would be most welcome.

ArcFS versions less than 1.00 are read-only, P.D. versions.

ArcFS allows the loading and opening of (compressed) files in archives 
almost as easily as files on ADFS or RamFS. It has its own ArcFS filer 
which displays the root directory in a filer window of any archive 
which is double clicked. From then on files and applications may be 
loaded as normal by double clicking them. Directories may be displayed 
also by double clicking them. ArcFS can, of cause, also be used from 
the command line.

You may notice a small increase in the time taken to load files 
compared to loading files from ADFS and also that ArcFS takes a short 
time to Open Spark compatible Archives when they are double clicked.

This version also supports a new archive format. It is much quicker to open
these new format archives than to open Spark compatible archives and the
read / write versions (1.00 and greater) can only write to and create new
format archives.

*****************************************************************************

ArcFS supports the following entry points:

    FSEntry_Func 0 to set current directory (*Dir)

    FSEntry_Func 1 to set library directory (*Lib)

    FSEntry_Func 2 to catalogue directory (*Cat)

    FSEntry_Func 3 to examine directory (*EX)

    FSEntry_Func 4 to catalogue library directory (*LCat)

    FSEntry_Func 5 to examine library directory (*LEX)

    FSEntry_Func 6 to examine objects (*Info).

    FSEntry_Func 8 to rename objects (*Rename) - r/w version only

    FSEntry_Func 9 to access objects (*Access) - r/w version only

    FSEntry_Func 11 to read name of archive containing the CSD (OS_GBPB 5)

    FSEntry_Func 12 to read CSD name (OS_GBPB 6)

    FSEntry_Func 13 to read Lib. name (OS_GBPB 7)

    FSEntry_Func 14 to read dir. entries (OS_GBPB 8/9)

    FSEntry_Func 15 to respond to requests from the Filer for 
    the necessary information to display a directory window

    FSEntry_Func 16 to close all archives on a Shut down

    FSEntry_Func 19 to read directory entries & information

    FSEntry_Func 20 to give full information on objects (*FileInfo)

    FSEntry_File 0 to save files - r/w version only

    FSEntry_File 1-4 to write catalogue information - r/w version only

    FSEntry_File 5 to read catalogue information on a file

    FSEntry_File 6 to delete objects - r/w version only

    FSEntry_File 7 to create files - r/w version only

    FSEntry_File 8 to create directories - r/w version only

    FSEntry_File 255 to load files

    FSEntry_Open to provide facilities for opening files for 
    random access input (and output for r/w version). ArcFS claims memory
    from the R.M.A. the size of the uncompressed file and the loads the file 
    into this claimed memory. For this reason it is possible to 
    get 'No Room in RMA errors' when opening large files.

    FSEntry_GetBytes reads required bytes from memory claimed 
    by FSEntry_Open

    FSEntry_PutBytes writes required bytes to memory claimed by FSEntry_Open
    extending it if necessary.

    FSEntry_Args 3,4,7,8,9 is supported for operations on files open for
    update - r/w version only

    FSEntry_Close releases memory claimed by FSEntry_Open (and writes the
    data back to the file if open for update)

*****************************************************************************

Catalogue Storage in memory

When an archive is opened the number of objects in the archive is 
counted and a block of R.M.A., 36 bytes for each object is claimed and 
the catalogue information is read into this block.

*****************************************************************************

Compression formats

This version of ArcFS supports crunched, packed, new format stored
objects, squashed and compressed objects. Objects in a format  that
ArcFS cannot handle will give 'Can't handle archive' errors when  you
attempt to load them. Archives containing old format stored objects cannot
be opened.

Memory requirements

-----------------------------------------------------------------------------
No. of bits| ArcFS formats          | Spark formats       |Memory requirement
compression|                        |                     |
-----------------------------------------------------------------------------12 bits    | Crunch 12, Compress 12 | Crunch, Compress 12 |Just over 16K
13 bits    | Crunch 13, Compress 13 | Squash, Compress 13 |Just over 32K
14 bits    | Crunch 14, Compress 14 | Compress 14         |Just over 64K
15 bits    | Crunch 15, Compress 15 | Compress 15         |Just over 128K
16 bits    | Crunch 16, Compress 16 | Compress 16         |Just over 256K
-----------------------------------------------------------------------------

The above table shows the requirements for free memory in order to load each
of the available formats. Using 16 bit compression formats can cause
problems when trying to load such files on a 1Mbyte machine. ArcFS requires
triple the above requirements when compressing files.

*****************************************************************************

Simultaneously open archives

This version of ArcFS supports up to five archives open at any one time.
Each archive must be refered to by a unique name (usually, but not
necessarily, the leaf name of the archive). This is name is provided when
the archive is opened using *OpenArchive and can then be included in the
special field to refer to that specific archive. The ArcFS Filer uses the
leaf name of the archive as the name.

*****************************************************************************

Screen Output format

Screen Output follows that of Filecore as closely as possible. *FileInfo
gives a totaly different output to that of Filecore.

*FileInfo

*FileInfo displays the complete Header information held in memory about
files. The output of *FileInfo is as follows:

Name     LWR/wr ff format bb llllllll aaaaaaaa eeeeeeee cccccccc pppppppp rr%

where:

    Name is the object leafname

    LWR/wr are the object attributes

    ff is the Header Version Number (represents the compression format)

    format is the type of data compression (always store for directories)

    bb is the number of bits for crunch or compress formats (-- otherwise)

    llllllll is the full object length (for directories this is the total
             compressed size of all objects contained in it.)

    aaaaaaaa is the load address

    eeeeeeee is the execute address

    cccccccc is the compressed file size.It equals the full length for stored
             objects.

    pppppppp This depends on whether the object is a file or directory. For a
             file it is the position in the archive file at which the file
             data begins. For directories this is the memory address at which
             the next header in the parent directory exists (not very useful,
             but used internally by ArcFS).

         rr% This is the compression ratio, i.e. the compressed file size
             expressed as a percentage of the original.

*****************************************************************************

File Attributes

The CRC is stored in the top 16 bits and the no. of bits compression (where
appropriate) is stored in the next 8 bits. File access rights are stored in
the bottom 8 bits. (N.B. the top 24 bits were used to store the compressed
file length in previous versions.)

*****************************************************************************

User Root Directories (U.R.D.'s)

Now supported. Use *URD to select the user root (&) directory. If the URD is "unset" then the root ($) directory is used instead.

The previously selected directory (P.S.D.)

Now supported. When a new directory selection is made, the old one becomes
the P.S.D. Use *Back to swap the C.S.D. and P.S.D. The P.S.D. can be
specified at the begining of a pathname as \. If the PSD is "unset" then the CSD is used instead.

Automatic library selection

If ArcFS finds a directory starting with the letters 'Lib' in the root
directory of an archive when it is open it selects this as the library
directory.

Unset Directory contexts

If the PSD or library are used but are "unset" then the CSD is used instead.
If the URD is "unset" then the root is used instead. If the CSD is "unset"
and the user tries to perform operations on the current directory (or
current archive) the an error will be generated.

If the CSD is "unset" and an archive is opened, the CSD will automatically
be set the root directory of the new archive.

*****************************************************************************

Random access filing

Files are decompressed and held in R.M.A. whilst they are open. You  should
note that when sprite files are loaded they are opened for  random access
input and therefore there needs to be enough free memory  available when the
sprites are loaded. This may cause problems when  large sprite files are
loaded into a 1 Mbyte machine (anyone with an  unexpanded A305 - don't
bother!) but I cannot really suggest anything  short of upgrading to 2
Mbytes (other than making sure that all the  possible free memory is
available to the R.M.A.). When I bought my 2Mbyte RAM upgrade in Dec. 1989
it cost �150 +VAT. Now it can cost as little as a third of that price and is
still falling. I have found it very useful and can recommend it to any users
of 1 Mbyte A3000's and A410's who use their computers for more than just
arcade games. Other files such as  Exec and Obey files are also opened for
random access input but these  are usually short.
A maximum of five files may be open for update with the r/w version (BASIC's
OPENUP and OPENOUT) but there is no limit to the number of files open for
input only (BASIC's OPENIN).

*****************************************************************************

Use with 65Host and 65Tube

ArcFS can easily be used with 65Host and 65Tube. 65Host users must open the
required archive(s) before entering the emulator under which ArcFS is
selected by:

    *Dir ArcFS:

DFS emulations may also be set up in archives (as on ADFS) and used
under 65Host

*****************************************************************************

PC Format

Files archived using PC Format in Spark or archived using SEA arc or PK arc
on a PC all have file type &111.

*****************************************************************************

Directory levels

Up to 64 directory levels are supported. In the unlikely event that more
exist in an archive further subdirectories are shown as archives. This limit does not apply to new format archives.

*****************************************************************************

Commands provided:

  *ArcFS                       - selects ArcFS as the current filing system
  *OpenArchive <Object> <name> - Opens an archive for file operations
  *CloseArchive [<name>]       - Closes the named (or any) open archive(s)
  *CreateArchive <Object>      - Creates an archive (r/w version only)

Filing system commands:

  *Back                        - swaps the currently and previously selected                                  directories (CSD and PSD)
  *URD                         - selects the user root directory (URD)
  *Garble <PassWord>           - Loads files garbled with a password
  *NoEncryption                - Loads files with no encryption
For r/w version only:
  *Compact [<archive name.>]   - Removes gaps left by deletions / overwrites
  *Store                       - Sets no compression
  *Pack                        - Sets compression of rptd. chars. only
  *Crunch [<no. bits>]         - Sets file crunching with no. bits (or 12)
  *Compress [<no. bits>]       - Sets file compress with no. bits (or 12)

*****************************************************************************

File encryption

This version supports garbled files. Incorrect passwords, use of Garble for
files with no encryption or trying to load garbled files having set ArcFS to
load files with no encryption will result in a 'Wrong password / Data
Corrupt' error. This will also occur if data in an archive becomes
corrupted.

For Spark compatible (old format) archives containing crunched or compressed
files which are encoded, all files of these formats must be encoded with
passwords that have the same first letter. Encryption must be set with at
least the first letter of the password(s) before opening the archive
(otherwise the above error will occur). This is because ArcFS must be able
to decode the first byte of the data for these files to find out the no. of
bits of compression.

*****************************************************************************

Software Interrupts

The allocated SWI chunk base is &437C0.
-----------------------------------------------------------------------------
SWI "ArcFS_ArchiveInfo"                                          &437C0

On entry: R0=archive number (0-4)

On exit : R0=pointer to archive name (null terminated)
�         R1=pointer to archive pathname (null terminated)
          R2=pointer to archive headers (internal use only)

This SWI gives the name and pathname of the archive whose number is given by
R0 on entry. If R0 points to a null string on exit then there is no open
archive with this number (i.e. an empty 'slot')
-----------------------------------------------------------------------------
SWI "ArcFS_Status"                                               &437C1

On entry: -

On exit : R0=status (&vvbbffee)

This returns the current status of ArcFS.

vv is &FF for read / write version or &00 for read only version
bb is no. of bits for crunch / compress formats (0 otherwise)
ff is the compression format (see SWI "ArcFS_Compression", below)

The bottom bit of ee is set if file garble is set or clear otherwise. The
other bits of ee are reserved for future expansion.
-----------------------------------------------------------------------------
SWI "ArcFS_OpenArchive"                                          &437C2

On entry: R0=pointer to pathname (control terminated)
          R1=pointer to name (control terminated)

On exit : R0 & R1 preserved

This SWI opens an archive. Possible errors are 'Too many archives open' or
'An archive with this name is already open'.
-----------------------------------------------------------------------------
SWI "ArcFS_CloseArchive"                                         &437C3

On entry: R0=pointer to name (control terminated)

On exit : R0 prserved

This SWI closes an archive. Possible error is 'No archive with this name is
open'.
-----------------------------------------------------------------------------
SWI "ArcFS_Encryption"                                           &437C4

On entry: R0=encryption method (none=0, garble=1)
          R1=pointer to password (control termainated, up to 32 bytes)

On exit : R0 & R1 preserved

This SWI sets the encryption method and password used.
-----------------------------------------------------------------------------
SWI "ArcFS_Compression"           r/w version only               &437C5

On entry: R0=compression format (&82,&83,&88 or &FF)
          R1=no. bits for &88 and &FF

On exit : R0 & R1 preserved

This SWI sets the data compression format to be used:
  &82 Store
  &83 Pack
  &88 Crunch
  &FF Compress
Possible errors are 'Bits range error' and 'Unknown compression format'
-----------------------------------------------------------------------------
SWI "ArcFS_CreateArchive"         r/w version only               &437C6

On entry: R0=pointer to pathname for new archive

On exit : R0 is preserved

This SWI creates (but does not open) a new archive.
-----------------------------------------------------------------------------
SWI "ArcFS_Compact"               r/w version only               &437C7

On entry: R0=pointer to archive name or 0

On exit : R0 is preserved

This SWI compacts the named archive (or that containing the CSD) to removed
gaps left by deletions and file overwrites.

*****************************************************************************

Errors

Error numbers are of the form &138xx where xx is as follows:

xx Error

01 ArcFS CSD is "Unset"
02 Can't handle this archive
03 This version of ArcFS is read only.... (self explanatory)
04 Wrong password / Data Corrupt
05 No archive with this name is open
06 Bits range error (outside range 12-16, used by read / write version only)
07 Unknown Compression format (used by read / write version only)
08 Version .... or .... required (your version of ArcFS is too old to handle
   this archive)

80 Too many archives open
82 An archive with this name is already open
89 Archive read only (no write access or is locked, used by r/w version only)

96 Can't delete current directory
97 Can't delete current library
A0 ArcFS in use (RMReinit ArcFS if it occurs repeatedly)
A2 Can't delete user root directory
B4 Dir. not empty (read / write version only)
C0 Too many open files (more than 5 files open for update, r/w version only)
C3 Locked (read / write version only)
C4 Already exists (read / write version only)
C5 Types don't match (read / write version only)
D6 Not found

FF Internal filing error (should not occur)

In addition, errors may be generated by FileSwitch or by the filing system
on which an archive is based, e.g. Disc full errors from ADFS.

*****************************************************************************

ArcFS Filer

The ArcFS filer is a module task, provided so that directories may be
displayed in normal filer windows. Archives are opened by double clicking
them or dragging them to the ArcFS icon. The root directory of the most
recently opened archive may be displayed by clicking on the icon. A menu is
provided with four options (seven for the r/w version):

Encryption - Sets the encryption method and password (if any) that is used.
             The subdirectory has options for no encryption and garble. DES
             encryption is not available in this version and so is shaded.

Open '$'   - Opens the root directory of an open archive, chosen from the
             sub-menu.

Close arc  - Closes an open archive, chosen from the sub-menu and all
             directory windows of that archive.

Kill       - Closes all the open archives, removes all arcfs directory
             windows, Kills the ArcFS module, Quits the ArcFS Filer and Kills
             the ArcFS Filer module.

Kill prompts for confirmation. Click on OK to Kill the modules or Cancel
otherwise. Note pressing escape has the same effect as clicking on OK.

In addition the r/w version provides the following options:

New arc    - Provides a save box for creating new archives

Compact    - Compacts an open archive (choose from sub-menu)

Compression- Use to set the compression method

*****************************************************************************

All comments and suggestions for future improvement are welcome but please
note that I cannot reply to letters without return postage and an addressed
envelope.

The address is:

    Mr. M. Smith
    Pen-y-dre,
    Riverside Ave.,
    Broxbourne,
    Herts.,
    EN10 6RD.

Between Monday 30th September and Friday 13th December 1991 and between
Monday 6th January and Friday 27th March 1992 inc. I can be reached more
quickly at:

    Mr. M. Smith,
    Chepstow Hall of Residence,
    Room L14,
    Brunel University,
    Uxbridge,
    Middlsex,
    UB8 3PH.

Please do not send any post to reach this address after 27th March 1992 as I
will probably not receive it. Please be patient when waiting for replies as
I may not be able to reply immediately.

I have a JANET email address:

ee91mds2@brunel.ac.uk

I can be contacted at this email address from Oct-Mar of 1991/92, 92/93 and
93/94 and from Oct-Jun of 1994/95.

I would also, of course welcome details of any bugs discovered so that I can
correct them.

*****************************************************************************

Version Improvements

v0.20 First Release version
v0.21 Max number of directory levels increased from 16 to 64, some tidying
v0.22 Snowed in 8th Feb 91 so made extensive changes: URD and PSD now
      supported. Commands *Back and *URD provided. *FileInfo command added.
      Compression format removed from *Info and *EX output (now given by
      *FileInfo). *Info & *FileInfo now give information on multiple
      wildcarded files. Compressed file size now stored in the top 24 bits of
      the file attributes. PC format files are now supported. Supplied with
      new ArcFS Filer with icon and menu.
v0.23 Corrected 2 bugs - ArcFS did not release 16k of claimed memory when an
      error occured during the load crunch routine. If you cancelled a
      request from the load pack routine to insert a disk the request was
      repeated a second time.
v0.30 Now added support for squashed and compressed formats. Also added
      support for Garbled files, *Garble and *NoEncryption commands provided.
      Comprehensive error checking checks for corrupted data and/or passwords
      and file encryption methods inconsistent with those that have been set.
v0.40 Added support for multiple archives, new format archives, rewritten
      ArcFS Filer as a module task. Also added SWI's. Corrected bugs such as
      the one causing strange characters to appear in % compression ratios
      (sometimes causing a crash when trying to give a ratio for very small
      files). Not for P.D. distribution as I am still waiting for a SWI chunk
      base allocation.
v0.41 Added support for FSEntry_Func 11,12,13,14 and 19. Will now work with
      Impression (documents can be loaded without another copy of Impression
      being loaded and !Impress can be loaded from an archive without
      crashing). Tidied the error numbers (some now different) to give
      allocations shown above. SWI chunk base allocation &437C0 received
      from Acorn. New ArcFSFiler (v0.21) should work with older Oak SCSI and
      ICS IDE hard drives
v0.42 Fixed bug which sometimes gives an address exception when trying to
      read an encrypted file with the wrong password. v0.41 was mistakenly
      sent out with a copy of ArcFSFiler v0.21 which stated that it was not
      P.D.
v0.43 Fixed bug which gives incorrect load address on return from OS_File
      load commands. This caused problems with Edit not maintaining the
      correct filetype when updating files.
v0.44 Fixed bug present in versions 0.40 to 0.43 which caused the machine to
      crash when attempting to open SEA ARC or PKARC archives or Spark
      archives containing PC format files.

v1.01 First fully implimented read / write version.
v1.02 Compact now fully implimented, makes archive as small as possible.
      Also, bug fix as for v0.43
v1.03 Fixed bugs in rename routine and also in compact routine. Now generates
      an error if you attempt to delete the CSD, Library or URD. Also, bug
      fix as for v0.44
v1.04 Added facility to detect read / write version from SWI "ArcFS_Status"
v1.05 Fixed bug which sometimes caused the loss of additional directories /
      files when deleteing directories. File recovery program 'BgArcFS104'
      included for files lost due to this bug.

� 1991 M. Smith

00000000  21 48 65 6c 70 20 66 69  6c 65 20 66 6f 72 20 41  |!Help file for A|
00000010  72 63 46 53 20 76 65 72  73 69 6f 6e 20 30 2e 34  |rcFS version 0.4|
00000020  34 20 2f 20 31 2e 30 35  0a 62 79 20 4d 2e 53 6d  |4 / 1.05.by M.Sm|
00000030  69 74 68 0a 32 38 74 68  20 4f 63 74 6f 62 65 72  |ith.28th October|
00000040  20 31 39 39 31 0a 0a 4d  61 6e 79 20 74 68 61 6e  | 1991..Many than|
00000050  6b 73 20 74 6f 20 44 61  76 69 64 20 50 69 6c 6c  |ks to David Pill|
00000060  69 6e 67 2c 20 61 75 74  68 6f 72 20 6f 66 20 53  |ing, author of S|
00000070  70 61 72 6b 20 61 6e 64  20 53 70 61 72 6b 50 6c  |park and SparkPl|
00000080  75 67 2c 20 66 6f 72 20  70 72 6f 76 69 64 69 6e  |ug, for providin|
00000090  67 0a 6d 65 20 77 69 74  68 20 74 68 65 20 69 6e  |g.me with the in|
000000a0  66 6f 72 6d 61 74 69 6f  6e 20 74 6f 20 65 6e 61  |formation to ena|
000000b0  62 6c 65 20 6d 65 20 74  6f 20 69 6e 63 6c 75 64  |ble me to includ|
000000c0  65 20 73 75 70 70 6f 72  74 20 66 6f 72 20 53 71  |e support for Sq|
000000d0  75 61 73 68 65 64 20 28  50 4b 20 61 72 63 0a 63  |uashed (PK arc.c|
000000e0  6f 6d 70 61 74 69 62 6c  65 29 20 61 6e 64 20 43  |ompatible) and C|
000000f0  6f 6d 70 72 65 73 73 20  66 6f 72 6d 61 74 73 2e  |ompress formats.|
00000100  20 53 70 61 72 6b 20 69  73 20 61 76 61 69 6c 61  | Spark is availa|
00000110  62 6c 65 20 64 69 72 65  63 74 6c 79 20 66 72 6f  |ble directly fro|
00000120  6d 20 68 69 6d 2c 0a 63  75 72 72 65 6e 74 6c 79  |m him,.currently|
00000130  20 66 6f 72 20 a3 35 2e  39 39 0a 0a 41 72 63 46  | for .5.99..ArcF|
00000140  53 20 68 61 73 20 66 69  6c 69 6e 67 20 73 79 73  |S has filing sys|
00000150  74 65 6d 20 6e 75 6d 62  65 72 20 35 36 2e 20 4d  |tem number 56. M|
00000160  79 20 74 68 61 6e 6b 73  20 74 6f 20 41 63 6f 72  |y thanks to Acor|
00000170  6e 20 66 6f 72 20 74 68  65 20 61 6c 6c 6f 63 61  |n for the alloca|
00000180  74 69 6f 6e 20 6f 66 0a  74 68 69 73 20 66 69 6c  |tion of.this fil|
00000190  69 6e 67 20 73 79 73 74  65 6d 20 6e 75 6d 62 65  |ing system numbe|
000001a0  72 20 61 6e 64 20 66 6f  72 20 74 68 65 20 61 6c  |r and for the al|
000001b0  6c 6f 63 61 74 69 6f 6e  20 6f 66 20 74 68 65 20  |location of the |
000001c0  53 57 49 20 63 68 75 6e  6b 20 62 61 73 65 0a 28  |SWI chunk base.(|
000001d0  26 34 33 37 43 30 29 2e  0a 0a 54 68 65 20 76 65  |&437C0)...The ve|
000001e0  72 73 69 6f 6e 20 6f 66  20 41 72 63 46 53 46 69  |rsion of ArcFSFi|
000001f0  6c 65 72 20 73 75 70 70  6c 69 65 64 20 77 69 74  |ler supplied wit|
00000200  68 20 74 68 69 73 20 76  65 72 73 69 6f 6e 20 6f  |h this version o|
00000210  66 20 41 72 63 46 53 20  28 76 30 2e 32 31 20 2f  |f ArcFS (v0.21 /|
00000220  0a 76 31 2e 30 31 29 20  73 68 6f 75 6c 64 20 77  |.v1.01) should w|
00000230  6f 72 6b 20 77 69 74 68  20 61 6c 6c 20 76 65 72  |ork with all ver|
00000240  73 69 6f 6e 73 20 6f 66  20 4f 61 6b 27 73 20 53  |sions of Oak's S|
00000250  43 53 49 20 48 61 72 64  20 64 72 69 76 65 20 61  |CSI Hard drive a|
00000260  6e 64 20 6d 61 79 20 61  6c 73 6f 0a 77 6f 72 6b  |nd may also.work|
00000270  20 77 69 74 68 20 61 6c  6c 20 76 65 72 73 69 6f  | with all versio|
00000280  6e 73 20 6f 66 20 49 61  6e 20 43 6f 70 65 73 74  |ns of Ian Copest|
00000290  61 6b 65 20 53 6f 66 74  77 61 72 65 27 73 20 49  |ake Software's I|
000002a0  44 45 20 48 61 72 64 20  64 72 69 76 65 2e 20 49  |DE Hard drive. I|
000002b0  20 63 61 6e 6e 6f 74 0a  74 65 73 74 20 74 68 69  | cannot.test thi|
000002c0  73 20 73 69 6e 63 65 20  49 20 64 6f 6e 27 74 20  |s since I don't |
000002d0  68 61 76 65 20 65 69 74  68 65 72 20 6f 66 20 74  |have either of t|
000002e0  68 65 73 65 20 68 61 72  64 20 64 72 69 76 65 73  |hese hard drives|
000002f0  2e 20 41 6e 79 20 66 65  65 64 62 61 63 6b 20 61  |. Any feedback a|
00000300  62 6f 75 74 0a 74 68 69  73 20 77 6f 75 6c 64 20  |bout.this would |
00000310  62 65 20 6d 6f 73 74 20  77 65 6c 63 6f 6d 65 2e  |be most welcome.|
00000320  0a 0a 41 72 63 46 53 20  76 65 72 73 69 6f 6e 73  |..ArcFS versions|
00000330  20 6c 65 73 73 20 74 68  61 6e 20 31 2e 30 30 20  | less than 1.00 |
00000340  61 72 65 20 72 65 61 64  2d 6f 6e 6c 79 2c 20 50  |are read-only, P|
00000350  2e 44 2e 20 76 65 72 73  69 6f 6e 73 2e 0a 0a 41  |.D. versions...A|
00000360  72 63 46 53 20 61 6c 6c  6f 77 73 20 74 68 65 20  |rcFS allows the |
00000370  6c 6f 61 64 69 6e 67 20  61 6e 64 20 6f 70 65 6e  |loading and open|
00000380  69 6e 67 20 6f 66 20 28  63 6f 6d 70 72 65 73 73  |ing of (compress|
00000390  65 64 29 20 66 69 6c 65  73 20 69 6e 20 61 72 63  |ed) files in arc|
000003a0  68 69 76 65 73 20 0a 61  6c 6d 6f 73 74 20 61 73  |hives .almost as|
000003b0  20 65 61 73 69 6c 79 20  61 73 20 66 69 6c 65 73  | easily as files|
000003c0  20 6f 6e 20 41 44 46 53  20 6f 72 20 52 61 6d 46  | on ADFS or RamF|
000003d0  53 2e 20 49 74 20 68 61  73 20 69 74 73 20 6f 77  |S. It has its ow|
000003e0  6e 20 41 72 63 46 53 20  66 69 6c 65 72 20 0a 77  |n ArcFS filer .w|
000003f0  68 69 63 68 20 64 69 73  70 6c 61 79 73 20 74 68  |hich displays th|
00000400  65 20 72 6f 6f 74 20 64  69 72 65 63 74 6f 72 79  |e root directory|
00000410  20 69 6e 20 61 20 66 69  6c 65 72 20 77 69 6e 64  | in a filer wind|
00000420  6f 77 20 6f 66 20 61 6e  79 20 61 72 63 68 69 76  |ow of any archiv|
00000430  65 20 0a 77 68 69 63 68  20 69 73 20 64 6f 75 62  |e .which is doub|
00000440  6c 65 20 63 6c 69 63 6b  65 64 2e 20 46 72 6f 6d  |le clicked. From|
00000450  20 74 68 65 6e 20 6f 6e  20 66 69 6c 65 73 20 61  | then on files a|
00000460  6e 64 20 61 70 70 6c 69  63 61 74 69 6f 6e 73 20  |nd applications |
00000470  6d 61 79 20 62 65 20 0a  6c 6f 61 64 65 64 20 61  |may be .loaded a|
00000480  73 20 6e 6f 72 6d 61 6c  20 62 79 20 64 6f 75 62  |s normal by doub|
00000490  6c 65 20 63 6c 69 63 6b  69 6e 67 20 74 68 65 6d  |le clicking them|
000004a0  2e 20 44 69 72 65 63 74  6f 72 69 65 73 20 6d 61  |. Directories ma|
000004b0  79 20 62 65 20 64 69 73  70 6c 61 79 65 64 20 0a  |y be displayed .|
000004c0  61 6c 73 6f 20 62 79 20  64 6f 75 62 6c 65 20 63  |also by double c|
000004d0  6c 69 63 6b 69 6e 67 20  74 68 65 6d 2e 20 41 72  |licking them. Ar|
000004e0  63 46 53 20 63 61 6e 2c  20 6f 66 20 63 61 75 73  |cFS can, of caus|
000004f0  65 2c 20 61 6c 73 6f 20  62 65 20 75 73 65 64 20  |e, also be used |
00000500  66 72 6f 6d 20 0a 74 68  65 20 63 6f 6d 6d 61 6e  |from .the comman|
00000510  64 20 6c 69 6e 65 2e 0a  0a 59 6f 75 20 6d 61 79  |d line...You may|
00000520  20 6e 6f 74 69 63 65 20  61 20 73 6d 61 6c 6c 20  | notice a small |
00000530  69 6e 63 72 65 61 73 65  20 69 6e 20 74 68 65 20  |increase in the |
00000540  74 69 6d 65 20 74 61 6b  65 6e 20 74 6f 20 6c 6f  |time taken to lo|
00000550  61 64 20 66 69 6c 65 73  20 0a 63 6f 6d 70 61 72  |ad files .compar|
00000560  65 64 20 74 6f 20 6c 6f  61 64 69 6e 67 20 66 69  |ed to loading fi|
00000570  6c 65 73 20 66 72 6f 6d  20 41 44 46 53 20 61 6e  |les from ADFS an|
00000580  64 20 61 6c 73 6f 20 74  68 61 74 20 41 72 63 46  |d also that ArcF|
00000590  53 20 74 61 6b 65 73 20  61 20 73 68 6f 72 74 20  |S takes a short |
000005a0  0a 74 69 6d 65 20 74 6f  20 4f 70 65 6e 20 53 70  |.time to Open Sp|
000005b0  61 72 6b 20 63 6f 6d 70  61 74 69 62 6c 65 20 41  |ark compatible A|
000005c0  72 63 68 69 76 65 73 20  77 68 65 6e 20 74 68 65  |rchives when the|
000005d0  79 20 61 72 65 20 64 6f  75 62 6c 65 20 63 6c 69  |y are double cli|
000005e0  63 6b 65 64 2e 0a 0a 54  68 69 73 20 76 65 72 73  |cked...This vers|
000005f0  69 6f 6e 20 61 6c 73 6f  20 73 75 70 70 6f 72 74  |ion also support|
00000600  73 20 61 20 6e 65 77 20  61 72 63 68 69 76 65 20  |s a new archive |
00000610  66 6f 72 6d 61 74 2e 20  49 74 20 69 73 20 6d 75  |format. It is mu|
00000620  63 68 20 71 75 69 63 6b  65 72 20 74 6f 20 6f 70  |ch quicker to op|
00000630  65 6e 0a 74 68 65 73 65  20 6e 65 77 20 66 6f 72  |en.these new for|
00000640  6d 61 74 20 61 72 63 68  69 76 65 73 20 74 68 61  |mat archives tha|
00000650  6e 20 74 6f 20 6f 70 65  6e 20 53 70 61 72 6b 20  |n to open Spark |
00000660  63 6f 6d 70 61 74 69 62  6c 65 20 61 72 63 68 69  |compatible archi|
00000670  76 65 73 20 61 6e 64 20  74 68 65 0a 72 65 61 64  |ves and the.read|
00000680  20 2f 20 77 72 69 74 65  20 76 65 72 73 69 6f 6e  | / write version|
00000690  73 20 28 31 2e 30 30 20  61 6e 64 20 67 72 65 61  |s (1.00 and grea|
000006a0  74 65 72 29 20 63 61 6e  20 6f 6e 6c 79 20 77 72  |ter) can only wr|
000006b0  69 74 65 20 74 6f 20 61  6e 64 20 63 72 65 61 74  |ite to and creat|
000006c0  65 20 6e 65 77 0a 66 6f  72 6d 61 74 20 61 72 63  |e new.format arc|
000006d0  68 69 76 65 73 2e 0a 0a  2a 2a 2a 2a 2a 2a 2a 2a  |hives...********|
000006e0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000720  2a 2a 2a 2a 2a 0a 0a 41  72 63 46 53 20 73 75 70  |*****..ArcFS sup|
00000730  70 6f 72 74 73 20 74 68  65 20 66 6f 6c 6c 6f 77  |ports the follow|
00000740  69 6e 67 20 65 6e 74 72  79 20 70 6f 69 6e 74 73  |ing entry points|
00000750  3a 0a 0a 20 20 20 20 46  53 45 6e 74 72 79 5f 46  |:..    FSEntry_F|
00000760  75 6e 63 20 30 20 74 6f  20 73 65 74 20 63 75 72  |unc 0 to set cur|
00000770  72 65 6e 74 20 64 69 72  65 63 74 6f 72 79 20 28  |rent directory (|
00000780  2a 44 69 72 29 0a 0a 20  20 20 20 46 53 45 6e 74  |*Dir)..    FSEnt|
00000790  72 79 5f 46 75 6e 63 20  31 20 74 6f 20 73 65 74  |ry_Func 1 to set|
000007a0  20 6c 69 62 72 61 72 79  20 64 69 72 65 63 74 6f  | library directo|
000007b0  72 79 20 28 2a 4c 69 62  29 0a 0a 20 20 20 20 46  |ry (*Lib)..    F|
000007c0  53 45 6e 74 72 79 5f 46  75 6e 63 20 32 20 74 6f  |SEntry_Func 2 to|
000007d0  20 63 61 74 61 6c 6f 67  75 65 20 64 69 72 65 63  | catalogue direc|
000007e0  74 6f 72 79 20 28 2a 43  61 74 29 0a 0a 20 20 20  |tory (*Cat)..   |
000007f0  20 46 53 45 6e 74 72 79  5f 46 75 6e 63 20 33 20  | FSEntry_Func 3 |
00000800  74 6f 20 65 78 61 6d 69  6e 65 20 64 69 72 65 63  |to examine direc|
00000810  74 6f 72 79 20 28 2a 45  58 29 0a 0a 20 20 20 20  |tory (*EX)..    |
00000820  46 53 45 6e 74 72 79 5f  46 75 6e 63 20 34 20 74  |FSEntry_Func 4 t|
00000830  6f 20 63 61 74 61 6c 6f  67 75 65 20 6c 69 62 72  |o catalogue libr|
00000840  61 72 79 20 64 69 72 65  63 74 6f 72 79 20 28 2a  |ary directory (*|
00000850  4c 43 61 74 29 0a 0a 20  20 20 20 46 53 45 6e 74  |LCat)..    FSEnt|
00000860  72 79 5f 46 75 6e 63 20  35 20 74 6f 20 65 78 61  |ry_Func 5 to exa|
00000870  6d 69 6e 65 20 6c 69 62  72 61 72 79 20 64 69 72  |mine library dir|
00000880  65 63 74 6f 72 79 20 28  2a 4c 45 58 29 0a 0a 20  |ectory (*LEX).. |
00000890  20 20 20 46 53 45 6e 74  72 79 5f 46 75 6e 63 20  |   FSEntry_Func |
000008a0  36 20 74 6f 20 65 78 61  6d 69 6e 65 20 6f 62 6a  |6 to examine obj|
000008b0  65 63 74 73 20 28 2a 49  6e 66 6f 29 2e 0a 0a 20  |ects (*Info)... |
000008c0  20 20 20 46 53 45 6e 74  72 79 5f 46 75 6e 63 20  |   FSEntry_Func |
000008d0  38 20 74 6f 20 72 65 6e  61 6d 65 20 6f 62 6a 65  |8 to rename obje|
000008e0  63 74 73 20 28 2a 52 65  6e 61 6d 65 29 20 2d 20  |cts (*Rename) - |
000008f0  72 2f 77 20 76 65 72 73  69 6f 6e 20 6f 6e 6c 79  |r/w version only|
00000900  0a 0a 20 20 20 20 46 53  45 6e 74 72 79 5f 46 75  |..    FSEntry_Fu|
00000910  6e 63 20 39 20 74 6f 20  61 63 63 65 73 73 20 6f  |nc 9 to access o|
00000920  62 6a 65 63 74 73 20 28  2a 41 63 63 65 73 73 29  |bjects (*Access)|
00000930  20 2d 20 72 2f 77 20 76  65 72 73 69 6f 6e 20 6f  | - r/w version o|
00000940  6e 6c 79 0a 0a 20 20 20  20 46 53 45 6e 74 72 79  |nly..    FSEntry|
00000950  5f 46 75 6e 63 20 31 31  20 74 6f 20 72 65 61 64  |_Func 11 to read|
00000960  20 6e 61 6d 65 20 6f 66  20 61 72 63 68 69 76 65  | name of archive|
00000970  20 63 6f 6e 74 61 69 6e  69 6e 67 20 74 68 65 20  | containing the |
00000980  43 53 44 20 28 4f 53 5f  47 42 50 42 20 35 29 0a  |CSD (OS_GBPB 5).|
00000990  0a 20 20 20 20 46 53 45  6e 74 72 79 5f 46 75 6e  |.    FSEntry_Fun|
000009a0  63 20 31 32 20 74 6f 20  72 65 61 64 20 43 53 44  |c 12 to read CSD|
000009b0  20 6e 61 6d 65 20 28 4f  53 5f 47 42 50 42 20 36  | name (OS_GBPB 6|
000009c0  29 0a 0a 20 20 20 20 46  53 45 6e 74 72 79 5f 46  |)..    FSEntry_F|
000009d0  75 6e 63 20 31 33 20 74  6f 20 72 65 61 64 20 4c  |unc 13 to read L|
000009e0  69 62 2e 20 6e 61 6d 65  20 28 4f 53 5f 47 42 50  |ib. name (OS_GBP|
000009f0  42 20 37 29 0a 0a 20 20  20 20 46 53 45 6e 74 72  |B 7)..    FSEntr|
00000a00  79 5f 46 75 6e 63 20 31  34 20 74 6f 20 72 65 61  |y_Func 14 to rea|
00000a10  64 20 64 69 72 2e 20 65  6e 74 72 69 65 73 20 28  |d dir. entries (|
00000a20  4f 53 5f 47 42 50 42 20  38 2f 39 29 0a 0a 20 20  |OS_GBPB 8/9)..  |
00000a30  20 20 46 53 45 6e 74 72  79 5f 46 75 6e 63 20 31  |  FSEntry_Func 1|
00000a40  35 20 74 6f 20 72 65 73  70 6f 6e 64 20 74 6f 20  |5 to respond to |
00000a50  72 65 71 75 65 73 74 73  20 66 72 6f 6d 20 74 68  |requests from th|
00000a60  65 20 46 69 6c 65 72 20  66 6f 72 20 0a 20 20 20  |e Filer for .   |
00000a70  20 74 68 65 20 6e 65 63  65 73 73 61 72 79 20 69  | the necessary i|
00000a80  6e 66 6f 72 6d 61 74 69  6f 6e 20 74 6f 20 64 69  |nformation to di|
00000a90  73 70 6c 61 79 20 61 20  64 69 72 65 63 74 6f 72  |splay a director|
00000aa0  79 20 77 69 6e 64 6f 77  0a 0a 20 20 20 20 46 53  |y window..    FS|
00000ab0  45 6e 74 72 79 5f 46 75  6e 63 20 31 36 20 74 6f  |Entry_Func 16 to|
00000ac0  20 63 6c 6f 73 65 20 61  6c 6c 20 61 72 63 68 69  | close all archi|
00000ad0  76 65 73 20 6f 6e 20 61  20 53 68 75 74 20 64 6f  |ves on a Shut do|
00000ae0  77 6e 0a 0a 20 20 20 20  46 53 45 6e 74 72 79 5f  |wn..    FSEntry_|
00000af0  46 75 6e 63 20 31 39 20  74 6f 20 72 65 61 64 20  |Func 19 to read |
00000b00  64 69 72 65 63 74 6f 72  79 20 65 6e 74 72 69 65  |directory entrie|
00000b10  73 20 26 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 0a  |s & information.|
00000b20  0a 20 20 20 20 46 53 45  6e 74 72 79 5f 46 75 6e  |.    FSEntry_Fun|
00000b30  63 20 32 30 20 74 6f 20  67 69 76 65 20 66 75 6c  |c 20 to give ful|
00000b40  6c 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 6f 6e  |l information on|
00000b50  20 6f 62 6a 65 63 74 73  20 28 2a 46 69 6c 65 49  | objects (*FileI|
00000b60  6e 66 6f 29 0a 0a 20 20  20 20 46 53 45 6e 74 72  |nfo)..    FSEntr|
00000b70  79 5f 46 69 6c 65 20 30  20 74 6f 20 73 61 76 65  |y_File 0 to save|
00000b80  20 66 69 6c 65 73 20 2d  20 72 2f 77 20 76 65 72  | files - r/w ver|
00000b90  73 69 6f 6e 20 6f 6e 6c  79 0a 0a 20 20 20 20 46  |sion only..    F|
00000ba0  53 45 6e 74 72 79 5f 46  69 6c 65 20 31 2d 34 20  |SEntry_File 1-4 |
00000bb0  74 6f 20 77 72 69 74 65  20 63 61 74 61 6c 6f 67  |to write catalog|
00000bc0  75 65 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 2d  |ue information -|
00000bd0  20 72 2f 77 20 76 65 72  73 69 6f 6e 20 6f 6e 6c  | r/w version onl|
00000be0  79 0a 0a 20 20 20 20 46  53 45 6e 74 72 79 5f 46  |y..    FSEntry_F|
00000bf0  69 6c 65 20 35 20 74 6f  20 72 65 61 64 20 63 61  |ile 5 to read ca|
00000c00  74 61 6c 6f 67 75 65 20  69 6e 66 6f 72 6d 61 74  |talogue informat|
00000c10  69 6f 6e 20 6f 6e 20 61  20 66 69 6c 65 0a 0a 20  |ion on a file.. |
00000c20  20 20 20 46 53 45 6e 74  72 79 5f 46 69 6c 65 20  |   FSEntry_File |
00000c30  36 20 74 6f 20 64 65 6c  65 74 65 20 6f 62 6a 65  |6 to delete obje|
00000c40  63 74 73 20 2d 20 72 2f  77 20 76 65 72 73 69 6f  |cts - r/w versio|
00000c50  6e 20 6f 6e 6c 79 0a 0a  20 20 20 20 46 53 45 6e  |n only..    FSEn|
00000c60  74 72 79 5f 46 69 6c 65  20 37 20 74 6f 20 63 72  |try_File 7 to cr|
00000c70  65 61 74 65 20 66 69 6c  65 73 20 2d 20 72 2f 77  |eate files - r/w|
00000c80  20 76 65 72 73 69 6f 6e  20 6f 6e 6c 79 0a 0a 20  | version only.. |
00000c90  20 20 20 46 53 45 6e 74  72 79 5f 46 69 6c 65 20  |   FSEntry_File |
00000ca0  38 20 74 6f 20 63 72 65  61 74 65 20 64 69 72 65  |8 to create dire|
00000cb0  63 74 6f 72 69 65 73 20  2d 20 72 2f 77 20 76 65  |ctories - r/w ve|
00000cc0  72 73 69 6f 6e 20 6f 6e  6c 79 0a 0a 20 20 20 20  |rsion only..    |
00000cd0  46 53 45 6e 74 72 79 5f  46 69 6c 65 20 32 35 35  |FSEntry_File 255|
00000ce0  20 74 6f 20 6c 6f 61 64  20 66 69 6c 65 73 0a 0a  | to load files..|
00000cf0  20 20 20 20 46 53 45 6e  74 72 79 5f 4f 70 65 6e  |    FSEntry_Open|
00000d00  20 74 6f 20 70 72 6f 76  69 64 65 20 66 61 63 69  | to provide faci|
00000d10  6c 69 74 69 65 73 20 66  6f 72 20 6f 70 65 6e 69  |lities for openi|
00000d20  6e 67 20 66 69 6c 65 73  20 66 6f 72 20 0a 20 20  |ng files for .  |
00000d30  20 20 72 61 6e 64 6f 6d  20 61 63 63 65 73 73 20  |  random access |
00000d40  69 6e 70 75 74 20 28 61  6e 64 20 6f 75 74 70 75  |input (and outpu|
00000d50  74 20 66 6f 72 20 72 2f  77 20 76 65 72 73 69 6f  |t for r/w versio|
00000d60  6e 29 2e 20 41 72 63 46  53 20 63 6c 61 69 6d 73  |n). ArcFS claims|
00000d70  20 6d 65 6d 6f 72 79 0a  20 20 20 20 66 72 6f 6d  | memory.    from|
00000d80  20 74 68 65 20 52 2e 4d  2e 41 2e 20 74 68 65 20  | the R.M.A. the |
00000d90  73 69 7a 65 20 6f 66 20  74 68 65 20 75 6e 63 6f  |size of the unco|
00000da0  6d 70 72 65 73 73 65 64  20 66 69 6c 65 20 61 6e  |mpressed file an|
00000db0  64 20 74 68 65 20 6c 6f  61 64 73 20 74 68 65 20  |d the loads the |
00000dc0  66 69 6c 65 20 0a 20 20  20 20 69 6e 74 6f 20 74  |file .    into t|
00000dd0  68 69 73 20 63 6c 61 69  6d 65 64 20 6d 65 6d 6f  |his claimed memo|
00000de0  72 79 2e 20 46 6f 72 20  74 68 69 73 20 72 65 61  |ry. For this rea|
00000df0  73 6f 6e 20 69 74 20 69  73 20 70 6f 73 73 69 62  |son it is possib|
00000e00  6c 65 20 74 6f 20 0a 20  20 20 20 67 65 74 20 27  |le to .    get '|
00000e10  4e 6f 20 52 6f 6f 6d 20  69 6e 20 52 4d 41 20 65  |No Room in RMA e|
00000e20  72 72 6f 72 73 27 20 77  68 65 6e 20 6f 70 65 6e  |rrors' when open|
00000e30  69 6e 67 20 6c 61 72 67  65 20 66 69 6c 65 73 2e  |ing large files.|
00000e40  0a 0a 20 20 20 20 46 53  45 6e 74 72 79 5f 47 65  |..    FSEntry_Ge|
00000e50  74 42 79 74 65 73 20 72  65 61 64 73 20 72 65 71  |tBytes reads req|
00000e60  75 69 72 65 64 20 62 79  74 65 73 20 66 72 6f 6d  |uired bytes from|
00000e70  20 6d 65 6d 6f 72 79 20  63 6c 61 69 6d 65 64 20  | memory claimed |
00000e80  0a 20 20 20 20 62 79 20  46 53 45 6e 74 72 79 5f  |.    by FSEntry_|
00000e90  4f 70 65 6e 0a 0a 20 20  20 20 46 53 45 6e 74 72  |Open..    FSEntr|
00000ea0  79 5f 50 75 74 42 79 74  65 73 20 77 72 69 74 65  |y_PutBytes write|
00000eb0  73 20 72 65 71 75 69 72  65 64 20 62 79 74 65 73  |s required bytes|
00000ec0  20 74 6f 20 6d 65 6d 6f  72 79 20 63 6c 61 69 6d  | to memory claim|
00000ed0  65 64 20 62 79 20 46 53  45 6e 74 72 79 5f 4f 70  |ed by FSEntry_Op|
00000ee0  65 6e 0a 20 20 20 20 65  78 74 65 6e 64 69 6e 67  |en.    extending|
00000ef0  20 69 74 20 69 66 20 6e  65 63 65 73 73 61 72 79  | it if necessary|
00000f00  2e 0a 0a 20 20 20 20 46  53 45 6e 74 72 79 5f 41  |...    FSEntry_A|
00000f10  72 67 73 20 33 2c 34 2c  37 2c 38 2c 39 20 69 73  |rgs 3,4,7,8,9 is|
00000f20  20 73 75 70 70 6f 72 74  65 64 20 66 6f 72 20 6f  | supported for o|
00000f30  70 65 72 61 74 69 6f 6e  73 20 6f 6e 20 66 69 6c  |perations on fil|
00000f40  65 73 20 6f 70 65 6e 20  66 6f 72 0a 20 20 20 20  |es open for.    |
00000f50  75 70 64 61 74 65 20 2d  20 72 2f 77 20 76 65 72  |update - r/w ver|
00000f60  73 69 6f 6e 20 6f 6e 6c  79 0a 0a 20 20 20 20 46  |sion only..    F|
00000f70  53 45 6e 74 72 79 5f 43  6c 6f 73 65 20 72 65 6c  |SEntry_Close rel|
00000f80  65 61 73 65 73 20 6d 65  6d 6f 72 79 20 63 6c 61  |eases memory cla|
00000f90  69 6d 65 64 20 62 79 20  46 53 45 6e 74 72 79 5f  |imed by FSEntry_|
00000fa0  4f 70 65 6e 20 28 61 6e  64 20 77 72 69 74 65 73  |Open (and writes|
00000fb0  20 74 68 65 0a 20 20 20  20 64 61 74 61 20 62 61  | the.    data ba|
00000fc0  63 6b 20 74 6f 20 74 68  65 20 66 69 6c 65 20 69  |ck to the file i|
00000fd0  66 20 6f 70 65 6e 20 66  6f 72 20 75 70 64 61 74  |f open for updat|
00000fe0  65 29 0a 0a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |e)..************|
00000ff0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001030  2a 0a 0a 43 61 74 61 6c  6f 67 75 65 20 53 74 6f  |*..Catalogue Sto|
00001040  72 61 67 65 20 69 6e 20  6d 65 6d 6f 72 79 0a 0a  |rage in memory..|
00001050  57 68 65 6e 20 61 6e 20  61 72 63 68 69 76 65 20  |When an archive |
00001060  69 73 20 6f 70 65 6e 65  64 20 74 68 65 20 6e 75  |is opened the nu|
00001070  6d 62 65 72 20 6f 66 20  6f 62 6a 65 63 74 73 20  |mber of objects |
00001080  69 6e 20 74 68 65 20 61  72 63 68 69 76 65 20 69  |in the archive i|
00001090  73 20 0a 63 6f 75 6e 74  65 64 20 61 6e 64 20 61  |s .counted and a|
000010a0  20 62 6c 6f 63 6b 20 6f  66 20 52 2e 4d 2e 41 2e  | block of R.M.A.|
000010b0  2c 20 33 36 20 62 79 74  65 73 20 66 6f 72 20 65  |, 36 bytes for e|
000010c0  61 63 68 20 6f 62 6a 65  63 74 20 69 73 20 63 6c  |ach object is cl|
000010d0  61 69 6d 65 64 20 61 6e  64 20 0a 74 68 65 20 63  |aimed and .the c|
000010e0  61 74 61 6c 6f 67 75 65  20 69 6e 66 6f 72 6d 61  |atalogue informa|
000010f0  74 69 6f 6e 20 69 73 20  72 65 61 64 20 69 6e 74  |tion is read int|
00001100  6f 20 74 68 69 73 20 62  6c 6f 63 6b 2e 0a 0a 2a  |o this block...*|
00001110  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001150  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 0a 0a 43 6f  |************..Co|
00001160  6d 70 72 65 73 73 69 6f  6e 20 66 6f 72 6d 61 74  |mpression format|
00001170  73 0a 0a 54 68 69 73 20  76 65 72 73 69 6f 6e 20  |s..This version |
00001180  6f 66 20 41 72 63 46 53  20 73 75 70 70 6f 72 74  |of ArcFS support|
00001190  73 20 63 72 75 6e 63 68  65 64 2c 20 70 61 63 6b  |s crunched, pack|
000011a0  65 64 2c 20 6e 65 77 20  66 6f 72 6d 61 74 20 73  |ed, new format s|
000011b0  74 6f 72 65 64 0a 6f 62  6a 65 63 74 73 2c 20 73  |tored.objects, s|
000011c0  71 75 61 73 68 65 64 20  61 6e 64 20 63 6f 6d 70  |quashed and comp|
000011d0  72 65 73 73 65 64 20 6f  62 6a 65 63 74 73 2e 20  |ressed objects. |
000011e0  4f 62 6a 65 63 74 73 20  69 6e 20 61 20 66 6f 72  |Objects in a for|
000011f0  6d 61 74 20 20 74 68 61  74 0a 41 72 63 46 53 20  |mat  that.ArcFS |
00001200  63 61 6e 6e 6f 74 20 68  61 6e 64 6c 65 20 77 69  |cannot handle wi|
00001210  6c 6c 20 67 69 76 65 20  27 43 61 6e 27 74 20 68  |ll give 'Can't h|
00001220  61 6e 64 6c 65 20 61 72  63 68 69 76 65 27 20 65  |andle archive' e|
00001230  72 72 6f 72 73 20 77 68  65 6e 20 20 79 6f 75 0a  |rrors when  you.|
00001240  61 74 74 65 6d 70 74 20  74 6f 20 6c 6f 61 64 20  |attempt to load |
00001250  74 68 65 6d 2e 20 41 72  63 68 69 76 65 73 20 63  |them. Archives c|
00001260  6f 6e 74 61 69 6e 69 6e  67 20 6f 6c 64 20 66 6f  |ontaining old fo|
00001270  72 6d 61 74 20 73 74 6f  72 65 64 20 6f 62 6a 65  |rmat stored obje|
00001280  63 74 73 20 63 61 6e 6e  6f 74 0a 62 65 20 6f 70  |cts cannot.be op|
00001290  65 6e 65 64 2e 0a 0a 4d  65 6d 6f 72 79 20 72 65  |ened...Memory re|
000012a0  71 75 69 72 65 6d 65 6e  74 73 0a 0a 2d 2d 2d 2d  |quirements..----|
000012b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000012f0  2d 2d 2d 2d 2d 2d 2d 2d  2d 0a 4e 6f 2e 20 6f 66  |---------.No. of|
00001300  20 62 69 74 73 7c 20 41  72 63 46 53 20 66 6f 72  | bits| ArcFS for|
00001310  6d 61 74 73 20 20 20 20  20 20 20 20 20 20 7c 20  |mats          | |
00001320  53 70 61 72 6b 20 66 6f  72 6d 61 74 73 20 20 20  |Spark formats   |
00001330  20 20 20 20 7c 4d 65 6d  6f 72 79 20 72 65 71 75  |    |Memory requ|
00001340  69 72 65 6d 65 6e 74 0a  63 6f 6d 70 72 65 73 73  |irement.compress|
00001350  69 6f 6e 7c 20 20 20 20  20 20 20 20 20 20 20 20  |ion|            |
00001360  20 20 20 20 20 20 20 20  20 20 20 20 7c 20 20 20  |            |   |
00001370  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001380  20 20 7c 0a 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |  |.------------|
00001390  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000013d0  2d 31 32 20 62 69 74 73  20 20 20 20 7c 20 43 72  |-12 bits    | Cr|
000013e0  75 6e 63 68 20 31 32 2c  20 43 6f 6d 70 72 65 73  |unch 12, Compres|
000013f0  73 20 31 32 20 7c 20 43  72 75 6e 63 68 2c 20 43  |s 12 | Crunch, C|
00001400  6f 6d 70 72 65 73 73 20  31 32 20 7c 4a 75 73 74  |ompress 12 |Just|
00001410  20 6f 76 65 72 20 31 36  4b 0a 31 33 20 62 69 74  | over 16K.13 bit|
00001420  73 20 20 20 20 7c 20 43  72 75 6e 63 68 20 31 33  |s    | Crunch 13|
00001430  2c 20 43 6f 6d 70 72 65  73 73 20 31 33 20 7c 20  |, Compress 13 | |
00001440  53 71 75 61 73 68 2c 20  43 6f 6d 70 72 65 73 73  |Squash, Compress|
00001450  20 31 33 20 7c 4a 75 73  74 20 6f 76 65 72 20 33  | 13 |Just over 3|
00001460  32 4b 0a 31 34 20 62 69  74 73 20 20 20 20 7c 20  |2K.14 bits    | |
00001470  43 72 75 6e 63 68 20 31  34 2c 20 43 6f 6d 70 72  |Crunch 14, Compr|
00001480  65 73 73 20 31 34 20 7c  20 43 6f 6d 70 72 65 73  |ess 14 | Compres|
00001490  73 20 31 34 20 20 20 20  20 20 20 20 20 7c 4a 75  |s 14         |Ju|
000014a0  73 74 20 6f 76 65 72 20  36 34 4b 0a 31 35 20 62  |st over 64K.15 b|
000014b0  69 74 73 20 20 20 20 7c  20 43 72 75 6e 63 68 20  |its    | Crunch |
000014c0  31 35 2c 20 43 6f 6d 70  72 65 73 73 20 31 35 20  |15, Compress 15 |
000014d0  7c 20 43 6f 6d 70 72 65  73 73 20 31 35 20 20 20  || Compress 15   |
000014e0  20 20 20 20 20 20 7c 4a  75 73 74 20 6f 76 65 72  |      |Just over|
000014f0  20 31 32 38 4b 0a 31 36  20 62 69 74 73 20 20 20  | 128K.16 bits   |
00001500  20 7c 20 43 72 75 6e 63  68 20 31 36 2c 20 43 6f  | | Crunch 16, Co|
00001510  6d 70 72 65 73 73 20 31  36 20 7c 20 43 6f 6d 70  |mpress 16 | Comp|
00001520  72 65 73 73 20 31 36 20  20 20 20 20 20 20 20 20  |ress 16         |
00001530  7c 4a 75 73 74 20 6f 76  65 72 20 32 35 36 4b 0a  ||Just over 256K.|
00001540  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00001580  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 54  |-------------..T|
00001590  68 65 20 61 62 6f 76 65  20 74 61 62 6c 65 20 73  |he above table s|
000015a0  68 6f 77 73 20 74 68 65  20 72 65 71 75 69 72 65  |hows the require|
000015b0  6d 65 6e 74 73 20 66 6f  72 20 66 72 65 65 20 6d  |ments for free m|
000015c0  65 6d 6f 72 79 20 69 6e  20 6f 72 64 65 72 20 74  |emory in order t|
000015d0  6f 20 6c 6f 61 64 20 65  61 63 68 0a 6f 66 20 74  |o load each.of t|
000015e0  68 65 20 61 76 61 69 6c  61 62 6c 65 20 66 6f 72  |he available for|
000015f0  6d 61 74 73 2e 20 55 73  69 6e 67 20 31 36 20 62  |mats. Using 16 b|
00001600  69 74 20 63 6f 6d 70 72  65 73 73 69 6f 6e 20 66  |it compression f|
00001610  6f 72 6d 61 74 73 20 63  61 6e 20 63 61 75 73 65  |ormats can cause|
00001620  0a 70 72 6f 62 6c 65 6d  73 20 77 68 65 6e 20 74  |.problems when t|
00001630  72 79 69 6e 67 20 74 6f  20 6c 6f 61 64 20 73 75  |rying to load su|
00001640  63 68 20 66 69 6c 65 73  20 6f 6e 20 61 20 31 4d  |ch files on a 1M|
00001650  62 79 74 65 20 6d 61 63  68 69 6e 65 2e 20 41 72  |byte machine. Ar|
00001660  63 46 53 20 72 65 71 75  69 72 65 73 0a 74 72 69  |cFS requires.tri|
00001670  70 6c 65 20 74 68 65 20  61 62 6f 76 65 20 72 65  |ple the above re|
00001680  71 75 69 72 65 6d 65 6e  74 73 20 77 68 65 6e 20  |quirements when |
00001690  63 6f 6d 70 72 65 73 73  69 6e 67 20 66 69 6c 65  |compressing file|
000016a0  73 2e 0a 0a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |s...************|
000016b0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000016f0  2a 0a 0a 53 69 6d 75 6c  74 61 6e 65 6f 75 73 6c  |*..Simultaneousl|
00001700  79 20 6f 70 65 6e 20 61  72 63 68 69 76 65 73 0a  |y open archives.|
00001710  0a 54 68 69 73 20 76 65  72 73 69 6f 6e 20 6f 66  |.This version of|
00001720  20 41 72 63 46 53 20 73  75 70 70 6f 72 74 73 20  | ArcFS supports |
00001730  75 70 20 74 6f 20 66 69  76 65 20 61 72 63 68 69  |up to five archi|
00001740  76 65 73 20 6f 70 65 6e  20 61 74 20 61 6e 79 20  |ves open at any |
00001750  6f 6e 65 20 74 69 6d 65  2e 0a 45 61 63 68 20 61  |one time..Each a|
00001760  72 63 68 69 76 65 20 6d  75 73 74 20 62 65 20 72  |rchive must be r|
00001770  65 66 65 72 65 64 20 74  6f 20 62 79 20 61 20 75  |efered to by a u|
00001780  6e 69 71 75 65 20 6e 61  6d 65 20 28 75 73 75 61  |nique name (usua|
00001790  6c 6c 79 2c 20 62 75 74  20 6e 6f 74 0a 6e 65 63  |lly, but not.nec|
000017a0  65 73 73 61 72 69 6c 79  2c 20 74 68 65 20 6c 65  |essarily, the le|
000017b0  61 66 20 6e 61 6d 65 20  6f 66 20 74 68 65 20 61  |af name of the a|
000017c0  72 63 68 69 76 65 29 2e  20 54 68 69 73 20 69 73  |rchive). This is|
000017d0  20 6e 61 6d 65 20 69 73  20 70 72 6f 76 69 64 65  | name is provide|
000017e0  64 20 77 68 65 6e 0a 74  68 65 20 61 72 63 68 69  |d when.the archi|
000017f0  76 65 20 69 73 20 6f 70  65 6e 65 64 20 75 73 69  |ve is opened usi|
00001800  6e 67 20 2a 4f 70 65 6e  41 72 63 68 69 76 65 20  |ng *OpenArchive |
00001810  61 6e 64 20 63 61 6e 20  74 68 65 6e 20 62 65 20  |and can then be |
00001820  69 6e 63 6c 75 64 65 64  20 69 6e 20 74 68 65 0a  |included in the.|
00001830  73 70 65 63 69 61 6c 20  66 69 65 6c 64 20 74 6f  |special field to|
00001840  20 72 65 66 65 72 20 74  6f 20 74 68 61 74 20 73  | refer to that s|
00001850  70 65 63 69 66 69 63 20  61 72 63 68 69 76 65 2e  |pecific archive.|
00001860  20 54 68 65 20 41 72 63  46 53 20 46 69 6c 65 72  | The ArcFS Filer|
00001870  20 75 73 65 73 20 74 68  65 0a 6c 65 61 66 20 6e  | uses the.leaf n|
00001880  61 6d 65 20 6f 66 20 74  68 65 20 61 72 63 68 69  |ame of the archi|
00001890  76 65 20 61 73 20 74 68  65 20 6e 61 6d 65 2e 0a  |ve as the name..|
000018a0  0a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |.***************|
000018b0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000018e0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 0a 0a  |**************..|
000018f0  53 63 72 65 65 6e 20 4f  75 74 70 75 74 20 66 6f  |Screen Output fo|
00001900  72 6d 61 74 0a 0a 53 63  72 65 65 6e 20 4f 75 74  |rmat..Screen Out|
00001910  70 75 74 20 66 6f 6c 6c  6f 77 73 20 74 68 61 74  |put follows that|
00001920  20 6f 66 20 46 69 6c 65  63 6f 72 65 20 61 73 20  | of Filecore as |
00001930  63 6c 6f 73 65 6c 79 20  61 73 20 70 6f 73 73 69  |closely as possi|
00001940  62 6c 65 2e 20 2a 46 69  6c 65 49 6e 66 6f 0a 67  |ble. *FileInfo.g|
00001950  69 76 65 73 20 61 20 74  6f 74 61 6c 79 20 64 69  |ives a totaly di|
00001960  66 66 65 72 65 6e 74 20  6f 75 74 70 75 74 20 74  |fferent output t|
00001970  6f 20 74 68 61 74 20 6f  66 20 46 69 6c 65 63 6f  |o that of Fileco|
00001980  72 65 2e 0a 0a 2a 46 69  6c 65 49 6e 66 6f 0a 0a  |re...*FileInfo..|
00001990  2a 46 69 6c 65 49 6e 66  6f 20 64 69 73 70 6c 61  |*FileInfo displa|
000019a0  79 73 20 74 68 65 20 63  6f 6d 70 6c 65 74 65 20  |ys the complete |
000019b0  48 65 61 64 65 72 20 69  6e 66 6f 72 6d 61 74 69  |Header informati|
000019c0  6f 6e 20 68 65 6c 64 20  69 6e 20 6d 65 6d 6f 72  |on held in memor|
000019d0  79 20 61 62 6f 75 74 0a  66 69 6c 65 73 2e 20 54  |y about.files. T|
000019e0  68 65 20 6f 75 74 70 75  74 20 6f 66 20 2a 46 69  |he output of *Fi|
000019f0  6c 65 49 6e 66 6f 20 69  73 20 61 73 20 66 6f 6c  |leInfo is as fol|
00001a00  6c 6f 77 73 3a 0a 0a 4e  61 6d 65 20 20 20 20 20  |lows:..Name     |
00001a10  4c 57 52 2f 77 72 20 66  66 20 66 6f 72 6d 61 74  |LWR/wr ff format|
00001a20  20 62 62 20 6c 6c 6c 6c  6c 6c 6c 6c 20 61 61 61  | bb llllllll aaa|
00001a30  61 61 61 61 61 20 65 65  65 65 65 65 65 65 20 63  |aaaaa eeeeeeee c|
00001a40  63 63 63 63 63 63 63 20  70 70 70 70 70 70 70 70  |ccccccc pppppppp|
00001a50  20 72 72 25 0a 0a 77 68  65 72 65 3a 0a 0a 20 20  | rr%..where:..  |
00001a60  20 20 4e 61 6d 65 20 69  73 20 74 68 65 20 6f 62  |  Name is the ob|
00001a70  6a 65 63 74 20 6c 65 61  66 6e 61 6d 65 0a 0a 20  |ject leafname.. |
00001a80  20 20 20 4c 57 52 2f 77  72 20 61 72 65 20 74 68  |   LWR/wr are th|
00001a90  65 20 6f 62 6a 65 63 74  20 61 74 74 72 69 62 75  |e object attribu|
00001aa0  74 65 73 0a 0a 20 20 20  20 66 66 20 69 73 20 74  |tes..    ff is t|
00001ab0  68 65 20 48 65 61 64 65  72 20 56 65 72 73 69 6f  |he Header Versio|
00001ac0  6e 20 4e 75 6d 62 65 72  20 28 72 65 70 72 65 73  |n Number (repres|
00001ad0  65 6e 74 73 20 74 68 65  20 63 6f 6d 70 72 65 73  |ents the compres|
00001ae0  73 69 6f 6e 20 66 6f 72  6d 61 74 29 0a 0a 20 20  |sion format)..  |
00001af0  20 20 66 6f 72 6d 61 74  20 69 73 20 74 68 65 20  |  format is the |
00001b00  74 79 70 65 20 6f 66 20  64 61 74 61 20 63 6f 6d  |type of data com|
00001b10  70 72 65 73 73 69 6f 6e  20 28 61 6c 77 61 79 73  |pression (always|
00001b20  20 73 74 6f 72 65 20 66  6f 72 20 64 69 72 65 63  | store for direc|
00001b30  74 6f 72 69 65 73 29 0a  0a 20 20 20 20 62 62 20  |tories)..    bb |
00001b40  69 73 20 74 68 65 20 6e  75 6d 62 65 72 20 6f 66  |is the number of|
00001b50  20 62 69 74 73 20 66 6f  72 20 63 72 75 6e 63 68  | bits for crunch|
00001b60  20 6f 72 20 63 6f 6d 70  72 65 73 73 20 66 6f 72  | or compress for|
00001b70  6d 61 74 73 20 28 2d 2d  20 6f 74 68 65 72 77 69  |mats (-- otherwi|
00001b80  73 65 29 0a 0a 20 20 20  20 6c 6c 6c 6c 6c 6c 6c  |se)..    lllllll|
00001b90  6c 20 69 73 20 74 68 65  20 66 75 6c 6c 20 6f 62  |l is the full ob|
00001ba0  6a 65 63 74 20 6c 65 6e  67 74 68 20 28 66 6f 72  |ject length (for|
00001bb0  20 64 69 72 65 63 74 6f  72 69 65 73 20 74 68 69  | directories thi|
00001bc0  73 20 69 73 20 74 68 65  20 74 6f 74 61 6c 0a 20  |s is the total. |
00001bd0  20 20 20 20 20 20 20 20  20 20 20 20 63 6f 6d 70  |            comp|
00001be0  72 65 73 73 65 64 20 73  69 7a 65 20 6f 66 20 61  |ressed size of a|
00001bf0  6c 6c 20 6f 62 6a 65 63  74 73 20 63 6f 6e 74 61  |ll objects conta|
00001c00  69 6e 65 64 20 69 6e 20  69 74 2e 29 0a 0a 20 20  |ined in it.)..  |
00001c10  20 20 61 61 61 61 61 61  61 61 20 69 73 20 74 68  |  aaaaaaaa is th|
00001c20  65 20 6c 6f 61 64 20 61  64 64 72 65 73 73 0a 0a  |e load address..|
00001c30  20 20 20 20 65 65 65 65  65 65 65 65 20 69 73 20  |    eeeeeeee is |
00001c40  74 68 65 20 65 78 65 63  75 74 65 20 61 64 64 72  |the execute addr|
00001c50  65 73 73 0a 0a 20 20 20  20 63 63 63 63 63 63 63  |ess..    ccccccc|
00001c60  63 20 69 73 20 74 68 65  20 63 6f 6d 70 72 65 73  |c is the compres|
00001c70  73 65 64 20 66 69 6c 65  20 73 69 7a 65 2e 49 74  |sed file size.It|
00001c80  20 65 71 75 61 6c 73 20  74 68 65 20 66 75 6c 6c  | equals the full|
00001c90  20 6c 65 6e 67 74 68 20  66 6f 72 20 73 74 6f 72  | length for stor|
00001ca0  65 64 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ed.             |
00001cb0  6f 62 6a 65 63 74 73 2e  0a 0a 20 20 20 20 70 70  |objects...    pp|
00001cc0  70 70 70 70 70 70 20 54  68 69 73 20 64 65 70 65  |pppppp This depe|
00001cd0  6e 64 73 20 6f 6e 20 77  68 65 74 68 65 72 20 74  |nds on whether t|
00001ce0  68 65 20 6f 62 6a 65 63  74 20 69 73 20 61 20 66  |he object is a f|
00001cf0  69 6c 65 20 6f 72 20 64  69 72 65 63 74 6f 72 79  |ile or directory|
00001d00  2e 20 46 6f 72 20 61 0a  20 20 20 20 20 20 20 20  |. For a.        |
00001d10  20 20 20 20 20 66 69 6c  65 20 69 74 20 69 73 20  |     file it is |
00001d20  74 68 65 20 70 6f 73 69  74 69 6f 6e 20 69 6e 20  |the position in |
00001d30  74 68 65 20 61 72 63 68  69 76 65 20 66 69 6c 65  |the archive file|
00001d40  20 61 74 20 77 68 69 63  68 20 74 68 65 20 66 69  | at which the fi|
00001d50  6c 65 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |le.             |
00001d60  64 61 74 61 20 62 65 67  69 6e 73 2e 20 46 6f 72  |data begins. For|
00001d70  20 64 69 72 65 63 74 6f  72 69 65 73 20 74 68 69  | directories thi|
00001d80  73 20 69 73 20 74 68 65  20 6d 65 6d 6f 72 79 20  |s is the memory |
00001d90  61 64 64 72 65 73 73 20  61 74 20 77 68 69 63 68  |address at which|
00001da0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 74 68  |.             th|
00001db0  65 20 6e 65 78 74 20 68  65 61 64 65 72 20 69 6e  |e next header in|
00001dc0  20 74 68 65 20 70 61 72  65 6e 74 20 64 69 72 65  | the parent dire|
00001dd0  63 74 6f 72 79 20 65 78  69 73 74 73 20 28 6e 6f  |ctory exists (no|
00001de0  74 20 76 65 72 79 20 75  73 65 66 75 6c 2c 0a 20  |t very useful,. |
00001df0  20 20 20 20 20 20 20 20  20 20 20 20 62 75 74 20  |            but |
00001e00  75 73 65 64 20 69 6e 74  65 72 6e 61 6c 6c 79 20  |used internally |
00001e10  62 79 20 41 72 63 46 53  29 2e 0a 0a 20 20 20 20  |by ArcFS)...    |
00001e20  20 20 20 20 20 72 72 25  20 54 68 69 73 20 69 73  |     rr% This is|
00001e30  20 74 68 65 20 63 6f 6d  70 72 65 73 73 69 6f 6e  | the compression|
00001e40  20 72 61 74 69 6f 2c 20  69 2e 65 2e 20 74 68 65  | ratio, i.e. the|
00001e50  20 63 6f 6d 70 72 65 73  73 65 64 20 66 69 6c 65  | compressed file|
00001e60  20 73 69 7a 65 0a 20 20  20 20 20 20 20 20 20 20  | size.          |
00001e70  20 20 20 65 78 70 72 65  73 73 65 64 20 61 73 20  |   expressed as |
00001e80  61 20 70 65 72 63 65 6e  74 61 67 65 20 6f 66 20  |a percentage of |
00001e90  74 68 65 20 6f 72 69 67  69 6e 61 6c 2e 0a 0a 2a  |the original...*|
00001ea0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001ee0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 0a 0a 46 69  |************..Fi|
00001ef0  6c 65 20 41 74 74 72 69  62 75 74 65 73 0a 0a 54  |le Attributes..T|
00001f00  68 65 20 43 52 43 20 69  73 20 73 74 6f 72 65 64  |he CRC is stored|
00001f10  20 69 6e 20 74 68 65 20  74 6f 70 20 31 36 20 62  | in the top 16 b|
00001f20  69 74 73 20 61 6e 64 20  74 68 65 20 6e 6f 2e 20  |its and the no. |
00001f30  6f 66 20 62 69 74 73 20  63 6f 6d 70 72 65 73 73  |of bits compress|
00001f40  69 6f 6e 20 28 77 68 65  72 65 0a 61 70 70 72 6f  |ion (where.appro|
00001f50  70 72 69 61 74 65 29 20  69 73 20 73 74 6f 72 65  |priate) is store|
00001f60  64 20 69 6e 20 74 68 65  20 6e 65 78 74 20 38 20  |d in the next 8 |
00001f70  62 69 74 73 2e 20 46 69  6c 65 20 61 63 63 65 73  |bits. File acces|
00001f80  73 20 72 69 67 68 74 73  20 61 72 65 20 73 74 6f  |s rights are sto|
00001f90  72 65 64 20 69 6e 0a 74  68 65 20 62 6f 74 74 6f  |red in.the botto|
00001fa0  6d 20 38 20 62 69 74 73  2e 20 28 4e 2e 42 2e 20  |m 8 bits. (N.B. |
00001fb0  74 68 65 20 74 6f 70 20  32 34 20 62 69 74 73 20  |the top 24 bits |
00001fc0  77 65 72 65 20 75 73 65  64 20 74 6f 20 73 74 6f  |were used to sto|
00001fd0  72 65 20 74 68 65 20 63  6f 6d 70 72 65 73 73 65  |re the compresse|
00001fe0  64 0a 66 69 6c 65 20 6c  65 6e 67 74 68 20 69 6e  |d.file length in|
00001ff0  20 70 72 65 76 69 6f 75  73 20 76 65 72 73 69 6f  | previous versio|
00002000  6e 73 2e 29 0a 0a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |ns.)..**********|
00002010  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002050  2a 2a 2a 0a 0a 55 73 65  72 20 52 6f 6f 74 20 44  |***..User Root D|
00002060  69 72 65 63 74 6f 72 69  65 73 20 28 55 2e 52 2e  |irectories (U.R.|
00002070  44 2e 27 73 29 0a 0a 4e  6f 77 20 73 75 70 70 6f  |D.'s)..Now suppo|
00002080  72 74 65 64 2e 20 55 73  65 20 2a 55 52 44 20 74  |rted. Use *URD t|
00002090  6f 20 73 65 6c 65 63 74  20 74 68 65 20 75 73 65  |o select the use|
000020a0  72 20 72 6f 6f 74 20 28  26 29 20 64 69 72 65 63  |r root (&) direc|
000020b0  74 6f 72 79 2e 20 49 66  20 74 68 65 20 55 52 44  |tory. If the URD|
000020c0  20 69 73 20 22 75 6e 73  65 74 22 20 74 68 65 6e  | is "unset" then|
000020d0  20 74 68 65 20 72 6f 6f  74 20 28 24 29 20 64 69  | the root ($) di|
000020e0  72 65 63 74 6f 72 79 20  69 73 20 75 73 65 64 20  |rectory is used |
000020f0  69 6e 73 74 65 61 64 2e  0a 0a 54 68 65 20 70 72  |instead...The pr|
00002100  65 76 69 6f 75 73 6c 79  20 73 65 6c 65 63 74 65  |eviously selecte|
00002110  64 20 64 69 72 65 63 74  6f 72 79 20 28 50 2e 53  |d directory (P.S|
00002120  2e 44 2e 29 0a 0a 4e 6f  77 20 73 75 70 70 6f 72  |.D.)..Now suppor|
00002130  74 65 64 2e 20 57 68 65  6e 20 61 20 6e 65 77 20  |ted. When a new |
00002140  64 69 72 65 63 74 6f 72  79 20 73 65 6c 65 63 74  |directory select|
00002150  69 6f 6e 20 69 73 20 6d  61 64 65 2c 20 74 68 65  |ion is made, the|
00002160  20 6f 6c 64 20 6f 6e 65  20 62 65 63 6f 6d 65 73  | old one becomes|
00002170  0a 74 68 65 20 50 2e 53  2e 44 2e 20 55 73 65 20  |.the P.S.D. Use |
00002180  2a 42 61 63 6b 20 74 6f  20 73 77 61 70 20 74 68  |*Back to swap th|
00002190  65 20 43 2e 53 2e 44 2e  20 61 6e 64 20 50 2e 53  |e C.S.D. and P.S|
000021a0  2e 44 2e 20 54 68 65 20  50 2e 53 2e 44 2e 20 63  |.D. The P.S.D. c|
000021b0  61 6e 20 62 65 0a 73 70  65 63 69 66 69 65 64 20  |an be.specified |
000021c0  61 74 20 74 68 65 20 62  65 67 69 6e 69 6e 67 20  |at the begining |
000021d0  6f 66 20 61 20 70 61 74  68 6e 61 6d 65 20 61 73  |of a pathname as|
000021e0  20 5c 2e 20 49 66 20 74  68 65 20 50 53 44 20 69  | \. If the PSD i|
000021f0  73 20 22 75 6e 73 65 74  22 20 74 68 65 6e 20 74  |s "unset" then t|
00002200  68 65 20 43 53 44 20 69  73 20 75 73 65 64 20 69  |he CSD is used i|
00002210  6e 73 74 65 61 64 2e 0a  0a 41 75 74 6f 6d 61 74  |nstead...Automat|
00002220  69 63 20 6c 69 62 72 61  72 79 20 73 65 6c 65 63  |ic library selec|
00002230  74 69 6f 6e 0a 0a 49 66  20 41 72 63 46 53 20 66  |tion..If ArcFS f|
00002240  69 6e 64 73 20 61 20 64  69 72 65 63 74 6f 72 79  |inds a directory|
00002250  20 73 74 61 72 74 69 6e  67 20 77 69 74 68 20 74  | starting with t|
00002260  68 65 20 6c 65 74 74 65  72 73 20 27 4c 69 62 27  |he letters 'Lib'|
00002270  20 69 6e 20 74 68 65 20  72 6f 6f 74 0a 64 69 72  | in the root.dir|
00002280  65 63 74 6f 72 79 20 6f  66 20 61 6e 20 61 72 63  |ectory of an arc|
00002290  68 69 76 65 20 77 68 65  6e 20 69 74 20 69 73 20  |hive when it is |
000022a0  6f 70 65 6e 20 69 74 20  73 65 6c 65 63 74 73 20  |open it selects |
000022b0  74 68 69 73 20 61 73 20  74 68 65 20 6c 69 62 72  |this as the libr|
000022c0  61 72 79 0a 64 69 72 65  63 74 6f 72 79 2e 0a 0a  |ary.directory...|
000022d0  55 6e 73 65 74 20 44 69  72 65 63 74 6f 72 79 20  |Unset Directory |
000022e0  63 6f 6e 74 65 78 74 73  0a 0a 49 66 20 74 68 65  |contexts..If the|
000022f0  20 50 53 44 20 6f 72 20  6c 69 62 72 61 72 79 20  | PSD or library |
00002300  61 72 65 20 75 73 65 64  20 62 75 74 20 61 72 65  |are used but are|
00002310  20 22 75 6e 73 65 74 22  20 74 68 65 6e 20 74 68  | "unset" then th|
00002320  65 20 43 53 44 20 69 73  20 75 73 65 64 20 69 6e  |e CSD is used in|
00002330  73 74 65 61 64 2e 0a 49  66 20 74 68 65 20 55 52  |stead..If the UR|
00002340  44 20 69 73 20 22 75 6e  73 65 74 22 20 74 68 65  |D is "unset" the|
00002350  6e 20 74 68 65 20 72 6f  6f 74 20 69 73 20 75 73  |n the root is us|
00002360  65 64 20 69 6e 73 74 65  61 64 2e 20 49 66 20 74  |ed instead. If t|
00002370  68 65 20 43 53 44 20 69  73 20 22 75 6e 73 65 74  |he CSD is "unset|
00002380  22 0a 61 6e 64 20 74 68  65 20 75 73 65 72 20 74  |".and the user t|
00002390  72 69 65 73 20 74 6f 20  70 65 72 66 6f 72 6d 20  |ries to perform |
000023a0  6f 70 65 72 61 74 69 6f  6e 73 20 6f 6e 20 74 68  |operations on th|
000023b0  65 20 63 75 72 72 65 6e  74 20 64 69 72 65 63 74  |e current direct|
000023c0  6f 72 79 20 28 6f 72 0a  63 75 72 72 65 6e 74 20  |ory (or.current |
000023d0  61 72 63 68 69 76 65 29  20 74 68 65 20 61 6e 20  |archive) the an |
000023e0  65 72 72 6f 72 20 77 69  6c 6c 20 62 65 20 67 65  |error will be ge|
000023f0  6e 65 72 61 74 65 64 2e  0a 0a 49 66 20 74 68 65  |nerated...If the|
00002400  20 43 53 44 20 69 73 20  22 75 6e 73 65 74 22 20  | CSD is "unset" |
00002410  61 6e 64 20 61 6e 20 61  72 63 68 69 76 65 20 69  |and an archive i|
00002420  73 20 6f 70 65 6e 65 64  2c 20 74 68 65 20 43 53  |s opened, the CS|
00002430  44 20 77 69 6c 6c 20 61  75 74 6f 6d 61 74 69 63  |D will automatic|
00002440  61 6c 6c 79 0a 62 65 20  73 65 74 20 74 68 65 20  |ally.be set the |
00002450  72 6f 6f 74 20 64 69 72  65 63 74 6f 72 79 20 6f  |root directory o|
00002460  66 20 74 68 65 20 6e 65  77 20 61 72 63 68 69 76  |f the new archiv|
00002470  65 2e 0a 0a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |e...************|
00002480  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000024c0  2a 0a 0a 52 61 6e 64 6f  6d 20 61 63 63 65 73 73  |*..Random access|
000024d0  20 66 69 6c 69 6e 67 0a  0a 46 69 6c 65 73 20 61  | filing..Files a|
000024e0  72 65 20 64 65 63 6f 6d  70 72 65 73 73 65 64 20  |re decompressed |
000024f0  61 6e 64 20 68 65 6c 64  20 69 6e 20 52 2e 4d 2e  |and held in R.M.|
00002500  41 2e 20 77 68 69 6c 73  74 20 74 68 65 79 20 61  |A. whilst they a|
00002510  72 65 20 6f 70 65 6e 2e  20 59 6f 75 20 20 73 68  |re open. You  sh|
00002520  6f 75 6c 64 0a 6e 6f 74  65 20 74 68 61 74 20 77  |ould.note that w|
00002530  68 65 6e 20 73 70 72 69  74 65 20 66 69 6c 65 73  |hen sprite files|
00002540  20 61 72 65 20 6c 6f 61  64 65 64 20 74 68 65 79  | are loaded they|
00002550  20 61 72 65 20 6f 70 65  6e 65 64 20 66 6f 72 20  | are opened for |
00002560  20 72 61 6e 64 6f 6d 20  61 63 63 65 73 73 0a 69  | random access.i|
00002570  6e 70 75 74 20 61 6e 64  20 74 68 65 72 65 66 6f  |nput and therefo|
00002580  72 65 20 74 68 65 72 65  20 6e 65 65 64 73 20 74  |re there needs t|
00002590  6f 20 62 65 20 65 6e 6f  75 67 68 20 66 72 65 65  |o be enough free|
000025a0  20 6d 65 6d 6f 72 79 20  20 61 76 61 69 6c 61 62  | memory  availab|
000025b0  6c 65 20 77 68 65 6e 20  74 68 65 0a 73 70 72 69  |le when the.spri|
000025c0  74 65 73 20 61 72 65 20  6c 6f 61 64 65 64 2e 20  |tes are loaded. |
000025d0  54 68 69 73 20 6d 61 79  20 63 61 75 73 65 20 70  |This may cause p|
000025e0  72 6f 62 6c 65 6d 73 20  77 68 65 6e 20 20 6c 61  |roblems when  la|
000025f0  72 67 65 20 73 70 72 69  74 65 20 66 69 6c 65 73  |rge sprite files|
00002600  20 61 72 65 0a 6c 6f 61  64 65 64 20 69 6e 74 6f  | are.loaded into|
00002610  20 61 20 31 20 4d 62 79  74 65 20 6d 61 63 68 69  | a 1 Mbyte machi|
00002620  6e 65 20 28 61 6e 79 6f  6e 65 20 77 69 74 68 20  |ne (anyone with |
00002630  61 6e 20 20 75 6e 65 78  70 61 6e 64 65 64 20 41  |an  unexpanded A|
00002640  33 30 35 20 2d 20 64 6f  6e 27 74 0a 62 6f 74 68  |305 - don't.both|
00002650  65 72 21 29 20 62 75 74  20 49 20 63 61 6e 6e 6f  |er!) but I canno|
00002660  74 20 72 65 61 6c 6c 79  20 73 75 67 67 65 73 74  |t really suggest|
00002670  20 61 6e 79 74 68 69 6e  67 20 20 73 68 6f 72 74  | anything  short|
00002680  20 6f 66 20 75 70 67 72  61 64 69 6e 67 20 74 6f  | of upgrading to|
00002690  20 32 0a 4d 62 79 74 65  73 20 28 6f 74 68 65 72  | 2.Mbytes (other|
000026a0  20 74 68 61 6e 20 6d 61  6b 69 6e 67 20 73 75 72  | than making sur|
000026b0  65 20 74 68 61 74 20 61  6c 6c 20 74 68 65 20 20  |e that all the  |
000026c0  70 6f 73 73 69 62 6c 65  20 66 72 65 65 20 6d 65  |possible free me|
000026d0  6d 6f 72 79 20 69 73 0a  61 76 61 69 6c 61 62 6c  |mory is.availabl|
000026e0  65 20 74 6f 20 74 68 65  20 52 2e 4d 2e 41 2e 29  |e to the R.M.A.)|
000026f0  2e 20 57 68 65 6e 20 49  20 62 6f 75 67 68 74 20  |. When I bought |
00002700  6d 79 20 32 4d 62 79 74  65 20 52 41 4d 20 75 70  |my 2Mbyte RAM up|
00002710  67 72 61 64 65 20 69 6e  20 44 65 63 2e 20 31 39  |grade in Dec. 19|
00002720  38 39 0a 69 74 20 63 6f  73 74 20 a3 31 35 30 20  |89.it cost .150 |
00002730  2b 56 41 54 2e 20 4e 6f  77 20 69 74 20 63 61 6e  |+VAT. Now it can|
00002740  20 63 6f 73 74 20 61 73  20 6c 69 74 74 6c 65 20  | cost as little |
00002750  61 73 20 61 20 74 68 69  72 64 20 6f 66 20 74 68  |as a third of th|
00002760  61 74 20 70 72 69 63 65  20 61 6e 64 20 69 73 0a  |at price and is.|
00002770  73 74 69 6c 6c 20 66 61  6c 6c 69 6e 67 2e 20 49  |still falling. I|
00002780  20 68 61 76 65 20 66 6f  75 6e 64 20 69 74 20 76  | have found it v|
00002790  65 72 79 20 75 73 65 66  75 6c 20 61 6e 64 20 63  |ery useful and c|
000027a0  61 6e 20 72 65 63 6f 6d  6d 65 6e 64 20 69 74 20  |an recommend it |
000027b0  74 6f 20 61 6e 79 20 75  73 65 72 73 0a 6f 66 20  |to any users.of |
000027c0  31 20 4d 62 79 74 65 20  41 33 30 30 30 27 73 20  |1 Mbyte A3000's |
000027d0  61 6e 64 20 41 34 31 30  27 73 20 77 68 6f 20 75  |and A410's who u|
000027e0  73 65 20 74 68 65 69 72  20 63 6f 6d 70 75 74 65  |se their compute|
000027f0  72 73 20 66 6f 72 20 6d  6f 72 65 20 74 68 61 6e  |rs for more than|
00002800  20 6a 75 73 74 0a 61 72  63 61 64 65 20 67 61 6d  | just.arcade gam|
00002810  65 73 2e 20 4f 74 68 65  72 20 66 69 6c 65 73 20  |es. Other files |
00002820  73 75 63 68 20 61 73 20  20 45 78 65 63 20 61 6e  |such as  Exec an|
00002830  64 20 4f 62 65 79 20 66  69 6c 65 73 20 61 72 65  |d Obey files are|
00002840  20 61 6c 73 6f 20 6f 70  65 6e 65 64 20 66 6f 72  | also opened for|
00002850  0a 72 61 6e 64 6f 6d 20  61 63 63 65 73 73 20 69  |.random access i|
00002860  6e 70 75 74 20 62 75 74  20 74 68 65 73 65 20 20  |nput but these  |
00002870  61 72 65 20 75 73 75 61  6c 6c 79 20 73 68 6f 72  |are usually shor|
00002880  74 2e 0a 41 20 6d 61 78  69 6d 75 6d 20 6f 66 20  |t..A maximum of |
00002890  66 69 76 65 20 66 69 6c  65 73 20 6d 61 79 20 62  |five files may b|
000028a0  65 20 6f 70 65 6e 20 66  6f 72 20 75 70 64 61 74  |e open for updat|
000028b0  65 20 77 69 74 68 20 74  68 65 20 72 2f 77 20 76  |e with the r/w v|
000028c0  65 72 73 69 6f 6e 20 28  42 41 53 49 43 27 73 0a  |ersion (BASIC's.|
000028d0  4f 50 45 4e 55 50 20 61  6e 64 20 4f 50 45 4e 4f  |OPENUP and OPENO|
000028e0  55 54 29 20 62 75 74 20  74 68 65 72 65 20 69 73  |UT) but there is|
000028f0  20 6e 6f 20 6c 69 6d 69  74 20 74 6f 20 74 68 65  | no limit to the|
00002900  20 6e 75 6d 62 65 72 20  6f 66 20 66 69 6c 65 73  | number of files|
00002910  20 6f 70 65 6e 20 66 6f  72 0a 69 6e 70 75 74 20  | open for.input |
00002920  6f 6e 6c 79 20 28 42 41  53 49 43 27 73 20 4f 50  |only (BASIC's OP|
00002930  45 4e 49 4e 29 2e 0a 0a  2a 2a 2a 2a 2a 2a 2a 2a  |ENIN)...********|
00002940  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002980  2a 2a 2a 2a 2a 0a 0a 55  73 65 20 77 69 74 68 20  |*****..Use with |
00002990  36 35 48 6f 73 74 20 61  6e 64 20 36 35 54 75 62  |65Host and 65Tub|
000029a0  65 0a 0a 41 72 63 46 53  20 63 61 6e 20 65 61 73  |e..ArcFS can eas|
000029b0  69 6c 79 20 62 65 20 75  73 65 64 20 77 69 74 68  |ily be used with|
000029c0  20 36 35 48 6f 73 74 20  61 6e 64 20 36 35 54 75  | 65Host and 65Tu|
000029d0  62 65 2e 20 36 35 48 6f  73 74 20 75 73 65 72 73  |be. 65Host users|
000029e0  20 6d 75 73 74 20 6f 70  65 6e 20 74 68 65 0a 72  | must open the.r|
000029f0  65 71 75 69 72 65 64 20  61 72 63 68 69 76 65 28  |equired archive(|
00002a00  73 29 20 62 65 66 6f 72  65 20 65 6e 74 65 72 69  |s) before enteri|
00002a10  6e 67 20 74 68 65 20 65  6d 75 6c 61 74 6f 72 20  |ng the emulator |
00002a20  75 6e 64 65 72 20 77 68  69 63 68 20 41 72 63 46  |under which ArcF|
00002a30  53 20 69 73 0a 73 65 6c  65 63 74 65 64 20 62 79  |S is.selected by|
00002a40  3a 0a 0a 20 20 20 20 2a  44 69 72 20 41 72 63 46  |:..    *Dir ArcF|
00002a50  53 3a 0a 0a 44 46 53 20  65 6d 75 6c 61 74 69 6f  |S:..DFS emulatio|
00002a60  6e 73 20 6d 61 79 20 61  6c 73 6f 20 62 65 20 73  |ns may also be s|
00002a70  65 74 20 75 70 20 69 6e  20 61 72 63 68 69 76 65  |et up in archive|
00002a80  73 20 28 61 73 20 6f 6e  20 41 44 46 53 29 20 61  |s (as on ADFS) a|
00002a90  6e 64 20 75 73 65 64 0a  75 6e 64 65 72 20 36 35  |nd used.under 65|
00002aa0  48 6f 73 74 0a 0a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |Host..**********|
00002ab0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002af0  2a 2a 2a 0a 0a 50 43 20  46 6f 72 6d 61 74 0a 0a  |***..PC Format..|
00002b00  46 69 6c 65 73 20 61 72  63 68 69 76 65 64 20 75  |Files archived u|
00002b10  73 69 6e 67 20 50 43 20  46 6f 72 6d 61 74 20 69  |sing PC Format i|
00002b20  6e 20 53 70 61 72 6b 20  6f 72 20 61 72 63 68 69  |n Spark or archi|
00002b30  76 65 64 20 75 73 69 6e  67 20 53 45 41 20 61 72  |ved using SEA ar|
00002b40  63 20 6f 72 20 50 4b 20  61 72 63 0a 6f 6e 20 61  |c or PK arc.on a|
00002b50  20 50 43 20 61 6c 6c 20  68 61 76 65 20 66 69 6c  | PC all have fil|
00002b60  65 20 74 79 70 65 20 26  31 31 31 2e 0a 0a 2a 2a  |e type &111...**|
00002b70  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002bb0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 0a 0a 44 69 72  |***********..Dir|
00002bc0  65 63 74 6f 72 79 20 6c  65 76 65 6c 73 0a 0a 55  |ectory levels..U|
00002bd0  70 20 74 6f 20 36 34 20  64 69 72 65 63 74 6f 72  |p to 64 director|
00002be0  79 20 6c 65 76 65 6c 73  20 61 72 65 20 73 75 70  |y levels are sup|
00002bf0  70 6f 72 74 65 64 2e 20  49 6e 20 74 68 65 20 75  |ported. In the u|
00002c00  6e 6c 69 6b 65 6c 79 20  65 76 65 6e 74 20 74 68  |nlikely event th|
00002c10  61 74 20 6d 6f 72 65 0a  65 78 69 73 74 20 69 6e  |at more.exist in|
00002c20  20 61 6e 20 61 72 63 68  69 76 65 20 66 75 72 74  | an archive furt|
00002c30  68 65 72 20 73 75 62 64  69 72 65 63 74 6f 72 69  |her subdirectori|
00002c40  65 73 20 61 72 65 20 73  68 6f 77 6e 20 61 73 20  |es are shown as |
00002c50  61 72 63 68 69 76 65 73  2e 20 54 68 69 73 20 6c  |archives. This l|
00002c60  69 6d 69 74 20 64 6f 65  73 20 6e 6f 74 20 61 70  |imit does not ap|
00002c70  70 6c 79 20 74 6f 20 6e  65 77 20 66 6f 72 6d 61  |ply to new forma|
00002c80  74 20 61 72 63 68 69 76  65 73 2e 0a 0a 2a 2a 2a  |t archives...***|
00002c90  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00002cd0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 0a 0a 43 6f 6d 6d  |**********..Comm|
00002ce0  61 6e 64 73 20 70 72 6f  76 69 64 65 64 3a 0a 0a  |ands provided:..|
00002cf0  20 20 2a 41 72 63 46 53  20 20 20 20 20 20 20 20  |  *ArcFS        |
00002d00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2d  |               -|
00002d10  20 73 65 6c 65 63 74 73  20 41 72 63 46 53 20 61  | selects ArcFS a|
00002d20  73 20 74 68 65 20 63 75  72 72 65 6e 74 20 66 69  |s the current fi|
00002d30  6c 69 6e 67 20 73 79 73  74 65 6d 0a 20 20 2a 4f  |ling system.  *O|
00002d40  70 65 6e 41 72 63 68 69  76 65 20 3c 4f 62 6a 65  |penArchive <Obje|
00002d50  63 74 3e 20 3c 6e 61 6d  65 3e 20 2d 20 4f 70 65  |ct> <name> - Ope|
00002d60  6e 73 20 61 6e 20 61 72  63 68 69 76 65 20 66 6f  |ns an archive fo|
00002d70  72 20 66 69 6c 65 20 6f  70 65 72 61 74 69 6f 6e  |r file operation|
00002d80  73 0a 20 20 2a 43 6c 6f  73 65 41 72 63 68 69 76  |s.  *CloseArchiv|
00002d90  65 20 5b 3c 6e 61 6d 65  3e 5d 20 20 20 20 20 20  |e [<name>]      |
00002da0  20 2d 20 43 6c 6f 73 65  73 20 74 68 65 20 6e 61  | - Closes the na|
00002db0  6d 65 64 20 28 6f 72 20  61 6e 79 29 20 6f 70 65  |med (or any) ope|
00002dc0  6e 20 61 72 63 68 69 76  65 28 73 29 0a 20 20 2a  |n archive(s).  *|
00002dd0  43 72 65 61 74 65 41 72  63 68 69 76 65 20 3c 4f  |CreateArchive <O|
00002de0  62 6a 65 63 74 3e 20 20  20 20 20 20 2d 20 43 72  |bject>      - Cr|
00002df0  65 61 74 65 73 20 61 6e  20 61 72 63 68 69 76 65  |eates an archive|
00002e00  20 28 72 2f 77 20 76 65  72 73 69 6f 6e 20 6f 6e  | (r/w version on|
00002e10  6c 79 29 0a 0a 46 69 6c  69 6e 67 20 73 79 73 74  |ly)..Filing syst|
00002e20  65 6d 20 63 6f 6d 6d 61  6e 64 73 3a 0a 0a 20 20  |em commands:..  |
00002e30  2a 42 61 63 6b 20 20 20  20 20 20 20 20 20 20 20  |*Back           |
00002e40  20 20 20 20 20 20 20 20  20 20 20 20 20 2d 20 73  |             - s|
00002e50  77 61 70 73 20 74 68 65  20 63 75 72 72 65 6e 74  |waps the current|
00002e60  6c 79 20 61 6e 64 20 70  72 65 76 69 6f 75 73 6c  |ly and previousl|
00002e70  79 20 73 65 6c 65 63 74  65 64 20 20 20 20 20 20  |y selected      |
00002e80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002e90  20 20 20 20 20 20 20 20  20 20 20 20 64 69 72 65  |            dire|
00002ea0  63 74 6f 72 69 65 73 20  28 43 53 44 20 61 6e 64  |ctories (CSD and|
00002eb0  20 50 53 44 29 0a 20 20  2a 55 52 44 20 20 20 20  | PSD).  *URD    |
00002ec0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002ed0  20 20 20 20 20 2d 20 73  65 6c 65 63 74 73 20 74  |     - selects t|
00002ee0  68 65 20 75 73 65 72 20  72 6f 6f 74 20 64 69 72  |he user root dir|
00002ef0  65 63 74 6f 72 79 20 28  55 52 44 29 0a 20 20 2a  |ectory (URD).  *|
00002f00  47 61 72 62 6c 65 20 3c  50 61 73 73 57 6f 72 64  |Garble <PassWord|
00002f10  3e 20 20 20 20 20 20 20  20 20 20 20 2d 20 4c 6f  |>           - Lo|
00002f20  61 64 73 20 66 69 6c 65  73 20 67 61 72 62 6c 65  |ads files garble|
00002f30  64 20 77 69 74 68 20 61  20 70 61 73 73 77 6f 72  |d with a passwor|
00002f40  64 0a 20 20 2a 4e 6f 45  6e 63 72 79 70 74 69 6f  |d.  *NoEncryptio|
00002f50  6e 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |n               |
00002f60  20 2d 20 4c 6f 61 64 73  20 66 69 6c 65 73 20 77  | - Loads files w|
00002f70  69 74 68 20 6e 6f 20 65  6e 63 72 79 70 74 69 6f  |ith no encryptio|
00002f80  6e 0a 46 6f 72 20 72 2f  77 20 76 65 72 73 69 6f  |n.For r/w versio|
00002f90  6e 20 6f 6e 6c 79 3a 0a  20 20 2a 43 6f 6d 70 61  |n only:.  *Compa|
00002fa0  63 74 20 5b 3c 61 72 63  68 69 76 65 20 6e 61 6d  |ct [<archive nam|
00002fb0  65 2e 3e 5d 20 20 20 2d  20 52 65 6d 6f 76 65 73  |e.>]   - Removes|
00002fc0  20 67 61 70 73 20 6c 65  66 74 20 62 79 20 64 65  | gaps left by de|
00002fd0  6c 65 74 69 6f 6e 73 20  2f 20 6f 76 65 72 77 72  |letions / overwr|
00002fe0  69 74 65 73 0a 20 20 2a  53 74 6f 72 65 20 20 20  |ites.  *Store   |
00002ff0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003000  20 20 20 20 2d 20 53 65  74 73 20 6e 6f 20 63 6f  |    - Sets no co|
00003010  6d 70 72 65 73 73 69 6f  6e 0a 20 20 2a 50 61 63  |mpression.  *Pac|
00003020  6b 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |k               |
00003030  20 20 20 20 20 20 20 20  20 2d 20 53 65 74 73 20  |         - Sets |
00003040  63 6f 6d 70 72 65 73 73  69 6f 6e 20 6f 66 20 72  |compression of r|
00003050  70 74 64 2e 20 63 68 61  72 73 2e 20 6f 6e 6c 79  |ptd. chars. only|
00003060  0a 20 20 2a 43 72 75 6e  63 68 20 5b 3c 6e 6f 2e  |.  *Crunch [<no.|
00003070  20 62 69 74 73 3e 5d 20  20 20 20 20 20 20 20 20  | bits>]         |
00003080  2d 20 53 65 74 73 20 66  69 6c 65 20 63 72 75 6e  |- Sets file crun|
00003090  63 68 69 6e 67 20 77 69  74 68 20 6e 6f 2e 20 62  |ching with no. b|
000030a0  69 74 73 20 28 6f 72 20  31 32 29 0a 20 20 2a 43  |its (or 12).  *C|
000030b0  6f 6d 70 72 65 73 73 20  5b 3c 6e 6f 2e 20 62 69  |ompress [<no. bi|
000030c0  74 73 3e 5d 20 20 20 20  20 20 20 2d 20 53 65 74  |ts>]       - Set|
000030d0  73 20 66 69 6c 65 20 63  6f 6d 70 72 65 73 73 20  |s file compress |
000030e0  77 69 74 68 20 6e 6f 2e  20 62 69 74 73 20 28 6f  |with no. bits (o|
000030f0  72 20 31 32 29 0a 0a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |r 12)..*********|
00003100  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00003140  2a 2a 2a 2a 0a 0a 46 69  6c 65 20 65 6e 63 72 79  |****..File encry|
00003150  70 74 69 6f 6e 0a 0a 54  68 69 73 20 76 65 72 73  |ption..This vers|
00003160  69 6f 6e 20 73 75 70 70  6f 72 74 73 20 67 61 72  |ion supports gar|
00003170  62 6c 65 64 20 66 69 6c  65 73 2e 20 49 6e 63 6f  |bled files. Inco|
00003180  72 72 65 63 74 20 70 61  73 73 77 6f 72 64 73 2c  |rrect passwords,|
00003190  20 75 73 65 20 6f 66 20  47 61 72 62 6c 65 20 66  | use of Garble f|
000031a0  6f 72 0a 66 69 6c 65 73  20 77 69 74 68 20 6e 6f  |or.files with no|
000031b0  20 65 6e 63 72 79 70 74  69 6f 6e 20 6f 72 20 74  | encryption or t|
000031c0  72 79 69 6e 67 20 74 6f  20 6c 6f 61 64 20 67 61  |rying to load ga|
000031d0  72 62 6c 65 64 20 66 69  6c 65 73 20 68 61 76 69  |rbled files havi|
000031e0  6e 67 20 73 65 74 20 41  72 63 46 53 20 74 6f 0a  |ng set ArcFS to.|
000031f0  6c 6f 61 64 20 66 69 6c  65 73 20 77 69 74 68 20  |load files with |
00003200  6e 6f 20 65 6e 63 72 79  70 74 69 6f 6e 20 77 69  |no encryption wi|
00003210  6c 6c 20 72 65 73 75 6c  74 20 69 6e 20 61 20 27  |ll result in a '|
00003220  57 72 6f 6e 67 20 70 61  73 73 77 6f 72 64 20 2f  |Wrong password /|
00003230  20 44 61 74 61 0a 43 6f  72 72 75 70 74 27 20 65  | Data.Corrupt' e|
00003240  72 72 6f 72 2e 20 54 68  69 73 20 77 69 6c 6c 20  |rror. This will |
00003250  61 6c 73 6f 20 6f 63 63  75 72 20 69 66 20 64 61  |also occur if da|
00003260  74 61 20 69 6e 20 61 6e  20 61 72 63 68 69 76 65  |ta in an archive|
00003270  20 62 65 63 6f 6d 65 73  0a 63 6f 72 72 75 70 74  | becomes.corrupt|
00003280  65 64 2e 0a 0a 46 6f 72  20 53 70 61 72 6b 20 63  |ed...For Spark c|
00003290  6f 6d 70 61 74 69 62 6c  65 20 28 6f 6c 64 20 66  |ompatible (old f|
000032a0  6f 72 6d 61 74 29 20 61  72 63 68 69 76 65 73 20  |ormat) archives |
000032b0  63 6f 6e 74 61 69 6e 69  6e 67 20 63 72 75 6e 63  |containing crunc|
000032c0  68 65 64 20 6f 72 20 63  6f 6d 70 72 65 73 73 65  |hed or compresse|
000032d0  64 0a 66 69 6c 65 73 20  77 68 69 63 68 20 61 72  |d.files which ar|
000032e0  65 20 65 6e 63 6f 64 65  64 2c 20 61 6c 6c 20 66  |e encoded, all f|
000032f0  69 6c 65 73 20 6f 66 20  74 68 65 73 65 20 66 6f  |iles of these fo|
00003300  72 6d 61 74 73 20 6d 75  73 74 20 62 65 20 65 6e  |rmats must be en|
00003310  63 6f 64 65 64 20 77 69  74 68 0a 70 61 73 73 77  |coded with.passw|
00003320  6f 72 64 73 20 74 68 61  74 20 68 61 76 65 20 74  |ords that have t|
00003330  68 65 20 73 61 6d 65 20  66 69 72 73 74 20 6c 65  |he same first le|
00003340  74 74 65 72 2e 20 45 6e  63 72 79 70 74 69 6f 6e  |tter. Encryption|
00003350  20 6d 75 73 74 20 62 65  20 73 65 74 20 77 69 74  | must be set wit|
00003360  68 20 61 74 0a 6c 65 61  73 74 20 74 68 65 20 66  |h at.least the f|
00003370  69 72 73 74 20 6c 65 74  74 65 72 20 6f 66 20 74  |irst letter of t|
00003380  68 65 20 70 61 73 73 77  6f 72 64 28 73 29 20 62  |he password(s) b|
00003390  65 66 6f 72 65 20 6f 70  65 6e 69 6e 67 20 74 68  |efore opening th|
000033a0  65 20 61 72 63 68 69 76  65 0a 28 6f 74 68 65 72  |e archive.(other|
000033b0  77 69 73 65 20 74 68 65  20 61 62 6f 76 65 20 65  |wise the above e|
000033c0  72 72 6f 72 20 77 69 6c  6c 20 6f 63 63 75 72 29  |rror will occur)|
000033d0  2e 20 54 68 69 73 20 69  73 20 62 65 63 61 75 73  |. This is becaus|
000033e0  65 20 41 72 63 46 53 20  6d 75 73 74 20 62 65 20  |e ArcFS must be |
000033f0  61 62 6c 65 0a 74 6f 20  64 65 63 6f 64 65 20 74  |able.to decode t|
00003400  68 65 20 66 69 72 73 74  20 62 79 74 65 20 6f 66  |he first byte of|
00003410  20 74 68 65 20 64 61 74  61 20 66 6f 72 20 74 68  | the data for th|
00003420  65 73 65 20 66 69 6c 65  73 20 74 6f 20 66 69 6e  |ese files to fin|
00003430  64 20 6f 75 74 20 74 68  65 20 6e 6f 2e 20 6f 66  |d out the no. of|
00003440  0a 62 69 74 73 20 6f 66  20 63 6f 6d 70 72 65 73  |.bits of compres|
00003450  73 69 6f 6e 2e 0a 0a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |sion...*********|
00003460  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000034a0  2a 2a 2a 2a 0a 0a 53 6f  66 74 77 61 72 65 20 49  |****..Software I|
000034b0  6e 74 65 72 72 75 70 74  73 0a 0a 54 68 65 20 61  |nterrupts..The a|
000034c0  6c 6c 6f 63 61 74 65 64  20 53 57 49 20 63 68 75  |llocated SWI chu|
000034d0  6e 6b 20 62 61 73 65 20  69 73 20 26 34 33 37 43  |nk base is &437C|
000034e0  30 2e 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |0..-------------|
000034f0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003530  0a 53 57 49 20 22 41 72  63 46 53 5f 41 72 63 68  |.SWI "ArcFS_Arch|
00003540  69 76 65 49 6e 66 6f 22  20 20 20 20 20 20 20 20  |iveInfo"        |
00003550  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00003570  20 20 26 34 33 37 43 30  0a 0a 4f 6e 20 65 6e 74  |  &437C0..On ent|
00003580  72 79 3a 20 52 30 3d 61  72 63 68 69 76 65 20 6e  |ry: R0=archive n|
00003590  75 6d 62 65 72 20 28 30  2d 34 29 0a 0a 4f 6e 20  |umber (0-4)..On |
000035a0  65 78 69 74 20 3a 20 52  30 3d 70 6f 69 6e 74 65  |exit : R0=pointe|
000035b0  72 20 74 6f 20 61 72 63  68 69 76 65 20 6e 61 6d  |r to archive nam|
000035c0  65 20 28 6e 75 6c 6c 20  74 65 72 6d 69 6e 61 74  |e (null terminat|
000035d0  65 64 29 0a a0 20 20 20  20 20 20 20 20 20 52 31  |ed)..         R1|
000035e0  3d 70 6f 69 6e 74 65 72  20 74 6f 20 61 72 63 68  |=pointer to arch|
000035f0  69 76 65 20 70 61 74 68  6e 61 6d 65 20 28 6e 75  |ive pathname (nu|
00003600  6c 6c 20 74 65 72 6d 69  6e 61 74 65 64 29 0a 20  |ll terminated). |
00003610  20 20 20 20 20 20 20 20  20 52 32 3d 70 6f 69 6e  |         R2=poin|
00003620  74 65 72 20 74 6f 20 61  72 63 68 69 76 65 20 68  |ter to archive h|
00003630  65 61 64 65 72 73 20 28  69 6e 74 65 72 6e 61 6c  |eaders (internal|
00003640  20 75 73 65 20 6f 6e 6c  79 29 0a 0a 54 68 69 73  | use only)..This|
00003650  20 53 57 49 20 67 69 76  65 73 20 74 68 65 20 6e  | SWI gives the n|
00003660  61 6d 65 20 61 6e 64 20  70 61 74 68 6e 61 6d 65  |ame and pathname|
00003670  20 6f 66 20 74 68 65 20  61 72 63 68 69 76 65 20  | of the archive |
00003680  77 68 6f 73 65 20 6e 75  6d 62 65 72 20 69 73 20  |whose number is |
00003690  67 69 76 65 6e 20 62 79  0a 52 30 20 6f 6e 20 65  |given by.R0 on e|
000036a0  6e 74 72 79 2e 20 49 66  20 52 30 20 70 6f 69 6e  |ntry. If R0 poin|
000036b0  74 73 20 74 6f 20 61 20  6e 75 6c 6c 20 73 74 72  |ts to a null str|
000036c0  69 6e 67 20 6f 6e 20 65  78 69 74 20 74 68 65 6e  |ing on exit then|
000036d0  20 74 68 65 72 65 20 69  73 20 6e 6f 20 6f 70 65  | there is no ope|
000036e0  6e 0a 61 72 63 68 69 76  65 20 77 69 74 68 20 74  |n.archive with t|
000036f0  68 69 73 20 6e 75 6d 62  65 72 20 28 69 2e 65 2e  |his number (i.e.|
00003700  20 61 6e 20 65 6d 70 74  79 20 27 73 6c 6f 74 27  | an empty 'slot'|
00003710  29 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |).--------------|
00003720  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003750  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 0a  |---------------.|
00003760  53 57 49 20 22 41 72 63  46 53 5f 53 74 61 74 75  |SWI "ArcFS_Statu|
00003770  73 22 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |s"              |
00003780  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000037a0  20 26 34 33 37 43 31 0a  0a 4f 6e 20 65 6e 74 72  | &437C1..On entr|
000037b0  79 3a 20 2d 0a 0a 4f 6e  20 65 78 69 74 20 3a 20  |y: -..On exit : |
000037c0  52 30 3d 73 74 61 74 75  73 20 28 26 76 76 62 62  |R0=status (&vvbb|
000037d0  66 66 65 65 29 0a 0a 54  68 69 73 20 72 65 74 75  |ffee)..This retu|
000037e0  72 6e 73 20 74 68 65 20  63 75 72 72 65 6e 74 20  |rns the current |
000037f0  73 74 61 74 75 73 20 6f  66 20 41 72 63 46 53 2e  |status of ArcFS.|
00003800  0a 0a 76 76 20 69 73 20  26 46 46 20 66 6f 72 20  |..vv is &FF for |
00003810  72 65 61 64 20 2f 20 77  72 69 74 65 20 76 65 72  |read / write ver|
00003820  73 69 6f 6e 20 6f 72 20  26 30 30 20 66 6f 72 20  |sion or &00 for |
00003830  72 65 61 64 20 6f 6e 6c  79 20 76 65 72 73 69 6f  |read only versio|
00003840  6e 0a 62 62 20 69 73 20  6e 6f 2e 20 6f 66 20 62  |n.bb is no. of b|
00003850  69 74 73 20 66 6f 72 20  63 72 75 6e 63 68 20 2f  |its for crunch /|
00003860  20 63 6f 6d 70 72 65 73  73 20 66 6f 72 6d 61 74  | compress format|
00003870  73 20 28 30 20 6f 74 68  65 72 77 69 73 65 29 0a  |s (0 otherwise).|
00003880  66 66 20 69 73 20 74 68  65 20 63 6f 6d 70 72 65  |ff is the compre|
00003890  73 73 69 6f 6e 20 66 6f  72 6d 61 74 20 28 73 65  |ssion format (se|
000038a0  65 20 53 57 49 20 22 41  72 63 46 53 5f 43 6f 6d  |e SWI "ArcFS_Com|
000038b0  70 72 65 73 73 69 6f 6e  22 2c 20 62 65 6c 6f 77  |pression", below|
000038c0  29 0a 0a 54 68 65 20 62  6f 74 74 6f 6d 20 62 69  |)..The bottom bi|
000038d0  74 20 6f 66 20 65 65 20  69 73 20 73 65 74 20 69  |t of ee is set i|
000038e0  66 20 66 69 6c 65 20 67  61 72 62 6c 65 20 69 73  |f file garble is|
000038f0  20 73 65 74 20 6f 72 20  63 6c 65 61 72 20 6f 74  | set or clear ot|
00003900  68 65 72 77 69 73 65 2e  20 54 68 65 0a 6f 74 68  |herwise. The.oth|
00003910  65 72 20 62 69 74 73 20  6f 66 20 65 65 20 61 72  |er bits of ee ar|
00003920  65 20 72 65 73 65 72 76  65 64 20 66 6f 72 20 66  |e reserved for f|
00003930  75 74 75 72 65 20 65 78  70 61 6e 73 69 6f 6e 2e  |uture expansion.|
00003940  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00003950  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003980  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 0a 53  |--------------.S|
00003990  57 49 20 22 41 72 63 46  53 5f 4f 70 65 6e 41 72  |WI "ArcFS_OpenAr|
000039a0  63 68 69 76 65 22 20 20  20 20 20 20 20 20 20 20  |chive"          |
000039b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000039d0  26 34 33 37 43 32 0a 0a  4f 6e 20 65 6e 74 72 79  |&437C2..On entry|
000039e0  3a 20 52 30 3d 70 6f 69  6e 74 65 72 20 74 6f 20  |: R0=pointer to |
000039f0  70 61 74 68 6e 61 6d 65  20 28 63 6f 6e 74 72 6f  |pathname (contro|
00003a00  6c 20 74 65 72 6d 69 6e  61 74 65 64 29 0a 20 20  |l terminated).  |
00003a10  20 20 20 20 20 20 20 20  52 31 3d 70 6f 69 6e 74  |        R1=point|
00003a20  65 72 20 74 6f 20 6e 61  6d 65 20 28 63 6f 6e 74  |er to name (cont|
00003a30  72 6f 6c 20 74 65 72 6d  69 6e 61 74 65 64 29 0a  |rol terminated).|
00003a40  0a 4f 6e 20 65 78 69 74  20 3a 20 52 30 20 26 20  |.On exit : R0 & |
00003a50  52 31 20 70 72 65 73 65  72 76 65 64 0a 0a 54 68  |R1 preserved..Th|
00003a60  69 73 20 53 57 49 20 6f  70 65 6e 73 20 61 6e 20  |is SWI opens an |
00003a70  61 72 63 68 69 76 65 2e  20 50 6f 73 73 69 62 6c  |archive. Possibl|
00003a80  65 20 65 72 72 6f 72 73  20 61 72 65 20 27 54 6f  |e errors are 'To|
00003a90  6f 20 6d 61 6e 79 20 61  72 63 68 69 76 65 73 20  |o many archives |
00003aa0  6f 70 65 6e 27 20 6f 72  0a 27 41 6e 20 61 72 63  |open' or.'An arc|
00003ab0  68 69 76 65 20 77 69 74  68 20 74 68 69 73 20 6e  |hive with this n|
00003ac0  61 6d 65 20 69 73 20 61  6c 72 65 61 64 79 20 6f  |ame is already o|
00003ad0  70 65 6e 27 2e 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |pen'..----------|
00003ae0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003b20  2d 2d 2d 0a 53 57 49 20  22 41 72 63 46 53 5f 43  |---.SWI "ArcFS_C|
00003b30  6c 6f 73 65 41 72 63 68  69 76 65 22 20 20 20 20  |loseArchive"    |
00003b40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00003b60  20 20 20 20 20 26 34 33  37 43 33 0a 0a 4f 6e 20  |     &437C3..On |
00003b70  65 6e 74 72 79 3a 20 52  30 3d 70 6f 69 6e 74 65  |entry: R0=pointe|
00003b80  72 20 74 6f 20 6e 61 6d  65 20 28 63 6f 6e 74 72  |r to name (contr|
00003b90  6f 6c 20 74 65 72 6d 69  6e 61 74 65 64 29 0a 0a  |ol terminated)..|
00003ba0  4f 6e 20 65 78 69 74 20  3a 20 52 30 20 70 72 73  |On exit : R0 prs|
00003bb0  65 72 76 65 64 0a 0a 54  68 69 73 20 53 57 49 20  |erved..This SWI |
00003bc0  63 6c 6f 73 65 73 20 61  6e 20 61 72 63 68 69 76  |closes an archiv|
00003bd0  65 2e 20 50 6f 73 73 69  62 6c 65 20 65 72 72 6f  |e. Possible erro|
00003be0  72 20 69 73 20 27 4e 6f  20 61 72 63 68 69 76 65  |r is 'No archive|
00003bf0  20 77 69 74 68 20 74 68  69 73 20 6e 61 6d 65 20  | with this name |
00003c00  69 73 0a 6f 70 65 6e 27  2e 0a 2d 2d 2d 2d 2d 2d  |is.open'..------|
00003c10  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003c50  2d 2d 2d 2d 2d 2d 2d 0a  53 57 49 20 22 41 72 63  |-------.SWI "Arc|
00003c60  46 53 5f 45 6e 63 72 79  70 74 69 6f 6e 22 20 20  |FS_Encryption"  |
00003c70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00003c90  20 20 20 20 20 20 20 20  20 26 34 33 37 43 34 0a  |         &437C4.|
00003ca0  0a 4f 6e 20 65 6e 74 72  79 3a 20 52 30 3d 65 6e  |.On entry: R0=en|
00003cb0  63 72 79 70 74 69 6f 6e  20 6d 65 74 68 6f 64 20  |cryption method |
00003cc0  28 6e 6f 6e 65 3d 30 2c  20 67 61 72 62 6c 65 3d  |(none=0, garble=|
00003cd0  31 29 0a 20 20 20 20 20  20 20 20 20 20 52 31 3d  |1).          R1=|
00003ce0  70 6f 69 6e 74 65 72 20  74 6f 20 70 61 73 73 77  |pointer to passw|
00003cf0  6f 72 64 20 28 63 6f 6e  74 72 6f 6c 20 74 65 72  |ord (control ter|
00003d00  6d 61 69 6e 61 74 65 64  2c 20 75 70 20 74 6f 20  |mainated, up to |
00003d10  33 32 20 62 79 74 65 73  29 0a 0a 4f 6e 20 65 78  |32 bytes)..On ex|
00003d20  69 74 20 3a 20 52 30 20  26 20 52 31 20 70 72 65  |it : R0 & R1 pre|
00003d30  73 65 72 76 65 64 0a 0a  54 68 69 73 20 53 57 49  |served..This SWI|
00003d40  20 73 65 74 73 20 74 68  65 20 65 6e 63 72 79 70  | sets the encryp|
00003d50  74 69 6f 6e 20 6d 65 74  68 6f 64 20 61 6e 64 20  |tion method and |
00003d60  70 61 73 73 77 6f 72 64  20 75 73 65 64 2e 0a 2d  |password used..-|
00003d70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003db0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 53 57 49  |------------.SWI|
00003dc0  20 22 41 72 63 46 53 5f  43 6f 6d 70 72 65 73 73  | "ArcFS_Compress|
00003dd0  69 6f 6e 22 20 20 20 20  20 20 20 20 20 20 20 72  |ion"           r|
00003de0  2f 77 20 76 65 72 73 69  6f 6e 20 6f 6e 6c 79 20  |/w version only |
00003df0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 26 34  |              &4|
00003e00  33 37 43 35 0a 0a 4f 6e  20 65 6e 74 72 79 3a 20  |37C5..On entry: |
00003e10  52 30 3d 63 6f 6d 70 72  65 73 73 69 6f 6e 20 66  |R0=compression f|
00003e20  6f 72 6d 61 74 20 28 26  38 32 2c 26 38 33 2c 26  |ormat (&82,&83,&|
00003e30  38 38 20 6f 72 20 26 46  46 29 0a 20 20 20 20 20  |88 or &FF).     |
00003e40  20 20 20 20 20 52 31 3d  6e 6f 2e 20 62 69 74 73  |     R1=no. bits|
00003e50  20 66 6f 72 20 26 38 38  20 61 6e 64 20 26 46 46  | for &88 and &FF|
00003e60  0a 0a 4f 6e 20 65 78 69  74 20 3a 20 52 30 20 26  |..On exit : R0 &|
00003e70  20 52 31 20 70 72 65 73  65 72 76 65 64 0a 0a 54  | R1 preserved..T|
00003e80  68 69 73 20 53 57 49 20  73 65 74 73 20 74 68 65  |his SWI sets the|
00003e90  20 64 61 74 61 20 63 6f  6d 70 72 65 73 73 69 6f  | data compressio|
00003ea0  6e 20 66 6f 72 6d 61 74  20 74 6f 20 62 65 20 75  |n format to be u|
00003eb0  73 65 64 3a 0a 20 20 26  38 32 20 53 74 6f 72 65  |sed:.  &82 Store|
00003ec0  0a 20 20 26 38 33 20 50  61 63 6b 0a 20 20 26 38  |.  &83 Pack.  &8|
00003ed0  38 20 43 72 75 6e 63 68  0a 20 20 26 46 46 20 43  |8 Crunch.  &FF C|
00003ee0  6f 6d 70 72 65 73 73 0a  50 6f 73 73 69 62 6c 65  |ompress.Possible|
00003ef0  20 65 72 72 6f 72 73 20  61 72 65 20 27 42 69 74  | errors are 'Bit|
00003f00  73 20 72 61 6e 67 65 20  65 72 72 6f 72 27 20 61  |s range error' a|
00003f10  6e 64 20 27 55 6e 6b 6e  6f 77 6e 20 63 6f 6d 70  |nd 'Unknown comp|
00003f20  72 65 73 73 69 6f 6e 20  66 6f 72 6d 61 74 27 0a  |ression format'.|
00003f30  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00003f70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 53 57  |-------------.SW|
00003f80  49 20 22 41 72 63 46 53  5f 43 72 65 61 74 65 41  |I "ArcFS_CreateA|
00003f90  72 63 68 69 76 65 22 20  20 20 20 20 20 20 20 20  |rchive"         |
00003fa0  72 2f 77 20 76 65 72 73  69 6f 6e 20 6f 6e 6c 79  |r/w version only|
00003fb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 26  |               &|
00003fc0  34 33 37 43 36 0a 0a 4f  6e 20 65 6e 74 72 79 3a  |437C6..On entry:|
00003fd0  20 52 30 3d 70 6f 69 6e  74 65 72 20 74 6f 20 70  | R0=pointer to p|
00003fe0  61 74 68 6e 61 6d 65 20  66 6f 72 20 6e 65 77 20  |athname for new |
00003ff0  61 72 63 68 69 76 65 0a  0a 4f 6e 20 65 78 69 74  |archive..On exit|
00004000  20 3a 20 52 30 20 69 73  20 70 72 65 73 65 72 76  | : R0 is preserv|
00004010  65 64 0a 0a 54 68 69 73  20 53 57 49 20 63 72 65  |ed..This SWI cre|
00004020  61 74 65 73 20 28 62 75  74 20 64 6f 65 73 20 6e  |ates (but does n|
00004030  6f 74 20 6f 70 65 6e 29  20 61 20 6e 65 77 20 61  |ot open) a new a|
00004040  72 63 68 69 76 65 2e 0a  2d 2d 2d 2d 2d 2d 2d 2d  |rchive..--------|
00004050  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00004090  2d 2d 2d 2d 2d 0a 53 57  49 20 22 41 72 63 46 53  |-----.SWI "ArcFS|
000040a0  5f 43 6f 6d 70 61 63 74  22 20 20 20 20 20 20 20  |_Compact"       |
000040b0  20 20 20 20 20 20 20 20  72 2f 77 20 76 65 72 73  |        r/w vers|
000040c0  69 6f 6e 20 6f 6e 6c 79  20 20 20 20 20 20 20 20  |ion only        |
000040d0  20 20 20 20 20 20 20 26  34 33 37 43 37 0a 0a 4f  |       &437C7..O|
000040e0  6e 20 65 6e 74 72 79 3a  20 52 30 3d 70 6f 69 6e  |n entry: R0=poin|
000040f0  74 65 72 20 74 6f 20 61  72 63 68 69 76 65 20 6e  |ter to archive n|
00004100  61 6d 65 20 6f 72 20 30  0a 0a 4f 6e 20 65 78 69  |ame or 0..On exi|
00004110  74 20 3a 20 52 30 20 69  73 20 70 72 65 73 65 72  |t : R0 is preser|
00004120  76 65 64 0a 0a 54 68 69  73 20 53 57 49 20 63 6f  |ved..This SWI co|
00004130  6d 70 61 63 74 73 20 74  68 65 20 6e 61 6d 65 64  |mpacts the named|
00004140  20 61 72 63 68 69 76 65  20 28 6f 72 20 74 68 61  | archive (or tha|
00004150  74 20 63 6f 6e 74 61 69  6e 69 6e 67 20 74 68 65  |t containing the|
00004160  20 43 53 44 29 20 74 6f  20 72 65 6d 6f 76 65 64  | CSD) to removed|
00004170  0a 67 61 70 73 20 6c 65  66 74 20 62 79 20 64 65  |.gaps left by de|
00004180  6c 65 74 69 6f 6e 73 20  61 6e 64 20 66 69 6c 65  |letions and file|
00004190  20 6f 76 65 72 77 72 69  74 65 73 2e 0a 0a 2a 2a  | overwrites...**|
000041a0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000041e0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 0a 0a 45 72 72  |***********..Err|
000041f0  6f 72 73 0a 0a 45 72 72  6f 72 20 6e 75 6d 62 65  |ors..Error numbe|
00004200  72 73 20 61 72 65 20 6f  66 20 74 68 65 20 66 6f  |rs are of the fo|
00004210  72 6d 20 26 31 33 38 78  78 20 77 68 65 72 65 20  |rm &138xx where |
00004220  78 78 20 69 73 20 61 73  20 66 6f 6c 6c 6f 77 73  |xx is as follows|
00004230  3a 0a 0a 78 78 20 45 72  72 6f 72 0a 0a 30 31 20  |:..xx Error..01 |
00004240  41 72 63 46 53 20 43 53  44 20 69 73 20 22 55 6e  |ArcFS CSD is "Un|
00004250  73 65 74 22 0a 30 32 20  43 61 6e 27 74 20 68 61  |set".02 Can't ha|
00004260  6e 64 6c 65 20 74 68 69  73 20 61 72 63 68 69 76  |ndle this archiv|
00004270  65 0a 30 33 20 54 68 69  73 20 76 65 72 73 69 6f  |e.03 This versio|
00004280  6e 20 6f 66 20 41 72 63  46 53 20 69 73 20 72 65  |n of ArcFS is re|
00004290  61 64 20 6f 6e 6c 79 2e  2e 2e 2e 20 28 73 65 6c  |ad only.... (sel|
000042a0  66 20 65 78 70 6c 61 6e  61 74 6f 72 79 29 0a 30  |f explanatory).0|
000042b0  34 20 57 72 6f 6e 67 20  70 61 73 73 77 6f 72 64  |4 Wrong password|
000042c0  20 2f 20 44 61 74 61 20  43 6f 72 72 75 70 74 0a  | / Data Corrupt.|
000042d0  30 35 20 4e 6f 20 61 72  63 68 69 76 65 20 77 69  |05 No archive wi|
000042e0  74 68 20 74 68 69 73 20  6e 61 6d 65 20 69 73 20  |th this name is |
000042f0  6f 70 65 6e 0a 30 36 20  42 69 74 73 20 72 61 6e  |open.06 Bits ran|
00004300  67 65 20 65 72 72 6f 72  20 28 6f 75 74 73 69 64  |ge error (outsid|
00004310  65 20 72 61 6e 67 65 20  31 32 2d 31 36 2c 20 75  |e range 12-16, u|
00004320  73 65 64 20 62 79 20 72  65 61 64 20 2f 20 77 72  |sed by read / wr|
00004330  69 74 65 20 76 65 72 73  69 6f 6e 20 6f 6e 6c 79  |ite version only|
00004340  29 0a 30 37 20 55 6e 6b  6e 6f 77 6e 20 43 6f 6d  |).07 Unknown Com|
00004350  70 72 65 73 73 69 6f 6e  20 66 6f 72 6d 61 74 20  |pression format |
00004360  28 75 73 65 64 20 62 79  20 72 65 61 64 20 2f 20  |(used by read / |
00004370  77 72 69 74 65 20 76 65  72 73 69 6f 6e 20 6f 6e  |write version on|
00004380  6c 79 29 0a 30 38 20 56  65 72 73 69 6f 6e 20 2e  |ly).08 Version .|
00004390  2e 2e 2e 20 6f 72 20 2e  2e 2e 2e 20 72 65 71 75  |... or .... requ|
000043a0  69 72 65 64 20 28 79 6f  75 72 20 76 65 72 73 69  |ired (your versi|
000043b0  6f 6e 20 6f 66 20 41 72  63 46 53 20 69 73 20 74  |on of ArcFS is t|
000043c0  6f 6f 20 6f 6c 64 20 74  6f 20 68 61 6e 64 6c 65  |oo old to handle|
000043d0  0a 20 20 20 74 68 69 73  20 61 72 63 68 69 76 65  |.   this archive|
000043e0  29 0a 0a 38 30 20 54 6f  6f 20 6d 61 6e 79 20 61  |)..80 Too many a|
000043f0  72 63 68 69 76 65 73 20  6f 70 65 6e 0a 38 32 20  |rchives open.82 |
00004400  41 6e 20 61 72 63 68 69  76 65 20 77 69 74 68 20  |An archive with |
00004410  74 68 69 73 20 6e 61 6d  65 20 69 73 20 61 6c 72  |this name is alr|
00004420  65 61 64 79 20 6f 70 65  6e 0a 38 39 20 41 72 63  |eady open.89 Arc|
00004430  68 69 76 65 20 72 65 61  64 20 6f 6e 6c 79 20 28  |hive read only (|
00004440  6e 6f 20 77 72 69 74 65  20 61 63 63 65 73 73 20  |no write access |
00004450  6f 72 20 69 73 20 6c 6f  63 6b 65 64 2c 20 75 73  |or is locked, us|
00004460  65 64 20 62 79 20 72 2f  77 20 76 65 72 73 69 6f  |ed by r/w versio|
00004470  6e 20 6f 6e 6c 79 29 0a  0a 39 36 20 43 61 6e 27  |n only)..96 Can'|
00004480  74 20 64 65 6c 65 74 65  20 63 75 72 72 65 6e 74  |t delete current|
00004490  20 64 69 72 65 63 74 6f  72 79 0a 39 37 20 43 61  | directory.97 Ca|
000044a0  6e 27 74 20 64 65 6c 65  74 65 20 63 75 72 72 65  |n't delete curre|
000044b0  6e 74 20 6c 69 62 72 61  72 79 0a 41 30 20 41 72  |nt library.A0 Ar|
000044c0  63 46 53 20 69 6e 20 75  73 65 20 28 52 4d 52 65  |cFS in use (RMRe|
000044d0  69 6e 69 74 20 41 72 63  46 53 20 69 66 20 69 74  |init ArcFS if it|
000044e0  20 6f 63 63 75 72 73 20  72 65 70 65 61 74 65 64  | occurs repeated|
000044f0  6c 79 29 0a 41 32 20 43  61 6e 27 74 20 64 65 6c  |ly).A2 Can't del|
00004500  65 74 65 20 75 73 65 72  20 72 6f 6f 74 20 64 69  |ete user root di|
00004510  72 65 63 74 6f 72 79 0a  42 34 20 44 69 72 2e 20  |rectory.B4 Dir. |
00004520  6e 6f 74 20 65 6d 70 74  79 20 28 72 65 61 64 20  |not empty (read |
00004530  2f 20 77 72 69 74 65 20  76 65 72 73 69 6f 6e 20  |/ write version |
00004540  6f 6e 6c 79 29 0a 43 30  20 54 6f 6f 20 6d 61 6e  |only).C0 Too man|
00004550  79 20 6f 70 65 6e 20 66  69 6c 65 73 20 28 6d 6f  |y open files (mo|
00004560  72 65 20 74 68 61 6e 20  35 20 66 69 6c 65 73 20  |re than 5 files |
00004570  6f 70 65 6e 20 66 6f 72  20 75 70 64 61 74 65 2c  |open for update,|
00004580  20 72 2f 77 20 76 65 72  73 69 6f 6e 20 6f 6e 6c  | r/w version onl|
00004590  79 29 0a 43 33 20 4c 6f  63 6b 65 64 20 28 72 65  |y).C3 Locked (re|
000045a0  61 64 20 2f 20 77 72 69  74 65 20 76 65 72 73 69  |ad / write versi|
000045b0  6f 6e 20 6f 6e 6c 79 29  0a 43 34 20 41 6c 72 65  |on only).C4 Alre|
000045c0  61 64 79 20 65 78 69 73  74 73 20 28 72 65 61 64  |ady exists (read|
000045d0  20 2f 20 77 72 69 74 65  20 76 65 72 73 69 6f 6e  | / write version|
000045e0  20 6f 6e 6c 79 29 0a 43  35 20 54 79 70 65 73 20  | only).C5 Types |
000045f0  64 6f 6e 27 74 20 6d 61  74 63 68 20 28 72 65 61  |don't match (rea|
00004600  64 20 2f 20 77 72 69 74  65 20 76 65 72 73 69 6f  |d / write versio|
00004610  6e 20 6f 6e 6c 79 29 0a  44 36 20 4e 6f 74 20 66  |n only).D6 Not f|
00004620  6f 75 6e 64 0a 0a 46 46  20 49 6e 74 65 72 6e 61  |ound..FF Interna|
00004630  6c 20 66 69 6c 69 6e 67  20 65 72 72 6f 72 20 28  |l filing error (|
00004640  73 68 6f 75 6c 64 20 6e  6f 74 20 6f 63 63 75 72  |should not occur|
00004650  29 0a 0a 49 6e 20 61 64  64 69 74 69 6f 6e 2c 20  |)..In addition, |
00004660  65 72 72 6f 72 73 20 6d  61 79 20 62 65 20 67 65  |errors may be ge|
00004670  6e 65 72 61 74 65 64 20  62 79 20 46 69 6c 65 53  |nerated by FileS|
00004680  77 69 74 63 68 20 6f 72  20 62 79 20 74 68 65 20  |witch or by the |
00004690  66 69 6c 69 6e 67 20 73  79 73 74 65 6d 0a 6f 6e  |filing system.on|
000046a0  20 77 68 69 63 68 20 61  6e 20 61 72 63 68 69 76  | which an archiv|
000046b0  65 20 69 73 20 62 61 73  65 64 2c 20 65 2e 67 2e  |e is based, e.g.|
000046c0  20 44 69 73 63 20 66 75  6c 6c 20 65 72 72 6f 72  | Disc full error|
000046d0  73 20 66 72 6f 6d 20 41  44 46 53 2e 0a 0a 2a 2a  |s from ADFS...**|
000046e0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00004720  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 0a 0a 41 72 63  |***********..Arc|
00004730  46 53 20 46 69 6c 65 72  0a 0a 54 68 65 20 41 72  |FS Filer..The Ar|
00004740  63 46 53 20 66 69 6c 65  72 20 69 73 20 61 20 6d  |cFS filer is a m|
00004750  6f 64 75 6c 65 20 74 61  73 6b 2c 20 70 72 6f 76  |odule task, prov|
00004760  69 64 65 64 20 73 6f 20  74 68 61 74 20 64 69 72  |ided so that dir|
00004770  65 63 74 6f 72 69 65 73  20 6d 61 79 20 62 65 0a  |ectories may be.|
00004780  64 69 73 70 6c 61 79 65  64 20 69 6e 20 6e 6f 72  |displayed in nor|
00004790  6d 61 6c 20 66 69 6c 65  72 20 77 69 6e 64 6f 77  |mal filer window|
000047a0  73 2e 20 41 72 63 68 69  76 65 73 20 61 72 65 20  |s. Archives are |
000047b0  6f 70 65 6e 65 64 20 62  79 20 64 6f 75 62 6c 65  |opened by double|
000047c0  20 63 6c 69 63 6b 69 6e  67 0a 74 68 65 6d 20 6f  | clicking.them o|
000047d0  72 20 64 72 61 67 67 69  6e 67 20 74 68 65 6d 20  |r dragging them |
000047e0  74 6f 20 74 68 65 20 41  72 63 46 53 20 69 63 6f  |to the ArcFS ico|
000047f0  6e 2e 20 54 68 65 20 72  6f 6f 74 20 64 69 72 65  |n. The root dire|
00004800  63 74 6f 72 79 20 6f 66  20 74 68 65 20 6d 6f 73  |ctory of the mos|
00004810  74 0a 72 65 63 65 6e 74  6c 79 20 6f 70 65 6e 65  |t.recently opene|
00004820  64 20 61 72 63 68 69 76  65 20 6d 61 79 20 62 65  |d archive may be|
00004830  20 64 69 73 70 6c 61 79  65 64 20 62 79 20 63 6c  | displayed by cl|
00004840  69 63 6b 69 6e 67 20 6f  6e 20 74 68 65 20 69 63  |icking on the ic|
00004850  6f 6e 2e 20 41 20 6d 65  6e 75 20 69 73 0a 70 72  |on. A menu is.pr|
00004860  6f 76 69 64 65 64 20 77  69 74 68 20 66 6f 75 72  |ovided with four|
00004870  20 6f 70 74 69 6f 6e 73  20 28 73 65 76 65 6e 20  | options (seven |
00004880  66 6f 72 20 74 68 65 20  72 2f 77 20 76 65 72 73  |for the r/w vers|
00004890  69 6f 6e 29 3a 0a 0a 45  6e 63 72 79 70 74 69 6f  |ion):..Encryptio|
000048a0  6e 20 2d 20 53 65 74 73  20 74 68 65 20 65 6e 63  |n - Sets the enc|
000048b0  72 79 70 74 69 6f 6e 20  6d 65 74 68 6f 64 20 61  |ryption method a|
000048c0  6e 64 20 70 61 73 73 77  6f 72 64 20 28 69 66 20  |nd password (if |
000048d0  61 6e 79 29 20 74 68 61  74 20 69 73 20 75 73 65  |any) that is use|
000048e0  64 2e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |d..             |
000048f0  54 68 65 20 73 75 62 64  69 72 65 63 74 6f 72 79  |The subdirectory|
00004900  20 68 61 73 20 6f 70 74  69 6f 6e 73 20 66 6f 72  | has options for|
00004910  20 6e 6f 20 65 6e 63 72  79 70 74 69 6f 6e 20 61  | no encryption a|
00004920  6e 64 20 67 61 72 62 6c  65 2e 20 44 45 53 0a 20  |nd garble. DES. |
00004930  20 20 20 20 20 20 20 20  20 20 20 20 65 6e 63 72  |            encr|
00004940  79 70 74 69 6f 6e 20 69  73 20 6e 6f 74 20 61 76  |yption is not av|
00004950  61 69 6c 61 62 6c 65 20  69 6e 20 74 68 69 73 20  |ailable in this |
00004960  76 65 72 73 69 6f 6e 20  61 6e 64 20 73 6f 20 69  |version and so i|
00004970  73 20 73 68 61 64 65 64  2e 0a 0a 4f 70 65 6e 20  |s shaded...Open |
00004980  27 24 27 20 20 20 2d 20  4f 70 65 6e 73 20 74 68  |'$'   - Opens th|
00004990  65 20 72 6f 6f 74 20 64  69 72 65 63 74 6f 72 79  |e root directory|
000049a0  20 6f 66 20 61 6e 20 6f  70 65 6e 20 61 72 63 68  | of an open arch|
000049b0  69 76 65 2c 20 63 68 6f  73 65 6e 20 66 72 6f 6d  |ive, chosen from|
000049c0  20 74 68 65 0a 20 20 20  20 20 20 20 20 20 20 20  | the.           |
000049d0  20 20 73 75 62 2d 6d 65  6e 75 2e 0a 0a 43 6c 6f  |  sub-menu...Clo|
000049e0  73 65 20 61 72 63 20 20  2d 20 43 6c 6f 73 65 73  |se arc  - Closes|
000049f0  20 61 6e 20 6f 70 65 6e  20 61 72 63 68 69 76 65  | an open archive|
00004a00  2c 20 63 68 6f 73 65 6e  20 66 72 6f 6d 20 74 68  |, chosen from th|
00004a10  65 20 73 75 62 2d 6d 65  6e 75 20 61 6e 64 20 61  |e sub-menu and a|
00004a20  6c 6c 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ll.             |
00004a30  64 69 72 65 63 74 6f 72  79 20 77 69 6e 64 6f 77  |directory window|
00004a40  73 20 6f 66 20 74 68 61  74 20 61 72 63 68 69 76  |s of that archiv|
00004a50  65 2e 0a 0a 4b 69 6c 6c  20 20 20 20 20 20 20 2d  |e...Kill       -|
00004a60  20 43 6c 6f 73 65 73 20  61 6c 6c 20 74 68 65 20  | Closes all the |
00004a70  6f 70 65 6e 20 61 72 63  68 69 76 65 73 2c 20 72  |open archives, r|
00004a80  65 6d 6f 76 65 73 20 61  6c 6c 20 61 72 63 66 73  |emoves all arcfs|
00004a90  20 64 69 72 65 63 74 6f  72 79 0a 20 20 20 20 20  | directory.     |
00004aa0  20 20 20 20 20 20 20 20  77 69 6e 64 6f 77 73 2c  |        windows,|
00004ab0  20 4b 69 6c 6c 73 20 74  68 65 20 41 72 63 46 53  | Kills the ArcFS|
00004ac0  20 6d 6f 64 75 6c 65 2c  20 51 75 69 74 73 20 74  | module, Quits t|
00004ad0  68 65 20 41 72 63 46 53  20 46 69 6c 65 72 20 61  |he ArcFS Filer a|
00004ae0  6e 64 20 4b 69 6c 6c 73  0a 20 20 20 20 20 20 20  |nd Kills.       |
00004af0  20 20 20 20 20 20 74 68  65 20 41 72 63 46 53 20  |      the ArcFS |
00004b00  46 69 6c 65 72 20 6d 6f  64 75 6c 65 2e 0a 0a 4b  |Filer module...K|
00004b10  69 6c 6c 20 70 72 6f 6d  70 74 73 20 66 6f 72 20  |ill prompts for |
00004b20  63 6f 6e 66 69 72 6d 61  74 69 6f 6e 2e 20 43 6c  |confirmation. Cl|
00004b30  69 63 6b 20 6f 6e 20 4f  4b 20 74 6f 20 4b 69 6c  |ick on OK to Kil|
00004b40  6c 20 74 68 65 20 6d 6f  64 75 6c 65 73 20 6f 72  |l the modules or|
00004b50  20 43 61 6e 63 65 6c 0a  6f 74 68 65 72 77 69 73  | Cancel.otherwis|
00004b60  65 2e 20 4e 6f 74 65 20  70 72 65 73 73 69 6e 67  |e. Note pressing|
00004b70  20 65 73 63 61 70 65 20  68 61 73 20 74 68 65 20  | escape has the |
00004b80  73 61 6d 65 20 65 66 66  65 63 74 20 61 73 20 63  |same effect as c|
00004b90  6c 69 63 6b 69 6e 67 20  6f 6e 20 4f 4b 2e 0a 0a  |licking on OK...|
00004ba0  49 6e 20 61 64 64 69 74  69 6f 6e 20 74 68 65 20  |In addition the |
00004bb0  72 2f 77 20 76 65 72 73  69 6f 6e 20 70 72 6f 76  |r/w version prov|
00004bc0  69 64 65 73 20 74 68 65  20 66 6f 6c 6c 6f 77 69  |ides the followi|
00004bd0  6e 67 20 6f 70 74 69 6f  6e 73 3a 0a 0a 4e 65 77  |ng options:..New|
00004be0  20 61 72 63 20 20 20 20  2d 20 50 72 6f 76 69 64  | arc    - Provid|
00004bf0  65 73 20 61 20 73 61 76  65 20 62 6f 78 20 66 6f  |es a save box fo|
00004c00  72 20 63 72 65 61 74 69  6e 67 20 6e 65 77 20 61  |r creating new a|
00004c10  72 63 68 69 76 65 73 0a  0a 43 6f 6d 70 61 63 74  |rchives..Compact|
00004c20  20 20 20 20 2d 20 43 6f  6d 70 61 63 74 73 20 61  |    - Compacts a|
00004c30  6e 20 6f 70 65 6e 20 61  72 63 68 69 76 65 20 28  |n open archive (|
00004c40  63 68 6f 6f 73 65 20 66  72 6f 6d 20 73 75 62 2d  |choose from sub-|
00004c50  6d 65 6e 75 29 0a 0a 43  6f 6d 70 72 65 73 73 69  |menu)..Compressi|
00004c60  6f 6e 2d 20 55 73 65 20  74 6f 20 73 65 74 20 74  |on- Use to set t|
00004c70  68 65 20 63 6f 6d 70 72  65 73 73 69 6f 6e 20 6d  |he compression m|
00004c80  65 74 68 6f 64 0a 0a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |ethod..*********|
00004c90  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00004cd0  2a 2a 2a 2a 0a 0a 41 6c  6c 20 63 6f 6d 6d 65 6e  |****..All commen|
00004ce0  74 73 20 61 6e 64 20 73  75 67 67 65 73 74 69 6f  |ts and suggestio|
00004cf0  6e 73 20 66 6f 72 20 66  75 74 75 72 65 20 69 6d  |ns for future im|
00004d00  70 72 6f 76 65 6d 65 6e  74 20 61 72 65 20 77 65  |provement are we|
00004d10  6c 63 6f 6d 65 20 62 75  74 20 70 6c 65 61 73 65  |lcome but please|
00004d20  0a 6e 6f 74 65 20 74 68  61 74 20 49 20 63 61 6e  |.note that I can|
00004d30  6e 6f 74 20 72 65 70 6c  79 20 74 6f 20 6c 65 74  |not reply to let|
00004d40  74 65 72 73 20 77 69 74  68 6f 75 74 20 72 65 74  |ters without ret|
00004d50  75 72 6e 20 70 6f 73 74  61 67 65 20 61 6e 64 20  |urn postage and |
00004d60  61 6e 20 61 64 64 72 65  73 73 65 64 0a 65 6e 76  |an addressed.env|
00004d70  65 6c 6f 70 65 2e 0a 0a  54 68 65 20 61 64 64 72  |elope...The addr|
00004d80  65 73 73 20 69 73 3a 0a  0a 20 20 20 20 4d 72 2e  |ess is:..    Mr.|
00004d90  20 4d 2e 20 53 6d 69 74  68 0a 20 20 20 20 50 65  | M. Smith.    Pe|
00004da0  6e 2d 79 2d 64 72 65 2c  0a 20 20 20 20 52 69 76  |n-y-dre,.    Riv|
00004db0  65 72 73 69 64 65 20 41  76 65 2e 2c 0a 20 20 20  |erside Ave.,.   |
00004dc0  20 42 72 6f 78 62 6f 75  72 6e 65 2c 0a 20 20 20  | Broxbourne,.   |
00004dd0  20 48 65 72 74 73 2e 2c  0a 20 20 20 20 45 4e 31  | Herts.,.    EN1|
00004de0  30 20 36 52 44 2e 0a 0a  42 65 74 77 65 65 6e 20  |0 6RD...Between |
00004df0  4d 6f 6e 64 61 79 20 33  30 74 68 20 53 65 70 74  |Monday 30th Sept|
00004e00  65 6d 62 65 72 20 61 6e  64 20 46 72 69 64 61 79  |ember and Friday|
00004e10  20 31 33 74 68 20 44 65  63 65 6d 62 65 72 20 31  | 13th December 1|
00004e20  39 39 31 20 61 6e 64 20  62 65 74 77 65 65 6e 0a  |991 and between.|
00004e30  4d 6f 6e 64 61 79 20 36  74 68 20 4a 61 6e 75 61  |Monday 6th Janua|
00004e40  72 79 20 61 6e 64 20 46  72 69 64 61 79 20 32 37  |ry and Friday 27|
00004e50  74 68 20 4d 61 72 63 68  20 31 39 39 32 20 69 6e  |th March 1992 in|
00004e60  63 2e 20 49 20 63 61 6e  20 62 65 20 72 65 61 63  |c. I can be reac|
00004e70  68 65 64 20 6d 6f 72 65  0a 71 75 69 63 6b 6c 79  |hed more.quickly|
00004e80  20 61 74 3a 0a 0a 20 20  20 20 4d 72 2e 20 4d 2e  | at:..    Mr. M.|
00004e90  20 53 6d 69 74 68 2c 0a  20 20 20 20 43 68 65 70  | Smith,.    Chep|
00004ea0  73 74 6f 77 20 48 61 6c  6c 20 6f 66 20 52 65 73  |stow Hall of Res|
00004eb0  69 64 65 6e 63 65 2c 0a  20 20 20 20 52 6f 6f 6d  |idence,.    Room|
00004ec0  20 4c 31 34 2c 0a 20 20  20 20 42 72 75 6e 65 6c  | L14,.    Brunel|
00004ed0  20 55 6e 69 76 65 72 73  69 74 79 2c 0a 20 20 20  | University,.   |
00004ee0  20 55 78 62 72 69 64 67  65 2c 0a 20 20 20 20 4d  | Uxbridge,.    M|
00004ef0  69 64 64 6c 73 65 78 2c  0a 20 20 20 20 55 42 38  |iddlsex,.    UB8|
00004f00  20 33 50 48 2e 0a 0a 50  6c 65 61 73 65 20 64 6f  | 3PH...Please do|
00004f10  20 6e 6f 74 20 73 65 6e  64 20 61 6e 79 20 70 6f  | not send any po|
00004f20  73 74 20 74 6f 20 72 65  61 63 68 20 74 68 69 73  |st to reach this|
00004f30  20 61 64 64 72 65 73 73  20 61 66 74 65 72 20 32  | address after 2|
00004f40  37 74 68 20 4d 61 72 63  68 20 31 39 39 32 20 61  |7th March 1992 a|
00004f50  73 20 49 0a 77 69 6c 6c  20 70 72 6f 62 61 62 6c  |s I.will probabl|
00004f60  79 20 6e 6f 74 20 72 65  63 65 69 76 65 20 69 74  |y not receive it|
00004f70  2e 20 50 6c 65 61 73 65  20 62 65 20 70 61 74 69  |. Please be pati|
00004f80  65 6e 74 20 77 68 65 6e  20 77 61 69 74 69 6e 67  |ent when waiting|
00004f90  20 66 6f 72 20 72 65 70  6c 69 65 73 20 61 73 0a  | for replies as.|
00004fa0  49 20 6d 61 79 20 6e 6f  74 20 62 65 20 61 62 6c  |I may not be abl|
00004fb0  65 20 74 6f 20 72 65 70  6c 79 20 69 6d 6d 65 64  |e to reply immed|
00004fc0  69 61 74 65 6c 79 2e 0a  0a 49 20 68 61 76 65 20  |iately...I have |
00004fd0  61 20 4a 41 4e 45 54 20  65 6d 61 69 6c 20 61 64  |a JANET email ad|
00004fe0  64 72 65 73 73 3a 0a 0a  65 65 39 31 6d 64 73 32  |dress:..ee91mds2|
00004ff0  40 62 72 75 6e 65 6c 2e  61 63 2e 75 6b 0a 0a 49  |@brunel.ac.uk..I|
00005000  20 63 61 6e 20 62 65 20  63 6f 6e 74 61 63 74 65  | can be contacte|
00005010  64 20 61 74 20 74 68 69  73 20 65 6d 61 69 6c 20  |d at this email |
00005020  61 64 64 72 65 73 73 20  66 72 6f 6d 20 4f 63 74  |address from Oct|
00005030  2d 4d 61 72 20 6f 66 20  31 39 39 31 2f 39 32 2c  |-Mar of 1991/92,|
00005040  20 39 32 2f 39 33 20 61  6e 64 0a 39 33 2f 39 34  | 92/93 and.93/94|
00005050  20 61 6e 64 20 66 72 6f  6d 20 4f 63 74 2d 4a 75  | and from Oct-Ju|
00005060  6e 20 6f 66 20 31 39 39  34 2f 39 35 2e 0a 0a 49  |n of 1994/95...I|
00005070  20 77 6f 75 6c 64 20 61  6c 73 6f 2c 20 6f 66 20  | would also, of |
00005080  63 6f 75 72 73 65 20 77  65 6c 63 6f 6d 65 20 64  |course welcome d|
00005090  65 74 61 69 6c 73 20 6f  66 20 61 6e 79 20 62 75  |etails of any bu|
000050a0  67 73 20 64 69 73 63 6f  76 65 72 65 64 20 73 6f  |gs discovered so|
000050b0  20 74 68 61 74 20 49 20  63 61 6e 0a 63 6f 72 72  | that I can.corr|
000050c0  65 63 74 20 74 68 65 6d  2e 0a 0a 2a 2a 2a 2a 2a  |ect them...*****|
000050d0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00005110  2a 2a 2a 2a 2a 2a 2a 2a  0a 0a 56 65 72 73 69 6f  |********..Versio|
00005120  6e 20 49 6d 70 72 6f 76  65 6d 65 6e 74 73 0a 0a  |n Improvements..|
00005130  76 30 2e 32 30 20 46 69  72 73 74 20 52 65 6c 65  |v0.20 First Rele|
00005140  61 73 65 20 76 65 72 73  69 6f 6e 0a 76 30 2e 32  |ase version.v0.2|
00005150  31 20 4d 61 78 20 6e 75  6d 62 65 72 20 6f 66 20  |1 Max number of |
00005160  64 69 72 65 63 74 6f 72  79 20 6c 65 76 65 6c 73  |directory levels|
00005170  20 69 6e 63 72 65 61 73  65 64 20 66 72 6f 6d 20  | increased from |
00005180  31 36 20 74 6f 20 36 34  2c 20 73 6f 6d 65 20 74  |16 to 64, some t|
00005190  69 64 79 69 6e 67 0a 76  30 2e 32 32 20 53 6e 6f  |idying.v0.22 Sno|
000051a0  77 65 64 20 69 6e 20 38  74 68 20 46 65 62 20 39  |wed in 8th Feb 9|
000051b0  31 20 73 6f 20 6d 61 64  65 20 65 78 74 65 6e 73  |1 so made extens|
000051c0  69 76 65 20 63 68 61 6e  67 65 73 3a 20 55 52 44  |ive changes: URD|
000051d0  20 61 6e 64 20 50 53 44  20 6e 6f 77 0a 20 20 20  | and PSD now.   |
000051e0  20 20 20 73 75 70 70 6f  72 74 65 64 2e 20 43 6f  |   supported. Co|
000051f0  6d 6d 61 6e 64 73 20 2a  42 61 63 6b 20 61 6e 64  |mmands *Back and|
00005200  20 2a 55 52 44 20 70 72  6f 76 69 64 65 64 2e 20  | *URD provided. |
00005210  2a 46 69 6c 65 49 6e 66  6f 20 63 6f 6d 6d 61 6e  |*FileInfo comman|
00005220  64 20 61 64 64 65 64 2e  0a 20 20 20 20 20 20 43  |d added..      C|
00005230  6f 6d 70 72 65 73 73 69  6f 6e 20 66 6f 72 6d 61  |ompression forma|
00005240  74 20 72 65 6d 6f 76 65  64 20 66 72 6f 6d 20 2a  |t removed from *|
00005250  49 6e 66 6f 20 61 6e 64  20 2a 45 58 20 6f 75 74  |Info and *EX out|
00005260  70 75 74 20 28 6e 6f 77  20 67 69 76 65 6e 20 62  |put (now given b|
00005270  79 0a 20 20 20 20 20 20  2a 46 69 6c 65 49 6e 66  |y.      *FileInf|
00005280  6f 29 2e 20 2a 49 6e 66  6f 20 26 20 2a 46 69 6c  |o). *Info & *Fil|
00005290  65 49 6e 66 6f 20 6e 6f  77 20 67 69 76 65 20 69  |eInfo now give i|
000052a0  6e 66 6f 72 6d 61 74 69  6f 6e 20 6f 6e 20 6d 75  |nformation on mu|
000052b0  6c 74 69 70 6c 65 0a 20  20 20 20 20 20 77 69 6c  |ltiple.      wil|
000052c0  64 63 61 72 64 65 64 20  66 69 6c 65 73 2e 20 43  |dcarded files. C|
000052d0  6f 6d 70 72 65 73 73 65  64 20 66 69 6c 65 20 73  |ompressed file s|
000052e0  69 7a 65 20 6e 6f 77 20  73 74 6f 72 65 64 20 69  |ize now stored i|
000052f0  6e 20 74 68 65 20 74 6f  70 20 32 34 20 62 69 74  |n the top 24 bit|
00005300  73 20 6f 66 0a 20 20 20  20 20 20 74 68 65 20 66  |s of.      the f|
00005310  69 6c 65 20 61 74 74 72  69 62 75 74 65 73 2e 20  |ile attributes. |
00005320  50 43 20 66 6f 72 6d 61  74 20 66 69 6c 65 73 20  |PC format files |
00005330  61 72 65 20 6e 6f 77 20  73 75 70 70 6f 72 74 65  |are now supporte|
00005340  64 2e 20 53 75 70 70 6c  69 65 64 20 77 69 74 68  |d. Supplied with|
00005350  0a 20 20 20 20 20 20 6e  65 77 20 41 72 63 46 53  |.      new ArcFS|
00005360  20 46 69 6c 65 72 20 77  69 74 68 20 69 63 6f 6e  | Filer with icon|
00005370  20 61 6e 64 20 6d 65 6e  75 2e 0a 76 30 2e 32 33  | and menu..v0.23|
00005380  20 43 6f 72 72 65 63 74  65 64 20 32 20 62 75 67  | Corrected 2 bug|
00005390  73 20 2d 20 41 72 63 46  53 20 64 69 64 20 6e 6f  |s - ArcFS did no|
000053a0  74 20 72 65 6c 65 61 73  65 20 31 36 6b 20 6f 66  |t release 16k of|
000053b0  20 63 6c 61 69 6d 65 64  20 6d 65 6d 6f 72 79 20  | claimed memory |
000053c0  77 68 65 6e 20 61 6e 0a  20 20 20 20 20 20 65 72  |when an.      er|
000053d0  72 6f 72 20 6f 63 63 75  72 65 64 20 64 75 72 69  |ror occured duri|
000053e0  6e 67 20 74 68 65 20 6c  6f 61 64 20 63 72 75 6e  |ng the load crun|
000053f0  63 68 20 72 6f 75 74 69  6e 65 2e 20 49 66 20 79  |ch routine. If y|
00005400  6f 75 20 63 61 6e 63 65  6c 6c 65 64 20 61 0a 20  |ou cancelled a. |
00005410  20 20 20 20 20 72 65 71  75 65 73 74 20 66 72 6f  |     request fro|
00005420  6d 20 74 68 65 20 6c 6f  61 64 20 70 61 63 6b 20  |m the load pack |
00005430  72 6f 75 74 69 6e 65 20  74 6f 20 69 6e 73 65 72  |routine to inser|
00005440  74 20 61 20 64 69 73 6b  20 74 68 65 20 72 65 71  |t a disk the req|
00005450  75 65 73 74 20 77 61 73  0a 20 20 20 20 20 20 72  |uest was.      r|
00005460  65 70 65 61 74 65 64 20  61 20 73 65 63 6f 6e 64  |epeated a second|
00005470  20 74 69 6d 65 2e 0a 76  30 2e 33 30 20 4e 6f 77  | time..v0.30 Now|
00005480  20 61 64 64 65 64 20 73  75 70 70 6f 72 74 20 66  | added support f|
00005490  6f 72 20 73 71 75 61 73  68 65 64 20 61 6e 64 20  |or squashed and |
000054a0  63 6f 6d 70 72 65 73 73  65 64 20 66 6f 72 6d 61  |compressed forma|
000054b0  74 73 2e 20 41 6c 73 6f  20 61 64 64 65 64 0a 20  |ts. Also added. |
000054c0  20 20 20 20 20 73 75 70  70 6f 72 74 20 66 6f 72  |     support for|
000054d0  20 47 61 72 62 6c 65 64  20 66 69 6c 65 73 2c 20  | Garbled files, |
000054e0  2a 47 61 72 62 6c 65 20  61 6e 64 20 2a 4e 6f 45  |*Garble and *NoE|
000054f0  6e 63 72 79 70 74 69 6f  6e 20 63 6f 6d 6d 61 6e  |ncryption comman|
00005500  64 73 20 70 72 6f 76 69  64 65 64 2e 0a 20 20 20  |ds provided..   |
00005510  20 20 20 43 6f 6d 70 72  65 68 65 6e 73 69 76 65  |   Comprehensive|
00005520  20 65 72 72 6f 72 20 63  68 65 63 6b 69 6e 67 20  | error checking |
00005530  63 68 65 63 6b 73 20 66  6f 72 20 63 6f 72 72 75  |checks for corru|
00005540  70 74 65 64 20 64 61 74  61 20 61 6e 64 2f 6f 72  |pted data and/or|
00005550  20 70 61 73 73 77 6f 72  64 73 0a 20 20 20 20 20  | passwords.     |
00005560  20 61 6e 64 20 66 69 6c  65 20 65 6e 63 72 79 70  | and file encryp|
00005570  74 69 6f 6e 20 6d 65 74  68 6f 64 73 20 69 6e 63  |tion methods inc|
00005580  6f 6e 73 69 73 74 65 6e  74 20 77 69 74 68 20 74  |onsistent with t|
00005590  68 6f 73 65 20 74 68 61  74 20 68 61 76 65 20 62  |hose that have b|
000055a0  65 65 6e 20 73 65 74 2e  0a 76 30 2e 34 30 20 41  |een set..v0.40 A|
000055b0  64 64 65 64 20 73 75 70  70 6f 72 74 20 66 6f 72  |dded support for|
000055c0  20 6d 75 6c 74 69 70 6c  65 20 61 72 63 68 69 76  | multiple archiv|
000055d0  65 73 2c 20 6e 65 77 20  66 6f 72 6d 61 74 20 61  |es, new format a|
000055e0  72 63 68 69 76 65 73 2c  20 72 65 77 72 69 74 74  |rchives, rewritt|
000055f0  65 6e 0a 20 20 20 20 20  20 41 72 63 46 53 20 46  |en.      ArcFS F|
00005600  69 6c 65 72 20 61 73 20  61 20 6d 6f 64 75 6c 65  |iler as a module|
00005610  20 74 61 73 6b 2e 20 41  6c 73 6f 20 61 64 64 65  | task. Also adde|
00005620  64 20 53 57 49 27 73 2e  20 43 6f 72 72 65 63 74  |d SWI's. Correct|
00005630  65 64 20 62 75 67 73 20  73 75 63 68 20 61 73 0a  |ed bugs such as.|
00005640  20 20 20 20 20 20 74 68  65 20 6f 6e 65 20 63 61  |      the one ca|
00005650  75 73 69 6e 67 20 73 74  72 61 6e 67 65 20 63 68  |using strange ch|
00005660  61 72 61 63 74 65 72 73  20 74 6f 20 61 70 70 65  |aracters to appe|
00005670  61 72 20 69 6e 20 25 20  63 6f 6d 70 72 65 73 73  |ar in % compress|
00005680  69 6f 6e 20 72 61 74 69  6f 73 0a 20 20 20 20 20  |ion ratios.     |
00005690  20 28 73 6f 6d 65 74 69  6d 65 73 20 63 61 75 73  | (sometimes caus|
000056a0  69 6e 67 20 61 20 63 72  61 73 68 20 77 68 65 6e  |ing a crash when|
000056b0  20 74 72 79 69 6e 67 20  74 6f 20 67 69 76 65 20  | trying to give |
000056c0  61 20 72 61 74 69 6f 20  66 6f 72 20 76 65 72 79  |a ratio for very|
000056d0  20 73 6d 61 6c 6c 0a 20  20 20 20 20 20 66 69 6c  | small.      fil|
000056e0  65 73 29 2e 20 4e 6f 74  20 66 6f 72 20 50 2e 44  |es). Not for P.D|
000056f0  2e 20 64 69 73 74 72 69  62 75 74 69 6f 6e 20 61  |. distribution a|
00005700  73 20 49 20 61 6d 20 73  74 69 6c 6c 20 77 61 69  |s I am still wai|
00005710  74 69 6e 67 20 66 6f 72  20 61 20 53 57 49 20 63  |ting for a SWI c|
00005720  68 75 6e 6b 0a 20 20 20  20 20 20 62 61 73 65 20  |hunk.      base |
00005730  61 6c 6c 6f 63 61 74 69  6f 6e 2e 0a 76 30 2e 34  |allocation..v0.4|
00005740  31 20 41 64 64 65 64 20  73 75 70 70 6f 72 74 20  |1 Added support |
00005750  66 6f 72 20 46 53 45 6e  74 72 79 5f 46 75 6e 63  |for FSEntry_Func|
00005760  20 31 31 2c 31 32 2c 31  33 2c 31 34 20 61 6e 64  | 11,12,13,14 and|
00005770  20 31 39 2e 20 57 69 6c  6c 20 6e 6f 77 20 77 6f  | 19. Will now wo|
00005780  72 6b 20 77 69 74 68 0a  20 20 20 20 20 20 49 6d  |rk with.      Im|
00005790  70 72 65 73 73 69 6f 6e  20 28 64 6f 63 75 6d 65  |pression (docume|
000057a0  6e 74 73 20 63 61 6e 20  62 65 20 6c 6f 61 64 65  |nts can be loade|
000057b0  64 20 77 69 74 68 6f 75  74 20 61 6e 6f 74 68 65  |d without anothe|
000057c0  72 20 63 6f 70 79 20 6f  66 20 49 6d 70 72 65 73  |r copy of Impres|
000057d0  73 69 6f 6e 0a 20 20 20  20 20 20 62 65 69 6e 67  |sion.      being|
000057e0  20 6c 6f 61 64 65 64 20  61 6e 64 20 21 49 6d 70  | loaded and !Imp|
000057f0  72 65 73 73 20 63 61 6e  20 62 65 20 6c 6f 61 64  |ress can be load|
00005800  65 64 20 66 72 6f 6d 20  61 6e 20 61 72 63 68 69  |ed from an archi|
00005810  76 65 20 77 69 74 68 6f  75 74 0a 20 20 20 20 20  |ve without.     |
00005820  20 63 72 61 73 68 69 6e  67 29 2e 20 54 69 64 69  | crashing). Tidi|
00005830  65 64 20 74 68 65 20 65  72 72 6f 72 20 6e 75 6d  |ed the error num|
00005840  62 65 72 73 20 28 73 6f  6d 65 20 6e 6f 77 20 64  |bers (some now d|
00005850  69 66 66 65 72 65 6e 74  29 20 74 6f 20 67 69 76  |ifferent) to giv|
00005860  65 0a 20 20 20 20 20 20  61 6c 6c 6f 63 61 74 69  |e.      allocati|
00005870  6f 6e 73 20 73 68 6f 77  6e 20 61 62 6f 76 65 2e  |ons shown above.|
00005880  20 53 57 49 20 63 68 75  6e 6b 20 62 61 73 65 20  | SWI chunk base |
00005890  61 6c 6c 6f 63 61 74 69  6f 6e 20 26 34 33 37 43  |allocation &437C|
000058a0  30 20 72 65 63 65 69 76  65 64 0a 20 20 20 20 20  |0 received.     |
000058b0  20 66 72 6f 6d 20 41 63  6f 72 6e 2e 20 4e 65 77  | from Acorn. New|
000058c0  20 41 72 63 46 53 46 69  6c 65 72 20 28 76 30 2e  | ArcFSFiler (v0.|
000058d0  32 31 29 20 73 68 6f 75  6c 64 20 77 6f 72 6b 20  |21) should work |
000058e0  77 69 74 68 20 6f 6c 64  65 72 20 4f 61 6b 20 53  |with older Oak S|
000058f0  43 53 49 20 61 6e 64 0a  20 20 20 20 20 20 49 43  |CSI and.      IC|
00005900  53 20 49 44 45 20 68 61  72 64 20 64 72 69 76 65  |S IDE hard drive|
00005910  73 0a 76 30 2e 34 32 20  46 69 78 65 64 20 62 75  |s.v0.42 Fixed bu|
00005920  67 20 77 68 69 63 68 20  73 6f 6d 65 74 69 6d 65  |g which sometime|
00005930  73 20 67 69 76 65 73 20  61 6e 20 61 64 64 72 65  |s gives an addre|
00005940  73 73 20 65 78 63 65 70  74 69 6f 6e 20 77 68 65  |ss exception whe|
00005950  6e 20 74 72 79 69 6e 67  20 74 6f 0a 20 20 20 20  |n trying to.    |
00005960  20 20 72 65 61 64 20 61  6e 20 65 6e 63 72 79 70  |  read an encryp|
00005970  74 65 64 20 66 69 6c 65  20 77 69 74 68 20 74 68  |ted file with th|
00005980  65 20 77 72 6f 6e 67 20  70 61 73 73 77 6f 72 64  |e wrong password|
00005990  2e 20 76 30 2e 34 31 20  77 61 73 20 6d 69 73 74  |. v0.41 was mist|
000059a0  61 6b 65 6e 6c 79 0a 20  20 20 20 20 20 73 65 6e  |akenly.      sen|
000059b0  74 20 6f 75 74 20 77 69  74 68 20 61 20 63 6f 70  |t out with a cop|
000059c0  79 20 6f 66 20 41 72 63  46 53 46 69 6c 65 72 20  |y of ArcFSFiler |
000059d0  76 30 2e 32 31 20 77 68  69 63 68 20 73 74 61 74  |v0.21 which stat|
000059e0  65 64 20 74 68 61 74 20  69 74 20 77 61 73 20 6e  |ed that it was n|
000059f0  6f 74 0a 20 20 20 20 20  20 50 2e 44 2e 0a 76 30  |ot.      P.D..v0|
00005a00  2e 34 33 20 46 69 78 65  64 20 62 75 67 20 77 68  |.43 Fixed bug wh|
00005a10  69 63 68 20 67 69 76 65  73 20 69 6e 63 6f 72 72  |ich gives incorr|
00005a20  65 63 74 20 6c 6f 61 64  20 61 64 64 72 65 73 73  |ect load address|
00005a30  20 6f 6e 20 72 65 74 75  72 6e 20 66 72 6f 6d 20  | on return from |
00005a40  4f 53 5f 46 69 6c 65 0a  20 20 20 20 20 20 6c 6f  |OS_File.      lo|
00005a50  61 64 20 63 6f 6d 6d 61  6e 64 73 2e 20 54 68 69  |ad commands. Thi|
00005a60  73 20 63 61 75 73 65 64  20 70 72 6f 62 6c 65 6d  |s caused problem|
00005a70  73 20 77 69 74 68 20 45  64 69 74 20 6e 6f 74 20  |s with Edit not |
00005a80  6d 61 69 6e 74 61 69 6e  69 6e 67 20 74 68 65 0a  |maintaining the.|
00005a90  20 20 20 20 20 20 63 6f  72 72 65 63 74 20 66 69  |      correct fi|
00005aa0  6c 65 74 79 70 65 20 77  68 65 6e 20 75 70 64 61  |letype when upda|
00005ab0  74 69 6e 67 20 66 69 6c  65 73 2e 0a 76 30 2e 34  |ting files..v0.4|
00005ac0  34 20 46 69 78 65 64 20  62 75 67 20 70 72 65 73  |4 Fixed bug pres|
00005ad0  65 6e 74 20 69 6e 20 76  65 72 73 69 6f 6e 73 20  |ent in versions |
00005ae0  30 2e 34 30 20 74 6f 20  30 2e 34 33 20 77 68 69  |0.40 to 0.43 whi|
00005af0  63 68 20 63 61 75 73 65  64 20 74 68 65 20 6d 61  |ch caused the ma|
00005b00  63 68 69 6e 65 20 74 6f  0a 20 20 20 20 20 20 63  |chine to.      c|
00005b10  72 61 73 68 20 77 68 65  6e 20 61 74 74 65 6d 70  |rash when attemp|
00005b20  74 69 6e 67 20 74 6f 20  6f 70 65 6e 20 53 45 41  |ting to open SEA|
00005b30  20 41 52 43 20 6f 72 20  50 4b 41 52 43 20 61 72  | ARC or PKARC ar|
00005b40  63 68 69 76 65 73 20 6f  72 20 53 70 61 72 6b 0a  |chives or Spark.|
00005b50  20 20 20 20 20 20 61 72  63 68 69 76 65 73 20 63  |      archives c|
00005b60  6f 6e 74 61 69 6e 69 6e  67 20 50 43 20 66 6f 72  |ontaining PC for|
00005b70  6d 61 74 20 66 69 6c 65  73 2e 0a 0a 76 31 2e 30  |mat files...v1.0|
00005b80  31 20 46 69 72 73 74 20  66 75 6c 6c 79 20 69 6d  |1 First fully im|
00005b90  70 6c 69 6d 65 6e 74 65  64 20 72 65 61 64 20 2f  |plimented read /|
00005ba0  20 77 72 69 74 65 20 76  65 72 73 69 6f 6e 2e 0a  | write version..|
00005bb0  76 31 2e 30 32 20 43 6f  6d 70 61 63 74 20 6e 6f  |v1.02 Compact no|
00005bc0  77 20 66 75 6c 6c 79 20  69 6d 70 6c 69 6d 65 6e  |w fully implimen|
00005bd0  74 65 64 2c 20 6d 61 6b  65 73 20 61 72 63 68 69  |ted, makes archi|
00005be0  76 65 20 61 73 20 73 6d  61 6c 6c 20 61 73 20 70  |ve as small as p|
00005bf0  6f 73 73 69 62 6c 65 2e  0a 20 20 20 20 20 20 41  |ossible..      A|
00005c00  6c 73 6f 2c 20 62 75 67  20 66 69 78 20 61 73 20  |lso, bug fix as |
00005c10  66 6f 72 20 76 30 2e 34  33 0a 76 31 2e 30 33 20  |for v0.43.v1.03 |
00005c20  46 69 78 65 64 20 62 75  67 73 20 69 6e 20 72 65  |Fixed bugs in re|
00005c30  6e 61 6d 65 20 72 6f 75  74 69 6e 65 20 61 6e 64  |name routine and|
00005c40  20 61 6c 73 6f 20 69 6e  20 63 6f 6d 70 61 63 74  | also in compact|
00005c50  20 72 6f 75 74 69 6e 65  2e 20 4e 6f 77 20 67 65  | routine. Now ge|
00005c60  6e 65 72 61 74 65 73 0a  20 20 20 20 20 20 61 6e  |nerates.      an|
00005c70  20 65 72 72 6f 72 20 69  66 20 79 6f 75 20 61 74  | error if you at|
00005c80  74 65 6d 70 74 20 74 6f  20 64 65 6c 65 74 65 20  |tempt to delete |
00005c90  74 68 65 20 43 53 44 2c  20 4c 69 62 72 61 72 79  |the CSD, Library|
00005ca0  20 6f 72 20 55 52 44 2e  20 41 6c 73 6f 2c 20 62  | or URD. Also, b|
00005cb0  75 67 0a 20 20 20 20 20  20 66 69 78 20 61 73 20  |ug.      fix as |
00005cc0  66 6f 72 20 76 30 2e 34  34 0a 76 31 2e 30 34 20  |for v0.44.v1.04 |
00005cd0  41 64 64 65 64 20 66 61  63 69 6c 69 74 79 20 74  |Added facility t|
00005ce0  6f 20 64 65 74 65 63 74  20 72 65 61 64 20 2f 20  |o detect read / |
00005cf0  77 72 69 74 65 20 76 65  72 73 69 6f 6e 20 66 72  |write version fr|
00005d00  6f 6d 20 53 57 49 20 22  41 72 63 46 53 5f 53 74  |om SWI "ArcFS_St|
00005d10  61 74 75 73 22 0a 76 31  2e 30 35 20 46 69 78 65  |atus".v1.05 Fixe|
00005d20  64 20 62 75 67 20 77 68  69 63 68 20 73 6f 6d 65  |d bug which some|
00005d30  74 69 6d 65 73 20 63 61  75 73 65 64 20 74 68 65  |times caused the|
00005d40  20 6c 6f 73 73 20 6f 66  20 61 64 64 69 74 69 6f  | loss of additio|
00005d50  6e 61 6c 20 64 69 72 65  63 74 6f 72 69 65 73 20  |nal directories |
00005d60  2f 0a 20 20 20 20 20 20  66 69 6c 65 73 20 77 68  |/.      files wh|
00005d70  65 6e 20 64 65 6c 65 74  65 69 6e 67 20 64 69 72  |en deleteing dir|
00005d80  65 63 74 6f 72 69 65 73  2e 20 46 69 6c 65 20 72  |ectories. File r|
00005d90  65 63 6f 76 65 72 79 20  70 72 6f 67 72 61 6d 20  |ecovery program |
00005da0  27 42 67 41 72 63 46 53  31 30 34 27 0a 20 20 20  |'BgArcFS104'.   |
00005db0  20 20 20 69 6e 63 6c 75  64 65 64 20 66 6f 72 20  |   included for |
00005dc0  66 69 6c 65 73 20 6c 6f  73 74 20 64 75 65 20 74  |files lost due t|
00005dd0  6f 20 74 68 69 73 20 62  75 67 2e 0a 0a a9 20 31  |o this bug.... 1|
00005de0  39 39 31 20 4d 2e 20 53  6d 69 74 68 0a           |991 M. Smith.|
00005ded

© Dominic Ford 2021–2025.

Our privacy policy is here.
Last updated: 01 May 2025, 21:49 UTC
Website designed by .