Annotation of www/68.html, Revision 1.60
1.1 benno 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
5: <title>OpenBSD 6.8</title>
6: <meta name="description" content="OpenBSD 6.8">
7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
9: <link rel="canonical" href="https://www.openbsd.org/68.html">
10:
11: <h2 id=OpenBSD>
12: <a href="index.html">
13: <i>Open</i><b>BSD</b></a>
14: 6.8
15: </h2>
16:
17: <table>
18: <tr>
19: <td>
20: <a href="images/XXX.gif">
21: <img width="227" height="343" src="images/XXX-s.gif" alt="XXX"></a>
22: <td>
23: Released Oct XXX, 2020<br>
24: Copyright 1997-2020, Theo de Raadt.<br>
25: <br>
26: <br>
27: Artwork by XXX.
28: <br>
29: <ul>
30: <li>See the information on <a href="ftp.html">the FTP page</a> for
31: a list of mirror machines.
32: <li>Go to the <code class=reldir>pub/OpenBSD/6.8/</code> directory on
33: one of the mirror sites.
34: <li>Have a look at <a href="errata68.html">the 6.8 errata page</a> for a list
35: of bugs and workarounds.
36: <li>See a <a href="plus68.html">detailed log of changes</a> between the
37: 6.7 and 6.8 releases.
38: <p>
39: <li><a href="https://man.openbsd.org/signify.1">signify(1)</a>
40: pubkeys for this release:<p>
41:
42: <table class=signify>
43: <tr><td>
44: openbsd-68-base.pub:
45: <td>
46: <a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/openbsd-68-base.pub">
47: RWQZj25CSG5R2oLo5735Hh6C48kkjFsj5rJDjW+fGZwyY+BkD5/zps8f
48: <tr><td>
49: openbsd-68-fw.pub:
50: <td>
51: RWSYx4htNi/zavF8ZToMBDFz2xymRfFnnR1MEKV9csYbvnrTBwdkXhdy
52: <tr><td>
53: openbsd-68-pkg.pub:
54: <td>
55: RWQlDXyHx5KlPoEiz4yWRK/Gt/rvPwI8KEAt3utge/dBS7R+EscdzA5K
56: <tr><td>
57: openbsd-68-syspatch.pub:
58: <td>
59: RWRWuHkSV0U8PUX24vGa3ywrvKNQY6llV3PLvKEzDTiTVPfIRaXPfvzR
60: </table>
61: </ul>
62: <p>
63: All applicable copyrights and credits are in the src.tar.gz,
64: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
65: files fetched via <code>ports.tar.gz</code>.
66: </table>
67:
68: <hr>
69:
70: <section id=new>
71: <h3>What's New</h3>
72: <p>
73: This is a partial list of new features and systems included in OpenBSD 6.8.
74: For a comprehensive list, see the <a href="plus68.html">changelog</a> leading
75: to 6.8.
76:
77: <ul>
78:
1.17 kettenis 79: <li>New/extended platforms:
80: <ul>
81: <li>New <a href="https://www.openbsd.org/powerpc64.html">powerpc64</a>
82: platform, supporting PowerNV (non-virtualized) systems with
83: POWER8 and POWER9 CPUs, such as Raptor Computing Systems Talos
84: II and Blackbird systems. POWER8 support has not been tested
85: on real hardware yet.
86: </ul>
87:
1.40 schwarze 88: <li>Improvements to time measurements, mostly in the kernel:
1.1 benno 89: <ul>
1.3 benno 90: <li>Added support in the kernel and libc for timecounting in
91: userland, eliminating the need for a context switch everytime a
92: process requests the current time, thereby improving speed and
93: responsiveness in programs which make many <a
94: href="https://man.openbsd.org/gettimeofday">gettimeofday(2)</a> calls,
95: especially browsers and office software.<br>The userland timecounters
96: are enabled on the amd64, arm64, macppc, octeon and sparc64
1.18 kettenis 97: architectures.
1.40 schwarze 98: <li>Added a <a href="https://man.openbsd.org/ktrace">ktrace(1)</a> -T option to make time-related system calls more prominent.
99: <li>Added tsc_delay(), a <a href="https://man.openbsd.org/delay">delay(9)</a> implementation based on the TSC, to amd64.
100: <li>Used an LFENCE instruction everywhere RDTSC is used for a time measurement, reducing the jitter in TSC skew measurements.
101: <li>Introduced <a href="https://man.openbsd.org/gettime">gettime(9)</a> and <a href="https://man.openbsd.org/getuptime">getuptime(9)</a> and substituted these for time_second(9) and time_uptime(9) throughout the kernel to prevent split-read problems on 32-bit platforms.
102: <li>Synchronized each core's CP0 cycle counter using the IO clock counter on mips64 and octeon, making the cycle counter usable as timecounter.
103: <li>Improved CPU frequency scaling in automatic performance mode by removing accounting for offline CPUs.
104: </ul>
1.3 benno 105:
1.40 schwarze 106: <li>Various kernel improvements:
107: <ul>
108: <li>Added <a href="https://man.openbsd.org/intrmap_create">intrmap</a>, an interrupt to CPU mapping API that is used by hardware drivers to use multiple CPUs for interrupt handling.
109: <li>Added an ioctl PCIOCGETVPD allowing userland to access read-only support information about pci devices via the vpd register.
1.1 benno 110: <li>Set <a href="https://man.openbsd.org/ddb">ddb(4)</a> "/t" to show a trace via TID on all architectures.
1.40 schwarze 111: <li>Introduced <a href="https://man.openbsd.org/kstat">kstat(1)</a>, a subsystem to allow the kernel to expose statistics to userland.
112: <li>Added kstat to <a href="https://man.openbsd.org/cnmac">cnmac(4)</a>.
113: <li>Added support for remote coverage to <a href="https://man.openbsd.org/kcov">kcov(4)</a>.
114: <li>Moved <a href="https://man.openbsd.org/sysctl">sysctl(2)</a> CTL_DEBUG from DEBUG to the new DEBUG_SYSCTL.
115: <li>Prevented creation of bogus <a href="https://man.openbsd.org/sd">sd(4)</a> devices for <a href="https://man.openbsd.org/nvme">nvme(4)</a> namespaces which are configured but have size 0.
116: <li>Used READ(16)/WRITE(16) commands for disks large enough to require them to access the last sectors, fixing large 512E devices plugged into USB to ATA/ATAPI bridges which mistakenly use 4K sector addresses/sizes.
1.1 benno 117: <li>Restored VGA fonts on VT switch, preventing an unusable screen when switching to a VT with a custom VGA font from X.
1.40 schwarze 118: <li>Ensured only pseudo-terminal devices use reprint delays.
119: <li>Prevented improper disabling of the backlight in <a href="https://man.openbsd.org/umstc">umstc(4)</a> when brightness is adjusted to 0.
120: <li>Provided an optimized implementation of <a href="https://man.openbsd.org/ffs">ffs(3)</a> in the kernel on arm64/powerpc/powerpc64.
1.1 benno 121: <li>Rewrote m88k mutex code as a slight variation of the MI mutex code, potentially improving stability and rendering mutex spinning time visible in <a href="https://man.openbsd.org/top">top(1)</a>.
1.40 schwarze 122: <li>Reworked kernel loading with <a href="https://man.openbsd.org/octboot">octboot(4)</a>, which now does not rely on a mounted filesystem.
123: </ul>
124:
125: <li>Various new userland features:
126: <ul>
127: <li>Imported <a href="https://man.openbsd.org/login_ldap">login_ldap(8)</a>, using <a href="https://man.openbsd.org/ldap">ldap(1)</a> rather than openldap.
128: <li>Added support for set -o pipefail to <a href="https://man.openbsd.org/ksh">ksh(1)</a>, potentially helping error checking.
129: <li>Cleared the screen in <a href="https://man.openbsd.org/ksh">ksh(1)</a>'s vi editing mode before redrawing the line with ^L.
130: <li>Implemented the gensub(), systime() and strftime() functions for <a href="https://man.openbsd.org/awk">awk(1)</a>.
131: <li>Allowed specification of supported TLS protocols in <a href="https://man.openbsd.org/ftp">ftp(1)</a> "-S protocols".
132: <li>Switched the default <a href="https://man.openbsd.org/man.1">man(1)</a> pager from "<a href="https://man.openbsd.org/more.1">more(1)</a> -s" to <a href="https://man.openbsd.org/less.1">less(1)</a>.
133: <li>Supported -T html -O tag in <a href="https://man.openbsd.org/man.1">man(1)</a> by passing a file:// URI to the pager.
134: <li>Added <a href="https://man.openbsd.org/fstat">fstat(1)</a> support for looking up unix domain sockets by file name.
135: <li>Added / as an alias for g (grep) in <a href="https://man.openbsd.org/top">top(1)</a>.
136: <li>Provided a naptime variable for userspace via <a href="https://man.openbsd.org/kvm_read">kvm_read(3)</a>, usable by <a href="https://man.openbsd.org/vmstat">vmstat(8)</a>.
1.1 benno 137: <li>Allowed switching between alternate devices (-F) with <a href="https://man.openbsd.org/sndioctl">sndioctl(1)</a>.
138: <li>Added the ability to set and display <a href="https://man.openbsd.org/video">video(1)</a> control values directly on the CLI.
139: <li>Allowed the combination of <a href="https://man.openbsd.org/video">video(1)</a> "-dc" options, reset and display control values.
1.40 schwarze 140: <li>Added <a href="https://man.openbsd.org/video">video(1)</a> white balance temperature control through w/W keys.
1.1 benno 141: <li>Added control for backlight compensation to <a href="https://man.openbsd.org/video">video(4)</a>.
1.40 schwarze 142: <li>Initialized v4l2_requestbuffers for libv4l compatibility, allowing view of video encodings not directly supported by <a href="https://man.openbsd.org/video">video(1)</a>.
143: <li>Added a new column to <a href="https://man.openbsd.org/wsfontload">wsfontload(8)</a> -l output to report the number of characters contained in a loaded font.
144: <li>Relaxed filename checks in <a href="https://man.openbsd.org/syspatch">syspatch(8)</a> to allow use of hyphens.
145: <li>Enabled <a href="https://man.openbsd.org/btrace">btrace(8)</a> (<a href="https://man.openbsd.org/dt">dt(4)</a> not yet enabled in GENERIC, though).
146: <li>Added <a href="https://man.openbsd.org/btrace">btrace(8)</a> -p flag to filter all actions by PID.
147: <li>Implemented linear and power-of-two histograms in bt(5).
148: <li>Added support for "&" and "|" operators in btrace scripts.
149: </ul>
150:
151: <li>Various bugfixes and tweaks in userland:
152: <ul>
153: <li>Fixed the <a href="https://man.openbsd.org/ksh">ksh(1)</a> exit code when evaluating a || compound list to prevent termination of the shell when running under -e.
154: <li>Fixed "$@" splitting with empty IFS in <a href="https://man.openbsd.org/ksh">ksh(1)</a>.
155: <li>Stopped incrementing openclass for a literal "[" in <a href="https://man.openbsd.org/awk">awk(1)</a>, allowing parsing of expressions such as "/[[/[]/".
156: <li>Fixed <a href="https://man.openbsd.org/make">make(1)</a> :S with anchors and replacement.
157: <li>Prevented <a href="https://man.openbsd.org/mg">mg(1)</a> from running out of memory or segfaulting with <code>query-replace-regex ^</code>.
158: <li>Fixed <a href="https://man.openbsd.org/ls">ls(1)</a> -R mode to not display subdirectories of a directory beginning with '.' and ensure directory names are always displayed.
1.1 benno 159: <li>Prevented a core dump in <a href="https://man.openbsd.org/ftp">ftp(1)</a> during fetch abort.
160: <li>Taught <a href="https://man.openbsd.org/su">su(1)</a> -l -f to start a regular shell for non-csh shells rather than a login shell.
161: <li>Used <a href="https://man.openbsd.org/su">su(1)</a> -fl to avoid sourcing the target user's .profile in <a href="https://man.openbsd.org/rc.d">rc.d(8)</a>/<a href="https://man.openbsd.org/rcctl">rcctl(8)</a>.
1.40 schwarze 162: <li>Fixed merging of files that lack newlines for <a href="https://man.openbsd.org/diff3">diff3(1)</a>, OpenRCS and OpenCVS.
163: <li>Prevented <a href="https://man.openbsd.org/rcs">rcs(1)</a> removal of locked revisions with rcs -orange, avoiding leaving behind a lock for a revision which no longer exists.
164: <li>Fixed <a href="https://man.openbsd.org/sndiod">sndiod(8)</a> crashes when USB devices are disconnected.
165: <li>Fixed the initial <a href="https://man.openbsd.org/sndiod">sndiod(8)</a> alternate device number, preventing device number 1 from being skipped on first use.
166: <li>Switched the default CDDB database for <a href="https://man.openbsd.org/cdio">cdio(1)</a> to gnudb.gnudb.org:8880.
1.7 jsg 167: <li>Stopped <a href="https://man.openbsd.org/syslogd">syslogd(8)</a> from closing UDP sockets for sending messages when DNS lookup of a UDP loghost fails, allowing them to be used to send if DNS is working during the next SIGHUP.
1.1 benno 168: <li>Prevented established TCP and TLS sockets of <a href="https://man.openbsd.org/syslogd">syslogd(8)</a> from staying open forever if a client aborted the connection silently.
1.40 schwarze 169: <li>Avoided reading one byte before the path buffer in <a href="https://man.openbsd.org/mountd">mountd(8)</a>.
1.1 benno 170: <li>Made <a href="https://man.openbsd.org/apmd">apmd(8)</a> always ask the kernel about current hw.perfpolicy rather than maintaining state.
1.40 schwarze 171: <li>Prevented an <a href="https://man.openbsd.org/unveil">unveil(2)</a> failure with chdir / on <a href="https://man.openbsd.org/sensorsd">sensorsd(8)</a>.
172: <li>Corrected <a href="https://man.openbsd.org/getopt_long">getopt_long(3)</a> parsing of a trailing dash in an option group, which was being incorrectly returned as an argument.
173: <li>Prevented callers inspecting unrelated fields in the libc resolver function asr_run().
174: <li>Introduced a darker <a href="https://man.openbsd.org/xenodm">xenodm(1)</a> login widget and a lower contrast default background.
175: <li>Fixed an <a href="https://man.openbsd.org/xconsole">xconsole(1)</a> crash by starting it after setting the background.
1.1 benno 176: </ul>
177:
178: <li>Improved hardware support and driver bugfixes, including:
179: <ul>
180: <li>Enabled scrollback in <a href="https://man.openbsd.org/simplefb">simplefb(4)</a>.
181: <li>Fixed display glitches on smaller screens or with larger fonts in <a href="https://man.openbsd.org/efifb">efifb(4)</a> associated with remapping and attaching.
182: <li>Improved reporting of remaining power with batteries of different capacities in <a href="https://man.openbsd.org/acpi">acpi(4)</a>.
183: <li>Fixed bogus frame sizes being returned by <a href="https://man.openbsd.org/xhci">xhci(4)</a>.
184: <li>Added <a href="https://man.openbsd.org/wsmoused">wsmoused(8)</a> support to <a href="https://man.openbsd.org/efifb">efifb(4)</a>.
185: <li>Added <a href="https://man.openbsd.org/umstc">umstc(4)</a>, a driver for Microsoft Surface Type Cover keyboards.
186: <li>Introduced <a href="https://man.openbsd.org/acpihid">acpihid(4)</a> for ACPI HID event and 5-button array devices.
187: <li>Moved Powerbook5,4 audio from <a href="https://man.openbsd.org/aoa">aoa(4)</a> to <a href="https://man.openbsd.org/snapper">snapper(4)</a>, adding the missing TAS3004 volume control.
188: <li>Fixed broken HID descriptors of Elecom trackballs with 6 or 8 buttons.
189: <li>Added RK3328 PWM, also found in the RK3308, to <a href="https://man.openbsd.org/rkpwm">rkpwm(4)</a>.
190: <li>Added RK3308 temperature sensors to <a href="https://man.openbsd.org/rktemp">rktemp(4)</a>.
1.32 patrick 191: <li>Added <a href="https://man.openbsd.org/pcamux">pcamux(4)</a>, a driver for the PCA9548 I2C switch.
1.6 jsg 192: <li>Introduced a framework for digital audio interfaces, and added <a href="https://man.openbsd.org/simpleaudio">simpleaudio(4)</a>, a driver for "simple audio cards." This is a wrapper connecting the I2S controller, the codec and some aux devices, and <a href="https://man.openbsd.org/simpleamp">simpleamp(4)</a>, a driver for "simple audio amplifier," one of the aux devices for <a href="https://man.openbsd.org/simpleaudio">simpleaudio(4)</a>.
1.1 benno 193: <li>Enabled <a href="https://man.openbsd.org/nvme">nvme(4)</a> on i386.
194: <li>Added support for the Ericsson F5521gw Mobile Broadband Modem.
195: <li>Ensured the STOP command sent by <a href="https://man.openbsd.org/sd">sd(4)</a> on powerdown will not result in hanging the machine if commands to the USB mass storage fail.
196: <li>Fixed intermittent failing <a href="https://man.openbsd.org/pms">pms(4)</a> device initialization seen on some Synaptics devices.
197: <li>Corrected trackstick/button attachment of Windows Precision Touchpad <a href="https://man.openbsd.org/imt">imt(4)</a> devices, fixing behavior on certain Dell Latitude laptops.
198: <li>Improved speed of scrolling by optimizing <a href="https://man.openbsd.org/rasops">rasops(9)</a> write-only framebuffer console.
199: <li>Modified <a href="https://man.openbsd.org/uvideo">uvideo(4)</a> to fix webcam detection in Firefox 78.
200: <li>Added a SENSOR_ENERGY sensor type to the <a href="https://man.openbsd.org/sensor_attach">sensors framework API</a> which uses microjoules.
201: <li>Added support for the AMDI0010 touchpad on the Inspiron 5505.
202: <li>Avoided nvram lock timeout on sparc64 systems with onboard BCM5704 <a href="https://man.openbsd.org/bge">bge(4)</a> instances that come without a fitted EEPROM/NVRAM.
203: <li>Added <a href="https://man.openbsd.org/pms">pms(4)</a> support for the Elantech v1 touchpad with firmware version 0x20022.
204: <li>Added <a href="https://man.openbsd.org/sdmmc">sdmmc(4)</a> support for eMMC HS200 mode.
205: <li>Added Exar XR17V35x serial port support.
206: <li>Properly implemented <a href="https://man.openbsd.org/amlmmc">amlmmc(4)</a> setting of signal voltage.
207: <li>Implemented UHS-I support in the <a href="https://man.openbsd.org/sdmmc">sdmmc(4)</a> midlayer and enabled it in <a href="https://man.openbsd.org/amlmmc">amlmmc(4)</a>.
208: <li>Introduced <a href="https://man.openbsd.org/abl">abl(4)</a>, a new driver to control the backlight brightness on Intel-based Apple machines, and allowed it to be controlled through <a href="https://man.openbsd.org/wsconsctl">wsconsctl(8)</a>.
209: <li>Disabled <a href="https://man.openbsd.org/acpivout">acpivout(4)</a> brightness control on machines aware of Windows 8, enabling inteldrm to handle brightness ioctls.
210: <li>Fixed <a href="https://man.openbsd.org/eeprom">eeprom(8)</a> error when setting variables on macppc.
1.4 jsg 211: <li>Updated <a href="https://man.openbsd.org/drm">drm(4)</a> to Linux 5.7.19.
1.1 benno 212: </ul>
213: <li>New or improved network hardware support:
214: <ul>
1.34 jmatthew 215: <li>Enabled multiple tx/rx queues with Toeplitz RSS hashing in <a href="https://man.openbsd.org/vmx">vmx(4)</a>, <a href="https://man.openbsd.org/ix">ix(4)</a> and <a href="https://man.openbsd.org/ixl">ixl(4)</a>.
1.48 jmatthew 216: <li>Added support for hardware VLAN tagging and checksumming to <a href="https://man.openbsd.org/mcx">mcx(4)</a> and <a href="https://man.openbsd.org/bnxt">bnxt(4)</a>.
1.1 benno 217: <li>Fixed a crash in <a href="https://man.openbsd.org/re">re(4)</a>.
1.7 jsg 218: <li>Added <a href="https://man.openbsd.org/bge">bge(4)</a> support for the BCM5719 A1 Ethernet controller.
1.1 benno 219: <li>Handled AGL interfaces on octeon, making management network ports usable on some machines.
220: <li>Added support for the <a href="https://man.openbsd.org/mcx">mcx(4)</a> ConnectX-6 Dx.
221: <li>Fixed a potential crash when bringing down an <a href="https://man.openbsd.org/mcx">mcx(4)</a> interface.
222: <li>Increased the <a href="https://man.openbsd.org/mcx">mcx(4)</a> event queue size, preventing a potential interrupt storm on the ConnectX-4.
223: <li>Fixed outbound <a href="https://man.openbsd.org/bpf">bpf(4)</a> tap on <a href="https://man.openbsd.org/ogx">ogx(4)</a> interfaces.
1.29 jsg 224: <li>Improved <a href="https://man.openbsd.org/ure">ure(4)</a> performance by combining multiple sent packets into one transfer.
225: <li>Added support for RK3308 Ethernet to <a href="https://man.openbsd.org/dwge">dwge(4)</a>.
1.31 kevlo 226: <li>Added <a href="https://man.openbsd.org/rge">rge(4)</a> support for newer RTL8125 chipset (RTL8125B).
1.1 benno 227: </ul>
228: <li>Added or improved wireless network drivers:
229: <ul>
230: <li>Added support to <a href="https://man.openbsd.org/urtwn">urtwn(4)</a> for TP-Link TL-WN822N-EU v5 (and v4).
1.33 benno 231: <li>Added WPA2 (CCMP) crypto offload support to <a href="https://man.openbsd.org/iwm">iwm(4)</a> and
232: <a href="https://man.openbsd.org/iwx">iwx(4)</a>,
233: reducing CPU load during traffic bursts.
234: <li>Fixed causes of several fatal firmware errors on <a href="https://man.openbsd.org/iwx">iwx(4)</a> devices.
1.1 benno 235: <li>Added <a href="https://man.openbsd.org/bwfm">bwfm(4)</a> support for BCM4359 SDIO variants such as the AP6359SA module found on the RockPro64 WiFi module.
236: <li>Enabled critical temperature detection in <a href="https://man.openbsd.org/iwx">iwx(4)</a> firmware.
237: <li>Fixed mbuf leak in <a href="https://man.openbsd.org/urtwn">urtwn(4)</a> with frames CCMP-encrypted by hardware.
238: <li>Added support for the D-Link DWA-121 rev B1 <a href="https://man.openbsd.org/urtwn">urtwn(4)</a> device.
239: <li>Repaired <a href="https://man.openbsd.org/athn">athn(4)</a> in client mode against WPA2 access points.
1.33 benno 240: <li>Prevented a panic where <a href="https://man.openbsd.org/athn">athn(4)</a> attempted to transmit old, unencryptable frames after switching to a new group key in hostap mode.
1.1 benno 241: <li>Switched <a href="https://man.openbsd.org/iwx">iwx(4)</a> from -46 to -48 firmware.
242: <li>Enabled background scanning on <a href="https://man.openbsd.org/iwx">iwx(4)</a> devices.
243: <li>Fixed gain calibration for some <a href="https://man.openbsd.org/iwn">iwn(4)</a> devices (5000 and up).
244: <li>Added support for AX201 devices to <a href="https://man.openbsd.org/iwx">iwx(4)</a>.
245: </ul>
246:
247: <li>New <a href="https://www.openbsd.org/arm64.html">arm64</a> and <a
248: href="https://www.openbsd.org/armv7.html">armv7</a> hardware support
249: and bugfixes, including:
250: <ul>
251: <li>Added <a href="https://man.openbsd.org/amlpwrc">amlpwrc(4)</a>, a driver for the power domain controller found on Amlogic SoCs.
1.7 jsg 252: <li>Made OpenBSD boot on the ODROID-C4 with power domain in <a href="https://man.openbsd.org/amldwusb">amldwusb(4)</a>.
1.1 benno 253: <li>Added support for the SD card detect pins on the Turris Mox.
1.29 jsg 254: <li>Added support for the Marvell Xenon SDHC, used as storage on the Armada 3700 and 8040 SoCs.
1.7 jsg 255: <li>Opened up a 4GB memory bus window for <a href="https://man.openbsd.org/mvneta">mvneta(4)</a> on the Marvell Armada 3700, making the second Ethernet controller/port work on the Turris Mox.
1.1 benno 256: <li>Added <a href="https://man.openbsd.org/mvkpcie">mkvpcie(4)</a>, a driver for the Aardvark PCIe controller found on the Armada 3700 SoC.
257: <li>Adjusted <a href="https://man.openbsd.org/dwpcie">dwpcie(4)</a> timing to improve likelihood of a successful PCIe link on the i.MX8MM. Avoids a failure to detect <a href="https://man.openbsd.org/em">em(4)</a> on the HummingBoard Pulse.
258: <li>Added <a href="https://man.openbsd.org/cwfg">cwfg(4)</a>, a driver for the Cellwise CW201x fuel gauge on the Pinebook Pro.
259: <li>Populated a list of 256 brightness levels as a fallback when the device tree does not specify a list, making the Pinebook Pro display work with the dtb from Linux 5.7.
260: <li>Added <a href="https://man.openbsd.org/escodec">escodec(4)</a>, a driver for the Everest ES8316 audio codec used on the Pinebook Pro.
1.6 jsg 261: <li>Added <a href="https://man.openbsd.org/rkiis">rkiis(4)</a>, a driver for the I2S controller found on the Rockchip RK3399.
1.1 benno 262: <li>Added <a href="https://man.openbsd.org/bcmtmon">bcmtmon(4)</a>, a driver for the temperature sensor on the Raspberry Pi 4.
263: <li>Introduced <a href="https://man.openbsd.org/mvpp">mvpp(4)</a>, a driver for the Marvell Packet Processor v2 as used on the Armada 7K and 8K SoCs.
264: <li>Improved PLL1(CPU_PLL) stability for the Allwinner H3/H2+.
1.40 schwarze 265: <li>Ported NetBSD's arm64 disassembler for <a href="https://man.openbsd.org/ddb">ddb(4)</a>.
266: <li>Enabled spleen16x32 and spleen32x64 fonts on armv7 for GENERIC kernels.
267: <li>Enabled building <a href="https://man.openbsd.org/wsmoused">wsmoused(8)</a> and <a href="https://man.openbsd.org/wsfontload">wsfontload(8)</a> on arm64 and armv7.
1.1 benno 268: </ul>
269:
270: <li>IEEE 802.11 wireless stack improvements and bugfixes:
271: <ul>
272: <li>Fixed CCMP replay checks with 11n Rx aggregation and CCMP hardware offloading.
1.33 benno 273: <li>In hostap mode, complete WPA group key renewals immediately if no station is associated.
1.1 benno 274: <li>Improved processing of lost frames during 802.11 Rx aggregation.
275: <li>Allowed passage of unencrypted 802.11 frames during hardware decryption post-processing, fixing failure of some <a href="https://man.openbsd.org/ral">ral(4)</a> devices to receive packets on encrypted networks.
276: <li>Prevented a use-after-free when a wireless device is detached.
277: </ul>
278:
279: <li>Generic network stack improvements and bugfixes:
280: <ul>
281: <!-- carp and pf -->
282: <li>Implemented a <a href="https://man.openbsd.org/carp">carp(4)</a> transmit bypassing the ifq on output, enqueuing the packet directly on the parent interface.
283: <li>Fixed <a href="https://man.openbsd.org/pf.conf">pf.conf(5)</a> "route-to TABLE least-states" in an anchor.
284: <li>Allowed <a href="https://man.openbsd.org/pf">pf(4)</a> to divert packets from <a href="https://man.openbsd.org/bridge">bridge(4)</a> to local socket.
285: <li>Rehashed main <a href="https://man.openbsd.org/pf">pf(4)</a> rulesets after rule expiration.
286: <li>Added a check for <a href="https://man.openbsd.org/pfctl">pfctl(8)</a> that an rtable exists when parsing the config.
1.24 kn 287: <li>Corrected ruleset checksum calculation to allow <a href="https://man.openbsd.org/pfsync">pfsync(4)</a> to verify rulesets are identical on all nodes.
1.1 benno 288: <!-- wg -->
1.7 jsg 289: <li>Added <a href="https://man.openbsd.org/wg">wg(4)</a>, an in-kernel driver for WireGuard VPN communication.
1.1 benno 290: <!-- network pseudo drivers and other kernel network internals -->
291: <li>Protected the whole <a href="https://man.openbsd.org/pipex">pipex(4)</a> layer by NET_LOCK().
292: <li>Stopped creation of non-existent <a href="https://man.openbsd.org/bridge">bridge(4)</a> interfaces.
293: <li>Added a symmetric toeplitz implementation with integration for nics, usable through the <a href="https://man.openbsd.org/stoeplitz_to_key">stoeplitz_to_key(9)</a> hash algorithm API.
294: <li>Changed <a href="https://man.openbsd.org/tpmr">tpmr(4)</a> from ifconfig [-]trunkport to add|del synopsis.
295: <li>Filtered vlan and svlan packets by default for <a href="https://man.openbsd.org/tpmr">tpmr(4)</a>.
296: <li>Implemented IPv6 source address selection as outlined in RFC 6724 section 5.
297: <li>Set IPv6 source address selection to prefer the address with the highest preferred lifetime in case of a tie.
298: <li>Stopped preventing TCP connections to IPv6 anycast addresses.
299: <li>Added the <a href="https://man.openbsd.org/pcap-filter">pcap-filter(5)</a> "sample NUM" primitive to allow capture of 1/NUM packets.
300: <li>Added a <a href="https://man.openbsd.org/man4/route.4">ROUTE_FLAGFILTER</a> socket option for routing sockets, allowing routing daemons to opt out of receiving messages for L2 and broadcast route entries.
301: <li>Allowed SIOCSWGDPID and SIOCSWGMAXFLOW ioctls for non-root, preventing <a href="https://man.openbsd.org/switch">switch(4)</a> interfaces from appearing partially as <a href="https://man.openbsd.org/bridge">bridge(4)</a> devices for unprivileged users running <a href="https://man.openbsd.org/ifconfig">ifconfig(8)</a>.
302: <li>Modified <a href="https://man.openbsd.org/trunk">trunk(4)</a> to keep port interfaces UP on removal, matching <a href="https://man.openbsd.org/aggr">aggr(4)</a> behavior.
1.25 kn 303: <li>Fixed <a href="https://man.openbsd.org/rdomain">rdomain(4)</a> handling for IPv6.
304: <li>Fixed <a href="https://man.openbsd.org/rtable">rtable(4)</a> separation of raw sockets for IPv6.
305: <li>Documented <a href="https://man.openbsd.org/rtable">rtable(4)</a> removal semantics.
1.1 benno 306: </ul>
307:
308: <li>Installer improvements:
309: <ul>
1.36 florian 310: <li>On systems with multiple root disks, the installer will upgrade the disk with auto_upgrade.conf present when the upgrade was initiated by <a href="https://man.openbsd.org/sysupgrade">sysupgrade(8)</a>.
1.1 benno 311: <li>Changed install images called *.fs to *.img to accommodate some UEFI bootloaders.
1.40 schwarze 312: <li>Forced long-names on msdos filenames for installboot on most 32-bit architectures.
313: <li>Converted macppc, octeon and loongson to use machine-independent installboot.
314: <!-- FFS2 -->
315: <li>Improvements in the FFS2 filesystem:
316: <ul>
317: <li>Made FFS2 the default for <a href="https://man.openbsd.org/newfs">newfs(8)</a>, except for mfs.
1.44 otto 318: <li>Improved reliability of very large FFS2 filesystems.
319: <li>Improved speed of checking FFS2 filesystems.
1.40 schwarze 320: <li>Enabled the FFS2 option on the luna88k ramdisk.
321: <li>Made FFS2 the default non-root filesystems on landisk, sgi and luna88k.
322: </ul>
1.1 benno 323: </ul>
324:
325: <li>Security improvements:
326: <ul>
327: <li>Added RB_GOODRANDOM passed from bootloader to kernel in boothowto, indicating confidence a "great seed" was loaded.
328: <li>Passed boothowto from the sparc64 bootloader to the kernel using .openbsd.bootdata.
329: <li>Introduced detection of /etc/random.seed reuse.
330: <li>Rewrote the entropy enqueue ring to collect damage asynchronously and adapted the dequeue to mix a selection of "best" ring entries, exponentially backing off the dequeue timeout, to compensate rapidly for weak seeding in unidentifiable conditions and ensure quality to arc4random() calls early in boot.
331: <li>Enabled PAN (Privileged Access Never) on arm64 CPUs supporting it.
332: <li>Skipped scanning file systems which are both nodev and nosuid for SUID, SGID and device files with <a href="https://man.openbsd.org/security">security(8)</a>.
1.41 deraadt 333: <li>Fixed two out-of-bounds array accesses in ioctl code pathways in
334: <a href="https://man.openbsd.org/wscons">wscons(4)</a>.
335: <li>Fixed information leak in semctl SEM_GET.
336: <li>Prevented root from freezing the UTC clock with <a href="https://man.openbsd.org/settimeofday">settimeofday(2)</a> at securelevel 2.
337: <li>Fixed performance problems relating to tty subsystem abuse.<!-- tty.c,v 1.158 2020/07/14 14:33:03 deraadt -->
338: <li>Fixed heap corruption in the X input method client in libX11.
339: <li>Fixed potential information leak via X server pixel data uninitialized memory.
340: <li>Fixed a race condition for isoc devices during device close.
341: <li>Fixed an integer overflow in libX11 which could lead to a double free.
342: <li>Corrected multiple input validation deficits in X server extensions.
1.1 benno 343: </ul>
344:
345: <li>Routing daemons and other userland network improvements:
346: <ul>
347: <!-- bgpd -->
348: <li>In <a href="https://man.openbsd.org/bgpctl">bgpctl(8)</a>, the
349: "reload" command now takes a 'reason' argument to use as
1.7 jsg 350: Administrative Shutdown Communication to its neighbors.
1.1 benno 351: <li>Added <a href="https://man.openbsd.org/bgpctl">bgpctl(8)</a>
352: support for VPNv6 in the family option of the "show rib" command.
1.50 job 353: <li>Added <a href="https://man.openbsd.org/bgpctl">bgpctl(8)</a>
354: support for JSON formatted output in various "show" commands.
1.1 benno 355: <!-- OSPF -->
356: <li>Improve performance of <a href="https://man.openbsd.org/ospfd">ospfd(8)</a>, <a href="https://man.openbsd.org/ospf6d">ospf6d(8)</a> by using the ROUTE_FLAGFILTER setsockopt to filter out routing socket messages
357: for L2 and broadcast routes.
358: <!-- ldap -->
359: <li>Modified <a href="https://man.openbsd.org/ldapd">ldapd(8)</a> use of "ldaps" and "tls" keywords to enable only the libtls defaults for protocols and ciphers. The new "legacy" keyword can be used before these keywords in <a href="https://man.openbsd.org/ldapd.conf">ldapd.conf(5)</a> to enable them all.
360: <li>Added a bsd.schema to <a href="https://man.openbsd.org/ldapd">ldapd(8)</a> including a shadowPassword and an sshPublicKey attribute which can be used to extend existing LDAP users with the additional bsdAccount objectclass.
361: <!-- snmpd -->
362: <li>Removed support for the socket keyword in <a href="https://man.openbsd.org/snmpd.conf">snmpd.conf(5)</a>.
363: <li>Allowed <a href="https://man.openbsd.org/snmp">snmp(1)</a> mibtree to take one or more arguments to be converted to a chosen output format.
364: <!-- httpd and relayd -->
365: <li>Introduced a "dark mode" for directory listings and error pages in <a href="https://man.openbsd.org/httpd">httpd(8)</a>.
366: <li>Allowed specifying -d multiple times in <a href="https://man.openbsd.org/slowcgi">slowcgi(8)</a>.
367: <li>Added <a href="https://man.openbsd.org/unveil">unveil(2)</a> to the main process of <a href="https://man.openbsd.org/relayd">relayd(8)</a>.
368: <li>Added support for non-localhost fastcgi sockets to <a href="https://man.openbsd.org/httpd.conf">httpd.conf(5)</a>.
369: <!-- rpki-client -->
370: <li>Fixed a hang in <a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a> by properly waiting for exiting <a href="https://man.openbsd.org/openrsync">openrsync(1)</a> processes.
371: <li>Removed the -f (force) option in <a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a>.
1.53 tb 372: <li><a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a> no longer uses <a href="https://man.openbsd.org/openrsync">openrsync(1)</a>'s "--delete" to clean up stale files, but instead relies on cryptographically signed RPKI manifest listings.
1.7 jsg 373: <li>Fixed <a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a> return value check for OpenSSL API used during pubkey validation.
1.1 benno 374: <li>Released <a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a> 6.7p1 including OpenBSD 6.7 Errata 015.
375: <li>Changed <a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a> -n behavior to automatically validate the repo.
376: <li>Added a "-s timeout" feature to <a href="https://man.openbsd.org/rpki-client">rpki-client(8)</a> with a one hour default, allowing fresh attempts with <a href="https://man.openbsd.org/cron">cron(8)</a> if rpki-client gets stuck.
377: <!-- other userland -->
1.37 florian 378: <li>Added an optional "domain name" <a href="https://man.openbsd.org/acme-client.conf">acme-client.conf(5)</a> option allowing use of multiple domain sections with the same name and creation of an rsa and an ecdsa key for the same domain name.
379: <li>Added an optional "contact" <a href="https://man.openbsd.org/acme-client.conf">acme-client.conf(5)</a> option to the account section allowing issuance of certificates from authorities that require a contact email address.
1.1 benno 380: <li>Added <a href="https://man.openbsd.org/netstat">netstat(1)</a> -R to show a summary of rdomains with associated interfaces and tables.
381: <li>Defaulted to showing full IPv6 address entries in the routing tables displayed by <a href="https://man.openbsd.org/route">route(8)</a> show and <a href="https://man.openbsd.org/netstat">netstat(1)</a> -r.
1.27 kn 382: <li>Fixed <a href="https://man.openbsd.org/pcap-filters">pcap-filters(5)</a> on DLT_LOOP links, e.g. <a href="https://man.openbsd.org/lo">lo(4)</a>, <a href="https://man.openbsd.org/gre">gre(4)</a>, <a href="https://man.openbsd.org/wg">wg(4)</a>, etc.
1.1 benno 383: <li>Fixed <a href="https://man.openbsd.org/dhclient">dhclient(8)</a> domain-search option processing.
384: <li>Corrected <a href="https://man.openbsd.org/route">route(8)</a> handling of ::/0 and "route add -inet 0.0.0.0 -prefixlen 0 (gateway)".
1.27 kn 385: <li>Fixed integer underflow in <a href="https://man.openbsd.org/tcpdump">tcpdump(8)</a> due to tiny snaplen causing bogus hexdumps.
1.1 benno 386: <li>Added initial <a href="https://man.openbsd.org/tcpdump">tcpdump(8)</a> support for handling geneve packets.
387: <li>Added <a href="https://man.openbsd.org/top">top(1)</a> "t" to toggle the display of routing tables.
388: <li>Added filtering by routing table to <a href="https://man.openbsd.org/top">top(1)</a>.
389: <li>Moved <a href="https://man.openbsd.org/ntpd">ntpd(8)</a> to unsynced mode if no replies are received for awhile due to connectivity issues.
390: <li>Made <a href="https://man.openbsd.org/slaacd">slaacd(8)</a> handle IPv6 address configuration in all rdomains in a single daemon, instead of running one daemon per rdomain.
391: </ul>
392:
393: <li><a href="https://man.openbsd.org/ipsec">ipsec(4)</a> (and related userland programs) improvements and
394: bugfixes:
395: <ul>
396: <li>Added AES-GCM mode ciphers for IKEv2, configurable in <a href="https://man.openbsd.org/iked.conf">iked.conf(5)</a> with the new "ikesa enc" options aes-128-gcm, aes-256-gcm, aes-128-gcm-12 and aes-256-gcm-12.
1.52 tobhe 397: <li>Enabled AES-GCM ciphers by default for IKE and Child SAs resulting in considerable performance improvements with hardware acceleration support.
398: <li>Enabled SHA2_384 and SHA2_512 by default for improved compatibilty.
399: <li>Added the new <a href="https://man.openbsd.org/iked">iked(8)</a> configuration option "set enforcesingleikesa" to limit the number of connections for each peer.
1.1 benno 400: <li>Added optional <a href="https://man.openbsd.org/iked">iked(8)</a> time-stamp validation for OCSP.
1.52 tobhe 401: <li>Added a 30 second timeout for OCSP requests in <a href="https://man.openbsd.org/iked">iked(8)</a>.
402: <li>Added a new "set cert_partial_chain" config option to <a href="https://man.openbsd.org/iked.conf">iked.conf(5)</a> to allow verification of partial certificate chains if a trusted intermediate CA is found in /etc/iked/ca.
1.1 benno 403: <li>Added a dpd_check_interval configuration option to <a href="https://man.openbsd.org/iked.conf">iked.conf(5)</a>.
404: <li>Allowed disabling of <a href="https://man.openbsd.org/iked">iked(8)</a> DPD liveness checks by setting dpd_check_interval to 0 in <a href="https://man.openbsd.org/iked.conf">iked.conf(5)</a>.
1.52 tobhe 405: <li>Made <a href="https://man.openbsd.org/iked">iked(8)</a> use the CA certificate for the OCSP issuer and respect the OCSP url from the issuer certificate.
406: <li>Fixed <a href="https://man.openbsd.org/iked">iked(8)</a> public key authentication interoperability with *swan and other IKEv2 implementations by making CERT and CERTREQ payloads optional.
407: <li>Fixed an <a href="https://man.openbsd.org/iked">iked(8)</a> policy lookup edge case for simultaneous transport and tunnel mode SAs.
1.24 kn 408: <li>Fixed a dst/src <a href="https://man.openbsd.org/iked">iked(8)</a> port configuration bug with multiple flows.
1.52 tobhe 409: <li>Prioritized incoming certificate requests by the order of CERTEQ payloads in the received message in <a href="https://man.openbsd.org/iked">iked(8)</a>.
410: <li>Prevented concurrent CREATE_CHILD_SA and INFORMATION exchanges in <a href="https://man.openbsd.org/iked">iked(8)</a>.
1.24 kn 411: <li>Handled <a href="https://man.openbsd.org/iked">iked(8)</a> TEMPORARY_FAILURE notification on IKESA rekeying.
1.52 tobhe 412: <li>Fixed multiple bugs with pfkey acquire messages.
1.1 benno 413: </ul>
414:
415: <li><a href="https://man.openbsd.org/tmux">tmux(1)</a> improvements and bug fixes:
416: <ul>
1.43 nicm 417: <li>How data is sent to control mode clients has been completely revamped to both be more fair with multiple panes and to prevent huge amounts of data being backed up.
418: <li>Configuration file parsing has changed slightly: the contents of the {} syntax must now be valid <a href="https://man.openbsd.org/tmux">tmux(1)</a> command syntax; and to allow formats to be annotated, strings given with quotes may now contain newlines (leading spaces and comments are stripped).
419: <li>A new customize mode available with C-b C (C-b S-c) which allows options and key bindings to be browsed and changed interactively.
420: <li>Support for extended keys offered by some terminals (xterm, mintty, iTerm2).
421: <li>A pane-border-lines option to change the characters used to draw the pane border separators.
422: <li>How UTF-8 data is stored has been rewritten to reduce memory use for characters in the BMP.
423: <li>The message log (C-b ~) has been changed to be per server instead of per client and to have some useful content.
424: <li>A new active-pane client flag that if given allows a client to have its own active pane for each window rather than being tied to the server's active pane.
425: <li>Improved command-prompt completion including showing a menu of completions.
426: <li>All style options can now be formats, for example the default pane-active-border-style now changes colour depending on pane_in_mode and synchronize-panes.
427: <li>Performance improvements in copy mode and additional styles for marking of search terms.
428: <li>Window and pane hooks such as window-layout-changed and pane-exited are now window or pane options instead of session options.
1.1 benno 429: <li>Added the 'e' key in buffer mode to open the buffer in an editor.
430: <li>Added M-+ and M-- to expand and collapse all items in tree mode.
431: <li>Added a -D flag to run in non-daemonized mode.
432: <li>Added <a href="https://man.openbsd.org/tmux">tmux(1)</a> -b flags to insert a window before (like the existing -a for after) to break-pane, move-window and new-window.
433: <li>Changed <a href="https://man.openbsd.org/tmux">tmux(1)</a> searching to behave more like emacs and prevented regex searching from overlapping when searching forward.
434: <li>Allowed a-z keys for <a href="https://man.openbsd.org/tmux">tmux(1)</a> display-panes to jump to higher-numbered panes.
435: <li>Allowed use of -N without a command to change or add a note to an existing key in <a href="https://man.openbsd.org/tmux">tmux(1)</a>.
436: </ul>
437:
438: <li>VMM/VMD and ldom/sparc64 virtualization improvements
439: <ul>
1.24 kn 440: <li>Fixed <a href="https://man.openbsd.org/ldomctl">ldomctl(8)</a> "init-system" with multiple PCIe root complexes (Oracle SPARC T4-2 machines).
441: <li>Made <a href="https://man.openbsd.org/ldomctl">ldomctl(8)</a> reject vdisk, vnet and iodevice parameters for primary domain.
1.1 benno 442: <li>Made <a href="https://man.openbsd.org/ldomctl">ldomctl(8)</a> "init-system -n" check vcpu and memory constraints.
443: <li>Increased the default number of ldom and ttyV devices for sparc64 from eight to sixteen.
444: <li>Fixed <a href="https://man.openbsd.org/vmd">vmd(8)</a> ns8250 lockup due to a race condition, helping to prevent linux vm crashes when the return key is held on boot.
445: <li>Prevented possible libevent state corruption in <a href="https://man.openbsd.org/vmd">vmd(8)</a>.
446: </ul>
447:
448: <li>OpenSMTPD 6.8.0
449: <ul>
450: <li>Fixed an uninitialized variable and potential stack overflow with IPv6 connections in <a href="https://man.openbsd.org/smtpd">smtpd(8)</a>.
451: <li>Fixed <a href="https://man.openbsd.org/smtpd">smtpd(8)</a> handling of user names containing "@" symbols.
452: <li>Allowed handling of long lines in an <a href="https://man.openbsd.org/smtpd">smtpd(8)</a> aliases table.
453: <li>Removed <a href="https://man.openbsd.org/mail.local">mail.local(8)</a> support for world-writable mail spools.
454: </ul>
455:
1.54 tb 456: <li>LibreSSL 3.2.2
1.1 benno 457: <ul>
458: <li>New Features
459: <ul>
1.55 beck 460: <li>This is the first stable release with the new TLSv1.3
1.58 tb 461: implementation enabled by default for both client and server. The
1.55 beck 462: OpenSSL 1.1 TLSv1.3 API is not yet available and will be provided
1.54 tb 463: in an upcoming release.
464:
1.55 beck 465: <li>New X509 certificate chain validator that correctly handles
466: multiple paths through intermediate certificates. Loosely based on
467: Go's X509 validator.
468:
469: <li>New name constraints verification implementation which passes the
470: bettertls.com certificate validation check suite.
1.1 benno 471: </ul>
472:
473: <li>API and Documentation Enhancements
474: <ul>
1.57 tb 475: <li>New <a href="https://man.openbsd.org/CMAC_Init">CMAC_Init(3)</a> and <a href="https://man.openbsd.org/ChaCha">ChaCha(3)</a> manual pages.
476: <li>Document <a href="https://man.openbsd.org/SSL_set1_host">SSL_set1_host(3)</a>, <a href="https://man.openbsd.org/SSL_set_SSL_CTX">SSL_set_SSL_CTX(3)</a>.
1.54 tb 477: <li>Document PKCS7 attribute functions.
1.57 tb 478: <li>Document <a href="https://man.openbsd.org/PKCS7_final">PKCS7_final(3)</a>, <a href="https://man.openbsd.org/PKCS7_add_attribute">PKCS7_add_attribute(3)</a>.
479: <li>Document <a href="https://man.openbsd.org/PKCS7_get_signer_info">PKCS7_get_signer_info(3)</a>.
480: <li>Document <a href="https://man.openbsd.org/PEM_ASN1_read">PEM_ASN1_read(3)</a> and <a href="https://man.openbsd.org/PEM_ASN1_read_bio">PEM_ASN1_read_bio(3)</a>.
481: <li>Document <a href="https://man.openbsd.org/PEM_X509_INFO_read">PEM_X509_INFO_read(3)</a> and <a href="https://man.openbsd.org/PEM_X509_INFO_read_bio">PEM_X509_INFO_read_bio(3)</a>.
482: <li>Document <a href="https://man.openbsd.org/PEM_def_callback">PEM_def_callback(3)</a>.
483: <li>Document <a href="https://man.openbsd.org/EVP_read_pw_string_min">EVP_read_pw_string_min(3)</a>.
484: <li>Merge documentation of <a href="https://man.openbsd.org/X509_get0_serialNumber">X509_get0_serialNumber(3)</a> from OpenSSL 1.1.1.
485: <li>Document error handling of <a href="https://man.openbsd.org/X509_PUBKEY_get0">X509_PUBKEY_get0(3)</a> and <a href="https://man.openbsd.org/X509_PUBKEY_get">X509_PUBKEY_get(3)</a>.
486: <li>Document <a href="https://man.openbsd.org/X509_get0_pubkey_bitstr">X509_get0_pubkey_bitstr(3)</a>
487: <li>Document <a href="https://man.openbsd.org/openssl">openssl(1)</a> certhash.
1.1 benno 488: </ul>
489:
490: <li>Compatibility Changes
491: <ul>
1.60 ! tb 492: <li>Modify I/O behavior so that <a href="https://man.openbsd.org/SSL_CTX_set_mode#SSL_MODE_AUTO_RETRY">SSL_MODE_AUTO_RETRY</a> is the default similar to new OpenSSL releases.
1.54 tb 493: <li>Add the P-521 curve to the list of curves supported by default in the client.
494: <li>Define OPENSSL_NO_SSL_TRACE in opensslfeatures.h.
495: <li>Make SSL_CTX_get_ciphers(NULL) return NULL rather than crash.
496: <li>Improve TLSv1.3 client certificate selection to allow EC certificates instead of only RSA certificates.
497: <li>Add minimal info callback support for TLSv1.3.
1.57 tb 498: <li>Support TLSv1.3 options in the <a href="https://man.openbsd.org/openssl">openssl(1)</a> command.
1.54 tb 499: <li>Add support for additional GOST curves from RFC 7836 and draft-deremin-rfc4491-bis.
500: <li>Add OIDs for HMAC using the Streebog hash function.
501: <li>Allow GOST R 34.11-2012 in PBE/PBKDF2/PKCS#5.
502: <li>Enable GOST_SIG_FORMAT_RS_LE when verifying certificate signatures.
503: <li>Handle GOST in ssl_cert_dup().
504: <li>Stop sending GOST R 34.10-94 as a CertificateType.
505: <li>Use IANA allocated GOST ClientCertificateTypes.
1.1 benno 506: </ul>
507:
508: <li>Testing and Proactive Security
509: <ul>
1.54 tb 510: <li>Greatly expanded test coverage via the tlsfuzzer test scripts.
1.55 beck 511: <li>Expanded test coverage via the bettertls certificate test suite.
1.54 tb 512: <li>Test interoperability with the Botan TLS client.
1.1 benno 513: </ul>
514:
515: <li>Internal Improvements
516: <ul>
1.54 tb 517: <li>Collapse x509v3 directory into x509.
518: <li>Add initial support for openbsd/powerpc64.
1.56 tb 519: <li>Improve length checks in the TLSv1.3 record layer and provide appropriate alerts for violations of record layer limits.
1.54 tb 520: <li>Enforce that SNI hostnames received by the TLS server are correctly formed as per RFC 5890 and RFC 6066, responding with illegal parameter for a nonconformant host name.
1.60 ! tb 521: <li>Support <a href="https://man.openbsd.org/SSL_CTX_set_mode#SSL_MODE_AUTO_RETRY">SSL_MODE_AUTO_RETRY</a> in TLSv1.3 to allow the automatic retry of handshake messages.
1.57 tb 522: <li>Improve the handling of <a href="https://man.openbsd.org/BIO_read">BIO_read(3)</a>/<a href="https://man.openbsd.org/BIO_write">BIO_write(3)</a> failures in the TLSv1.3 stack.
1.54 tb 523: <li>Start replacing the existing TLSv1.2 record layer.
524: <li>Simplify SSL method lookups.
1.57 tb 525: <li>Clean up and simplify <a href="https://man.openbsd.org/SSL_get_ciphers">SSL_get_ciphers(3)</a>, <a href="https://man.openbsd.org/SSL_set_session">SSL_set_session(3)</a>, <a href="https://man.openbsd.org/SSL_set_ssl_method">SSL_set_ssl_method(3)</a> and several internal functions.
1.54 tb 526: <li>Refactor dtls1_new(), dtls1_hm_fragment_new(), dtls1_drain_fragments(), dtls1_clear_queues().
527: <li>Make the message type available in the internal TLS extensions API functions.
1.57 tb 528: <li>Numerous <a href="https://man.openbsd.org/openssl">openssl(1)</a> subcommands were converted to the new option handling.
1.54 tb 529: <li>Copy the session ID directly in ssl_get_prev_session() instead of handing it through several functions for copying.
1.1 benno 530: </ul>
531:
532: <li>Portable Improvements
533: <ul>
1.54 tb 534: <li>Make pthread_mutex static initialisation work on Windows.
535: <li>Get __STRICT_ALIGNMENT from machine/endian.h with portable build.
1.1 benno 536: </ul>
537:
538: <li>Bug Fixes
539: <ul>
1.54 tb 540: <li>Fix an off-by-one in the CBC padding removal.
541: <li>Enforce in the TLSv1.3 server that that ClientHello messages after a HelloRetryRequest match the original ClientHello as per RFC 8446 section 4.1.2
542: <li>Avoid calling freezero with a negative size if a server sends a malformed plaintext of all zeroes.
543: <li>Correct use of sockaddr_storage instead of sockaddr in openssl(1) s_client, which could lead to using 14 bytes of stack garbage instead of an IPv6 address in DTLS mode.
1.57 tb 544: <li>Fix a longstanding bug in <a href="https://man.openbsd.org/PEM_X509_INFO_read_bio">PEM_X509_INFO_read_bio(3)</a> that could cause use-after-free and double-free issues in calling programs.
1.54 tb 545: <li>Zero out variable on the stack to avoid leaving garbage in the tail of short session IDs.
546: <li>Ensure that appropriate alerts are sent on various error conditions.
1.57 tb 547: <li>Move state initialization from <a href="https://man.openbsd.org/SSL_clear">SSL_clear(3)</a> to ssl3_clear() to ensure that it gets correctly reinitialized across a <a href="https://man.openbsd.org/SSL_set_ssl_method">SSL_set_ssl_method(3)</a> call.
1.54 tb 548: <li>Add a custom copy handler for AES keywrap to fix a use-after-free.
1.57 tb 549: <li>Avoid an out-of-bounds write in <a href="https://man.openbsd.org/BN_rand">BN_rand(3)</a>.
1.59 tb 550: <li>Fix numerous leaks in the <a href="https://man.openbsd.org/UI_new">UI_dup_*(3)</a> functions. Simplify and tidy up the code in ui_lib.c.
1.57 tb 551: <li>Correctly track selected ALPN length to avoid a potential segmentation fault with <a href="https://man.openbsd.org/SSL_get0_alpn_selected">SSL_get0_alpn_selected(3)</a> when alpn_selected is NULL.
1.54 tb 552: <li>Include machine/endian.h gost2814789.c in order to pick up the __STRICT_ALIGNMENT define.
1.57 tb 553: <li>Correctly handle ssl_cert_dup() failure in <a href="https://man.openbsd.org/SSL_set_SSL_CTX">SSL_set_SSL_CTX(3)</a>.
554: <li>Fail on receiving an invalid NID in <a href="https://man.openbsd.org/X509_ATTRIBUTE_create">X509_ATTRIBUTE_create(3)</a> instead of constructing a broken objects that may cause NULL pointer accesses.
555: <li>Fix <a href="https://man.openbsd.org/SSL_shutdown">SSL_shutdown(3)</a> behavior in TLSv1.3 to match the legacy stack. The previous behavior could cause a hang.
556: <li>Modify "openssl x509" to display invalid certificate times as invalid, and correctly deal with the failing return case from <a href="https://man.openbsd.org/X509_cmp_time ">X509_cmp_time(3)</a> so that a certificate with an invalid NotAfter does not appear valid.
1.1 benno 557: </ul>
558: </ul>
559:
1.14 benno 560: <li>OpenSSH 8.4
1.1 benno 561: <ul>
562: <li>Potentially incompatible changes.
1.14 benno 563: <ul>
564: <li>For FIDO/U2F support, OpenSSH recommends the use of libfido2
565: 1.5.0 or greater. Older libraries have limited support at the expense
566: of disabling particular features. These include resident keys, PIN-
567: required keys and multiple attached tokens.
568: <li><a href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>:
569: the format of the attestation information optionally recorded when a
570: FIDO key is generated has changed. It now includes the authenticator
571: data needed to validate attestation signatures.
572: <li>The API between OpenSSH and the FIDO token middleware has
573: changed and the SSH_SK_VERSION_MAJOR version has been incremented as a
574: result. Third-party middleware libraries must support the current API
575: version (7) to work with OpenSSH 8.4.
576: <li>The portable OpenSSH distribution now requires automake to
577: rebuild the configure script and supporting files. This is not
578: required when simply building portable OpenSSH from a release tar
579: file.
580: </ul>
1.1 benno 581: <li>New Features
1.14 benno 582: <ul>
583: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
584: href="https://man.openbsd.org/ssh-keygen">ssh-keygen">ssh-keygen(1)</a>:
585: support for FIDO keys that require a PIN for each use. These keys may
586: be generated using ssh-keygen using a new "verify-required" option.
587: When a PIN-required key is used, the user will be prompted for a PIN
588: to complete the signature operation.
589: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>:
590: authorized_keys now supports a new "verify-required" option to require
591: FIDO signatures assert that the token verified that the user was
592: present before making the signature. The FIDO protocol supports
593: multiple methods for user-verification, but currently OpenSSH only
594: supports PIN verification.
595: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>, <a
596: href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>: add
597: support for verifying FIDO webauthn signatures. Webauthn is a standard
598: for using FIDO keys in web browsers. These signatures are a slightly
599: different format to plain FIDO signatures and thus require explicit
600: support.
601: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: allow some
602: keywords to expand shell-style ${ENV} environment variables. The
603: supported keywords are CertificateFile, ControlPath, IdentityAgent and
604: IdentityFile, plus LocalForward and RemoteForward when used for Unix
605: domain socket paths.
606: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
607: href="https://man.openbsd.org/ssh-agent">ssh-agent(1)</a>: allow some
608: additional control over the use of ssh-askpass via a new
609: $SSH_ASKPASS_REQUIRE environment variable, including forcibly enabling
610: and disabling its use.
611: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: allow <a
612: href="https://man.openbsd.org/ssh_config">ssh_config(5)</a>'s
613: AddKeysToAgent keyword accept a time limit for keys in addition to its
614: current flag options. Time- limited keys will automatically be removed
615: from ssh-agent after their expiry time has passed.
616: <li><a href="https://man.openbsd.org/scp">scp(1)</a>, <a
617: href="https://man.openbsd.org/sftp">sftp(1)</a>: allow the -A flag to
618: explicitly enable agent forwarding in scp and sftp. The default
619: remains to not forward an agent, even when ssh_config enables it.
620: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: add a '%k'
621: TOKEN that expands to the effective HostKey of the destination. This
622: allows, e.g., keeping host keys in individual files using
623: "UserKnownHostsFile ~/.ssh/known_hosts.d/%k".
1.53 tb 624: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: add %-TOKEN,
1.14 benno 625: environment variable and tilde expansion to the UserKnownHostsFile
626: directive, allowing the path to be completed by the configuration.
627: <li><a href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>:
628: allow "ssh-add -d -" to read keys to be deleted from stdin.
629: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: improve
630: logging for MaxStartups connection throttling. sshd will now log when
631: it starts and stops throttling and periodically while in this state.
632: </ul>
1.1 benno 633: <li>Bugfixes
1.14 benno 634: <ul>
635: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
636: href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>: better
637: support for multiple attached FIDO tokens. In cases where OpenSSH
638: cannot unambiguously determine which token to direct a request to, the
639: user is now required to select a token by touching it. In cases of
640: operations that require a PIN to be verified, this avoids sending the
641: wrong PIN to the wrong token and incrementing the token's PIN failure
642: counter (tokens effectively erase their keys after too many PIN
643: failures).
644: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: fix Include
645: before Match in <a
646: href="https://man.openbsd.org/sshd_config">sshd_config(5)</a>.
647: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: close
648: stdin/out/error when forking after authentication completes ("ssh -f
649: ...").
650: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
651: href="https://man.openbsd.org/sshd">sshd(8)</a>: limit the amount of
652: channel input data buffered, avoiding peers that advertise large
653: windows but are slow to read from causing high memory consumption.
654: <li><a href="https://man.openbsd.org/ssh-agent">ssh-agent(1)</a>:
655: handle multiple requests sent in a single write() to the agent.
656: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: allow <a
657: href="https://man.openbsd.org/sshd_config">sshd_config(5)</a> longer than 256k
658: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: avoid
659: spurious "Unable to load host key" message when sshd load a private
660: key but no public counterpart
661: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: prefer the
662: default hostkey algorithm list whenever we have a hostkey that matches
663: its best-preference algorithm.
664: <li><a href="https://man.openbsd.org/sshd">sshd(1)</a>: when
665: ordering the hostkey algorithms to request from a server, prefer
666: certificate types if the known_hosts files contain a key marked as a
667: @cert-authority;
668: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: perform host
669: key fingerprint comparisons for the "Are you sure you want to continue
670: connecting (yes/no/[fingerprint])?" prompt with case sensitivity.
671: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: ensure that
672: address/masklen mismatches in sshd_config yield fatal errors at daemon
673: start time rather than later when they are evaluated.
674: <li><a href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>:
675: ensure that certificate extensions are lexically sorted. Previously if
676: the user specified a custom extension then the everything would be in
677: order except the custom ones.
678: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: also compare
679: username when checking for JumpHost loops.
680: <li><a href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>:
681: preserve group/world read permission on known_hosts files across runs
682: of "ssh-keygen -Rf /path". The old behaviour was to remove all rights
683: for group/other.
1.42 deraadt 684: <li><a href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>:
1.14 benno 685: Mention the [-a rounds] flag in the ssh-keygen manual page and
686: usage().
687: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: explicitly construct path to ~/.ssh/rc rather than
688: relying on it being relative to the current directory, so that it
689: can still be found if the shell startup changes its directory.
690: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: when
691: redirecting sshd's log output to a file, undo this redirection after
692: the session child process is forked(). Fixes missing log messages when
693: using this feature under some circumstances.
694: <li><a href="https://man.openbsd.org/sshd">sshd(8)</a>: start
695: ClientAliveInterval bookkeeping before first pass through select()
696: loop; fixed theoretical case where busy sshd may ignore timeouts from
697: client.
698: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>: only reset the
699: ServerAliveInterval check when we receive traffic from the server and
700: ignore traffic from a port forwarding client, preventing a client from
701: keeping a connection alive when it should be terminated.
702: <li><a href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>:
703: avoid spurious error message when ssh-keygen creates files outside
704: ~/.ssh
705: <li><a
706: href="https://man.openbsd.org/sftp-client">sftp-client(1)</a>: fix
707: off-by-one error that caused sftp downloads to make one more
708: concurrent request that desired. This prevented using <a
709: href="https://man.openbsd.org/sftp">sftp(1)</a> in unpipelined
710: request/response mode, which is useful when debugging.
711: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
712: href="https://man.openbsd.org/sshd">sshd(8)</a>: handle EINTR in
713: waitfd() and timeout_connect() helpers.
714: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
715: href="https://man.openbsd.org/ssh-keygen">ssh-keygen(1)</a>: defer
716: creation of ~/.ssh until we attempt to write to it so we don't leave
717: an empty .ssh directory when it's not needed.
718: <li><a href="https://man.openbsd.org/ssh">ssh(1)</a>, <a
719: href="https://man.openbsd.org/sshd">sshd(8)</a>: fix multiplier when
720: parsing time specifications when handling seconds after other units.
721: </ul>
1.1 benno 722: </ul>
723:
724: <li>Ports and packages:
725: <p>Many pre-built packages for each architecture:
726: <!-- number of FTP packages minus SHA256, SHA256.sig, index.txt -->
727: <ul style="column-count: 3">
1.39 naddy 728: <li>aarch64: 10768
1.11 sthen 729: <li>amd64: 11234
1.1 benno 730: <li>arm: XXX
1.11 sthen 731: <li>i386: 10548
1.45 visa 732: <li>mips64: 8540
1.1 benno 733: <li>mips64el: XXX
734: <li>powerpc: XXX
1.15 deraadt 735: <li>powerpc64: XXX
1.39 naddy 736: <li>sparc64: 9688
1.1 benno 737: </ul>
738:
739: <li>As usual, steady improvements in manual pages and other documentation.
740:
1.47 benno 741: <li>The system includes the following major components from outside suppliers:
1.46 benno 742: <ul>
743: <li>Xenocara (based on X.Org 7.7 with xserver 1.20.9 + patches,
1.4 jsg 744: freetype 2.10.2, fontconfig 2.12.4, Mesa 20.0.8, xterm 351,
1.1 benno 745: xkeyboard-config 2.20 and more)
746: <li>LLVM/Clang 10.0.1 (+ patches)
747: <li>GCC 4.2.1 (+ patches) and 3.3.6 (+ patches)
748: <li>Perl 5.30.3 (+ patches)
749: <li>NSD 4.3.2
750: <li>Unbound 1.11.0
751: <li>Ncurses 5.7
752: <li>Binutils 2.17 (+ patches)
753: <li>Gdb 6.3 (+ patches)
754: <li>Awk August 7, 2020 version
755: <li>Expat 2.2.8
756: </ul>
757:
758: </ul>
759: </section>
760:
761: <hr>
762:
763: <section id=install>
764: <h3>How to install</h3>
765: <p>
766: Please refer to the following files on the mirror site for
767: extensive details on how to install OpenBSD 6.8 on your machine:
768:
769: <ul>
770: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/alpha/INSTALL.alpha">
771: .../OpenBSD/6.8/alpha/INSTALL.alpha</a>
772: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/amd64/INSTALL.amd64">
773: .../OpenBSD/6.8/amd64/INSTALL.amd64</a>
774: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/arm64/INSTALL.arm64">
775: .../OpenBSD/6.8/arm64/INSTALL.arm64</a>
776: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/armv7/INSTALL.armv7">
777: .../OpenBSD/6.8/armv7/INSTALL.armv7</a>
778: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/hppa/INSTALL.hppa">
779: .../OpenBSD/6.8/hppa/INSTALL.hppa</a>
780: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/i386/INSTALL.i386">
781: .../OpenBSD/6.8/i386/INSTALL.i386</a>
782: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/landisk/INSTALL.landisk">
783: .../OpenBSD/6.8/landisk/INSTALL.landisk</a>
784: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/loongson/INSTALL.loongson">
785: .../OpenBSD/6.8/loongson/INSTALL.loongson</a>
786: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/luna88k/INSTALL.luna88k">
787: .../OpenBSD/6.8/luna88k/INSTALL.luna88k</a>
788: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/macppc/INSTALL.macppc">
789: .../OpenBSD/6.8/macppc/INSTALL.macppc</a>
790: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/octeon/INSTALL.octeon">
791: .../OpenBSD/6.8/octeon/INSTALL.octeon</a>
792: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/powerpc64/INSTALL.powerpc64">
793: .../OpenBSD/6.8/octeon/INSTALL.powerpc64</a>
794: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/sgi/INSTALL.sgi">
795: .../OpenBSD/6.8/sgi/INSTALL.sgi</a>
796: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.8/sparc64/INSTALL.sparc64">
797: .../OpenBSD/6.8/sparc64/INSTALL.sparc64</a>
798: </ul>
799: </section>
800:
801: <hr>
802:
803: <section id=quickinstall>
804: <p>
805: Quick installer information for people familiar with OpenBSD, and the use of
806: the "<a href="https://man.openbsd.org/disklabel.8">disklabel</a> -E" command.
807: If you are at all confused when installing OpenBSD, read the relevant
808: INSTALL.* file as listed above!
809:
810: <h3>OpenBSD/alpha:</h3>
811:
812: <p>
813: If your machine can boot from CD, you can write <i>install68.iso</i> or
814: <i>cd68.iso</i> to a CD and boot from it.
815: Refer to INSTALL.alpha for more details.
816:
817: <h3>OpenBSD/amd64:</h3>
818:
819: <p>
820: If your machine can boot from CD, you can write <i>install68.iso</i> or
821: <i>cd68.iso</i> to a CD and boot from it.
822: You may need to adjust your BIOS options first.
823:
824: <p>
1.23 kettenis 825: If your machine can boot from USB, you can write <i>install68.img</i> or
826: <i>miniroot68.img</i> to a USB stick and boot from it.
1.1 benno 827:
828: <p>
829: If you can't boot from a CD, floppy disk, or USB,
830: you can install across the network using PXE as described in the included
831: INSTALL.amd64 document.
832:
833: <p>
834: If you are planning to dual boot OpenBSD with another OS, you will need to
835: read INSTALL.amd64.
836:
837: <h3>OpenBSD/arm64:</h3>
838:
839: <p>
1.23 kettenis 840: Write <i>miniroot68.img</i> to a disk and boot from it after connecting
1.1 benno 841: to the serial console. Refer to INSTALL.arm64 for more details.
842:
843: <h3>OpenBSD/armv7:</h3>
844:
845: <p>
846: Write a system specific miniroot to an SD card and boot from it after connecting
847: to the serial console. Refer to INSTALL.armv7 for more details.
848:
849: <h3>OpenBSD/hppa:</h3>
850:
851: <p>
852: Boot over the network by following the instructions in INSTALL.hppa or the
853: <a href="hppa.html#install">hppa platform page</a>.
854:
855: <h3>OpenBSD/i386:</h3>
856:
857: <p>
858: If your machine can boot from CD, you can write <i>install68.iso</i> or
859: <i>cd68.iso</i> to a CD and boot from it.
860: You may need to adjust your BIOS options first.
861:
862: <p>
1.23 kettenis 863: If your machine can boot from USB, you can write <i>install68.img</i> or
864: <i>miniroot68.img</i> to a USB stick and boot from it.
1.1 benno 865:
866: <p>
867: If you can't boot from a CD, floppy disk, or USB,
868: you can install across the network using PXE as described in
869: the included INSTALL.i386 document.
870:
871: <p>
872: If you are planning on dual booting OpenBSD with another OS, you will need to
873: read INSTALL.i386.
874:
875: <h3>OpenBSD/landisk:</h3>
876:
877: <p>
1.23 kettenis 878: Write <i>miniroot68.img</i> to the start of the CF
1.1 benno 879: or disk, and boot normally.
880:
881: <h3>OpenBSD/loongson:</h3>
882:
883: <p>
1.23 kettenis 884: Write <i>miniroot68.img</i> to a USB stick and boot bsd.rd from it
1.1 benno 885: or boot bsd.rd via tftp.
886: Refer to the instructions in INSTALL.loongson for more details.
887:
888: <h3>OpenBSD/luna88k:</h3>
889:
890: <p>
891: Copy 'boot' and 'bsd.rd' to a Mach or UniOS partition, and boot the bootloader
892: from the PROM, and then bsd.rd from the bootloader.
893: Refer to the instructions in INSTALL.luna88k for more details.
894:
895: <h3>OpenBSD/macppc:</h3>
896:
897: <p>
898: Burn the image from a mirror site to a CDROM, and power on your machine
899: while holding down the <i>C</i> key until the display turns on and
900: shows <i>OpenBSD/macppc boot</i>.
901:
902: <p>
903: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
904: /6.8/macppc/bsd.rd</i>
905:
906: <h3>OpenBSD/octeon:</h3>
907:
908: <p>
909: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
910: Refer to the instructions in INSTALL.octeon for more details.
911:
912: <h3>OpenBSD/powerpc64:</h3>
913:
914: <p>
1.23 kettenis 915: To install, write <i>install68.img</i> or <i>miniroot68.img</i> to a
916: USB stick, plug it into the machine and coose the <i>OpenBSD
917: install</i> menu item in Petitboot.
1.1 benno 918: Refer to the instructions in INSTALL.powerpc64 for more details.
919:
920: <h3>OpenBSD/sgi:</h3>
921:
922: <p>
923: To install, burn cd68.iso on a CD-R, put it in the CD drive of your
924: machine and select <i>Install System Software</i> from the System Maintenance
925: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
926: CD-ROM, and need a proper invocation from the PROM prompt.
927: Refer to the instructions in INSTALL.sgi for more details.
928:
929: <p>
930: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
931: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
932: system type. Refer to the instructions in INSTALL.sgi for more details.
933:
934: <h3>OpenBSD/sparc64:</h3>
935:
936: <p>
937: Burn the image from a mirror site to a CDROM, boot from it, and type
938: <i>boot cdrom</i>.
939:
940: <p>
941: If this doesn't work, or if you don't have a CDROM drive, you can write
1.23 kettenis 942: <i>floppy68.img</i> or <i>floppyB68.img</i>
1.1 benno 943: (depending on your machine) to a floppy and boot it with <i>boot
944: floppy</i>. Refer to INSTALL.sparc64 for details.
945:
946: <p>
947: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
948: will most likely fail.
949:
950: <p>
1.23 kettenis 951: You can also write <i>miniroot68.img</i> to the swap partition on
1.1 benno 952: the disk and boot with <i>boot disk:b</i>.
953:
954: <p>
955: If nothing works, you can boot over the network as described in INSTALL.sparc64.
956: </section>
957:
958: <hr>
959:
960: <section id=upgrade>
961: <h3>How to upgrade</h3>
962: <p>
1.2 benno 963: If you already have an OpenBSD 6.7 system, and do not want to reinstall,
1.1 benno 964: upgrade instructions and advice can be found in the
965: <a href="faq/upgrade68.html">Upgrade Guide</a>.
966: </section>
967:
968: <hr>
969:
970: <section id=sourcecode>
971: <h3>Notes about the source code</h3>
972: <p>
973: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
974: This file contains everything you need except for the kernel sources,
975: which are in a separate archive.
976: To extract:
977: <blockquote><pre>
978: # <kbd>mkdir -p /usr/src</kbd>
979: # <kbd>cd /usr/src</kbd>
980: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
981: </pre></blockquote>
982: <p>
983: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
984: This file contains all the kernel sources you need to rebuild kernels.
985: To extract:
986: <blockquote><pre>
987: # <kbd>mkdir -p /usr/src/sys</kbd>
988: # <kbd>cd /usr/src</kbd>
989: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
990: </pre></blockquote>
991: <p>
992: Both of these trees are a regular CVS checkout. Using these trees it
993: is possible to get a head-start on using the anoncvs servers as
994: described <a href="anoncvs.html">here</a>.
995: Using these files
996: results in a much faster initial CVS update than you could expect from
997: a fresh checkout of the full OpenBSD source tree.
998: </section>
999:
1000: <hr>
1001:
1002: <section id=ports>
1003: <h3>Ports Tree</h3>
1004: <p>
1005: A ports tree archive is also provided. To extract:
1006: <blockquote><pre>
1007: # <kbd>cd /usr</kbd>
1008: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
1009: </pre></blockquote>
1010: <p>
1011: Go read the <a href="faq/ports/index.html">ports</a> page
1012: if you know nothing about ports
1013: at this point. This text is not a manual of how to use ports.
1014: Rather, it is a set of notes meant to kickstart the user on the
1015: OpenBSD ports system.
1016: <p>
1017: The <i>ports/</i> directory represents a CVS checkout of our ports.
1018: As with our complete source tree, our ports tree is available via
1019: <a href="anoncvs.html">AnonCVS</a>.
1020: So, in order to keep up to date with the -stable branch, you must make
1021: the <i>ports/</i> tree available on a read-write medium and update the tree
1022: with a command like:
1023: <blockquote><pre>
1024: # <kbd>cd /usr/ports</kbd>
1025: # <kbd>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_6_8</kbd>
1026: </pre></blockquote>
1027: <p>
1028: [Of course, you must replace the server name here with a nearby anoncvs
1029: server.]
1030: <p>
1031: Note that most ports are available as packages on our mirrors. Updated
1032: ports for the 6.8 release will be made available if problems arise.
1033: <p>
1034: If you're interested in seeing a port added, would like to help out, or just
1035: would like to know more, the mailing list
1036: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1037: </section>
![[BACK]](/icons/back.gif){kind=icon}
Return to 68.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / www