From 9e674a2bd6351597329ac22b2fafe3996d56312c Mon Sep 17 00:00:00 2001 From: Reuben Thomas Date: Tue, 17 Jul 2007 23:46:25 +0000 Subject: Simplify README, removing installation instructions to INSTALL. --- README | 211 +++-------------------------------------------------------------- 1 file changed, 8 insertions(+), 203 deletions(-) (limited to 'README') diff --git a/README b/README index b06864b..cab26bf 100644 --- a/README +++ b/README @@ -1,205 +1,10 @@ $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) 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. - - --with-kdeversion=X - - Override the KDE version detection manually. Only needed in - special cases where more than one KDE version is installed and - autodetection fails. X can be either 2 or 3. - - You will get 6 programs and a shared and static library (in - case you enabled KDE: 8 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 - - NOTE: - Although the subdirectory for KDE stuff is named "kde2", this is only - for historical reason. The package builds on KDE2 as well as KDE3. - It tries to figure out the version of KDE automatically. People who have - both versions installed should carefully watch the output of configure. - The KDEDIR as well as KDE's version can be overridden via commandline - (see above). - - IMPORTANT NOTE about the following descriptions: - Please read the man pages ncpd(8) plpftp(1), plpnfsd(8) plpprintd(8), - sisinstall(1) and plpbackup(1)! The information there is more up-to-date. - - The programs: - - NCPD - - 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 - - plpftp is a FTP-like program for manipulating files on the Psion. - - SISINSTALL - - Sisinstall, written by Daniel Brahneborg (basic70@gmail.com) installs a - SIS file on the connected psion. It is in very early development, but - it seems to work fine for simple packages. - - PLPBACKUP - - Is a program for backup/restore of your Psion (same functionality - like KPsion, but command-line version, not depending on QT, KDE or X11) - - PLPNFSD - 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). Of course you - must have NFS support enabled in the kernel and the portmapper - must be running for this. 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) - - PLPPRINTD - A daemon for printing via PC from your Psion. - - KDE STUFF - - The KDE 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 - +plptools is a suite of programs for transferring files to and from +EPOC devices, as well as backing them up, installing software, and +setting the clock. See INSTALL for installation instructions and +HISTORY for some history. + +The programs include KDE 2/3 Psion support, and plpnfsd, which allows +the EPOC device's filesystem to be mounted in an NFS-like way (portmap +is required for this). -- cgit v1.2.3