The mmu.library project © 1998,99 the mmu.library development group, THOR ----------------------------------------------------------------------------- This drawer contains the mmu.library and all related tools, most important debugging tools which might be handy for developing. Most important are the tools "MuForce" and "MuGuardianAngel" in the "MuTools" directory. Disclaimer: ----------- Permission is hereby granted to publish this archive exclusively on the Amiga Developer CD 2.1. However, my licence conditions still apply. Study the "THOR-Software Licence" in the "MMU.guide" for details: NO COMMERCIAL REPRODUCTION WITHOUT PRIOR WRITTEN PERMISSION OF THE AUTHORS. MuForce is based on and uses code of Michael Sinz's "Enforcer" debugging tool. Therefore, "MuForce" might be seen as the V40 edition of "Enforcer". This work wouldn't have been possible without the nice and friendly support of Mike I really appreciate. Permission of the authors is given to publish MuForce on the Amiga Dev CD 2.1. A quick start: -------------- Copy the files LIBS/mmu.library and LIBS/disassembler.library to LIBS:, keep the "MuTools" wherever you want. HOWEVER: -------- This archive contains more than just debugging tools. It's more a completely new concept that is introduced here, namely that of a system library controlling the MMU functions of the more advanced Amiga models and building a basis for shared access to the MMU. The idea is to have a set of compatible tools that cooperate nicely with each other, namely... MMU HACKING HAS TO STOP! For a full installation, for a lot of background information, for a selection of frequently answered questions and answers, please consult the "MMU.guide" in this directory. It should, hopefully, provide all required information. Please read the "Licence" agreement first, then the "What is it" chapter and the "Installation" rules. Developers will find all required includes and autodocs in this directory as well. Compatibility ------------- The MuTools and the mmu.library are compatible to all Amiga models with a working MMU. They will print a warning and fail if no MMU is available. They are also compatible to WarpOs © H&P, but they are unfortunately *NOT* compatible to P5's PowerUp and ppc.library. THIS IS NOT MY FAULT. I contacted P5 to get some internal information to support the ppc.library, but little to no interest was shown. I'm still willing to support PowerUp, but I won't be able to without cooperation of P5. Please run WarpOs, and the ppc.library emulation of Frank Wille on top of it. This combination will work fine. The mmu.library is also incompable to the Draco © P5 computer, first due to a name clash, and second because of missing documentation. Last minute changes ------------------- Unfortunately, we haven't been able to provide the mmu.library based 68060.library in time. This doesn't mean that the "MuTools" won't work, it just means that some memory is wasted because the MMU data structures will be build twice. Furthermore, 100% waterproof "virtual memory" is impossible with all current 68060.library implementations - this is not related to the mmu.library at all, it's just a fact due to the way how emulation of unimplemented FPU instructions work. I'm also sorry for not being able to draw all the nice colorful Os 3.5 icons in time. The tools will therefore come in the old four-color style. In case you want to provide some nicer icons, you're welcome! I'm not an artist! Credits ------- *Thanks a lot!* This project wouldn't have been possible without your support, help, background information, testing, providing sources! Thanks for your time and for all the friendly emails! Special thanks goes to: Michael Sinz: For explaining me a lot of internals of exec, for detailed information about the Amiga hardware, for providing the sources of his "Enforcer", for answering all my stupid questions and for being a nice guy. Ralph Babel: For answering my questions about caching and the CachePre/PostDMA() questions, for documenting some of the internals of the omniscsi.device and hence allowing me to make his "GuruROM" software mmu.library aware. Sam Jordan: For providing me insight into WarpOs. Simon N. Goodwin: For running a lot of tests on various systems, especially for some insider information about the Motorola 68060. Michaela Prüß: For making the VBCC includes available for all my frequent updates and bugfixes. Bjoern Schmidt: For allowing me to run some tests on his 060 and for taking time for me several afternoons. Werner Müller: For providing a 68040 system for a bargain price which finally allowed me to write support code for the most tricky member of the motorola family, and to get rid of my 68030 based system and its "creative" chip memory. Olaf Barthel: For allowing me to include his program "Sashimi" in this distribution, for all his great Amiga Software and for building the DevCD 2.1. Richard Körber: For his great "PatchWork" tool, and for allowing me to include it in this archive. Motorola: For providing the service of shipping the MC68K manual to my place for free. I wish to thank all beta testers, for risking to run the beta software on their systems and for providing all the information I required to make the mmu.library great: (in alphabetical order by last name) Stephen Brookes Carl Drougge Gaelan Griffin (with special thanks for testing this on his 68020/68851) Gene Heskett Andreas R. Kleinert Stéphane PAYET, 29 years and 13 with Amiga. Jon Peterson - Avid shareware supporter. Raphael 'PIK' Pilarczyk: "Murphy hates me" Hynek Schlawack Nicholas Stallard Flemming Steffensen Geoffrey Taylor Smyrna, TN USA Carlos A. Tirado Maure Vaughn Etienne Vogt ----------------------------------------------------------------------------- Thomas Richter, October 1999