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

Documents/Re-Arrange

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/Re-Arrange
Read OK:
File size: 0665 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
-----------------------------

Compact
-------

When files are deleted or over-written in an archive, it is necessary to
recover the space left by these files so that the archive can be made as
small as possible. This is done by compacting the archive.

In order to compact an archive ArcFS needs a buffer to shift blocks of data
about. The larger the buffer, the faster the compact operation will be,
particularly if the archive is on a floppy disk. This buffer is set by the
command '*ArcFSBuffer <size in K>' and has a default size of 56K.

AutoCompact
-----------

By default, auto compact is switched on. This will automatically compact an
archive following a write operation. Since this can make write operations
take a lot longer, it is suggested that AutoCompact is switched off whilst a
lot of work is carried out on an archive. The archive should be manually
compacted at intervals during work on the archive and again when the work is
complete. AutoCompact should then be switched on again.

Making room for more headers
----------------------------

Since an archive contains a set of file headers (the catalogue) followed by
data, the data may need to be moved in order that more headers can be
accomodated. The number of gaps created at once is set by '*ArcFSGaps <no.
of gaps>' (default 10). If you are copying a large number of objects into an
archive, then you can speed the process up by making the number of gaps
equal to no. files + 2 * no. directories to copy. After copying the files
change the no. gaps back to 10. The buffer used to move the data is the same
as that used by compact.
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 43 6f 6d  |-----------..Com|
00000040  70 61 63 74 0a 2d 2d 2d  2d 2d 2d 2d 0a 0a 57 68  |pact.-------..Wh|
00000050  65 6e 20 66 69 6c 65 73  20 61 72 65 20 64 65 6c  |en files are del|
00000060  65 74 65 64 20 6f 72 20  6f 76 65 72 2d 77 72 69  |eted or over-wri|
00000070  74 74 65 6e 20 69 6e 20  61 6e 20 61 72 63 68 69  |tten in an archi|
00000080  76 65 2c 20 69 74 20 69  73 20 6e 65 63 65 73 73  |ve, it is necess|
00000090  61 72 79 20 74 6f 0a 72  65 63 6f 76 65 72 20 74  |ary to.recover t|
000000a0  68 65 20 73 70 61 63 65  20 6c 65 66 74 20 62 79  |he space left by|
000000b0  20 74 68 65 73 65 20 66  69 6c 65 73 20 73 6f 20  | these files so |
000000c0  74 68 61 74 20 74 68 65  20 61 72 63 68 69 76 65  |that the archive|
000000d0  20 63 61 6e 20 62 65 20  6d 61 64 65 20 61 73 0a  | can be made as.|
000000e0  73 6d 61 6c 6c 20 61 73  20 70 6f 73 73 69 62 6c  |small as possibl|
000000f0  65 2e 20 54 68 69 73 20  69 73 20 64 6f 6e 65 20  |e. This is done |
00000100  62 79 20 63 6f 6d 70 61  63 74 69 6e 67 20 74 68  |by compacting th|
00000110  65 20 61 72 63 68 69 76  65 2e 0a 0a 49 6e 20 6f  |e archive...In o|
00000120  72 64 65 72 20 74 6f 20  63 6f 6d 70 61 63 74 20  |rder to compact |
00000130  61 6e 20 61 72 63 68 69  76 65 20 41 72 63 46 53  |an archive ArcFS|
00000140  20 6e 65 65 64 73 20 61  20 62 75 66 66 65 72 20  | needs a buffer |
00000150  74 6f 20 73 68 69 66 74  20 62 6c 6f 63 6b 73 20  |to shift blocks |
00000160  6f 66 20 64 61 74 61 0a  61 62 6f 75 74 2e 20 54  |of data.about. T|
00000170  68 65 20 6c 61 72 67 65  72 20 74 68 65 20 62 75  |he larger the bu|
00000180  66 66 65 72 2c 20 74 68  65 20 66 61 73 74 65 72  |ffer, the faster|
00000190  20 74 68 65 20 63 6f 6d  70 61 63 74 20 6f 70 65  | the compact ope|
000001a0  72 61 74 69 6f 6e 20 77  69 6c 6c 20 62 65 2c 0a  |ration will be,.|
000001b0  70 61 72 74 69 63 75 6c  61 72 6c 79 20 69 66 20  |particularly if |
000001c0  74 68 65 20 61 72 63 68  69 76 65 20 69 73 20 6f  |the archive is o|
000001d0  6e 20 61 20 66 6c 6f 70  70 79 20 64 69 73 6b 2e  |n a floppy disk.|
000001e0  20 54 68 69 73 20 62 75  66 66 65 72 20 69 73 20  | This buffer is |
000001f0  73 65 74 20 62 79 20 74  68 65 0a 63 6f 6d 6d 61  |set by the.comma|
00000200  6e 64 20 27 2a 41 72 63  46 53 42 75 66 66 65 72  |nd '*ArcFSBuffer|
00000210  20 3c 73 69 7a 65 20 69  6e 20 4b 3e 27 20 61 6e  | <size in K>' an|
00000220  64 20 68 61 73 20 61 20  64 65 66 61 75 6c 74 20  |d has a default |
00000230  73 69 7a 65 20 6f 66 20  35 36 4b 2e 0a 0a 41 75  |size of 56K...Au|
00000240  74 6f 43 6f 6d 70 61 63  74 0a 2d 2d 2d 2d 2d 2d  |toCompact.------|
00000250  2d 2d 2d 2d 2d 0a 0a 42  79 20 64 65 66 61 75 6c  |-----..By defaul|
00000260  74 2c 20 61 75 74 6f 20  63 6f 6d 70 61 63 74 20  |t, auto compact |
00000270  69 73 20 73 77 69 74 63  68 65 64 20 6f 6e 2e 20  |is switched on. |
00000280  54 68 69 73 20 77 69 6c  6c 20 61 75 74 6f 6d 61  |This will automa|
00000290  74 69 63 61 6c 6c 79 20  63 6f 6d 70 61 63 74 20  |tically compact |
000002a0  61 6e 0a 61 72 63 68 69  76 65 20 66 6f 6c 6c 6f  |an.archive follo|
000002b0  77 69 6e 67 20 61 20 77  72 69 74 65 20 6f 70 65  |wing a write ope|
000002c0  72 61 74 69 6f 6e 2e 20  53 69 6e 63 65 20 74 68  |ration. Since th|
000002d0  69 73 20 63 61 6e 20 6d  61 6b 65 20 77 72 69 74  |is can make writ|
000002e0  65 20 6f 70 65 72 61 74  69 6f 6e 73 0a 74 61 6b  |e operations.tak|
000002f0  65 20 61 20 6c 6f 74 20  6c 6f 6e 67 65 72 2c 20  |e a lot longer, |
00000300  69 74 20 69 73 20 73 75  67 67 65 73 74 65 64 20  |it is suggested |
00000310  74 68 61 74 20 41 75 74  6f 43 6f 6d 70 61 63 74  |that AutoCompact|
00000320  20 69 73 20 73 77 69 74  63 68 65 64 20 6f 66 66  | is switched off|
00000330  20 77 68 69 6c 73 74 20  61 0a 6c 6f 74 20 6f 66  | whilst a.lot of|
00000340  20 77 6f 72 6b 20 69 73  20 63 61 72 72 69 65 64  | work is carried|
00000350  20 6f 75 74 20 6f 6e 20  61 6e 20 61 72 63 68 69  | out on an archi|
00000360  76 65 2e 20 54 68 65 20  61 72 63 68 69 76 65 20  |ve. The archive |
00000370  73 68 6f 75 6c 64 20 62  65 20 6d 61 6e 75 61 6c  |should be manual|
00000380  6c 79 0a 63 6f 6d 70 61  63 74 65 64 20 61 74 20  |ly.compacted at |
00000390  69 6e 74 65 72 76 61 6c  73 20 64 75 72 69 6e 67  |intervals during|
000003a0  20 77 6f 72 6b 20 6f 6e  20 74 68 65 20 61 72 63  | work on the arc|
000003b0  68 69 76 65 20 61 6e 64  20 61 67 61 69 6e 20 77  |hive and again w|
000003c0  68 65 6e 20 74 68 65 20  77 6f 72 6b 20 69 73 0a  |hen the work is.|
000003d0  63 6f 6d 70 6c 65 74 65  2e 20 41 75 74 6f 43 6f  |complete. AutoCo|
000003e0  6d 70 61 63 74 20 73 68  6f 75 6c 64 20 74 68 65  |mpact should the|
000003f0  6e 20 62 65 20 73 77 69  74 63 68 65 64 20 6f 6e  |n be switched on|
00000400  20 61 67 61 69 6e 2e 0a  0a 4d 61 6b 69 6e 67 20  | again...Making |
00000410  72 6f 6f 6d 20 66 6f 72  20 6d 6f 72 65 20 68 65  |room for more he|
00000420  61 64 65 72 73 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |aders.----------|
00000430  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000440  2d 2d 0a 0a 53 69 6e 63  65 20 61 6e 20 61 72 63  |--..Since an arc|
00000450  68 69 76 65 20 63 6f 6e  74 61 69 6e 73 20 61 20  |hive contains a |
00000460  73 65 74 20 6f 66 20 66  69 6c 65 20 68 65 61 64  |set of file head|
00000470  65 72 73 20 28 74 68 65  20 63 61 74 61 6c 6f 67  |ers (the catalog|
00000480  75 65 29 20 66 6f 6c 6c  6f 77 65 64 20 62 79 0a  |ue) followed by.|
00000490  64 61 74 61 2c 20 74 68  65 20 64 61 74 61 20 6d  |data, the data m|
000004a0  61 79 20 6e 65 65 64 20  74 6f 20 62 65 20 6d 6f  |ay need to be mo|
000004b0  76 65 64 20 69 6e 20 6f  72 64 65 72 20 74 68 61  |ved in order tha|
000004c0  74 20 6d 6f 72 65 20 68  65 61 64 65 72 73 20 63  |t more headers c|
000004d0  61 6e 20 62 65 0a 61 63  63 6f 6d 6f 64 61 74 65  |an be.accomodate|
000004e0  64 2e 20 54 68 65 20 6e  75 6d 62 65 72 20 6f 66  |d. The number of|
000004f0  20 67 61 70 73 20 63 72  65 61 74 65 64 20 61 74  | gaps created at|
00000500  20 6f 6e 63 65 20 69 73  20 73 65 74 20 62 79 20  | once is set by |
00000510  27 2a 41 72 63 46 53 47  61 70 73 20 3c 6e 6f 2e  |'*ArcFSGaps <no.|
00000520  0a 6f 66 20 67 61 70 73  3e 27 20 28 64 65 66 61  |.of gaps>' (defa|
00000530  75 6c 74 20 31 30 29 2e  20 49 66 20 79 6f 75 20  |ult 10). If you |
00000540  61 72 65 20 63 6f 70 79  69 6e 67 20 61 20 6c 61  |are copying a la|
00000550  72 67 65 20 6e 75 6d 62  65 72 20 6f 66 20 6f 62  |rge number of ob|
00000560  6a 65 63 74 73 20 69 6e  74 6f 20 61 6e 0a 61 72  |jects into an.ar|
00000570  63 68 69 76 65 2c 20 74  68 65 6e 20 79 6f 75 20  |chive, then you |
00000580  63 61 6e 20 73 70 65 65  64 20 74 68 65 20 70 72  |can speed the pr|
00000590  6f 63 65 73 73 20 75 70  20 62 79 20 6d 61 6b 69  |ocess up by maki|
000005a0  6e 67 20 74 68 65 20 6e  75 6d 62 65 72 20 6f 66  |ng the number of|
000005b0  20 67 61 70 73 0a 65 71  75 61 6c 20 74 6f 20 6e  | gaps.equal to n|
000005c0  6f 2e 20 66 69 6c 65 73  20 2b 20 32 20 2a 20 6e  |o. files + 2 * n|
000005d0  6f 2e 20 64 69 72 65 63  74 6f 72 69 65 73 20 74  |o. directories t|
000005e0  6f 20 63 6f 70 79 2e 20  41 66 74 65 72 20 63 6f  |o copy. After co|
000005f0  70 79 69 6e 67 20 74 68  65 20 66 69 6c 65 73 0a  |pying the files.|
00000600  63 68 61 6e 67 65 20 74  68 65 20 6e 6f 2e 20 67  |change the no. g|
00000610  61 70 73 20 62 61 63 6b  20 74 6f 20 31 30 2e 20  |aps back to 10. |
00000620  54 68 65 20 62 75 66 66  65 72 20 75 73 65 64 20  |The buffer used |
00000630  74 6f 20 6d 6f 76 65 20  74 68 65 20 64 61 74 61  |to move the data|
00000640  20 69 73 20 74 68 65 20  73 61 6d 65 0a 61 73 20  | is the same.as |
00000650  74 68 61 74 20 75 73 65  64 20 62 79 20 63 6f 6d  |that used by com|
00000660  70 61 63 74 2e                                    |pact.|
00000665