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