1*597bd30bSMike Kupfer OS/Net (ON) Buildable Source 27a98501bSkupfer 3*597bd30bSMike KupferThis delivery of the Buildable Source consists of 5 pieces: 44e5b757fSkupfer 54e5b757fSkupfer1. encumbered binaries tarball (on-closed-bins-DATE.PLATFORM.tar.bz2) 6*597bd30bSMike Kupfer2. signed cryptographic binaries (on-crypto-DATE.PLATFORM.tar.bz2) 74e5b757fSkupfer3. ON build tools package (SUNWonbld-DATE.PLATFORM.tar.bz2) 84e5b757fSkupfer4. Pre-built BFU archives (on-bfu-DATE.PLATFORM.tar.bz2) 94e5b757fSkupfer5. source tarball (on-src-DATE.tar.bz2; numbered builds only) 104e5b757fSkupfer 114e5b757fSkupferIf you just want to install the pre-built archives, you'll need the ON 124e5b757fSkupferbuild tools and the BFU archives. The tar file will unpack the 13*597bd30bSMike Kupferarchives into archives-DATE/PLATFORM/ (e.g., archives-20050612/i386/). 14*597bd30bSMike KupferYou should review the Known Issues section (below) before following 15*597bd30bSMike Kupferthe BFU instructions in the Developer's Reference 1620440d37SMike Kupfer(http://hub.opensolaris.org/bin/view/Community+Group+on/devref_toc). 174e5b757fSkupfer 18*597bd30bSMike KupferIf you want to build the entire source tree, you will need the source, 19*597bd30bSMike Kupferthe ON build tools, the encumbered binaries, and the cryptographic 204e5b757fSkupferbinaries. 214e5b757fSkupfer 22*597bd30bSMike KupferThe encumbered binaries tarball contains complete binaries (libraries, 23*597bd30bSMike Kupferkernel modules, commands) that are compatible with the source. These 24*597bd30bSMike Kupferare binaries that cannot be built using only the source tarball for 25*597bd30bSMike Kupferone reason or another. 26*597bd30bSMike Kupfer 27*597bd30bSMike KupferThe cryptographic binaries have been signed with a certificate and key 28*597bd30bSMike Kupferthat enables their use. The cryptographic binaries that you build 29*597bd30bSMike Kupferfrom source will not be usable unless you have obtained your own 30*597bd30bSMike Kupfercertificate and key. See elfsign(1) for more information related to 31*597bd30bSMike Kupfersigning binaries. 32*597bd30bSMike Kupfer 33*597bd30bSMike KupferTo obtain source, you can download the on-src-DATE.tar.bz2 34*597bd30bSMike Kupfertarball if you are downloading a build-synchronised delivery. Or, you 35*597bd30bSMike Kupfercan checkout from the Mercurial repository; please see instructions 36*597bd30bSMike Kupferat: http://hub.opensolaris.org/bin/view/Project+onnv/. 37*597bd30bSMike Kupfer 38*597bd30bSMike Kupfer 39*597bd30bSMike KupferBuild Environment 40*597bd30bSMike Kupfer----------------- 41*597bd30bSMike Kupfer 42*597bd30bSMike KupferTo build from source, you will also need the proper compiler, and you 43*597bd30bSMike Kupfermust be running a recent build. 44*597bd30bSMike Kupfer 45*597bd30bSMike KupferThe standard compiler for building OpenSolaris code is Sun Studio, 46*597bd30bSMike Kupferwhich is free to download and use. You can also use gcc. See the 47*597bd30bSMike Kupfersection "Installing from Source" (below) for details. 48*597bd30bSMike Kupfer 49*597bd30bSMike KupferBuild machines are expected to be running an OpenSolaris build that is 50*597bd30bSMike Kupferno more than 2 builds behind the source that you're building. For 51*597bd30bSMike Kupferexample, if you're building snv_120, your build machine should be 52*597bd30bSMike Kupferrunning snv_118 or later. 53*597bd30bSMike Kupfer 54*597bd30bSMike Kupfer 55*597bd30bSMike KupferOther Important Information 56*597bd30bSMike Kupfer--------------------------- 574e5b757fSkupfer 584e5b757fSkupferThe buildable source contains the source for our high key-strength 594e5b757fSkupfercrypto, known as the Encryption Kit (SUNWcry, SUNWcryr, SUNWcryptoint). 60c3f177eaSPeter Dennis - Sustaining EngineerPlease note that certain countries restrict the redistribution of 614e5b757fSkupferhigh key-strength crypto. If you live in one of these countries, 624e5b757fSkupferit is your responsibility to ensure that you are complying with your 634e5b757fSkupfercountry's laws in this area. 644e5b757fSkupfer 654e5b757fSkupferFor general questions on the buildable source, please ask on the 664e5b757fSkupferOpenSolaris Help discussion list (opensolaris-help <at> opensolaris 67*597bd30bSMike Kupfer<dot> org). For detailed comments about the code, please use the 68*597bd30bSMike Kupferon-discuss list. Please note that the mailing lists are configured to 69*597bd30bSMike Kupferonly allow posts from list subscribers. The Help list also has a web 70*597bd30bSMike Kupferforum that is gatewayed with the mailing list. More information about 71*597bd30bSMike KupferOpenSolaris lists is available at 72*597bd30bSMike Kupferhttp://hub.opensolaris.org/bin/view/Main/discussions. 734e5b757fSkupfer 744e5b757fSkupfer 754e5b757fSkupferCurrently Known Issues 764e5b757fSkupfer---------------------- 774e5b757fSkupfer These were some of the major known issues at the time of this 784e5b757fSkupferdelivery. The most recent list is available on the OpenSolaris.org 79*597bd30bSMike Kupferwebsite in the ON community at: 8020440d37SMike Kupferhttp://hub.opensolaris.org/bin/view/Community+Group+on/known_issues 814e5b757fSkupfer 8220440d37SMike Kupfer<!-- #include http://hub.opensolaris.org/bin/view/Community+Group+on/known_issues --> 834e5b757fSkupfer 844e5b757fSkupfer 854e5b757fSkupferInstalling from Source 864e5b757fSkupfer---------------------- 874e5b757fSkupfer 8820440d37SMike Kupfer<!-- #include http://hub.opensolaris.org/bin/view/Community+Group+on/install_quickstart --> 89