--------------------------------------------------------- FlFinger - Finger client for EPOC (C) 1999, 2000 David Rushall All rights reserved --------------------------------------------------------- INTRODUCTION FlFinger is a simple client for the TCP/IP 'finger' protocol (RFC1288). Using FlFinger you can collect information about the user of an email address, if the user's server provides the service. Some servers may provide other information via 'finger', such as the service status information provided for Demon Internet subscribers. Features include: o Simple interface. o Address history. o Copy-and-paste responses into other applications. --------------------------------------------------------- INSTALLATION NOTE: You must have installed and configured Internet (TCP/IP) access (e.g. the Message Suite) before installing this software. On more modern machines (e.g. Series 5mx and Revo) this is installed as standard. Consult you machine's manual for more information. To install this software on your machine: 1) Close ALL applications on your EPOC device. If you do not close all applications before installing the two OPX *.sis packages in the next step, you may have problems with OPX versions later. 2) Install the two OPX SIS files, first: CDescriptor.sis CSocket.sis If you get a message saying that a later version than the one supplied has already been installed on your machine then DO NOT allow the older version to overwrite the newer. 3) Install the main application SIS file: FlFinger.sis If you get a message that one of the two OPX SIS files has not been installed at the correct level then return to the previous step. 4) Finally, look in the "Extras" draw on the machine for the new "FlFinger" icon, in the normal manner. NOTES: * Please consult the manuals for your device for details of installing applications packaged in SIS files. You will require either a PC/Mac running your EPOC connect software (i.e. PsiWin 2 or equivalent) or the "Add/Remove" icon on the control panel of your EPOC device. Double-clicking on the SIS file either on the EPOC device or on the PC/Mac connected to the EPOC device should do the trick. * The supplied OPXs are for ARM-based machines, such as the Series 5, Revo, Osaris, Geofox 1, Series 5mx, Series 7, etc. If you wish to run this application on the Windows EPOC emulator then please contact the OPX author, Keith Walker (web address below), for the appropriate versions. * OPXs are special resources that may be shared by many different applications on the EPOC device. If these applications do not deliver the OPXs correctly in the standard SIS files, they may cause problems with other applications when they are installed, or even uninstalled. If you find that this application fails to start after installing or uninstalling another application, perhaps reporting a missing or invalid OPX file, please try reinstalling this application using the instructions above. This should correct the problem. --------------------------------------------------------- UNINSTALLING If you have finished with this software you can remove the application as follows: 1) Make sure the FlFinger application is not running. 2) Using the "Add/Remove" icon on the EPOC control panel, remove the "FlFinger" application. After you have completed these steps, FlFinger will have been removed from your machine's memory and "Extras" bar. NOTE: I DO NOT recommend removing the small OPX files, installed by the additional supplied SIS packages, as they may also be in use by other applications. --------------------------------------------------------- BASIC USE If you are familiar with using other EPOC TCP/IP applications (e.g. the Message Suite) and have used finger clients before, you should find FlFinger easy to use. Simply run FlFinger, select 'Open connection...' from the main menu, enter a valid email address (or select one from the history of recently used addresses) and FlFinger will do the rest for you. Anything you can't work out should be documented in the online Help available from the application menu. Inexperienced users are advised to browse through this file when they first run FlFinger. --------------------------------------------------------- SERVING FINGER REQUESTS FlFinger is a finger client only, so it cannot respond to finger requests (perhaps from another machine). However, you can use the supplied 'flfingerd.opo' sample program to serve finger requests from your EPOC machine, and so try FlFinger even when you are disconnected from the Internet. Simply run the 'flfingerd.opo' program and then use FlFinger to send a request to 'someone@localhost', or 'someone@127.0.0.1', where 'someone' is any valid user name. If you wish, you can customise this OPL sample to serve your own message, and even use it to serve requests from other machines when you are connected to the Internet. See the 'flfingerd.opl' source file for details. --------------------------------------------------------- CHANGES Version 1.3 * Pioneering 'ping' probe. * Fabulously faster 'finger' fetching. * Long format finger requests. * Improved display on Osaris and colour machines. * Colour application item. Version 1.2 * Improved Revo support; * "Disconnect from Internet" menu item; * Automatic response dialog preference setting; * More attractive interface; * Installable on drive E: * Sample finger server included; * Minor enhancements. --------------------------------------------------------- DISCLAIMER AND COPYRIGHT 1) FlFinger is freeware and copyright; it is not public domain. The rights to this package remain the property of the author. 2) You may use this software, free of charge, for an indefinite period and at no obligation to the author. 3) Permission is given to publically distribute this software provided the distribution contains all, and only, the unaltered files of the original distribution, the ownership of the rights to this software is clearly stated and any fee charged is extremely nominal. 4) Use of this software is entirely at the user's own risk. The user must accept responsibility for any direct or indirect loss or damage arising from the use (or misuse) of the package. This software is supplied "as-is". 5) Note: The OPX files employed by this software (and included in this distribution) are the copyright of Keith Walker. Please see his WWW site, http://www.starship.freeserve.co.uk/ for more details. --------------------------------------------------------- CONTACTS If you have any problems, comments or suggestions about this software, you can contact me at the following email addresses: dave@freepoc.de dave@piecafe.demon.co.uk This application is distributed in association with FreEPOC: http://www.freepoc.de/ For the latest news of this an my other software, also visit: http://www.piecafe.demon.co.uk/ --------------------------------------------------------- Dave Rushall, 2000