README.opensolaris.tmpl revision 7a98501b9c3e4e2c566bc6542c4eccff1f757cf8
4e5b757fbcf21077677360be274461dcd9064106kupfer OpenSolaris Buildable Source
7a98501b9c3e4e2c566bc6542c4eccff1f757cf8kupfer#ident "%Z%%M% %I% %E% SMI"
4e5b757fbcf21077677360be274461dcd9064106kupferNote: if this is your first OpenSolaris installation, please see the
4e5b757fbcf21077677360be274461dcd9064106kupfercurrently known issues section below to see the minimum build of
4e5b757fbcf21077677360be274461dcd9064106kupferSolaris Express - Community Release required to build and install
4e5b757fbcf21077677360be274461dcd9064106kupferOpenSolaris. Either an initial install or an upgrade will work,
4e5b757fbcf21077677360be274461dcd9064106kupferprovided you use the "Entire Distribution" metacluster.
4e5b757fbcf21077677360be274461dcd9064106kupferThis delivery of the Buildable Source consists of 4 or 5 pieces:
4e5b757fbcf21077677360be274461dcd9064106kupfer1. encumbered binaries tarball (on-closed-bins-DATE.PLATFORM.tar.bz2)
4e5b757fbcf21077677360be274461dcd9064106kupfer2. compiler (Sun Studio 11 is the preferred compiler, and it is free
4e5b757fbcf21077677360be274461dcd9064106kupfer for OpenSolaris community members. You can also use gcc; more on
4e5b757fbcf21077677360be274461dcd9064106kupfer that below.)
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
4e5b757fbcf21077677360be274461dcd9064106kupferarchives-20050612/i386/). You should review Section A
4e5b757fbcf21077677360be274461dcd9064106kupfer(changes since the last delivery) and Section B (known issues) before
4e5b757fbcf21077677360be274461dcd9064106kupferfollowing the BFU instructions in the Developer's Reference
4e5b757fbcf21077677360be274461dcd9064106kupfer(http://www.opensolaris.org/os/community/onnv/devref_toc/).
4e5b757fbcf21077677360be274461dcd9064106kupferIf you want to build from source, you will need the source, compiler,
4e5b757fbcf21077677360be274461dcd9064106kupferON tools, and "extras" tools. The encumbered binaries tarball contains
4e5b757fbcf21077677360be274461dcd9064106kupfercomplete binaries (libraries, kernel modules, commands) that are
4e5b757fbcf21077677360be274461dcd9064106kupfercompatible with the source. These are binaries that cannot be built
4e5b757fbcf21077677360be274461dcd9064106kupferusing only the source tarball for one reason or another. If you wish
4e5b757fbcf21077677360be274461dcd9064106kupferto build the kernel (or some portion of it), or if you wish to build a
4e5b757fbcf21077677360be274461dcd9064106kupfercomplete set of installable archives, you will want the encumbered
4e5b757fbcf21077677360be274461dcd9064106kupferCurrently, to obtain source, you can either download the
4e5b757fbcf21077677360be274461dcd9064106kupferon-src-DATE.tar.bz2 tarball if you are downloading a build-synchronised
4e5b757fbcf21077677360be274461dcd9064106kupferdelivery. Or, you can checkout from the Mercurial repository at
4e5b757fbcf21077677360be274461dcd9064106kupfer(please see instructions at: http://opensolaris.org/os/project/onnv/)
4e5b757fbcf21077677360be274461dcd9064106kupferThe buildable source contains the source for our high key-strength
4e5b757fbcf21077677360be274461dcd9064106kupfercrypto, known as the Encryption Kit (SUNWcry, SUNWcryr, SUNWcryptoint).
4e5b757fbcf21077677360be274461dcd9064106kupferPlease note that certain countries restrict the redistribtuion 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
4e5b757fbcf21077677360be274461dcd9064106kupfer<dot> org). For detailed comments about the code, please use
4e5b757fbcf21077677360be274461dcd9064106kupferOpenSolaris Code discussion list. Please note that the mailing lists
4e5b757fbcf21077677360be274461dcd9064106kupferare configured to only allow posts via the web forum interface or from
4e5b757fbcf21077677360be274461dcd9064106kupferlist subscribers.
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
4e5b757fbcf21077677360be274461dcd9064106kupferwebsite in the Nevada community at:
4e5b757fbcf21077677360be274461dcd9064106kupferhttp://opensolaris.org/os/community/onnv/known_issues/
4e5b757fbcf21077677360be274461dcd9064106kupfer<!-- #include http://opensolaris.org/os/community/onnv/known_issues -->
4e5b757fbcf21077677360be274461dcd9064106kupferInstalling from Source
4e5b757fbcf21077677360be274461dcd9064106kupfer----------------------