Annotation of www/56.html, Revision 1.15
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 5.6</title>
5: <meta name="resource-type" content="document">
6: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7: <meta name="description" content="OpenBSD 5.6">
8: <meta name="keywords" content="openbsd,main">
9: <meta name="distribution" content="global">
10: <meta name="copyright" content="This document copyright 2014 by OpenBSD.">
11: </head>
12:
13: <body bgcolor="#ffffff" text="#000000" link="#24248E">
14:
15: <a href="index.html">
16: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
17: <p>
18:
19: <a href="images/XXX.jpg">
20: <img align="left" width="227" height="343" hspace="24" src="images/XXX.jpg"></a>
21: <h2><font color="#0000e0">OpenBSD 5.6</font></h2>
22: <p>
23: Released Nov 1, 2014<br>
24: Copyright 1997-2014, Theo de Raadt.<br>
25: <font color="#e00000">ISBN 978-0-9881561-4-2</font>
26: <br>
27: <a href="lyrics.html#56">5.6 Song: "XXX"</a>
28: <p>
29:
30: <ul>
31: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
32: <li>See the information on <a href="ftp.html">the FTP page</a> for
33: a list of mirror machines.
34: <li>Go to the <font color="#e00000">pub/OpenBSD/5.6/</font> directory on
35: one of the mirror sites.
36: <li>Have a look at <a href="errata56.html">the 5.6 errata page</a> for a list
37: of bugs and workarounds.
38: <li>See a <a href="plus56.html">detailed log of changes</a> between the
39: 5.5 and 5.6 releases.
40: <p>
1.10 deraadt 41: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1">signify(1)</a> pubkeys for this release:<br>
42: base: RWR0EANmo9nqhpPbPUZDIBcRtrVcRwQxZ8UKGWY8Ui4RHi229KFL84wV<br>
43: fw: RWT4e3jpYgSeLYs62aDsUkcvHR7+so5S/Fz/++B859j61rfNVcQTRxMw<br>
44: pkg: RWSPEf7Vpp2j0PTDG+eLs5L700nlqBFzEcSmHuv3ypVUEOYwso+UucXb<br>
1.1 deraadt 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.6.
60: For a comprehensive list, see the <a href="plus56.html">changelog</a> leading
61: to 5.6.
62: <p>
63:
64: <ul>
65: <li>...
66: <p>
67:
68:
69: <li>Installer improvements:
70: <ul>
1.15 ! krw 71: <li>Remove ftp and tape as install methods.
! 72: <li>Preserve the disklabel (and next 6 blocks) when installing boot block on
! 73: 4k-sector disk drives.
! 74: <li>Change the "Server?" question to "HTTP Server?" to allow unambiguous auto-install handling.
1.1 deraadt 75: <li>...
76: </ul>
77: <p>
78:
79: <li>New/extended platforms:
80: <ul>
81: <li>...
82: </ul>
83: <p>
84:
85: <li>Improved hardware support, including:
86: <ul>
1.13 dlg 87: <li>SCSI Multipathing support via <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man4/mpath.4">mpath(4)</a> and associated path drivers on several architectures.
1.1 deraadt 88: </ul>
89: <p>
90:
91: <li>Generic network stack improvements:
92: <ul>
93: <li>...
94: </ul>
95: <p>
96:
97: <li>Routing daemons and other userland network improvements:
98: <ul>
99: <li>...
100: </ul>
101: <p>
102:
103: <li>OpenSMTPD 5.4.2 (includes changes to 5.4.1):
104: <ul>
105: <li>...
106: </ul>
107: <p>
108:
109: <li>Security improvements:
110: <ul>
1.2 pascal 111: <li>Changed the heuristics of the stack protector to also protect functions with local array definitions and references to local frame addresses. This matches the -fstack-protector-strong option of upstream GCC.
112: <li>Position-independent executables (PIE) are now used by default on powerpc.
113: <li>Removed Kerberos.
114: </ul>
115: <p>
116:
117: <li>Assorted improvements:
118: <ul>
1.3 espie 119: <li>locate databases for both base and xenocara, as
120: <code>/usr/lib/locate/src.db</code> and
121: <code>/usr/X11R6/lib/locate/xorg.db</code>.
122: <li>Much faster package updates, due to package contents reordering that
123: precludes re-downloading unchanged files.
1.1 deraadt 124: </ul>
125: <p>
126:
1.2 pascal 127: <li>LibreSSL
1.1 deraadt 128: <ul>
129: <li>...
130: </ul>
131: <p>
132:
1.2 pascal 133: <li>OpenSSH 6.7
1.1 deraadt 134: <ul>
1.14 sobrado 135: <li>Potentially-incompatible changes:
1.1 deraadt 136: <ul>
1.14 sobrado 137: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
138: The default set of ciphers and <i>MAC</i>s has been altered to remove
139: unsafe algorithms. In particular, <i>CBC ciphers</i> and
140: <i>arcfour*</i> are disabled by default.
141: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
142: Support for <i>tcpwrappers</i>/<i>libwrap</i> has been removed.
143: <li>OpenSSH 6.5 and 6.6 have a bug that causes ~0.2% of connections
144: using the "curve25519-sha256@libssh.org" <i>KEX exchange method</i>
145: to fail when connecting with something that implements the
146: specification correctly. OpenSSH 6.7 disables this KEX method when
147: speaking to one of the affected versions.
1.1 deraadt 148: </ul>
149: <li>New/changed features:
150: <ul>
1.14 sobrado 151: <li>Major internal refactoring to begin to make part of OpenSSH usable
152: as a library. So far the wire parsing, key handling and KRL code
153: has been refactored. Please note that we do not consider the API
154: stable yet, nor do we offer the library in separable form.
155: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
156: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
157: Add support for <i>Unix domain socket</i> forwarding. A remote TCP
158: port may be forwarded to a local Unix domain socket and vice versa or
159: both ends may be a Unix domain socket.
160: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
161: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
162: Add support for <i>SSHFP DNS records</i> for <i>Ed2551</i>9 key types.
163: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
164: Allow resumption of interrupted uploads.
165: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
166: When rekeying, skip file/DNS lookups of the hostkey if it is the same
167: as the one sent during initial key exchange. (bz#2154)
168: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
169: Allow explicit ::1 and 127.0.0.1 forwarding bind addresses when
170: <tt>GatewayPorts=no</tt>; allows client to choose address family.
171: (bz#2222)
172: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
173: Add a
174: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>
175: <tt>PermitUserRC</tt> option to control whether <tt>~/.ssh/rc</tt> is
176: executed, mirroring the <tt>no-user-rc</tt> authorized_keys option.
177: (bz#2160)
178: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
179: Add a %C escape sequence for <tt>LocalCommand</tt> and
180: <tt>ControlPath</tt> that expands to a unique identifer based on a
181: hash of the tuple of (local host, remote user, hostname, port). Helps
182: avoid exceeding miserly pathname limits for Unix domain sockets in
183: multiplexing control paths. (bz#2220)
184: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
185: Make the "Too many authentication failures" message include the user,
186: source address, port and protocol in a format similar to the
187: authentication success/failure messages. (bz#2199)
188: <li>Added <i>unit</i> and <i>fuzz</i> tests for refactored code.
1.1 deraadt 189: </ul>
190: <li>The following significant bugs have been fixed in this release:
191: <ul>
1.14 sobrado 192: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
193: Fix remote forwarding with same listen port but different listen
194: address.
195: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
196: Fix inverted test that caused <i>PKCS#11</i> keys that were explicitly
197: listed in
198: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>
199: or on the commandline not to be preferred.
200: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
201: Fix bug in KRL generation: multiple consecutive revoked certificate
202: serial number ranges could be serialised to an invalid format.
203: Readers of a broken KRL caused by this bug will fail closed, so no
204: should-have-been-revoked key will be accepted.
205: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
206: Reflect stdio-forward ("<tt>ssh -W host:port ...</tt>") failures in
207: exit status. Previously we were always returning 0. (bz#2255)
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-keygen&sektion=1">ssh-keygen(1)</a>:
210: Make Ed25519 keys' title fit properly in the randomart border.
211: (bz#2247)
212: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
213: Only cleanup agent socket in the main agent process and not in any
214: subprocesses it may have started (e.g. forked askpass). Fixes agent
215: sockets being zapped when askpass processes <i>fatal()</i>. (bz#2236)
216: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&sektion=1">ssh-add(1)</a>:
217: Make stdout line-buffered; saves partial output getting lost when
218: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&sektion=1">ssh-add(1)</a>
219: <i>fatal()</i>s part-way through (e.g. when listing keys from an
220: agent that supports key types that
221: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&sektion=1">ssh-add(1)</a>
222: doesn't). (bz#2234)
223: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
224: When hashing or removing hosts, don't choke on "@revoked" markers and
225: don't remove "@cert-authority" markers. (bz#2241)
226: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
227: Don't fatal when hostname canonicalisation fails and a
228: <tt>ProxyCommand</tt> is in use; continue and allow the
229: <tt>ProxyCommand</tt> to connect anyway (e.g. to a host with a name
230: outside the DNS behind a bastion).
231: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=scp&sektion=1">scp(1)</a>:
232: When copying local->remote fails during read, don't send uninitialised
233: heap to the remote end.
234: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
235: Fix fatal "el_insertstr failed" errors when tab-completing filenames
236: with a single quote char somewhere in the string. (bz#2238)
237: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keyscan&sektion=1">ssh-keyscan(1)</a>:
238: Scan for Ed25519 keys by default.
239: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
240: When using <tt>VerifyHostKeyDNS</tt> with a DNSSEC resolver,
241: down-convert any certificate keys to plain keys and attempt SSHFP
242: resolution. Prevents a server from skipping SSHFP lookup and forcing
243: a new-hostkey dialog by offering only certificate keys.
244: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
245: Avoid crash at exit via NULL pointer reference. (bz#2225)
246: <li>Fix some strict-alignment errors.
1.1 deraadt 247: </ul>
248: </ul>
249: <p>
250:
251: <li>Ports and packages:
252: <ul>
1.2 pascal 253: <li>Over 8,800 ports.
1.1 deraadt 254: <li>...
255: </ul>
256: <p>
257: <li>Many pre-built packages for each architecture:
258: <table border=0 cellspacing=0 cellpadding=2 width="95%">
259: <tr>
260: <td valign="top" width="25%">
261: <ul>
262: <li>i386: XXXX
263: <li>sparc64: XXXX
264: <li>alpha: XXXX
265: <li>m68k: XXXX
266: </ul></td><td valign=top width="25%"><ul>
267: <li>sh: XXXX
268: <li>amd64: XXXX
269: <li>powerpc: XXXX
270: <li>m88k: XXXX
271: </ul></td><td valign=top width="25%"><ul>
272: <li>sparc: XXXX
273: <li>arm: XXXX
274: <li>hppa: XXXX
275: </ul></td><td valign=top width="25%"><ul>
276: <li>vax: XXXX
277: <li>mips64: XXXX
278: <li>mips64el: XXXX
279: </ul></td></tr></table>
280: <p>
281:
282: <li>Some highlights:
283: <ul>
1.2 pascal 284: <li>GNOME 3.12.2 <li>KDE 3.5.10
1.11 zhuk 285: <li>KDE 4.13.3
1.1 deraadt 286: <li>Xfce 4.10 <li>MySQL 5.1.73
1.2 pascal 287: <li>PostgreSQL 9.3.4 <li>Postfix 2.11.1
288: <li>OpenLDAP 2.3.43 and 2.4.39 <li>Mozilla Firefox 31.0
289: <li>Mozilla Thunderbird 31.0 <li>GHC 7.6.3
290: <li>LibreOffice 4.1.6.2 <li>Emacs 21.4 and 24.3
291: <li>Vim 7.4.135 <li>PHP 5.3.28, 5.4.30 and 5.5.14
292: <li>Python 2.7.8, 3.3.5 and 3.4.1 <li>Ruby 1.8.7.374, 1.9.3.545, 2.0.0.481 and 2.1.2
293: <li>Tcl/Tk 8.5.15 and 8.6.1 <li>JDK 1.6.0.32 and 1.7.0.55
294: <li>Mono 3.4.0 <li>Chromium 36.0.1985.125
295: <li>Groff 1.22.2 <li>Go 1.3
296: <li>GCC 4.6.4, 4.8.3 and 4.9.0 <li>LLVM/Clang 3.5 (20140228)
297: <li>Node.js 0.10.28
1.1 deraadt 298: </ul>
299: <p>
300:
301: <li>As usual, steady improvements in manual pages and other documentation.
302: <p>
303:
304: <li>The system includes the following major components from outside suppliers:
305: <ul>
1.2 pascal 306: <li>Xenocara (based on X.Org 7.7 with xserver 1.15.2 + patches,
307: freetype 2.5.3, fontconfig 2.11.1, Mesa 10.2.3, xterm 309,
308: xkeyboard-config 2.11 and more)
1.1 deraadt 309: <li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.12 lteo 310: <li>Perl 5.18.2 (+ patches)
1.2 pascal 311: <li>Nginx 1.6.0 (+ patches)
312: <li>SQLite 3.8.4.3 (+ patches)
1.1 deraadt 313: <li>Sendmail 8.14.8, with libmilter
314: <li>Bind 9.4.2-P2 (+ patches)
1.12 lteo 315: <li>NSD 4.0.3
1.2 pascal 316: <li>Unbound 1.4.22
1.1 deraadt 317: <li>Sudo 1.7.2p8
318: <li>Ncurses 5.7
319: <li>Binutils 2.15 (+ patches)
320: <li>Gdb 6.3 (+ patches)
1.12 lteo 321: <li>Less 458 (+ patches)
1.1 deraadt 322: <li>Awk Aug 10, 2011 version
323: </ul>
324:
325: </ul>
326:
327: <a name="install"></a>
328: <hr>
329: <p>
330: <h3><font color="#0000e0">How to install</font></h3>
331: <p>
332: Following this are the instructions which you would have on a piece of
333: paper if you had purchased a CDROM set instead of doing an alternate
334: form of install. The instructions for doing an FTP (or other style
335: of) install are very similar; the CDROM instructions are left intact
336: so that you can see how much easier it would have been if you had
337: purchased a CDROM instead.
338: <p>
339:
340: <hr>
341: Please refer to the following files on the three CDROMs or FTP mirror for
342: extensive details on how to install OpenBSD 5.6 on your machine:
343: <p>
344: <ul>
1.8 deraadt 345: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/hppa/INSTALL.alpha">
346: .../OpenBSD/5.6/alpha/INSTALL.alpha (on CD1)</a>
1.1 deraadt 347: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/i386/INSTALL.i386">
348: .../OpenBSD/5.6/i386/INSTALL.i386 (on CD1)</a>
1.8 deraadt 349: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/hppa/INSTALL.hppa">
350: .../OpenBSD/5.6/hppa/INSTALL.hppa (on CD1)</a>
1.1 deraadt 351: <p>
352: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/amd64/INSTALL.amd64">
1.8 deraadt 353: .../OpenBSD/5.6/amd64/INSTALL.amd64 (on CD2)</a>
1.1 deraadt 354: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/macppc/INSTALL.macppc">
1.8 deraadt 355: .../OpenBSD/5.6/macppc/INSTALL.macppc (on CD2)</a>
1.1 deraadt 356: <p>
357: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/sparc64/INSTALL.sparc64">
1.8 deraadt 358: .../OpenBSD/5.6/sparc64/INSTALL.sparc64 (on CD3)</a>
1.1 deraadt 359: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/sparc/INSTALL.sparc">
1.8 deraadt 360: .../OpenBSD/5.6/sparc/INSTALL.sparc (on CD3)</a>
1.1 deraadt 361: <p>
362: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/alpha/INSTALL.alpha">
363: .../OpenBSD/5.6/alpha/INSTALL.alpha</a>
364: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/armish/INSTALL.armish">
365: .../OpenBSD/5.6/armish/INSTALL.armish</a>
366: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/armv7/INSTALL.armv7">
367: .../OpenBSD/5.6/armv7/INSTALL.armv7</a>
368: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/aviion/INSTALL.aviion">
369: .../OpenBSD/5.6/aviion/INSTALL.aviion</a>
370: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/hppa/INSTALL.hppa">
371: .../OpenBSD/5.6/hppa/INSTALL.hppa</a>
372: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/landisk/INSTALL.landisk">
373: .../OpenBSD/5.6/landisk/INSTALL.landisk</a>
374: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/loongson/INSTALL.loongson">
375: .../OpenBSD/5.6/loongson/INSTALL.loongson</a>
376: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/luna88k/INSTALL.luna88k">
377: .../OpenBSD/5.6/luna88k/INSTALL.luna88k</a>
378: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/macppc/INSTALL.macppc">
379: .../OpenBSD/5.6/macppc/INSTALL.macppc</a>
380: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/octeon/INSTALL.octeon">
381: .../OpenBSD/5.6/octeon/INSTALL.octeon</a>
382: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/sgi/INSTALL.sgi">
383: .../OpenBSD/5.6/sgi/INSTALL.sgi</a>
384: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/socppc/INSTALL.socppc">
385: .../OpenBSD/5.6/socppc/INSTALL.socppc</a>
386: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/sparc/INSTALL.sparc">
387: .../OpenBSD/5.6/sparc/INSTALL.sparc</a>
388: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/vax/INSTALL.vax">
389: .../OpenBSD/5.6/vax/INSTALL.vax</a>
390: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.6/zaurus/INSTALL.zaurus">
391: .../OpenBSD/5.6/zaurus/INSTALL.zaurus</a>
392: </ul>
393: <hr>
394:
395: <p>
396: Quick installer information for people familiar with OpenBSD, and the
397: use of the "disklabel -E" command. If you are at all confused when
398: installing OpenBSD, read the relevant INSTALL.* file as listed above!
399: <p>
400:
401: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
402: <ul>
403: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
404: release is on CD1. If your BIOS does not support booting from CD, you will need
405: to create a boot floppy to install from. To create a boot floppy write
406: <i>CD1:5.6/i386/floppy56.fs</i> to a floppy and boot via the floppy drive.
407:
408: <p>
409: Use <i>CD1:5.6/i386/floppyB56.fs</i> instead for greater SCSI controller
410: support, or <i>CD1:5.6/i386/floppyC56.fs</i> for better laptop support.
411:
412: <p>
413: If you can't boot from a CD or a floppy disk,
414: you can install across the network using PXE as described in
415: the included INSTALL.i386 document.
416:
417: <p>
418: If you are planning on dual booting OpenBSD with another OS, you will need to
419: read INSTALL.i386.
420:
421: <p>
422: To make a boot floppy under MS-DOS, use the "rawrite" utility located
423: at <i>CD1:5.6/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
424: use the
425: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>
426: utility. The following is an example usage of
427: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>,
428: where the device could be "floppy", "rfd0c", or
429: "rfd0a".
430:
431: <ul><pre>
432: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
433: </pre></ul>
434:
435: <p>
436: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
437: your install will most likely fail. For more information on creating a boot
438: floppy and installing OpenBSD/i386 please refer to
439: <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
440: </ul>
441:
442: <p>
443: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
444: <ul>
445: The 5.6 release of OpenBSD/amd64 is located on CD2.
446: Boot from the CD to begin the install - you may need to adjust
447: your BIOS options first.
448: If you can't boot from the CD, you can create a boot floppy to install from.
449: To do this, write <i>CD2:5.6/amd64/floppy56.fs</i> to a floppy, then
450: boot from the floppy drive.
451:
452: <p>
453: If you can't boot from a CD or a floppy disk,
454: you can install across the network using PXE as described in the included
455: INSTALL.amd64 document.
456:
457: <p>
458: If you are planning to dual boot OpenBSD with another OS, you will need to
459: read INSTALL.amd64.
460: </ul>
461:
462: <p>
463: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
464: <ul>
465: Burn the image from the FTP site to a CDROM, and power on your machine
466: while holding down the <i>C</i> key until the display turns on and
467: shows <i>OpenBSD/macppc boot</i>.
468:
469: <p>
470: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
471: /5.6/macppc/bsd.rd</i>
472: </ul>
473:
474: <p>
475: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
476: <ul>
477: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
478:
479: <p>
480: If this doesn't work, or if you don't have a CDROM drive, you can write
481: <i>CD3:5.6/sparc64/floppy56.fs</i> or <i>CD3:5.6/sparc64/floppyB56.fs</i>
482: (depending on your machine) to a floppy and boot it with <i>boot
483: floppy</i>. Refer to INSTALL.sparc64 for details.
484:
485: <p>
486: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
487: will most likely fail.
488:
489: <p>
490: You can also write <i>CD3:5.6/sparc64/miniroot56.fs</i> to the swap partition on
491: the disk and boot with <i>boot disk:b</i>.
492:
493: <p>
494: If nothing works, you can boot over the network as described in INSTALL.sparc64.
495: </ul>
496:
497: <p>
498: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
499: <ul>
500: <p>Write <i>FTP:5.6/alpha/floppy56.fs</i> or
501: <i>FTP:5.6/alpha/floppyB56.fs</i> (depending on your machine) to a diskette and
502: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
503:
504: <p>
505: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
506: will most likely fail.
507:
508: </ul>
509:
510: <p>
511: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
512: <ul>
513: <p>
514: After connecting a serial port, Thecus can boot directly from the network
515: either tftp or http. Configure the network using fconfig, reset,
516: then load bsd.rd, see INSTALL.armish for specific details.
517: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
518: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
519: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
520: More details are available in INSTALL.armish.
521: </ul>
522:
523: <p>
524: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
525: <ul>
526: <p>
527: Boot over the network by following the instructions in INSTALL.hppa or the
528: <a href="hppa.html#install">hppa platform page</a>.
529: </ul>
530:
531: <p>
532: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
533: <ul>
534: <p>
535: Write <i>miniroot56.fs</i> to the start of the CF
536: or disk, and boot normally.
537: </ul>
538:
539: <p>
540: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
541: <ul>
542: <p>
543: Write <i>miniroot56.fs</i> to a USB stick and boot bsd.rd from it
544: or boot bsd.rd via tftp.
545: Refer to the instructions in INSTALL.loongson for more details.
546: </ul>
547: <p>
548:
549: <p>
550: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
551: <ul>
552: <p>
553: Copy `boot' and `bsd.rd' to a Mach or UniOS partition, and boot the bootloader
554: from the PROM, and the bsd.rd from the bootloader.
555: Refer to the instructions in INSTALL.luna88k for more details.
556: </ul>
557:
558: <p>
559: <h3><font color="#e00000">OpenBSD/octeon:</font></h3>
560: <ul>
561: <p>
562: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
563: Refer to the instructions in INSTALL.octeon for more details.
564: </ul>
565:
566: <p>
567: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
568: <ul>
569: <p>
570: To install, burn cd56.iso on a CD-R, put it in the CD drive of your
571: machine and select <i>Install System Software</i> from the System Maintenance
572: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
573: CD-ROM, and need a proper invocation from the PROM prompt.
574: Refer to the instructions in INSTALL.sgi for more details.
575:
576: <p>
577: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
578: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
579: system type. Refer to the instructions in INSTALL.sgi for more details.
580: </ul>
581:
582: <p>
583: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
584: <ul>
585: <p>
586: After connecting a serial port, boot over the network via DHCP/tftp.
587: Refer to the instructions in INSTALL.socppc for more details.
588: </ul>
589:
590: <p>
591: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
592: <ul>
593: Boot from one of the provided install ISO images, using one of the two
594: commands listed below, depending on the version of your ROM.
595:
596: <ul><pre>
597: ok <strong>boot cdrom 5.6/sparc/bsd.rd</strong>
598: or
599: > <strong>b sd(0,6,0)5.6/sparc/bsd.rd</strong>
600: </pre></ul>
601:
602: <p>
603: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
604: To do so you need to write <i>floppy56.fs</i> to a floppy.
605: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
606: To boot from the floppy use one of the two commands listed below,
607: depending on the version of your ROM.
608:
609: <ul><pre>
610: ok <strong>boot floppy</strong>
611: or
612: > <strong>b fd()</strong>
613: </pre></ul>
614:
615: <p>
616: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
617: will most likely fail.
618:
619: <p>
620: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
621: setup a bootable tape, or install via network, as told in the
622: INSTALL.sparc file.
623: </ul>
624:
625: <p>
626: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
627: <ul>
628: Boot over the network via mopbooting as described in INSTALL.vax.
629: </ul>
630:
631: <p>
632: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
633: <ul>
634: <p>
635: Using the Linux built-in graphical ipkg installer, install the
636: openbsd56_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
637: for a few important details.
638: </ul>
639:
640: <p>
641: <h3><font color="#e00000">Notes about the source code:</font></h3>
642: <ul>
643: src.tar.gz contains a source archive starting at /usr/src. This file
644: contains everything you need except for the kernel sources, which are
645: in a separate archive. To extract:
646: <p>
647: <ul><pre>
648: # <strong>mkdir -p /usr/src</strong>
649: # <strong>cd /usr/src</strong>
650: # <strong>tar xvfz /tmp/src.tar.gz</strong>
651: </pre></ul>
652: <p>
653: sys.tar.gz contains a source archive starting at /usr/src/sys.
654: This file contains all the kernel sources you need to rebuild kernels.
655: To extract:
656: <p>
657: <ul><pre>
658: # <strong>mkdir -p /usr/src/sys</strong>
659: # <strong>cd /usr/src</strong>
660: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
661: </pre></ul>
662: <p>
663: Both of these trees are a regular CVS checkout. Using these trees it
664: is possible to get a head-start on using the anoncvs servers as
665: described <a href="anoncvs.html">here</a>.
666: Using these files
667: results in a much faster initial CVS update than you could expect from
668: a fresh checkout of the full OpenBSD source tree.
669: <p>
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.6 deraadt 677: If you already have an OpenBSD 5.5 system, and do not want to reinstall,
1.1 deraadt 678: upgrade instructions and advice can be found in the
679: <a href="faq/upgrade56.html">Upgrade Guide</a>.
680:
681: <a name="ports"></a>
682: <hr>
683: <p>
684: <h3><font color="#0000e0">Ports Tree</font></h3>
685: <p>
686: A ports tree archive is also provided. To extract:
687: <p>
688: <ul><pre>
689: # <strong>cd /usr</strong>
690: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
691: </pre></ul>
692: <p>
693: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
694: read the <a href="faq/ports/index.html">ports</a> page
695: if you know nothing about ports
696: at this point. This text is not a manual of how to use ports.
697: Rather, it is a set of notes meant to kickstart the user on the
698: OpenBSD ports system.
699: <p>
700: The <i>ports/</i> directory represents a CVS (see the manpage for
701: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&arch=i386">
702: cvs(1)</a> if
703: you aren't familiar with CVS) checkout of our ports. As with our complete
704: source tree, our ports tree is available via
705: <a href="anoncvs.html">AnonCVS</a>.
706: So, in order to keep current with it, you must make the <i>ports/</i> tree
707: available on a read-write medium and update the tree with a command
708: like:
709: <p>
710: <ul><pre>
711: # <strong>cd /usr/ports</strong>
1.6 deraadt 712: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_6</strong>
1.1 deraadt 713: </pre></ul>
714: <p>
715: [Of course, you must replace the server name here with a nearby anoncvs
716: server.]
717: <p>
718: Note that most ports are available as packages through FTP. Updated
719: packages for the 5.6 release will be made available if problems arise.
720: <p>
721: If you're interested in seeing a port added, would like to help out, or just
722: would like to know more, the mailing list
723: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
724: <p>
725: </body>
726: </html>