Skip to contentSkip to conversation

Improve types abstraction for gdb python scripts

PATCH In review [email protected] 3 participants 7 messages May 4, 2016 – May 5, 2016 GDB kernel debugging helper scripts

lore
Share & tools
lore
#0 lore raw

PATCH 1/2 Improve types abstraction for gdb python scripts

From: Dom Cote <[email protected]>

Change the read_u16 function so it accepts both 'str' and 'byte' as type for the arguments.

When calling read_memory() from gdb API, depending on if it was built with 2.7 or 3.X, the format used to return the data will differ ( 'str' for 2.7, and 'byte' for 3.X ).

Add a function read_memoryview() to be able to get a 'memoryview' object back from read_memory() both with python 2.7 and 3.X .

Tested with python 3.4 and 2.7
Tested with gdb 7.7

---
 scripts/gdb/linux/utils.py | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)
scripts/gdb/linux/utils.py +15 -2
index 0893b326a28b..dba6c88ea7b9 100644
@@ -87,11 +87,24 @@ def get_target_endianness():
     return target_endianness
 
 
+def read_memoryview(inf, start, length):
+    return memoryview(inf.read_memory(start, length))
+
+
 def read_u16(buffer):
+    value = [0, 0]
+
+    if type(buffer[0]) is str:
+        value[0] = ord(buffer[0])
+        value[1] = ord(buffer[1])
+    else:
+        value[0] = buffer[0]
+        value[1] = buffer[1]
+
     if get_target_endianness() == LITTLE_ENDIAN:
-        return ord(buffer[0]) + (ord(buffer[1]) << 8)
+        return value[0] + (value[1] << 8)
     else:
-        return ord(buffer[1]) + (ord(buffer[0]) << 8)
+        return value[1] + (value[0] << 8)
 
 
 def read_u32(buffer):
Signature · 1 line
2.8.2
#1 lore raw

PATCH 2/2 Fix issue with dmesg.py and python 3.X

From: Dom Cote <[email protected]>

Replace the addition (+) of 2 python 'memoryview' objects with the addition of 2 'bytes' objects, convert the result back to memoryview.

Tested with python 3.4 and 2.7
Tested with gdb 7.7

---
 scripts/gdb/linux/dmesg.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
scripts/gdb/linux/dmesg.py +4 -3
index 927d0d2a3145..04d6719067f2 100644
@@ -33,11 +33,12 @@ class LxDmesg(gdb.Command):
         if log_first_idx < log_next_idx:
             log_buf_2nd_half = -1
             length = log_next_idx - log_first_idx
-            log_buf = inf.read_memory(start, length)
+            log_buf = utils.read_memoryview(inf, start, length).tobytes()
         else:
             log_buf_2nd_half = log_buf_len - log_first_idx
-            log_buf = inf.read_memory(start, log_buf_2nd_half) + \
-                inf.read_memory(log_buf_addr, log_next_idx)
+            a = utils.read_memoryview(inf, start, log_buf_2nd_half)
+            b = utils.read_memoryview(inf, log_buf_addr, log_next_idx)
+            log_buf = a.tobytes() + b.tobytes()
 
         pos = 0
         while pos < log_buf.__len__():
Signature · 1 line
2.8.2
maintainer
#2 lore raw

Re: [PATCH 2/2] Fix issue with dmesg.py and python 3.X

Quoted 8 lines · On 2016-05-04 05:12, [email protected] wrote:

From: Dom Cote <[email protected]>

Replace the addition (+) of 2 python 'memoryview' objects with the addition of 2 'bytes' objects, convert the result back to memoryview.

Tested with python 3.4 and 2.7
Tested with gdb 7.7

A word here on what setup was found broken would have been good. If you have a sentence at hand, we can fold it in during merge.

Quoted 17 lines
---
 scripts/gdb/linux/dmesg.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
scripts/gdb/linux/dmesg.py +1 -1
index 927d0d2a3145..04d6719067f2 100644
@@ -33,11 +33,12 @@ class LxDmesg(gdb.Command):
         if log_first_idx < log_next_idx:
             log_buf_2nd_half = -1
             length = log_next_idx - log_first_idx
-            log_buf = inf.read_memory(start, length)
+            log_buf = utils.read_memoryview(inf, start, length).tobytes()

scripts/gdb/linux/dmesg.py class LxDmesg(gdb.Command): · line 44

Quoted 10 lines
scripts/gdb/linux/dmesg.py +3 -2
         else:
             log_buf_2nd_half = log_buf_len - log_first_idx
-            log_buf = inf.read_memory(start, log_buf_2nd_half) + \
-                inf.read_memory(log_buf_addr, log_next_idx)
+            a = utils.read_memoryview(inf, start, log_buf_2nd_half)
+            b = utils.read_memoryview(inf, log_buf_addr, log_next_idx)
+            log_buf = a.tobytes() + b.tobytes()
 
         pos = 0
         while pos < log_buf.__len__():

Patches look good to me on first glance. Need to try out as well.

Kieran?

Thanks,
Jan

Signature · 2 lines
Siemens AG, Corporate Technology, CT RDA ITP SES-DE
Corporate Competence Center Embedded Linux
Tested-by Reviewed-by on v1 2/2
#3 lore raw

Re: [PATCH 2/2] Fix issue with dmesg.py and python 3.X

In reply to [email protected]
Quoted 5 lines · On 04/05/16 04:12, [email protected] wrote:

From: Dom Cote <[email protected]>

Replace the addition (+) of 2 python 'memoryview' objects with the addition of 2 'bytes' objects, convert the result back to memoryview.

I'm a little concerned with the text above not quite sounding like the code below, as the two 'bytes' objects are not converted back to a memoryview object, rather the memoryview objects are converted to 'bytes' objects (i.e. the result in log_buf) ...

Could I suggest something like the following commit-log-message? (Also based on Jan's feedback)

---8<---
When built against Python 3, GDB differs in the return type for its read_memory function, causing the lx-dmesg command to fail.

Now that we have an improved read_16() we can use the new read_memoryview() abstraction to make lx-dmesg return valid data on both current Python APIs
--->8---

(Only a suggestion of course, if you feel it should say something else go with that)

Quoted 3 lines

Tested with python 3.4 and 2.7
Tested with gdb 7.7

I have also tested with Python 3.4, 2.7 on GDB 11, and I've tested that things still work on a wrapped log-buffer too.

Looking good.

The only final note is that because of the way Python 3 prints a byte-stream, we end up with:

[    0.000000] b'x86/fpu: Legacy x87 FPU detected.'
instead of:
[    0.000000] x86/fpu: Legacy x87 FPU detected.

on all of the lines.

I've just done a little digging, and seen we now need to '.decode()' the line for printing, so I'll post that as a quick patch in reply to this set.

Quoted 1 line
Quoted 25 lines
---
 scripts/gdb/linux/dmesg.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
scripts/gdb/linux/dmesg.py +4 -3
index 927d0d2a3145..04d6719067f2 100644
@@ -33,11 +33,12 @@ class LxDmesg(gdb.Command):
         if log_first_idx < log_next_idx:
             log_buf_2nd_half = -1
             length = log_next_idx - log_first_idx
-            log_buf = inf.read_memory(start, length)
+            log_buf = utils.read_memoryview(inf, start, length).tobytes()
         else:
             log_buf_2nd_half = log_buf_len - log_first_idx
-            log_buf = inf.read_memory(start, log_buf_2nd_half) + \
-                inf.read_memory(log_buf_addr, log_next_idx)
+            a = utils.read_memoryview(inf, start, log_buf_2nd_half)
+            b = utils.read_memoryview(inf, log_buf_addr, log_next_idx)
+            log_buf = a.tobytes() + b.tobytes()
 
         pos = 0
         while pos < log_buf.__len__():
Signature · 3 lines
Regards

Kieran Bingham
#4 lore raw

PATCH 1/1 scripts/gdb: decode bytestream on dmesg for Python3

In reply to [email protected]

The recent fixes to lx-dmesg, now allow the command to print successfully on Python3, however the python interpreter wraps the bytes for each line with a b'<text>' marker.

To remove this, we need to decode the line, where .decode() will default to 'UTF-8'

---
 scripts/gdb/linux/dmesg.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
scripts/gdb/linux/dmesg.py +2 -2
index 04d6719067f2..f9b92ece7834 100644
@@ -51,10 +51,10 @@ class LxDmesg(gdb.Command):
                 continue
 
             text_len = utils.read_u16(log_buf[pos + 10:pos + 12])
-            text = log_buf[pos + 16:pos + 16 + text_len]
+            text = log_buf[pos + 16:pos + 16 + text_len].decode()
             time_stamp = utils.read_u64(log_buf[pos:pos + 8])
 
-            for line in memoryview(text).tobytes().splitlines():
+            for line in text.splitlines():
                 gdb.write("[{time:12.6f}] {line}\n".format(
                     time=time_stamp / 1000000000.0,
                     line=line))
Signature · 1 line
2.5.0
author Acked-by Tested-by on v1 1/1
#5 lore raw

Re: [PATCH] scripts/gdb: decode bytestream on dmesg for Python3

Looks good, b'<text>' marker doesn't appear anymore. Tested for python 2.7 and 3.4

Regards

Quoted 32 lines · Kieran Bingham

The recent fixes to lx-dmesg, now allow the command to print successfully on Python3, however the python interpreter wraps the bytes for each line with a b'<text>' marker.

To remove this, we need to decode the line, where .decode() will default to 'UTF-8'

---
 scripts/gdb/linux/dmesg.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
scripts/gdb/linux/dmesg.py +2 -3
index 04d6719067f2..f9b92ece7834 100644
@@ -51,10 +51,10 @@ class LxDmesg(gdb.Command):
                 continue
 
             text_len = utils.read_u16(log_buf[pos + 10:pos + 12])
-            text = log_buf[pos + 16:pos + 16 + text_len]
+            text = log_buf[pos + 16:pos + 16 + text_len].decode()
             time_stamp = utils.read_u64(log_buf[pos:pos + 8])
 
-            for line in memoryview(text).tobytes().splitlines():
+            for line in text.splitlines():
                 gdb.write("[{time:12.6f}] {line}\n".format(
                     time=time_stamp / 1000000000.0,
                     line=line))
--

2.5.0

Acked-by Tested-by on v1 1/2
#6 lore raw
In reply to [email protected]
Quoted 9 lines · On 04/05/16 04:12, [email protected] wrote:

From: Dom Cote <[email protected]>

Change the read_u16 function so it accepts both 'str' and 'byte' as type for the arguments.

When calling read_memory() from gdb API, depending on if it was built with 2.7 or 3.X, the format used to return the data will differ ( 'str' for 2.7, and 'byte' for 3.X ).

Quoted 6 lines

Add a function read_memoryview() to be able to get a 'memoryview' object back from read_memory() both with python 2.7 and 3.X .

Tested with python 3.4 and 2.7
Tested with gdb 7.7

I have also tested with Python 3.4, 2.7 on GDB 11

Quoted 2 lines
Quoted 36 lines
---
 scripts/gdb/linux/utils.py | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)
scripts/gdb/linux/utils.py +15 -2
index 0893b326a28b..dba6c88ea7b9 100644
@@ -87,11 +87,24 @@ def get_target_endianness():
     return target_endianness
 
 
+def read_memoryview(inf, start, length):
+    return memoryview(inf.read_memory(start, length))
+
+
 def read_u16(buffer):
+    value = [0, 0]
+
+    if type(buffer[0]) is str:
+        value[0] = ord(buffer[0])
+        value[1] = ord(buffer[1])
+    else:
+        value[0] = buffer[0]
+        value[1] = buffer[1]
+
     if get_target_endianness() == LITTLE_ENDIAN:
-        return ord(buffer[0]) + (ord(buffer[1]) << 8)
+        return value[0] + (value[1] << 8)
     else:
-        return ord(buffer[1]) + (ord(buffer[0]) << 8)
+        return value[1] + (value[0] << 8)
 
 
 def read_u32(buffer):
Signature · 3 lines
Regards

Kieran Bingham