Annotation of www/stable.html, Revision 1.78
1.69 bentley 1: <!doctype html>
2: <html lang=en>
3: <meta charset=utf-8>
4:
1.46 tj 5: <title>OpenBSD: -stable</title>
1.43 tb 6: <meta name="viewport" content="width=device-width, initial-scale=1">
7: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.47 tb 8: <link rel="canonical" href="https://www.openbsd.org/stable.html">
1.69 bentley 9: <style>
10: h3, h4 {
11: color: var(--blue);
12: }
1.48 tb 13: </style>
1.23 nick 14:
1.69 bentley 15: <h2 id=OpenBSD>
1.44 tb 16: <a href="index.html">
1.69 bentley 17: <i>Open</i><b>BSD</b></a>
18: -stable
1.43 tb 19: </h2>
1.69 bentley 20:
1.43 tb 21: <hr>
1.1 jason 22:
1.75 tj 23: <h3 id="whatis">What is the -stable Branch?</h3>
1.48 tb 24:
1.69 bentley 25: <p>
1.61 tj 26: The -stable branch is one of OpenBSD's three
1.48 tb 27: <a href="faq/faq5.html#Flavors">flavors</a>.
28: It consists of the release and <a href="errata.html">errata</a> patches.
29: More precisely:
1.40 tj 30:
1.4 deraadt 31: <ul>
1.48 tb 32: <li>Errata entries are made for bugs which affect many people.
1.61 tj 33: <li>Other patches may be merged into -stable if they affect a few
1.48 tb 34: people in drastic ways.
35: <li>New or changed functionality, hardware support or APIs will <i>not</i> be
36: merged.
1.4 deraadt 37: </ul>
1.40 tj 38:
1.69 bentley 39: <p>
1.56 tj 40: This page describes how to follow the -stable branch via CVS and building
41: from source.
1.78 ! tj 42: If you're running a release on amd64, i386, or arm64, you can also
1.62 tj 43: use the <a href="https://man.openbsd.org/syspatch">syspatch(8)</a> utility to
44: upgrade any files in need of security or reliability fixes with binary updates.
45: More information can be found <a href="faq/faq10.html#Patches">here</a>.
1.56 tj 46:
1.75 tj 47: <h3 id="getting">Getting -stable Source Code</h3>
1.40 tj 48:
1.69 bentley 49: <p>
1.61 tj 50: To obtain the -stable tree for a particular release of OpenBSD, you can
1.48 tb 51: <a href="anoncvs.html#updating">update</a> on top of a pre-existing source tree
52: or you can <a href="anoncvs.html#getting">check out</a> a fresh source tree from
53: an <a href="anoncvs.html">AnonCVS</a> server.
1.40 tj 54:
1.4 deraadt 55: <p>
1.48 tb 56: Do not attempt to go from one release to another via source.
1.78 ! tj 57: Instead, please follow the <a href="faq/upgrade73.html">upgrade guide</a> for
1.61 tj 58: the release before compiling -stable.
1.23 nick 59:
1.61 tj 60: <h3 id="building">Building OpenBSD -stable</h3>
1.48 tb 61:
1.69 bentley 62: <p>
1.48 tb 63: Details on building OpenBSD from source are provided in steps 2 and 3 of the
1.66 tj 64: <a href="https://man.openbsd.org/release">release(8)</a> manual.
1.49 tb 65: There is also an FAQ on <a href="faq/faq5.html">building the system</a>.
1.61 tj 66: If you have a number of machines to keep on the -stable branch, you may
1.49 tb 67: wish to <a href="faq/faq5.html#Release">make a release</a>.
1.1 jason 68:
1.48 tb 69: <h4>Rebuild the kernel and reboot</h4>
1.1 jason 70:
1.69 bentley 71: <p>
72: Replace <code>GENERIC.MP</code> with <code>GENERIC</code> for
1.64 tb 73: single-core processor systems.
1.40 tj 74:
1.65 tj 75: <pre class="cmdbox">
1.63 tb 76: # <b>cd /sys/arch/$(machine)/compile/GENERIC.MP</b>
1.58 tb 77: # <b>make obj</b>
78: # <b>make config</b>
79: # <b>make && make install</b>
1.40 tj 80: # <b>reboot</b>
1.65 tj 81: </pre>
1.1 jason 82:
1.69 bentley 83: <p>
1.40 tj 84: If your system has trouble booting the new kernel, you can easily go back
1.69 bentley 85: and reboot from the old kernel, now called <code>obsd</code>.
1.40 tj 86:
1.65 tj 87: <h4>Rebuild the userland</h4>
1.1 jason 88:
1.65 tj 89: <pre class="cmdbox">
1.40 tj 90: # <b>rm -rf /usr/obj/*</b>
91: # <b>cd /usr/src</b>
1.51 tb 92: # <b>make obj && make build</b>
1.65 tj 93: </pre>