[BACK]Return to stable.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/stable.html, Revision 1.3

1.1       jason       1: <!DOCTYPE HTML PUBLIC  "-//IETF//DTD HTML Strict//EN">
                      2: <html>
                      3: <head>
                      4: <title>OpenBSD Patch Branches</title>
                      5: <link rev=made href=mailto:www@openbsd.org>
                      6: <meta name="resource-type" content="document">
                      7: <meta name="description" content="stable">
                      8: <meta name="keywords" content="openbsd,anoncvs,updates,stable">
                      9: <meta name="distribution" content="global">
                     10: <meta name="copyright" content="This document copyright 1996-1998 by OpenBSD.">
                     11: </head>
                     12:
                     13: <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#23238E">
                     14:
                     15: <img alt="[OpenBSD]" height=30 width=141 SRC="images/smalltitle.gif">
                     16: <p>
1.2       deraadt    17: <h2><font color=#e00000>Patch Branches</font><hr></h2>
1.1       jason      18:
                     19: <p>
                     20: <ul><h3>Table Of Contents</h3>
                     21: <li><a href="#whatis">What is a patch branch?</a>
                     22: <li><a href="#getting">Getting a patch branch</a>
                     23: <li><a href="#building">Building from a patch branch</a>
                     24: </ul>
                     25: </p>
                     26: <hr>
                     27:
                     28: <a name="whatis"></a>
                     29: <h3><font color=#0000e0>What is a patch branch?</font></h3>
                     30:
                     31: <p>
                     32: Starting with 2.7, the OpenBSD project is providing a source
                     33: tree that contains the patches and fixes from the
                     34: <a href="errata.html">errata</a> and making
                     35: it available via <a href="anoncvs.html">CVS</a> in addition to the
                     36: current source.  Users can choose to follow either branch: current
                     37: for those who want/need all of the latest features, and the patch
                     38: branch for those who want to stick with releases and only require
                     39: the fixes and patches between releases.
                     40:
                     41: <a name="getting"></a>
                     42: <h3><font color=#0000e0>Getting a patch branch</font></h3>
                     43:
                     44: <p>
                     45: To obtain a patch branch for a particular release of OpenBSD, you
                     46: can either start with a source tree from the CD shipped with the release
1.2       deraadt    47: of OpenBSD you want to use (see <a href="orders.html">ordering</a>), or
                     48: you can grab the whole tree from an <a href="anoncvs.html">AnonCVS</a> server.
1.1       jason      49: The instructions for getting a patch branch and staying up to date are
                     50: described in the Getting Started section of the
                     51: <a href="anoncvs.html#starting">AnonCVS documentation</a>.
                     52:
                     53: <p>
                     54: Please note that the patch branches are not helpful for upgrading from one
                     55: release of OpenBSD to another, eg. to go from 2.5 to 2.6.  They only provide
                     56: a means for staying up to date with the patches for a given release.  If
                     57: you are trying to go from one release to another via source, please visit
                     58: the <a href="faq/upgrade-minifaq.html">upgrade-minifaq</a>.
                     59:
                     60: <a name="building"></a>
                     61: <h3><font color=#0000e0>Building from an OpenBSD patch branch</font></h3>
                     62: Once you have obtained a source tree via <a href="anoncvs.html">anoncvs</a>,
                     63: you must rebuild the system.  The stages for doing so are:
                     64:
                     65: <ul>
                     66:  <li>Rebuild the kernel
                     67:  <li>Reboot with the new kernel
                     68:  <li>Rebuild the binaries
                     69: </ul>
                     70:
                     71: <h4><font color=#0000e0>Rebuilding the kernel</font></h4>
                     72:
                     73: <p>
                     74: To rebuild the default kernel from stable:
1.3     ! ericj      75: <ul><pre>
        !            76: # <strong>cd /usr/src/sys/arch/i386/conf</strong>
        !            77: # <strong>/usr/sbin/config GENERIC</strong>
        !            78: # <strong>cd /usr/src/sys/arch/i386/compile/GENERIC</strong>
        !            79: # <strong>make clean &amp;&amp; make depend &amp;&amp; make</strong>
        !            80: </pre></ul>
1.1       jason      81:
                     82: <p>
                     83: Replace <i>i386</i> with your architecture, eg.
                     84: <i>sparc</i>, <i>alpha</i>, etc.
                     85:
                     86: <h4><font color=#0000e0>Rebooting with the new kernel</font></h4>
                     87:
                     88: <p>
                     89: To reboot with the newly compiled kernel:
1.3     ! ericj      90: <ul><pre>
        !            91: # <strong>cd /usr/src/sys/arch/i386/compile/GENERIC</strong>
        !            92: # <strong>cp /bsd /bsd.old</strong>          <i>(Save an old copy of your kernel)</i>
        !            93: # <strong>cp bsd /bsd</strong>               <i>(Copy the new kernel into place)</i>
        !            94: # <strong>reboot</strong>
        !            95: </pre></ul>
1.1       jason      96:
                     97: <p>
                     98: As above, substitute your architecture for <i>i386</i>.  If your system has
                     99: trouble booting the new kernel, you can easily go back and reboot from the
                    100: old kernel, now called <i>bsd.old</i>.
                    101:
                    102: <h4><font color=#0000e0>Rebuilding the binaries</font></h4>
                    103:
                    104: <p> To rebuild the system binaries:
1.3     ! ericj     105: <ul><pre>
        !           106: # <strong>cd /usr/src</strong>
        !           107: # <strong>rm -r /usr/obj/*</strong>
        !           108: # <strong>make obj &amp;&amp; make build</strong>
        !           109: </pre></ul>
1.1       jason     110:
                    111: <p>This will take awhile...
                    112: <hr>
                    113: <a href=index.html><img height=24 width=24 src=back.gif border=0 alt=OpenBSD></a>
                    114: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
1.3     ! ericj     115: <br><small>$OpenBSD: stable.html,v 1.2 2000/05/29 07:58:56 deraadt Exp $</small>
1.1       jason     116: </body>
                    117: </html>
                    118: