Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
pilot-xfer(1)
Edit
PageHistory
Diff
Info
LikePages
PILOT-XFER !!!PILOT-XFER NAME SYNOPSIS DESCRIPTION TARGET DEVICE OPTIONS USAGE EXAMPLES SEE ALSO AUTHOR ---- !!NAME pilot-xfer - backup and restore databases to and from a Palm Computing Device, Handspring Visor, TRGPro, or other Palm Compatible Handheld PDA !!SYNOPSIS __pilot-xfer__ -p ''[['' [[__--exclude__ ''file''] __--backup__ | __--update__ | __--sync__ ''directory'' or __pilot-xfer__ -p ''[['' [[ __--restore__ ''directory'' | __--list__ | __--Listall__ | __--purge__ | __--fetch__ ''dbname'' ... | __--delete__ ''dbname'' ... | __--install__ ''file'' ... | __--merge__ ''file'' ... ] ... (Note that some options are not shown above and short option aliases are excluded for clarity) !!DESCRIPTION __pilot-xfer__ allows the user to install databases contained in the standard .prc and .pdb formats onto a Palm, retrieve databases from the Palm, list the databases contained in a Palm, and backup or restore all of the databases at once. Once the user has executed __pilot-xfer__ the user must invoke !HotSync on the target device. !!TARGET DEVICE The default serial device used to communicate with a Palm is __/dev/pilot__. If the environment variable __$PILOTPORT__ is set, its value will override the default. A serial device specified on the command-line will be used regardless of any __$PILOTPORT__ setting. !!OPTIONS Several options exist, including... __-a__ ''dir''__,__ Archives files which have been removed from the Palm to ''dir'' instead of just deleting (unlinking) them __-b__ ''dir''__, --backup__ ''dir'' Backs up the Palm into the specified directory (which will be created if it does not already exist). This operation must be specified ''after'' any __exclude__ option. __-c --count__ Counts the files as they go by, but shunts the displaying of the __-d__ ''dbname'' __[[...], --delete__ ''dbname'' __[[...]__ Delete the specified database(s) by name (without extension). Obviously, be very careful with this one. __-e__ ''file''__, --exclude__ ''file'' Reads a list of databases from ''file''. Prevents __--backup__, __--sync__, or __--update__ from operating on the listed database(s). This option must be specified before the __--backup__, __--sync__, or __--update__ operation whose action it modifies. __-f__ ''dbname'' __[[...], --fetch__ ''dbname'' __[[...]__ Fetch each specified database out of the Palm into the current directory. __-F__ Modifies the behavior of __--backup__, __--sync__, and __--update__ to back up non-OS databases which have been stored in FlashROM __-h, --help__ Displays a summary list of ''pilot-xfer'''s usage and exits. __-i__ ''file'' __[[...], --install__ ''file [[...]'' Install each specified file into the Palm. Wildcards are valid with this syntax. __-l, --list__ List the databases in the Palm, excluding OS-specific databases. __-L, --Listall__ List all of the databases on the Palm, including OS-specific native databases. __-m__ ''file'' __[[...], --merge__ ''file'' __[[...]__ Adds the records in each specified file into the corresponding Palm database. __-O__ Modifies the behavior of __--backup__, __--sync__, and __--update__ to back up OS databases which are stored in FlashROM __-p, --purge__ Purge any deleted data that hasn't been cleaned up by a sync (this is a safe operation, and will prevent your Palm from accumulating crud if you delete records but aren't syncing with a PIM.) The only information you can lose is archived but un-synced records. __-q, --quiet__ Causes ''pilot-xfer'' to be quiet and not display the '' __-r__ ''dir''__, --restore__ ''dir'' Installs all files contained in a directory into the Palm. (Use this to restore your Palm after a hard reset has cleared its memory, using your __backup__ directory as a baseline.) __-s__ ''dir''__, --sync__ ''dir'' Backs up the Palm into the specified directory (which will be created if it does not already exist). Any Palm databases which have not been modified or created since the versions stored in the specified directory will not be backed up. __NOTE:__ Any Palm databases which have been deleted will have their corresponding backup file removed. This operation must be specified ''after'' any __exclude__ option. __-u__ ''dir''__, --update__ ''dir'' Backs up the Palm into the specified directory (which will be created if it does not already exist). Any Palm databases which have not been modified or created since the versions stored in the specified directory will not be backed up. This operation must be specified ''after'' any __exclude__ option. __-U__ This will back up the !UnsavedPreferences.pdb file from the Palm. Normally this file is not backed up by normal means (Palm Computing recommends that you do __not__ restore this file upon restoration of your device using __--restore__ This also modifies the behavior of __--backup --sync__ and __--update__ __-v, --version__ Displays the version of ''pilot-link'' from which this program was installed and exits. !!USAGE The program will connect to a target device and port, prompt the user to !HotSync, and perform the requested database options specified by the user. !!EXAMPLES To backup a Palm: pilot-xfer --backup /home/pilot/Backup or pilot-xfer -p /dev/irnine -b /home/pilot/Backup To restore that backup to a non-standard serial port (for example, to a xcopilot or POSE session, assuming you have xcopilot or POSE configured properly for this operation, see the appropriate man pages for details on configuring your emulator): pilot-xfer -p /dev/ttyqe --restore /home/pilot/Backup !!SEE ALSO __pilot-link(7)__. !!AUTHOR __pilot-xfer__ written by Kenneth Albanowski. This manual page was originally written by Kenneth Albanowski and David H. Silber. Completely rewritten by David A. Desrosiers for pilot-link 0.9.5. ----
One page links to
pilot-xfer(1)
:
Man1p
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.