README file for PGP International Freeware, Version 5 - AMIGA '060 ------------------------------------------------------------------ SYSTEM REQUIREMENTS =================== You will need: 1. An AMIGA with an '060 2. A text editor such as "Ed" or "CEd" 3. A healthy amount of Fast RAM (4mb should be O.K) 4. About 2mb of Hard Disk space for the executables, keys and PGP configuration file. OVERVIEW ======== Welcome to this freeware release of AMIGA PGP 5, commonly referred to as PGP 5. This archive contains everything you need to use PGP 5 on the AMIGA platform. The executable code contained in this archive was compiled from the AMIGA source code, known as "pgp51i-amiga-src.lha", which you can (normally) download from the same site you got this archive from. Currently, it is virtually a "straight" port from the UNIX "final" source code, known as "pgp50i-unix-src.tar.gz". Be warned that the AMIGA code has NOT been thoroughly investigated to make this a true AMIGA specific port. It has only been modified enough to make it usable and stable on an AMIGA. Not all functions have been tested. The "keyserver" functions have not been tested. Given the problems "ixemul.library" currently has working with TCP/IP stuff, I doubt it would work reliably - if at all! This was not a major concern during THIS port, but it WILL be in the future! Also, the "batchmode" functions have yet to be tested. It is assumed you have used previous versions of PGP (2.6, etc.) and are familiar with it's usage and the concepts of Public Key Encryption in general. Note that the operation, usage, and command line format has changed from previous versions of PGP - so you must read, at least, the documentation contained in this archive. DOCUMENTATION ============= The documentation, normally available as UNIX "man" pages, is located in the "docs/" directory. I've converted these "man" documents to ANSI for those of you that can't display "man" pages easily. Multiview or AMIGAGuide should be able display the ANSI documentation easily. Hmmm... What can I say? There isn't much documentation available about PGP5 Freeware! What you get with the AMIGA archive is pretty much what you get with the UNIX archive. A more detailed discussion on PGP 5 usage, including a copy of the PGP User's Manual and answers to FAQs, may be available from Ståle Schumacher's "International PGP Home Page": http://www.pgpi.com/ As the AMIGA community comes up to speed with PGP 5, I'll assume that more AMIGA specific documentation will become available. YOUR help would be greatly appreciated! I have subscriptions with the "PGP-USERS" and the "PGPAMIGA" mailing lists, so placing questions at either of these mailing lists will probably get a response from me if it's AMIGA related. I have also created a AMIGA PGP5 web site so that you can download the latest versions of AMIGA PGP5 sources and executables. Hopefully, it will also contain Help'n'Tips on using AMIGA PGP5 as well as more documentation... My web site address is: http://www.amitar.com.au/~stef/ PGP-USERS MAILING LIST ====================== The PGP-USERS mailing list server, run by Fred B. Ringel, can be subscribed to via this WWW page: http://pgp.rivertown.net/ Be warned that this list's messages are biased towards machines other than AMIGA. This is a good source for information on the intricasies of PGP5 because the AMIGA's source-code is based on the UNIX source. Questions/answers to UNIX problems are usually also relevant to the AMIGA! This mailing list is for PGP users ONLY! Do not abuse this list!!! If the mail is not related to PGP then it's (usually) not going to get put on this list. You'll get the rules and regulations for using this mailing list when you subscribe. I suggest you read these rules and regulations very, very carefully or you can expect to be barred from this mailing list! Fred keeps a tight, well moderated reign on this mailing list. A warm thanks must go to Fred B. Ringel for his tireless dedication toward maintaining this mailing list. You can usually expect, on average, between 10 - 30 informative Emails a day about PGP from this list because of his effort... IMPORTANT NOTE!!! ================= For those people who may be concerned about the legalities of this software, Ståle Schumacher has given me the permission to port and distribute the FREEWARE versions of AMIGA PGP5. Any questions regarding this matter, should be directed to either Ståle Schumacher or myself if you want more information. Note that Ståle is quite busy coordinating the INTERNATIONAL FREEWARE DISTRIBUTION FOR ALL PLATFORMS, so do not expect a quick reply... Remember that he gets hundreds of Emails a week and also has a life away from his computer too! Please, PLEASE, do NOT distribute modified AMIGA PGP5 versions of the source code or executables. I, and many other PGP users, do NOT wish to denigrate the integrity PGP has gained and maintained over the years. Not only that, but confusion between different versions will probably become a problem! I am prepared to be the source code maintainer for AMIGA PGP5. As source code changes to the UNIX version become available, I will incorporate them into the AMIGA source code. If you really need and/or require something to be put into the source code or executable then please submit your request, and any desired source code changes to me: Stefan Zakarias . If it is appropriate, and/or necessary, to the operation and integrity of AMIGA PGP5 then I will incorporate the changes into the following release of AMIGA PGP5. HOW TO INSTALL PGP 5 FOR THE AMIGA COMPUTER ------------------------------------------- REQUIREMENTS ============ This document assumes you know how to install programs using: "copy", "rename", "ed", "setenv", "assign", etc. Of course, a file manager like DOpus5 and a text editor like CEd makes installing and modifying things much easier. In the future I will make an installation script using the standard "installer" program usually supplied with AMIGA computers - probably version 43.3 will be required. INSTALLING ========== Note that PGP5 can co-exist with a previous installation of PGP 2.6.3. In fact I recommend it! 1. Make sure you have "ixemul.library" and "ixnet.library" version 47.2 located in your system default "LIBS:" directory. 2. Make 2 copies of "PGPE" - One named "PGPV", the other one named "PGPS". 3. Copy "PGPE", "PGPV", "PGPS" and "PGPK" to your C: directory. DO NOT CHANGE THE NAME OF THESE FILES OR THEY MAY NOT WORK!!! 4. If you don't have an assignment to "PGP:"... a) Make a directory named "PGP" somewhere on your hard-drive. b) Remember the complete path to this directory. c) Open up your favourite text editor and load in your "S:User-StartUp" file. d) Somewhere in the "User-StartUp" file, put the following line, where "xxx" is the path to the PGP directory you created in step 4a. C:Assign PGP: xxx:PGP e) Reboot your computer and continue from here... 5. Copy "pgp.cfg" to your assigned "PGP:" directory. 6. Copy "language50.txt" to your assigned "PGP:" directory. If you do not put "language50.txt" in the PGP: directory, then the default is to use the built-in language which is English. 7. Make a new drawer named "Keys50" in your assigned "PGP:" directory. 8. An environment variable has to be set for PGP5. It's called "PGPPATH" and must be set to the directory you have installed the PGP5 "pgp.cfg" file. You'll have open up a Shell window and type: SetEnv PGPPATH PGP: Copy ENV:PGPPATH ENVARC: This assumes that "pgp.cfg" is installed and exists in the "PGP:" assigned directory. 9a. If you have never used PGP before and do NOT have a Secret or Public keyrings from a previous version of PGP (EG: PGP 2.6.3), then you'll have to read the docs about "PGPK -g" and create a new pair of keys for yourself! 9b. If you DO have keyrings from a previous version of PGP (E.G: PGP 2.6.3), then make copies of them, naming the new copies as follows: "pubring.pgp" is now "pubring.pkr" "secring.pgp" is now "secring.skr" Copy the new keyrings, "pubring.pkr" amd "secring.skr", to the "Keys50" directory you created in step 7. 10. When you have the keyrings in the "Keys50" drawer, you should read the documentation named "pgp.cfg.ansi" for details on how to modify the "pgp.cfg" file to suit your purposes. If you've used a previous version of PGP, then you'll notice that the "pgp.cfg" file is almost the same as the old "config.txt" configuration file with just a few extra "enhancements" for the new PGP5 operations. 11. I hope this is enough to get you going... The "xxx.n.ansi" documents should help you do the rest. Just remember that the filenames and paths mentioned in the docs are UNIX orientated. Appropriate conversions to AMIGADOS path specs will have to be made! Look in "pgp.cfg" for examples. NOTES ===== * Resist the urge to make PGPS and PGPV a hard or soft link to PGPE!!! Only COPY PGPE as PGPS and PGPV! It'll take up some extra space on your hard drive but it is the safest way to do a "link". The reason is that making links to files on the AMIGA is still NOT very stable. If you are using AmiFileSafe it is disasterous - you'll more than likely corrupt the partition the link is on if you try to remove the link! It WILL force you to reformat that partition to recover. IN THE FUTURE ============= An installer script to make it easy to install the executables of AMIGA PGP5. I've started creating GUI's for PGP5. I have one ready for PGPK already... It's being beta-tested (still ;-). I've also adapted "YAPY1.3" to work with "YAM1.35/YAM2.0" and PGP5. When YAM2.0's ARexx and DOS interface is functioning, then I'll get the ball rolling and send my adaptations to the original author of YAPY1.3. THE PORTER ========== That's me - Stefan Zakarias . Feel free to Email me, regarding AMIGA PGP5, if: You need installation help. You come across bugs in the operation of AMIGA PGP5. You have suggestions for improving the operation of AMIGA PGP5. You wish to become a beta-tester for AMIGA PGP5... Specifically, I need '040 and '060 beta-testers, but '030 and '020 testers are welcome. OR Have a look at my AMIGA PGP5 web site so that you can download the latest versions of AMIGA PGP5 sources and executables. The web page address is: http://www.amitar.com.au/~stef/ ---------------------------------------------------------------------- Enjoy AMIGA PGP5... Stefan Zakarias 22/MAR/1998 ----------------------------------------------------------------------