Annotation of www/59.html, Revision 1.24
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 5.9</title>
5: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6: <meta name="description" content="OpenBSD 5.9">
7: <meta name="copyright" content="This document copyright 2015 by OpenBSD.">
8: <link rel="canonical" href="http://www.openbsd.org/59.html">
9: </head>
10:
11: <body bgcolor="#ffffff" text="#000000" link="#24248E">
12:
13: <a href="index.html">
14: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
15: <p>
16:
17: <a href="images/XXX.jpg">
18: <img align="left" width="227" height="343" hspace="24" vspace="10" src="images/XXX.jpg"></a>
19: <h2><font color="#0000e0">OpenBSD 5.9</font></h2>
20: <p>
1.11 tedu 21: To be released May 1, 2016<br>
1.1 deraadt 22: Copyright 1997-2016, Theo de Raadt.<br>
23: <font color="#e00000">ISBN 978-0-9881561-7-3</font>
24: <br>
25: 5.9 Songs: <a href="lyrics.html#59a">"xxx"</a>,
26: <a href="lyrics.html#59b">"xxx"</a>
27: <ul>
28: <li>Order a CDROM from our <a href="https://openbsdstore.com">ordering system</a>.
29: <li>See the information on <a href="ftp.html">the FTP page</a> for
30: a list of mirror machines.
31: <li>Go to the <font color="#e00000">pub/OpenBSD/5.9/</font> directory on
32: one of the mirror sites.
33: <li>Have a look at <a href="errata59.html">the 5.9 errata page</a> for a list
34: of bugs and workarounds.
35: <li>See a <a href="plus59.html">detailed log of changes</a> between the
36: 5.8 and 5.9 releases.
37: <p>
38: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1">signify(1)</a> pubkeys for this release:<br>
39: <pre>
1.4 jsg 40: base: RWQJVNompF3pwfIqbg+5sxfpxmZMa3tTBaW4qbUhWje/H/M7glrA6oVn
41: fw: RWSdmaNkytzh6BApmPSNSDLNg26ZaXlY8g/879UvLdo3rjbsby76Eda1
42: pkg: RWSLRYDCTJeWLIScncqwGuXK6JVXDcIyRT0q+0m30MXXG4W2xWS4NZBP
1.1 deraadt 43: </pre>
44: </ul>
45: <br clear=all>
46: All applicable copyrights and credits can be found in the applicable
47: file sources found in the files src.tar.gz, sys.tar.gz,
48: xenocara.tar.gz, or in the files fetched via ports.tar.gz. The
49: distribution files used to build packages from the ports.tar.gz file
50: are not included on the CDROM because of lack of space.
51: <p>
52:
53: <a name="new"></a>
54: <hr>
55: <p>
56: <h3><font color="#0000e0">What's New</font></h3>
57: <p>
58: This is a partial list of new features and systems included in OpenBSD 5.9.
59: For a comprehensive list, see the <a href="plus59.html">changelog</a> leading
60: to 5.9.
61: <p>
62:
63: <ul>
64: <li>Improved hardware support, including:
65: <ul>
66: <li>...
67: </ul>
68: <p>
69:
70: <li>Removed hardware support:
71: <ul>
1.24 ! krw 72: <li>ST-506 disks are no longer supported.
1.1 deraadt 73: <li>...
74: </ul>
75: <p>
76:
77: <li>Generic network stack improvements:
78: <ul>
1.9 tedu 79: <li>Remove support for obsolete IPv6 socket options
1.1 deraadt 80: <li>...
81: </ul>
82: <p>
83:
84: <li>Installer improvements:
85: <ul>
1.24 ! krw 86: <li>Inappropriate user choices from a list of options are more reliably rejected.
! 87: <li>Installing to a disk partitioned with a GPT is now supported (amd64 only).
! 88: <li>When initializing a GPT the required EFI System partition is automatically created.
! 89: <li>When installing to a GPT disk <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=installboot&sektion=8">installboot(8)</a> now formats the EFI System partition, creates the appropriate directory structure and copies the required UEFI boot files into place.
1.1 deraadt 90: <li>...
91: </ul>
92: <p>
93:
94: <li>Routing daemons and other userland network improvements:
95: <ul>
1.23 krw 96: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> now supports multiple domain names provided via DHCP option 15 (Domain Name).
97: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> now supports search domains provided via DHCP option 119 (Domain Search).
98: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> no longer continually checks for a change to the routing domain of the interface it controls. It now relies on the appropriate routing socket messages.
99: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> now issues DHCP DECLINE responses to lease offers found to be inadequate, and restarts the DISCOVER/RENEW process rather than waiting indefinitely for a better lease to appear.
100: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> no longer exits if a desired route cannot be added. It now just reports the fact.
101: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> now takes a much more careful approach to received packets to ensure only received data is used to process the packet. Packets with incorrect length information or lacking appropriate header information are now dropped.
102: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> again disables pending timeouts if the interface link is lost, preventing endless retries at obtaining a lease.
103: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> was pledged.
104: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> again properly utilizes default-lease-time, max-lease-time and bootp-lease-time options.
105: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> was pledged.
1.1 deraadt 106: <li>...
107: </ul>
108: <p>
109:
110: <li>Security improvements:
111: <ul>
112: <li>...
1.10 tedu 113: <li>Support for looking up hosts via YP has been removed from libc.
114: The 'yp' lookup method in
115: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=resolv.conf&sektion=5">resolv.conf</a>
116: is no longer available.
117: <li>Support for the HOSTALIASES environment variable has been removed from libc.
1.1 deraadt 118: </ul>
119: <p>
120:
121: <li>Assorted improvements:
122: <ul>
1.9 tedu 123: <li>doas is a little friendlier to use
124: <li>Updated flex
125: <li>Updated and improved less
1.24 ! krw 126: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man8/macppc/pdisk.8?query=pdisk">pdisk(8)</a> was largely rewritten and pledged.
! 127: <li>Renaming files in the root directory of a MSDOS filesystem was fixed.
! 128: <li>Many obsolete <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man5/disktab.5?query=disktab">disktab(5)</a> attributes and entries were removed.
! 129: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/softraid.4?query=softraid">softraid(4)</a> volumes now correctly look for the disklabel in the first OpenBSD disk partition, not the last.
! 130: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/softraid.4?query=softraid">softraid(4)</a> volumes can now be partitioned with a GPT.
1.1 deraadt 131: <li>...
132: </ul>
133: <p>
134:
135: <li>OpenBSD <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=httpd&sektion=8">httpd(8)</a>:
136: <ul>
137: <li>...
138: </ul>
139: <p>
140:
141: <li>OpenSMTPD
142: <ul>
143: <li>...
144: </ul>
145: <p>
146:
1.3 jsg 147: <li>OpenSSH 7.1
1.1 deraadt 148: <ul>
149: <li>Security:
150: <ul>
1.16 sobrado 151: <li>Qualys Security identified vulnerabilities in the
152: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
1.18 sobrado 153: client experimental support for resuming SSH-connections (roaming).
1.16 sobrado 154: In the default configuration, this could potentially leak client keys
155: to a hostile server. The authentication of the server host key
156: prevents exploitation by a man-in-the-middle, so this information leak
157: is restricted to connections to malicious or compromised servers.
158: This feature has been disabled in the
159: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
160: client, and it has been removed from the source tree. The matching
161: server code has never been shipped.
162: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
163: OpenSSH 7.0 contained a logic error in
164: <tt>PermitRootLogin=prohibit-password/without-password</tt> that could,
165: depending on compile-time configuration, permit password authentication
166: to root while preventing other forms of authentication.
167: <li>Eliminate the fallback from untrusted X11-forwarding to trusted
168: forwarding for cases when the X server disables the <tt>SECURITY</tt>
169: extension.
170: <li>Fix an out of-bound read access in the packet handling code.
1.18 sobrado 171: <li>Further use of
172: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bzero&sektion=3">explicit_bzero(3)</a>
173: has been added in various buffer handling code paths to guard against
174: compilers aggressively doing dead-store removal.
1.1 deraadt 175: </ul>
176: <li>The following significant bugs have been fixed in this release:
177: <ul>
1.16 sobrado 178: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
179: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
1.18 sobrado 180: add compatibility workarounds for FuTTY.
1.16 sobrado 181: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
182: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
1.18 sobrado 183: refine compatibility workarounds for WinSCP.
1.16 sobrado 184: <li>Fix a number of memory faults (double-free, free of uninitialised
185: memory, etc) in
186: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
187: and
188: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>.
1.18 sobrado 189: <li>Correctly interpret the <tt>first_kex_follows</tt> option during the
190: initial key exchange.
1.1 deraadt 191: </ul>
192: </ul>
193: <p>
1.17 sobrado 194: <li>LibreSSL 2.3.2
1.1 deraadt 195: <ul>
196: <li>User-visible features:
197: <ul>
1.17 sobrado 198: <li>This release corrects the handling of <tt>ClientHello</tt> messages
199: that do not include TLS extensions, resulting in such handshakes being
200: aborted.
201: <li>When loading a DSA key from an raw (without DH parameters) ASN.1
202: serialization, perform some consistency checks on its `p' and `q'
203: values, and return an error if the checks failed.
204: <li>Fixed a bug in <tt>ECDH_compute_key</tt> that can lead to silent
205: truncation of the result key without error. A coding error could cause
206: software to use much shorter keys than intended.
207: <li>Removed support for <tt>DTLS_BAD_VER</tt>. Pre-DTLSv1 implementations
208: are no longer supported.
209: <li>The engine command and parameters are removed from
210: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>.
211: Previous releases removed dynamic and builtin engine support already.
212: <li>SHA-0 is removed, which was withdrawn shortly after publication
213: twenty years ago.
214: <li>Added <tt>Certplus CA</tt> root certificate to the default
215: <tt>cert.pem</tt> file.
1.19 sobrado 216: <li>Fixed a leak in
217: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=SSL_new&sektion=3">SSL_new(3)</a>
218: in the error path.
1.17 sobrado 219: <li>Fixed a memory leak and out-of-bounds access in <tt>OBJ_obj2txt</tt>.
220: <li>Fixed an up-to 7 byte overflow in RC4 when len is not a multiple of
221: <tt>sizeof(RC4_CHUNK)</tt>.
1.19 sobrado 222: <li>Added
223: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=EVP_AEAD_CTX_init&sektion=3">EVP_aead_chacha20_poly1305(3)</a>
224: which matches the
1.18 sobrado 225: <tt>AEAD</tt> construction introduced in RFC 7539, which is different
226: than that already used in TLS with
1.19 sobrado 227: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=EVP_AEAD_CTX_init&sektion=3">EVP_aead_chacha20_poly1305(3)</a>.
1.18 sobrado 228: <li>More man pages converted from pod to
229: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sektion=7">mdoc(7)</a>
230: format.
1.17 sobrado 231: <li>Added <tt>COMODO RSA Certification Authority</tt> and
232: <tt>QuoVadis</tt> root certificates to <tt>cert.pem</tt>.
233: <li>Removed Remhve "<tt>C=US, O=VeriSign, Inc., OU=Class 3 Public Primary
234: Certification Authority</tt>"
235: (serial 3c:91:31:cb:1f:f6:d0:1b:0e:9a:b8:d0:44:bf:12:be)
236: root certificate from <tt>cert.pem</tt>.
237: <li>Fixed incorrect TLS certificate loading by
238: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nc&sektion=1">nc(1)</a>.
239: <li>The following CVEs had been fixed:
240: <ul>
241: <li><tt>CVE-2015-3194</tt>—NULL pointer dereference in client
242: side certificate validation.
243: <li><tt>CVE-2015-3195</tt>—memory leak in PKCS7, not reachable
244: from TLS/SSL.
245: </ul>
246: <li>Note: The following OpenSSL CVEs did not apply to LibreSSL:
247: <ul>
248: <li><tt>CVE-2015-3193</tt>—carry propagating bug in the x86_64
249: Montgomery squaring procedure.
250: <li><tt>CVE-2015-3196</tt>—double free race condition of the
251: identify hint data.
252: </ul>
1.1 deraadt 253: </ul>
254: <li>Code improvements:
255: <ul>
1.17 sobrado 256: <li>Added install target for <tt>cmake</tt> builds.
257: <li>Updated <tt>pkgconfig</tt> files to correctly report the release
258: version number, not the individual library ABI version numbers.
259: <li>SSLv3 is now permanently removed from the tree.
260: <li>The <tt>libtls</tt> API is changed from the 2.2.x series:
261: <ul>
1.19 sobrado 262: <li>The
263: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_read(3)</a>
264: and
265: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_write(3)</a>
266: functions now work better with external event libraries.
1.17 sobrado 267: <li>Client-side verification is now supported, with the client
268: supplying the certificate to the server.
1.19 sobrado 269: <li>Also, when using
270: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_connect_fds(3)</a>,
271: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_connect_socket(3)</a>
272: or
273: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_accept_fds(3)</a>,
1.17 sobrado 274: <tt>libtls</tt> no longer implicitly closes the passed in sockets.
275: The caller is responsible for closing them in this case.
276: </ul>
277: <li>New interface <tt>OPENSSL_cpu_caps</tt> is provided that does not
278: allow software to inadvertently modify cpu capability flags.
279: <tt>OPENSSL_ia32cap</tt> and <tt>OPENSSL_ia32cap_loc</tt> are removed.
1.18 sobrado 280: <li>The <tt>out_len</tt> argument of <tt>AEAD</tt> changed from
281: <tt>ssize_t</tt> to <tt>size_t</tt>.
1.17 sobrado 282: <li>Deduplicated DTLS code, sharing bugfixes and improvements with TLS.
283: <li>Converted
284: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nc&sektion=1">nc(1)</a>
285: to use <tt>libtls</tt> for client and server operations; it is
286: included in the libressl-portable distribution as an example of how
287: to use the <tt>libtls</tt> library. This is intended to be a simpler
288: and more robust replacement for <tt>openssl s_client</tt> and
289: <tt>openssl s_server</tt> for day-to-day operations.
290: <li>ASN.1 cleanups and RFC5280 compliance fixes.
291: <li>Time representations switched from <tt>unsigned long</tt> to
292: <tt>time_t</tt>. LibreSSL now checks if the host OS supports 64-bit
293: <tt>time_t</tt>.
294: <li>Support always extracting the peer cipher and version with
295: <tt>libtls</tt>.
296: <li>Added ability to check certificate validity times with
1.19 sobrado 297: <tt>libtls</tt>,
298: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_peer_cert_notbefore(3)</a>
299: and
300: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_peer_cert_notafter(3)</a>.
301: <li>Changed
302: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tls_init&sektion=3">tls_connect_servername(3)</a>
303: to use the first address that resolves with
1.18 sobrado 304: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getaddrinfo&sektion=3">getaddrinfo(3)</a>.
1.17 sobrado 305: <li>Remove broken conditional <tt>EVP_CHECK_DES_KEY</tt> code
306: (non-functional since initial commit in 2004).
1.19 sobrado 307: <li>Reject too small bits value in
308: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=BN_generate_prime&sektion=3">BN_generate_prime_ex(3)</a>,
1.17 sobrado 309: so that it does not risk becoming negative in
310: <tt>probable_prime_dh_safe()</tt>.
1.18 sobrado 311: <li>Changed format of <tt>LIBRESSL_VERSION_NUMBER</tt> to match that of
1.17 sobrado 312: <tt>OPENSSL_VERSION_NUMBER</tt>.
313: <li>Avoid a potential undefined C99+ behavior due to shift overflow in
314: <tt>AES_decrypt</tt>.
315: <li>Deprecated the <tt>SSL_OP_SINGLE_DH_USE</tt> flag.
1.1 deraadt 316: </ul>
317: </ul>
318: <p>
319: <li>Syslogd:
320: <ul>
321: <li>...
322: </ul>
323: <p>
324: <li>Ports and packages:
325: <dl>
326: <dt>Many pre-built packages for each architecture:
327: <table border=0 cellspacing=0 cellpadding=2 width="95%">
328: <tr>
329: <td valign="top" width="25%">
330: <ul>
331: <li>alpha: xxxx
332: <li>amd64: xxxx
333: <li>hppa: xxxx
334: </ul></td><td valign=top width="25%"><ul>
335: <li>i386: xxxx
336: <li>mips64: xxxx
337: <li>mips64el: xxxx
338: </ul></td><td valign=top width="25%"><ul>
339: <li>powerpc: xxxx
340: <li>sh: xxxx
341: <li>sparc64: xxxx
342: </ul></td><td valign=top width="25%"><ul>
343: <li>vax: xxxx
344: </ul></td></tr></table>
345: <p>
346:
347: <dt>Some highlights:
348: <table border=0 cellspacing=0 cellpadding=2 width="95%">
349: <tr>
350: <td valign="top" width="33%"><ul>
1.15 lteo 351: <li>Chromium 48.0.2564.97
1.1 deraadt 352: <li>Emacs 21.4 and 24.5
1.3 jsg 353: <li>GCC 4.9.3
354: <li>GHC 7.10.3
355: <li>GNOME 3.18.2
1.5 sthen 356: <li>Go 1.5.3
1.1 deraadt 357: <li>Groff 1.22.3
358: <li>JDK 1.7.0.80 and 1.8.0.45
359: <li>KDE 3.5.10 and 4.14.3 (plus KDE4 core updates)
360: <li>LLVM/Clang 3.5 (20140228)
1.3 jsg 361: <li>LibreOffice 5.0.4.2
362: <li>MariaDB 10.0.23
363: <li>Mono 4.2.1.102
1.13 jsg 364: <li>Mozilla Firefox 38.6.0esr and 44.0
1.3 jsg 365: <li>Mozilla Thunderbird 38.5.1
1.1 deraadt 366: </ul></td><td valign=top width="33%"><ul>
1.22 abieber 367: <li>Node.js 4.3.0
1.3 jsg 368: <li>OpenLDAP 2.3.43 and 2.4.43
1.5 sthen 369: <li>PHP 5.4.45, 5.5.31 and 5.6.17
1.3 jsg 370: <li>Postfix 3.0.3
371: <li>PostgreSQL 9.4.5
372: <li>Python 2.7.11, 3.4.4 and 3.5.1
373: <li>R 3.2.3
374: <li>Ruby 1.8.7.374, 2.0.0.648, 2.1.8, 2.2.4 and 2.3.0
1.15 lteo 375: <li>Rust 1.6.0
1.1 deraadt 376: <li>Sendmail 8.15.2
1.3 jsg 377: <li>Sudo 1.8.15
1.1 deraadt 378: <li>Tcl/Tk 8.5.18 and 8.6.4
379: <li>TeX Live 2014
1.3 jsg 380: <li>Vim 7.4.900
1.1 deraadt 381: <li>Xfce 4.12
382: </ul></td><td valign=top width="34%">
383: </td></tr></table>
384: <p>
385:
386: <li>As usual, steady improvements in manual pages and other documentation.
387: <p>
388:
389: <li>The system includes the following major components from outside suppliers:
390: <ul>
1.3 jsg 391: <li>Xenocara (based on X.Org 7.7 with xserver 1.17.4 + patches,
1.8 jsg 392: freetype 2.6.2, fontconfig 2.11.1, Mesa 11.0.9, xterm 322,
1.21 matthieu 393: xkeyboard-config 2.17 and more)
1.1 deraadt 394: <li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
395: <li>Perl 5.20.2 (+ patches)
1.3 jsg 396: <li>SQLite 3.9.2 (+ patches)
397: <li>NSD 4.1.7
398: <li>Unbound 1.5.7
1.1 deraadt 399: <li>Ncurses 5.7
400: <li>Binutils 2.17 (+ patches)
401: <li>Gdb 6.3 (+ patches)
402: <li>Less 458 (+ patches)
403: <li>Awk Aug 10, 2011 version
404: </ul>
405:
406: </ul>
407:
408: <a name="install"></a>
409: <hr>
410: <p>
411: <h3><font color="#0000e0">How to install</font></h3>
412: <p>
413: Following this are the instructions which you would have on a piece of
414: paper if you had purchased a CDROM set instead of doing an alternate
415: form of install. The instructions for doing an HTTP (or other style
416: of) install are very similar; the CDROM instructions are left intact
417: so that you can see how much easier it would have been if you had
418: purchased a CDROM instead.
419: <p>
420:
421: <hr>
422: Please refer to the following files on the three CDROMs or mirror site for
423: extensive details on how to install OpenBSD 5.9 on your machine:
424: <p>
425: <ul>
426: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/alpha/INSTALL.alpha">
427: .../OpenBSD/5.9/alpha/INSTALL.alpha (on CD1)</a>
428: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/i386/INSTALL.i386">
429: .../OpenBSD/5.9/i386/INSTALL.i386 (on CD1)</a>
430: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/hppa/INSTALL.hppa">
431: .../OpenBSD/5.9/hppa/INSTALL.hppa (on CD1)</a>
432: <p>
433: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/amd64/INSTALL.amd64">
434: .../OpenBSD/5.9/amd64/INSTALL.amd64 (on CD2)</a>
435: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/macppc/INSTALL.macppc">
436: .../OpenBSD/5.9/macppc/INSTALL.macppc (on CD2)</a>
437: <p>
438: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/sparc64/INSTALL.sparc64">
439: .../OpenBSD/5.9/sparc64/INSTALL.sparc64 (on CD3)</a>
440: <p>
441: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/alpha/INSTALL.alpha">
442: .../OpenBSD/5.9/alpha/INSTALL.alpha</a>
443: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/hppa/INSTALL.hppa">
444: .../OpenBSD/5.9/hppa/INSTALL.hppa</a>
445: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/landisk/INSTALL.landisk">
446: .../OpenBSD/5.9/landisk/INSTALL.landisk</a>
447: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/loongson/INSTALL.loongson">
448: .../OpenBSD/5.9/loongson/INSTALL.loongson</a>
449: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/luna88k/INSTALL.luna88k">
450: .../OpenBSD/5.9/luna88k/INSTALL.luna88k</a>
451: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/macppc/INSTALL.macppc">
452: .../OpenBSD/5.9/macppc/INSTALL.macppc</a>
453: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/octeon/INSTALL.octeon">
454: .../OpenBSD/5.9/octeon/INSTALL.octeon</a>
455: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/sgi/INSTALL.sgi">
456: .../OpenBSD/5.9/sgi/INSTALL.sgi</a>
457: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/socppc/INSTALL.socppc">
458: .../OpenBSD/5.9/socppc/INSTALL.socppc</a>
459: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/vax/INSTALL.vax">
460: .../OpenBSD/5.9/vax/INSTALL.vax</a>
461: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.9/zaurus/INSTALL.zaurus">
462: .../OpenBSD/5.9/zaurus/INSTALL.zaurus</a>
463: </ul>
464: <hr>
465:
466: <p>
467: Quick installer information for people familiar with OpenBSD, and the
468: use of the "disklabel -E" command. If you are at all confused when
469: installing OpenBSD, read the relevant INSTALL.* file as listed above!
470: <p>
471:
472: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
473: <ul>
474: The OpenBSD/i386 release is on CD1.
475: Boot from the CD to begin the install - you may need to adjust
476: your BIOS options first.
477:
478: <p>
479: If your machine can boot from USB, you can write <i>install59.fs</i> or
480: <i>miniroot59.fs</i> to a USB stick and boot from it.
481:
482: <p>
483: If you can't boot from a CD, floppy disk, or USB,
484: you can install across the network using PXE as described in
485: the included INSTALL.i386 document.
486:
487: <p>
488: If you are planning on dual booting OpenBSD with another OS, you will need to
489: read INSTALL.i386.
490:
491: </ul>
492:
493: <p>
494: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
495: <ul>
496: The OpenBSD/amd64 release is on CD2.
497: Boot from the CD to begin the install - you may need to adjust
498: your BIOS options first.
499:
500: <p>
501: If your machine can boot from USB, you can write <i>install59.fs</i> or
502: <i>miniroot59.fs</i> to a USB stick and boot from it.
503:
504: <p>
505: If you can't boot from a CD, floppy disk, or USB,
506: you can install across the network using PXE as described in the included
507: INSTALL.amd64 document.
508:
509: <p>
510: If you are planning to dual boot OpenBSD with another OS, you will need to
511: read INSTALL.amd64.
512: </ul>
513:
514: <p>
515: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
516: <ul>
517: Burn the image from a mirror site to a CDROM, and power on your machine
518: while holding down the <i>C</i> key until the display turns on and
519: shows <i>OpenBSD/macppc boot</i>.
520:
521: <p>
522: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
523: /5.9/macppc/bsd.rd</i>
524: </ul>
525:
526: <p>
527: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
528: <ul>
529: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
530:
531: <p>
532: If this doesn't work, or if you don't have a CDROM drive, you can write
533: <i>CD3:5.9/sparc64/floppy59.fs</i> or <i>CD3:5.9/sparc64/floppyB59.fs</i>
534: (depending on your machine) to a floppy and boot it with <i>boot
535: floppy</i>. Refer to INSTALL.sparc64 for details.
536:
537: <p>
538: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
539: will most likely fail.
540:
541: <p>
542: You can also write <i>CD3:5.9/sparc64/miniroot59.fs</i> to the swap partition on
543: the disk and boot with <i>boot disk:b</i>.
544:
545: <p>
546: If nothing works, you can boot over the network as described in INSTALL.sparc64.
547: </ul>
548:
549: <p>
550: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
551: <ul>
552: <p>Write <i>FTP:5.9/alpha/floppy59.fs</i> or
553: <i>FTP:5.9/alpha/floppyB59.fs</i> (depending on your machine) to a diskette and
554: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
555:
556: <p>
557: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
558: will most likely fail.
559:
560: </ul>
561:
562: <p>
563: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
564: <ul>
565: <p>
566: Boot over the network by following the instructions in INSTALL.hppa or the
567: <a href="hppa.html#install">hppa platform page</a>.
568: </ul>
569:
570: <p>
571: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
572: <ul>
573: <p>
574: Write <i>miniroot59.fs</i> to the start of the CF
575: or disk, and boot normally.
576: </ul>
577:
578: <p>
579: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
580: <ul>
581: <p>
582: Write <i>miniroot59.fs</i> to a USB stick and boot bsd.rd from it
583: or boot bsd.rd via tftp.
584: Refer to the instructions in INSTALL.loongson for more details.
585: </ul>
586: <p>
587:
588: <p>
589: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
590: <ul>
591: <p>
592: Copy `boot' and `bsd.rd' to a Mach or UniOS partition, and boot the bootloader
593: from the PROM, and then bsd.rd from the bootloader.
594: Refer to the instructions in INSTALL.luna88k for more details.
595: </ul>
596:
597: <p>
598: <h3><font color="#e00000">OpenBSD/octeon:</font></h3>
599: <ul>
600: <p>
601: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
602: Refer to the instructions in INSTALL.octeon for more details.
603: </ul>
604:
605: <p>
606: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
607: <ul>
608: <p>
609: To install, burn cd59.iso on a CD-R, put it in the CD drive of your
610: machine and select <i>Install System Software</i> from the System Maintenance
611: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
612: CD-ROM, and need a proper invocation from the PROM prompt.
613: Refer to the instructions in INSTALL.sgi for more details.
614:
615: <p>
616: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
617: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
618: system type. Refer to the instructions in INSTALL.sgi for more details.
619: </ul>
620:
621: <p>
622: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
623: <ul>
624: <p>
625: After connecting a serial port, boot over the network via DHCP/tftp.
626: Refer to the instructions in INSTALL.socppc for more details.
627: </ul>
628:
629: <p>
630: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
631: <ul>
632: Boot over the network via mopbooting as described in INSTALL.vax.
633: </ul>
634:
635: <p>
636: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
637: <ul>
638: <p>
639: Using the Linux built-in graphical ipkg installer, install the
640: openbsd59_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
641: for a few important details.
642: </ul>
643:
644: <a name="upgrade"></a>
645: <hr>
646: <p>
647: <h3><font color="#0000e0">How to upgrade</font></h3>
648: <p>
1.6 tj 649: If you already have an OpenBSD 5.8 system, and do not want to reinstall,
1.1 deraadt 650: upgrade instructions and advice can be found in the
651: <a href="faq/upgrade59.html">Upgrade Guide</a>.
652:
653: <a name="sourcecode"></a>
654: <hr>
655: <p>
656: <h3><font color="#0000e0">Notes about the source code</font></h3>
657: <p>
658: src.tar.gz contains a source archive starting at /usr/src. This file
659: contains everything you need except for the kernel sources, which are
660: in a separate archive. To extract:
661: <p>
662: <ul><pre>
663: # <strong>mkdir -p /usr/src</strong>
664: # <strong>cd /usr/src</strong>
665: # <strong>tar xvfz /tmp/src.tar.gz</strong>
666: </pre></ul>
667: <p>
668: sys.tar.gz contains a source archive starting at /usr/src/sys.
669: This file contains all the kernel sources you need to rebuild kernels.
670: To extract:
671: <p>
672: <ul><pre>
673: # <strong>mkdir -p /usr/src/sys</strong>
674: # <strong>cd /usr/src</strong>
675: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
676: </pre></ul>
677: <p>
678: Both of these trees are a regular CVS checkout. Using these trees it
679: is possible to get a head-start on using the anoncvs servers as
680: described <a href="anoncvs.html">here</a>.
681: Using these files
682: results in a much faster initial CVS update than you could expect from
683: a fresh checkout of the full OpenBSD source tree.
684: <p>
685:
686: <a name="ports"></a>
687: <hr>
688: <p>
689: <h3><font color="#0000e0">Ports Tree</font></h3>
690: <p>
691: A ports tree archive is also provided. To extract:
692: <p>
693: <ul><pre>
694: # <strong>cd /usr</strong>
695: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
696: </pre></ul>
697: <p>
698: Go read the <a href="faq/ports/index.html">ports</a> page
699: if you know nothing about ports
700: at this point. This text is not a manual of how to use ports.
701: Rather, it is a set of notes meant to kickstart the user on the
702: OpenBSD ports system.
703: <p>
704: The <i>ports/</i> directory represents a CVS (see the manpage for
705: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&arch=i386">
706: cvs(1)</a> if
707: you aren't familiar with CVS) checkout of our ports. As with our complete
708: source tree, our ports tree is available via
709: <a href="anoncvs.html">AnonCVS</a>.
710: So, in order to keep up to date with the <i>-stable</i> branch, you must make
711: the <i>ports/</i> tree available on a read-write medium and update the tree
712: with a command like:
713: <p>
714: <ul><pre>
715: # <strong>cd /usr/ports</strong>
716: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_9</strong>
717: </pre></ul>
718: <p>
719: [Of course, you must replace the server name here with a nearby anoncvs
720: server.]
721: <p>
722: Note that most ports are available as packages on our mirrors. Updated
723: ports for the 5.9 release will be made available if problems arise.
724: <p>
725: If you're interested in seeing a port added, would like to help out, or just
726: would like to know more, the mailing list
727: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
728: <p>
729: </body>
730: </html>