Annotation of www/stable.html, Revision 1.59
1.22 nick 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1.1 jason 2: <html>
3: <head>
1.46 tj 4: <title>OpenBSD: -stable</title>
1.40 tj 5: <meta name="copyright" content="This document copyright 1996-2016 by OpenBSD.">
1.22 nick 6: <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
1.43 tb 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.47 tb 9: <link rel="canonical" href="https://www.openbsd.org/stable.html">
1.48 tb 10: <style type="text/css">
11: h3, h4 { color: #0000e0; }
12: </style>
1.1 jason 13: </head>
14:
1.22 nick 15: <body bgcolor="#ffffff" text="#000000">
1.23 nick 16:
1.43 tb 17: <h2>
1.44 tb 18: <a href="index.html">
1.43 tb 19: <font color="#0000ff"><i>Open</i></font><font color="#000084">BSD</font></a>
20: <font color="#e00000">-stable</font>
21: </h2>
22: <hr>
1.1 jason 23: <p>
24:
1.48 tb 25: <h3 id="whatis">What is the <i>-stable</i> branch?</h3>
26:
27: The <i>-stable</i> branch is one of OpenBSD's three
28: <a href="faq/faq5.html#Flavors">flavors</a>.
29: It consists of the release and <a href="errata.html">errata</a> patches.
30: More precisely:
1.40 tj 31:
1.4 deraadt 32: <ul>
1.48 tb 33: <li>Errata entries are made for bugs which affect many people.
34: <li>Other patches may be merged into <i>-stable</i> if they affect a few
35: people in drastic ways.
36: <li>New or changed functionality, hardware support or APIs will <i>not</i> be
37: merged.
1.4 deraadt 38: </ul>
1.40 tj 39:
1.56 tj 40: If you're running the -release branch of OpenBSD on amd64 or i386, you can
1.59 ! tb 41: simply use the <a href="https://man.openbsd.org/syspatch">syspatch(8)</a> utility
1.56 tj 42: to upgrade any files in need of
43: <a href="faq/faq10.html#Patches">security or reliability fixes</a>.
44: This page describes how to follow the -stable branch via CVS and building
45: from source.
46:
1.48 tb 47: <h3 id="getting">Getting <i>-stable</i> source code</h3>
1.40 tj 48:
1.56 tj 49: To obtain the <i>-stable</i> tree for OpenBSD 6.1, <b>it is recommended that you
50: <a href="anoncvs.html#getting">check out</a> a fresh source tree</b> from an
51: <a href="anoncvs.html">AnonCVS</a> server.
52: If you need to <a href="anoncvs.html#updating">update</a> on top of a
53: pre-existing source tree, you need to do
54: <a href="https://cvsweb.openbsd.org/cgi-bin/cvsweb/~checkout~/www/faq/current.html?rev=1.808&content-type=text/html#r20161014a">
55: some cleanup</a> first.
56: <!-- XXXrelease - remove paragraph above and reinstate paragraph below
1.48 tb 57: To obtain the <i>-stable</i> tree for a particular release of OpenBSD, you can
58: <a href="anoncvs.html#updating">update</a> on top of a pre-existing source tree
59: or you can <a href="anoncvs.html#getting">check out</a> a fresh source tree from
60: an <a href="anoncvs.html">AnonCVS</a> server.
1.56 tj 61: -->
1.40 tj 62:
1.4 deraadt 63: <p>
1.48 tb 64: <!-- XXXrelease - bump href to upgradeXX.html -->
65: Do not attempt to go from one release to another via source.
1.56 tj 66: Instead, please follow the <a href="faq/upgrade61.html">upgrade guide</a> for
1.49 tb 67: the release before compiling <i>-stable</i>.
1.23 nick 68:
1.48 tb 69: <h3 id="building">Building OpenBSD <i>-stable</i></h3>
70:
71: Details on building OpenBSD from source are provided in steps 2 and 3 of the
1.56 tj 72: <!-- XXXrelease - bump man link -->
1.59 ! tb 73: <a href="https://man.openbsd.org/OpenBSD-6.1/release">release(8)</a> manual.
1.49 tb 74: There is also an FAQ on <a href="faq/faq5.html">building the system</a>.
1.48 tb 75: If you have a number of machines to keep on the <i>-stable</i> branch, you may
1.49 tb 76: wish to <a href="faq/faq5.html#Release">make a release</a>.
1.1 jason 77:
1.48 tb 78: <h4>Rebuild the kernel and reboot</h4>
1.1 jason 79:
1.48 tb 80: Replace <tt>GENERIC</tt> with <tt>GENERIC.MP</tt> for multiprocessor systems.
1.40 tj 81:
1.22 nick 82: <blockquote><pre>
1.52 tb 83: # <b>cd /sys/arch/$(machine)/compile/GENERIC</b>
1.58 tb 84: # <b>make obj</b>
85: # <b>make config</b>
86: # <b>make && make install</b>
1.40 tj 87: # <b>reboot</b>
1.22 nick 88: </pre></blockquote>
1.1 jason 89:
1.40 tj 90: If your system has trouble booting the new kernel, you can easily go back
91: and reboot from the old kernel, now called <tt>obsd</tt>.
92:
1.48 tb 93: <h4>Rebuilding the userland</h4>
1.1 jason 94:
1.22 nick 95: <blockquote><pre>
1.40 tj 96: # <b>rm -rf /usr/obj/*</b>
97: # <b>cd /usr/src</b>
1.51 tb 98: # <b>make obj && make build</b>
1.22 nick 99: </pre></blockquote>
1.23 nick 100:
1.1 jason 101: </body>
102: </html>