Annotation of www/stable.html, Revision 1.2
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:
75: <pre>
76: # cd /usr/src/sys/arch/i386/conf
77: # /usr/sbin/config GENERIC
78: # cd /usr/src/sys/arch/i386/compile/GENERIC
79: # make clean && make depend && make
80: </pre>
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:
90: <pre>
91: # cd /usr/src/sys/arch/i386/compile/GENERIC
92: # cp /bsd /bsd.old <i>(Save an old copy of your kernel)</i>
93: # cp bsd /bsd <i>(Copy the new kernel into place)</i>
94: # reboot
95: </pre>
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:
105: <pre>
106: # cd /usr/src
107: # rm -r /usr/obj/*
108: # make obj && make build
109: </pre>
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.2 ! deraadt 115: <br><small>$OpenBSD: stable.html,v 1.1 2000/05/28 19:02:34 jason Exp $</small>
1.1 jason 116: </body>
117: </html>
118: