Project

General

Profile

Xgoldscanner » History » Revision 3

Revision 2 (Linus, 12/23/2013 05:19 PM) → Revision 3/6 (Linus, 12/23/2013 05:20 PM)

h1. Xgoldscanner 

 This script collects 2G and 3G traces using Samsung Android phones. 
 The trace log files can be analyzed with Tobias Engel's "xgoldmon":https://github.com/2b-as/xgoldmon tool, which heavily inspired the development of xgoldscanner. 

 h3. Requirements 

 * Samsung Galaxy S2 / S3    phone 
 * Micro-USB cable 
 * Linux computer 

 h3. Download 

 TODO: 

 * "Source Source Code (bash)":https://opensource.srlabs.de/attachments/download/78/xgoldscanner.zip (bash) 
 * Live System 

 h3. Disclaimer 

 The tests include an active part. First, your phone will place outgoing calls to a dedicated number. This number will always be busy and never answer in order to rule out voice charges as best as we can. 

 Second, your phone will send SMS short messages via an invalid SMS-C to an invalid number. 

 During our tests (in Europe) we have not encounter any network that would charge for these transactions. However, we can not rule out that you may be charged in specific settings. 

 To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests. 

 h3. Instructions 

 # Download TODO 
 # unpack TODO 
 # run:    <pre>sudo ./xgoldscanner.sh -n [telephone number, e.g. +491234567]</pre> 
 Optional parameters: 
 *    -g    conduct GPRS test 
 *    -d    display debug messages 
 *    -o    offline mode [skip log upload for manual submission] 
 *    -3    conduct 3G tests only [skip 2G tests] 
 *    -y    assume "yes" to questions and confirmation dialogues [for automated testing] 
 *    -i    <n> repeat each test <n> times (default is 5) 

 h3. Advanced usage 

 Use Tobias Engel's "xgoldmon":https://github.com/2b-as/xgoldmon tool to analyze the trace log files. 

 h3. Mailing list 

 A public mailing list for discussions is found "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap