Home » Archimedes archive » Micro User » MU 1992-09.adf » ArcFSExtra » Documents/OldSWIs

Documents/OldSWIs

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 1992-09.adf » ArcFSExtra
Filename: Documents/OldSWIs
Read OK:
File size: 12DE bytes
Load address: 0000
Exec address: 0000
Duplicates

There is 1 duplicate copy of this file in the archive:

File contents
ArcFS 0.50/2.00 Documentation
-----------------------------

Old Software Interrupts
-----------------------

The following Software Interrupts are supported for compatablity with older
versions of ArcFS only. They must NOT be used unless compatability with older
versions is required.

The allocated SWI chunk base is &437C0.

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

SWI "ArcFS_ArchiveInfo"                                          &437C0
-----------------------                                          ------

On entry: R0=archive number

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. The first archive has number zero. If R0 is zero on exit then
there are not this many open archives.

Unlike previous versions of ArcFS there is no limit to the number of open
archives.

In order to maintain compatability with older versions when constructing a
list of open archives, you should call this SWI repeatedly, with R0=0 the
first time and increasing it by 1 each time. If the SWI returns with R0
pointing to a null string then you should miss out that archive (an empty
slot in previous versions of ArcFS). If the SWI returns with R0=0 then the
list is complete. (This will be when you try to get details of the 6th
archive in previous versions).

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

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 'This archive is already open
with a different name' or 'An archive with this name is already open'.

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

SWI "ArcFS_CloseArchive"                                         &437C3
------------------------                                         ------

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

On exit : R0 preserved

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.

*****************************************************************************
00000000  41 72 63 46 53 20 30 2e  35 30 2f 32 2e 30 30 20  |ArcFS 0.50/2.00 |
00000010  44 6f 63 75 6d 65 6e 74  61 74 69 6f 6e 0a 2d 2d  |Documentation.--|
00000020  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000030  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 0a 4f 6c 64  |-----------..Old|
00000040  20 53 6f 66 74 77 61 72  65 20 49 6e 74 65 72 72  | Software Interr|
00000050  75 70 74 73 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |upts.-----------|
00000060  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 0a 0a 54 68  |------------..Th|
00000070  65 20 66 6f 6c 6c 6f 77  69 6e 67 20 53 6f 66 74  |e following Soft|
00000080  77 61 72 65 20 49 6e 74  65 72 72 75 70 74 73 20  |ware Interrupts |
00000090  61 72 65 20 73 75 70 70  6f 72 74 65 64 20 66 6f  |are supported fo|
000000a0  72 20 63 6f 6d 70 61 74  61 62 6c 69 74 79 20 77  |r compatablity w|
000000b0  69 74 68 20 6f 6c 64 65  72 0a 76 65 72 73 69 6f  |ith older.versio|
000000c0  6e 73 20 6f 66 20 41 72  63 46 53 20 6f 6e 6c 79  |ns of ArcFS only|
000000d0  2e 20 54 68 65 79 20 6d  75 73 74 20 4e 4f 54 20  |. They must NOT |
000000e0  62 65 20 75 73 65 64 20  75 6e 6c 65 73 73 20 63  |be used unless c|
000000f0  6f 6d 70 61 74 61 62 69  6c 69 74 79 20 77 69 74  |ompatability wit|
00000100  68 20 6f 6c 64 65 72 0a  76 65 72 73 69 6f 6e 73  |h older.versions|
00000110  20 69 73 20 72 65 71 75  69 72 65 64 2e 0a 0a 54  | is required...T|
00000120  68 65 20 61 6c 6c 6f 63  61 74 65 64 20 53 57 49  |he allocated SWI|
00000130  20 63 68 75 6e 6b 20 62  61 73 65 20 69 73 20 26  | chunk base is &|
00000140  34 33 37 43 30 2e 0a 0a  2a 2a 2a 2a 2a 2a 2a 2a  |437C0...********|
00000150  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000190  2a 2a 2a 2a 2a 0a 0a 53  57 49 20 22 41 72 63 46  |*****..SWI "ArcF|
000001a0  53 5f 41 72 63 68 69 76  65 49 6e 66 6f 22 20 20  |S_ArchiveInfo"  |
000001b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000001d0  20 20 20 20 20 20 20 20  26 34 33 37 43 30 0a 2d  |        &437C0.-|
000001e0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000001f0  2d 2d 2d 2d 2d 2d 20 20  20 20 20 20 20 20 20 20  |------          |
00000200  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000220  2d 2d 2d 2d 2d 2d 0a 0a  4f 6e 20 65 6e 74 72 79  |------..On entry|
00000230  3a 20 52 30 3d 61 72 63  68 69 76 65 20 6e 75 6d  |: R0=archive num|
00000240  62 65 72 0a 0a 4f 6e 20  65 78 69 74 20 3a 20 52  |ber..On exit : R|
00000250  30 3d 70 6f 69 6e 74 65  72 20 74 6f 20 61 72 63  |0=pointer to arc|
00000260  68 69 76 65 20 6e 61 6d  65 20 28 6e 75 6c 6c 20  |hive name (null |
00000270  74 65 72 6d 69 6e 61 74  65 64 29 0a a0 20 20 20  |terminated)..   |
00000280  20 20 20 20 20 20 52 31  3d 70 6f 69 6e 74 65 72  |      R1=pointer|
00000290  20 74 6f 20 61 72 63 68  69 76 65 20 70 61 74 68  | to archive path|
000002a0  6e 61 6d 65 20 28 6e 75  6c 6c 20 74 65 72 6d 69  |name (null termi|
000002b0  6e 61 74 65 64 29 0a 20  20 20 20 20 20 20 20 20  |nated).         |
000002c0  20 52 32 3d 70 6f 69 6e  74 65 72 20 74 6f 20 61  | R2=pointer to a|
000002d0  72 63 68 69 76 65 20 68  65 61 64 65 72 73 20 28  |rchive headers (|
000002e0  69 6e 74 65 72 6e 61 6c  20 75 73 65 20 6f 6e 6c  |internal use onl|
000002f0  79 29 0a 0a 54 68 69 73  20 53 57 49 20 67 69 76  |y)..This SWI giv|
00000300  65 73 20 74 68 65 20 6e  61 6d 65 20 61 6e 64 20  |es the name and |
00000310  70 61 74 68 6e 61 6d 65  20 6f 66 20 74 68 65 20  |pathname of the |
00000320  61 72 63 68 69 76 65 20  77 68 6f 73 65 20 6e 75  |archive whose nu|
00000330  6d 62 65 72 20 69 73 20  67 69 76 65 6e 20 62 79  |mber is given by|
00000340  0a 52 30 20 6f 6e 20 65  6e 74 72 79 2e 20 54 68  |.R0 on entry. Th|
00000350  65 20 66 69 72 73 74 20  61 72 63 68 69 76 65 20  |e first archive |
00000360  68 61 73 20 6e 75 6d 62  65 72 20 7a 65 72 6f 2e  |has number zero.|
00000370  20 49 66 20 52 30 20 69  73 20 7a 65 72 6f 20 6f  | If R0 is zero o|
00000380  6e 20 65 78 69 74 20 74  68 65 6e 0a 74 68 65 72  |n exit then.ther|
00000390  65 20 61 72 65 20 6e 6f  74 20 74 68 69 73 20 6d  |e are not this m|
000003a0  61 6e 79 20 6f 70 65 6e  20 61 72 63 68 69 76 65  |any open archive|
000003b0  73 2e 0a 0a 55 6e 6c 69  6b 65 20 70 72 65 76 69  |s...Unlike previ|
000003c0  6f 75 73 20 76 65 72 73  69 6f 6e 73 20 6f 66 20  |ous versions of |
000003d0  41 72 63 46 53 20 74 68  65 72 65 20 69 73 20 6e  |ArcFS there is n|
000003e0  6f 20 6c 69 6d 69 74 20  74 6f 20 74 68 65 20 6e  |o limit to the n|
000003f0  75 6d 62 65 72 20 6f 66  20 6f 70 65 6e 0a 61 72  |umber of open.ar|
00000400  63 68 69 76 65 73 2e 0a  0a 49 6e 20 6f 72 64 65  |chives...In orde|
00000410  72 20 74 6f 20 6d 61 69  6e 74 61 69 6e 20 63 6f  |r to maintain co|
00000420  6d 70 61 74 61 62 69 6c  69 74 79 20 77 69 74 68  |mpatability with|
00000430  20 6f 6c 64 65 72 20 76  65 72 73 69 6f 6e 73 20  | older versions |
00000440  77 68 65 6e 20 63 6f 6e  73 74 72 75 63 74 69 6e  |when constructin|
00000450  67 20 61 0a 6c 69 73 74  20 6f 66 20 6f 70 65 6e  |g a.list of open|
00000460  20 61 72 63 68 69 76 65  73 2c 20 79 6f 75 20 73  | archives, you s|
00000470  68 6f 75 6c 64 20 63 61  6c 6c 20 74 68 69 73 20  |hould call this |
00000480  53 57 49 20 72 65 70 65  61 74 65 64 6c 79 2c 20  |SWI repeatedly, |
00000490  77 69 74 68 20 52 30 3d  30 20 74 68 65 0a 66 69  |with R0=0 the.fi|
000004a0  72 73 74 20 74 69 6d 65  20 61 6e 64 20 69 6e 63  |rst time and inc|
000004b0  72 65 61 73 69 6e 67 20  69 74 20 62 79 20 31 20  |reasing it by 1 |
000004c0  65 61 63 68 20 74 69 6d  65 2e 20 49 66 20 74 68  |each time. If th|
000004d0  65 20 53 57 49 20 72 65  74 75 72 6e 73 20 77 69  |e SWI returns wi|
000004e0  74 68 20 52 30 0a 70 6f  69 6e 74 69 6e 67 20 74  |th R0.pointing t|
000004f0  6f 20 61 20 6e 75 6c 6c  20 73 74 72 69 6e 67 20  |o a null string |
00000500  74 68 65 6e 20 79 6f 75  20 73 68 6f 75 6c 64 20  |then you should |
00000510  6d 69 73 73 20 6f 75 74  20 74 68 61 74 20 61 72  |miss out that ar|
00000520  63 68 69 76 65 20 28 61  6e 20 65 6d 70 74 79 0a  |chive (an empty.|
00000530  73 6c 6f 74 20 69 6e 20  70 72 65 76 69 6f 75 73  |slot in previous|
00000540  20 76 65 72 73 69 6f 6e  73 20 6f 66 20 41 72 63  | versions of Arc|
00000550  46 53 29 2e 20 49 66 20  74 68 65 20 53 57 49 20  |FS). If the SWI |
00000560  72 65 74 75 72 6e 73 20  77 69 74 68 20 52 30 3d  |returns with R0=|
00000570  30 20 74 68 65 6e 20 74  68 65 0a 6c 69 73 74 20  |0 then the.list |
00000580  69 73 20 63 6f 6d 70 6c  65 74 65 2e 20 28 54 68  |is complete. (Th|
00000590  69 73 20 77 69 6c 6c 20  62 65 20 77 68 65 6e 20  |is will be when |
000005a0  79 6f 75 20 74 72 79 20  74 6f 20 67 65 74 20 64  |you try to get d|
000005b0  65 74 61 69 6c 73 20 6f  66 20 74 68 65 20 36 74  |etails of the 6t|
000005c0  68 0a 61 72 63 68 69 76  65 20 69 6e 20 70 72 65  |h.archive in pre|
000005d0  76 69 6f 75 73 20 76 65  72 73 69 6f 6e 73 29 2e  |vious versions).|
000005e0  0a 0a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |..**************|
000005f0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000620  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 0a  |***************.|
00000630  0a 53 57 49 20 22 41 72  63 46 53 5f 53 74 61 74  |.SWI "ArcFS_Stat|
00000640  75 73 22 20 20 20 20 20  20 20 20 20 20 20 20 20  |us"             |
00000650  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000670  20 20 26 34 33 37 43 31  0a 2d 2d 2d 2d 2d 2d 2d  |  &437C1.-------|
00000680  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 20 20 20 20 20  |-----------     |
00000690  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000006b0  20 20 20 20 20 20 20 20  20 20 2d 2d 2d 2d 2d 2d  |          ------|
000006c0  0a 0a 4f 6e 20 65 6e 74  72 79 3a 20 2d 0a 0a 4f  |..On entry: -..O|
000006d0  6e 20 65 78 69 74 20 3a  20 52 30 3d 73 74 61 74  |n exit : R0=stat|
000006e0  75 73 20 28 26 76 76 62  62 66 66 65 65 29 0a 0a  |us (&vvbbffee)..|
000006f0  54 68 69 73 20 72 65 74  75 72 6e 73 20 74 68 65  |This returns the|
00000700  20 63 75 72 72 65 6e 74  20 73 74 61 74 75 73 20  | current status |
00000710  6f 66 20 41 72 63 46 53  2e 0a 0a 76 76 20 69 73  |of ArcFS...vv is|
00000720  20 26 46 46 20 66 6f 72  20 72 65 61 64 20 2f 20  | &FF for read / |
00000730  77 72 69 74 65 20 76 65  72 73 69 6f 6e 20 6f 72  |write version or|
00000740  20 26 30 30 20 66 6f 72  20 72 65 61 64 20 6f 6e  | &00 for read on|
00000750  6c 79 20 76 65 72 73 69  6f 6e 0a 62 62 20 69 73  |ly version.bb is|
00000760  20 6e 6f 2e 20 6f 66 20  62 69 74 73 20 66 6f 72  | no. of bits for|
00000770  20 63 72 75 6e 63 68 20  2f 20 63 6f 6d 70 72 65  | crunch / compre|
00000780  73 73 20 66 6f 72 6d 61  74 73 20 28 30 20 6f 74  |ss formats (0 ot|
00000790  68 65 72 77 69 73 65 29  0a 66 66 20 69 73 20 74  |herwise).ff is t|
000007a0  68 65 20 63 6f 6d 70 72  65 73 73 69 6f 6e 20 66  |he compression f|
000007b0  6f 72 6d 61 74 20 28 73  65 65 20 53 57 49 20 22  |ormat (see SWI "|
000007c0  41 72 63 46 53 5f 43 6f  6d 70 72 65 73 73 69 6f  |ArcFS_Compressio|
000007d0  6e 22 2c 20 62 65 6c 6f  77 29 0a 0a 54 68 65 20  |n", below)..The |
000007e0  62 6f 74 74 6f 6d 20 62  69 74 20 6f 66 20 65 65  |bottom bit of ee|
000007f0  20 69 73 20 73 65 74 20  69 66 20 66 69 6c 65 20  | is set if file |
00000800  67 61 72 62 6c 65 20 69  73 20 73 65 74 20 6f 72  |garble is set or|
00000810  20 63 6c 65 61 72 20 6f  74 68 65 72 77 69 73 65  | clear otherwise|
00000820  2e 20 54 68 65 0a 6f 74  68 65 72 20 62 69 74 73  |. The.other bits|
00000830  20 6f 66 20 65 65 20 61  72 65 20 72 65 73 65 72  | of ee are reser|
00000840  76 65 64 20 66 6f 72 20  66 75 74 75 72 65 20 65  |ved for future e|
00000850  78 70 61 6e 73 69 6f 6e  2e 0a 0a 2a 2a 2a 2a 2a  |xpansion...*****|
00000860  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000008a0  2a 2a 2a 2a 2a 2a 2a 2a  0a 0a 53 57 49 20 22 41  |********..SWI "A|
000008b0  72 63 46 53 5f 4f 70 65  6e 41 72 63 68 69 76 65  |rcFS_OpenArchive|
000008c0  22 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |"               |
000008d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000008e0  20 20 20 20 20 20 20 20  20 20 20 26 34 33 37 43  |           &437C|
000008f0  32 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |2.--------------|
00000900  2d 2d 2d 2d 2d 2d 2d 2d  2d 20 20 20 20 20 20 20  |---------       |
00000910  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000930  20 20 20 2d 2d 2d 2d 2d  2d 0a 0a 4f 6e 20 65 6e  |   ------..On en|
00000940  74 72 79 3a 20 52 30 3d  70 6f 69 6e 74 65 72 20  |try: R0=pointer |
00000950  74 6f 20 70 61 74 68 6e  61 6d 65 20 28 63 6f 6e  |to pathname (con|
00000960  74 72 6f 6c 20 74 65 72  6d 69 6e 61 74 65 64 29  |trol terminated)|
00000970  0a 20 20 20 20 20 20 20  20 20 20 52 31 3d 70 6f  |.          R1=po|
00000980  69 6e 74 65 72 20 74 6f  20 6e 61 6d 65 20 28 63  |inter to name (c|
00000990  6f 6e 74 72 6f 6c 20 74  65 72 6d 69 6e 61 74 65  |ontrol terminate|
000009a0  64 29 0a 0a 4f 6e 20 65  78 69 74 20 3a 20 52 30  |d)..On exit : R0|
000009b0  20 26 20 52 31 20 70 72  65 73 65 72 76 65 64 0a  | & R1 preserved.|
000009c0  0a 54 68 69 73 20 53 57  49 20 6f 70 65 6e 73 20  |.This SWI opens |
000009d0  61 6e 20 61 72 63 68 69  76 65 2e 20 50 6f 73 73  |an archive. Poss|
000009e0  69 62 6c 65 20 65 72 72  6f 72 73 20 61 72 65 20  |ible errors are |
000009f0  27 54 68 69 73 20 61 72  63 68 69 76 65 20 69 73  |'This archive is|
00000a00  20 61 6c 72 65 61 64 79  20 6f 70 65 6e 0a 77 69  | already open.wi|
00000a10  74 68 20 61 20 64 69 66  66 65 72 65 6e 74 20 6e  |th a different n|
00000a20  61 6d 65 27 20 6f 72 20  27 41 6e 20 61 72 63 68  |ame' or 'An arch|
00000a30  69 76 65 20 77 69 74 68  20 74 68 69 73 20 6e 61  |ive with this na|
00000a40  6d 65 20 69 73 20 61 6c  72 65 61 64 79 20 6f 70  |me is already op|
00000a50  65 6e 27 2e 0a 0a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |en'...**********|
00000a60  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000aa0  2a 2a 2a 0a 0a 53 57 49  20 22 41 72 63 46 53 5f  |***..SWI "ArcFS_|
00000ab0  43 6c 6f 73 65 41 72 63  68 69 76 65 22 20 20 20  |CloseArchive"   |
00000ac0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000ae0  20 20 20 20 20 20 26 34  33 37 43 33 0a 2d 2d 2d  |      &437C3.---|
00000af0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000b00  2d 2d 2d 2d 2d 20 20 20  20 20 20 20 20 20 20 20  |-----           |
00000b10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000b20  20 20 20 20 20 20 20 20  20 20 20 20 20 20 2d 2d  |              --|
00000b30  2d 2d 2d 2d 0a 0a 4f 6e  20 65 6e 74 72 79 3a 20  |----..On entry: |
00000b40  52 30 3d 70 6f 69 6e 74  65 72 20 74 6f 20 6e 61  |R0=pointer to na|
00000b50  6d 65 20 28 63 6f 6e 74  72 6f 6c 20 74 65 72 6d  |me (control term|
00000b60  69 6e 61 74 65 64 29 0a  0a 4f 6e 20 65 78 69 74  |inated)..On exit|
00000b70  20 3a 20 52 30 20 70 72  65 73 65 72 76 65 64 0a  | : R0 preserved.|
00000b80  0a 54 68 69 73 20 53 57  49 20 63 6c 6f 73 65 73  |.This SWI closes|
00000b90  20 61 6e 20 61 72 63 68  69 76 65 2e 20 50 6f 73  | an archive. Pos|
00000ba0  73 69 62 6c 65 20 65 72  72 6f 72 20 69 73 20 27  |sible error is '|
00000bb0  4e 6f 20 61 72 63 68 69  76 65 20 77 69 74 68 20  |No archive with |
00000bc0  74 68 69 73 20 6e 61 6d  65 20 69 73 0a 6f 70 65  |this name is.ope|
00000bd0  6e 27 2e 0a 0a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |n'...***********|
00000be0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000c20  2a 2a 0a 0a 53 57 49 20  22 41 72 63 46 53 5f 45  |**..SWI "ArcFS_E|
00000c30  6e 63 72 79 70 74 69 6f  6e 22 20 20 20 20 20 20  |ncryption"      |
00000c40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000c60  20 20 20 20 20 26 34 33  37 43 34 0a 2d 2d 2d 2d  |     &437C4.----|
00000c70  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000c80  2d 2d 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |--              |
00000c90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000ca0  20 20 20 20 20 20 20 20  20 20 20 20 20 2d 2d 2d  |             ---|
00000cb0  2d 2d 2d 0a 0a 4f 6e 20  65 6e 74 72 79 3a 20 52  |---..On entry: R|
00000cc0  30 3d 65 6e 63 72 79 70  74 69 6f 6e 20 6d 65 74  |0=encryption met|
00000cd0  68 6f 64 20 28 6e 6f 6e  65 3d 30 2c 20 67 61 72  |hod (none=0, gar|
00000ce0  62 6c 65 3d 31 29 0a 20  20 20 20 20 20 20 20 20  |ble=1).         |
00000cf0  20 52 31 3d 70 6f 69 6e  74 65 72 20 74 6f 20 70  | R1=pointer to p|
00000d00  61 73 73 77 6f 72 64 20  28 63 6f 6e 74 72 6f 6c  |assword (control|
00000d10  20 74 65 72 6d 61 69 6e  61 74 65 64 2c 20 75 70  | termainated, up|
00000d20  20 74 6f 20 33 32 20 62  79 74 65 73 29 0a 0a 4f  | to 32 bytes)..O|
00000d30  6e 20 65 78 69 74 20 3a  20 52 30 20 26 20 52 31  |n exit : R0 & R1|
00000d40  20 70 72 65 73 65 72 76  65 64 0a 0a 54 68 69 73  | preserved..This|
00000d50  20 53 57 49 20 73 65 74  73 20 74 68 65 20 65 6e  | SWI sets the en|
00000d60  63 72 79 70 74 69 6f 6e  20 6d 65 74 68 6f 64 20  |cryption method |
00000d70  61 6e 64 20 70 61 73 73  77 6f 72 64 20 75 73 65  |and password use|
00000d80  64 2e 0a 0a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |d...************|
00000d90  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000dd0  2a 0a 0a 53 57 49 20 22  41 72 63 46 53 5f 43 6f  |*..SWI "ArcFS_Co|
00000de0  6d 70 72 65 73 73 69 6f  6e 22 20 20 20 20 20 20  |mpression"      |
00000df0  20 20 20 20 20 72 2f 77  20 76 65 72 73 69 6f 6e  |     r/w version|
00000e00  20 6f 6e 6c 79 20 20 20  20 20 20 20 20 20 20 20  | only           |
00000e10  20 20 20 20 26 34 33 37  43 35 0a 2d 2d 2d 2d 2d  |    &437C5.-----|
00000e20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000e30  2d 2d 20 20 20 20 20 20  20 20 20 20 20 2d 2d 2d  |--           ---|
00000e40  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 20 20 20  |-------------   |
00000e50  20 20 20 20 20 20 20 20  20 20 20 20 2d 2d 2d 2d  |            ----|
00000e60  2d 2d 0a 0a 4f 6e 20 65  6e 74 72 79 3a 20 52 30  |--..On entry: R0|
00000e70  3d 63 6f 6d 70 72 65 73  73 69 6f 6e 20 66 6f 72  |=compression for|
00000e80  6d 61 74 20 28 26 38 32  2c 26 38 33 2c 26 38 38  |mat (&82,&83,&88|
00000e90  20 6f 72 20 26 46 46 29  0a 20 20 20 20 20 20 20  | or &FF).       |
00000ea0  20 20 20 52 31 3d 6e 6f  2e 20 62 69 74 73 20 66  |   R1=no. bits f|
00000eb0  6f 72 20 26 38 38 20 61  6e 64 20 26 46 46 0a 0a  |or &88 and &FF..|
00000ec0  4f 6e 20 65 78 69 74 20  3a 20 52 30 20 26 20 52  |On exit : R0 & R|
00000ed0  31 20 70 72 65 73 65 72  76 65 64 0a 0a 54 68 69  |1 preserved..Thi|
00000ee0  73 20 53 57 49 20 73 65  74 73 20 74 68 65 20 64  |s SWI sets the d|
00000ef0  61 74 61 20 63 6f 6d 70  72 65 73 73 69 6f 6e 20  |ata compression |
00000f00  66 6f 72 6d 61 74 20 74  6f 20 62 65 20 75 73 65  |format to be use|
00000f10  64 3a 0a 20 20 26 38 32  20 53 74 6f 72 65 0a 20  |d:.  &82 Store. |
00000f20  20 26 38 33 20 50 61 63  6b 0a 20 20 26 38 38 20  | &83 Pack.  &88 |
00000f30  43 72 75 6e 63 68 0a 20  20 26 46 46 20 43 6f 6d  |Crunch.  &FF Com|
00000f40  70 72 65 73 73 0a 50 6f  73 73 69 62 6c 65 20 65  |press.Possible e|
00000f50  72 72 6f 72 73 20 61 72  65 20 27 42 69 74 73 20  |rrors are 'Bits |
00000f60  72 61 6e 67 65 20 65 72  72 6f 72 27 20 61 6e 64  |range error' and|
00000f70  20 27 55 6e 6b 6e 6f 77  6e 20 63 6f 6d 70 72 65  | 'Unknown compre|
00000f80  73 73 69 6f 6e 20 66 6f  72 6d 61 74 27 0a 0a 2a  |ssion format'..*|
00000f90  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000fd0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 0a 0a 53 57  |************..SW|
00000fe0  49 20 22 41 72 63 46 53  5f 43 72 65 61 74 65 41  |I "ArcFS_CreateA|
00000ff0  72 63 68 69 76 65 22 20  20 20 20 20 20 20 20 20  |rchive"         |
00001000  72 2f 77 20 76 65 72 73  69 6f 6e 20 6f 6e 6c 79  |r/w version only|
00001010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 26  |               &|
00001020  34 33 37 43 36 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |437C6.----------|
00001030  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 20  |--------------- |
00001040  20 20 20 20 20 20 20 20  2d 2d 2d 2d 2d 2d 2d 2d  |        --------|
00001050  2d 2d 2d 2d 2d 2d 2d 2d  20 20 20 20 20 20 20 20  |--------        |
00001060  20 20 20 20 20 20 20 2d  2d 2d 2d 2d 2d 0a 0a 4f  |       ------..O|
00001070  6e 20 65 6e 74 72 79 3a  20 52 30 3d 70 6f 69 6e  |n entry: R0=poin|
00001080  74 65 72 20 74 6f 20 70  61 74 68 6e 61 6d 65 20  |ter to pathname |
00001090  66 6f 72 20 6e 65 77 20  61 72 63 68 69 76 65 0a  |for new archive.|
000010a0  0a 4f 6e 20 65 78 69 74  20 3a 20 52 30 20 69 73  |.On exit : R0 is|
000010b0  20 70 72 65 73 65 72 76  65 64 0a 0a 54 68 69 73  | preserved..This|
000010c0  20 53 57 49 20 63 72 65  61 74 65 73 20 28 62 75  | SWI creates (bu|
000010d0  74 20 64 6f 65 73 20 6e  6f 74 20 6f 70 65 6e 29  |t does not open)|
000010e0  20 61 20 6e 65 77 20 61  72 63 68 69 76 65 2e 0a  | a new archive..|
000010f0  0a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |.***************|
00001100  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001130  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 0a 0a  |**************..|
00001140  53 57 49 20 22 41 72 63  46 53 5f 43 6f 6d 70 61  |SWI "ArcFS_Compa|
00001150  63 74 22 20 20 20 20 20  20 20 20 20 20 20 20 20  |ct"             |
00001160  20 20 72 2f 77 20 76 65  72 73 69 6f 6e 20 6f 6e  |  r/w version on|
00001170  6c 79 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |ly              |
00001180  20 26 34 33 37 43 37 0a  2d 2d 2d 2d 2d 2d 2d 2d  | &437C7.--------|
00001190  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 20 20 20 20 20  |-----------     |
000011a0  20 20 20 20 20 20 20 20  20 20 2d 2d 2d 2d 2d 2d  |          ------|
000011b0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 20 20 20 20 20 20  |----------      |
000011c0  20 20 20 20 20 20 20 20  20 2d 2d 2d 2d 2d 2d 0a  |         ------.|
000011d0  0a 4f 6e 20 65 6e 74 72  79 3a 20 52 30 3d 70 6f  |.On entry: R0=po|
000011e0  69 6e 74 65 72 20 74 6f  20 61 72 63 68 69 76 65  |inter to archive|
000011f0  20 6e 61 6d 65 20 6f 72  20 30 0a 0a 4f 6e 20 65  | name or 0..On e|
00001200  78 69 74 20 3a 20 52 30  20 69 73 20 70 72 65 73  |xit : R0 is pres|
00001210  65 72 76 65 64 0a 0a 54  68 69 73 20 53 57 49 20  |erved..This SWI |
00001220  63 6f 6d 70 61 63 74 73  20 74 68 65 20 6e 61 6d  |compacts the nam|
00001230  65 64 20 61 72 63 68 69  76 65 20 28 6f 72 20 74  |ed archive (or t|
00001240  68 61 74 20 63 6f 6e 74  61 69 6e 69 6e 67 20 74  |hat containing t|
00001250  68 65 20 43 53 44 29 20  74 6f 20 72 65 6d 6f 76  |he CSD) to remov|
00001260  65 64 0a 67 61 70 73 20  6c 65 66 74 20 62 79 20  |ed.gaps left by |
00001270  64 65 6c 65 74 69 6f 6e  73 20 61 6e 64 20 66 69  |deletions and fi|
00001280  6c 65 20 6f 76 65 72 77  72 69 74 65 73 2e 0a 0a  |le overwrites...|
00001290  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000012d0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 0a        |*************.|
000012de