Skip to content

GitLab

Commit 62dbb25d authored by Robert Sprowson's avatar Robert Sprowson Committed by ROOL
Browse files

Tone down ZPP warning, document developer modules 

First added in July 2015, no longer provide ZeroPain with every development ROM since it could be seen as a cause for alarm to a new user, and is a useful diagnosis tool to old deck hands.
Move the documentation of ZeroPain to its new home in the BonusBin, and add some notes and a link to the docs of the other developer modules provided (DebugBttn, DebugTools).

Version 1.00. Tagged as 'ABRelease-1_00'
parent 5fb58ee0
Hide whitespace changes
Inline Side-by-side
Showing with 76 additions and 167 deletions
Resources/BCM2835Dev/ReadMe.txt
View file @ 62dbb25d
......@@ -10,21 +10,6 @@ that you know what you are doing! It is likely to be functionally incomplete
and probably unstable in various ways.
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
CMOS RAM
========
......
Resources/BCM2835Dev/release_autobuild,feb
View file @ 62dbb25d
......@@ -30,9 +30,6 @@ Copy ab_res:ReadMe/txt <ab_res$dir>.zip.ReadMe/txt ~cf~r~v
| Compress the ROM image into the zip directory
Do rompress -vZ --align=4096 <Build$Dir>.Images.<Build$ImageName> <ab_res$dir>.zip.riscos/img
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/Generic/ZeroPain/ReadMe.txt → Resources/BonusBinDev/DeveloperModules.txt
View file @ 62dbb25d
Zero page relocation & ZeroPain
===============================
Developer modules
=================
This build of RISC OS makes use of "zero page relocation", a change to the
There are 3 modules provided to assist developers with debugging and diagnosing
some common software problems. They are
* DebugButtn
* DebugTools
* ZeroPain
Debug Button
============
This module intercepts Wimp service calls in order to add an extra
button (labelled "Debug") to Wimp error boxes where either:
a) the top bit of the error number is set, indicating an exception error
b) the flags word indicates it is a program report (ie unexpected error)
Clicking on this button will open a command window with a *Debug prompt
running in a simple environment - the current application cannot be replaced,
the exit handler tidies up the command window, and errors (such as those
caused by aborts from any comamnd line tool you use) do not cause an exit
from the command window. As usual with *Debug, you can press the Escape key
to resume the interrupted code.
DebugTools
==========
This module provides various low level commands to manipulate the environment.
While many are purely informational, beware that some of them are quite
dangerous and may crash the system if used inappropriately. For full details
of the commands visit
https://gitlab.riscosopen.org/RiscOS/Sources/Programmer/DebugTools/-/tree/master/Docs
ZeroPain
========
Since July 2015 builds of RISC OS 5 running on ARMv5 or later processors
have been available which make use of "zero page relocation", a change to the
standard memory map which moves the processor vectors and the kernel's "zero
page" workspace away from address zero and up to the high end of the memory
map. This greatly increases the system's resilience to a common type of
map.
This greatly increases the system's resilience to a common type of
software bug known as a "null pointer dereference", this comes in two forms:
a) Reading
......@@ -17,11 +59,9 @@ b) Writing
the processor vectors, most likely this results in crashing the computer
or similar knock on effects.
Starting with RISC OS 5.24 the default state is running with the processor
vectors and kernel's workspace moved away from zero page. But due to the
large amount of buggy software out there as a temporary measure there is still
a page of RAM left mapped in at the old address. The access attributes are
set such that:
RISC OS 5.24 and later include a temporary measure where there is still
a page of RAM left mapped in at the old address to allow buggy software to
continue to a limit. The access attributes are set such that:
a) Reading
Is permitted in all processor modes (no change).
......@@ -46,26 +86,25 @@ execute code. Some infrequently used instructions, such as LDRD, are also not
dealt with. In these cases a data or prefetch abort will be raised as normal,
and the program will most likely terminate with an error.
Installation
============
------------
The recommended method of installation is to add the ZeroPain module to your
Choices.Boot.PreDesk folder. This can be performed by using the boot merge
utility in Configure to merge in the !Boot structure that is provided here.
Choices.Boot.PreDesk folder.
To ensure that the log file is clearly visible, the default log location is the
file 'ZeroPain' in the root of your boot drive. However if desired you can
specify a different location for the file by editing the file !Boot.Choices.
Boot.PreDesk.!!ZeroPain.!Run.
specify a different location by passing the desired log file name when the
module is loaded, for example:
RMLoad ZeroPain ADFS::Foo.$.Bar.Log
The module is intended to be a temporary aid to be used until the dummy
The module is intended to be a temporary aid to be used until the dummy
compatibility page of RAM at address zero is removed - it is not intended to
be a long-term compatibility solution for running old or unmaintained software.
Use
===
Using ZeroPain
--------------
There is little to know about using the module. As long as the module is
running, it will be monitoring the data abort vector and watching for attempts
......@@ -84,9 +123,8 @@ be reported to the author and added to the list of known problems
ZeroPain will pause logging once the log file exceeds 1MB in size. Deleting the
log will allow it to resume.
Understanding log entries
=========================
-------------------------
Log entries produced by ZeroPain look like the following:
......@@ -204,9 +242,8 @@ boundary (the abort handler errs on the side of caution and avoids reading
across page boundaries). However there should still be enough information to
allow the problem code to be identified.
Annotated stack dumps
=====================
---------------------
Some ZeroPain log entries will include an annotated stack dump after the
disassembly. This stack dump can be critical in helping to identify the real
......@@ -228,11 +265,10 @@ summary entries that can be buffered at once.
Developers or users who wish to understand more about the stack dump format and
the different annotations should consult this reference on the ROOL wiki:
https://www.riscosopen.org/wiki/documentation/show/Debugger%20Annotated%20Exception%20Dumps
https://www.riscosopen.org/wiki/documentation/show/Debugger%20Annotated%20Exception%20Dumps
Zero page workspace emulated by ZeroPain
========================================
----------------------------------------
When ZeroPain emulates a read from zero page, it will return the value 0 for
most locations. However, special handling is performed for the following
......@@ -257,9 +293,8 @@ may limit our ability to make changes to the OS in future.
&FF8 - 'DomainId'. May be used by some software to identify the current Wimp
task. Use Wimp_ReadSysInfo instead.
High processor vectors
======================
----------------------
Modern ARM CPUs support a feature known as 'high processor vectors', whereby
the processor vectors are moved from their old location at &0 to a new location
......@@ -274,7 +309,7 @@ OS_PlatformFeatures 0 can be used to determine whether high processor vectors
are in use (flag returned in bit 20). Software which needs to interact with the
processor vectors directly should use this to determine their location.
https://www.riscosopen.org/wiki/documentation/show/OS_PlatformFeatures%200
https://www.riscosopen.org/wiki/documentation/show/OS_PlatformFeatures%200
The address of the processor vectors should not be used to infer the address of
the zero page workspace, and vice-versa.
......
Resources/BonusBinDev/release_autobuild,feb
View file @ 62dbb25d
......@@ -30,6 +30,7 @@ Copy <Install$Dir>.BonusBin <ab_res$dir>.zip.HardDisc4 ~cfr~v
| Copy the ReadMe for this build into the zip directory
Copy ab_res:ReadMe/txt <ab_res$dir>.zip.ReadMe/txt ~cf~r~v
Copy ab_res:Territories/txt <ab_res$dir>.zip.HardDisc4.Modules.Territories.ReadMe/txt ~cf~r~v
Copy ab_res:DeveloperModules/txt <ab_res$dir>.zip.HardDisc4.Modules.Developer.ReadMe/txt ~cf~r~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/Generic/ZeroPain/!Boot/Choices/Boot/PreDesk/!!ZeroPain/!Run,feb deleted 100644 → 0
View file @ 5fb58ee0
| To specify an alternate log location, add it the end of the line below, e.g.
| 'X RMLoad <Obey$Dir>.ZeroPain ADFS::Foo.$.Bar.Log'
X RMLoad <Obey$Dir>.ZeroPain
Resources/OMAP3Dev/ReadMe.txt
View file @ 62dbb25d
......@@ -10,21 +10,6 @@ that you know what you are doing! It is likely to be functionally incomplete
and probably unstable in various ways.
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
How to install the ROM image
============================
......
Resources/OMAP3Dev/release_autobuild,feb
View file @ 62dbb25d
......@@ -36,9 +36,6 @@ Copy <Install$Dir>.ABRelease.!SDCreate <ab_res$dir>.zip.!SDCreate ~cfr~v
| Copy the InstallHD4 script into the zip directory
Copy ab_res:InstallHD4 <ab_res$dir>.zip.InstallHD4 ~cf~r~v
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/OMAP4Dev/ReadMe.txt
View file @ 62dbb25d
......@@ -10,21 +10,6 @@ that you know what you are doing! It is likely to be functionally incomplete
and probably unstable in various ways.
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
How to install the ROM image
============================
......
Resources/OMAP4Dev/release_autobuild,feb
View file @ 62dbb25d
......@@ -36,9 +36,6 @@ Copy <Install$Dir>.ABRelease.!SDCreate <ab_res$dir>.zip.!SDCreate ~cfr~v
| Copy the InstallHD4 script into the zip directory
Copy ab_res:InstallHD4 <ab_res$dir>.zip.InstallHD4 ~cf~r~v
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/OMAP5Dev/ReadMe.txt
View file @ 62dbb25d
......@@ -10,21 +10,6 @@ that you know what you are doing! It is likely to be functionally incomplete
and probably unstable in various ways.
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
The 'InstallHD4' script, and setting up a !Boot sequence
========================================================
......
Resources/OMAP5Dev/release_autobuild,feb
View file @ 62dbb25d
......@@ -33,9 +33,6 @@ Copy <Build$Dir>.Images.<Build$ImageName> <ab_res$dir>.zip.riscos ~cf~r~v
| Copy the InstallHD4 script into the zip directory
Copy ab_res:InstallHD4 <ab_res$dir>.zip.InstallHD4 ~cf~r~v
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/TitaniumDev/ReadMe.txt
View file @ 62dbb25d
......@@ -21,18 +21,4 @@ before committing it into the QSPI boot flash. Then, if something goes wrong
it's possible to press the reset button and go back to the last flashed ROM.
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
-- RISC OS Open
Resources/TitaniumDev/release_autobuild,feb
View file @ 62dbb25d
......@@ -37,9 +37,6 @@ Copy ab_res:SoftLoad <ab_res$dir>.zip.SoftLoad ~cf~r~v
| Copy the ROM image into the zip directory
Copy <Build$Dir>.Images.<Build$ImageName> <ab_res$dir>.zip.riscos ~cf~r~v
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/TungstenDev/ReadMe.txt
View file @ 62dbb25d
......@@ -10,18 +10,4 @@ softloading it should only be done if you are confident that you know what
you are doing and have a good backup strategy in place!
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
-- RISC OS Open
Resources/TungstenDev/release_autobuild,feb
View file @ 62dbb25d
......@@ -36,9 +36,6 @@ Do rompress -vZps 4M <Build$Dir>.Images.<Build$ImageName> <ab_soft$dir>.riscos
| Copy pre-EDID specific softload support
Copy ab_res:Configure <ab_res$dir>.zip.soft.!Boot.Choices.Boot.PreDesk.Configure ~cfr~v
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
Resources/iMx6Dev/ReadMe.txt
View file @ 62dbb25d
......@@ -10,21 +10,6 @@ that you know what you are doing! It is likely to be functionally incomplete
and probably unstable in various ways.
IMPORTANT
=========
This build of RISC OS utilises "zero page relocation", a change to the
standard memory map which is designed to increase the stability of the OS and
your software. However, there is a catch - a lot of existing software is buggy,
and this change will expose those bugs, causing the software to crash.
To help with the transition to having zero page relocation enabled by default,
a compatibility/logging module called 'ZeroPain' has been developed. See the
readme file in the ZeroPain folder for more information. It is recommended that
you install the module before you install this new ROM image, otherwise you may
have difficulty booting your system.
How to install the ROM image
============================
......
Resources/iMx6Dev/release_autobuild,feb
View file @ 62dbb25d
......@@ -33,9 +33,6 @@ Do rompress -vZ --align=4096 <Build$Dir>.Images.<Build$ImageName> <ab_res$dir>.z
| Copy !SDCreate into the zip directory
Copy <Install$Dir>.ABRelease.!SDCreate <ab_res$dir>.zip.!SDCreate ~cfr~v
| Copy ZeroPain into the zip directory
Copy ab_res:ZeroPain <ab_res$dir>.zip.ZeroPain ~cfr~v
| Set the zip directory as the current directory
Dir <ab_res$dir>.zip
......
VersionNum
View file @ 62dbb25d
/* (0.99)
/* (1.00)
*
* This file is automatically maintained by srccommit, do not edit manually.
*
*/
#define Module_MajorVersion_CMHG 0.99
#define Module_MinorVersion_CMHG
#define Module_Date_CMHG 14 Mar 2020
#define Module_MajorVersion_CMHG 1.00
#define Module_MinorVersion_CMHG
#define Module_Date_CMHG 06 Jun 2020
#define Module_MajorVersion "0.99"
#define Module_Version 99
#define Module_MajorVersion "1.00"
#define Module_Version 100
#define Module_MinorVersion ""
#define Module_Date "14 Mar 2020"
#define Module_Date "06 Jun 2020"
#define Module_ApplicationDate "14-Mar-20"
#define Module_ApplicationDate "06-Jun-20"
#define Module_ComponentName "ABRelease"
#define Module_FullVersion "0.99"
#define Module_HelpVersion "0.99 (14 Mar 2020)"
#define Module_LibraryVersionInfo "0:99"
#define Module_FullVersion "1.00"
#define Module_HelpVersion "1.00 (06 Jun 2020)"
#define Module_LibraryVersionInfo "1:0"
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment