Return to howto.doc CVS log

Up to [PGP] / pgp / doc

Annotation of pgp/doc/howto.doc, revision 1.1.1.1

1.1       root        1:                             PGP How-To
                      2:                                 or
                      3:                How to build PGP 2.6 in two easy steps
                      4: 
                      5:                            Derek Atkins
                      6:                         <[email protected]>
                      7:                             22-May-94
                      8:                         Updated 25-May-94
                      9: 
                     10:        This document describes how to build PGP 2.6 from the sources
                     11: provided.  If you are reading this document, then I assume that you
                     12: have already retrived the sources and unpacked them.
                     13: 
                     14:        The first thing you will notice is that there is more than one
                     15: directory tree in the PGP 2.6 source distribution.  In particular,
                     16: there is the rsaref tree, and then there is the pgp26 tree.  The
                     17: rsaref directory contains the sources for RSAREF, the reference RSA
                     18: implementation from RSADSI, Inc.  The pgp26 directory contains the PGP
                     19: sources.
                     20: 
                     21:        Before you go any further, please read the PGP documentation.
                     22: I cannot stress how important it is for you to read this.  It explains
                     23: not only how to use the software, but also its limitations, drawbacks,
                     24: and other issues of which you should be aware.  The documentation is a
                     25: good source of information and you should use it.
                     26: 
                     27:        Now, on the build instructions:
                     28: 
                     29: VMS:
                     30: 
                     31:        If you are building this on a VMS system, then you should
                     32: change directories into the vmssource subdirectory of pgp26.  In
                     33: there, there is a program called "allbuild.com" which should build all
                     34: of PGP for you.  Just execute that, and it should work.
                     35: 
                     36: UNIX:
                     37: 
                     38:        If you are building on a UNIX platform, you need to build the
                     39: RSAREF code first, and then the PGP sources.  First, you should cd
                     40: into rsaref/install/unix and type "make".  It is possible that this
                     41: will fail, giving you a lot of errors, such as syntax errors or
                     42: parameters declared as non-functions.  If you get these errors, then
                     43: that means that your compiler does not understand prototypes.  There
                     44: are two things you can do to correct this.  The first is to use gcc,
                     45: the GNU CC compiler:
                     46:        make CC=gcc
                     47: 
                     48:        If this is not reasonable, then you can edit the Makefile and
                     49: change the line that contains:
                     50:        -DPROTOTYPES=1      and change it to read:
                     51:        -DPROTOTYPES=0
                     52: 
                     53:        Once you've done this, you should have a file rsaref.a.  The
                     54: next step is to compile the pgp sources.  For this, you should go back
                     55: to the top of the tree and cd into pgp26/src.  From here, you should
                     56: find the make rule for your platform (if you just type "make", it will
                     57: list out the known platforms).  Once you find your platform, just use
                     58: that makerule.  For example, if you are on linux, then you should:
                     59:        make linux
                     60: 
                     61:        If you cannot find a make rule for your platform, you may have
                     62: to create one yourself.  If you successfully create a rule for a new
                     63: platform, please send the patches to [email protected], so it can be
                     64: added to the next release.
                     65: 
                     66: Note: PGP 2.6 requires the function memmove.  Not all machines have
                     67: this in the standard C library.  There is an implementation of memmove
                     68: included with this distribution.  If you find that your platform
                     69: requires memmove, but the makefile rule for your platform does not
                     70: include memmove (look at the sun4gcc or sun386i rules for an example
                     71: of how to include it), please send mail to [email protected], so we can
                     72: correct the problem.
                     73: 
                     74:        If you have any problems, bugs, patches, etc., please send
                     75: mail to [email protected]!
                     76: 
                     77:                                        Thank you,
                     78: 
                     79:                                        Derek Atkins
                     80:                                        <[email protected]>

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.