👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for pilot-xfer (opensolaris section 1)

pilot-xfer(1)				    PILOT-LINK				    pilot-xfer(1)

NAME
       pilot-xfer - Backup, sync, and restore databases from a Palm handheld device.

SECTION
       pilot-link: Userland conduits

SYNOPSIS
	pilot-xfer [-p <port>] [-e <file>] [-b] [-u] [-s] <directory>

       or

	pilot-xfer  [-p  <port>]  [-r <directory>] [-l] [-L] [-P] [-f <dbname>] [-d <dbname>] [-i
       <dbname>] [-m <file>] ...

       Use exactly one of -brsudfimlI; mix in -aexDPv, --rom and with-os.

DESCRIPTION
       This is the swiss-army-knife of the entire pilot-link suite.

	pilot-xfer allows the user to install databases contained  in  the  standard  .prc  (Palm
       Resource Database), .pdb (Palm Record Database), and .pqa (Palm Query Application) formats
       onto a Palm, retrieve databases from the Palm, list the databases  contained  in  a  Palm,
       backup  or  restore all of the databases at once as well as many other powerful operations
       performed on a Palm handheld device.

OPTIONS
   pilot-xfer options
			       -a, --archive
			       <dir>

       Archives files which have been removed from the Palm to <dir>  instead  of  just  deleting
       (unlinking) them.

			       -b, --backup
			       <dir>

       Backs  up  the  Palm  into  the	specified directory (which will be created if it does not
       already exist).

			       -C, --cardinfo

       Show information on available cards

			       --delete <dbname>

       Permanently delete the specified database(s) by name (without  extension).  Obviously,  be
       very careful with this one.

			       -D,
			       --vfsdir=dir

       Modifies -l, -i or -f to use VFS dir instead of internal storage (see examples section for
       usage)

			       -e,
			       --exclude=

				   <file>

       Reads a list of databases from <file> and prevents  --backup,  --sync,  or  --update  from
       operating on the listed database(s). A maximum of 100 databases can be excluded. Databases
       should be specified by name without the extension, as displayed with --list, in any order.

			       -f, --fetch
			       <dbname>

       Fetch each specified database out of the Palm into the current directory.

			       -F, --Flash

       Obsolete. Replaced by --rom in v0.12.

			       -i, --install
			       <file> [...]

       Install each specified file into the Palm. Wildcards are valid with this syntax and multi-
       ple files may be listed at once.

			       -l, --list

       Note: the behavior of list has changed in version 0.12 and later

       List all the databases in the Palm, including OS-specific native databases.

			       -L, --Listall

       Unsupported in 0.12 - see -l

			       -m, --merge
			       <file1> <file2> [...]

       Adds the records in each specified file into the corresponding Palm database.

			       -O, --Osflash

       Obsolete. Replaced by --with-os in v0.12 and later

			       -P, --Purge

       Purge  any  deleted data that haven't been cleaned up by a full synchronization (this is a
       safe operation, and will prevent your Palm from accumulating unused  data  if  you  delete
       records	but aren't syncing with a PIM.) The only information you can lose is archived but
       un-synchronized records.

			       -r, --restore
			       <dir>

       Installs all files contained in the named directory to the Palm. (Use this to restore your
       Palm after a hard reset has cleared and wiped its memory, using your backup directory as a
       baseline).

			       --rom

       Modifies -b, -u, and  s , to back up non-OS dbs from the internal Flash ROM

			       -s, --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 ver-
       sions 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.

			       -S, --novsf

       Not supported in v0.12. No replacement.

			       --with-os

       Modifies -b, -u, and  s , to back up OS databases from internal Flash ROM.

			       -u, --update

       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  ver-
       sions stored in the specified directory will not be backed up.

			       -I, --Illegal

       This will back up the UnsavedPreferences.prc file from the Palm. Normally this file is not
       backed up by normal means (Palm recommends that you do not restore this file upon restora-
       tion of your device using --restore.

       This also modifies the behavior of --backup, --sync, and --update.

			       -x, --exec=command

       Execute	a shell command for intermediate processing. All commands will be done, from left
       to right on the command-line, before the connection to the Palm device is made.

   Conduit Options
			       -p, --port
			       <port>

       Use device file <port> to communicate with the Palm handheld. If this  is  not  specified,
       pilot-xfer  will  look  for  the  $PILOTPORT  environment  variable. If neither are found,
       pilot-xfer  will print the usage information.

			       -v, --version

       Display version of pilot-xfer and exit without connecting.

   Help Options
			       -h, --help

       Display the help synopsis for pilot-xfer and exit without connecting.

			       --usage

       Display a brief usage message and exit without connecting.

USAGE
       The program will attempt to connect to a target Palm handheld device  and  specified  port
       and perform the requested options specified by the user on the commandline.

EXAMPLES
       To perform a full backup of your Palm handheld:

       # using long options

		       pilot-xfer --port /dev/pilot
			   --backup

		       $HOME/pilot/Backup

       # or over IrDA, using short options

		       pilot-xfer -p /dev/ircomm0 -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

       To fetch a file that is on your Palm handheld, such as the Palm Address Book database, you
       could do the following. This will connect to /dev/pilot and retrieve the records found  in
       AddressDB and place them in a local file called AddressDB.pdb (Palm Record Database).

		       pilot-xfer -p /dev/pilot --fetch
			   AddressDB

       This will connect to your Palm device and install the application Foo (in Foo.prc) to your
       external storage card (typically an SD or MMC card) in  the  directory  /Palm/Launcher  on
       that card, using VFS.

		       pilot-xfer -p /dev/pilot -i Foo.prc
			   -D /Palm/Launcher

AUTHOR
	pilot-xfer written by Kenneth Albanowski. This manual page was originally written by Ken-
       neth Albanowski and David H. Silber. Completely rewritten by David A. Desrosiers.  Updated
       for 0.12 by Neil Williams < linux@codehelp.co.uk > .

BUGS
   Known Bugs
	--backup will currently truncate/corrupt pdb/prc files if the communication to the device
       is interrupted during sync (such as removing the Palm from the cradle, or a temporary net-
       work  hiccup  during a NetSync). Ideally, this should restore the original file, or delete
       the corrupted version and restore the original version back into place, but presently.. it
       does not.

   Reporting Bugs
       We  have  an  online  bug tracker. Using this is the only way to ensure that your bugs are
       recorded and that we can track them until they are resolved or closed. Reporting bugs  via
       email,  while  easy,  is  not  very  useful  in terms of accountability. Please point your
       browser to http://bugs.pilot-link.org: http://bugs.pilot-link.org and report your bugs and
       issues there.

COPYRIGHT
       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as published by the Free Software Foundation;  either  ver-
       sion 2 of the License, or (at your option) any later version.

       This  program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,  Boston,
       MA 02110-1301, USA.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-------------------------------+-----------------------------+
       |ATTRIBUTE TYPE^ATTRIBUTE VALUE |			     |
       +-------------------------------+-----------------------------+
       |Availability^SUNWpilot-link    |			     |
       +-------------------------------+-----------------------------+
       |Interface stablility^Volatile  |			     |
       +-------------------------------+-----------------------------+

SEE ALSO
	libpisock(3), libpisync(3)

0.12.3				     Copyright 1996-2007 FSF			    pilot-xfer(1)


All times are GMT -4. The time now is 04:26 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?