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