| | 9 | == Installation == |
| | 10 | |
| | 11 | Preliminary, as provided by Tobias Huerlimann. |
| | 12 | |
| | 13 | GnuPG has been configured to assume that a unixish file hierarchy exists, where it looks for its files. The environment variable UNIXROOT is used to determine in which directory that hierarchy is located. To install GnuPG you just have to extract the binary archive in the directory that UNIXROOT points to. More information about that file hierarchy and the env var UNIXROOT can be found at the UnixOS2 site. |
| | 14 | |
| | 15 | GnuPG also needs the environment varibale HOME, which determines where GnuPG saves its keyrings. And at least one of the two possible PRNG (Pseudo Random Number Generators), rndos2.dll or RexxEGD, has to be installed. |
| | 16 | |
| | 17 | The following environment variables are used by GnuPG: |
| | 18 | |
| | 19 | * HOME |
| | 20 | HOME points to the user's home directory. GnuPG stores the personal options and keys in the subdirectory ".gnupg". If you do not have a home dir, you may choose C: for example: |
| | 21 | |
| | 22 | SET HOME=C: |
| | 23 | |
| | 24 | * UNIXROOT |
| | 25 | The env var UNIXROOT should point to the directory, in which a unixish filesystem hierarchy exists. Example: set UNIXROOT to G: and gpg.exe will be located in G:\usr\bin |
| | 26 | |
| | 27 | SET UNIXROOT=G: |
| | 28 | |
| | 29 | * LANG |
| | 30 | LANG should already exist at most OS/2 installations because it is also used be OS/2 itself. |
| | 31 | |
| | 32 | It is used to determine the language GnuPG will use. Example: if you want GnuPG to 'speak' italian, you set: |
| | 33 | |
| | 34 | SET LANG=it |
| | 35 | |
| | 36 | Here's a summary of the directories that are used by GnuPG: |
| | 37 | |
| | 38 | * %HOME%/.gnupg/ |
| | 39 | If this directory does not exist, it will be created the first time GnuPG starts. Then GnuPG tries to create the personal configuration file "gpg.conf" by copying %UNIXROOT%/usr/share/gnupg/options.skel. %HOME%/.gnupg/ is also used to story the created and imported keys. |
| | 40 | * %UNIXROOT%/usr/lib/gnupg/ |
| | 41 | In this directory GnuPG looks for the random number generator "rndos2.dll" and plug-ins (i.e.: the IDEA plug-in). |
| | 42 | * %UNIXROOT%/usr/share/gnupg/ |
| | 43 | In this directory GnuPG looks for the file "options.skel", which is used as a template for %HOME%/.gnupg/gpg.conf. |
| | 44 | * %UNIXROOT%/usr/share/locale/ |
| | 45 | GnuPG expects the locale files (for NLS) in that directory. The files are in der LC_MESSGAES/<language> subdirectory. <language> is determined by the LANG env var. |
| | 46 | |
| | 47 | In case you really do not like the idea of UNIXROOT and you rather like the OS/2 way: Create a directory for GnuPG, for example C:\Progs\GnuPG and copy the following files in that directory: |
| | 48 | |
| | 49 | * usr/bin/gpg.exe |
| | 50 | * usr/bin/gpgv.exe |
| | 51 | * usr/bin/gpgsplit.exe |
| | 52 | * usr/lib/gnupg/rndos2.dll |
| | 53 | * usr/share/book/gpg.inf |
| | 54 | * usr/share/gnupg/FAQ |
| | 55 | * Optional: plug-in DLLs |
| | 56 | |
| | 57 | Not using a unixish file hierarchy imposes some minor limitations. For example, NLS requires such a hierarchy. In any case you should set the HOME variable. |
| | 58 | |
| 11 | | For now [[br]] |
| | 61 | Preliminary, as provided by Tobias Huerlimann. |
| | 62 | |
| | 63 | Compiling GnuPG shouldn't be a problem anymore because of the OS/2 specific handwritten makefiles (Makefile.os2). |
| | 64 | Software requirements |
| | 65 | |
| | 66 | To compile GnuPG for OS/2 you need the following software: |
| | 67 | |
| | 68 | * Innotek GCC. |
| | 69 | * EMX GCC should also work (older releases were compiled with it), but you will have to adapt some things. |
| | 70 | * GNU Make |
| | 71 | The makefiles are not in nmake syntax |
| | 72 | * A unixish shell, for example: Bash |
| | 73 | * A LibINTL library that knows UNIXROOT (e.g. I used the gettext package from Innotek) |
| | 74 | * libbzip2, for example from Hobbes |
| | 75 | |
| | 76 | Additional software is needed to create the man pages in INF format or the NLS files. |
| | 77 | |
| | 78 | * IPFC from the OS/2 Developer's Toolkit |
| | 79 | For the creation of the INF file |
| | 80 | * msgfmt.exe from the GNU gettext package |
| | 81 | For the creation of the NLS packages |
| | 82 | |
| | 83 | If you also want to install GnuPG via the makefiles, the following tools should be in PATH: |
| | 84 | |
| | 85 | * cp |
| | 86 | * cmp |
| | 87 | * mkdir |
| | 88 | * test |
| | 89 | |
| | 90 | Build process |
| | 91 | |
| | 92 | 1. Makefile.os2 assumes that the shell is called sh.exe. If that is not the case, please change Makefile.os2.config accordingly. |
| | 93 | 2. If you want to change the install destination (default: %UNIXROOT%/usr), please edit: |
| | 94 | * Makefile.os2.config |
| | 95 | * os2/os2init.c |
| | 96 | 3. If you do not have IPFC or msgfmt.exe and therefore cannot create the INF documentation or the NLS packages, delete the directories "doc" and "po" from the variable "SUBDIRS" in Makefile.os2. |
| | 97 | 4. Now "make -f Makefile.os2" should be enough to compile GnuPG. |
| | 98 | 5. Optional: "make -f Makefile.os2 check" runs a small testsuite. You have to install rndos2.dll or RexxEGD before that. |
| | 99 | 6. Optional: "make -f Makefile.os2 install-files" installs GnuPG in the %UNIXROOT% hierarchy. |
| 16 | | * version 1.4.6 with Tobias Huerlimanns OS/2 patches and docs added at 27.12.2011[[br]] |
| | 104 | * 28.12.2011 version 1.4.8 testbuild |
| | 105 | * 28.12.2011 version 1.4.7 added to netlabs |
| | 106 | * 27.12.2011 version 1.4.6 with Tobias Huerlimanns OS/2 patches and docs added to netlabs svn |
| | 107 | * 11.03.2007: GnuPG 1.4.7 now available for OS/2 |
| | 108 | * 20.12.2006: Uploaded a new version of GnuPG 1.4.6 for OS/2 that includes a patch from Peter Weilbacher that makes it possible to install GnuPG into one single directory. |
| | 109 | * 12.12.2006: GnuPG 1.4.6 now available for OS/2 – upgrading is strongly recommended (1.4.6 contains an important security fix)! |
| | 110 | * 11.09.2006: GnuPG 1.4.5 now available for OS/2 |
| | 111 | * 19.04.2006: GnuPG 1.4.3 now available for OS/2 |
| | 112 | * 14.04.2005: GnuPG 1.4.2 now available for OS/2 |
| | 113 | * 22.01.2005: The current issue of OS/2 e-Zine features a guide for setting up GnuPG and EnigMail, written by John Bijnens. |
| | 114 | * 02.01.2005: GnuPG 1.4.0 now available for OS/2 |
| | 115 | * 22.10.2004: Finally: Enigmail has been successfully ported! Have a look at this site. Note that the port still has some small glitches, so maybe wait until the patches have gone into the official Mozilla/Thunderbird tree. Anyway, a huge "Thank you!" goes to Davide Bresolin for the port! |
| | 116 | * 27.07.2004: GnuPG 1.2.5 now available for OS/2: please note that this release needs the Innotek GCC Runtime instead of EMX! |
| | 117 | * 26.12.2003: GnuPG 1.2.4 now available for OS/2. Also new: rndos2 0.91 |
| | 118 | * 27.11.2003: There is a flaw in GnuPG that can compromise private keys when ElGamal keys are used for signing! Please note that ElGamal signing keys can only be created in GnuPG by using hidden options and ignoring a warning message. They can not be created in a standard way, so the probability that you are affected is really small. However, better take a look at the details yourself! |
| | 119 | * 17.09.2003: GnuPG 1.2.3 now available for OS/2 |
| | 120 | * 09.08.2003: A GnuPG WarpIN Package is now available! |
