Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

Tree [8f9ae0] before_new_ncpd /
History



File Date Author Commit
conf 2002-02-28 Fritz Elfert Fritz Elfert [4f4971] - Added SIS stuff by Daniel Brahneborg
doc 2000-11-11 Fritz Elfert Fritz Elfert [dadadd] Fixed mountpoint-variable
etc 2001-07-23 Fritz Elfert Fritz Elfert [0c63f1] Some fixes
include 2002-02-15 Fritz Elfert Fritz Elfert [a15cf8] - Fixed psitime again. Waaahh, these guys at sy...
kde2 2002-02-14 Fritz Elfert Fritz Elfert [dd8485] - Added missing icons.
lib 2002-03-04 Daniel Brahneborg Daniel Brahneborg [dbfc3e] Use plp standard types.
ncpd 2002-02-16 Fritz Elfert Fritz Elfert [12241e] - Applied patches from Luke Diamand, Marc Spoo...
patches 2001-06-11 Fritz Elfert Fritz Elfert [bf74b2] Added kde mimetype patch.
plpbackup 2002-02-15 Fritz Elfert Fritz Elfert [b3c049] - plpbackup: more error handling; translation
plpftp 2002-03-02 Daniel Brahneborg Daniel Brahneborg [9df890]
plpnfsd 2002-02-14 Fritz Elfert Fritz Elfert [046bcf] - Unified headers.
plpprint 2002-03-04 Fritz Elfert Fritz Elfert [c3375b] Implemented images
po 2002-02-15 Fritz Elfert Fritz Elfert [b3c049] - plpbackup: more error handling; translation
sisinstall 2002-03-04 Daniel Brahneborg Daniel Brahneborg [8f9ae0] Use standard plp types.
.cvsignore 2001-03-24 Fritz Elfert Fritz Elfert [0f1ffc] NLS fixes, kpsion config
CHANGES 2001-05-17 Fritz Elfert Fritz Elfert [94e5f8] Added changes for release of 0.8
COPYING 1999-07-01 Fritz Elfert Fritz Elfert [0d619e] Updated GPL and added generic INSTALL
INSTALL 2000-01-17 Fritz Elfert Fritz Elfert [ab1811] Release of plptools-0.5
Makefile.am 2002-02-28 Fritz Elfert Fritz Elfert [4f4971] - Added SIS stuff by Daniel Brahneborg
Makefile.cvs 2002-03-04 Fritz Elfert Fritz Elfert [b68ab4] Added buildnox tartget
README 2001-05-21 Fritz Elfert Fritz Elfert [0fed1c] Added --with-kdedir
README.0.6-mjg 2000-07-31 Fritz Elfert Fritz Elfert [7fb94e] Applied mjg-0.6 patch.
README.mjg 2000-01-17 Fritz Elfert Fritz Elfert [ab1811] Release of plptools-0.5
TODO 1999-07-05 Fritz Elfert Fritz Elfert [7f21d8] Added RCS-Id's
acconfig.h 2002-02-15 Fritz Elfert Fritz Elfert [b3c049] - plpbackup: more error handling; translation
configure.in 2002-03-04 Fritz Elfert Fritz Elfert [69700c] Added generation of PostScript prolog and suppl...

Read Me

 $Id$

 This package is heavily based on two other packages:

   - p3nfsd-5.4 by Rudolf Koenig (rfkoenig@immd4.informatik.uni-erlangen.de)
     an nfs daemon for Psion series 3 and 5
   - plp_1_7 by Philip Proudman (phil@proudman51.freeserve.co.uk)

 I want to thank both authors for their nice packages and for making
 these available under GPL which makes it possible for me to
 create this package (which of course is distributed under GPL ass well)

 What i did:

 I modified and improved Philip's code to support more (nearly all?)
 rfsv32 commands and to gain speed (approx 4 times) and stability
 (properly reconnects on lost serial link).
 Rudolf's code originally used a homegrown protocol which needs a
 separate program running on the Psion. I changed his code to use
 the socket-based client-code from Philip's rfsv program thus
 eliminating the need for any software beeing run on the Psion.
 The rfsv code and some other stuff went into a lib (both shared
 and static available). I also removed all Psion-3 related stuff,
 because a) i can't test it and b) Sibo support is dropped by
 Psion.

 Since version 0.5, there is also starting support for RPC-service
 on the Psion. Note the new commands "ps", "kill" and "run" in
 plpftp. This support was only possible because of Alexander Thoukydides'
 excellent documentation at
 http://www.btinternet.com/~thouky/software/psifs/plp.html
 Thanks a lot for that. Also Psion-3 support is now added by Matt Gumbley
 (matt@gumbley.demon.co.uk)

 How to install:

 ./configure
 make
 make install

 In addition to the ususal options (see INSTALL), configure
 understands the following stuff for customization to your
 environment:

  --enable-debug

       Adds -g to CFLAGS, so you will get debugging-versions of
       the programs and libplp

  --with-serial=/dev/sometty

       overrides the default serial device for ncpd. Without this
       option, configure tries to automagically find a serial device.

  --with-speed=baudrate

       overrides the default serial speed of 115200 baud.

  --with-port=portnum

       overrides the default port number, where ncpd listens
       and plpftp resp. plpnfsd connects to.

  --with-drive=drivespec

       overrides the default drive for plpftp. The default "AUTO"
       triggers a drive-scan on the psion and sets the drive to
       the first drive found. If you don't want that, specify
       C: for example.

  --with-basedir=dirspec

       overrides the default directory for plpftp. The default is \\
       which means the root-dir. Note: directory-separators have to
       be specified as C-like backslashes and if you consider shell's
       escape-mechanism, these in turn have to be escaped with backslashes ;-)

  --disable-mnttab

       By default, configure checks for existence of /etc/mtab or /etc/mnttab
       and configures plpnfsd to update that file every time when it
       mounts or unmounts the psion. If plpnfsd crashes or is killed during
       that update, /etc/mtab resp. /etc/mnttab can be corrupted. Since
       this file on some operating systems is vital for functionality
       of mount/umount, this update can be disabled with the above option.

  --enable-kde

       Enable build of KDE related stuff. This needs installed
       KDE 2.1 headers/development-libraries as well as QT 2.2.4
       headers/development-libraries.

  --with-kdedir=/path/to/your/kde

       Specify the KDE directory. I got several reports from SuSE users,
       who have KDE1 and KDE2 in those weird pathes /opt/kde and /opt/kde2
       installed and the automatic detection does get confused by that.
       So be shure to use this switch. RedHat users can safely use
       --prefix=/usr instead.

  --with-qt-dir=/path/to/your/qtdir

   or 

  --with-qt-includes=/path/to/your/qt-headers
  --with-qt-libraries=/path/to/your/qt-lib

      Same as above. Use these, when automatic detection fails.

 You will get 3 programs and a shared and static library (in
 case you enabled KDE: 4 Programs 4 shared libraries).
 By default, the install-prefix is /usr/local, so you probably
 should add /usr/local/lib to your /etc/ld.so.conf and then run
 ldconfig after installation. Another option is to run configure
 with the option --prefix=/usr

 Please read the man pages ncpd(8) plpftp(1) and plpnfsd(8)! The
 information there is more up-to-date.

 The programs:

 ncpd is the daemon which handles the serial link to your Psion.
 It listens at port 7501 for local connections and provides
 basic PLP/NCP services for the other two programs. It auto-
 connects to the psion, even after unplugging/switching off
 therefore it can run always in background (if you have a
 spare serial-device). If supplied, the -e option will cause ncpd to
 automatically exit when the connection to the Psion is lost. This is useful
 when used with a patch to mgetty (see the patches directory).

 plpftp is a FTP-like program for manipulating files on the Psion.

 plpnfsd is a daemon, which provides NFS-like access to your Psion.
 It automatically makes the psion's filesystems available below
 an NFS-mounted directory (default /mnt/psion).
 By default, plpnfsd is installed suid-root, so any normal user
 can start it and get's the mounted directory owned by himself.
 As this program is usually used on single-user machines, this
 does not hurt security. Like the others, this program
 auto-reconnects after a link-failure, so you can keep the
 psion mounted all the time, even when it is not connected.
 Due to Rudol Koenig's clever error-handling, you don't need to
 worry about blocked io-processes if the psion isn't available.
 You simply will get an "device not configured" error, when
 accessing a file on a previously connected psion which has been
 disconnected. After that, the mount-point will appear empty.
 As soon as the psion is connected again, the subdirectories
 will reappear. (possibly with a few secs delay)

 The KDE2 KIOslave library adds support for a new protocol named
 "psion:". So in konqueror, just open psion:/ to see your Psion's
 drives. You now can copy, move, rename, open ... all those
 operations you are used to. Any KDE application which supports
 URLs should be able to deal with the files on the Psion.
 If you have the toplevel directory displayed in Konqueror, the
 Property dialog for the drives (right-click on an icon of a
 drive, Properties) comes up in a modified fashion which allows
 you to see the drive usage as well as triggering backup, restore
 and format. The toplevel Properties (right-click on the view's
 background, Properties) brings up a Dialog which displays machine-
 related information. (Same info like the "machinfo" command in
 plpftp. Currently there are no mime-types for Psion-Files but i
 soon will add these. Backup, restore and format is done by a separate
 standalone program "KPsion".

Have fun.
 -Fritz