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