README file for PGP International Freeware, Version 5 - AMIGA ------------------------------------------------------------- SYSTEM REQUIREMENTS =================== You will need: 1. An AMIGA with at least an '020 and a FPU... PGP5 runs too slow on anything less - believe me! 2. Version 47.0 of "ixemul.library" and "ixnet.library" located in your "LIBS:" assigned directory. 3. My PGP5 Public Key that was used to sign the MD5 Hash Sums in this archive. I've included it in this archive - Email me if you want to verify it's integrity. I'll send it to you. My Email address is located at the bottom of this document. OVERVIEW ======== Welcome to this freeware release of AMIGA PGP 5, commonly referred to as PGP 5. This archive contains the source code you need to build a version of PGP 5 on the AMIGA platform. The source code contained in this archive is based on the UNIX "final" source code known as "pgp50i-unix-src.tar.gz" which you can (normally) download from the same site you got this archive from. Currently, it is virtually a "straight" port from the UNIX source code - "#ifdef AMIGA" has been put in appropriate places to get the compiled executable to work correctly in the AMIGA environment and a few bits of code have been added. Some parts of the "configure" script and it's associated input files have been altered to better suit the AMIGA environment and also to make them work correctly on the AMIGA. Be warned that this source 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 "src/man/" 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/ 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... IN THE FUTURE ============= 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 help compiling AMIGA PGP5. You come across bugs in the operation of AMIGA PGP5. You have bug fixes for AMIGA PGP5. You have suggestions for improving the operation of AMIGA PGP5. You want to get my public key that is used to signed this archive. 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 page 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/ 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 COMPILE PGP 5 FOR THE AMIGA COMPUTER ------------------------------------------ REQUIREMENTS ============ This document assumes you know how to compile programs using: "sh", "configure", "make", etc. from the GNU suite of compiler programs. You need to have a more or less complete GNU C compiling environment such as the Geek Gadgets - ADE (Amiga Developer Environment). For compiling, you will need: At least 6Mb of free RAM. At least 10Mb of Hard Disk space. An '020+FPU AMIGA computer (bigger IS better;). About 90 minutes free for the first build and compile (Based on A1200, 40mhz '030, FPU) COMPILING ========= The "configure" script and the "config/pre.in", "config/post.in", and "Makefile.in" input files have been modified to work with the AMIGA environment. If you modify them, then you're on your own!!! Be sure to set the CFLAGS environment variable depending on the processor you are compiling for. Set it wrong for your processor and AMIGA PGP5 will execute real slow!!! At the AmigaDOS shell prompt, type: For 68020 - 68040 processors, use: set CFLAGS "-m68020-40 -m68881 -O2" For 68060 processors, use: set CFLAGS "-m68020-40 -O2 -DCPU060" For ALL processors, use: set LDFLAGS "-s" If you don't set the above mentioned LDFLAGS environment variable, then "configure" will create makefiles to generate HUGE executables because debugging symbols will be added to the libraries and executables! Make sure you are in the "src/" directory then type: sh configure --prefix=/ADE m68k-cbm-amigados This will then begin configuring and building the "makefiles". This will take 5-10 mins. the first time, so be patient! When "configure" has completed, at the AmigaDOS shell prompt type: make This will start the compiling process. After an hour or so, you SHOULD end up with NEW executables in the "src/apps/pgp" and the "src/apps/pgpk" directories. Verify that the executables exist and then type: make install The executables will then be copied to your "ADE:bin/" directory. The UNIX "man" docs will be copied to your "ADE:man/man1" and "ADE:man/man5" directories. If "ADE:bin/" is not in your normal default AmigaDOS search path then copy the executables PGPE, PGPS, PGPV and PGPK to your "C:" directory. YOU MUST NOT NAME THESE FILES AS ANYTHING ELSE OR THEY MAY NOT WORK! 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. ---------------------------------------------------------------------- Enjoy AMIGA PGP5... Stefan Zakarias, 21/MAR/1998. Email: ----------------------------------------------------------------------