Annotation of www/54.html, Revision 1.49
1.46 bentley 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
1.30 deraadt 5: <title>OpenBSD 5.4</title>
1.1 deraadt 6: <meta name="description" content="OpenBSD 5.4">
1.40 deraadt 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.42 tb 9: <link rel="canonical" href="https://www.openbsd.org/54.html">
1.1 deraadt 10:
1.46 bentley 11: <h2 id=OpenBSD>
1.1 deraadt 12: <a href="index.html">
1.46 bentley 13: <i>Open</i><b>BSD</b></a>
14: 5.4
1.40 deraadt 15: </h2>
1.1 deraadt 16:
1.46 bentley 17: <table>
18: <tr>
19: <td>
1.14 deraadt 20: <a href="images/Puffia.jpg">
1.46 bentley 21: <img width="227" height="343" src="images/Puffia.jpg" alt="Puffia"></a>
22: <td>
1.25 nick 23: Released Nov 1, 2013<br>
1.1 deraadt 24: Copyright 1997-2013, Theo de Raadt.<br>
1.46 bentley 25: <cite class=isbn>ISBN 978-0-9881561-2-8</cite>
1.1 deraadt 26: <br>
1.37 deraadt 27: 5.4 Song: <a href="lyrics.html#54">"Our favorite hacks"</a>
1.45 deraadt 28: <br>
29: <br>
1.1 deraadt 30: <ul>
31: <li>See the information on <a href="ftp.html">The FTP page</a> for
32: a list of mirror machines.
1.46 bentley 33: <li>Go to the <code class=reldir>pub/OpenBSD/5.4/</code> directory on
1.1 deraadt 34: one of the mirror sites.
35: <li>Have a look at <a href="errata54.html">The 5.4 Errata page</a> for a list
36: of bugs and workarounds.
37: <li>See a <a href="plus54.html">detailed log of changes</a> between the
38: 5.3 and 5.4 releases.
39: </ul>
1.40 deraadt 40: <p>
41: All applicable copyrights and credits are in the src.tar.gz,
42: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
1.49 ! deraadt 43: files fetched via <code>ports.tar.gz</code>.
1.46 bentley 44: </table>
1.40 deraadt 45:
46: <hr>
1.1 deraadt 47:
1.46 bentley 48: <section id=new>
49: <h3>What's New</h3>
1.1 deraadt 50: <p>
51: This is a partial list of new features and systems included in OpenBSD 5.4.
52: For a comprehensive list, see the <a href="plus54.html">changelog</a> leading
53: to 5.4.
54: <p>
55:
56: <ul>
1.29 tedu 57: <li>New/extended platforms:
1.2 bcallah 58: <ul>
59: <li><a href="octeon.html">OpenBSD/octeon</a><br>
60: New platform for systems based on the Cavium Octeon MIPS-compatible
61: processors. Supported machines include:
62: <ul>
63: <li>Portwell CAM-0100
64: <li>Ubiquiti Networks EdgeRouter LITE (no local storage)
65: </ul>
1.15 lteo 66: <li><a href="beagle.html">OpenBSD/beagle</a><br>
67: New platform for OMAP3/4 and AM335x systems using an ARM Cortex-A8 or
68: Cortex-A9 CPU. Supported boards include:
69: <ul>
70: <li>BeagleBoard C4 / xM
71: <li>BeagleBone and BeagleBone Black
72: <li>PandaBoard and PandaBoard ES
73: </ul>
1.2 bcallah 74: </ul>
75: <p>
76:
1.1 deraadt 77: <li>Improved hardware support, including:
78: <ul>
1.46 bentley 79: <li><a href="https://man.openbsd.org/inteldrm.4">inteldrm(4)</a>
1.7 jsg 80: has been overhauled, including:
81: <ul>
82: <li>Now mostly in sync with Linux 3.8.13.
83: <li>Support for Kernel Mode Setting (KMS) including support for additional output types such as DisplayPort.
84: <li>Sandy Bridge and newer parts which previously had only ShadowFB acceleration
85: now have full hardware acceleration including use of the 3D rings.
1.46 bentley 86: <li><a href="https://man.openbsd.org/wsdisplay.4">wsdisplay(4)</a> now attaches to
87: <a href="https://man.openbsd.org/inteldrm.4">inteldrm(4)</a> and providers a
1.7 jsg 88: framebuffer console.
1.18 deraadt 89: </ul>
1.46 bentley 90: <li><a href="https://man.openbsd.org/macppc/vgafb.4">vgafb(4/macppc)</a> now supports multiple virtual consoles.
91: <li>Support for Elantech touchpads version 4 (clickpad) added to <a href="https://man.openbsd.org/pms.4">pms(4)</a>.
92: <li>Fixed <a href="https://man.openbsd.org/st.4">st(4)</a> EOM handling, enabling much better Bacula support.
93: <li>Support for <a href="https://man.openbsd.org/sparc64/vdsk.4">vdsk(4)</a> disks larger than 2TB.
1.15 lteo 94: </ul>
1.1 deraadt 95: <p>
96:
97: <li>Generic network stack improvements:
98: <ul>
1.6 pascal 99: <li>Reworked checksum handling for network protocols.
1.46 bentley 100: <li><a href="https://man.openbsd.org/divert.4">divert(4)</a> now recalculates the IP and protocol checksums of reinjected packets.
1.16 krw 101: <li>No longer attempt to delete the undeletable RNF_ROOT route.
1.1 deraadt 102: </ul>
103: <p>
104:
105: <li>Routing daemons and other userland network improvements:
106: <ul>
1.46 bentley 107: <li>Support SSL inspection in <a href="https://man.openbsd.org/relayd.8">relayd(8)</a>.
108: <li>Added <a href="https://man.openbsd.org/slowcgi.8">slowcgi(8)</a>, a libevent-based FastCGI implementation.
109: <li>Enabled ECDHE support in <a href="https://man.openbsd.org/httpd.8">httpd(8)</a>.
110: <li>Do not start <a href="https://man.openbsd.org/inetd.8">inetd(8)</a> by default any more.
111: <li>Many <a href="https://man.openbsd.org/ldpd.8">ldpd(8)</a> improvements, including a speed-up of the session establishment process, support for adjacencies and targeted hellos, support for multiple addresses per interface, and more.
1.1 deraadt 112: </ul>
113: <p>
114:
1.46 bentley 115: <li><a href="https://man.openbsd.org/dhcpd.8">dhcpd(8)</a> improvements:
1.16 krw 116: <ul>
117: <li>Improved compliance with RFC 2131 strictures on client-identifiers.
118: <li>Fixed synchronization of leases.
119: <li>Replaced manual date parsing and printing with strftime and strptime.
120: <li>Explicitly label dates in leases files as being UTC dates.
121: </ul>
122:
123: <p>
124:
1.46 bentley 125: <li><a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> improvements:
1.16 krw 126: <ul>
127: <li>Delete routes added by defunct dhclient processes.
128: <li>Improved handling of client-identifier option.
129: <li>Increased ip_ttl on packets to 128, allowing more distant servers to provide leases.
130: <li>Replaced manual date parsing and printing with strftime and strptime.
131: <li>Explicitly label dates in leases files as being UTC dates.
1.21 sobrado 132: <li>Improved interactions between dhclient processes to make the most recent dhclient started the most likely to persist.
1.16 krw 133: <li>Support for static routes and classless static routes options.
134: <li>Fixed log messages to print correct addresses.
135: <li>Reduced log verbosity by emitting debug messages only when debugging.
136: <li>Eliminated unnecessary address and route churn during lease renewal by not binding leases identical to the current one.
137: </ul>
138:
139: <p>
1.1 deraadt 140:
141: <li>OpenSMTPD 5.3.3:
142: <ul>
143: <li>New features:
144: <ul>
1.17 gilles 145: <li>Add support for LMTP local deliveries
146: <li>Add SECURE and AUTH transmission types
147: <li>Add support for transparent queue compression
148: <li>helo names can now be looked up in a db(3) table
149: <li>New "error:" alias kind allows aliasing a user-part to an error
150: <li>Traces can be (de)activated at runtime
1.1 deraadt 151: </ul>
152:
153: <li>Improvements:
154: <ul>
1.17 gilles 155: <li>More robust queue can cope with runtime errors
156: <li>Improved routing strategies
157: <li>Assorted minor bug fixes and cleanups
1.1 deraadt 158: </ul>
159: </ul>
160: <p>
161:
162: <li>Performance improvements:
163: <ul>
1.13 guenther 164: <li>Don't require the kernel lock when processing audio interrupts.
165: <li>Improved kernel bcopy/memmove/memcpy implementations and made more careful choices between them.
1.46 bentley 166: <li>Implemented symbol caching and RELCOUNT/RELACOUNT optimizations in <a href="https://man.openbsd.org/ld.so.1">ld.so(1)</a>.
1.1 deraadt 167: </ul>
168: <p>
169:
170: <li>Threading improvements:
171: <ul>
1.13 guenther 172: <li>Closed various race conditions between exit/fork/execve/__tfork/__threxit/ptrace in both the kernel and libpthread.
1.1 deraadt 173: </ul>
174: <p>
175:
176: <li>Assorted improvements:
177: <ul>
1.46 bentley 178: <li>Added a <a href="https://man.openbsd.org/locale.1">locale(1)</a> utility.
179: <li>Added <a href="https://man.openbsd.org/ltrace.1">ltrace(1)</a>, a tool to trace PLT calls.
180: <li>Added a new implementation of <a href="https://man.openbsd.org/cu.1">cu(1)</a>.
181: <li>Added <a href="https://man.openbsd.org/shm_open.3">shm_open(3)/shm_unlink(3)</a>.
182: <li>Added <a href="https://man.openbsd.org/getprogname.3">getprogname(3)/setprogname(3)</a>.
183: <li>Added <a href="https://man.openbsd.org/clock_getcpuclockid.3">clock_getcpuclockid(3)</a> and
184: <a href="https://man.openbsd.org/pthread_getcpuclockid.3">pthread_getcpuclockid(3)</a>.
185: <li>Added <a href="https://man.openbsd.org/fmemopen.3">fmemopen(3)</a>.
186: <li>Added <a href="https://man.openbsd.org/open_memstream.3">open_memstream(3)/open_wmemstream(3)</a>.
187: <li>Added <a href="https://man.openbsd.org/memmem.3">memmem(3)</a>.
188: <li>Added <a href="https://man.openbsd.org/fdatasync.2">fdatasync(2)</a>.
189: <li>Added <a href="https://man.openbsd.org/ppoll.2">ppoll(2)</a>.
190: <li>Added <a href="https://man.openbsd.org/pselect.2">pselect(2)</a>.
191: <li>Added <a href="https://man.openbsd.org/utrace.2">utrace(2)</a>.
192: <li>Switched the <a href="vax.html">VAX</a> platform to <a href="https://man.openbsd.org/elf.5">ELF</a>.
1.6 pascal 193: <li>Fixed kernel profiling on multiprocessor systems.
1.46 bentley 194: <li>Experimental support for <a href="https://man.openbsd.org/fuse.4">fuse(4)</a>.
195: <li>Added support for <code>write_opt=nodir</code> and the 'path' and 'linkpath' extended headers to <a href="https://man.openbsd.org/pax.1">pax(1)</a> (aka <a href="https://man.openbsd.org/tar.1">tar(1)</a>).
196: <li>Brought <a href="https://man.openbsd.org/getconf.1">getconf(1)</a> up to date with recent POSIX updates.
197: <li>Added -L and -P options to <a href="https://man.openbsd.org/ln.1">ln(1)</a>.
198: <li>More structures and symbolic values displayed by <a href="https://man.openbsd.org/kdump.1">kdump(1)</a>.
199: <li><a href="https://man.openbsd.org/pkill.1">pkill(1)</a> now accepts an -I option to ask for confirmation on killing processes.
1.1 deraadt 200: </ul>
201: <p>
202:
203: <li>OpenSSH 6.3:
204: <ul>
205: <li>New features:
206: <ul>
1.46 bentley 207: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.1 deraadt 208: add
1.46 bentley 209: <a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>
1.1 deraadt 210: support to
1.46 bentley 211: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>;
1.1 deraadt 212: allows encrypted hostkeys, or hostkeys on smartcards.
1.46 bentley 213: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.1 deraadt 214: and
1.46 bentley 215: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.1 deraadt 216: allow optional time-based rekeying via a second argument to the
1.46 bentley 217: existing <code>RekeyLimit</code> option. <code>RekeyLimit</code> is now
1.1 deraadt 218: supported in
1.46 bentley 219: <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
1.1 deraadt 220: as well as on the client.
1.46 bentley 221: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.1 deraadt 222: standardise logging of information during user authentication.
1.46 bentley 223: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.1 deraadt 224: add the ability to query supported ciphers, MAC algorithms, key types
225: and key exchange methods.
1.46 bentley 226: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
227: support <code>ProxyCommand=-</code> to allow support cases where stdin and
1.1 deraadt 228: stdout already point to the proxy.
1.46 bentley 229: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
230: allow <code>IdentityFile=none</code>.
231: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.1 deraadt 232: and
1.46 bentley 233: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
234: add <code>-E</code> option to
235: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.1 deraadt 236: and
1.46 bentley 237: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.1 deraadt 238: to append debugging logs to a specified file instead of stderr or
239: syslog.
1.46 bentley 240: <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
241: add support for resuming partial downloads using the <code>reget</code>
1.1 deraadt 242: command and on the
1.46 bentley 243: <a href="https://man.openbsd.org/sftp.1">sftp(1)</a>
244: commandline or on the get commandline using the <code>-a</code>
1.1 deraadt 245: (append) option.
1.46 bentley 246: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
247: add an <code>IgnoreUnknown</code> configuration option to selectively
1.1 deraadt 248: suppress errors arising from unknown configuration directives.
1.46 bentley 249: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.1 deraadt 250: add support for submethods to be appended to required authentication
1.46 bentley 251: methods listed via <code>AuthenticationMethods</code>.
1.1 deraadt 252: </ul>
253: <li>The following significant bugs have been fixed in this release:
254: <ul>
1.46 bentley 255: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.1 deraadt 256: fix refusal to accept certificate if a key of a different type to the
1.46 bentley 257: CA key appeared in <code>authorized_keys</code> before the CA key.
258: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
259: <a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>
1.1 deraadt 260: and
1.46 bentley 261: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.1 deraadt 262: Use a monotonic time source for timers so that things like keepalives
263: and rekeying will work properly over clock steps.
1.46 bentley 264: <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
1.1 deraadt 265: update progressmeter when data is acknowledged, not when it's sent.
266: (bz#2108)
1.46 bentley 267: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.1 deraadt 268: and
1.46 bentley 269: <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.1 deraadt 270: improve error messages when the current user does not exist in
1.46 bentley 271: <code>/etc/passwd</code>. (bz#2125)
272: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.1 deraadt 273: reset the order in which public keys are tried after partial
274: authentication success.
1.46 bentley 275: <li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
1.1 deraadt 276: clean up socket files after SIGINT when in debug mode. (bz#2120)
1.46 bentley 277: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.1 deraadt 278: and others: avoid confusing error messages in the case of broken system
279: resolver configurations. (bz#2122)
1.46 bentley 280: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
281: set TCP nodelay for connections started with <code>-N</code>. (bz#2124)
282: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
283: correct manual for permission requirements on <code>~/.ssh/config</code>.
1.1 deraadt 284: (bz#2078)
1.46 bentley 285: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
286: fix <code>ControlPersist</code> timeout not triggering in cases where TCP
1.1 deraadt 287: connections have hung. (bz#1917)
1.46 bentley 288: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
289: properly detach a <code>ControlPersist</code> master from its controlling
1.1 deraadt 290: terminal.
1.46 bentley 291: <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
1.1 deraadt 292: avoid crashes in libedit when it has been compiled with multi-byte
293: character support. (bz#1990)
1.46 bentley 294: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
295: when running <code>sshd -D</code>, close stderr unless we have explicitly
1.1 deraadt 296: requested logging to stderr. (bz#1976)
1.46 bentley 297: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.1 deraadt 298: fix incomplete bzero. (bz#2100)
1.46 bentley 299: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
300: log and error and exit if <code>ChrootDirectory</code> is specified and
1.1 deraadt 301: running without root privileges.
302: <li>Many improvements to the regression test suite. In particular log
303: files are now saved from
1.46 bentley 304: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.1 deraadt 305: and
1.46 bentley 306: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.1 deraadt 307: after failures.
308: <li>Fix a number of memory leaks. (bz#1967, bz#2096 and others)
1.46 bentley 309: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
310: fix public key authentication when a <code>:style</code> is appended to the
1.1 deraadt 311: requested username.
1.46 bentley 312: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.1 deraadt 313: do not fatally exit when attempting to cleanup multiplexing-created
314: channels that are incompletely opened. (bz#2079)
315: </ul>
316: </ul>
317: <p>
318:
1.19 espie 319: <li>Over 7,800 ports, major stability improvements in
1.1 deraadt 320: the package build process
321: <ul>
1.19 espie 322: <li>The parallel ports builder is better at catching up errors on older
323: slower platforms, thus allowing release engineers to better concentrate on
324: real errors.
1.1 deraadt 325: </ul>
326: <p>
327: <li>Many pre-built packages for each architecture:
1.46 bentley 328: <ul style="column-count: 4">
1.10 sthen 329: <li>i386: 7976
330: <li>sparc64: 6959
331: <li>alpha: 6062
1.24 miod 332: <li>m68k: 3862
1.23 pirofti 333: <li>sh: 989
1.10 sthen 334: <li>amd64: 7941
1.11 sthen 335: <li>powerpc: 7483
1.24 miod 336: <li>m88k: 3951
1.11 sthen 337: <li>sparc: 4823
338: <li>arm: 5582
1.10 sthen 339: <li>hppa: 6607
1.12 sebastia 340: <li>vax: 2226
1.10 sthen 341: <li>mips64: 6739
342: <li>mips64el: 6306
1.46 bentley 343: </ul>
1.1 deraadt 344: <p>
345:
346: <li>Some highlights:
347: <ul>
348: <li>GNOME 3.8.3 <li>KDE 3.5.10
349: <li>Xfce 4.10 <li>MySQL 5.1.70
350: <li>PostgreSQL 9.2.4 <li>Postfix 2.10.1
351: <li>OpenLDAP 2.3.43 and 2.4.35 <li>Mozilla Firefox 3.6.28 and 22.0
352: <li>Mozilla Thunderbird 17.0.7 <li>GHC 7.6.3
353: <li>LibreOffice 4.0.4.2 <li>Emacs 21.4 and 24.3
1.5 lteo 354: <li>Vim 7.3.850 <li>PHP 5.2.17 and 5.3.27
1.1 deraadt 355: <li>Python 2.7.5 and 3.3.2 <li>Ruby 1.8.7.374, 1.9.3.448 and 2.0.0.247
1.5 lteo 356: <li>Tcl/Tk 8.4.20, 8.5.14 and 8.6.0 <li>JDK 1.6.0.32 and 1.7.0.21
1.1 deraadt 357: <li>Mono 2.10.9 <li>Chromium 28.0.1500.45
358: <li>Groff 1.22.2 <li>Go 1.1.1
359: <li>GCC 4.6.4 and 4.8.1 <li>LLVM/Clang 3.3
1.3 abieber 360: <li>Node.js 0.10.12
1.1 deraadt 361: </ul>
362: <p>
363:
364: <li>As usual, steady improvements in manual pages and other documentation.
365: <p>
366:
367: <li>The system includes the following major components from outside suppliers:
368: <ul>
369: <li>Xenocara (based on X.Org 7.7 with xserver 1.14.1 + patches,
1.4 matthieu 370: freetype 2.4.12, fontconfig 2.10.91, Mesa 7.11.2, xterm 293,
1.1 deraadt 371: xkeyboard-config 2.7 and more)
1.22 nick 372: <li>Gcc 4.2.1 (+patches), 3.3.6 (+ patches) and 2.95.3 (+ patches)
1.1 deraadt 373: <li>Perl 5.16.3 (+ patches)
374: <li>Our improved and secured version of Apache 1.3, with
375: SSL/TLS and DSO support
376: <li>Nginx 1.4.1 (+ patches)
377: <li>OpenSSL 1.0.1c (+ patches)
378: <li>SQLite 3.7.17 (+ patches)
379: <li>Sendmail 8.14.7, with libmilter
380: <li>Bind 9.4.2-P2 (+ patches)
381: <li>NSD 3.2.15
382: <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
383: <li>Sudo 1.7.2p8
384: <li>Ncurses 5.7
385: <li>Heimdal 1.5.2 (+ patches)
386: <li>Binutils 2.15 (+ patches)
387: <li>Gdb 6.3 (+ patches)
388: <li>Less 444 (+ patches)
389: <li>Awk Aug 10, 2011 version
390: </ul>
391: </ul>
1.46 bentley 392: </section>
1.1 deraadt 393:
394: <hr>
1.46 bentley 395:
396: <section id=install>
397: <h3>How to install</h3>
1.1 deraadt 398: <p>
399: Following this are the instructions which you would have on a piece of
400: paper if you had purchased a CDROM set instead of doing an alternate
401: form of install. The instructions for doing an FTP (or other style
402: of) install are very similar; the CDROM instructions are left intact
403: so that you can see how much easier it would have been if you had
404: purchased a CDROM instead.
405: <p>
406:
407: <hr>
408: Please refer to the following files on the three CDROMs or FTP mirror for
409: extensive details on how to install OpenBSD 5.4 on your machine:
410: <p>
411: <ul>
1.47 deraadt 412: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/i386/INSTALL.i386">
413: .../OpenBSD/5.4/i386/INSTALL.i386 (on CD1)</a>
1.1 deraadt 414: <p>
1.47 deraadt 415: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/amd64/INSTALL.amd64">
416: .../OpenBSD/5.4/amd64/INSTALL.amd64 (on CD2)</a>
1.1 deraadt 417: <p>
1.47 deraadt 418: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/sparc64/INSTALL.sparc64">
419: .../OpenBSD/5.4/sparc64/INSTALL.sparc64 (on CD3)</a>
1.1 deraadt 420: <p>
1.47 deraadt 421: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/alpha/INSTALL.alpha">
422: .../OpenBSD/5.4/alpha/INSTALL.alpha</a>
423: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/armish/INSTALL.armish">
424: .../OpenBSD/5.4/armish/INSTALL.armish</a>
425: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/beagle/INSTALL.beagle">
426: .../OpenBSD/5.4/beagle/INSTALL.beagle</a>
427: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/hp300/INSTALL.hp300">
428: .../OpenBSD/5.4/hp300/INSTALL.hp300</a>
429: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/hppa/INSTALL.hppa">
430: .../OpenBSD/5.4/hppa/INSTALL.hppa</a>
431: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/landisk/INSTALL.landisk">
432: .../OpenBSD/5.4/landisk/INSTALL.landisk</a>
433: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/loongson/INSTALL.loongson">
434: .../OpenBSD/5.4/loongson/INSTALL.loongson</a>
435: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/luna88k/INSTALL.luna88k">
436: .../OpenBSD/5.4/luna88k/INSTALL.luna88k</a>
437: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/macppc/INSTALL.macppc">
438: .../OpenBSD/5.4/macppc/INSTALL.macppc</a>
439: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/mvme68k/INSTALL.mvme68k">
440: .../OpenBSD/5.4/mvme68k/INSTALL.mvme68k</a>
441: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/mvme88k/INSTALL.mvme88k">
442: .../OpenBSD/5.4/mvme88k/INSTALL.mvme88k</a>
443: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/octeon/INSTALL.octeon">
444: .../OpenBSD/5.4/octeon/INSTALL.octeon</a>
445: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/sgi/INSTALL.sgi">
446: .../OpenBSD/5.4/sgi/INSTALL.sgi</a>
447: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/socppc/INSTALL.socppc">
448: .../OpenBSD/5.4/socppc/INSTALL.socppc</a>
449: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/sparc/INSTALL.sparc">
450: .../OpenBSD/5.4/sparc/INSTALL.sparc</a>
451: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/vax/INSTALL.vax">
452: .../OpenBSD/5.4/vax/INSTALL.vax</a>
453: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/zaurus/INSTALL.zaurus">
454: .../OpenBSD/5.4/zaurus/INSTALL.zaurus</a>
1.1 deraadt 455: </ul>
1.47 deraadt 456: </section>
457:
1.1 deraadt 458: <hr>
459:
1.46 bentley 460: <section id=quickinstall>
461:
1.1 deraadt 462: <p>
463: Quick installer information for people familiar with OpenBSD, and the
464: use of the "disklabel -E" command. If you are at all confused when
465: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.46 bentley 466:
467: <h3>OpenBSD/i386:</h3>
468:
1.1 deraadt 469: <p>
470: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
471: release is on CD1. If your BIOS does not support booting from CD, you will need
472: to create a boot floppy to install from. To create a boot floppy write
473: <i>CD1:5.4/i386/floppy54.fs</i> to a floppy and boot via the floppy drive.
474:
475: <p>
476: Use <i>CD1:5.4/i386/floppyB54.fs</i> instead for greater SCSI controller
477: support, or <i>CD1:5.4/i386/floppyC54.fs</i> for better laptop support.
478:
479: <p>
480: If you can't boot from a CD or a floppy disk,
481: you can install across the network using PXE as described in
482: the included INSTALL.i386 document.
483:
484: <p>
485: If you are planning on dual booting OpenBSD with another OS, you will need to
486: read INSTALL.i386.
487:
488: <p>
489: To make a boot floppy under MS-DOS, use the "rawrite" utility located
490: at <i>CD1:5.4/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
491: use the
1.46 bentley 492: <a href="https://man.openbsd.org/dd.1">dd(1)</a>
1.1 deraadt 493: utility. The following is an example usage of
1.46 bentley 494: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.1 deraadt 495: where the device could be "floppy", "rfd0c", or
496: "rfd0a".
497:
1.46 bentley 498: <blockquote><pre>
1.47 deraadt 499: # <kbd>dd if=<file> of=/dev/<device> bs=32k</kbd>
1.46 bentley 500: </pre></blockquote>
1.1 deraadt 501:
502: <p>
503: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
504: your install will most likely fail. For more information on creating a boot
505: floppy and installing OpenBSD/i386 please refer to
1.41 tj 506: <a href="faq/faq4.html#MkFlop">this page</a>.
1.46 bentley 507:
508: <h3>OpenBSD/amd64:</h3>
1.1 deraadt 509:
510: <p>
511: The 5.4 release of OpenBSD/amd64 is located on CD2.
512: Boot from the CD to begin the install - you may need to adjust
513: your BIOS options first.
514: If you can't boot from the CD, you can create a boot floppy to install from.
515: To do this, write <i>CD2:5.4/amd64/floppy54.fs</i> to a floppy, then
516: boot from the floppy drive.
517:
518: <p>
519: If you can't boot from a CD or a floppy disk,
520: you can install across the network using PXE as described in the included
521: INSTALL.amd64 document.
522:
523: <p>
524: If you are planning to dual boot OpenBSD with another OS, you will need to
525: read INSTALL.amd64.
1.46 bentley 526:
527: <h3>OpenBSD/macppc:</h3>
1.1 deraadt 528:
529: <p>
1.9 martin 530: Burn the image from the FTP site to a CDROM, and power on your machine
1.1 deraadt 531: while holding down the <i>C</i> key until the display turns on and
532: shows <i>OpenBSD/macppc boot</i>.
533:
534: <p>
535: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
536: /5.4/macppc/bsd.rd</i>
1.46 bentley 537:
538: <h3>OpenBSD/sparc64:</h3>
1.1 deraadt 539:
540: <p>
541: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
542:
543: <p>
544: If this doesn't work, or if you don't have a CDROM drive, you can write
545: <i>CD3:5.4/sparc64/floppy54.fs</i> or <i>CD3:5.4/sparc64/floppyB54.fs</i>
546: (depending on your machine) to a floppy and boot it with <i>boot
547: floppy</i>. Refer to INSTALL.sparc64 for details.
548:
549: <p>
550: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
551: will most likely fail.
552:
553: <p>
554: You can also write <i>CD3:5.4/sparc64/miniroot54.fs</i> to the swap partition on
555: the disk and boot with <i>boot disk:b</i>.
556:
557: <p>
558: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.46 bentley 559:
560: <h3>OpenBSD/alpha:</h3>
1.1 deraadt 561:
562: <p>
1.47 deraadt 563: Write <i>5.4/alpha/floppy54.fs</i> or
564: <i>5.4/alpha/floppyB54.fs</i> (depending on your machine) to a diskette and
1.1 deraadt 565: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
566:
567: <p>
568: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
569: will most likely fail.
570:
1.46 bentley 571: <h3>OpenBSD/armish:</h3>
1.1 deraadt 572:
573: <p>
574: After connecting a serial port, Thecus can boot directly from the network
575: either tftp or http. Configure the network using fconfig, reset,
576: then load bsd.rd, see INSTALL.armish for specific details.
577: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
578: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
579: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
580: More details are available in INSTALL.armish.
1.46 bentley 581:
582: <h3>OpenBSD/hp300:</h3>
1.1 deraadt 583:
584: <p>
585: Boot over the network by following the instructions in INSTALL.hp300.
586:
1.46 bentley 587: <h3>OpenBSD/hppa:</h3>
588:
1.1 deraadt 589: <p>
590: Boot over the network by following the instructions in INSTALL.hppa or the
591: <a href="hppa.html#install">hppa platform page</a>.
592:
1.46 bentley 593: <h3>OpenBSD/landisk:</h3>
594:
1.1 deraadt 595: <p>
596: Write <i>miniroot54.fs</i> to the start of the CF
597: or disk, and boot normally.
1.46 bentley 598:
599: <h3>OpenBSD/loongson:</h3>
1.1 deraadt 600:
601: <p>
602: Write <i>miniroot54.fs</i> to a USB stick and boot bsd.rd from it
603: or boot bsd.rd via tftp.
604: Refer to the instructions in INSTALL.loongson for more details.
1.46 bentley 605:
606: <h3>OpenBSD/luna88k:</h3>
1.1 deraadt 607:
608: <p>
609: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
610: Alternatively, you can create a bootable tape and boot from it. Refer to
611: the instructions in INSTALL.luna88k for more details.
1.46 bentley 612:
613: <h3>OpenBSD/mvme68k:</h3>
1.1 deraadt 614:
615: <p>
616: You can create a bootable installation tape or boot over the network.<br>
617: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
618: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
619: for more details.
1.46 bentley 620:
621: <h3>OpenBSD/mvme88k:</h3>
1.1 deraadt 622:
623: <p>
624: You can create a bootable installation tape or boot over the network.<br>
625: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
626: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
627: for more details.
628:
1.46 bentley 629: <h3>OpenBSD/octeon:</h3>
630:
1.1 deraadt 631: <p>
1.2 bcallah 632: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
633: Refer to the instructions in INSTALL.octeon for more details.
1.1 deraadt 634:
1.46 bentley 635: <h3>OpenBSD/sgi:</h3>
636:
1.1 deraadt 637: <p>
638: To install on an O2, burn cd54.iso on a CD-R, put it in the CD drive of your
639: machine and select <i>Install System Software</i> from the System Maintenance
640: menu.
641:
642: <p>
643: On other systems, or if your machine doesn't have a CD drive, you can
644: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
645: the kernel matching your system type.
646: Refer to the instructions in INSTALL.sgi for more details.
1.46 bentley 647:
648: <h3>OpenBSD/socppc:</h3>
1.1 deraadt 649:
650: <p>
651: After connecting a serial port, boot over the network via DHCP/tftp.
652: Refer to the instructions in INSTALL.socppc for more details.
1.46 bentley 653:
654: <h3>OpenBSD/sparc:</h3>
1.1 deraadt 655:
656: <p>
657: Boot from one of the provided install ISO images, using one of the two
658: commands listed below, depending on the version of your ROM.
659:
1.46 bentley 660: <blockquote><pre>
661: ok <kbd>boot cdrom 5.4/sparc/bsd.rd</kbd>
1.1 deraadt 662: or
1.46 bentley 663: > <kbd>b sd(0,6,0)5.4/sparc/bsd.rd</kbd>
664: </pre></blockquote>
1.1 deraadt 665:
666: <p>
667: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
668: To do so you need to write <i>floppy54.fs</i> to a floppy.
1.41 tj 669: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.1 deraadt 670: To boot from the floppy use one of the two commands listed below,
671: depending on the version of your ROM.
672:
1.46 bentley 673: <blockquote><pre>
674: ok <kbd>boot floppy</kbd>
1.1 deraadt 675: or
1.46 bentley 676: > <kbd>b fd()</kbd>
677: </pre></blockquote>
1.1 deraadt 678:
679: <p>
680: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
681: will most likely fail.
682:
683: <p>
684: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
685: setup a bootable tape, or install via network, as told in the
686: INSTALL.sparc file.
1.46 bentley 687:
688: <h3>OpenBSD/vax:</h3>
1.1 deraadt 689:
690: <p>
691: Boot over the network via mopbooting as described in INSTALL.vax.
692:
1.46 bentley 693: <h3>OpenBSD/zaurus:</h3>
694:
1.1 deraadt 695: <p>
696: Using the Linux built-in graphical ipkg installer, install the
697: openbsd54_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
698: for a few important details.
1.47 deraadt 699: </section>
1.46 bentley 700:
1.47 deraadt 701: <hr>
1.46 bentley 702:
703: <section id=sourcecode>
1.47 deraadt 704: <h3>Notes about the source code</h3>
1.1 deraadt 705: <p>
1.49 ! deraadt 706: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
! 707: This file contains everything you need except for the kernel sources, which are
1.1 deraadt 708: in a separate archive. To extract:
1.46 bentley 709:
710: <blockquote><pre>
711: # <kbd>mkdir -p /usr/src</kbd>
712: # <kbd>cd /usr/src</kbd>
713: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
714: </pre></blockquote>
715:
1.1 deraadt 716: <p>
1.49 ! deraadt 717: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
1.1 deraadt 718: This file contains all the kernel sources you need to rebuild kernels.
719: To extract:
1.46 bentley 720:
721: <blockquote><pre>
722: # <kbd>mkdir -p /usr/src/sys</kbd>
723: # <kbd>cd /usr/src</kbd>
1.47 deraadt 724: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
1.46 bentley 725: </pre></blockquote>
726:
1.1 deraadt 727: <p>
728: Both of these trees are a regular CVS checkout. Using these trees it
729: is possible to get a head-start on using the anoncvs servers as
730: described <a href="anoncvs.html">here</a>.
731: Using these files
732: results in a much faster initial CVS update than you could expect from
733: a fresh checkout of the full OpenBSD source tree.
1.46 bentley 734: </section>
735:
1.1 deraadt 736: <hr>
1.46 bentley 737:
738: <section id=upgrade>
739: <h3>How to upgrade</h3>
1.1 deraadt 740: <p>
741: If you already have an OpenBSD 5.3 system, and do not want to reinstall,
742: upgrade instructions and advice can be found in the
743: <a href="faq/upgrade54.html">Upgrade Guide</a>.
1.46 bentley 744: </section>
1.1 deraadt 745:
746: <hr>
1.46 bentley 747:
748: <section id=ports>
749: <h3>Ports Tree</h3>
1.1 deraadt 750: <p>
751: A ports tree archive is also provided. To extract:
1.46 bentley 752: <blockquote><pre>
753: # <kbd>cd /usr</kbd>
754: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
755: </pre></blockquote>
1.1 deraadt 756: <p>
757: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
758: read the <a href="faq/ports/index.html">ports</a> page
759: if you know nothing about ports
760: at this point. This text is not a manual of how to use ports.
761: Rather, it is a set of notes meant to kickstart the user on the
762: OpenBSD ports system.
763: <p>
764: The <i>ports/</i> directory represents a CVS (see the manpage for
1.48 bentley 765: <a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
1.1 deraadt 766: you aren't familiar with CVS) checkout of our ports. As with our complete
767: source tree, our ports tree is available via
768: <a href="anoncvs.html">AnonCVS</a>.
769: So, in order to keep current with it, you must make the <i>ports/</i> tree
770: available on a read-write medium and update the tree with a command
771: like:
1.46 bentley 772: <blockquote><pre>
1.47 deraadt 773: # <kbd>cd /usr/ports</kbd>
774: # <kbd>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_4</kbd>
1.46 bentley 775: </pre></blockquote>
1.1 deraadt 776: <p>
777: [Of course, you must replace the server name here with a nearby anoncvs
778: server.]
779: <p>
1.47 deraadt 780: Note that most ports are available as packages on our mirrors. Updated
1.1 deraadt 781: packages for the 5.4 release will be made available if problems arise.
782: <p>
783: If you're interested in seeing a port added, would like to help out, or just
784: would like to know more, the mailing list
785: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.46 bentley 786: </section>