Project

General

Profile

Xgoldscanner » History » Version 3

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