aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHolger Hans Peter Freyther <zecke@selfish.org>2011-08-15 13:09:24 +0200
committerHolger Hans Peter Freyther <zecke@selfish.org>2011-08-15 13:12:34 +0200
commite5a98e5b79a554d96b203d763054728c0adc6288 (patch)
tree52d30fb9a6256cfe94f9f687531a662d835a6e1b
parente3fb596c640151c9c49a601fe3f1525c1761d3e4 (diff)
doc: Document building wireshark
-rw-r--r--docs/chapters/building.xml41
-rw-r--r--docs/usermanual.xml6
2 files changed, 47 insertions, 0 deletions
diff --git a/docs/chapters/building.xml b/docs/chapters/building.xml
index 7b25999..09625da 100644
--- a/docs/chapters/building.xml
+++ b/docs/chapters/building.xml
@@ -44,4 +44,45 @@ cc -o simtrace main.o usb_helper.o usb.o apdu_split.o -lusb `pkg-config --libs l
</screen>
</section>
</section>
+
+ <section id="building_wireshark">
+ <title>Building Wireshark</title>
+ <para>SIMtrace provides a patch against <command>wireshark</command>
+ version 1.6. It is the easiest to checkout a copy using the 1.6 branch
+ of wireshark and applying the <filename>simcard.patch</filename> on top
+ of it. And then use the usual way of building wireshark</para>
+
+ <section id="getting_wireshark">
+ <title>Getting Wireshark</title>
+ <screen>
+$ svn co https://anonsvn.wireshark.org/wireshark/trunk-1.6 wireshark-1.6
+A wireshark-1.6/isprint.h
+ U wireshark-1.6
+Checked out revision 38543.
+ </screen>
+ </section>
+
+ <section id="getting_simcard.patch">
+ <title>SIMCard patch</title>
+ <para>You will need to download and apply the patch.</para>
+ <screen>
+$ cd wireshark-1.6
+$ wget http://cgit.osmocom.org/cgit/simtrace/tree/wireshark/simcard-for-wireshark-1.6.patch
+$ cat ../simcard-for-wireshark-1.6.patch | patch -p 0
+patching file epan/dissectors/packet-gsm_sim.c
+patching file epan/dissectors/packet-gsmtap.c
+patching file epan/dissectors/Makefile.common
+ </screen>
+ </section>
+
+ <section id="building_and_installing">
+ <title>Building and Installing</title>
+ <screen>
+$ autoreconf --install
+$ ./configure
+$ make
+$ sudo ./wireshark
+ </screen>
+ </section>
+ </section>
</chapter>
diff --git a/docs/usermanual.xml b/docs/usermanual.xml
index d69f443..1c01704 100644
--- a/docs/usermanual.xml
+++ b/docs/usermanual.xml
@@ -28,6 +28,12 @@
<authorinitials>z</authorinitials>
<revremark>Copy HW Info from the Wiki</revremark>
</revision>
+ <revision>
+ <revnumber>0.0.3</revnumber>
+ <date>15 August 2011</date>
+ <authorinitials>z</authorinitials>
+ <revremark>Document building wireshark</revremark>
+ </revision>
</revhistory>
<title>SIMtrace Usermanual</title>