Add table of contents to README (#609)

Also adjusted indentation for the subsections in
section *Install the Intel(R) SGX PSW*.

Author: sbellem

README.md

@@ -1,9 +1,33 @@
-
-
 Intel(R) Software Guard Extensions for Linux\* OS
 ================================================
 
 # linux-sgx
+* [Introduction](#introduction)
+* [License](#license)
+* [Contributing](#contributing)
+* [Documentation](#documentation)
+* [Quick Start with Docker and Docker Compose](#quick-start-with-docker-and-docker-compose)
+* [Build and Install the Intel(R) SGX Driver](#build-and-install-the-intelr-sgx-driver)
+* [Build the Intel(R) SGX SDK and Intel(R) SGX PSW Package](#build-the-intelr-sgx-sdk-and-intelr-sgx-psw-package)
+    * [Prerequisites](#prerequisites)
+    * [Build the Intel(R) SGX SDK and Intel(R) SGX SDK Installer](#build-the-intelr-sgx-sdk-and-intelr-sgx-sdk-installer)
+    * [Build the Intel(R) SGX PSW and Intel(R) SGX PSW Installer](#build-the-intelr-sgx-psw-and-intelr-sgx-psw-installer)
+* [Install the Intel(R) SGX SDK](#install-the-intelr-sgx-sdk)
+    * [Prerequisites](#prerequisites-1)
+    * [Install the Intel(R) SGX SDK](#install-the-intelr-sgx-sdk-1)
+    * [Test the Intel(R) SGX SDK Package with the Code Samples](#test-the-intelr-sgx-sdk-package-with-the-code-samples)
+    * [Compile and Run the Code Samples in the Hardware Mode](#compile-and-run-the-code-samples-in-the-hardware-mode)
+* [Install the Intel(R) SGX PSW](#install-the-intelr-sgx-psw)
+    * [Prerequisites](#prerequisites-2)
+    * [Install the Intel(R) SGX PSW](#install-the-intelr-sgx-psw-1)
+        * [Using the local repo(recommended)](#using-the-local-reporecommended)
+        * [Using the individual packages](#using-the-individual-packages)
+        * [Upgrade from a legacy installation](#upgrade-from-a-legacy-installation)
+        * [Configure the installation](#configure-the-installation)
+    * [ECDSA attestation](#ecdsa-attestation)
+    * [Start or Stop aesmd Service](#start-or-stop-aesmd-service)
+    * [Configure the Proxy for aesmd Service](#configure-the-proxy-for-aesmd-service)
+* [Reproducibility](#reproducibility)
 
 Introduction
 ------------
@@ -359,36 +383,37 @@ Install the Intel(R) SGX PSW
 ### Install the Intel(R) SGX PSW
 - The SGX PSW provides 3 services: launch, EPID-based attestation, and algorithm agnostic attestation. Starting with the 2.8 release, the SGX PSW is split into smaller packages and the user can choose which features and services to install. There are 2 methods to install the required packages: Using individual packages or using the local repo generated by the build system. Using the local repo is recommended since the system will resolve the dependencies automatically. Currently, we support .deb and .rpm based repos. 
 
-  #### Using the local repo(recommended)
+#### Using the local repo(recommended)
 
-  |   |Ubuntu 16.04, Ubuntu 18.04 and Ubuntu 20.04|Red Hat Enterprise Linux 7.6, Red Hat Enterprise Linux 8.2, CentOS 8.2, Fedora 31|
-  | ------------ | ------------ | ------------ |
-  |launch service |apt-get install libsgx-launch libsgx-urts|yum install libsgx-launch libsgx-urts|
-  |EPID-based attestation service|apt-get install libsgx-epid libsgx-urts|yum install libsgx-epid libsgx-urts|
-  |algorithm agnostic attestation service|apt-get install libsgx-quote-ex libsgx-urts|yum install libsgx-quote-ex libsgx-urts|
-  |DCAP ECDSA-based service(Ubuntu16.04 not included)|apt-get install libsgx-dcap-ql|yum install libsgx-dcap-ql|
+|   |Ubuntu 16.04, Ubuntu 18.04 and Ubuntu 20.04|Red Hat Enterprise Linux 7.6, Red Hat Enterprise Linux 8.2, CentOS 8.2, Fedora 31|
+| ------------ | ------------ | ------------ |
+|launch service |apt-get install libsgx-launch libsgx-urts|yum install libsgx-launch libsgx-urts|
+|EPID-based attestation service|apt-get install libsgx-epid libsgx-urts|yum install libsgx-epid libsgx-urts|
+|algorithm agnostic attestation service|apt-get install libsgx-quote-ex libsgx-urts|yum install libsgx-quote-ex libsgx-urts|
+|DCAP ECDSA-based service(Ubuntu16.04 not included)|apt-get install libsgx-dcap-ql|yum install libsgx-dcap-ql|
 
-  Optionally, you can install *-dbgsym or *-debuginfo packages to get the debug symbols, and install *-dev or *-devel packages to get the header files for development.
+Optionally, you can install *-dbgsym or *-debuginfo packages to get the debug symbols, and install *-dev or *-devel packages to get the header files for development.
 
-  **NOTE**: To debug with sgx-gdb on Ubuntu 16.04, you need to ensure the Intel(R) SGX PSW is built under the condition that the environment variable ``DEB_BUILD_OPTIONS="nostrip"`` is set. 
+**NOTE**: To debug with sgx-gdb on Ubuntu 16.04, you need to ensure the Intel(R) SGX PSW is built under the condition that the environment variable ``DEB_BUILD_OPTIONS="nostrip"`` is set.
 
-  #### Using the individual packages
-  Please refer [Intel_SGX_Installation_Guide_Linux](https://download.01.org/intel-sgx/latest/linux-latest/docs/) for detail.
+#### Using the individual packages
+Please refer [Intel_SGX_Installation_Guide_Linux](https://download.01.org/intel-sgx/latest/linux-latest/docs/) for detail.
 
-  #### Upgrade from a legacy installation
-  Sometimes we will split old package into smaller ones or move file between different packages. In such cases, you will encounter error messages like: "dpkg: error processing archive ....(--unpack): trying to overwrite ...". You can use 2 methods to address it.
-  * Uninstall the old installation first, then install new packages.
-  * Add ``-o Dpkg::Options::="--force-overwrite"`` option to overwrite existing files and use “``dist-upgrade``” instead of "upgrade" to install new packages when upgrading. In short, you should use this command:
-  ```
-  apt-get dist-upgrade -o Dpkg::Options::="--force-overwrite"
-  ```
-  #### Configure the installation
-  Some packages are configured with recommended dependency on other packages that are not required for certain usage. For instance, the background daemon is not required for container usage. It will be installed by default, but you can drop it by using the additional option during the installation.
-  * On Ubuntu 16.04, Ubuntu 18.04 and Ubuntu 20.04:
-  ```
-    --no-install-recommends
-  ```
-  **NOTE** On rpm based system, rpmbuild>=4.12 is required to enable similar features. 
+#### Upgrade from a legacy installation
+Sometimes we will split old package into smaller ones or move file between different packages. In such cases, you will encounter error messages like: "dpkg: error processing archive ....(--unpack): trying to overwrite ...". You can use 2 methods to address it.
+* Uninstall the old installation first, then install new packages.
+* Add ``-o Dpkg::Options::="--force-overwrite"`` option to overwrite existing files and use “``dist-upgrade``” instead of "upgrade" to install new packages when upgrading. In short, you should use this command:
+```
+apt-get dist-upgrade -o Dpkg::Options::="--force-overwrite"
+```
+
+#### Configure the installation
+Some packages are configured with recommended dependency on other packages that are not required for certain usage. For instance, the background daemon is not required for container usage. It will be installed by default, but you can drop it by using the additional option during the installation.
+* On Ubuntu 16.04, Ubuntu 18.04 and Ubuntu 20.04:
+```
+  --no-install-recommends
+```
+**NOTE** On rpm based system, rpmbuild>=4.12 is required to enable similar features. 
 
 ### ECDSA attestation
 To enable ECDSA attestation