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