PILOT-LINK(7)						 Miscellaneous Information Manual					     PILOT-LINK(7)

NAME

       pilot-link - a suite of tools for communicating with Palm handheld devices, such as those made from Palm, Handspring, Handera, TRGPro, Sony
       or other Palm Compatible Handheld PDA device

DESCRIPTION

       The pilot-link suite of tools contains a series of conduits for moving information to and  from	your  Palm  device  and  your  desktop	or
       server/workstation system.

TARGET DEVICE

       All  of	the pilot-link programs will default to /dev/pilot as the default device used to communicate with a Palm. In general, if the envi-
       ronment variable $PILOTPORT is set, its value will override the default. A serial device specified on the command-line will be used regard-
       less of any $PILOTPORT setting.

       The  default  connection  rate is 9600 baud. You are welcome to try higher baud rates (19200, 38400, 57600 or higher) by setting the $PILO-
       TRATE environment variable, but various machines have various limitations. (Be careful about values higher than 115200 on  Linux  boxes	if
       you've been using setserial to change the multiplier.)

USAGE

       Here is a list of programs available from within the pilot-link package as of the date of this manpage.

       addresses
	      dump the Palm address book into a generic text-output format

       debugsh
	      command-line interface to a Palm debug monitor

       dlpsh  command-line  interface  to Palm HotSync protocol. This is very useful for debugging potential problems with your serial port. Query
	      the RAM/ROM, list databases, change your UserID or Username, and many more functions.

       getrom program to fetch ROM using getrom.prc or getrom2.prc

       getrom.prc
	      Palm program to help dump a 512K ROM

       getrom2.prc
	      Palm program to help dump a 1024K ROM (used for PalmOS 2.x)

       ietf2datebook
	      convert IETF calendar to format used by install-datebook

       install-datebook
	      import datebook records from a text format into the Palm

       install-memo
	      import Memo records from a text format into the Palm

       install-todos
	      import ToDo records from a text format into the Palm

       install-user
	      modify User Preference settings and report additional intormation about the Palm, such as the Network Hotsync ID and Username/UserID

       memos  export memos from the Palm in mailbox format into one file, or one of two formats: one-file-per-record or one-directory-per-category

       pi-csd this must be running to accept Network HotSync(tm) connects

       pi-getram
	      program that retrieves the RAM from Palm

       pi-getrom
	      program that retrieves ROM from Palm (without getrom.prc)

       pi-getromtoken
	      program that retrieves the ROM tokens from the Palm, such as the serial number of the device, if available

       pi-nredir
	      program that accepts connections and redirects them via the Network HotSync(tm) protocol

       pi-port
	      experimental program to abstract the serial layer from pilot-link

       pilot-addresses
	      import and export records from the Address Book (AddressDB.pdb) on your Palm

       pilot-clip
	      experimental program to import and export data from Palm clipboard

       pilot-debug
	      graphical and command-line program to interface with Palm debug monitor

       pilot-dedupe
	      strips duplicate records from Palm databases

       pilot-file
	      dissect .prc and .pdb files to view header, app_info, and record information

       pilot-mail
	      import mail from POP3 mailbox into Palm's default Mail application, and send mail via sendmail. This has	been  replaced	by  pilot-
	      mailsync	from  Hollis Blanchard <hollis@amulet.co.jp>. Please see the CREDITS file for additional information on how to obtain this
	      package.

       pilot-schlep
	      stores a single file of any data type (such as .zip or .mp3) on the Palm or retrieves one from the Palm

       pilot-undelete
	      turn previously archived records into normal records by resetting the Dirty bit

       pilot-xfer
	      back up, restore, install & delete Palm databases. The Swiss Army Chainsaw of pilot-link

       read-expenses
	      export Palm expense database into text format

       read-ical
	      export Palm Datebook and ToDo databases (DatebookDB.pdb and ToDoDB.pdb respectively) into an Ical calendar (ical is required)

       read-notepad
	      reads record information and images created with the Palm OS4 and later NotePad application

       read-palmpix
	      reads images created with the Kodak PalmPix "snap-on" camera

       read-todos
	      export Palm ToDo database into generic text format

       reminders
	      export Palm Datebook into a 'remind' data file

       sync-plan
	      completely synchronize the Palm datebook with the Plan calendar via netplan, including authenticating to the netplan server

ADVANCED PROGRAMS

       Some of these programs are not intended for general end-users. More detailed documentation on their usage can be obtained  by  reading  the
       source of the application.

       ccexample
	      test program demonstrating C++ interface

       iambicexample
	      test program demonstrating C++ interface

       validate
	      experimental program to test C++ features

OBTAINING

       The  most  current  version of the pilot-link suite of tools can be found at the following web site:

	      http://pilot-link.org/

MAILING LIST

       The  original  pilot-unix  mailing  list has been taken offline, and is now being hosted and maintained by David A. Desrosiers <desrod@gnu-
       designs.com>.  The original pilot-unix mailing list was maintained by Matthew Cravit. Its mandate is:

	      The pilot-unix mailing list is for discussion and idea-sharing for those interested in using your Palm PDA with UNIX  systems.  This
	      includes	people	who  are interested in helping to develop tools to allow the Palm to operate with UNIX, and possibly to develop an
	      SDK for the Palm for Unix.

       For more information,  including  how  to  subscribe  to  the  list,  please  visit  the  following  page:  http://www.pilot-link.org/mail-
       man/listinfo/pilot-unix-ng  pilot-link specific mailing lists are also available for Development, General, and Announce topics, at the fol-
       lowing:

	      http://www.pilot-link.org/mailman/listinfo/pilot-link-devel
	      http://www.pilot-link.org/mailman/listinfo/pilot-link-general
	      http://www.pilot-link.org/mailman/listinfo/pilot-link-announce

SEE ALSO

       dlpsh(1),  ietf2datebook(1),  install-datebook(1),  install-hinote(1),	install-memo(1),   install-netsync(1),	 install-user(1),   pilot-
       addresses(1), pilot-xfer(1), read-ical(1), read-notepad(1), read-palmpix(1)

       David Silber <pilot@orbits.com> has written a Pilot HOWTO, which you can find at: http://www.sgmltools.org/HOWTO/Pilot-HOWTO/t1.html

AUTHOR

       Most  of  the pilot-link tools were written by Kenneth Albanowski.  This manual page was written by David H. Silber <pilot@orbits.com>, and
       updated for this version of pilot-link by David A. Desrosiers <desrod@gnu-designs.com>.

       Current maintainer of pilot-link as of the authoring of this manpage is David A. Desrosiers <desrod@gnu-designs.com>.

       Any questions or problems with pilot-link should be directed at the various pilot-link mailing lists.

PATCHES

       All patches should be sent to <pilot-link@pilot-link.org> directly.

FSF
							    Palm Computing Device Tools 					     PILOT-LINK(7)