Doc: convert markdown files to rst
The official documentation format for TF-M is becoming Restructured
Text. This change converts the existing .md files to the new format.
Due to support for documentation of external code (/lib) md support is
kept.
Change-Id: I3c1aef5d22442e0c7c362a40a8d344a266dc0940
Signed-off-by: Gyorgy Szing <Gyorgy.Szing@arm.com>
diff --git a/glossary.rst b/glossary.rst
new file mode 100644
index 0000000..b50ba4a
--- /dev/null
+++ b/glossary.rst
@@ -0,0 +1,89 @@
+########################################
+TF-M glossary of terms and abbreviations
+########################################
+
+************
+TF-M related
+************
+.. glossary::
+
+ TF-M
+ TFM
+ Trusted Firmware for M-class
+ ARM TF-M provides a reference implementation of secure world software for ARMv8-M.
+
+ SPE : TF-M related
+ Secure Processing Environment
+ PSA term. In TF-M this means the secure domain protected by TF-M
+
+ NSPE : TF-M related
+ Non Secure Processing Enviroment
+ PSA term. In TF-M this means non secure domain typically running an OS using services provided by TF-M
+
+ SS : TF-M related
+ Secure Service
+ A component within the TEE that is atomic from a security/trust point of view, i.e. which is viewed as a single entity from a TF-M point of view
+
+ SP : TF-M related
+ Secure Partition
+ A logical container for a single secure service
+
+ SPM : TF-M related
+ Secure Partition Manager
+ The TF-M component responsible for enumeration, management and isolation of multiple Secure Partitions within the TEE
+
+ SFN : TF-M related
+ Secure Function
+ An entry function to a secure service. Multiple SFN per SS are permitted
+
+ SST : TF-M related
+ Secure Storage Service
+ Secure storage service provided by TF-M
+
+****************
+SSE-200 platform
+****************
+.. glossary::
+
+ MPC : SSE-200 platform
+ Memory Protection Controller
+ Bus slave-side security controller for memory regions
+
+ PPC : SSE-200 platform
+ Peripheral Protection Controller
+ Bus slave-side security controller for peripheral access
+
+************
+v8M-specific
+************
+.. glossary::
+
+ SSE-200 platform
+ Secure/Non-secure
+ The separation provided by TrustZone hardware components in the system
+
+ SAU
+ Secure Attribution Unit
+ Hardware component providing isolation between Secure, Non-secure Callable and Non-secure addresses
+
+
+***************
+M-class Generic
+***************
+.. glossary::
+
+ APCS
+ ARM Architecture Procedure Call Standard
+ The AAPCS defines how subroutines can be separately written, separately compiled, and separately assembled to work together. It describes a contract between a calling routine and a called routine
+
+ SVC
+ SuperVisor Call
+ ARMv7M assembly instruction to call a privileged handler function
+
+ MPU
+ Memory Protection Unit
+ Hardware component providing privilege control
+
+--------------
+
+*Copyright (c) 2017-2019, Arm Limited. All rights reserved.*