-----------------------------------------------------------------------------

Contents:

This archive is the developer's distribution of the Memory Library, the
virtual memory library for the Amiga. You'll find include files, example
sources and manuals here. The library itself is not included in this
archive, but in the "MemLib.lha" distribution, on Aminet.

-----------------------------------------------------------------------------

Purpose and goal of the memory.library:

The memory.library is the second step stone of the mmu.library project. The
purpose of this library is to provide virtual memory for the AmigaOs 
environment. The requirement for making the memory.library working is to
install the mmu.library.


What does the memory.library, and what not?

The memory.library is *not* a system patch in the spirit of VMM or GigaMem.
It will not provide virtual memory automatically to old programs. The AmigaOs
is not prepared to handle this kind of virtual memory due to certain re-
strictions arising from access exception handling. However, "virtual memory
on demand" is possible - that is, programs are able to allocate virtual memory
from this library, and make use of it. These programs need not to care about
how memory is swapped in or out, this is done automatically. The only
additional step that is required to make use of virtual memory is to allocate
it from the memory.library directly rather than from exec, plus some safety
rules how to use this memory. A transparent patch to the system to make 
virtual memory available to all applications automatically is *not* possible, 
and is neither the intention of the memory.library at all.

The memory.library requires the installation of the mmu.library as it is
build on top of it. You are also encouraged to use the MuLib provided
68040 resp. 68060 libraries as they handle virtual memory more careful than
other implementations. The "SwapTest" program in the Examples directory 
should be run to find out whether the cpu support library you're using is
prepared for virtual memory.


About the mmu.library:

The mmu.library is a basis for MMU (memory management) related functions the 
MC68K family can perform. Up to now certain hacks are available that program 
the MMU themselves (Enforcer,CyberGuard,GuardianAngle,SetCPU,Shapeshifter,
VMM,GigaMem...). 
It's therefore not unexpected that these tools conflict with each other.
There's up to now no Os support for the MMU at all - the gap this mmu.library
fills.

The goal is to provide a basis of functions to address and program the MMU in
a hardware independent, Os friendly fashion. Hence, the new version of the
Enforcer, called MuForce, will work together with virtual memory, and others.

The mmu.library is also the basis for this virtual memory project, the 
memory.library. Even though the mmu.library does not provide virtual memory
itself, it builds the basics to allow an easy implementation and to avoid the
hacks required by other implementations so far.


Thomas Richter,

	February 2002

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  277     628  44.1% -lh5- 00f7 Feb  9  2002 MemManual/Autodocs.info
[generic]                12018   36656  32.8% -lh5- c6d5 Nov  9  2001 MemManual/Autodocs/memory.doc
[generic]                  271     628  43.2% -lh5- dab7 Feb  9  2002 MemManual/C_Sources.info
[generic]                 2359    9610  24.5% -lh5- 4f98 Feb  9  2002 MemManual/C_Sources/mmap.c
[generic]                 2098    9986  21.0% -lh5- c389 Nov 17  2001 MemManual/C_Sources/SwapTest.c
[generic]                 2764   11512  24.0% -lh5- da8a Feb  9  2002 MemManual/C_Sources/vmem.c
[generic]                 1413    2372  59.6% -lh5- 9d66 Nov  9  2001 MemManual/Examples/mmap
[generic]                 2322    4420  52.5% -lh5- 6d29 Nov 17  2001 MemManual/Examples/SwapTest
[generic]                 4892    8124  60.2% -lh5- d247 Nov  5  2001 MemManual/Examples/vmem
[generic]                  271     628  43.2% -lh5- c5ac Feb  9  2002 MemManual/Include.info
[generic]                  395    1233  32.0% -lh5- 4cb0 Oct 28  2001 MemManual/Include/clib/memory_protos.h
[generic]                  432    1388  31.1% -lh5- 03ad Jan 29  2002 MemManual/Include/memory/memalerts.h
[generic]                  696    2073  33.6% -lh5- 33e0 Jan 29  2002 MemManual/Include/memory/memerrors.h
[generic]                  558    1707  32.7% -lh5- 7d60 Jan 29  2002 MemManual/Include/memory/memfailhook.h
[generic]                  593    1613  36.8% -lh5- 48ae Jan 29  2002 MemManual/Include/memory/memory.h
[generic]                  655    2009  32.6% -lh5- 9e70 Jan 29  2002 MemManual/Include/memory/memswaphook.h
[generic]                 1838    5900  31.2% -lh5- fda2 Jan 29  2002 MemManual/Include/memory/memtags.h
[generic]                  637    1899  33.5% -lh5- dc47 Jan 29  2002 MemManual/Include/memory_lib.fd
[generic]                  543    1953  27.8% -lh5- 9b76 Jan 29  2002 MemManual/Include/pragmas/memory_pragmas.h
[generic]                  146     221  66.1% -lh5- ca66 Oct 28  2001 MemManual/Include/proto/memory.h
[generic]                  277     628  44.1% -lh5- aac4 Feb  9  2002 MemManual/Manual.info
[generic]                33631   84332  39.9% -lh5- 1490 Feb  9  2002 MemManual/Manual/memorydoc.dvi
[generic]                72612  186422  39.0% -lh5- 665a Feb  9  2002 MemManual/Manual/memorydoc_360.ps
[generic]                97836  242694  40.3% -lh5- ece5 Feb  9  2002 MemManual/Manual/memorydoc_600.ps
[generic]                 1019    2017  50.5% -lh5- 9550 Feb  9  2002 MemManual/Manual/ReadMe
[generic]                  268     523  51.2% -lh5- f1bd Feb  9  2002 MemManual/Manual/ReadMe.info
[generic]                 1428    3313  43.1% -lh5- 9111 Feb 10  2002 MemManual/MemManual.readme
[generic]                29801   77730  38.3% -lh5- d75e Jan 15  2002 MemManual/ReadMe
[generic]                  272     523  52.0% -lh5- b1c2 Feb  9  2002 MemManual/ReadMe.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        29 files  272322  702742  38.8%            Feb 17  2002