usr/src/tools/opensolaris/README.opensolaris.tmpl

   1                      OS/Net (ON) binaries for Buildable Source
   2
   3 This delivery of the binaries to enable the Buildable Source consists of 2
   4 pieces:
   5
   6 1. encumbered binaries tarball (on-closed-bins-DATE.PLATFORM.tar.bz2)
   7 2. signed cryptographic binaries (on-crypto-DATE.PLATFORM.tar.bz2)
   8
   9 BFU archives are no longer supported.
  10
  11 If you want to build the entire source tree, you will need the source,
  12 the encumbered binaries, and the cryptographic binaries. The tools may
  13 be bootstrapped from your source tree.
  14
  15 The encumbered binaries tarball contains complete binaries (libraries,
  16 kernel modules, commands) that are compatible with the source.  These
  17 are binaries that cannot be built using only the source tarball for
  18 one reason or another.
  19
  20 The cryptographic binaries have been signed with a certificate and key
  21 that enables their use.  The cryptographic binaries that you build
  22 from source will not be usable unless you have obtained your own
  23 certificate and key.  See elfsign(1) for more information related to
  24 signing binaries.
  25
  26 To obtain source, ensure that you have Mercurial installed (if you do
  27 not, utter 'pkg install developer/versioning/mercurial'), and then
  28 checkout from the Mercurial repository; please see instructions at:
  29 http://hub.opensolaris.org/bin/view/Project+onnv/
  30
  31
  32 Build Environment
  33 -----------------
  34
  35 To build from source, you will also need the proper compiler, and you
  36 must be running a recent build. The build schedule is available at
  37 http://hub.opensolaris.org/bin/view/Community+Group+on/schedule.
  38
  39 The standard compiler for building OpenSolaris code is Sun Studio,
  40 which is free to download and use.  You can also use gcc.  See the
  41 section "Installing from Source" (below) for details.
  42
  43 Build machines are expected to be running an OpenSolaris build that
  44 is no more than 2 builds behind the source that you're building.  For
  45 example, if you're building snv_143, your build machine should be
  46 running snv_141 or later.
  47
  48
  49 Other Important Information
  50 ---------------------------
  51
  52 The buildable source contains the source for our high key-strength
  53 crypto, known as the Encryption Kit (SUNWcry, SUNWcryr, SUNWcryptoint).
  54 Please note that certain countries restrict the redistribution of
  55 high key-strength crypto.  If you live in one of these countries,
  56 it is your responsibility to ensure that you are complying with your
  57 country's laws in this area.
  58
  59 For general questions on the buildable source, please ask on the
  60 OpenSolaris Help discussion list (opensolaris-help <at> opensolaris
  61 <dot> org).  For detailed comments about the code, please use the
  62 on-discuss list.  Please note that the mailing lists are configured to
  63 only allow posts from list subscribers.  The Help list also has a web
  64 forum that is gatewayed with the mailing list.  More information about
  65 OpenSolaris lists is available at
  66 http://hub.opensolaris.org/bin/view/Main/discussions.
  67
  68
  69 Currently Known Issues
  70 ----------------------
  71         These were some of the major known issues at the time of this
  72 delivery.  The most recent list is available on the OpenSolaris.org
  73 website in the ON community at:
  74 http://hub.opensolaris.org/bin/view/Community+Group+on/known_issues
  75
  76 <!-- #include http://hub.opensolaris.org/bin/view/Community+Group+on/known_issues -->
  77
  78
  79 Installing from Source
  80 ----------------------
  81
  82 <!-- #include http://hub.opensolaris.org/bin/view/Community+Group+on/install_quickstart -->