= gfree (by scotty2) =

See [http://forum.xda-developers.com/wiki/index.php?title=HTC_Vision#How_To_Get_R.2FW_Access_.28Permanent_Root_.2F_.22Permaroot.22.29] for instructions.

== gfree version 0.5 contained in gfree_05.zip ==
'''WARNING 0.5 the -b option is completely experimental. It has not been tested by anyone in real life.'''

If you are using this option then i '''highly recommend''' that after running it and syncing you create md5sums of the hboot.img that you installed and /dev/block/mmcblk0p18. If the md5sums don't match then '''first of all - DON'T REBOOT''' and second run for help at the #G2ROOT IRC channel on freenode.

'''gfree version 0.5 is known to have problems to disable the write protection on some vodafone desire z devices.'''

Changes:

* added -b option to install a hboot image file to partition 18. It will create a backup file of your existing partition 18 named /sdcard/part18backup-%lu.bin

''' Please make sure that you are using the correct hboot image file for your device! '''

{{{
gfree usage:
gfree [-h|-?|--help] [-v|--version] [-s|--secu_flag on|off]
	-h | -? | --help: display this message
	-v | --version: display program version
	-s | --secu_flag on|off: turn secu_flag on or off
	-c | --cid <CID>: set the CID to the 8-char long CID
	-S | --sim_unlock: remove the SIMLOCK
	-w | --disable_wp: disable write protect on eMMC and remove kernel filter only
        -b | --hboot: <hbootFile>: install hboot from image file 
        -r | --restore <backupFile>: restore partition from backup file
	-d | --debug: enable debug output

	-f | --free_all: same as --secu_flag off --sim_unlock --cid 11111111
}}}

== gfree version 0.4 contained in gfree_04.zip ==
'''gfree version 0.4 is known to have problems to disable the write protection on some vodafone desire z devices.'''

Changes:

* added -w option to ONLY disable the write protection on eMMC and remove the kernel filter. (this will make no changes to partition 7)

* added -d option to enable debug output

* added -r option to restore a backup file of partition 7 that was created during a previous run of gfree.

{{{
gfree usage:
gfree [-h|-?|--help] [-v|--version] [-s|--secu_flag on|off]
	-h | -? | --help: display this message
	-v | --version: display program version
	-s | --secu_flag on|off: turn secu_flag on or off
	-c | --cid <CID>: set the CID to the 8-char long CID
	-S | --sim_unlock: remove the SIMLOCK
	-w | --disable_wp: disable write protect on eMMC and remove kernel filter only
        -r | --restore <backupFile>: restore partition from backup file
	-d | --debug: enable debug output

	-f | --free_all: same as --secu_flag off --sim_unlock --cid 11111111
}}}

== gfree version 0.2 contained in gfree_02.zip ==
The new gfree version can be used to go back to S-ON and to set the CID back to whatever 8-character string you want.

It is still to be tested so use it with care.
{{{
gfree usage:
gfree [-h|-?|--help] [-v|--version] [-s|--secu_flag on|off]
	-h | -? | --help: display this message
	-v | --version: display program version
	-s | --secu_flag on|off: turn secu_flag on or off
	-c | --cid <CID>: set the CID to the 8-char long CID
	-S | --sim_unlock: remove the SIMLOCK

	-f | --free_all: same as --secu_flag off --sim_unlock --cid 11111111
}}}

== gfree_verify ==
Short guide how to verify that gfree worked.

Download and unpack gfree_verify.zip and unpack it on your PC.

Copy gfree_verify to the phone:
{{{
adb push gfree_verify /data/local
}}}
Get a shell
{{{
adb shell
}}}
In the shell
{{{
su
cd /data/local
chmod 777 gfree_verify
stop ril-daemon
./gfree_verify
}}}
You should see this output:
{{{
gfree verify_cid returned: 
@CID: 11111111

OK

gfree verify_secu_flag returned: 
@secu_flag: 0

OK

gfree verify_simlock returned: 
@SIMLOCK= 00

OK
}}}

Start the ril-daemon again by using
{{{
start ril-daemon
}}}
(or reboot your phone)