Annotation of www/58.html, Revision 1.19
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 5.8</title>
5: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6: <meta name="description" content="OpenBSD 5.8">
7: <meta name="copyright" content="This document copyright 2015 by OpenBSD.">
8: <link rel="canonical" href="http://www.openbsd.org/58.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.8</font></h2>
20: <p>
1.7 deraadt 21: To be released Oct 18, 2015<br>
1.1 deraadt 22: Copyright 1997-2015, Theo de Raadt.<br>
23: <font color="#e00000">ISBN 978-0-9881561-6-6</font>
24: <br>
1.17 deraadt 25: <a href="lyrics.html#58">5.8 Songs: "XXX", "XXX", "XXX", "XXX", "XXX"</a>
1.1 deraadt 26: <p>
27:
28: <ul>
29: <li>Order a CDROM from our <a href="https://openbsdstore.com">ordering system</a>.
30: <li>See the information on <a href="ftp.html">the FTP page</a> for
31: a list of mirror machines.
32: <li>Go to the <font color="#e00000">pub/OpenBSD/5.8/</font> directory on
33: one of the mirror sites.
34: <li>Have a look at <a href="errata58.html">the 5.8 errata page</a> for a list
35: of bugs and workarounds.
36: <li>See a <a href="plus58.html">detailed log of changes</a> between the
37: 5.7 and 5.8 releases.
38: <p>
39: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1">signify(1)</a> pubkeys for this release:<br>
40: <pre>
1.3 deraadt 41: base: RWQNNZXtC/MqP3Eiu+6FBz/qrxiWQwDhd+9Yljzp62UP4KzFmmvzVk60
42: fw: RWTpkvg4fhJCDx9yL4bUCou/vtAecPVTfcaaGESQeBruwX/qHToMvWh6
43: pkg: RWRlkI2aFHvL/XGqD+lFerD/xUi/jnAXKwdFQwZDekYwDrEPSpSWgpI9
1.1 deraadt 44: </pre>
45: </ul>
46: <br clear=all>
47: All applicable copyrights and credits can be found in the applicable
48: file sources found in the files src.tar.gz, sys.tar.gz,
49: xenocara.tar.gz, or in the files fetched via ports.tar.gz. The
50: distribution files used to build packages from the ports.tar.gz file
51: are not included on the CDROM because of lack of space.
52: <p>
53:
54: <a name="new"></a>
55: <hr>
56: <p>
57: <h3><font color="#0000e0">What's New</font></h3>
58: <p>
59: This is a partial list of new features and systems included in OpenBSD 5.8.
60: For a comprehensive list, see the <a href="plus58.html">changelog</a> leading
61: to 5.8.
62: <p>
63:
64: <ul>
65: <li>Improved hardware support, including:
66: <ul>
1.13 sthen 67: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/ugold.4?query=ugold&sec=4">ugold(4)</a> driver now supports TEMPerHUMV1.x temperature and humidity sensors.
68: <li>Improved sensor support for the <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/upd.4?query=upd&sec=4">upd(4)</a> driver for USB Power Devices (UPS).
69: <li>Support for jumbo frames on <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/re.4?query=re&sec=4">re(4)</a> devices using RTL8168C/D/E/F/G and RTL8411, including PC Engines APU.
70: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/re.4?query=re&sec=4">re(4)</a> now works with newer devices e.g. RTL8111GU.
71: <li>Partial support has been added for full-speed isochronous devices in <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/ehci.4?query=ehci&sec=4">ehci(4)</a>, allowing USB 1.1 audio devices to be used on EHCI-only systems in some cases.
1.1 deraadt 72: <li>...
73: </ul>
74: <p>
75:
76: <li>Removed hardware support:
77: <ul>
78: <li>...
79: </ul>
80: <p>
81:
82: <li>Generic network stack improvements:
83: <ul>
1.13 sthen 84: <li>MTU of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vlan&sektion=4">vlan(4)</a> devices can now be set independently from the parent interface's MTU.
85: <li>The same network range can now be assigned to multiple interfaces, using interface priorities to choose between them.
1.1 deraadt 86: <li>...
87: </ul>
88: <p>
89:
90: <li>Installer improvements:
91: <ul>
1.19 ! benno 92: <li>in <a
! 93: href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man8/autoinstall.8?query=autoinstall&sec=8">autoinstalls</a>,
! 94: a template can be passed to <a
! 95: href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man8/disklabel.8?query=disklabel&sec=8">disklabel(8)</a>
! 96: to automatically partition the disk.
1.1 deraadt 97: </ul>
98: <p>
99:
100: <li>Routing daemons and other userland network improvements:
101: <ul>
1.13 sthen 102: <li>Many improvements and simplifications in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldpd&sektion=8">ldpd(8)</a>, including configuration reload and support for <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mpw&sektion=4">mpw(4)</a> pseudowire interfaces.
103: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a> now allows rules to match on the peer AS number.
104: <li>For terminated BGP sessions, <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpctl&sektion=8">bgpctl(8)</a> now displays the number of prefixes received on the last session.
105: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a> now correctly handles <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=carp&sektion=4">carp(4)</a> interfaces in "backup" mode at startup.
106: <li>Log messages in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a> have been made more specific.
107: <li>The default Diffie-Hellman group for VPNs configured by <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ipsec.conf&sektion=5">ipsec.conf(5)</a> has been changed to modp3072.
1.1 deraadt 108: <li>...
1.6 deraadt 109: </ul>
1.1 deraadt 110: <p>
111:
112: <li>Security improvements:
113: <ul>
1.13 sthen 114: <li>sudo has been replaced with <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=doas&sektion=1">doas(1)</a>.
115: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=file&sektion=1">file(1)</a> has been replaced with a new modern implementation, including sandbox and privilege separation.
116: <li>... <!-- talk about improved W^X / i386 PAE -->
1.1 deraadt 117: </ul>
118: <p>
119:
120: <li>Assorted improvements:
121: <ul>
1.11 tedu 122: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=worm&sektion=6">worm(6)</a>
123: now grows at a rate proportional to terminal size.
1.1 deraadt 124: <li>...
125: </ul>
126: <p>
127:
128: <li>OpenBSD <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=httpd&sektion=8">httpd(8)</a>:
129: <ul>
130: <li>...
131: </ul>
132: <p>
133:
134: <li>OpenSMTPD X.X.X
135: <ul>
136: <li>...
137: </ul>
138: <p>
139:
1.15 sobrado 140: <li>OpenSSH 7.0
1.1 deraadt 141: <ul>
1.15 sobrado 142: <li>Security:
143: <ul>
144: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
145: OpenSSH 6.8 and 6.9 incorrectly set TTYs to be world-writable.
146: Local attackers may be able to write arbitrary messages to logged-in
147: users, including terminal escape sequences.
148: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
149: fix circumvention of <tt>MaxAuthTries</tt> using keyboard-interactive
150: authentication. By specifying a long, repeating keyboard-interactive
151: "devices" string, an attacker could request the same authentication
152: method be tried thousands of times in a single pass. The
153: <tt>LoginGraceTime</tt> timeout in
154: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>
155: and any authentication failure delays implemented by the authentication
156: mechanism itself were still applied.
157: </ul>
1.1 deraadt 158: <li>Potentially-incompatible changes:
159: <ul>
1.15 sobrado 160: <li>Support for the legacy <i>SSH version 1 protocol</i> is disabled by
161: default at compile time.
162: <li>Support for the 1024-bit diffie-hellman-group1-sha1 key exchange
163: is disabled by default at run-time. It may be re-enabled using
164: the instructions at <tt>http://www.openssh.com/legacy.html</tt>.
165: <li>Support for <tt>ssh-dss</tt>, <tt>ssh-dss-cert-*</tt> <i>host</i>
166: and <i>user</i> keys is disabled by default at run-time. These may
167: be re-enabled using the instructions at
168: <tt>http://www.openssh.com/legacy.html</tt>.
169: <li>Support for the legacy <i>v00 cert format</i> has been removed.
170: <li>The default for the
171: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>
172: <tt>PermitRootLogin</tt> option has changed from "yes" to
173: "without-password".
1.1 deraadt 174: </ul>
175: <li>New/changed features:
176: <ul>
1.16 sobrado 177: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>:
1.15 sobrado 178: add <tt>PubkeyAcceptedKeyTypes</tt> option to control which public
179: key types are available for user authentication.
180: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>:
181: add <tt>HostKeyAlgorithms</tt> option to control which public key
182: types are offered for host authentications.
183: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
184: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
185: extend <tt>Ciphers</tt>, <tt>MACs</tt>, <tt>KexAlgorithms</tt>,
186: <tt>HostKeyAlgorithms</tt>, <tt>PubkeyAcceptedKeyTypes</tt> and
187: <tt>HostbasedKeyTypes</tt> options to allow appending to the default
188: set of algorithms instead of replacing it. Options may now be
189: prefixed with a <tt>+</tt> to append to the default, e.g.
190: "<tt>HostKeyAlgorithms=+ssh-dss</tt>".
1.1 deraadt 191: </ul>
192: <li>The following significant bugs have been fixed in this release:
193: <ul>
1.15 sobrado 194: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
195: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
196: add compatability workarounds for Cisco and more PuTTY versions.
197: (bz#2424)
198: <li>Fix some omissions and errors in the <tt>PROTOCOL</tt> and
199: <tt>PROTCOL.mux</tt> documentation relating to <i>Unix domain
200: socket</i> forwarding. (bz#2421, bz#2422)
201: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
202: Improve the
203: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
204: manual page to include a better desciption of Unix domain socket
205: forwarding. (bz#2423)
206: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
207: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
208: skip uninitialised PKCS#11 slots, fixing failures to load keys when
209: they are present. (bz#2427)
210: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
211: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
212: do not ignore PKCS#11 hosted keys that wth empty <tt>CKA_ID</tt>.
213: (bz#2429)
214: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
215: clarify documentation for <tt>UseDNS</tt> option. (bz#2045)
1.1 deraadt 216: </ul>
217: </ul>
218: <p>
219:
220: <li>LibreSSL
221: <ul>
222: <li>User-visible features:
223: <ul>
1.14 sobrado 224: <li>Switched <tt>openssl dhparam</tt> default from 512 to 2048 bits.
225: <li>More <i>CRYPTO ByteString</i> (CBS) packet parsing conversions.
226: <li>Fixed <tt>openssl pkeyutl -verify</tt> to exit with a 0 on success.
227: <li>Fixed dozens of Coverity issues including dead code, memory leaks,
228: logic errors and more.
229: <li>Ensure that
230: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>
231: restores terminal echo state after reading a password.
232: <li>Incorporated fix for OpenSSL Issue #3683.
233: <li>Removed SSLv3 support from
234: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>.
235: <li>Modified <tt>tls_write</tt> in <tt>libtls</tt> to allow partial
236: writes, clarified with examples in the documentation.
237: <li>Removed RSAX engine.
1.16 sobrado 238: <li>Tested SSLv3 removal with the OpenBSD ports tree and found several
239: applications that were not ready to build without SSLv3 yet.
240: For now, building a program that intentionally uses SSLv3 will
241: result in a linker warning.
1.14 sobrado 242: <li>Added <tt>TLS_method</tt>, <tt>TLS_client_method</tt> and
243: <tt>TLS_server_method</tt> as a replacement for the
244: <tt>SSLv23_*method</tt> calls.
245: <li>Default <tt>cert.pem</tt>, <tt>openssl.cnf</tt>, and
246: <tt>x509v3.cnf</tt> files are now installed under
247: <tt>$sysconfdir/ssl</tt> or the directory specified by
248: <tt>--with-openssldir</tt>. Previous versions of LibreSSL left
249: these empty.
1.1 deraadt 250: </ul>
251: <li>Code improvements:
252: <ul>
1.14 sobrado 253: <li>Reworked
254: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>
255: option handling.
256: <li>LibreSSL version define <tt>LIBRESSL_VERSION_NUMBER</tt> will now
257: be bumped for each portable release.
258: <li>Removed workarounds for TLS client padding bugs.
259: <li>Removed IE 6 SSLv3 workarounds.
260: <li><tt>--with-enginesdir</tt> is removed as a configuration parameter.
1.1 deraadt 261: </ul>
262: </ul>
263: <p>
264: <li>mandoc X.X.X
265: <ul>
266: <li>...
267: </ul>
268:
269: <p>
270: <li>Syslogd:
271: <ul>
1.4 bluhm 272: <li>OpenBSD
273: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=syslogd&sektion=8">syslogd(8)</a>
274: can bind to explicitly given UDP or TCP sockets to receive messages.
275: TCP streams are accepted with the octet counting or the non
276: transparent framing method.
277: <li>Blocks in
278: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=syslog.conf&se
279: ktion=5">syslog.conf(5)</a>
280: started with <code>+host</code> process messages created by
281: certain hosts specifically.
282: <li>Handle situations when the file descriptor limit is exhausted
283: gracefully.
284: <li>Since libtls handles short writes smarter, syslogd can use the
1.12 tedu 285: complete output buffer to save messages, coping with
286: longer TLS server down times without losing messages.
1.1 deraadt 287: </ul>
288: <p>
289: <li>Ports and packages:
290: <ul>
291: <li>Over X,XXX ports.
292: </ul>
293: <p>
294: <li>Many pre-built packages for each architecture:
295: <table border=0 cellspacing=0 cellpadding=2 width="95%">
296: <tr>
297: <td valign="top" width="25%">
298: <ul>
1.13 sthen 299: <li>i386: 8839
1.1 deraadt 300: <li>sparc64: XXXX
301: <li>alpha: XXXX
302: <li>sh: XXXX
303: </ul></td><td valign=top width="25%"><ul>
304: <li>amd64: XXXX
305: <li>powerpc: XXXX
306: <li>m88k: XXXX
307: <li>sparc: XXXX
308: </ul></td><td valign=top width="25%"><ul>
309: <li>arm: XXXX
310: <li>hppa: XXXX
311: <li>vax: XXXX
312: </ul></td><td valign=top width="25%"><ul>
313: <li>mips64: XXXX
314: <li>mips64el: XXXX
315: </ul></td></tr></table>
316: <p>
317:
318: <li>Some highlights:
319: <table border=0 cellspacing=0 cellpadding=2 width="95%">
320: <tr>
321: <td valign="top" width="33%"><ul>
1.10 lteo 322: <li>Chromium 44.0.2403.125
323: <li>Emacs 21.4 and 24.5
324: <li>GCC 4.8.4 and 4.9.3
1.1 deraadt 325: <li>GHC 7.8.4
1.10 lteo 326: <li>GNOME 3.16.2
327: <li>Go 1.4.2
1.1 deraadt 328: <li>Groff 1.22.3
1.10 lteo 329: <li>JDK 1.7.0.80 and 1.8.0.45
1.1 deraadt 330: <li>KDE 3.5.10 and 4.14.3
331: <li>LLVM/Clang 3.5 (20140228)
1.10 lteo 332: <li>LibreOffice 4.4.4.3
333: <li>MariaDB 10.0.20
334: <li>Mono 3.12.1
1.18 landry 335: <li>Mozilla Firefox 38.1.1esr and 39.0.3
1.10 lteo 336: <li>Mozilla Thunderbird 38.1.0
1.1 deraadt 337: </ul></td><td valign=top width="33%"><ul>
338: <li>Node.js 0.10.35
1.10 lteo 339: <li>OpenLDAP 2.3.43 and 2.4.41
340: <li>PHP 5.4.43, 5.5.27 and 5.6.11
341: <li>Postfix 3.0.2
342: <li>PostgreSQL 9.4.4
343: <li>Python 2.7.10 and 3.4.3
344: <li>R 3.2.1
345: <li>Ruby 1.8.7.374, 1.9.3.551, 2.0.0.645, 2.1.6, and 2.2.2
346: <li>Sendmail 8.15.2
347: <li>Sudo 1.8.14.3
1.9 stu 348: <li>Tcl/Tk 8.5.18 and 8.6.4
1.10 lteo 349: <li>TeX Live 2014
350: <li>Vim 7.4.769
351: <li>Xfce 4.12
1.1 deraadt 352: </ul></td><td valign=top width="34%">
353: </td></tr></table>
354: <p>
355:
356: <li>As usual, steady improvements in manual pages and other documentation.
357: <p>
358:
359: <li>The system includes the following major components from outside suppliers:
360: <ul>
361: <li>Xenocara (based on X.Org 7.7 with xserver 1.16.4 + patches,
1.8 matthieu 362: freetype 2.6, fontconfig 2.11.1, Mesa 10.2.9, xterm 314,
363: xkeyboard-config 2.14 and more)
1.1 deraadt 364: <li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.8 matthieu 365: <li>Perl 5.20.2 (+ patches)
366: <li>SQLite 3.8.9 (+ patches)
367: <li>NSD 4.1.3
368: <li>Unbound 1.5.4
1.1 deraadt 369: <li>Ncurses 5.7
1.8 matthieu 370: <li>Binutils 2.17 (+ patches)
1.1 deraadt 371: <li>Gdb 6.3 (+ patches)
372: <li>Less 458 (+ patches)
373: <li>Awk Aug 10, 2011 version
374: </ul>
375:
376: </ul>
377:
378: <a name="install"></a>
379: <hr>
380: <p>
381: <h3><font color="#0000e0">How to install</font></h3>
382: <p>
383: Following this are the instructions which you would have on a piece of
384: paper if you had purchased a CDROM set instead of doing an alternate
385: form of install. The instructions for doing an HTTP (or other style
386: of) install are very similar; the CDROM instructions are left intact
387: so that you can see how much easier it would have been if you had
388: purchased a CDROM instead.
389: <p>
390:
391: <hr>
392: Please refer to the following files on the three CDROMs or mirror site for
393: extensive details on how to install OpenBSD 5.8 on your machine:
394: <p>
395: <ul>
396: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.alpha">
397: .../OpenBSD/5.8/alpha/INSTALL.alpha (on CD1)</a>
398: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/i386/INSTALL.i386">
399: .../OpenBSD/5.8/i386/INSTALL.i386 (on CD1)</a>
400: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.hppa">
401: .../OpenBSD/5.8/hppa/INSTALL.hppa (on CD1)</a>
402: <p>
403: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/amd64/INSTALL.amd64">
404: .../OpenBSD/5.8/amd64/INSTALL.amd64 (on CD2)</a>
405: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/macppc/INSTALL.macppc">
406: .../OpenBSD/5.8/macppc/INSTALL.macppc (on CD2)</a>
407: <p>
408: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sparc64/INSTALL.sparc64">
409: .../OpenBSD/5.8/sparc64/INSTALL.sparc64 (on CD3)</a>
410: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sparc/INSTALL.sparc">
411: .../OpenBSD/5.8/sparc/INSTALL.sparc (on CD3)</a>
412: <p>
413: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/alpha/INSTALL.alpha">
414: .../OpenBSD/5.8/alpha/INSTALL.alpha</a>
415: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/armish/INSTALL.armish">
416: .../OpenBSD/5.8/armish/INSTALL.armish</a>
417: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/aviion/INSTALL.aviion">
418: .../OpenBSD/5.8/aviion/INSTALL.aviion</a>
419: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.hppa">
420: .../OpenBSD/5.8/hppa/INSTALL.hppa</a>
421: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/landisk/INSTALL.landisk">
422: .../OpenBSD/5.8/landisk/INSTALL.landisk</a>
423: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/loongson/INSTALL.loongson">
424: .../OpenBSD/5.8/loongson/INSTALL.loongson</a>
425: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/luna88k/INSTALL.luna88k">
426: .../OpenBSD/5.8/luna88k/INSTALL.luna88k</a>
427: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/macppc/INSTALL.macppc">
428: .../OpenBSD/5.8/macppc/INSTALL.macppc</a>
429: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/octeon/INSTALL.octeon">
430: .../OpenBSD/5.8/octeon/INSTALL.octeon</a>
431: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sgi/INSTALL.sgi">
432: .../OpenBSD/5.8/sgi/INSTALL.sgi</a>
433: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/socppc/INSTALL.socppc">
434: .../OpenBSD/5.8/socppc/INSTALL.socppc</a>
435: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sparc/INSTALL.sparc">
436: .../OpenBSD/5.8/sparc/INSTALL.sparc</a>
437: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/vax/INSTALL.vax">
438: .../OpenBSD/5.8/vax/INSTALL.vax</a>
439: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/zaurus/INSTALL.zaurus">
440: .../OpenBSD/5.8/zaurus/INSTALL.zaurus</a>
441: </ul>
442: <hr>
443:
444: <p>
445: Quick installer information for people familiar with OpenBSD, and the
446: use of the "disklabel -E" command. If you are at all confused when
447: installing OpenBSD, read the relevant INSTALL.* file as listed above!
448: <p>
449:
450: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
451: <ul>
452: The OpenBSD/i386 release is on CD1.
453: Boot from the CD to begin the install - you may need to adjust
454: your BIOS options first.
455:
456: <p>
457: If your machine can boot from USB, you can write <i>install58.fs</i> or
458: <i>miniroot58.fs</i> to a USB stick and boot from it.
459:
460: <p>
461: If you can't boot from a CD, floppy disk, or USB,
462: you can install across the network using PXE as described in
463: the included INSTALL.i386 document.
464:
465: <p>
466: If you are planning on dual booting OpenBSD with another OS, you will need to
467: read INSTALL.i386.
468:
469: </ul>
470:
471: <p>
472: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
473: <ul>
474: The OpenBSD/amd64 release is on CD2.
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>install58.fs</i> or
480: <i>miniroot58.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 the included
485: INSTALL.amd64 document.
486:
487: <p>
488: If you are planning to dual boot OpenBSD with another OS, you will need to
489: read INSTALL.amd64.
490: </ul>
491:
492: <p>
493: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
494: <ul>
495: Burn the image from a mirror site to a CDROM, and power on your machine
496: while holding down the <i>C</i> key until the display turns on and
497: shows <i>OpenBSD/macppc boot</i>.
498:
499: <p>
500: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
501: /5.8/macppc/bsd.rd</i>
502: </ul>
503:
504: <p>
505: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
506: <ul>
507: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
508:
509: <p>
510: If this doesn't work, or if you don't have a CDROM drive, you can write
511: <i>CD3:5.8/sparc64/floppy58.fs</i> or <i>CD3:5.8/sparc64/floppyB58.fs</i>
512: (depending on your machine) to a floppy and boot it with <i>boot
513: floppy</i>. Refer to INSTALL.sparc64 for details.
514:
515: <p>
516: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
517: will most likely fail.
518:
519: <p>
520: You can also write <i>CD3:5.8/sparc64/miniroot58.fs</i> to the swap partition on
521: the disk and boot with <i>boot disk:b</i>.
522:
523: <p>
524: If nothing works, you can boot over the network as described in INSTALL.sparc64.
525: </ul>
526:
527: <p>
528: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
529: <ul>
530: <p>Write <i>FTP:5.8/alpha/floppy58.fs</i> or
531: <i>FTP:5.8/alpha/floppyB58.fs</i> (depending on your machine) to a diskette and
532: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
533:
534: <p>
535: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
536: will most likely fail.
537:
538: </ul>
539:
540: <p>
541: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
542: <ul>
543: <p>
544: After connecting a serial port, Thecus can boot directly from the network
545: either tftp or http. Configure the network using fconfig, reset,
546: then load bsd.rd, see INSTALL.armish for specific details.
547: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
548: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
549: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
550: More details are available in INSTALL.armish.
551: </ul>
552:
553: <p>
554: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
555: <ul>
556: <p>
557: Boot over the network by following the instructions in INSTALL.hppa or the
558: <a href="hppa.html#install">hppa platform page</a>.
559: </ul>
560:
561: <p>
562: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
563: <ul>
564: <p>
565: Write <i>miniroot58.fs</i> to the start of the CF
566: or disk, and boot normally.
567: </ul>
568:
569: <p>
570: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
571: <ul>
572: <p>
573: Write <i>miniroot58.fs</i> to a USB stick and boot bsd.rd from it
574: or boot bsd.rd via tftp.
575: Refer to the instructions in INSTALL.loongson for more details.
576: </ul>
577: <p>
578:
579: <p>
580: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
581: <ul>
582: <p>
583: Copy `boot' and `bsd.rd' to a Mach or UniOS partition, and boot the bootloader
584: from the PROM, and the bsd.rd from the bootloader.
585: Refer to the instructions in INSTALL.luna88k for more details.
586: </ul>
587:
588: <p>
589: <h3><font color="#e00000">OpenBSD/octeon:</font></h3>
590: <ul>
591: <p>
592: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
593: Refer to the instructions in INSTALL.octeon for more details.
594: </ul>
595:
596: <p>
597: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
598: <ul>
599: <p>
600: To install, burn cd58.iso on a CD-R, put it in the CD drive of your
601: machine and select <i>Install System Software</i> from the System Maintenance
602: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
603: CD-ROM, and need a proper invocation from the PROM prompt.
604: Refer to the instructions in INSTALL.sgi for more details.
605:
606: <p>
607: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
608: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
609: system type. Refer to the instructions in INSTALL.sgi for more details.
610: </ul>
611:
612: <p>
613: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
614: <ul>
615: <p>
616: After connecting a serial port, boot over the network via DHCP/tftp.
617: Refer to the instructions in INSTALL.socppc for more details.
618: </ul>
619:
620: <p>
621: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
622: <ul>
623: Boot from one of the provided install ISO images, using one of the two
624: commands listed below, depending on the version of your ROM.
625:
626: <ul><pre>
627: ok <strong>boot cdrom 5.8/sparc/bsd.rd</strong>
628: or
629: > <strong>b sd(0,6,0)5.8/sparc/bsd.rd</strong>
630: </pre></ul>
631:
632: <p>
633: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
634: To do so you need to write <i>floppy58.fs</i> to a floppy.
635: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
636: To boot from the floppy use one of the two commands listed below,
637: depending on the version of your ROM.
638:
639: <ul><pre>
640: ok <strong>boot floppy</strong>
641: or
642: > <strong>b fd()</strong>
643: </pre></ul>
644:
645: <p>
646: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
647: will most likely fail.
648:
649: <p>
650: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
651: setup a bootable tape, or install via network, as told in the
652: INSTALL.sparc file.
653: </ul>
654:
655: <p>
656: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
657: <ul>
658: Boot over the network via mopbooting as described in INSTALL.vax.
659: </ul>
660:
661: <p>
662: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
663: <ul>
664: <p>
665: Using the Linux built-in graphical ipkg installer, install the
666: openbsd58_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
667: for a few important details.
668: </ul>
669:
670: <a name="upgrade"></a>
671: <hr>
672: <p>
673: <h3><font color="#0000e0">How to upgrade</font></h3>
674: <p>
1.2 deraadt 675: If you already have an OpenBSD 5.7 system, and do not want to reinstall,
1.1 deraadt 676: upgrade instructions and advice can be found in the
677: <a href="faq/upgrade58.html">Upgrade Guide</a>.
678:
679: <a name="sourcecode"></a>
680: <hr>
681: <p>
682: <h3><font color="#0000e0">Notes about the source code</font></h3>
683: <p>
684: src.tar.gz contains a source archive starting at /usr/src. This file
685: contains everything you need except for the kernel sources, which are
686: in a separate archive. To extract:
687: <p>
688: <ul><pre>
689: # <strong>mkdir -p /usr/src</strong>
690: # <strong>cd /usr/src</strong>
691: # <strong>tar xvfz /tmp/src.tar.gz</strong>
692: </pre></ul>
693: <p>
694: sys.tar.gz contains a source archive starting at /usr/src/sys.
695: This file contains all the kernel sources you need to rebuild kernels.
696: To extract:
697: <p>
698: <ul><pre>
699: # <strong>mkdir -p /usr/src/sys</strong>
700: # <strong>cd /usr/src</strong>
701: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
702: </pre></ul>
703: <p>
704: Both of these trees are a regular CVS checkout. Using these trees it
705: is possible to get a head-start on using the anoncvs servers as
706: described <a href="anoncvs.html">here</a>.
707: Using these files
708: results in a much faster initial CVS update than you could expect from
709: a fresh checkout of the full OpenBSD source tree.
710: <p>
711:
712: <a name="ports"></a>
713: <hr>
714: <p>
715: <h3><font color="#0000e0">Ports Tree</font></h3>
716: <p>
717: A ports tree archive is also provided. To extract:
718: <p>
719: <ul><pre>
720: # <strong>cd /usr</strong>
721: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
722: </pre></ul>
723: <p>
724: Go read the <a href="faq/ports/index.html">ports</a> page
725: if you know nothing about ports
726: at this point. This text is not a manual of how to use ports.
727: Rather, it is a set of notes meant to kickstart the user on the
728: OpenBSD ports system.
729: <p>
730: The <i>ports/</i> directory represents a CVS (see the manpage for
731: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&arch=i386">
732: cvs(1)</a> if
733: you aren't familiar with CVS) checkout of our ports. As with our complete
734: source tree, our ports tree is available via
735: <a href="anoncvs.html">AnonCVS</a>.
736: So, in order to keep up to date with the <i>-stable</i> branch, you must make
737: the <i>ports/</i> tree available on a read-write medium and update the tree
738: with a command like:
739: <p>
740: <ul><pre>
741: # <strong>cd /usr/ports</strong>
1.2 deraadt 742: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_8</strong>
1.1 deraadt 743: </pre></ul>
744: <p>
745: [Of course, you must replace the server name here with a nearby anoncvs
746: server.]
747: <p>
748: Note that most ports are available as packages on our mirrors. Updated
749: ports for the 5.8 release will be made available if problems arise.
750: <p>
751: If you're interested in seeing a port added, would like to help out, or just
752: would like to know more, the mailing list
753: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
754: <p>
755: </body>
756: </html>