Updates rst docs and rename "log2align" to "alignment".

Author: clayborg

lldb/docs/use/symbolfilejson.rst

@@ -74,14 +74,61 @@ sections
 * ``type``: a string representing the section type (see below).
 * ``address``: a number representing the section file address.
 * ``size``: a number representing the section size in bytes.
+* ``read``: a boolean value indicating if the section has read permissions.
+* ``write``: a boolean value indicating if the section has write permissions.
+* ``execute``: a boolean value indicating if the section has execute permissions.
+* ``subsections``: An array of child sections in the same format.
+* ``user_id``: a number representing the section identifier.
+* ``file_offset``: a number that represents the offset in the file for this section's contents.
+* ``file_size``: a number that represents the size in bytes in the file for this section's contents.
+* ``alignment``: a boolean value indicating if the section has execute permissions.
+* ``fake``: a boolean value indicating if the section is fake.
+* ``encrypted``: a boolean value indicating if the section is encrypted.
+* ``thread_specific``: a boolean value indicating if the section is thread specific.
 
 .. code-block:: JSON
 
   {
-      "name": "__TEXT",
-      "type": "code",
-      "address": 0,
-      "size": 546,
+    "user_id": 256,
+    "name": "__TEXT",
+    "type": "code",
+    "address": 0,
+    "size": 546,
+    "file_offset": 0,
+    "file_size": 4096,
+    "read": true,
+    "write": false,
+    "executable": true,
+    "subsections": [
+      {
+        "name": "__text",
+        "type": "code",
+        "address": 0,
+        "size": 200,
+        "alignment": 2,
+        "read": true,
+        "write": false,
+        "execute": true
+      },
+      {
+          "name": "__fake",
+          "address": 200,
+          "size": 10,
+          "fake": true
+      },
+      {
+          "name": "__encrypted",
+          "address": 210,
+          "size": 20,
+          "encrypted": true
+      },
+      {
+          "name": "__tls",
+          "address": 230,
+          "size": 30,
+          "thread_specific": true
+      }
+    ]
   }
 
 The ``type`` field accepts the following values: ``code``, ``container``,

lldb/source/Core/Section.cpp

@@ -694,7 +694,7 @@ bool fromJSON(const llvm::json::Value &value,
          o.map("user_id", section.user_id) &&
          o.map("file_offset", section.file_offset) &&
          o.map("file_size", section.file_size) &&
-         o.map("log2align", section.log2align) &&
+         o.map("alignment", section.log2align) &&
          o.map("flags", section.flags) && o.map("fake", section.fake) &&
          o.map("encrypted", section.encrypted) &&
          o.map("thread_specific", section.thread_specific);

lldb/test/API/functionalities/json/object-file/TestObjectFileJSON.py

@@ -100,7 +100,7 @@ def test_module(self):
                             "type": "code",
                             "address": TEXT_file_addr,
                             "size": text_size,
-                            "log2align": 2,
+                            "alignment": 2,
                             "read": True,
                             "write": False,
                             "execute": True,