[gentoo-commits] proj/devmanual:master commit in: archs/sparc/

[gentoo-commits] proj/devmanual:master commit in: archs/sparc/

[Sam James]

commit:     f0be5cfbd0fe4f62fe0ee70abef4044247984a7b
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sat Jan 22 20:48:47 2022 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Mon Feb 21 05:15:25 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=f0be5cfb

archs/sparc: mention SIGBUS/unaligned access and link to tracker bug

Bug: https://bugs.gentoo.org/371525
Signed-off-by: Sam James <sam <AT> gentoo.org>
Closes: https://github.com/gentoo/devmanual/pull/266
Signed-off-by: Sam James <sam <AT> gentoo.org>

 archs/sparc/text.xml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/archs/sparc/text.xml b/archs/sparc/text.xml
index 20ce4b8..2b00f54 100644
--- a/archs/sparc/text.xml
+++ b/archs/sparc/text.xml
@@ -10,6 +10,20 @@ hardware (Sun UltraSparc systems with <c>v9</c> CPUs). <c>v8</c> processors
 and 2.4 kernels should still work with Gentoo, but they are no longer supported
 by the Gentoo/SPARC team.
 </p>
+
+<p>
+SPARC systems are notoriously strict on aligned access: this is the most common
+type of bug seen on SPARC (other than big-endian related issues), causing a
+<c>SIGBUS</c> signal to be sent to the errant process. Known issues should be
+linked to
+<uri link="https://bugs.gentoo.org/371525">the related tracker bug</uri>.
+</p>
+
+<p>
+This is usually due to supposedly clever pointer casts and type punning tricks
+by the code authors.
+</p>
+
 </body>
 
 <section>