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 && make depend && 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 && 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: