NFRtools Files

 Author: A.Keledjian <dervish@altern.org>
 Copyright: GPL3
 Revision: 0.4
 Various tools for freerunner

 History:

 0.4:	Better ssh connection hangup
	Better way to detect phone interface
	Use public key for ssh connection for several options

 0.3:	Export contacts in csv format (thunderbird for the moment and incomplete) 
	Export phone info result in text format file
	Zipping some transferts between phone and host
	Open ssh connection on the phone

 0.2:	Change phone's ip and default route
	Get some phone's info (Actually works with qtmoko)

 0.1: 	Set up phone's connection and deconnection
        Save and restore private data
 Todo:
	- a better way to choose what have to be in the backup
	- install new distro
	- update distro
	- gui

NFRtools is a script shell which try to act like swiss-army-knife for the phones from openmoko.
It permit to set up easily a usb connection with the phone. It allow to backup and restore locations
in the phone.

Requirement:
To use it, you need: bash, iptables, udev 
You also need to be root or use sudo in order to perform several actions

First of all:

mv ./NFRtools-X.Y ./NFRtools
chmod +x ./NFRtools

How to use it:
For each action, you need first to set up the connection to the phone. For that,
just type: 

./NFRtools -c

The script will search the phone and configure it with default values (you can modify them in the script).

If, for some reasons the detection of the phone fail, you can use the -i option like this:

./NFRtools -c -i eth2

You can enable masquerading nat with the --nat option.
You can also specify the ip you want for the phone and for your computer (respectively -p <ip address> and -l <ip address>

Once, the connection is set up, you can perform different tasks like:

*** Install user certificat on the phone:
./NFRtools --init-ssh
The script will search first your rsa public key then your dsa public key. If it found one of them (the first met),
it will ask you to use it. Else, it will generate one RSA key for you and install the public one on the phone. 

*** Change ip of the phone and setup the connection:

./NFRtools --change-ip-phone -p 10.0.0.2 -l 10.0.0.1

This will adjust ip for usb0 interface of the phone and the routing table.

*** You can save and restore datas from the phone.

To save, use:

./NFRtools --save  (to save de default location defined in the script)

or

./NFRtools -s "loc1 loc2 loc3" (where loc? is an absolute path to a file or directory)

This will give you a tarball (the prefix name is define in the script)

In order to restore a file or a directory (previously backup), use:

./NFRtools -r tarball_file

*** Getting info from the phone

You can retrieve some informations about the phone and the data stored in it:
The -I option allow to choose what kind of informations:
    STATS_MESS		Show recieved and sent message number by phone number  (works with qtmoko)
    STATS_CONT		Show contact number  (works with qtmoko)
    SYSTEM		Informations about kernel version, battery status
    			and health, memory, disk space and network interfaces. 
    CALL_HISTORY	Show call history (resp: phone number, start time, end time.

You just have to use it like that:

./NFRtools -I "SYSTEM STATS_MESS"

Use it as you want but don't forget one things, i'm not responsible for any loss of data or for what might happend.

Enjoy it!

P.S: next version should have a better english version... ;)