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