README.opensolaris.tmpl revision 597bd30ba830d1e11c8efdb9a1b9de28e0599f5e
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfer OS/Net (ON) Buildable Source
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferThis delivery of the Buildable Source consists of 5 pieces:
4e5b757fbcf21077677360be274461dcd9064106kupfer1. encumbered binaries tarball (on-closed-bins-DATE.PLATFORM.tar.bz2)
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfer2. signed cryptographic binaries (on-crypto-DATE.PLATFORM.tar.bz2)
4e5b757fbcf21077677360be274461dcd9064106kupfer3. ON build tools package (SUNWonbld-DATE.PLATFORM.tar.bz2)
4e5b757fbcf21077677360be274461dcd9064106kupfer4. Pre-built BFU archives (on-bfu-DATE.PLATFORM.tar.bz2)
4e5b757fbcf21077677360be274461dcd9064106kupfer5. source tarball (on-src-DATE.tar.bz2; numbered builds only)
4e5b757fbcf21077677360be274461dcd9064106kupferIf you just want to install the pre-built archives, you'll need the ON
4e5b757fbcf21077677360be274461dcd9064106kupferbuild tools and the BFU archives. The tar file will unpack the
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferarchives into archives-DATE/PLATFORM/ (e.g., archives-20050612/i386/).
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferYou should review the Known Issues section (below) before following
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferthe BFU instructions in the Developer's Reference
20440d374537378b3a70ad0e68114ae064baa8f7Mike Kupfer(http://hub.opensolaris.org/bin/view/Community+Group+on/devref_toc).
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferIf you want to build the entire source tree, you will need the source,
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferthe ON build tools, the encumbered binaries, and the cryptographic
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferThe encumbered binaries tarball contains complete binaries (libraries,
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferkernel modules, commands) that are compatible with the source. These
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferare binaries that cannot be built using only the source tarball for
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferone reason or another.
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferThe cryptographic binaries have been signed with a certificate and key
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferthat enables their use. The cryptographic binaries that you build
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferfrom source will not be usable unless you have obtained your own
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfercertificate and key. See elfsign(1) for more information related to
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfersigning binaries.
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferTo obtain source, you can download the on-src-DATE.tar.bz2
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfertarball if you are downloading a build-synchronised delivery. Or, you
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfercan checkout from the Mercurial repository; please see instructions
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferat: http://hub.opensolaris.org/bin/view/Project+onnv/.
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferBuild Environment
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfer-----------------
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferTo build from source, you will also need the proper compiler, and you
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfermust be running a recent build.
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferThe standard compiler for building OpenSolaris code is Sun Studio,
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferwhich is free to download and use. You can also use gcc. See the
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfersection "Installing from Source" (below) for details.
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferBuild machines are expected to be running an OpenSolaris build that is
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferno more than 2 builds behind the source that you're building. For
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferexample, if you're building snv_120, your build machine should be
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferrunning snv_118 or later.
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferOther Important Information
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfer---------------------------
4e5b757fbcf21077677360be274461dcd9064106kupferThe buildable source contains the source for our high key-strength
4e5b757fbcf21077677360be274461dcd9064106kupfercrypto, known as the Encryption Kit (SUNWcry, SUNWcryr, SUNWcryptoint).
c3f177eadfdb30c8441fe9e19b825793f30c7272Peter Dennis - Sustaining EngineerPlease note that certain countries restrict the redistribution of
4e5b757fbcf21077677360be274461dcd9064106kupferhigh key-strength crypto. If you live in one of these countries,
4e5b757fbcf21077677360be274461dcd9064106kupferit is your responsibility to ensure that you are complying with your
4e5b757fbcf21077677360be274461dcd9064106kupfercountry's laws in this area.
4e5b757fbcf21077677360be274461dcd9064106kupferFor general questions on the buildable source, please ask on the
4e5b757fbcf21077677360be274461dcd9064106kupferOpenSolaris Help discussion list (opensolaris-help <at> opensolaris
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupfer<dot> org). For detailed comments about the code, please use the
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferon-discuss list. Please note that the mailing lists are configured to
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferonly allow posts from list subscribers. The Help list also has a web
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferforum that is gatewayed with the mailing list. More information about
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike KupferOpenSolaris lists is available at
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferhttp://hub.opensolaris.org/bin/view/Main/discussions.
4e5b757fbcf21077677360be274461dcd9064106kupferCurrently Known Issues
4e5b757fbcf21077677360be274461dcd9064106kupfer----------------------
4e5b757fbcf21077677360be274461dcd9064106kupfer These were some of the major known issues at the time of this
4e5b757fbcf21077677360be274461dcd9064106kupferdelivery. The most recent list is available on the OpenSolaris.org
597bd30ba830d1e11c8efdb9a1b9de28e0599f5eMike Kupferwebsite in the ON community at:
20440d374537378b3a70ad0e68114ae064baa8f7Mike Kupferhttp://hub.opensolaris.org/bin/view/Community+Group+on/known_issues
20440d374537378b3a70ad0e68114ae064baa8f7Mike Kupfer<!-- #include http://hub.opensolaris.org/bin/view/Community+Group+on/known_issues -->
4e5b757fbcf21077677360be274461dcd9064106kupferInstalling from Source
4e5b757fbcf21077677360be274461dcd9064106kupfer----------------------