Annotation of www/55.html, Revision 1.51
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
1.14 deraadt 4: <title>OpenBSD 5.5</title>
1.1 deraadt 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.5">
8: <meta name="keywords" content="openbsd,main">
9: <meta name="distribution" content="global">
10: <meta name="copyright" content="This document copyright 2013 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>
1.33 deraadt 17: <p>
1.1 deraadt 18:
1.22 deraadt 19: <a href="images/McFishy.jpg">
20: <img align="left" width="227" height="343" hspace="24" src="images/McFishy.jpg"></a>
1.14 deraadt 21: <h2><font color="#0000e0">OpenBSD 5.5</font></h2>
1.1 deraadt 22: <p>
1.14 deraadt 23: To be released May 1, 2014<br>
1.1 deraadt 24: Copyright 1997-2014, Theo de Raadt.<br>
25: <font color="#e00000">ISBN 978-0-9881561-3-5</font>
26: <br>
27: <a href="lyrics.html#55">5.5 Song: "Wrap in Time"</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.5/</font> directory on
35: one of the mirror sites.
36: <li>Briefly read the rest of this document.
37: <li>Have a look at <a href="errata55.html">The 5.5 Errata page</a> for a list
38: of bugs and workarounds.
39: <li>See a <a href="plus55.html">detailed log of changes</a> between the
40: 5.4 and 5.5 releases.
41: </ul>
42: <br clear=all>
1.14 deraadt 43: <p>
44: All applicable copyrights and credits can be found in the applicable
45: file sources found in the files src.tar.gz, sys.tar.gz,
46: xenocara.tar.gz, or in the files fetched via ports.tar.gz. The
47: distribution files used to build packages from the ports.tar.gz file
48: are not included on the CDROM because of lack of space.
1.1 deraadt 49: <p>
50:
51: <a name="new"></a>
52: <hr>
53: <p>
54: <h3><font color="#0000e0">What's New</font></h3>
55: <p>
56: This is a partial list of new features and systems included in OpenBSD 5.5.
57: For a comprehensive list, see the <a href="plus55.html">changelog</a> leading
58: to 5.5.
59: <p>
60:
61: <ul>
1.45 brynet 62: <li>time_t is now 64 bits on all platforms.
1.24 guenther 63: While many filesystems are limited to 32 bits and thus cannot be
64: used to store times after Tue Jan 19 03:14:07 2038 UTC,
65: most system operations can now support times after that.
1.46 lteo 66: <p>
67:
1.15 tedu 68: <li>Releases and packages are now cryptographically signed with the
1.10 tedu 69: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1">signify(1)</a> utility.
1.46 lteo 70: <ul>
71: <li>The installer will verify all sets before installing.
72: <li>Installing without verification works, but is discouraged.
73: <li>Users are advised to verify the installer (bsd.rd, install55.iso, etc.)
74: ahead of time using the
75: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1#end">signify(1)</a> tool if available.
76: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pkg_add&sektion=1">pkg_add(1)</a> now trusts signed packages only by default.
77: </ul>
78: <p>
79:
1.47 lteo 80: <li>Installer improvements:
81: <ul>
82: <li>The installer now supports a scriptable
83: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=autoinstall&sektion=8">auto-installation</a>
84: method that enables unattended installation and upgrades using a response file.
1.48 deraadt 85: <li>Disk images which can be written to a USB flash drive
86: (miniroot55.fs [bsd.rd only] and install55.fs [bsd.rd + unsigned sets])
87: are now provided for amd64 and i386.
1.47 lteo 88: <li>Rewritten
89: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=installboot&sektion=8">installboot(8)</a>
90: utility aiming for a unified implementation across platforms (currently
91: used by amd64 and i386 only).
92: <li>The installer now parses nwid's with embedded blanks correctly.
93: </ul>
1.10 tedu 94: <p>
95:
1.8 tedu 96: <li>New/extended platforms:
1.1 deraadt 97: <ul>
1.32 miod 98: <li><a href="alpha.html">OpenBSD/alpha</a>:
99: <ul>
100: <li>Multiprocessor support.
101: </ul>
102: <li><a href="aviion.html">OpenBSD/aviion</a>:
103: <ul>
104: <li>First self-hosting release for 88100-based AViiON systems.
105: </ul>
1.39 lteo 106: <li><a href="armv7.html">OpenBSD/armv7</a> replaces OpenBSD/beagle.
1.1 deraadt 107: </ul>
108: <p>
109:
110: <li>Improved hardware support, including:
111: <ul>
1.5 jsg 112: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vmx&sektion=4">vmx(4)</a>
113: driver for VMware VMXNET3 Virtual Interface Controller devices.
114: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vmwpvs&sektion=4">vmwpvs(4)</a>
115: driver for VMware Paravirtual SCSI.
116: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vioscsi&sektion=4">vioscsi(4)</a>
117: driver for VirtIO SCSI adapters.
118: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=viornd&sektion=4">viornd(4)</a>
119: driver for VirtIO random number devices.
120: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ubcmtp&sektion=4">ubcmtp(4)</a>
1.50 lteo 121: driver for Broadcom multi-touch trackpads found on newer Apple MacBook,
122: MacBook Pro, and MacBook Air laptops.
1.5 jsg 123: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ugold&sektion=4">ugold(4)</a>
124: driver for TEMPer gold HID thermometers.
125: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ugl&sektion=4">ugl(4)</a>
126: driver for Genesys Logic based USB host-to-host adapters.
1.41 stsp 127: <li> New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=qla&sektion=4">qla(4)</a> driver for Qlogic fibre channel HBAs.
1.5 jsg 128: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=radeondrm&sektion=4">radeondrm(4)</a>
129: has been overhauled, including:
130: <ul>
131: <li>New port of the Radeon code in Linux 3.8.13.19.
132: <li>Support for Kernel Mode Setting (KMS) including support for
133: additional output types such as DisplayPort.
134: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wsdisplay&sektion=4">wsdisplay(4)</a>
135: now attaches to
136: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=radeondrm&sektion=4">radeondrm(4)</a>
137: and provides a framebuffer console.
138: </ul>
139: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=inteldrm&sektion=4">inteldrm(4)</a>
1.20 sthen 140: has been updated to Linux 3.8.13.19 notably bringing Haswell stability fixes.
1.5 jsg 141: <li>Support for Intel 8 Series Ethernet with i217/i218 PHYs, and
142: i210/i211/i354 has been added to
143: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=em&sektion=4">em(4)</a>.
144: <li>Support for Intel Centrino Wireless-N 2200, 2230 and 105/135 has been added to
145: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iwn&sektion=4">iwn(4)</a>.
1.28 chris 146: <li>Support for Areca ARC-1880, ARC-1882, ARC-1883, ARC-1223, ARC-1214, ARC-1264, ARC-1284 has been added to
147: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=arc&sektion=4">arc(4)</a>.
1.41 stsp 148: <li>Support for Elantech v2 touchpads in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pms&sektion=4">pms(4)</a> has been fixed.
149: <li>Support for 802.11a (5Ghz) has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wpi&sektion=4">wpi(4)</a>.
150: <li>Workarounds for firmware stability issues have been added to
151: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wpi&sektion=4">wpi(4)</a>,
152: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iwi&sektion=4">iwi(4)</a>, and
153: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iwn&sektion=4">iwn(4)</a>.
154: <li>Support for RT3572 chips has been added to the
155: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ral&sektion=4">ral(4)</a> driver.
1.43 brad 156: <li>Support for RTL8106E chips has been added to the
1.41 stsp 157: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=re&sektion=4">re(4)</a> driver.
158: <li>Support for RTS5229 card readers has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=rtsx&sektion=4">rtsx(4)</a>.
159: <li>Support for Microsoft XBox 360 controllers has been added to the <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=uhid&sektion=4">uhid(4)</a> driver.
160: <li>Support for CoreChip RD9700 USB Ethernet devices has been added to the <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=udav&sektion=4">udav(4)</a> driver.
1.38 deraadt 161: <li>Further reliability improvements regarding suspend/resume and hibernation.
1.50 lteo 162: <li>Enabled IPv6 transmit TCP/UDP checksum offload in
163: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=jme&sektion=4">jme(4)</a>.
1.1 deraadt 164: </ul>
165: <p>
166:
167: <li>Generic network stack improvements:
168: <ul>
1.17 jsg 169: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vxlan&sektion=4">vxlan(4)</a>
170: a virtual extensible local area network tunnel interface.
1.19 florian 171: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pflow&sektion=4">pflow(4)</a>
172: sends 64 bit time values for pflowproto 10. The changed templates /
173: flows for pflowproto 10 are now parseable by existing receivers.
1.34 lteo 174: <li>Continued improvement of the checksum offload framework to streamline
175: the calculation of TCP, UDP, ICMP, and ICMPv6 checksums.
1.50 lteo 176: <li>Enabled IPv6 routing domain support.
1.1 deraadt 177: </ul>
178: <p>
179:
180: <li>Routing daemons and other userland network improvements:
181: <ul>
1.13 tedu 182: <li>The popa3d POP3 server has been removed.
1.17 jsg 183: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ntpctl&sektion=8">ntpctl(8)</a>
184: a program to control the Network Time Protocol daemon.
1.19 florian 185: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=slowcgi&sektion=8">slowcgi(8)</a>
186: now works with a high number of concurrent connections.
1.39 lteo 187: <li>The inetd-based identd has been replaced by a new libevent-based
188: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=identd&sektion=8">identd(8)</a>.
189: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcpdump&sektion=8">tcpdump(8)</a>
190: can now detect bad ICMP and ICMPv6 checksums when used with the -v flag.
1.50 lteo 191: <li>Added rdomain support to IPv6 configuration tools
192: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ndp&sektion=8">ndp(8)</a>,
193: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=rtsold&sektion=8">rtsold(8)</a>,
194: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ping6&sektion=8">ping6(8)</a>, and
195: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=traceroute6&sektion=8">traceroute6(8)</a>.
1.1 deraadt 196: </ul>
197: <p>
198:
1.34 lteo 199: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf&sektion=4">pf(4)</a> improvements:
200: <ul>
201: <li>New queueing system with new syntax.
202: <li>The "received-on" parameter can now be used with the "any" keyword to
203: match any existing interface except loopback ones.
1.36 lteo 204: <li>The block policy in the default <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf.conf&sektion=5">pf.conf(5)</a> is now "block return".
1.34 lteo 205: </ul>
206: <p>
207:
1.7 deraadt 208: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> improvements:
1.1 deraadt 209: <ul>
1.30 krw 210: <li>no longer create a route to the bound address via 127.0.0.1.
1.42 rpe 211: <li>the options 'dhcp-lease-time', 'dhcp-rebinding-time', and 'dhcp-renewal-time' can now be configured in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&sektion=5">dhclient.conf(5)</a>.
1.30 krw 212: <li>'next-server' (a.k.a. siaddr) info now saved in lease files.
213: <li>fall back to broadcasting when unicast renewal fails, as specified in
214: RFC 2131 and friends.
215: <li>fix various problems in communications between privileged and non-privileged processes.
216: <li>fix many abuses of memcpy.
217: <li>stop pretending we still support FDDI or token ring hardware types.
218: <li>fix classless static routes option handling and add syntax to parse human readable forms.
1.42 rpe 219: <li>fix 'effective' lease created by '-L' to have correct address, 'next_server', 'timestamp', and 'resolv_conf' fields.
1.30 krw 220: <li>fix handling of non-printable characters in lease file strings.
221: <li>fix many edge cases in config file and lease parsing and ensure error messages refer to correct position in erroneous line.
222: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&sektion=5">dhclient.conf(5)</a> can now override anything in an offer or saved lease when creating the effective lease, in particular 'fixed-address', 'next-server', 'filename' and 'server-name'.
223: <li>fix parsing of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&sektion=5">dhclient.conf(5)</a> statements 'fixed-address' and
224: 'next-server'.
225: <li>log failures to fchmod() or fchown() files being written.
226: <li>create lease files with permissions 0640.
227: <li>fix possible failure to write <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=resolv.conf&sektion=5">resolv.conf(5)</a> when -L is used.
1.42 rpe 228: <li>'send dhcp-client-identifier "";' in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&sektion=5">dhclient.conf(5)</a> will result in no 'dhcp-client-identifier' (option 61) being sent.
1.1 deraadt 229: </ul>
230: <p>
231:
1.17 jsg 232: <li>OpenSMTPD 5.4.2:
1.1 deraadt 233: <ul>
234: <li>...
235: </ul>
236: <p>
237:
1.16 jsg 238: <li>Security improvements:
239: <ul>
1.23 deraadt 240: <li>Position-independent executables (PIE) are now used by default on i386.
1.17 jsg 241: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=arc4random&sektion=3">arc4random(3)</a>
242: functions now use the ChaCha20 cipher.
1.18 tedu 243: <li>The kernel random number system is initially seeded by the bootloader,
244: providing better random very early.
1.38 deraadt 245: <li>Kernel stack protector is also seeded via the same mechanism, providing
246: protection earlier.
1.17 jsg 247: <li>-Wbounded is now enabled in GCC by default.
248: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=explicit_bzero&sektion=3">explicit_bzero(3)</a>.
1.16 jsg 249: </ul>
250: <p>
251:
1.1 deraadt 252: <li>Performance improvements:
253: <ul>
1.11 tedu 254: <li>Relations between the buffer cache and swap daemon have been improved.
1.1 deraadt 255: </ul>
256: <p>
257:
258: <li>Threading improvements:
259: <ul>
1.12 tedu 260: <li>Interprocess semaphores via <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sem_open&sektion=3">sem_open(3)</a>.
1.26 guenther 261: <li>Running threaded processes under a debugger no longer causes panics.
262: <li>SIGPROF and SIGVTALRM are now reliably delivered to the thread that was running when they were triggered.
263: <li>Thread stacks now have a random bias.
1.45 brynet 264: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fork&sektion=2">fork(2)</a> no longer changes the pthread_t of the forking thread in the child.
1.26 guenther 265: <li>Signaling races eliminated from <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_kill&sektion=3">pthread_kill(3)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_cancel&sektion=3">pthread_cancel(3)</a>.
1.1 deraadt 266: </ul>
267: <p>
268:
269: <li>Assorted improvements:
270: <ul>
1.29 deraadt 271: <li>New in-memory file system, <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mount_tmpfs&sektion=8">tmpfs</a>.
1.37 sobrado 272: <li>Many <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fuse&sektion=4">fuse(4)</a> improvements and stability fixes.
1.29 deraadt 273: <li>Added POSIX required <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nl&sektion=1">nl(1)</a> utility.
1.16 jsg 274: <li>OpenBSD/vax has switched to GCC 3.
1.26 guenther 275: <li>Replaced <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getdirentries&sektion=2&manpath=OpenBSD+5.4">getdirentries(2)</a> with <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getdents&sektion=2">getdents(2)</a>, vastly improving the performance and memory usage of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=telldir&sektion=3">telldir(3)</a>.
276: <li>amd64 and i386 now use the MWAIT instruction for their idle loop where available to reduce latency.
1.29 deraadt 277: <li>Added support for CLOCK_UPTIME.
1.26 guenther 278: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcgetsid&sektion=3">tcgetsid(3)</a>.
1.45 brynet 279: <li>clock_t is now a 64 bit type, so it no longer wraps around in only 248 days.
280: <li>ino_t is now a 64 bit type, mostly to support large NFS filesystems.
1.26 guenther 281: <li>Corrected handling of UTIME_OMIT.
1.37 sobrado 282: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pax&sektion=1">pax(1)</a> now sets the mode and timestamps correctly on symlinks, and makes hardlinks to symlinks when requested.
1.50 lteo 283: <li>Corrected handling of shared-library destructors when libc is statically linked.
1.31 krw 284: <li>Corrected various disk drivers to handle non-512-byte sectors and disk sizes greater than 32-bits.
285: <li>Corrected <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=growfs&sektion=8">growfs(8)</a> to handle non-512-byte sectors and disk sizes greater than 32-bits.
286: <li>All CIRCLEQ uses replaced with TAILQ.
287: <li>Preserve and honour changes to the OpenBSD bounds in a disklabel.
288: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fdisk&sektion=8">fdisk(8)</a> now always writes a good signature when MBR is written to disk.
289: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sektion=8">disklabel(8)</a> now writes the disklabel to the correct location on non-512-byte sector devices.
290: <li>Fix <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=athn&sektion=4">athn(4)</a> tick calculations to eliminate excessive timeouts.
291: <li>Allow <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sektion=8">disklabel(8)</a> to set any partition, including 'C', to type UNUSED.
1.34 lteo 292: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sha512&sektion=1">sha512(1)</a> tool to calculate and verify the SHA-512 checksums of files.
293: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sha256&sektion=1">sha256(1)</a> and related tools
294: (<a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cksum&sektion=1">cksum(1)</a>,
295: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=md5&sektion=1">md5(1)</a>,
296: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sha1&sektion=1">sha1(1)</a>, and
297: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sha512&sektion=1">sha512(1)</a>)
298: now support a new -h flag to place the checksum into a specified hash file instead of stdout.
299: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sha256&sektion=1">sha256(1)</a> and related tools now support a new -C flag that allows the verification of selected files in a checklist.
300: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sha256&sektion=1">sha256(1)</a> and related tools will now print MISSING if they encounter non-existent files in a checklist.
1.40 stsp 301: <li>i386 and amd64 platforms can now boot from keydisk-based <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=softraid&sektion=4">softraid(4)</a> crypto volumes.
302: <li>Allow <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=softraid&sektion=4">softraid(4)</a> to work with partitions larger than 2TB.
303: <li>Removed experimental RAID 4 support from <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=softraid&sektion=4">softraid(4)</a>.
304: <li>Added experimental support for rebuilding RAID 5 <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=softraid&sektion=4">softraid(4)</a> volumes. Lots of testing is still required and there is missing functionality, such as the ability to resume a partially completed rebuild. <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bioctl&sektion=8">bioctl(8)</a> refuses to create RAID 5 volumes unless recompiled with -DRAID5.
1.50 lteo 305: <li>The uhts(4) driver has been merged into
1.41 stsp 306: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ums&sektion=4">ums(4)</a>.
1.1 deraadt 307: </ul>
308: <p>
309:
1.3 sobrado 310: <li>OpenSSH 6.6 (including changes to 6.5, a feature-focused release):
1.1 deraadt 311: <ul>
1.3 sobrado 312: <li>Security:
1.1 deraadt 313: <ul>
1.3 sobrado 314: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
315: when using environment passing with a
316: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>
317: <tt>AcceptEnv</tt> pattern with a wildcard. OpenSSH prior to 6.6 could
318: be tricked into accepting any enviornment variable that contains the
319: characters before the wildcard character.
320: </ul>
321: <li>New/changed features:
322: <ul>
323: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
324: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
325: Add support for key exchange using <i>elliptic-curve Diffie Hellman</i>
326: in Daniel Bernstein's <i>Curve25519</i>. This key exchange method is
327: the default when both the client and server support it.
328: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
329: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
330: Add support for <i>ED25519</i> as a public key type. ED25519 is
331: a elliptic curve signature scheme that offers better security than
332: <i>ECDSA</i> and <i>DSA</i> and good performance. It may be used for
333: both <i>user</i> and <i>host</i> keys.
334: <li>Add a new private key format that uses a <i>bcrypt KDF</i> to better
335: protect keys at rest. This format is used unconditionally for
336: ED25519 keys, but may be requested when generating or saving
337: existing keys of other types via the <tt>-o</tt>
338: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>
339: option. We intend to make the new format the default in the near
340: future. Details of the new format are in the <tt>PROTOCOL.key</tt>
341: file.
342: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
343: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
344: Add a new transport cipher "chacha20-poly1305@openssh.com" that
345: combines Daniel Bernstein's <i>ChaCha20</i> stream cipher and
346: <i>Poly1305 MAC</i> to build an authenticated encryption mode. Details
347: are in the <tt>PROTOCOL.chacha20poly1305</tt> file.
348: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
349: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
350: Refuse <i>RSA</i> keys from old proprietary clients and servers that
351: use the obsolete <i>RSA+MD5</i> signature scheme. It will still be
352: possible to connect with these clients/servers but <b>only DSA keys
353: will be accepted, and OpenSSH will refuse connection entirely in a
354: future release</b>.
355: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
356: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
357: Refuse old proprietary clients and servers that use a weaker key
358: exchange hash calculation.
359: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
360: Increase the size of the <i>Diffie-Hellman groups</i> requested for
361: each symmetric key size. New values from <i>NIST Special Publication
362: 800-57</i> with the upper limit specified by <i>RFC 4419</i>.
363: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
364: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
365: Support <i>PKCS#11</i> tokens that only provide <i>X.509</i> certs
366: instead of raw public keys. (requested as bz#1908)
367: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
368: Add a
369: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>
370: <tt>Match</tt> keyword that allows conditional configuration to be
371: applied by matching on <i>hostname</i>, <i>user</i> and <i>result of
372: arbitrary commands</i>.
373: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
374: Add support for <i>client-side hostname canonicalisation</i> using a
375: set of <i>DNS suffixes</i> and rules in
376: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>.
377: This allows unqualified names to be canonicalised to fully-qualified
378: domain names to eliminate ambiguity when looking up keys in
379: <tt>known_hosts</tt> or checking host certificate names.
380: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp-server&sektion=8">sftp-server(8)</a>:
381: Add the ability to whitelist and/or blacklist sftp protocol requests by
382: name.
383: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp-server&sektion=8">sftp-server(8)</a>:
384: Add a sftp "fsync@openssh.com" to support calling
385: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fsync&sektion=2">fsync(2)</a>
386: on an open file handle.
387: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
388: Add a
389: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>
390: <tt>PermitTTY</tt> to disallow <i>TTY</i> allocation, mirroring the
391: longstanding <tt>no-pty</tt> <tt>authorized_keys</tt> option.
392: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
393: Add a
394: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>
395: <tt>ProxyUseFDPass</tt> option that supports the use of
396: <tt>ProxyCommands</tt> that establish a connection and then pass a
397: connected file descriptor back to
398: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>.
399: This allows the <tt>ProxyCommand</tt> to exit rather than staying
400: around to transfer data.
401: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
402: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
403: this release removes the <i>J-PAKE</i> authentication code. This code
404: was experimental, never enabled and had been unmaintained for some
405: time.
406: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
407: when processing <tt>Match</tt> blocks, skip '<tt>exec</tt>' clauses
408: other clauses predicates failed to match.
409: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
410: if hostname canonicalisation is enabled and results in the destination
411: hostname being changed, then re-parse
412: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>
413: files using the new destination hostname. This gives '<tt>Host</tt>'
414: and '<tt>Match</tt>' directives that use the expanded hostname a chance
415: to be applied.
1.1 deraadt 416: </ul>
417: <li>The following significant bugs have been fixed in this release:
418: <ul>
1.3 sobrado 419: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
420: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
421: Fix potential stack exhaustion caused by nested certificates.
422: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
423: make <tt>BindAddress</tt> work with <tt>UsePrivilegedPort</tt>.
424: (bz#1211)
425: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
426: fix the progress meter for resumed transfer. (bz#2137)
427: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&sektion=1">ssh-add(1)</a>:
428: do not request smartcard PIN when removing keys from
429: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>.
430: (bz#2187)
431: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
432: fix re-exec fallback when original
433: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>
434: binary cannot be executed. (bz#2139)
435: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
436: Make relative-specified certificate expiry times relative to current
437: time and not the validity start time.
438: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
439: fix <tt>AuthorizedKeysCommand</tt> inside a <tt>Match</tt> block.
440: (bz#2161)
441: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
442: symlinking a file would incorrectly canonicalise the target path.
443: (bz#2129)
444: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
445: fix a use-after-free in the PKCS#11 agent helper executable.
446: (bz#2175)
447: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
448: Improve logging of sessions to include the <i>user name</i>, <i>remote
449: host</i> and <i>port</i>, the <i>session type</i> (shell, command,
450: etc.) and <i>allocated TTY</i> (if any).
451: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
452: tell the client (via a debug message) when their preferred listen
453: address has been overridden by the server's <tt>GatewayPorts</tt>
454: setting. (bz#1297)
455: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
456: include report port in bad protocol banner message. (bz#2162)
457: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
458: fix memory leak in error path in <i>do_readdir()</i>. (bz#2163)
459: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
460: don't leak file descriptor on error. (bz#2171)
461: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
462: include the <i>local address</i> and <i>port</i> in "<tt>Connection
463: from ...</tt>" message. (only shown at <i>loglevel>=verbose</i>)
464: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
465: avoid spurious "<tt>getsockname failed: Bad file descriptor</tt>" in
466: <tt>ssh -W</tt>. (bz#2200, debian#738692)
467: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
468: allow the
469: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=shutdown&sektion=2">shutdown(2)</a>
470: syscall in seccomp-bpf and systrace sandbox modes, as it is reachable
471: if the connection is terminated during the pre-auth phase.
472: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
473: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
474: fix unsigned overflow that in <i>SSH protocol 1 bignum parsing</i>.
475: Minimum key length checks render this bug unexploitable to compromise
476: SSH 1 sessions.
477: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>
478: clarify behaviour of a keyword that appears in multiple matching
479: <tt>Match</tt> blocks. (bz#2184)
480: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
481: avoid unnecessary hostname lookups when canonicalisation is disabled.
482: (bz#2205)
483: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
484: avoid sandbox violation crashes in GSSAPI code by caching the supported
485: list of GSSAPI mechanism OIDs before entering the sandbox. (bz#2107)
486: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
487: fix possible crashes in SOCKS4 parsing caused by assumption that the
488: SOCKS username is nul-terminated.
489: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
490: fix regression for <tt>UsePrivilegedPort=yes</tt> when
491: <tt>BindAddress</tt> is not specified.
492: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
493: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
494: fix memory leak in ECDSA signature verification.
495: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
496: fix matching of '<tt>Host</tt>' directives in
497: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>
498: files to be case-insensitive again. (regression in 6.5)
1.1 deraadt 499: </ul>
500: </ul>
501: <p>
502:
1.46 lteo 503: <li>Ports and packages:
1.1 deraadt 504: <ul>
1.46 lteo 505: <li>Over 8,700 ports.
506: <li>Major overhaul of the package tools resulting in much better memory usage.
1.23 deraadt 507: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pkg_add&sektion=1">pkg_add(1)</a> now trusts signed packages only by default.
1.46 lteo 508: <li>The build process now allows some limited capability for building
509: conflicting packages, yielding kde4 packages as a result, along with kde3.
1.1 deraadt 510: </ul>
511: <p>
512: <li>Many pre-built packages for each architecture:
513: <table border=0 cellspacing=0 cellpadding=2 width="95%">
514: <tr>
515: <td valign="top" width="25%">
516: <ul>
517: <li>i386: 8468
1.6 deraadt 518: <li>sparc64: 7969
1.21 sthen 519: <li>alpha: 6199
1.1 deraadt 520: <li>m68k: XXXX
521: </ul></td><td valign=top width="25%"><ul>
522: <li>sh: XXXX
523: <li>amd64: 8534
524: <li>powerpc: 8057
525: <li>m88k: XXXX
526: </ul></td><td valign=top width="25%"><ul>
1.49 sthen 527: <li>sparc: 4681
1.1 deraadt 528: <li>arm: XXXX
529: <li>hppa: 6549
530: </ul></td><td valign=top width="25%"><ul>
531: <li>vax: XXXX
1.21 sthen 532: <li>mips64: 4726
533: <li>mips64el: 6730
1.1 deraadt 534: </ul></td></tr></table>
535: <p>
536:
537: <li>Some highlights:
538: <ul>
1.4 jsg 539: <li>GNOME 3.10.2 <li>KDE 3.5.10
1.2 espie 540: <li>KDE 4.11.5
1.4 jsg 541: <li>Xfce 4.10 <li>MySQL 5.1.73
542: <li>PostgreSQL 9.3.2 <li>Postfix 2.11.0
543: <li>OpenLDAP 2.3.43 and 2.4.38 <li>Mozilla Firefox 24.3 and 26.0
544: <li>Mozilla Thunderbird 24.3.0 <li>GHC 7.6.3
545: <li>LibreOffice 4.1.4.2 <li>Emacs 21.4 and 24.3
546: <li>Vim 7.4.135 <li>PHP 5.3.28 and 5.4.24
547: <li>Python 2.7.6 and 3.3.2 <li>Ruby 1.8.7.374, 1.9.3.484, 2.0.0.353 and 2.1.0
548: <li>Tcl/Tk 8.5.15 and 8.6.1 <li>JDK 1.6.0.32 and 1.7.0.21
1.2 espie 549: <li>Mono 2.10.9 <li>Chromium 32.0.1700.102
1.4 jsg 550: <li>Groff 1.22.2 <li>Go 1.2
551: <li>GCC 4.6.4 and 4.8.2 <li>LLVM/Clang 3.3
552: <li>Node.js 0.10.24
1.1 deraadt 553: </ul>
554: <p>
555:
556: <li>As usual, steady improvements in manual pages and other documentation.
557: <p>
558:
559: <li>The system includes the following major components from outside suppliers:
560: <ul>
1.4 jsg 561: <li>Xenocara (based on X.Org 7.7 with xserver 1.14.5 + patches,
562: freetype 2.5.2, fontconfig 2.10.91, Mesa 9.2.5, xterm 301,
563: xkeyboard-config 2.10.1 and more)
1.32 miod 564: <li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.1 deraadt 565: <li>Perl 5.16.3 (+ patches)
566: <li>Our improved and secured version of Apache 1.3, with
567: SSL/TLS and DSO support
1.4 jsg 568: <li>Nginx 1.4.4 (+ patches)
1.1 deraadt 569: <li>OpenSSL 1.0.1c (+ patches)
1.4 jsg 570: <li>SQLite 3.8.0.2 (+ patches)
571: <li>Sendmail 8.14.8, with libmilter
1.1 deraadt 572: <li>Bind 9.4.2-P2 (+ patches)
1.4 jsg 573: <li>NSD 4.0.1
1.1 deraadt 574: <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
575: <li>Sudo 1.7.2p8
576: <li>Ncurses 5.7
577: <li>Heimdal 1.5.2 (+ patches)
578: <li>Binutils 2.15 (+ patches)
579: <li>Gdb 6.3 (+ patches)
580: <li>Less 444 (+ patches)
581: <li>Awk Aug 10, 2011 version
582: </ul>
583:
584: </ul>
585:
586: <a name="install"></a>
587: <hr>
588: <p>
589: <h3><font color="#0000e0">How to install</font></h3>
590: <p>
591: Following this are the instructions which you would have on a piece of
592: paper if you had purchased a CDROM set instead of doing an alternate
593: form of install. The instructions for doing an FTP (or other style
594: of) install are very similar; the CDROM instructions are left intact
595: so that you can see how much easier it would have been if you had
596: purchased a CDROM instead.
597: <p>
598:
599: <hr>
600: Please refer to the following files on the three CDROMs or FTP mirror for
601: extensive details on how to install OpenBSD 5.5 on your machine:
602: <p>
603: <ul>
1.9 deraadt 604: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/i386/INSTALL.i386">
1.7 deraadt 605: .../OpenBSD/5.5/i386/INSTALL.i386 (on CD1)</a>
1.9 deraadt 606: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/vax/INSTALL.vax">
1.7 deraadt 607: .../OpenBSD/vax/INSTALL.vax (on CD1)</a>
608: <p>
1.9 deraadt 609: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/amd64/INSTALL.amd64">
1.7 deraadt 610: .../OpenBSD/amd64/INSTALL.amd64 (on CD2)</a>
1.9 deraadt 611: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/hppa/INSTALL.hppa">
1.7 deraadt 612: .../OpenBSD/hppa/INSTALL.hppa (on CD2)</a>
1.9 deraadt 613: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/macppc/INSTALL.macppc">
1.7 deraadt 614: .../OpenBSD/macppc/INSTALL.macppc (on CD2)</a>
615: <p>
1.9 deraadt 616: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sparc64/INSTALL.sparc64">
1.7 deraadt 617: .../OpenBSD/sparc64/INSTALL.sparc64 (on CD3)</a>
1.9 deraadt 618: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sparc/INSTALL.sparc">
1.7 deraadt 619: .../OpenBSD/sparc/INSTALL.sparc (on CD3)</a>
620: <p>
1.9 deraadt 621: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/alpha/INSTALL.alpha">
1.7 deraadt 622: .../OpenBSD/5.5/alpha/INSTALL.alpha</a>
1.9 deraadt 623: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/armish/INSTALL.armish">
1.7 deraadt 624: .../OpenBSD/5.5/armish/INSTALL.armish</a>
1.9 deraadt 625: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/armv7/INSTALL.armv7">
1.7 deraadt 626: .../OpenBSD/5.5/armv7/INSTALL.armv7</a>
1.32 miod 627: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/aviion/INSTALL.aviion">
628: .../OpenBSD/5.5/aviion/INSTALL.aviion</a>
1.9 deraadt 629: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/hp300/INSTALL.hp300">
1.7 deraadt 630: .../OpenBSD/5.5/hp300/INSTALL.hp300</a>
1.9 deraadt 631: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/hppa/INSTALL.hppa">
1.7 deraadt 632: .../OpenBSD/5.5/hppa/INSTALL.hppa</a>
1.9 deraadt 633: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/landisk/INSTALL.landisk">
1.7 deraadt 634: .../OpenBSD/5.5/landisk/INSTALL.landisk</a>
1.9 deraadt 635: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/loongson/INSTALL.loongson">
1.7 deraadt 636: .../OpenBSD/5.5/loongson/INSTALL.loongson</a>
1.9 deraadt 637: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/luna88k/INSTALL.luna88k">
1.7 deraadt 638: .../OpenBSD/5.5/luna88k/INSTALL.luna88k</a>
1.9 deraadt 639: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/macppc/INSTALL.macppc">
1.7 deraadt 640: .../OpenBSD/5.5/macppc/INSTALL.macppc</a>
1.9 deraadt 641: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/mvme68k/INSTALL.mvme68k">
1.7 deraadt 642: .../OpenBSD/5.5/mvme68k/INSTALL.mvme68k</a>
1.9 deraadt 643: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/mvme88k/INSTALL.mvme88k">
1.7 deraadt 644: .../OpenBSD/5.5/mvme88k/INSTALL.mvme88k</a>
1.9 deraadt 645: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/octeon/INSTALL.octeon">
1.7 deraadt 646: .../OpenBSD/5.5/octeon/INSTALL.octeon</a>
1.9 deraadt 647: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sgi/INSTALL.sgi">
1.7 deraadt 648: .../OpenBSD/5.5/sgi/INSTALL.sgi</a>
1.9 deraadt 649: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/socppc/INSTALL.socppc">
1.7 deraadt 650: .../OpenBSD/5.5/socppc/INSTALL.socppc</a>
1.9 deraadt 651: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sparc/INSTALL.sparc">
1.7 deraadt 652: .../OpenBSD/5.5/sparc/INSTALL.sparc</a>
1.9 deraadt 653: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/vax/INSTALL.vax">
1.7 deraadt 654: .../OpenBSD/5.5/vax/INSTALL.vax</a>
1.9 deraadt 655: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/zaurus/INSTALL.zaurus">
1.7 deraadt 656: .../OpenBSD/5.5/zaurus/INSTALL.zaurus</a>
1.1 deraadt 657: </ul>
658: <hr>
659:
660: <p>
661: Quick installer information for people familiar with OpenBSD, and the
662: use of the "disklabel -E" command. If you are at all confused when
663: installing OpenBSD, read the relevant INSTALL.* file as listed above!
664: <p>
665:
666: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
667: <ul>
668: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
669: release is on CD1. If your BIOS does not support booting from CD, you will need
670: to create a boot floppy to install from. To create a boot floppy write
671: <i>CD1:5.5/i386/floppy55.fs</i> to a floppy and boot via the floppy drive.
672:
673: <p>
674: Use <i>CD1:5.5/i386/floppyB55.fs</i> instead for greater SCSI controller
675: support, or <i>CD1:5.5/i386/floppyC55.fs</i> for better laptop support.
676:
677: <p>
678: If you can't boot from a CD or a floppy disk,
679: you can install across the network using PXE as described in
680: the included INSTALL.i386 document.
681:
682: <p>
683: If you are planning on dual booting OpenBSD with another OS, you will need to
684: read INSTALL.i386.
685:
686: <p>
687: To make a boot floppy under MS-DOS, use the "rawrite" utility located
688: at <i>CD1:5.5/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
689: use the
690: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>
691: utility. The following is an example usage of
692: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>,
693: where the device could be "floppy", "rfd0c", or
694: "rfd0a".
695:
696: <ul><pre>
697: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
698: </pre></ul>
699:
700: <p>
701: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
702: your install will most likely fail. For more information on creating a boot
703: floppy and installing OpenBSD/i386 please refer to
704: <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
705: </ul>
706:
707: <p>
708: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
709: <ul>
710: The 5.5 release of OpenBSD/amd64 is located on CD2.
711: Boot from the CD to begin the install - you may need to adjust
712: your BIOS options first.
713: If you can't boot from the CD, you can create a boot floppy to install from.
714: To do this, write <i>CD2:5.5/amd64/floppy55.fs</i> to a floppy, then
715: boot from the floppy drive.
716:
717: <p>
718: If you can't boot from a CD or a floppy disk,
719: you can install across the network using PXE as described in the included
720: INSTALL.amd64 document.
721:
722: <p>
723: If you are planning to dual boot OpenBSD with another OS, you will need to
724: read INSTALL.amd64.
725: </ul>
726:
727: <p>
728: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
729: <ul>
730: Burn the image from the FTP site to a CDROM, and power on your machine
731: while holding down the <i>C</i> key until the display turns on and
732: shows <i>OpenBSD/macppc boot</i>.
733:
734: <p>
735: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
736: /5.5/macppc/bsd.rd</i>
737: </ul>
738:
739: <p>
740: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
741: <ul>
742: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
743:
744: <p>
745: If this doesn't work, or if you don't have a CDROM drive, you can write
746: <i>CD3:5.5/sparc64/floppy55.fs</i> or <i>CD3:5.5/sparc64/floppyB55.fs</i>
747: (depending on your machine) to a floppy and boot it with <i>boot
748: floppy</i>. Refer to INSTALL.sparc64 for details.
749:
750: <p>
751: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
752: will most likely fail.
753:
754: <p>
755: You can also write <i>CD3:5.5/sparc64/miniroot55.fs</i> to the swap partition on
756: the disk and boot with <i>boot disk:b</i>.
757:
758: <p>
759: If nothing works, you can boot over the network as described in INSTALL.sparc64.
760: </ul>
761:
762: <p>
763: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
764: <ul>
765: <p>Write <i>FTP:5.5/alpha/floppy55.fs</i> or
766: <i>FTP:5.5/alpha/floppyB55.fs</i> (depending on your machine) to a diskette and
767: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
768:
769: <p>
770: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
771: will most likely fail.
772:
773: </ul>
774:
775: <p>
776: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
777: <ul>
778: <p>
779: After connecting a serial port, Thecus can boot directly from the network
780: either tftp or http. Configure the network using fconfig, reset,
781: then load bsd.rd, see INSTALL.armish for specific details.
782: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
783: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
784: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
785: More details are available in INSTALL.armish.
786: </ul>
787:
788: <p>
789: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
790: <ul>
791: <p>
792: Boot over the network by following the instructions in INSTALL.hp300.
793: </ul>
794:
795: <p>
796: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
797: <ul>
798: <p>
799: Boot over the network by following the instructions in INSTALL.hppa or the
800: <a href="hppa.html#install">hppa platform page</a>.
801: </ul>
802:
803: <p>
804: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
805: <ul>
806: <p>
807: Write <i>miniroot55.fs</i> to the start of the CF
808: or disk, and boot normally.
809: </ul>
810:
811: <p>
812: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
813: <ul>
814: <p>
815: Write <i>miniroot55.fs</i> to a USB stick and boot bsd.rd from it
816: or boot bsd.rd via tftp.
817: Refer to the instructions in INSTALL.loongson for more details.
818: </ul>
819: <p>
820:
821: <p>
822: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
823: <ul>
824: <p>
1.32 miod 825: Copy `boot' and `bsd.rd' to a Mach or UniOS partition, and boot the bootloader
826: from the PROM, and the bsd.rd from the bootloader.
827: Refer to the instructions in INSTALL.luna88k for more details.
1.1 deraadt 828: </ul>
829:
830: <p>
831: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
832: <ul>
833: <p>
834: You can create a bootable installation tape or boot over the network.<br>
835: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
836: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
837: for more details.
838: </ul>
839:
840: <p>
841: <h3><font color="#e00000">OpenBSD/mvme88k:</font></h3>
842: <ul>
843: <p>
844: You can create a bootable installation tape or boot over the network.<br>
845: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
846: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
847: for more details.
848: </ul>
849:
850: <p>
851: <h3><font color="#e00000">OpenBSD/octeon:</font></h3>
852: <ul>
853: <p>
854: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
855: Refer to the instructions in INSTALL.octeon for more details.
856: </ul>
857:
858: <p>
859: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
860: <ul>
861: <p>
1.32 miod 862: To install, burn cd55.iso on a CD-R, put it in the CD drive of your
1.1 deraadt 863: machine and select <i>Install System Software</i> from the System Maintenance
1.32 miod 864: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
865: CD-ROM, and need a proper invocation from the PROM prompt.
866: Refer to the instructions in INSTALL.sgi for more details.
1.1 deraadt 867:
868: <p>
1.32 miod 869: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
870: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
871: system type. Refer to the instructions in INSTALL.sgi for more details.
1.1 deraadt 872: </ul>
873:
874: <p>
875: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
876: <ul>
877: <p>
878: After connecting a serial port, boot over the network via DHCP/tftp.
879: Refer to the instructions in INSTALL.socppc for more details.
880: </ul>
881:
882: <p>
883: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
884: <ul>
885: Boot from one of the provided install ISO images, using one of the two
886: commands listed below, depending on the version of your ROM.
887:
888: <ul><pre>
889: ok <strong>boot cdrom 5.5/sparc/bsd.rd</strong>
890: or
891: > <strong>b sd(0,6,0)5.5/sparc/bsd.rd</strong>
892: </pre></ul>
893:
894: <p>
895: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
896: To do so you need to write <i>floppy55.fs</i> to a floppy.
897: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
898: To boot from the floppy use one of the two commands listed below,
899: depending on the version of your ROM.
900:
901: <ul><pre>
902: ok <strong>boot floppy</strong>
903: or
904: > <strong>b fd()</strong>
905: </pre></ul>
906:
907: <p>
908: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
909: will most likely fail.
910:
911: <p>
912: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
913: setup a bootable tape, or install via network, as told in the
914: INSTALL.sparc file.
915: </ul>
916:
917: <p>
918: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
919: <ul>
920: Boot over the network via mopbooting as described in INSTALL.vax.
921: </ul>
922:
923: <p>
924: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
925: <ul>
926: <p>
927: Using the Linux built-in graphical ipkg installer, install the
928: openbsd55_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
929: for a few important details.
930: </ul>
931:
932: <p>
933: <h3><font color="#e00000">Notes about the source code:</font></h3>
934: <ul>
935: src.tar.gz contains a source archive starting at /usr/src. This file
936: contains everything you need except for the kernel sources, which are
937: in a separate archive. To extract:
938: <p>
939: <ul><pre>
940: # <strong>mkdir -p /usr/src</strong>
941: # <strong>cd /usr/src</strong>
942: # <strong>tar xvfz /tmp/src.tar.gz</strong>
943: </pre></ul>
944: <p>
945: sys.tar.gz contains a source archive starting at /usr/src/sys.
946: This file contains all the kernel sources you need to rebuild kernels.
947: To extract:
948: <p>
949: <ul><pre>
950: # <strong>mkdir -p /usr/src/sys</strong>
951: # <strong>cd /usr/src</strong>
952: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
953: </pre></ul>
954: <p>
955: Both of these trees are a regular CVS checkout. Using these trees it
956: is possible to get a head-start on using the anoncvs servers as
957: described <a href="anoncvs.html">here</a>.
958: Using these files
959: results in a much faster initial CVS update than you could expect from
960: a fresh checkout of the full OpenBSD source tree.
961: <p>
962: </ul>
963:
964: <a name="upgrade"></a>
965: <hr>
966: <p>
967: <h3><font color="#0000e0">How to upgrade</font></h3>
968: <p>
969: If you already have an OpenBSD 5.4 system, and do not want to reinstall,
970: upgrade instructions and advice can be found in the
971: <a href="faq/upgrade55.html">Upgrade Guide</a>.
972:
973: <a name="ports"></a>
974: <hr>
975: <p>
976: <h3><font color="#0000e0">Ports Tree</font></h3>
977: <p>
978: A ports tree archive is also provided. To extract:
979: <p>
980: <ul><pre>
981: # <strong>cd /usr</strong>
982: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
983: </pre></ul>
984: <p>
985: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
986: read the <a href="faq/ports/index.html">ports</a> page
987: if you know nothing about ports
988: at this point. This text is not a manual of how to use ports.
989: Rather, it is a set of notes meant to kickstart the user on the
990: OpenBSD ports system.
991: <p>
992: The <i>ports/</i> directory represents a CVS (see the manpage for
993: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&arch=i386">
994: cvs(1)</a> if
995: you aren't familiar with CVS) checkout of our ports. As with our complete
996: source tree, our ports tree is available via
997: <a href="anoncvs.html">AnonCVS</a>.
998: So, in order to keep current with it, you must make the <i>ports/</i> tree
999: available on a read-write medium and update the tree with a command
1000: like:
1001: <p>
1002: <ul><pre>
1003: # <strong>cd /usr/ports</strong>
1004: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_5</strong>
1005: </pre></ul>
1006: <p>
1007: [Of course, you must replace the server name here with a nearby anoncvs
1008: server.]
1009: <p>
1010: Note that most ports are available as packages through FTP. Updated
1011: packages for the 5.5 release will be made available if problems arise.
1012: <p>
1013: If you're interested in seeing a port added, would like to help out, or just
1014: would like to know more, the mailing list
1015: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1016: <p>
1017: </body>
1018: </html>