KPsion" -- delete this, if kpsion is in global KDE entities --> %ents; ]> The &kpsion; handbook Fritz Elfert
felfert@to.com
2001 Fritz Elfert &FDLNotice; __DATE__ __VERSION__ &kpsion; is an application for handling backup, restore and formatting of Psion PDAs. KDE plptools KPsion Psion PDA backup restore format
Introduction Welcome to &kpsion;! &kpsion; is an application handling backup, restore and formatting of Psion PDAs for the K Desktop Environment. It uses the daemon ncpd and the libraries from the plptools package. This program is meant to be started from the command line or from .desktop files. Installation Downloading &kpsion; is part of the plptools package. The plptools package is available at http://plptools.sourceforge.net/. Compiling The plptools package is not focussed on KDE application. Therefore, to enable the build of KDE related stuff (&kpsion; is part of that) you have to use the option when running plptools configure. The build process usual works like this: $ ./configure $ make $ make You will have to execute the last step as root. The installation process needs to be able to write to the system wide KDE directories. Using &kpsion; Usage of &kpsion; is easy. The syntax is one of the following: kpsion kpsion --autobackup kpsion --backup DRIVE kpsion --restore DRIVE kpsion --format DRIVE If started without any options, &kpsion; starts up in interactive mode. If started with any of the above options, &kpsion; performs the given task non interactively. This specifies to run a scheduled backup of the connected Psion. If no psion is connected, nothing happens. This option starts backup of the specified DRIVE. DRIVE is a single drive letter. This option starts restore of the specified DRIVE. DRIVE is a single drive letter. This option starts format of the specified DRIVE. DRIVE is a single drive letter. Configuration First time startup When you start &kpsion; the first time, a wizard dialog is shown which lets you easily configure the application for your personal use. The initial setup is divided into three steps: Select a backup directory Step one. Select a backup directory. Selecting the backup directory The backup directory will be used by &kpsion; for storing backup archives. You simply can accept the default proposed by this dialog if you don't have to care about disk space used in your home directory. Otherwise, select a directory of your choice by clicking on the Browse button. &kpsion; creates a that directory if it does not yet exist. Of course, you need the permission to do so. Adjust the backup strategy Step two. backup strategy. Setting the backup strategy In the second step, you can adjust the backup strategy. For both, incremental and full backups, you can select an interval. If any of these intervals is enabled, &kpsion; will create a .desktop Entry in your KDE Autostart folder. Every time KDE is started, this will start &kpsion; in autobackup mode. If the interval is expired and your Psion is currently connected, an unattended backup will be performed. The third adjustment to be made is the number of backup generations to keep. A backup generation consists of a full backup plus eventually made incremental backups. If a backup is completed sucessfully, &kpsion; will check, if there are more backup generations available and delete older backup generations. Connection parameters Step three. connection parameters. Setting connection parameters In the third step, you can adjust the behavior of &kpsion; during initial connect. If you set the connection retry interval to a non-zero value, &kpsion; will retry a connection attempt if it had failed. Since &kpsion; needs the ncpd daemon running, it is also possible to start this daemon on the fly if it is not running. For this, you need to have permissions to use the specified port. Internals TBD Questions and Answers &reporting.bugs; &updating.documentation; I have a Psion Series 3 and &kpsion; doesn't work. This is currently a known problem with the plptools lib. You have to wait until tis is fixed. Sorry. Author Copyright 2001 Fritz Elfert &kpsion; is written by Fritz Elfert. The author can be reached through email at felfert@to.com. Please report any bugs you find to me so that I can fix them. If you have a suggestion, feel free to contact me. &underFDL; &underGPL;