Return to howto.doc CVS log

Up to [PGP] / pgp / doc

Annotation of pgp/doc/howto.doc, revision 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.