Annotation of truecrypt/readme.txt, revision 1.1.1.13

1.1.1.13! root        1: This archive contains the complete source code of TrueCrypt 4.3a for all
1.1.1.12  root        2: supported operating systems and all supported hardware platforms.
1.1       root        3: 
                      4: 
1.1.1.8   root        5: Important
                      6: =========
1.1       root        7: 
1.1.1.8   root        8: You may use the source code contained in this archive only if you agree to the
                      9: license contained in the file 'License.txt', which is included in this archive.
                     10: Note that the license specifies conditions under which you may modify TrueCrypt
                     11: (for example, that a derived work must not be called "TrueCrypt").
1.1       root       12: 
                     13: 
                     14: 
1.1.1.8   root       15: Contents
                     16: ========
1.1       root       17: 
1.1.1.8   root       18: I. Windows
                     19:        Requirements for Building TrueCrypt for Windows
                     20:        Instructions for Building TrueCrypt for Windows
                     21: 
                     22: II. Linux
                     23:        Requirements for Building TrueCrypt for Linux
                     24:        Instructions for Building TrueCrypt for Linux
                     25:        Installing TrueCrypt
                     26:        Requirements for Running Truecrypt on Linux
                     27: 
1.1.1.13! root       28: III. Third-Party Developers (Contributors)
1.1.1.8   root       29: 
1.1.1.13! root       30: IV. Further Information
1.1.1.8   root       31: 
                     32: 
                     33: 
                     34: I. Windows
                     35: ==========
                     36: 
                     37: Requirements for Building TrueCrypt for Windows:
                     38: ------------------------------------------------
                     39: 
1.1.1.13! root       40: - Microsoft Visual Studio 2005 SP1
        !            41: - Windows 2003 SP1 Driver Development Kit (build 3790.1830)
        !            42: - Microsoft Windows SDK 6.0 (integrated with Visual Studio)
        !            43: 
        !            44: IMPORTANT:
        !            45: 
        !            46: The 64-bit editions of Windows Vista and in some cases (e.g. playback of HD DVD
        !            47: content) also the 32-bit editions of Windows Vista do not allow the TrueCrypt
        !            48: driver to run without an appropriate digital signature. Therefore, all .sys
        !            49: files in official TrueCrypt binary packages are digitally signed with the
        !            50: digital certificate of the TrueCrypt Foundation, which was issued by a
        !            51: certification authority. At the end of each official .exe and .sys file,
        !            52: there are embedded digital signatures and all related certificates (i.e. all
        !            53: certificates in the relevant certification chain, such as the certification
        !            54: authority certificates, CA-MS cross-certificate, and the TrueCrypt Foundation
        !            55: certificate). Keep this in mind if you compile TrueCrypt and compare your
        !            56: binaries with the official binaries. If your binaries are unsigned, the sizes
        !            57: of the official binaries will usually be approximately 10 KB greater than sizes
        !            58: of your binaries (if you use a different version of compiler or if you install
        !            59: a different or no service pack for Visual Studio, there may be further
        !            60: differences).
1.1.1.12  root       61: 
1.1.1.8   root       62: 
                     63: Instructions for Building TrueCrypt for Windows:
                     64: ------------------------------------------------
                     65: 
1.1.1.12  root       66: 1) Set the 'WINDDK_3790_1830' environment variable to point to the Windows DDK
                     67:    root directory. Alternatively, edit the 'DDK' variable in the file
                     68:    'Driver\Makefile'.
                     69: 2) Open the 'TrueCrypt.sln' solution in Microsoft Visual Studio.
                     70: 3) Make sure 'All' is the active solution configuration.
                     71: 4) Build the solution.
1.1.1.13! root       72: 5) If successful, there should be newly built TrueCrypt binaries in the
1.1.1.12  root       73:    'Release' folder.
1.1.1.8   root       74: 
                     75: 
                     76: 
                     77: II. Linux
                     78: =========
                     79: 
                     80: Requirements for Building TrueCrypt for Linux:
                     81: ----------------------------------------------
                     82: 
                     83: - Standard development tools: make, gcc, ld, strip
                     84: 
1.1.1.13! root       85: - Source code of the Linux kernel, version 2.6.5 or compatible. The version of
        !            86:   the kernel source code and its configuration must match the one under which
        !            87:   you will be running TrueCrypt. Linux kernel sources are available at:
        !            88:   http://kernel.org/pub/linux/kernel/
        !            89: 
        !            90:   Note that Linux kernel headers, located in the 'include' directory, are
        !            91:   not sufficient for compilation of the TrueCrypt kernel module. Fields of
        !            92:   'dm_dev' structure must be accessed by TrueCrypt but they are defined only in
        !            93:   an internal kernel header 'drivers/md/dm.h'. No appropriate accessor function
        !            94:   is available. The complete source code of the Linux kernel is required for
        !            95:   compilation of the kernel module.
        !            96: 
        !            97:   Also note that the Linux kernel lacks a stable external programming interface
        !            98:   and, therefore, new kernel releases may break compatibility with external
        !            99:   kernel modules. The TrueCrypt kernel module may fail to build, depending on
        !           100:   the changes made to the Linux kernel by the kernel developers.
1.1.1.8   root      101: 
                    102: 
                    103: Instructions for Building TrueCrypt for Linux:
                    104: ----------------------------------------------
                    105: 
                    106: To build TrueCrypt execute the following commands:
                    107: 
                    108: cd Linux
                    109: ./build.sh
                    110: 
                    111: The build script will first verify requirements for building TrueCrypt.
                    112: You may be prompted for additional information, which cannot be determined
                    113: automatically. Then the building process will start.
                    114: 
                    115: 
                    116: Installing TrueCrypt:
                    117: ---------------------
                    118: 
                    119: To build and install TrueCrypt, execute the following commands:
                    120: 
                    121: cd Linux
                    122: ./install.sh
                    123: 
                    124: The installation script will first verify requirements for running TrueCrypt.
1.1.1.12  root      125: If successful, you will be prompted for installation options and the
                    126: installation will proceed.
1.1.1.8   root      127: 
                    128: 
                    129: Requirements for Running Truecrypt on Linux
                    130: -------------------------------------------
                    131: 
1.1.1.12  root      132: - Linux kernel version 2.6.5 or compatible
1.1.1.13! root      133: 
1.1.1.8   root      134: - Device mapper (dmsetup, http://sources.redhat.com/dm) and loop device
                    135:   (losetup) infrastructure, which are available in all major Linux
1.1.1.12  root      136:   distributions
1.1.1.8   root      137: 
                    138: 
                    139: 
1.1.1.13! root      140: III. Third-Party Developers (Contributors)
        !           141: ==========================================
1.1.1.8   root      142: 
                    143: If you intend to implement a feature, please contact us first to make sure:
                    144: 
                    145: 1) That the feature has not been implemented (we may have already implemented
                    146:    it, but haven't released the code yet).
                    147: 2) That the feature is acceptable.
                    148: 3) Whether we need help of third-party developers with implementing the feature.
1.1.1.13! root      149: 
        !           150: Information on how to contact us can be found at:
1.1.1.8   root      151: http://www.truecrypt.org/contact.php
                    152: 
                    153: 
                    154: 
1.1.1.13! root      155: IV. Further Information
        !           156: =======================
1.1.1.8   root      157: 
1.1.1.13! root      158: http://www.truecrypt.org

unix.superglobalmegacorp.com

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