Project

General

Profile

Xgoldscanner » History » Version 5

Linus, 12/23/2013 05:23 PM

1 1 Linus
h1. Xgoldscanner
2
3
This script collects 2G and 3G traces using Samsung Android phones.
4
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.
5
6
h3. Requirements
7
8
* Samsung Galaxy S2 / S3  phone
9
* Micro-USB cable
10
* Linux computer
11
12
h3. Download
13
14
* "Source Code (bash)":https://opensource.srlabs.de/attachments/download/78/xgoldscanner.zip
15 4 Linus
* "Live System":https://opensource.srlabs.de/projects/mobile-network-assessment-tools/wiki/GSMmap-live
16 2 Linus
17
h3. Disclaimer
18
19
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.
20
21
Second, your phone will send SMS short messages via an invalid SMS-C to an invalid number.
22
23
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.
24
25
To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests.
26 1 Linus
27
h3. Instructions
28 2 Linus
29 5 Linus
# "Download":https://opensource.srlabs.de/attachments/download/78/xgoldscanner.zip
30 4 Linus
# unpack: <pre>unzip xgoldscanner.zip</pre>
31 2 Linus
# run:  <pre>sudo ./xgoldscanner.sh -n [telephone number, e.g. +491234567]</pre>
32
Optional parameters:
33
*  -g  conduct GPRS test
34
*  -d  display debug messages
35
*  -o  offline mode [skip log upload for manual submission]
36
*  -3  conduct 3G tests only [skip 2G tests]
37
*  -y  assume "yes" to questions and confirmation dialogues [for automated testing]
38
*  -i  <n> repeat each test <n> times (default is 5)
39
40
h3. Advanced usage
41
42
Use Tobias Engel's "xgoldmon":https://github.com/2b-as/xgoldmon tool to analyze the trace log files.
43
44
h3. Mailing list
45
46
A public mailing list for discussions is found "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap