Annotation of www/58.html, Revision 1.36
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 5.8</title>
5: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6: <meta name="description" content="OpenBSD 5.8">
7: <meta name="copyright" content="This document copyright 2015 by OpenBSD.">
8: <link rel="canonical" href="http://www.openbsd.org/58.html">
9: </head>
10:
11: <body bgcolor="#ffffff" text="#000000" link="#24248E">
12:
13: <a href="index.html">
14: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
15: <p>
16:
17: <a href="images/XXX.jpg">
18: <img align="left" width="227" height="343" hspace="24" vspace="10" src="images/XXX.jpg"></a>
19: <h2><font color="#0000e0">OpenBSD 5.8</font></h2>
20: <p>
1.7 deraadt 21: To be released Oct 18, 2015<br>
1.1 deraadt 22: Copyright 1997-2015, Theo de Raadt.<br>
23: <font color="#e00000">ISBN 978-0-9881561-6-6</font>
24: <br>
1.17 deraadt 25: <a href="lyrics.html#58">5.8 Songs: "XXX", "XXX", "XXX", "XXX", "XXX"</a>
1.1 deraadt 26: <p>
27:
28: <ul>
29: <li>Order a CDROM from our <a href="https://openbsdstore.com">ordering system</a>.
30: <li>See the information on <a href="ftp.html">the FTP page</a> for
31: a list of mirror machines.
32: <li>Go to the <font color="#e00000">pub/OpenBSD/5.8/</font> directory on
33: one of the mirror sites.
34: <li>Have a look at <a href="errata58.html">the 5.8 errata page</a> for a list
35: of bugs and workarounds.
36: <li>See a <a href="plus58.html">detailed log of changes</a> between the
37: 5.7 and 5.8 releases.
38: <p>
39: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1">signify(1)</a> pubkeys for this release:<br>
40: <pre>
1.3 deraadt 41: base: RWQNNZXtC/MqP3Eiu+6FBz/qrxiWQwDhd+9Yljzp62UP4KzFmmvzVk60
42: fw: RWTpkvg4fhJCDx9yL4bUCou/vtAecPVTfcaaGESQeBruwX/qHToMvWh6
43: pkg: RWRlkI2aFHvL/XGqD+lFerD/xUi/jnAXKwdFQwZDekYwDrEPSpSWgpI9
1.1 deraadt 44: </pre>
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.8.
60: For a comprehensive list, see the <a href="plus58.html">changelog</a> leading
61: to 5.8.
62: <p>
63:
64: <ul>
65: <li>Improved hardware support, including:
66: <ul>
1.36 ! mpi 67: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=rtwn&sec=4">rtwn(4)</a> driver for Realtek RTL8188CE wifi cards.
! 68: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=hpb&sec=4&arch=macppc">hpb(4)</a> driver for HyperTransport bridges as found in the IBM CPC945
1.23 guenther 69: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ugold&sec=4">ugold(4)</a> driver now supports TEMPerHUMV1.x temperature and humidity sensors.
70: <li>Improved sensor support for the <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=upd&sec=4">upd(4)</a> driver for USB Power Devices (UPS).
71: <li>Support for jumbo frames on <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=re&sec=4">re(4)</a> devices using RTL8168C/D/E/F/G and RTL8411, including PC Engines APU.
72: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=re&sec=4">re(4)</a> now works with newer devices e.g. RTL8111GU.
73: <li>Partial support has been added for full-speed isochronous devices in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ehci&sec=4">ehci(4)</a>, allowing USB 1.1 audio devices to be used on EHCI-only systems in some cases.
1.20 mpi 74: <li>Improved macppc stability and G5 performances with MP kernels
1.23 guenther 75: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=acpicpu&sec=4">acpicpu(4)</a> uses ACPI C-state information to reduce power consumption of idle CPUs.
76: <li>Kernel supports x86 AVX instructions on CPUs that have them.
1.31 krw 77: <li>Avoid assigning low address to PCI BARs, fixing various issues on machines whose BIOSes neglect to claim low memory.
78: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wscons(4)&sec=4">wscons(4)</a> works with even more odd trackpads.
1.35 reyk 79: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pvbus(4)&sec=4">pvbus(4)</a> paravirtual device tree root on virtual machines that are running on hypervisors.
1.1 deraadt 80: <li>...
81: </ul>
82: <p>
83:
84: <li>Removed hardware support:
85: <ul>
86: <li>...
87: </ul>
88: <p>
89:
90: <li>Generic network stack improvements:
91: <ul>
1.13 sthen 92: <li>MTU of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vlan&sektion=4">vlan(4)</a> devices can now be set independently from the parent interface's MTU.
93: <li>The same network range can now be assigned to multiple interfaces, using interface priorities to choose between them.
1.23 guenther 94: <li>New <!-- experimental? --> MPLS pseudowire driver <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mpw&sektion=4">mpw(4)</a>.
1.1 deraadt 95: <li>...
96: </ul>
97: <p>
98:
99: <li>Installer improvements:
100: <ul>
1.33 rpe 101: <li>The logic of the 'Allow root ssh login?' question has been changed.
1.29 rpe 102: <ul>
103: <li>The default answer is now 'no'.
104: <li>'prohibit-password' has been added to the list of possible answers.
105: </ul>
106: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=autoinstall&sec=8">autoinstall(8)</a>
107: has been extended to allow
108: <ul>
109: <li><tt>hostname-mode.conf</tt> response file names.
110: <li>response files to be placed in a subdir of the webserver's document root.
111: <li>passing a template file to
112: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sec=8">disklabel(8)</a>
113: to automatically partition the disk.
114: </ul>
115: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ntpd&sec=8">ntpd(8)</a>
116: is now enabled by default at install time.
1.21 guenther 117: <li>DUID support has improved enough that new installs now use them unconditionally.
1.29 rpe 118: <li>Installing sets from CD-ROM has been fixed if more than one CD-ROM drive is present.
119: <li>The 'Which CD-ROM contains the install media?' question has been removed.
120: Available cdrom devices are now shown directly in the 'Location of sets?' prompt.
1.1 deraadt 121: </ul>
122: <p>
123:
124: <li>Routing daemons and other userland network improvements:
125: <ul>
1.13 sthen 126: <li>Many improvements and simplifications in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldpd&sektion=8">ldpd(8)</a>, including configuration reload and support for <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mpw&sektion=4">mpw(4)</a> pseudowire interfaces.
127: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a> now allows rules to match on the peer AS number.
128: <li>For terminated BGP sessions, <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpctl&sektion=8">bgpctl(8)</a> now displays the number of prefixes received on the last session.
129: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a> now correctly handles <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=carp&sektion=4">carp(4)</a> interfaces in "backup" mode at startup.
130: <li>Log messages in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a> have been made more specific.
131: <li>The default Diffie-Hellman group for VPNs configured by <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ipsec.conf&sektion=5">ipsec.conf(5)</a> has been changed to modp3072.
1.1 deraadt 132: <li>...
1.6 deraadt 133: </ul>
1.1 deraadt 134: <p>
135:
136: <li>Security improvements:
137: <ul>
1.13 sthen 138: <li>sudo has been replaced with <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=doas&sektion=1">doas(1)</a>.
139: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=file&sektion=1">file(1)</a> has been replaced with a new modern implementation, including sandbox and privilege separation.
1.23 guenther 140: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pax&sektion=1">pax(1)</a> (and tar(1) and cpio(1)) now prevent archive extraction from escaping the current directory via symlinks; <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tar&sektion=1">tar(1)</a> without <tt>-P</tt> option now strips up through any "<tt>..</tt>" path components.
141: <li>Improved kernel checks of ELF headers.
1.13 sthen 142: <li>... <!-- talk about improved W^X / i386 PAE -->
1.1 deraadt 143: </ul>
144: <p>
145:
146: <li>Assorted improvements:
147: <ul>
1.11 tedu 148: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=worm&sektion=6">worm(6)</a>
149: now grows at a rate proportional to terminal size.
1.21 guenther 150: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dlfcn&sektion=3">dlclose(3)</a> now unregisters handlers registered by a <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_atfork&sektion=3">pthread_atfork(3)</a> call from the unloaded libraries.
151: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cp&sektion=1">cp(1)</a>, <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mv&sektion=1">mv(1)</a>, and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pax&sektion=1">pax(1)</a> with the <tt>-rw</tt> option now preserve timestamps with full nanosecond precision.
152: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pax&sektion=1">pax(1)</a> now detects failure to decompress an archive when reading it and errors out immediately.
153: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nm&sektion=1">nm(1)</a> now supports the <tt>-D</tt> option for displaying the dynamic symbol table.
154: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dump&sektion=8">dump(8)</a> now uses DUIDs in <tt>/etc/dumpdates</tt> when present and the <tt>-U</tt> option has thus been removed.
155: <li>Corrected <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=kdump&sektion=1">kdump(1)</a> reporting of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=lseek&sektion=2">lseek(2)</a> return value on ILP32 archs and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getsockopt&sektion=2">getsockopt/setsockopt(2)</a> level and optname arguments. <tt>iovec</tt>, <tt>msghdr</tt>, and <tt>cmsghdr</tt> structures are now dumped.
156: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sed&sektion=1">sed(1)</a> <tt>-i</tt> option added.
157: <li>Improvements in checking of numeric option values in <b>many</b> utilities.
1.22 guenther 158: <li>Upgraded to binutils version 2.17 with additional fixes.
159: <li>Static PIE support for sparc.
160: <li>Alpha switched to secure PLT.
1.23 guenther 161: <li>Improved correctness of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=poll&sektion=2">poll(2)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=poll&sektion=2">poll(2)</a> of <tt>O_RDONLY</tt> FIFO fds.
162: <li>Restored reporting of closed sockets by <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=netstat&sektion=1">netstat(1)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=systat&sektion=1">systat(1)</a>.
1.31 krw 163: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fdisk&sektion=8">fdisk(8)</a> now zeros correct GPT sector at end of disk.
164: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fdisk&sektion=8">fdisk(8)</a> now accepts 'T' sizes for terabytes.
165: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fdisk&sektion=8">fdisk(8)</a> repaired to work on 4K sector disks again.
166: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> now logs correct giaddr and ciaddr information even when DHCP relays are present.
167: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> now accommodates Linux and MS clients by not sending routers or static routes info when classless static routes are sent.
168: <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> now accept hostnames beginning with a digit.
169: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> no longer rejects leases with addresses overlapping existing subnets on other interfaces. Kernel routing logic now just works.
1.23 guenther 170: <li>... <!-- talk about reaper -->
1.1 deraadt 171: </ul>
172: <p>
173:
174: <li>OpenBSD <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=httpd&sektion=8">httpd(8)</a>:
175: <ul>
1.34 reyk 176: <li>New features:
177: <ul>
178: <li>Added support for matching and redirections with Lua <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man7/patterns.7">patterns(7)</a>.
179: <li>Implemented If-Modified-Since for conditional GET or HEAD requests (RFC 7232).
180: <li>Added byte-range support for range requests (RFC 7233).
181: <li>Allowing to specify a global or per-location default media type instead of <tt>application/octet-stream</tt>.
182: <li>Added support for HTTP Strict Transport Security (HSTS; RFC 6797).
183: <li>Added initial regression test suite based on <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man8/relayd.8">relayd(8)</a>'s implementation.
184: </ul>
185: <li>Fixes and improvements:
186: <ul>
187: <li>TLS in <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man8/httpd.8">httpd(8)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man8/relayd.8">relayd(8)</a> now defaults to TLSv1.2-only.
188: <li>Fixed support for large TLS keys or certificate bundles with up to 16KB each.
189: <li>Fixed the Content-Length header for files larger than 2 GB on 32-bit architectures.
190: <li>Fixed translation of CGI environment variables in accordance with RFCs 7230 and 3875.
191: <li>Improved memory usage and fixed possible memory exhaustion on large file transfers.
192: <li>Added URL-encoding of specific CGI variables before using them in the Location header.
193: <li>Prepend files or directories containing ":" with "./" in directory indexes as per RFC 3986.
194: <li>Allowing to specify characters like "?" in the Location URI.
195: <li>Various other bug fixes and improvements.
196: </ul>
1.1 deraadt 197: </ul>
198: <p>
199:
200: <li>OpenSMTPD X.X.X
201: <ul>
202: <li>...
203: </ul>
204: <p>
205:
1.15 sobrado 206: <li>OpenSSH 7.0
1.1 deraadt 207: <ul>
1.15 sobrado 208: <li>Security:
209: <ul>
1.27 sobrado 210: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
211: when forwarding X11 connections with <tt>ForwardX11Trusted=no</tt>,
212: connections made after <tt>ForwardX11Timeout</tt> expired could be
213: permitted and no longer subject to XSECURITY restrictions because of
214: an ineffective timeout check in
215: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
216: coupled with "fail open" behaviour in the X11 server when clients
217: attempted connections with expired credentials.
218: This problem was reported by Jann Horn.
219: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
220: fix weakness of agent locking (<tt>ssh-add -x</tt>) to
221: password guessing by implementing an increasing failure delay,
222: storing a salted hash of the password rather than the password
223: itself and using a timing-safe comparison function for verifying
224: unlock attempts. This problem was reported by Ryan Castellucci.
1.15 sobrado 225: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
226: OpenSSH 6.8 and 6.9 incorrectly set TTYs to be world-writable.
227: Local attackers may be able to write arbitrary messages to logged-in
228: users, including terminal escape sequences.
229: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
230: fix circumvention of <tt>MaxAuthTries</tt> using keyboard-interactive
231: authentication. By specifying a long, repeating keyboard-interactive
232: "devices" string, an attacker could request the same authentication
233: method be tried thousands of times in a single pass. The
234: <tt>LoginGraceTime</tt> timeout in
235: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>
236: and any authentication failure delays implemented by the authentication
237: mechanism itself were still applied.
238: </ul>
1.1 deraadt 239: <li>Potentially-incompatible changes:
240: <ul>
1.15 sobrado 241: <li>Support for the legacy <i>SSH version 1 protocol</i> is disabled by
242: default at compile time.
243: <li>Support for the 1024-bit diffie-hellman-group1-sha1 key exchange
244: is disabled by default at run-time. It may be re-enabled using
245: the instructions at <tt>http://www.openssh.com/legacy.html</tt>.
246: <li>Support for <tt>ssh-dss</tt>, <tt>ssh-dss-cert-*</tt> <i>host</i>
247: and <i>user</i> keys is disabled by default at run-time. These may
248: be re-enabled using the instructions at
249: <tt>http://www.openssh.com/legacy.html</tt>.
250: <li>Support for the legacy <i>v00 cert format</i> has been removed.
251: <li>The default for the
252: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>
253: <tt>PermitRootLogin</tt> option has changed from "yes" to
1.26 deraadt 254: "prohibit-password" (but the OpenBSD installer defaults to "no")
1.1 deraadt 255: </ul>
256: <li>New/changed features:
257: <ul>
1.27 sobrado 258: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
259: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
260: promote <tt>chacha20-poly1305@openssh.com</tt> to be the default
261: cipher.
262: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
263: support admin-specified arguments to <tt>AuthorizedKeysCommand</tt>.
264: (bz#2081)
265: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
266: add <tt>AuthorizedPrincipalsCommand</tt> that allows retrieving
267: authorized principals information from a subprocess rather than a
268: file.
269: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
270: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&sektion=1">ssh-add(1)</a>:
271: support PKCS#11 devices with external PIN entry devices. (bz#2240)
272: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
273: allow GSSAPI host credential check to be relaxed for multihomed
274: hosts via <tt>GSSAPIStrictAcceptorCheck</tt> option. (bz#928)
275: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
276: support <tt>ssh-keygen -lF hostname</tt> to search <tt>known_hosts</tt>
277: and print key hashes rather than full keys.
278: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
279: add <tt>-D</tt> flag to leave
280: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>
281: in foreground without enabling debug mode. (bz#2381)
1.16 sobrado 282: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>:
1.15 sobrado 283: add <tt>PubkeyAcceptedKeyTypes</tt> option to control which public
284: key types are available for user authentication.
285: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>:
286: add <tt>HostKeyAlgorithms</tt> option to control which public key
287: types are offered for host authentications.
288: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
289: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
290: extend <tt>Ciphers</tt>, <tt>MACs</tt>, <tt>KexAlgorithms</tt>,
291: <tt>HostKeyAlgorithms</tt>, <tt>PubkeyAcceptedKeyTypes</tt> and
292: <tt>HostbasedKeyTypes</tt> options to allow appending to the default
293: set of algorithms instead of replacing it. Options may now be
294: prefixed with a <tt>+</tt> to append to the default, e.g.
295: "<tt>HostKeyAlgorithms=+ssh-dss</tt>".
1.1 deraadt 296: </ul>
297: <li>The following significant bugs have been fixed in this release:
298: <ul>
1.15 sobrado 299: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
300: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
1.27 sobrado 301: deprecate legacy <tt>SSH2_MSG_KEX_DH_GEX_REQUEST_OLD</tt> message and
302: do not try to use it against some 3rd-party SSH implementations that
303: use it (older PuTTY, WinSCP).
304: <li>Many fixes for problems caused by compile-time deactivation of
305: SSH1 support. (including bz#2369)
306: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
307: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
308: cap DH-GEX group size at 4Kbits for Cisco implementations as some
309: would fail when attempting to use group sizes greater than 4K.
310: (bz#2209)
311: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
312: fix out-of-bound read in <tt>EscapeChar</tt> configuration option
313: parsing. (bz#2396)
314: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
315: fix application of <tt>PermitTunnel</tt>, <tt>LoginGraceTime</tt>,
316: <tt>AuthenticationMethods</tt> and <tt>StreamLocalBindMask</tt>
317: options in <tt>Match</tt> blocks.
318: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
319: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
320: improve disconnection message on TCP reset. (bz#2257)
321: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
322: remove failed remote forwards established by multiplexing from the
323: list of active forwards. (bz#2363)
324: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
325: make parsing of <tt>authorized_keys</tt> "<tt>environment=</tt>"
326: options independent of <tt>PermitUserEnv</tt> being enabled. (bz#2329)
327: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
328: fix post-auth crash with <tt>permitopen=none</tt>. (bz#2355)
329: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
330: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&sektion=1">ssh-add(1)</a>,
331: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
332: allow new-format private keys to be encrypted with AEAD ciphers.
333: (bz#2366)
334: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
335: allow <tt>ListenAddress</tt>, <tt>Port</tt> and <tt>AddressFamily</tt>
336: configuration options to appear in any order. (bz#86)
337: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
338: check for and reject missing arguments for <tt>VersionAddendum</tt>
339: and <tt>ForceCommand</tt>. (bz#2281)
340: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
341: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
342: don't treat unknown certificate extensions as fatal. (bz#2387)
343: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
344: make <tt>stdout</tt> and <tt>stderr</tt> output consistent. (bz#2325)
345: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
346: mention missing <tt>DISPLAY</tt> environment in debug log when X11
347: forwarding requested. (bz#1682)
348: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
349: correctly record login when <tt>UseLogin</tt> is set. (bz#378)
350: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
351: add some missing options to <tt>sshd -T</tt> output and fix output
352: of <tt>VersionAddendum</tt> and <tt>HostCertificate</tt>. (bz#2346)
353: <li>Document and improve consistency of options that accept a
354: "<tt>none</tt>" argument: <tt>TrustedUserCAKeys</tt>,
355: <tt>RevokedKeys</tt> (bz#2382), <tt>AuthorizedPrincipalsFile</tt>
356: (bz#2288).
357: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
358: include remote username in debug output. (bz#2368)
359: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
360: avoid compatibility problem with some versions of Tera Term, which
361: would crash when they received the hostkeys notification message
362: (<tt>hostkeys-00@openssh.com</tt>).
363: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
364: mention <tt>ssh-keygen -E</tt> as useful when comparing legacy
365: <i>MD5 host key fingerprints</i>. (bz#2332)
366: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
367: clarify pseudo-terminal request behaviour and use make manual language
368: consistent. (bz#1716)
369: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
370: document that the <tt>TERM</tt> environment variable is not subject
371: to <tt>SendEnv</tt> and <tt>AcceptEnv</tt>. (bz#2386)
372: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
373: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
1.15 sobrado 374: add compatability workarounds for Cisco and more PuTTY versions.
375: (bz#2424)
376: <li>Fix some omissions and errors in the <tt>PROTOCOL</tt> and
377: <tt>PROTCOL.mux</tt> documentation relating to <i>Unix domain
378: socket</i> forwarding. (bz#2421, bz#2422)
379: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
380: Improve the
381: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
382: manual page to include a better desciption of Unix domain socket
383: forwarding. (bz#2423)
384: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
385: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
386: skip uninitialised PKCS#11 slots, fixing failures to load keys when
387: they are present. (bz#2427)
388: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>,
389: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&sektion=1">ssh-agent(1)</a>:
390: do not ignore PKCS#11 hosted keys that wth empty <tt>CKA_ID</tt>.
391: (bz#2429)
392: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
393: clarify documentation for <tt>UseDNS</tt> option. (bz#2045)
1.1 deraadt 394: </ul>
395: </ul>
396: <p>
397:
398: <li>LibreSSL
399: <ul>
400: <li>User-visible features:
401: <ul>
1.27 sobrado 402: <li>Reject all <i>server DH keys</i> smaller than 1024 bits.
403: <li>Multiple CVEs fixed including CVE-2015-0207, CVE-2015-0209,
404: CVE-2015-0286, CVE-2015-0287, CVE-2015-0288, CVE-2015-0289,
405: CVE-2015-1788, CVE-2015-1789, CVE-2015-1792.
406: <li>Protocol parsing conversions to BoringSSL's <i>CRYPTO ByteString</i>
407: (CBS) API.
408: <li>Added <tt>EC_curve_nid2nist</tt> and <tt>EC_curve_nist2nid</tt>
409: from OpenSSL.
410: <li>Removed Dynamic Engine support.
411: <li>Removed MDC-2DES support.
1.14 sobrado 412: <li>Switched <tt>openssl dhparam</tt> default from 512 to 2048 bits.
413: <li>Fixed <tt>openssl pkeyutl -verify</tt> to exit with a 0 on success.
414: <li>Fixed dozens of Coverity issues including dead code, memory leaks,
415: logic errors and more.
416: <li>Ensure that
417: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>
418: restores terminal echo state after reading a password.
1.28 sobrado 419: <li>Incorporated fix for OpenSSL issue #3683.
1.14 sobrado 420: <li>Removed SSLv3 support from
421: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>.
422: <li>Modified <tt>tls_write</tt> in <tt>libtls</tt> to allow partial
423: writes, clarified with examples in the documentation.
424: <li>Removed RSAX engine.
1.16 sobrado 425: <li>Tested SSLv3 removal with the OpenBSD ports tree and found several
426: applications that were not ready to build without SSLv3 yet.
427: For now, building a program that intentionally uses SSLv3 will
428: result in a linker warning.
1.14 sobrado 429: <li>Added <tt>TLS_method</tt>, <tt>TLS_client_method</tt> and
430: <tt>TLS_server_method</tt> as a replacement for the
431: <tt>SSLv23_*method</tt> calls.
432: <li>Default <tt>cert.pem</tt>, <tt>openssl.cnf</tt>, and
433: <tt>x509v3.cnf</tt> files are now installed under
434: <tt>$sysconfdir/ssl</tt> or the directory specified by
435: <tt>--with-openssldir</tt>. Previous versions of LibreSSL left
436: these empty.
1.1 deraadt 437: </ul>
438: <li>Code improvements:
439: <ul>
1.27 sobrado 440: <li>Fix incorrect comparison function in openssl(1) certhash command.
441: Thanks to Christian Neukirchen / Void Linux.
442: <li>Removal of <tt>OPENSSL_issetugid</tt> and all library getenv calls.
443: Applications can and should no longer rely on environment variables
444: for changing library behavior.
445: <tt>OPENSSL_CONF</tt>/<tt>SSLEAY_CONF</tt> is still supported with the
446: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>
447: command.
448: <li><tt>libtls</tt> API and documentation additions.
1.28 sobrado 449: <li>Various bug fixes and simplifications to <tt>libssl</tt> and
1.27 sobrado 450: <tt>libcrypto</tt>.
1.14 sobrado 451: <li>Reworked
452: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=openssl&sektion=1">openssl(1)</a>
453: option handling.
454: <li>LibreSSL version define <tt>LIBRESSL_VERSION_NUMBER</tt> will now
455: be bumped for each portable release.
456: <li>Removed workarounds for TLS client padding bugs.
457: <li>Removed IE 6 SSLv3 workarounds.
458: <li><tt>--with-enginesdir</tt> is removed as a configuration parameter.
1.1 deraadt 459: </ul>
460: </ul>
461: <p>
462: <li>mandoc X.X.X
463: <ul>
1.21 guenther 464: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=man&sektion=1">man(1)</a> functionality is now built-in.
1.1 deraadt 465: <li>...
466: </ul>
467:
468: <p>
469: <li>Syslogd:
470: <ul>
1.4 bluhm 471: <li>OpenBSD
472: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=syslogd&sektion=8">syslogd(8)</a>
473: can bind to explicitly given UDP or TCP sockets to receive messages.
474: TCP streams are accepted with the octet counting or the non
475: transparent framing method.
476: <li>Blocks in
477: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=syslog.conf&se
478: ktion=5">syslog.conf(5)</a>
479: started with <code>+host</code> process messages created by
480: certain hosts specifically.
481: <li>Handle situations when the file descriptor limit is exhausted
482: gracefully.
483: <li>Since libtls handles short writes smarter, syslogd can use the
1.12 tedu 484: complete output buffer to save messages, coping with
485: longer TLS server down times without losing messages.
1.1 deraadt 486: </ul>
487: <p>
488: <li>Ports and packages:
489: <ul>
490: <li>Over X,XXX ports.
491: </ul>
492: <p>
493: <li>Many pre-built packages for each architecture:
494: <table border=0 cellspacing=0 cellpadding=2 width="95%">
495: <tr>
496: <td valign="top" width="25%">
497: <ul>
1.25 deraadt 498: <li>alpha: XXXX
1.32 sthen 499: <li>amd64: 8866
1.25 deraadt 500: <li>arm: XXXX
501: </ul></td><td valign=top width="25%"><ul>
1.32 sthen 502: <li>hppa: 5734
1.13 sthen 503: <li>i386: 8839
1.25 deraadt 504: <li>mips64: XXXX
505: </ul></td><td valign=top width="25%"><ul>
506: <li>mips64el: XXXX
507: <li>powerpc: XXXX
1.1 deraadt 508: <li>sh: XXXX
509: </ul></td><td valign=top width="25%"><ul>
1.25 deraadt 510: <li>sparc64: XXXX
1.1 deraadt 511: <li>sparc: XXXX
512: <li>vax: XXXX
513: </ul></td><td valign=top width="25%"><ul>
514: </ul></td></tr></table>
515: <p>
516:
517: <li>Some highlights:
518: <table border=0 cellspacing=0 cellpadding=2 width="95%">
519: <tr>
520: <td valign="top" width="33%"><ul>
1.10 lteo 521: <li>Chromium 44.0.2403.125
522: <li>Emacs 21.4 and 24.5
523: <li>GCC 4.8.4 and 4.9.3
1.1 deraadt 524: <li>GHC 7.8.4
1.10 lteo 525: <li>GNOME 3.16.2
526: <li>Go 1.4.2
1.1 deraadt 527: <li>Groff 1.22.3
1.10 lteo 528: <li>JDK 1.7.0.80 and 1.8.0.45
1.30 zhuk 529: <li>KDE 3.5.10 and 4.14.3 (plus KDE4 core updates)
1.1 deraadt 530: <li>LLVM/Clang 3.5 (20140228)
1.10 lteo 531: <li>LibreOffice 4.4.4.3
532: <li>MariaDB 10.0.20
533: <li>Mono 3.12.1
1.18 landry 534: <li>Mozilla Firefox 38.1.1esr and 39.0.3
1.10 lteo 535: <li>Mozilla Thunderbird 38.1.0
1.1 deraadt 536: </ul></td><td valign=top width="33%"><ul>
537: <li>Node.js 0.10.35
1.10 lteo 538: <li>OpenLDAP 2.3.43 and 2.4.41
539: <li>PHP 5.4.43, 5.5.27 and 5.6.11
540: <li>Postfix 3.0.2
541: <li>PostgreSQL 9.4.4
542: <li>Python 2.7.10 and 3.4.3
543: <li>R 3.2.1
544: <li>Ruby 1.8.7.374, 1.9.3.551, 2.0.0.645, 2.1.6, and 2.2.2
545: <li>Sendmail 8.15.2
546: <li>Sudo 1.8.14.3
1.9 stu 547: <li>Tcl/Tk 8.5.18 and 8.6.4
1.10 lteo 548: <li>TeX Live 2014
549: <li>Vim 7.4.769
550: <li>Xfce 4.12
1.1 deraadt 551: </ul></td><td valign=top width="34%">
552: </td></tr></table>
553: <p>
554:
555: <li>As usual, steady improvements in manual pages and other documentation.
556: <p>
557:
558: <li>The system includes the following major components from outside suppliers:
559: <ul>
560: <li>Xenocara (based on X.Org 7.7 with xserver 1.16.4 + patches,
1.8 matthieu 561: freetype 2.6, fontconfig 2.11.1, Mesa 10.2.9, xterm 314,
562: xkeyboard-config 2.14 and more)
1.1 deraadt 563: <li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.8 matthieu 564: <li>Perl 5.20.2 (+ patches)
565: <li>SQLite 3.8.9 (+ patches)
566: <li>NSD 4.1.3
567: <li>Unbound 1.5.4
1.1 deraadt 568: <li>Ncurses 5.7
1.8 matthieu 569: <li>Binutils 2.17 (+ patches)
1.1 deraadt 570: <li>Gdb 6.3 (+ patches)
571: <li>Less 458 (+ patches)
572: <li>Awk Aug 10, 2011 version
573: </ul>
574:
575: </ul>
576:
577: <a name="install"></a>
578: <hr>
579: <p>
580: <h3><font color="#0000e0">How to install</font></h3>
581: <p>
582: Following this are the instructions which you would have on a piece of
583: paper if you had purchased a CDROM set instead of doing an alternate
584: form of install. The instructions for doing an HTTP (or other style
585: of) install are very similar; the CDROM instructions are left intact
586: so that you can see how much easier it would have been if you had
587: purchased a CDROM instead.
588: <p>
589:
590: <hr>
591: Please refer to the following files on the three CDROMs or mirror site for
592: extensive details on how to install OpenBSD 5.8 on your machine:
593: <p>
594: <ul>
595: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.alpha">
596: .../OpenBSD/5.8/alpha/INSTALL.alpha (on CD1)</a>
597: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/i386/INSTALL.i386">
598: .../OpenBSD/5.8/i386/INSTALL.i386 (on CD1)</a>
599: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.hppa">
600: .../OpenBSD/5.8/hppa/INSTALL.hppa (on CD1)</a>
601: <p>
602: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/amd64/INSTALL.amd64">
603: .../OpenBSD/5.8/amd64/INSTALL.amd64 (on CD2)</a>
604: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/macppc/INSTALL.macppc">
605: .../OpenBSD/5.8/macppc/INSTALL.macppc (on CD2)</a>
606: <p>
607: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sparc64/INSTALL.sparc64">
608: .../OpenBSD/5.8/sparc64/INSTALL.sparc64 (on CD3)</a>
609: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sparc/INSTALL.sparc">
610: .../OpenBSD/5.8/sparc/INSTALL.sparc (on CD3)</a>
611: <p>
612: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/alpha/INSTALL.alpha">
613: .../OpenBSD/5.8/alpha/INSTALL.alpha</a>
614: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/armish/INSTALL.armish">
615: .../OpenBSD/5.8/armish/INSTALL.armish</a>
616: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.hppa">
617: .../OpenBSD/5.8/hppa/INSTALL.hppa</a>
618: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/landisk/INSTALL.landisk">
619: .../OpenBSD/5.8/landisk/INSTALL.landisk</a>
620: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/loongson/INSTALL.loongson">
621: .../OpenBSD/5.8/loongson/INSTALL.loongson</a>
622: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/luna88k/INSTALL.luna88k">
623: .../OpenBSD/5.8/luna88k/INSTALL.luna88k</a>
624: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/macppc/INSTALL.macppc">
625: .../OpenBSD/5.8/macppc/INSTALL.macppc</a>
626: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/octeon/INSTALL.octeon">
627: .../OpenBSD/5.8/octeon/INSTALL.octeon</a>
628: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sgi/INSTALL.sgi">
629: .../OpenBSD/5.8/sgi/INSTALL.sgi</a>
630: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/socppc/INSTALL.socppc">
631: .../OpenBSD/5.8/socppc/INSTALL.socppc</a>
632: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/sparc/INSTALL.sparc">
633: .../OpenBSD/5.8/sparc/INSTALL.sparc</a>
634: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/vax/INSTALL.vax">
635: .../OpenBSD/5.8/vax/INSTALL.vax</a>
636: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.8/zaurus/INSTALL.zaurus">
637: .../OpenBSD/5.8/zaurus/INSTALL.zaurus</a>
638: </ul>
639: <hr>
640:
641: <p>
642: Quick installer information for people familiar with OpenBSD, and the
643: use of the "disklabel -E" command. If you are at all confused when
644: installing OpenBSD, read the relevant INSTALL.* file as listed above!
645: <p>
646:
647: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
648: <ul>
649: The OpenBSD/i386 release is on CD1.
650: Boot from the CD to begin the install - you may need to adjust
651: your BIOS options first.
652:
653: <p>
654: If your machine can boot from USB, you can write <i>install58.fs</i> or
655: <i>miniroot58.fs</i> to a USB stick and boot from it.
656:
657: <p>
658: If you can't boot from a CD, floppy disk, or USB,
659: you can install across the network using PXE as described in
660: the included INSTALL.i386 document.
661:
662: <p>
663: If you are planning on dual booting OpenBSD with another OS, you will need to
664: read INSTALL.i386.
665:
666: </ul>
667:
668: <p>
669: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
670: <ul>
671: The OpenBSD/amd64 release is on CD2.
672: Boot from the CD to begin the install - you may need to adjust
673: your BIOS options first.
674:
675: <p>
676: If your machine can boot from USB, you can write <i>install58.fs</i> or
677: <i>miniroot58.fs</i> to a USB stick and boot from it.
678:
679: <p>
680: If you can't boot from a CD, floppy disk, or USB,
681: you can install across the network using PXE as described in the included
682: INSTALL.amd64 document.
683:
684: <p>
685: If you are planning to dual boot OpenBSD with another OS, you will need to
686: read INSTALL.amd64.
687: </ul>
688:
689: <p>
690: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
691: <ul>
692: Burn the image from a mirror site to a CDROM, and power on your machine
693: while holding down the <i>C</i> key until the display turns on and
694: shows <i>OpenBSD/macppc boot</i>.
695:
696: <p>
697: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
698: /5.8/macppc/bsd.rd</i>
699: </ul>
700:
701: <p>
702: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
703: <ul>
704: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
705:
706: <p>
707: If this doesn't work, or if you don't have a CDROM drive, you can write
708: <i>CD3:5.8/sparc64/floppy58.fs</i> or <i>CD3:5.8/sparc64/floppyB58.fs</i>
709: (depending on your machine) to a floppy and boot it with <i>boot
710: floppy</i>. Refer to INSTALL.sparc64 for details.
711:
712: <p>
713: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
714: will most likely fail.
715:
716: <p>
717: You can also write <i>CD3:5.8/sparc64/miniroot58.fs</i> to the swap partition on
718: the disk and boot with <i>boot disk:b</i>.
719:
720: <p>
721: If nothing works, you can boot over the network as described in INSTALL.sparc64.
722: </ul>
723:
724: <p>
725: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
726: <ul>
727: <p>Write <i>FTP:5.8/alpha/floppy58.fs</i> or
728: <i>FTP:5.8/alpha/floppyB58.fs</i> (depending on your machine) to a diskette and
729: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
730:
731: <p>
732: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
733: will most likely fail.
734:
735: </ul>
736:
737: <p>
738: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
739: <ul>
740: <p>
741: After connecting a serial port, Thecus can boot directly from the network
742: either tftp or http. Configure the network using fconfig, reset,
743: then load bsd.rd, see INSTALL.armish for specific details.
744: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
745: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
746: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
747: More details are available in INSTALL.armish.
748: </ul>
749:
750: <p>
751: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
752: <ul>
753: <p>
754: Boot over the network by following the instructions in INSTALL.hppa or the
755: <a href="hppa.html#install">hppa platform page</a>.
756: </ul>
757:
758: <p>
759: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
760: <ul>
761: <p>
762: Write <i>miniroot58.fs</i> to the start of the CF
763: or disk, and boot normally.
764: </ul>
765:
766: <p>
767: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
768: <ul>
769: <p>
770: Write <i>miniroot58.fs</i> to a USB stick and boot bsd.rd from it
771: or boot bsd.rd via tftp.
772: Refer to the instructions in INSTALL.loongson for more details.
773: </ul>
774: <p>
775:
776: <p>
777: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
778: <ul>
779: <p>
780: Copy `boot' and `bsd.rd' to a Mach or UniOS partition, and boot the bootloader
1.24 miod 781: from the PROM, and then bsd.rd from the bootloader.
1.1 deraadt 782: Refer to the instructions in INSTALL.luna88k for more details.
783: </ul>
784:
785: <p>
786: <h3><font color="#e00000">OpenBSD/octeon:</font></h3>
787: <ul>
788: <p>
789: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
790: Refer to the instructions in INSTALL.octeon for more details.
791: </ul>
792:
793: <p>
794: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
795: <ul>
796: <p>
797: To install, burn cd58.iso on a CD-R, put it in the CD drive of your
798: machine and select <i>Install System Software</i> from the System Maintenance
799: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
800: CD-ROM, and need a proper invocation from the PROM prompt.
801: Refer to the instructions in INSTALL.sgi for more details.
802:
803: <p>
804: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
805: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
806: system type. Refer to the instructions in INSTALL.sgi for more details.
807: </ul>
808:
809: <p>
810: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
811: <ul>
812: <p>
813: After connecting a serial port, boot over the network via DHCP/tftp.
814: Refer to the instructions in INSTALL.socppc for more details.
815: </ul>
816:
817: <p>
818: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
819: <ul>
820: Boot from one of the provided install ISO images, using one of the two
821: commands listed below, depending on the version of your ROM.
822:
823: <ul><pre>
824: ok <strong>boot cdrom 5.8/sparc/bsd.rd</strong>
825: or
826: > <strong>b sd(0,6,0)5.8/sparc/bsd.rd</strong>
827: </pre></ul>
828:
829: <p>
830: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
831: To do so you need to write <i>floppy58.fs</i> to a floppy.
832: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
833: To boot from the floppy use one of the two commands listed below,
834: depending on the version of your ROM.
835:
836: <ul><pre>
837: ok <strong>boot floppy</strong>
838: or
839: > <strong>b fd()</strong>
840: </pre></ul>
841:
842: <p>
843: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
844: will most likely fail.
845:
846: <p>
847: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
848: setup a bootable tape, or install via network, as told in the
849: INSTALL.sparc file.
850: </ul>
851:
852: <p>
853: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
854: <ul>
855: Boot over the network via mopbooting as described in INSTALL.vax.
856: </ul>
857:
858: <p>
859: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
860: <ul>
861: <p>
862: Using the Linux built-in graphical ipkg installer, install the
863: openbsd58_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
864: for a few important details.
865: </ul>
866:
867: <a name="upgrade"></a>
868: <hr>
869: <p>
870: <h3><font color="#0000e0">How to upgrade</font></h3>
871: <p>
1.2 deraadt 872: If you already have an OpenBSD 5.7 system, and do not want to reinstall,
1.1 deraadt 873: upgrade instructions and advice can be found in the
874: <a href="faq/upgrade58.html">Upgrade Guide</a>.
875:
876: <a name="sourcecode"></a>
877: <hr>
878: <p>
879: <h3><font color="#0000e0">Notes about the source code</font></h3>
880: <p>
881: src.tar.gz contains a source archive starting at /usr/src. This file
882: contains everything you need except for the kernel sources, which are
883: in a separate archive. To extract:
884: <p>
885: <ul><pre>
886: # <strong>mkdir -p /usr/src</strong>
887: # <strong>cd /usr/src</strong>
888: # <strong>tar xvfz /tmp/src.tar.gz</strong>
889: </pre></ul>
890: <p>
891: sys.tar.gz contains a source archive starting at /usr/src/sys.
892: This file contains all the kernel sources you need to rebuild kernels.
893: To extract:
894: <p>
895: <ul><pre>
896: # <strong>mkdir -p /usr/src/sys</strong>
897: # <strong>cd /usr/src</strong>
898: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
899: </pre></ul>
900: <p>
901: Both of these trees are a regular CVS checkout. Using these trees it
902: is possible to get a head-start on using the anoncvs servers as
903: described <a href="anoncvs.html">here</a>.
904: Using these files
905: results in a much faster initial CVS update than you could expect from
906: a fresh checkout of the full OpenBSD source tree.
907: <p>
908:
909: <a name="ports"></a>
910: <hr>
911: <p>
912: <h3><font color="#0000e0">Ports Tree</font></h3>
913: <p>
914: A ports tree archive is also provided. To extract:
915: <p>
916: <ul><pre>
917: # <strong>cd /usr</strong>
918: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
919: </pre></ul>
920: <p>
921: Go read the <a href="faq/ports/index.html">ports</a> page
922: if you know nothing about ports
923: at this point. This text is not a manual of how to use ports.
924: Rather, it is a set of notes meant to kickstart the user on the
925: OpenBSD ports system.
926: <p>
927: The <i>ports/</i> directory represents a CVS (see the manpage for
928: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&sektion=1&arch=i386">
929: cvs(1)</a> if
930: you aren't familiar with CVS) checkout of our ports. As with our complete
931: source tree, our ports tree is available via
932: <a href="anoncvs.html">AnonCVS</a>.
933: So, in order to keep up to date with the <i>-stable</i> branch, you must make
934: the <i>ports/</i> tree available on a read-write medium and update the tree
935: with a command like:
936: <p>
937: <ul><pre>
938: # <strong>cd /usr/ports</strong>
1.2 deraadt 939: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_8</strong>
1.1 deraadt 940: </pre></ul>
941: <p>
942: [Of course, you must replace the server name here with a nearby anoncvs
943: server.]
944: <p>
945: Note that most ports are available as packages on our mirrors. Updated
946: ports for the 5.8 release will be made available if problems arise.
947: <p>
948: If you're interested in seeing a port added, would like to help out, or just
949: would like to know more, the mailing list
950: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
951: <p>
952: </body>
953: </html>