File 0371-megaco-doc-Update-the-performance-and-debu... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0371-megaco-doc-Update-the-performance-and-debug-chapters.patch of Package erlang (Revision 57cf7c87cb80e2aaaf3f20327bf57529)

Currently displaying revision 57cf7c87cb80e2aaaf3f20327bf57529 , Show latest

From f86afb0dd84d2cf27c8a418ce9b9f5f65ca475ec Mon Sep 17 00:00:00 2001
From: Micael Karlberg <bmk@erlang.org>
Date: Tue, 4 Jan 2022 18:09:56 +0100
Subject: [PATCH 01/13] [megaco|doc] Update the performance and debug chapters

Update the performance and debug chapters of the User's Guide.
Much of the content was outdated.

OTP-17839
---
 lib/megaco/doc/src/megaco_debug.xml       |  22 ++--
 lib/megaco/doc/src/megaco_performance.xml | 138 +++++++++-------------
 2 files changed, 66 insertions(+), 94 deletions(-)

diff --git a/lib/megaco/doc/src/megaco_debug.xml b/lib/megaco/doc/src/megaco_debug.xml
index 18453f23a6..375139dd92 100644
--- a/lib/megaco/doc/src/megaco_debug.xml
+++ b/lib/megaco/doc/src/megaco_debug.xml
@@ -60,13 +60,13 @@
       <title>Requirement</title>
       <list type="bulleted">
         <item>
-          <p>Erlang/OTP, version R13B01 or later.</p>
+          <p>Erlang/OTP, version 24.2 or later.</p>
         </item>
         <item>
-          <p>Version 3.11 or later of <em>this</em> application.</p>
+          <p>Version 4.2 or later of <em>this</em> application.</p>
         </item>
         <item>
-          <p>Version 1.6.10 or later of the <em>asn1</em> application. </p>
+          <p>Version 5.0.17 or later of the <em>asn1</em> application. </p>
         </item>
         <item>
           <p>The flex libraries. Without it, the flex powered codecs cannot 
@@ -145,7 +145,7 @@
         % erl -pa <path-megaco-ebin-dir> -pa <path-to-meas-module-dir>
         Erlang (BEAM) emulator version 5.6 [source]
 
-        Eshell V5.7.1  (abort with ^G)
+        Eshell V12.2  (abort with ^G)
         1> megaco_codec_meas:start().
         ...
         2> halt().
@@ -241,15 +241,11 @@ message() = binary()
           convenient internal form (equivalent with the decoded text message).</p>
         <p>The transformation is done _after_ the actual decode has been 
           done.</p>
-        <p>Furthermore, it is possible to make use of a linked in driver that 
-          performs some of the decode/encode, decode for ber and encode for per 
-          (the 'driver' encoding config).</p>
-        <p>Therefor in the tests, binary codecs are tested with four 
+        <p>Therefor in the tests, binary codecs are tested with two 
           different encoding configs to determine exactly how the
-          different options effect the performance: with transformation and 
-          without driver ([]), without transformation and without driver 
-          ([native]), with transformation and with driver ([driver]) and 
-          finally without transformation and with driver ([driver,native]).</p>
+	  different options effect the performance:
+	  with transformation ([]) and
+	  without transformation ([native]).</p>
       </section>
 
       <section>
@@ -264,7 +260,7 @@ message() = binary()
         <p>Be sure <em>not</em> no name the directory containing the measurement
           binaries starting with 'megaco-', e.g. megaco-meas. This will
           confuse the erlang application loader (erlang applications
-          are named, e.g. megaco-1.0.2).</p>
+          are named, e.g. megaco-5.2).</p>
       </section>
     </section>
   </section>
diff --git a/lib/megaco/doc/src/megaco_performance.xml b/lib/megaco/doc/src/megaco_performance.xml
index d32f3296e9..f56221862b 100644
--- a/lib/megaco/doc/src/megaco_performance.xml
+++ b/lib/megaco/doc/src/megaco_performance.xml
@@ -4,7 +4,7 @@
 <chapter>
   <header>
     <copyright>
-      <year>2002</year><year>2016</year>
+      <year>2002</year><year>2021</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -47,19 +47,21 @@
       our different encoders/decoders. The result of each one is summarized 
       in the table below.</p>
 
+      
 
     <table>
       <row>
@@ -74,128 +76,101 @@
       <row>
         <cell align="left" valign="middle">pretty</cell>
         <cell align="right" valign="middle">336</cell>
-        <cell align="right" valign="middle">20 / 13</cell>
-        <cell align="right" valign="middle">75 / 40</cell>
-        <cell align="right" valign="middle">95 / 53</cell>
+        <cell align="right" valign="middle">5</cell>
+        <cell align="right" valign="middle">12</cell>
+        <cell align="right" valign="middle">17</cell>
       </row>
       <row>
         <cell align="left" valign="middle">pretty [flex]</cell>
         <cell align="right" valign="middle">336</cell>
-        <cell align="right" valign="middle">20 / 13 / 20</cell>
-        <cell align="right" valign="middle">39 / 33 / 38</cell>
-        <cell align="right" valign="middle">59 / 46 / 58</cell>
+        <cell align="right" valign="middle">5</cell>
+        <cell align="right" valign="middle">11</cell>
+        <cell align="right" valign="middle">16</cell>
       </row>
 
       
       <row>
         <cell align="left" valign="middle">compact</cell>
         <cell align="right" valign="middle">181</cell>
-        <cell align="right" valign="middle">17 / 10</cell>
-        <cell align="right" valign="middle">62 / 35</cell>
-        <cell align="right" valign="middle">79 / 45</cell>
+        <cell align="right" valign="middle">4</cell>
+        <cell align="right" valign="middle">10</cell>
+        <cell align="right" valign="middle">14</cell>
       </row>
       <row>
         <cell align="left" valign="middle">compact [flex]</cell>
         <cell align="right" valign="middle">181</cell>
-        <cell align="right" valign="middle">17 / 10 / 17</cell>
-        <cell align="right" valign="middle">37 / 31 / 36</cell>
-	<cell align="right" valign="middle">54 / 41 / 53</cell>
+        <cell align="right" valign="middle">4</cell>
+        <cell align="right" valign="middle">9</cell>
+	<cell align="right" valign="middle">13</cell>
       </row>
 
       
       <row>
         <cell align="left" valign="middle">per bin</cell>
         <cell align="right" valign="middle">91</cell>
-        <cell align="right" valign="middle">60 / 29</cell>
-        <cell align="right" valign="middle">64 / -</cell>
-        <cell align="right" valign="middle">124 / -</cell>
-      </row>
-      <row>
-        <cell align="left" valign="middle">per bin [driver]</cell>
-        <cell align="right" valign="middle">91</cell>
-        <cell align="right" valign="middle">39 / 24</cell>
-        <cell align="right" valign="middle">42 / 26</cell>
-        <cell align="right" valign="middle">81 / 50</cell>
+        <cell align="right" valign="middle">6</cell>
+        <cell align="right" valign="middle">6</cell>
+        <cell align="right" valign="middle">12</cell>
       </row>
       <row>
         <cell align="left" valign="middle">per bin [native]</cell>
         <cell align="right" valign="middle">91</cell>
-        <cell align="right" valign="middle">45 / 21</cell>
-        <cell align="right" valign="middle">48 / -</cell>
-        <cell align="right" valign="middle">93 / -</cell>
-      </row>
-      <row>
-        <cell align="left" valign="middle">per bin [driver,native]</cell>
-        <cell align="right" valign="middle">91</cell>
-        <cell align="right" valign="middle">25 / 15</cell>
-        <cell align="right" valign="middle">27 / 18</cell>
-        <cell align="right" valign="middle">52 / 33</cell>
+        <cell align="right" valign="middle">4</cell>
+        <cell align="right" valign="middle">3</cell>
+        <cell align="right" valign="middle">7</cell>
       </row>
 
       
       <row>
         <cell align="left" valign="middle">ber bin</cell>
         <cell align="right" valign="middle">165</cell>
-        <cell align="right" valign="middle">32 / 19</cell>
-        <cell align="right" valign="middle">38 / 21</cell>
-        <cell align="right" valign="middle">70 / 40</cell>
-      </row>
-      <row>
-        <cell align="left" valign="middle">ber bin [driver]</cell>
-        <cell align="right" valign="middle">165</cell>
-        <cell align="right" valign="middle">32 / 19</cell>
-        <cell align="right" valign="middle">33 / 20</cell>
-        <cell align="right" valign="middle">65 / 39</cell>
+        <cell align="right" valign="middle">6</cell>
+        <cell align="right" valign="middle">6</cell>
+        <cell align="right" valign="middle">12</cell>
       </row>
       <row>
         <cell align="left" valign="middle">ber bin [native]</cell>
         <cell align="right" valign="middle">165</cell>
-        <cell align="right" valign="middle">17 / 11</cell>
-        <cell align="right" valign="middle">25 / 13</cell>
-        <cell align="right" valign="middle">42 / 24</cell>
-      </row>
-      <row>
-        <cell align="left" valign="middle">ber bin [driver,native]</cell>
-        <cell align="right" valign="middle">165</cell>
-        <cell align="right" valign="middle">17 / 11</cell>
-        <cell align="right" valign="middle">17 / 12</cell>
-        <cell align="right" valign="middle">34 / 23</cell>
+        <cell align="right" valign="middle">4</cell>
+        <cell align="right" valign="middle">3</cell>
+        <cell align="right" valign="middle">7</cell>
       </row>
 
       
       <row>
         <cell align="left" valign="middle">erl_dist</cell>
         <cell align="right" valign="middle">875</cell>
-        <cell align="right" valign="middle">5  /  5</cell>
-        <cell align="right" valign="middle">10 / 10</cell>
-        <cell align="right" valign="middle">15 / 15</cell>
+        <cell align="right" valign="middle">2</cell>
+        <cell align="right" valign="middle">5</cell>
+        <cell align="right" valign="middle">7</cell>
       </row>
       <row>
         <cell align="left" valign="middle">erl_dist [megaco_compressed]</cell>
         <cell align="right" valign="middle">405</cell>
-        <cell align="right" valign="middle">6  / 4</cell>
-        <cell align="right" valign="middle">7  / 4</cell>
-        <cell align="right" valign="middle">13 / 8</cell>
+        <cell align="right" valign="middle">1</cell>
+        <cell align="right" valign="middle">2</cell>
+        <cell align="right" valign="middle">3</cell>
       </row>
       <row>
         <cell align="left" valign="middle">erl_dist [compressed]</cell>
         <cell align="right" valign="middle">345</cell>
-        <cell align="right" valign="middle">47 / 47</cell>
-        <cell align="right" valign="middle">20 / 20</cell>
-        <cell align="right" valign="middle">67 / 67</cell>
+        <cell align="right" valign="middle">15</cell>
+        <cell align="right" valign="middle">9</cell>
+        <cell align="right" valign="middle">24</cell>
       </row>
       <row>
         <cell align="left" valign="middle">erl_dist [megaco_compressed,compressed]</cell>
         <cell align="right" valign="middle">200</cell>
-        <cell align="right" valign="middle">34 / 33</cell>
-        <cell align="right" valign="middle">11 /  9</cell>
-        <cell align="right" valign="middle">45 / 42</cell>
+        <cell align="right" valign="middle">11</cell>
+        <cell align="right" valign="middle">4</cell>
+        <cell align="right" valign="middle">15</cell>
       </row>
 
       <tcaption>Codec performance</tcaption>
     </table>
   </section>
 
+  
 
   <section>
     <title>Description of encoders/decoders</title>
@@ -277,16 +253,16 @@ MEGACO/1 [124.124.124.222]
       keywords:</p>
     <pre>
 !/1 [124.124.124.222] T=9998{
-  C=-{SC=ROOT{SV{MT=RS,AD=55555,PF=ResGW/1,RE="901 MG Cold Boot"}}}}    </pre>
+  C=-{SC=ROOT{SV{MT=RS,AD=55555,PF=ResGW/1,RE="901 MG Cold Boot"}}}}</pre>
   </section>
 
   <section>
     <title>Setup</title>
     <p>The measurements has been performed on a 
-      HP xw4600 Workstation with 
-      a Intel(R) Core(TM)2 Quad CPU Q9550 @ 2.83GHz, with 4 GB memory and 
-      running Ubuntu 10.04 x86_64, kernel 2.6.32-22-generic. 
-      Software versions was open source OTP R13B04 (megaco-3.14).</p>
+      Dell Precision 5550 Laptop with 
+      a Intel(R) Core(TM) i7-10875H CPU @ 2.30GHz, with 40 GB memory and 
+      running Ubuntu 20.04 x86_64, kernel 5.4.0-91-generic. 
+      Software versions was open source OTP 24.2 (megaco-4.2).</p>
   </section>
 
   <section>
@@ -309,7 +285,7 @@ MEGACO/1 [124.124.124.222]
           to our fastest text encoder (compact). </p>
       </item>
       <item>
-        <p>our fastest binary decoder (ber) is about 54% (61%) faster than our 
+        <p>our fastest binary decoder (ber) is about 66% faster than our 
           fastest text decoder (compact). </p>
       </item>
     </list> 
-- 
2.31.1

Places

File 0371-megaco-doc-Update-the-performance-and-debug-chapters.patch of Package erlang (Revision 57cf7c87cb80e2aaaf3f20327bf57529)

Places