Return to readme.vms CVS log

Up to [PGP] / pgp / doc

Annotation of pgp/doc/readme.vms, revision 1.1.1.4

1.1.1.4 ! root        1: PGP/VMS Version 2.6
        !             2: -------------------
        !             3: 
        !             4: THIS MAY OR MAY NOT WORK.
        !             5: 
        !             6: The pgp26/vmsbuild contains support files for building a VMS
        !             7: version of PGP 2.6. We at MIT have not tested this code out,
        !             8: but it should work without too much effort. See the file:
        !             9: pgp26/vmsbuild/000read.me.
        !            10: 
        !            11: In particular, PGP 2.6 needs to be linked with the RSAREF library. David
        !            12: North has provided a build file "pgp26/vmsbuild/rsabuild.com" that should
        !            13: help in building RSAREF.
        !            14: 
        !            15: If you can figure out how to compile it, it SHOULD work.  One change is
        !            16: that PGP can now look for support files in a system-wide directory.
        !            17: The default (PGP_SYSTEM_DIR, defined in fileio.h) is PGP$LIBRARY:, but
        !            18: you can change that if you like.
        !            19: 
        !            20: --- PGP 2.3 instructions follow ---
        !            21: 
        !            22: All rights to PGP are reserved by Phil Zimmermann. All contributed
        !            23: modules are also subject to the copyrights of their individual authors,
        !            24: on the same conditions. Certain algorithms used by PGP are subject to
        !            25: patent restrictions and this software as a whole may be subject to
        !            26: export control in certain countries. Read the PGP Guide for full
        !            27: copyright information and for details about export control.
        !            28: 
        !            29: These notes are intended for those people using and working with PGP under
        !            30: the VAX/VMS operating system. These are intended to supplement rather than
        !            31: replace the PGP guide. You should read and understand the guide, particularly
        !            32: the section about key management.
        !            33: 
        !            34: If you unzip under VMS using the public domain Zipper - you will probably have
        !            35: a problem with file characteristics. If you have the PD FILE utility, you can
        !            36: fix this by saying:
        !            37: 
        !            38: $ FILE/type=stream  *.*
        !            39: 
        !            40: Otherwise you can fix using either TPU or CONVERT/FDL.
        !            41: 
        !            42: PGP/VMS was written using the VAX C compiler, which you must have to
        !            43: compile it. If you wish to use another compiler, see the developers notes.
        !            44: PGP is provided with an MMS description file. To build using this file, go
        !            45: to the directory containing the uncompressed files and type the following:
        !            46: 
        !            47: $ MMS PGP.EXE
        !            48: 
        !            49: You may wish to delete the object files at this point, they are not needed
        !            50: unless you are working on the code. To build a version under the VAX/VMS
        !            51: debugger, define the DCL symbol PGP_DEBUG=1. The debugger version will be
        !            52: built without any optimisation and will be *significantly* slower.
        !            53: 
        !            54: If you do not have MMS you may execute the DCL supplied command procedure
        !            55: VMSBUILD.COM to compile and link PGP.
        !            56: 
        !            57: Once you have built PGP, it should be placed somewhere that is protected
        !            58: against tampering. It is not impossible that someone may replace PGP.EXE
        !            59: with a patched version designed to capture keys. You may wish to use the
        !            60: CHECKSUM utility (CHECKSUM/IMAGE PGP.EXE) to control against modifications,
        !            61: however CHECKSUM does not use very effective algorithms and may itself be
        !            62: compromised.
        !            63: 
        !            64: You should then use PGP by defining it as an "external command" in your
        !            65: LOGIN.COM, or alternative the system wide login command procedure, SYLOGIN.
        !            66: This is done simply with the following line of DCL:
        !            67: 
        !            68: $ PGP:==$device:[directory]PGP
        !            69: 
        !            70: After executing this line (remember the dollar sign before the device name),
        !            71: you should be able to display a help text by typing:
        !            72: 
        !            73: $ PGP
        !            74: 
        !            75: PGP will want to retain the keyrings and some other information. These are
        !            76: stored in the device and directory pointed to by the logical name PGPPATH.
        !            77: You should copy the files LANGUAGE.TXT and CONFIG.TXT to this directory.
        !            78: 
        !            79: Your secret keyring contains information that could be cryptographically
        !            80: analysed - it must be protected against world access. However, your secret key
        !            81: ring is encrypted so is protected against casual browsing. If anyone that you
        !            82: can not trust has privileged access to your system, your plaintext files are
        !            83: vulnerable and potentially, also your keyrings.
        !            84: 
        !            85: Note that keyrings should be directly transportable between VMS, MSDOS
        !            86: and other PGP implementations. Text files may not be portable because of the
        !            87: different text record representations across operating systems. If you wish
        !            88: to send a text file to a system other than VAX/VMS, you are recommended to
        !            89: use the 'canonical-form' switch '-t'.
        !            90: 
        !            91: If you wish to take binary files such as backup savesets between two systems
        !            92: running VMS, you can use the special flag 'i' with the encrypt function to
        !            93: preserve the file and record characteristics. When decrypting, PGP will read
        !            94: the 'i' flag and the type of the system that created the file. If both systems
        !            95: are VMS, the file will be correctly decrypted with the correct file
        !            96: characteristics.
        !            97: 
        !            98: Special Notes For V2.2 And Following
        !            99: ------------------------------------
        !           100: 
        !           101: This version improves the keyboard handling. Specifically, it addresses
        !           102: the CPU bound loop whilst reading terminal input and provides better prompt
        !           103: and keyboard handling.
        !           104: 
        !           105: Developers Notes
        !           106: ----------------
        !           107: 
        !           108: There are two key conditionals throughout the source for the VAX/VMS
        !           109: implementation:
        !           110: 
        !           111: VAXC -  Allows specific optimisations permitted by the VAX C compiler and
        !           112:         overcomes problems with the differences between VAX C and ANSI C.
        !           113: 
        !           114: VMS  -  This allows VMS specific file handling and some optimisations. It
        !           115:         should be noted that the primitives do not work with RISC/VMS until
        !           116:         someone has done some work on porting VAX.MAR.
        !           117: 
        !           118: There was also some preliminary work done on porting this to GNU C and indeed
        !           119: an earlier (developers) version ran under GNU C. The code affected is usually
        !           120: conditionalised with GCC. If someone wishes to complete this and (hopefully)
        !           121: integrate the inline assembler stuff used for moves and zero-fills, this
        !           122: would be very useful.
        !           123: 
        !           124: The MMS command procedure and VMSBUILD.COM build from sources in a directory
        !           125: pointed to by the logical SRC and objects pointed to by OBJ. This makes life
        !           126: a little easier as you can use a search list for the sources so you can keep
        !           127: the distribution intect.
        !           128: 
        !           129: All optimizations were checked out using DEC's PCA, and this version appears
        !           130: to be optimal under VAX C.
        !           131: 
        !           132: As for cleaning up, there are verious areas which could be improved:
        !           133: 
        !           134: 1)      PGP's own erase on delete could be replaced by the standard VMS
        !           135:         function so the file system does the work.
        !           136: 
        !           137: Contributing Authors
        !           138: --------------------
        !           139: 
        !           140: This port was originally performed by Hugh Kennedy with assistance from
        !           141: Mark Barsoum and others.
        !           142: 
        !           143: Support
        !           144: -------
        !           145: 
        !           146: This software is provided in the public domain and without charge other than
        !           147: for copying. For support issues concerning PGP and VAX/VMS, you are welcome
        !           148: to contact me via Electronic Mail on Compuserve using ID 70042,710 and on the
        !           149: Internet with [email protected]. This software is provided "as-is" and
        !           150: any support given will be of an informal nature.
        !           151: 
        !           152: Hugh A.J. Kennedy, 11th February 1992
        !           153: Minor editing for 2.3 release, Colin Plumb, 14 June 1993

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