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