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