ChangeName documentation version 3.2
October 29. 2003 by Collin R. Mulliner <palm@mulliner.org>

With ChangeName you can set / change the PalmOS UserName (the HotSync name) und
PalmOS UserID. Also you can fake the FlashRom serial number and the OS version
(string).


                   N O  -  W A R R A N T Y


First a small explanation:

The UserName is the name of your PalmOS device (upper right corner in HotSync
screen). This identifies your PalmOS device. Most shareware programms use this
to generate a registration code.

The UserID is a number from 256 to 65535 (Word) this is also to identify your
PalmOS device. The PalmDesktop (Win/Mac) uses this number to identify your 
PalmOS device while syncing. The UserID is the actual criteria for identifing 
the device not the UserName. As far as I know the UserID is just a random number
chosen by the PalmDesktop software at the first HotSync. The numbers from 0 to 
255 are special 0 means no ID present, 1 to 255 are profiles.

If you just change the UserName and sync, the PalmDesktop will reset the
UserName to the old value (he identifies the device using the UserID).
So if you want to sync with a different user you have to change both the 
UserName and the UserID. If that UserID is new to the PalmDesktop you will be
asked if a new user should be created by the PalmDesktop. This also happens if
the UserID actualy is a profile ID (1-255) then a new profile will be created.
If the UserID is 0 (no UserID set) you have to select or creat a user. After the
sync the device will be reseted (soft reset).

The FlashRom serial number and the OS version (string) [only PalmOS < 5.x]:
On startup (the first startup) of ChangeName the original FlashRom serial number
and the OS version (string) will be displayed. If you don't change them nothing 
will happen. If you change one or both the system traps will be patched. If you
want to undo the patching just clear the fields and tap "Set ROM/OS", this will
do it. If you want to look at the results just go to "App" -> "Info" menu in the
standart launcher and select "Version" this will show you the changes. After a 
softreset ChangeName will repatch the traps for you.


comments are welcome ... Collin


email: palm@mulliner.org
website: www.mulliner.org/palm
