Annotation of www/74.html, Revision 1.27
1.1 deraadt 1: <!doctype html>
2: <html lang=en id=release>
3: <head>
4: <meta charset=utf-8>
5:
6: <title>OpenBSD 7.4</title>
7: <meta name="description" content="OpenBSD 7.4">
8: <meta name="viewport" content="width=device-width, initial-scale=1">
9: <link rel="stylesheet" type="text/css" href="openbsd.css">
10: <link rel="canonical" href="https://www.openbsd.org/74.html">
11: </head><body>
12: <h2 id=OpenBSD>
13: <a href="index.html">
14: <i>Open</i><b>BSD</b></a>
15: 7.4
16: </h2>
17:
18: <table>
19: <tr>
20: <td>
21: <a href="images/XXX.png">
22: <img width="227" height="303" src="images/XXX-s.gif" alt="XXX"></a>
23: <td>
24: Released Oct XXX, 2023. (55th OpenBSD release)<br>
25: Copyright 1997-2023, Theo de Raadt.<br>
26: <br>
1.4 job 27: Artwork by Jessica Scott.
1.1 deraadt 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/7.4/</code> directory on
33: one of the mirror sites.
34: <li>Have a look at <a href="errata74.html">the 7.4 errata page</a> for a list
35: of bugs and workarounds.
36: <li>See a <a href="plus74.html">detailed log of changes</a> between the
37: 7.3 and 7.4 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-74-base.pub:
45: <td>
46: <a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/openbsd-74-base.pub">
47: RWRoyQmAD08ajTqgzK3UcWaVlwaJMckH9/CshU8Md5pN1GoIrcBdTF+c</a>
48: <tr><td>
49: openbsd-74-fw.pub:
50: <td>
51: RWTRA9KXRuZKunpXYK0ed5OxbE0K7rYWpDnTu+M8wZdqzRroFqed0U6I
52: <tr><td>
53: openbsd-74-pkg.pub:
54: <td>
55: RWR/h7gubZ9M/O46RNy3PzLTPevOCK24LGCPca41IHMwSH4YuVA+jnWO
56: <tr><td>
57: openbsd-74-syspatch.pub:
58: <td>
59: RWQqty2voy8V8afR9/v2RzuNr7r4y9cKwljABN7Tytd7JcPdBjnXg0Ue
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 7.4.
74: For a comprehensive list, see the <a href="plus74.html">changelog</a> leading
75: to 7.4.
76:
77: <ul>
78:
79: <li>New/extended platforms:
80: <ul>
1.11 benno 81: <li>On arm64, implement branch target protection using the branch
82: target identification feature introduced in Armv8.5. This provides
83: "head-CFI" to complement the "tail-CFI" provided by retguard, and is
84: supported on Apple M2.
1.1 deraadt 85: </ul>
86:
87: <li>Various kernel improvements:
88: <ul>
1.21 schwarze 89: <li>On amd64, identify IBT capability in
90: <a href="https://man.openbsd.org/amd64/cpu.4">cpu(4)</a> dmesg lines.
1.26 kn 91: <li>On arm64, show BTI and SBSS features in
1.21 schwarze 92: <a href="https://man.openbsd.org/dmesg.8">dmesg(8)</a>.
93: <li>Map device tree read/write to unbreak root on
94: <a href="https://man.openbsd.org/softraid.4">softraid(4)</a>.
1.1 deraadt 95: </ul>
96:
97: <li>SMP Improvements
98: <ul>
1.15 benno 99: <li>Protect struct clockintr(9)_queue with a mutex so that arbitrary CPUs
100: can manipulate clock interrupts established on arbitrary CPU queues.
101: <li>
102:
1.1 deraadt 103: </ul>
104:
105: <li>Direct Rendering Manager and graphics drivers
106: <ul>
1.18 jsg 107: <li>Updated <a href="https://man.openbsd.org/drm.4">drm(4)</a>
108: to Linux 6.1.55
109: <li>Don't change end marker in sg_set_page(). Caused bad memory accesses
110: when using page flipping on Alder Lake and Raptor Lake.
1.1 deraadt 111: </ul>
112:
113: <li>VMM/VMD improvements
114: <ul>
1.21 schwarze 115: <li>Avoid use of uninitialised memory in
116: <a href="https://man.openbsd.org/vmd.8">vmd(8)</a>.
1.15 benno 117: <li>Migrate vmd_vm.vm_ttyname to char array allowing a vmd_vm
118: object to be transmitted over an ipc channel.
1.1 deraadt 119: </ul>
120:
121: <li>Various new userland features:
122: <ul>
1.20 schwarze 123: <li>New ISO C11 header <code><uchar.h></code> declaring the
124: types <code>char32_t</code> and <code>char16_t</code> and the
125: functions <a href="https://man.openbsd.org/c32rtomb.3">c32rtomb(3)</a>,
126: <a href="https://man.openbsd.org/mbrtoc32.3">mbrtoc32(3)</a>,
127: <a href="https://man.openbsd.org/c16rtomb.3">c16rtomb(3)</a>, and
128: <a href="https://man.openbsd.org/mbrtoc16.3">mbrtoc16(3)</a>.
1.24 otto 129: <li><a href="https://man.openbsd.org/malloc.3">malloc(3)</a> gains built-in leak detection.
1.11 benno 130: <li>Update zoneinfo to tzdata2023c.
1.1 deraadt 131: </ul>
132:
133: <li>Various bugfixes and tweaks in userland:
134: <ul>
1.21 schwarze 135: <li>Refactoring and documenting of
136: <a href="https://man.openbsd.org/fdisk.8">fdisk(8)</a> code,
137: to make it easier to maintain.
138: <li>In <a href="https://man.openbsd.org/clang.1">clang(1)</a>,
139: allow out-of-class defaulting of comparison operators,
1.11 benno 140: by ways of backporting an upstream commit.
1.21 schwarze 141: <li>Improve the code of
142: <a href="https://man.openbsd.org/aucat.1">aucat(1)</a>
143: and fix spelling mistakes.
1.11 benno 144: <li>Improve the code quality of find(1).
1.21 schwarze 145: <li>Many changes in <a href="https://man.openbsd.org/mg.1">mg(1)</a>:
1.11 benno 146: <ul>
1.21 schwarze 147: <li>Improve the readability of the code.
148: <li>Fall back to /bin/sh if $SHELL is undefined.
149: <li>Fix parsing of tag files with duplicate entries.
1.11 benno 150: Instead of erroring out ignore duplicates. Fixes using
151: /var/db/libc.tags again.
1.21 schwarze 152: <li>Change tagvisit (aka visit-tag-table) to immediately
1.11 benno 153: load the tag file, and drop the lazy mechanics.
1.21 schwarze 154: <li>Remove useless global variable.
155: <li>Plug memory leak.
156: <li>Replace strncpy() with strlcpy().
1.11 benno 157: <li>Skip checking permissions of conffile with access(2).
158: </ul>
1.16 jsg 159: <li>On aarch64 architectures improve how BTI control flow integrity
1.11 benno 160: enforcement is implemented in the executable entry point and enable
1.16 jsg 161: support for BTI control flow integrity checks in libc assembly
1.11 benno 162: functions.
163:
1.1 deraadt 164: </ul>
165:
166: <li>Improved hardware support and driver bugfixes, including:
167: <ul>
1.20 schwarze 168: <li>New <a href="https://man.openbsd.org/sysctl.2">sysctl(2)</a>
169: nodes for battery management, <code>hw.battery.charge*</code>.
170: <li>Define fixed names for
171: <a href="https://man.openbsd.org/ucom.4">ucom(4)</a> USB serial
172: ports, make them discoverable via the new <code>hw.ucomnames</code>
173: <a href="https://man.openbsd.org/sysctl.2#HW_UCOMNAMES~2">sysctl(2)</a>,
174: and support them in <a href="https://man.openbsd.org/cu.1">cu(1)</a>.
1.21 schwarze 175: <li>Add support for the RK3568 32k RTC in
176: <a href="https://man.openbsd.org/rkclock.4">rkclock(4)</a>.
177: <li>In <a href="https://man.openbsd.org/dwpcie.4">dwpcie(4)</a>,
178: attach Baikal-M PCIe.
1.11 benno 179: <li>In openfirmware, implement regulator notifiers which get called
180: when the voltage/current for a regulator is changed or when the
181: regulator gets initialized when it attaches for the first time. The
182: latter makes it possible to register a notifier for a regulator that
183: hasn't attached yet.
1.21 schwarze 184: <li>Add <a href="https://man.openbsd.org/rkiovd.4">rkiovd(4)</a>,
185: a driver for the I/O voltage domains on Rockchip SoCs.
186: <li>Add support for TEMPerGold 3.4 temperature sensor to
187: <a href="https://man.openbsd.org/ugold.4">ugold(4)</a>.
1.15 benno 188: <li>Ignore duplicate ACPI lid transitions as they can happen on Dell
189: Precision 5510 systems.
190: <li>Make RK3568 PCIe controllers run at the maximum possible speed
191: by using dwpcie_link_config() when initializing.
192: <li>In the Universal Flash Storage Host Controller Interface
1.21 schwarze 193: (<a href="https://man.openbsd.org/ufshci.4">ufshci(4)</a>),
194: enable Force Unit Access (FUA) for write commands.
1.11 benno 195:
1.1 deraadt 196: </ul>
197:
198: <li>New or improved network hardware support:
199: <ul>
1.21 schwarze 200: <li>Fix <a href="https://man.openbsd.org/dwqe.4">dwqe(4)</a>
201: on several boards that use
202: <a href="https://man.openbsd.org/rgephy.4">rgephy(4)</a> by configuring
1.11 benno 203: the RGMII interface before taking the PHY out of reset.
1.21 schwarze 204: <li>Document that Intel i226 adapters are supported by
205: <a href="https://man.openbsd.org/igc.4">igc(4)</a>.
206: <li>Add <a href="https://man.openbsd.org/ngbe.4">ngbe(4)</a>,
207: a driver for WangXun WX1860 PCI Express 10/100/1Gb Ethernet devices.
208: Also support it on amd64 install media.
209: <li>Add <a href="https://man.openbsd.org/rkusbphy.4">rkusbphy(4)</a>,
210: a driver for the usb2phy on Rockchip SoCs, and enable it on arm64.
211: <li>Add support for the RTL8211F-VD PHY in
212: <a href="https://man.openbsd.org/rgephy.4">rgephy(4)</a>.
1.15 benno 213: <li>In openfirmware, add glue for network interfaces to be found by
214: fdt/ofw node or phandle in order to support "switch chips" like the
215: marvell link street.
216: <li>Add support for enabling both the usb2 and usb3 phys in xhci and ehci.
1.1 deraadt 217: </ul>
218:
219: <li>Added or improved wireless network drivers:
220: <ul>
1.21 schwarze 221: <li>Improve how Quectel LTE&5G devices attach to
222: <a href="https://man.openbsd.org/umb.4">umb(4)</a>.
1.1 deraadt 223: </ul>
224:
225: <li>IEEE 802.11 wireless stack improvements and bugfixes:
226: <ul>
1.27 ! stsp 227: <li> Add support for RTL8188FTV devices to the
! 228: <a href="https://man.openbsd.org/urtwn.4">urtwn(4)</a> driver.
! 229: <li>Attach Intel wireless devices with PCI product ID 0x51f1 to
! 230: <a href="https://man.openbsd.org/iwx.4">iwx(4)</a>.
! 231: <li>Fix a bug where <a href="https://man.openbsd.org/iwm.4">iwm(4)</a> and
! 232: <a href="https://man.openbsd.org/iwx.4">iwx(4)</a> background
! 233: scan tasks were added to the wrong task queue.
! 234: <li>Fix a firmware error that occurred when an
! 235: <a href="https://man.openbsd.org/iwx.4">iwx(4)</a> interface
! 236: was brought down.
! 237: <li>Fix <a href="https://man.openbsd.org/iwx.4">iwx(4)</a> firmware errors
! 238: triggered during background scans.
! 239: <li>Fix a crash in the <a href="https://man.openbsd.org/iwm.4">iwm(4)</a>
! 240: driver when userland attempts to inject frames via bpf in monitor mode.
1.1 deraadt 241: </ul>
242:
243: <li>Installer, upgrade and bootloader improvements:
244: <ul>
1.11 benno 245: <li>In the arm64 ramdisk, simplify apple firmware copying to make it
246: easier to add new firmware.
1.21 schwarze 247: <li>On armv7 and arm64, silence informational messages from
248: <a href="https://man.openbsd.org/dd.1">dd(1)</a>
1.11 benno 249: when zeroing a disk's first 1MB. Use character not block devices with
250: dd(1) like on other architectures.
251: <li>Refactor the code of md_installboot() on armv7 and arm64 to be
252: more in line with other architectures.
253: <li>Improve the dialogue of the installer without affecting
1.21 schwarze 254: <a href="https://man.openbsd.org/autoinstall.8">autoinstall(8)</a>
255: files.
256: <li>Enable <a href="https://man.openbsd.org/ufshci.4">ufshci(4)</a>
257: on arm64 install media.
1.15 benno 258: <li>On arm64 pine64 boards, stop writing pine64 firmware to disk.
1.21 schwarze 259: <li>Make root on
260: <a href="https://man.openbsd.org/softraid.4">softraid(4)</a>
261: installations boot out of the box on Raspberry Pis (arm64).
1.26 kn 262: <li>Add arm64 to the list of architectures with support for guided disk
263: encryption.
264: <li>Retain existing EFI System partitions on systems with APFSISC
265: partitions (arm64 Apple M1/M2) during installation with root on
266: <a href="https://man.openbsd.org/softraid.4">softraid(4)</a>.
1.1 deraadt 267: </ul>
268:
269: <li>Security improvements:
270: <ul>
1.21 schwarze 271: <li>Change <a href="https://man.openbsd.org/malloc.3">malloc(3)</a>
1.24 otto 272: chunk sizes to be fine grained: chunk sizes are closer to the
273: requested allocation size.
1.21 schwarze 274: <li>In <a href="https://man.openbsd.org/malloc.3">malloc(3)</a>,
275: check all chunks in the delayed free list for write-after-free.
1.1 deraadt 276: </ul>
277:
278: <li>Changes in the network stack:
279: <ul>
1.21 schwarze 280: <li>In <a href="https://man.openbsd.org/pf.4">pf(4)</a>,
281: when redirecting locally generated IP packets to
1.15 benno 282: userland with divert-packet rules, the packets may have no checksum
1.17 jsg 283: due to hardware offloading. Calculate the checksum in that case.
1.21 schwarze 284: <li>Sync the use of
285: <a href="https://man.openbsd.org/getuptime.9">getuptime(9)</a>
286: in the Neighbour Discovery (ND) code with ARP.
287: <li>In the IPv6 forwarding code, call
288: <a href="https://man.openbsd.org/getuptime.9">getuptime(9)</a>
289: once for consistency with IPv4.
1.15 benno 290:
1.1 deraadt 291: </ul>
292:
293: <li>Routing daemons and other userland network improvements:
294: <ul>
295: <li>IPsec support was improved:
296: <ul>
1.21 schwarze 297: <li>In <a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a>,
298: avoid a double free in ec_init() when using the OpenSSL API.
299: <li>In <a href="https://man.openbsd.org/iked.8">iked(8)</a>,
300: do not treat the return value of
301: <a href="https://man.openbsd.org/i2d_ECDSA_SIG.3"
302: >i2d_ECDSA_SIG(3)</a> as a length as it can be negative.
303: <li>Prepare <a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a>
304: for a libcrypto library that is lacking binary field support.
305: <li>In <a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a>,
306: avoid a potential crash by adding a missing NULL check.
1.11 benno 307:
1.1 deraadt 308: </ul>
309: <li>In <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>,
310: <ul>
1.22 claudio 311: <li>Add first version of flowspec support. Right now only announcement
312: of flowspec rules is possible.
313: <li>Update ASPA support to follow draft-ietf-sidrops-aspa-verification-16
314: and draft-ietf-sidrops-aspa-profile-16 by making the ASPA lookup
315: tables AFI-agnostic.
316: <li>Rework UPDATE message generation to use the new ibuf API instead
317: of the hand-rolled solution before.
318: <li>Fix <code>ext-community * *</code> matching which also affects
319: filters removing all ext-commuinites.
320: <li>Improve and extend the bgpctl parser to handle commands like
321: <code>bgpctl show rib 192.0.2.0/24 detail</code>.
322: Also add various flowspec specific commands.
323: <li>Introduce a semaphore to protect intermittent RTR session data
324: from being published to the RDE.
325: <li>Limit the socket buffer size to 64k for all sessions.
326: Limiting the buffer size to a reasonable size ensures that not
327: too many updates end up queued in the TCP stack.
328: <li>Adjusted example <code>GRACEFUL_SHUTDOWN</code> filter rule in
329: the example config to only match on ebgp sessions.
1.1 deraadt 330: </ul>
331: <li><a href="https://man.openbsd.org/rpki-client.8">rpki-client(8)</a> saw some changes:
332: <ul>
1.23 claudio 333: <li>A 30%-50% performance improvement was achieved through libcrypto's
334: partial chains certificate validation feature. Already validated
335: non-inheriting CA certificates are now marked as trusted roots. This
336: way it can be ensured that a leaf's delegated resources are properly
337: covered, and at the same time most validation paths are
338: significantly shortened.
339: <li>Support for gzip and deflate HTTP Content-Encoding compression was
340: added. This allows web servers to send RRDP XML in compressed form,
341: saving around 50% of bandwidth.
342: <li>ASPA support was updated to draft-ietf-sidrops-aspa-profile-16.
343: As part of supporting AFI-agnostic ASPAs, the JSON syntax for
344: Validated ASPA Payloads changed in both filemode and normal output.
345: <li>In filemode (-f option) the applicable manifests are now shown as
346: part of the signature path.
347: <li>A new -P option was added to manually specify a moment in time
348: to use when parsing the validity window of certificates. Useful
349: for regression testing. Default is invocation time of rpki-client.
350: <li>The -A option will now also exclude ASPA data from the JSON output.
351: <li>The synchronisation protocol used to sync the repository is now
352: included in the OpenMetrics output.
353: <li>Improved accounting by tracking objects both by repo and tal.
354: <li>Check whether products listed on a manifest were issued by the same
355: authority as the manifest itself.
356: <li>File modification timestamps of objects retrieved via RRDP are now
357: deterministically set to prepare the on-disk cache for seamless
358: failovers from RRDP to RSYNC.
359: <li>Improved detection of RRDP session desynchronization: a check was
360: added to compare whether the delta hashes associated to previously
361: seen serials are different in newly fetched notification files.
362: <li>Improved handling of RRDP deltas in which objects are published,
363: withdrawn, and published again.
364: <li>Disallow X.509 v2 issuer and subject unique identifiers in certs.
365: RPKI CAs will never issue certificates with V2 unique identifiers.
366: <li>A check to disallow duplicate X.509 certificate extensions was
367: added.
368: <li>A check to disallow empty sets of IP Addresses or AS numbers in RFC
369: 3779 extensions was added.
370: <li>A warning is printed when the CMS signing-time attribute in a Signed
371: Object is missing.
372: <li>Warnings about unrecoverable message digest mismatches now include
373: the manifestNumber to aid debugging the cause.
374: <li>A check was added to disallow multiple RRDP publish elements for the
375: same file in RRDP snapshots. If this error condition is encountered,
376: the RRDP transfer is failed and the RP falls back to rsync.
377: <li>A compliance check for the proper X.509 Certificate version and CRL
378: version was added.
379: <li>A compliance check was added to ensure CMS Signed Objects contain
380: SignedData, in accordance to RFC 6488 section 3 checklist item 1a.
381: <li>Compliance checks were added for the version, KeyUsage, and
382: ExtendedKeyUsage of EE certificates in Manifest, TAK, and GBR Signed
383: Objects.
384: <li>A CMS signing-time value being after the X.509 notAfter timestamp
385: was downgraded from an error to a warning.
386: <li>A bug was fixed in the handling of CA certificates which inherit IP
387: resources.
388: <li>A compliance check was added to ensure the X.509 Subject only
389: contains commonName and optionally serialNumber.
390: <li>A compliance check was added to ensure the CMS SignedData and
391: SignerInfo versions to be 3.
392: <li>Fisher-Yates shuffle the order in which Manifest entries are
393: processed. Previously, work items were enqueued in the order the CA
394: intended them to appear on a Manifest. However, there is no obvious
395: benefit to third parties deciding the order in which things are
396: processed.
1.1 deraadt 397: </ul>
398:
399: <li>In <a href="https://man.openbsd.org/snmpd.8">snmpd(8)</a>,
400: <ul>
401: <li>...
402: </ul>
403:
1.21 schwarze 404: <li>Make <a href="https://man.openbsd.org/dig.1">dig(1)</a>
405: use less deprecated LibreSSL API.
406: <li>In <a href="https://man.openbsd.org/ypldap.8">ypldap(8)</a>,
407: reduce memory usage when updating larger directories.
408: <li>Remove stylistic differences between
409: <a href="https://man.openbsd.org/arp.8">arp(8)</a> and
410: <a href="https://man.openbsd.org/ndp.8">ndp(8)</a> delete()
1.15 benno 411: function. This makes it easier to spot real changes in behavior.
1.21 schwarze 412: <li>Make <a href="https://man.openbsd.org/ndp.8">ndp(8)</a>
413: not remove cloning routes when no neighbor entry is
1.15 benno 414: found with <code>ndp -d</code>.
1.1 deraadt 415: </ul>
416:
417: <li><a href="https://man.openbsd.org/tmux.1">tmux(1)</a> improvements and bug fixes:
418: <ul>
1.11 benno 419: <li>For passthrough, don't write to clients attached to different sessions.
420: <li>Add a format to show if there are unseen changes while in a mode.
1.1 deraadt 421: </ul>
422:
1.7 tb 423: <li>LibreSSL version 3.8.2
1.1 deraadt 424: <ul>
1.7 tb 425: <li>Security fixes
426: <ul>
427: <li>Disabled TLSv1.0 and TLSv1.1 in libssl so that they may no longer
428: be selected for use.
429: <li>BN_is_prime{,_fasttest}_ex() refuse to check numbers larger than
430: 32 kbits for primality. This mitigates various DoS vectors.
431: <li>Restricted the RFC 3779 code to IPv4 and IPv6. It was not written
432: to be able to deal with anything else.
433: </ul>
434: <li>Portable changes
435: <ul>
436: <li>Extended the endian.h compat header with hto* and *toh macros.
437: <li>Adapted more tests to the portable framework.
438: <li>Internal tools are now statically linked.
439: <li>Applications bundled as part of the LibreSSL package internally,
440: nc(1) and openssl(1), now are linked statically if static libraries
441: are built.
442: <li>Internal compatibility function symbols are no longer exported from
443: libcrypto. Instead, the libcompat library is linked to libcrypto,
444: libssl, and libtls separately. This increases size a little, but
445: ensures that the libraries are not exporting symbols to programs
446: unintentionally.
447: <li>Selective removal of CET implementation on platforms where it is
448: not supported (macOS).
449: <li>Integrated four more tests.
450: <li>Added Windows ARM64 architecture to tested platforms.
451: <li>Removed Solaris 10 support, fixed Solaris 11.
452: <li>libtls no longer links statically to libcrypto / libssl unless
453: <code>--enable-libtls-only</code> is specified at configure time.
454: <li>Improved Windows compatibility library, namely handling of files vs
455: sockets, correcting an exception when operating on a closed socket.
456: <li>CMake builds no longer hardcode <code>-O2</code> into the compiler flags,
457: instead using flags from the CMake build type instead.
458: <li>Set the CMake default build type to <code>Release</code>. This can be overridden
459: during configuration.
460: <li>Fixed broken ASM support with MinGW builds.
461: </ul>
1.1 deraadt 462: <li>New features
463: <ul>
1.7 tb 464: <li>Added support for truncated SHA-2 and for SHA-3.
465: <li>The BPSW primality test performs additional Miller-Rabin rounds
466: with random bases to reduce the likelihood of composites passing.
467: <li>Allow testing of ciphers and digests using badly aligned buffers
468: in openssl speed using -unalign.
469: <li>Ed25519 certificates are now supported in openssl(1) ca and req.
470: Prepared Ed25519 support in libssl.
471: <li>Add branch target information (BTI) support to amd64 and arm64
472: assembly.
1.1 deraadt 473: </ul>
474: <li>Compatibility changes
475: <ul>
1.7 tb 476: <li>Added a workaround for a poorly thought-out change in OpenSSL 3 that
477: broke privilege separation support in libtls.
478: <li>Moved libtls from ECDSA_METHOD to EC_KEY_METHOD.
479: <li>Removed GF2m support: BIGNUM no longer supports binary extension
480: field arithmetic and all binary elliptic builtin curves were removed.
481: <li>Removed dangerous, "fast" NIST prime and elliptic curve implementations.
482: In particular, EC_GFp_nist_method() is no longer available.
483: <li>Removed most public symbols that were deprecated in OpenSSL 0.9.8.
484: <li>Removed the public X9.31 API (RSA_X931_PADDING is still available).
485: <li>Removed Cipher Text Stealing mode.
486: <li>Removed ENGINE support, including ECDH_METHOD and ECDSA_METHOD.
487: <li>Removed COMP, DSO, dynamic loading of conf modules and support for
488: custom ex_data and error stacks.
489: <li>Removed proxy certificate (RFC 3820) support.
490: <li>Removed SXNET and NETSCAPE_CERT_SEQUENCE support including the
1.8 tb 491: openssl(1) nseq command.
1.7 tb 492: <li>ENGINE support was removed and OPENSSL_NO_ENGINE is set. In spite
493: of this, some stub functions are provided to avoid patching some
494: applications that do not honor OPENSSL_NO_ENGINE.
495: <li>The POLICY_TREE and its related structures and API were removed.
496: <li>In X509_VERIFY_PARAM_inherit() copy hostflags independently of the
497: host list.
498: <li>Made CRYPTO_get_ex_new_index() not return 0 to allow applications
499: to use *_{get,set}_app_data() and *_{get,set}_ex_data() alongside
500: each other.
501: <li>X509_NAME_get_text_by_{NID,OBJ}() now only succeed if they contain
502: valid UTF-8 without embedded NUL.
503: <li>The explicitText user notice uses UTF8String instead of VisibleString
504: to reduce the risk of emitting certificates with invalid DER-encoding.
505: <li>Initial fixes for RSA-PSS support to make the TLSv1.3 stack more
506: compliant with RFC 8446.
507: <li>Fixed EVP_CIPHER_CTX_iv_length() to return what was set with
508: EVP_CTRL_AEAD_SET_IVLEN or one of its aliases.
1.1 deraadt 509: </ul>
1.7 tb 510: <li>Internal improvements
1.1 deraadt 511: <ul>
1.7 tb 512: <li>Improved sieve of Eratosthenes script used for generating a table
513: of small primes.
514: <li>Removed incomplete and dangerous BN_RECURSION code.
515: <li>Imported RFC 5280 policy checking code from BoringSSL and used it
516: to replace the old exponential time code.
517: <li>Converted more of libcrypto to use CBB/CBS.
518: <li>Started cleaning up and rewriting SHA internals.
519: <li>Reduced the dependency of hash implementations on many layers of
520: macros. This results in significant speedups since modern compilers
521: are now less confused.
522: <li>Improved BIGNUM internals and performance.
523: <li>Significantly simplified the BN_BLINDING internals used in RSA.
524: <li>Made BN_num_bits() independent of bn->top.
525: <li>Rewrote and simplified bn_sqr().
526: <li>Significantly improved Montgomery multiplication performance.
527: <li>Rewrote and improved BN_exp() and BN_copy().
528: <li>Changed ASN1_item_sign_ctx() and ASN1_item_verify() to work with
529: Ed25519 and fixed a few bugs in there.
530: <li>Lots of cleanup for DH, DSA, EC, RSA internals. Plugged numerous
531: memory leaks, fixed logic errors and inconsistencies.
532: <li>Cleaned up and simplified various ECDH and ECDSA internals.
533: <li>Removed EC_GROUP precomp machinery.
534: <li>Fixed various issues with EVP_PKEY_CTX_{new,dup}().
535: <li>Rewrote OBJ_find_sigid_algs() and OBJ_find_sigid_by_algs().
536: <li>Improved X.509 certificate version checks.
537: <li>Ensure no X.509v3 extensions appear more than once in certificates.
538: <li>Replaced ASN1_bn_print with a cleaner internal implementation.
539: <li>Fix OPENSSL_cpuid_setup() invocations on arm/aarch64.
540: <li>Improved checks for commonName in libtls.
541: <li>Fixed error check for X509_get_ext_d2i() failure in libtls.
542: <li>Removed code guarded by #ifdef ZLIB.
543: <li>Plug a potential memory leak in ASN1_TIME_normalize().
544: <li>Fixed a use of uninitialized in i2r_IPAddrBlocks().
545: <li>Rewrote CMS_SignerInfo_{sign,verify}().
1.1 deraadt 546: </ul>
1.7 tb 547: <li>Bug fixes
1.1 deraadt 548: <ul>
1.7 tb 549: <li>Correctly handle negative input to various BIGNUM functions.
550: <li>Ensure ERR_load_ERR_strings() does not set errno unexpectedly.
551: <li>Fix error checking of i2d_ECDSA_SIG() in ossl_ecdsa_sign().
1.8 tb 552: <li>Fixed aliasing issue in BN_mod_inverse(). Disallowed aliasing of result
553: and modulus in various BN_mod_* functions.
1.7 tb 554: <li>Fixed detection of extended operations (XOP) on AMD hardware.
555: <li>Ensure Montgomery exponentiation is used for the initial RSA blinding.
556: <li>Policy is always checked in X509 validation. Critical policy extensions
557: are no longer silently ignored.
558: <li>Fixed error handling in tls_check_common_name().
559: <li>Add missing pointer invalidation in SSL_free().
560: <li>Fixed X509err() and X509V3err() and their internal versions.
561: <li>Ensure that OBJ_obj2txt() always returns a C string again.
562: <li>Made EVP_PKEY_set1_hkdf_key() fail on a NULL key.
563: <li>On socket errors in the poll loop, netcat could issue system calls
564: on invalidated file descriptors.
565: <li>Allow IP addresses to be specified in a URI.
566: <li>Fixed a copy-paste error in ASN1_TIME_compare() that could lead
567: to two UTCTimes or two GeneralizedTimes incorrectly being compared
568: as equal.
569: </ul>
570: <li>Documentation improvements
571: <ul>
572: <li>Improved documentation of BIO_ctrl(3), BIO_set_info_callback(3),
573: BIO_get_info_callback(3), BIO_method_type(3), and BIO_method_name(3).
574: <li>Marked BIO_CB_return(), BIO_cb_pre(), and BIO_cb_post() as intentionally
575: undocumented.
576: <li>Made it very explicit that the verify callback should not be used.
577: <li>Called out that the CRL lastUpdate is standardized as thisUpdate.
578: <li>Documented the RFC 3779 API and its shortcomings.
579: </ul>
580: <li>Testing and Proactive Security
581: <ul>
582: <li>Significantly improved test coverage of BN_mod_sqrt() and GCD.
583: <li>As always, new test coverage is added as bugs are fixed and subsystems
584: are cleaned up.
1.1 deraadt 585: </ul>
586: </ul>
587:
1.13 dtucker 588: <li>OpenSSH 9.5 and OpenSSH 9.4
1.1 deraadt 589: <ul>
1.12 dtucker 590: <li>Potentially incompatible changes
1.1 deraadt 591: <ul>
1.12 dtucker 592: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
593: generate Ed25519 keys by default. Ed25519 public keys
594: are very convenient due to their small size. Ed25519 keys are
595: specified in RFC 8709 and OpenSSH has supported them since version 6.5
596: (January 2014).
597: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
598: the Subsystem directive now accurately preserves quoting of
599: subsystem commands and arguments. This may change behaviour for exotic
600: configurations, but the most common subsystem configuration
601: (sftp-server) is unlikely to be affected.
1.13 dtucker 602: <li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
603: PKCS#11 modules must now be specified by their full
604: paths. Previously dlopen(3) could search for them in system
605: library directories.
1.1 deraadt 606: </ul>
1.12 dtucker 607: <li>New features
1.1 deraadt 608: <ul>
1.12 dtucker 609: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
610: add keystroke timing obfuscation to the client. This attempts
611: to hide inter-keystroke timings by sending interactive traffic at
612: fixed intervals (default: every 20ms) when there is only a small
613: amount of data being sent. It also sends fake "chaff" keystrokes for
614: a random interval after the last real keystroke. These are
615: controlled by a new ssh_config ObscureKeystrokeTiming keyword.
616: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
617: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
618: Introduce a transport-level ping facility. This adds
619: a pair of SSH transport protocol messages SSH2_MSG_PING/PONG to
620: implement a ping capability. These messages use numbers in the "local
621: extensions" number space and are advertised using a "ping@openssh.com"
622: ext-info message with a string version number of "0".
1.13 dtucker 623: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
624: allow override of Subsystem directives in sshd Match blocks.
625: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
626: allow forwarding Unix Domain sockets via ssh -W.
627: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
628: add support for configuration tags to ssh(1).
629: This adds a ssh_config(5) "Tag" directive and corresponding
630: "Match tag" predicate that may be used to select blocks of
631: configuration similar to the pf.conf(5) keywords of the same
632: name.
633: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
634: add a "match localnetwork" predicate. This allows matching
635: on the addresses of available network interfaces and may be used to
636: vary the effective client configuration based on network location.
637: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
638: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>,
639: <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
640: infrastructure support for KRL
641: extensions. This defines wire formats for optional KRL extensions
642: and implements parsing of the new submessages. No actual extensions
643: are supported at this point.
644: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
645: AuthorizedPrincipalsCommand and AuthorizedKeysCommand now
646: accept two additional %-expansion sequences: %D which expands to
647: the routing domain of the connected session and %C which expands
648: to the addresses and port numbers for the source and destination
649: of the connection.
650: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
651: increase the default work factor (rounds) for the
652: bcrypt KDF used to derive symmetric encryption keys for passphrase
653: protected key files by 50%.
1.1 deraadt 654: </ul>
655: <li>Bugfixes
656: <ul>
1.12 dtucker 657: <li><a href="https://man.openbsd.org/scp.1">scp(1)</a>:
658: fix scp in SFTP mode recursive upload and download of
659: directories that contain symlinks to other directories. In scp mode,
660: the links would be followed, but in SFTP mode they were not.
661: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
662: handle cr+lf (instead of just cr) line endings in
663: sshsig signature files.
664: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
665: interactive mode for ControlPersist sessions if they
666: originally requested a tty.
667: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
668: make PerSourceMaxStartups first-match-wins
669: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
670: limit artificial login delay to a reasonable maximum (5s)
671: and don't delay at all for the "none" authentication mechanism.
1.13 dtucker 672: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
673: Log errors in kex_exchange_identification() with level
1.12 dtucker 674: verbose instead of error to reduce preauth log spam. All of those
675: get logged with a more generic error message by sshpkt_fatal().
676: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
677: correct math for ClientAliveInterval that caused the probes
678: to be sent less frequently than configured.
1.13 dtucker 679: <li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
680: improve isolation between loaded PKCS#11 modules
681: by running separate ssh-pkcs11-helpers for each loaded provider.
682: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
683: make -f (fork after authentication) work correctly with
684: multiplexed connections, including ControlPersist.
685: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
686: make ConnectTimeout apply to multiplexing sockets and not
687: just to network connections.
688: <li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>,
689: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
690: improve defences against invalid PKCS#11
691: modules being loaded by checking that the requested module
692: contains the required symbol before loading it.
693: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
694: fix AuthorizedPrincipalsCommand when AuthorizedKeysCommand
695: appears before it in sshd_config. Since OpenSSH 8.7 the
696: AuthorizedPrincipalsCommand directive was incorrectly ignored in
697: this situation.
698: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>,
699: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
700: <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.16 jsg 701: remove vestigial support for KRL
1.13 dtucker 702: signatures When the KRL format was originally defined, it included
703: support for signing of KRL objects. However, the code to sign KRLs
1.16 jsg 704: and verify KRL signatures was never completed in OpenSSH. This
1.13 dtucker 705: release removes the partially-implemented code to verify KRLs.
706: All OpenSSH tools now ignore KRL_SECTION_SIGNATURE sections in
707: KRL files.
708: <li>All: fix a number of memory leaks and unreachable/harmless integer
709: overflows.
710: <li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>,
711: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
712: don't truncate strings logged from PKCS#11 modules
713: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>,
714: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
715: better validate CASignatureAlgorithms in
716: ssh_config and sshd_config. Previously this directive would accept
717: certificate algorithm names, but these were unusable in practice as
718: OpenSSH does not support CA chains.
719: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
720: make <code>ssh -Q CASignatureAlgorithms</code> only list signature
721: algorithms that are valid for CA signing. Previous behaviour was
722: to list all signing algorithms, including certificate algorithms.
723: <li><a href="https://man.openbsd.org/ssh-keyscan.1">ssh-keyscan(1)</a>:
724: gracefully handle systems where rlimits or the
725: maximum number of open files is larger than INT_MAX
726: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
727: fix "no comment" not showing on when running
728: <code>ssh-keygen -l</code> on multiple keys where one has a comment
729: and other following keys do not.
730: <li><a href="https://man.openbsd.org/scp.1">scp(1)</a>,
1.14 dtucker 731: <a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
1.13 dtucker 732: adjust ftruncate() logic to handle servers that
733: reorder requests. Previously, if the server reordered requests then
734: the resultant file would be erroneously truncated.
735: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
736: don't incorrectly disable hostname canonicalization when
1.16 jsg 737: CanonicalizeHostname=yes and ProxyJump was explicitly set to
1.13 dtucker 738: "none".
739: <li><a href="https://man.openbsd.org/scp.1">scp(1)</a>:
740: when copying local to remote, check that the source file
741: exists before opening an SFTP connection to the server.
1.1 deraadt 742: </ul>
743: </ul>
744:
745: <li>Ports and packages:
746: <p>Many pre-built packages for each architecture:
747: <!-- number of FTP packages minus SHA256, SHA256.sig, index.txt -->
748: <ul style="column-count: 3">
1.25 naddy 749: <li>aarch64: 11508
750: <li>amd64: 11845
1.1 deraadt 751: <li>arm:
1.25 naddy 752: <li>i386: 10603
1.1 deraadt 753: <li>mips64:
754: <li>powerpc:
755: <li>powerpc64:
756: <li>riscv64:
757: <li>sparc64:
758: </ul>
759:
760: <p>Some highlights:
1.7 tb 761: <ul style="column-count: 3"><!-- XXX all need to be checked/updated 2023-03-04 -->
1.6 matthieu 762: <li>Asterisk 16.30.1, 18.19.0 and 20.4.0
1.5 matthieu 763: <li>Audacity 3.3.3
764: <li>CMake 3.27.5
1.10 matthieu 765: <li>Chromium 117.0.5838.149
1.5 matthieu 766: <li>Emacs 29.1
767: <li>FFmpeg 4.4.4
1.1 deraadt 768: <li>GCC 8.4.0 and 11.2.0
1.5 matthieu 769: <li>GHC 9.2.7
770: <li>GNOME 44
771: <li>Go 1.21.1
772: <li>JDK 8u382, 11.0.20 and 17.0.8
773: <li>KDE Applications 23.08.0
1.1 deraadt 774: <li>KDE Frameworks 5.98.0
1.5 matthieu 775: <li>Krita 5.1.5
776: <li>LLVM/Clang 13.0.0 and 16.0.6
777: <li>LibreOffice 7.6.2.1
778: <li>Lua 5.1.5, 5.2.4, 5.3.6 and 5.4.6
779: <li>MariaDB 10.9.6
780: <li>Mono 6.12.0.199
781: <li>Mozilla Firefox 118.0.1 and ESR 115.3.1
782: <li>Mozilla Thunderbird 115.3.1
783: <li>Mutt 2.2.12 and NeoMutt 20230517
784: <li>Node.js 18.18.0
1.1 deraadt 785: <li>OCaml 4.12.1
1.5 matthieu 786: <li>OpenLDAP 2.6.6
787: <li>PHP 7.4.33, 8.0.30, 8.1.24 and 8.2.11
788: <li>Postfix 3.7.3
789: <li>PostgreSQL 15.4
790: <li>Python 2.7.18, 3.9.18, 3.10.13 and 3.11.5
791: <li>Qt 5.15.10 and 6.5.2
792: <li>R 4.2.3
793: <li>Ruby 3.0.6, 3.1.4 and 3.2.2
794: <li>Rust 1.72.1
1.9 lteo 795: <li>SQLite 3.42.0
1.5 matthieu 796: <li>Shotcut 23.07.29
797: <li>Sudo 1.9.14.2
798: <li>Suricata 6.0.12
799: <li>Tcl/Tk 8.5.19 and 8.6.13
800: <li>TeX Live 2022
801: <li>Vim 9.0.1897 and Neovim 0.9.1
802: <li>Xfce 4.18
1.1 deraadt 803: </ul>
804: <p>
805:
806: <li>As usual, steady improvements in manual pages and other documentation.
807:
808: <li>The system includes the following major components from outside suppliers:
1.7 tb 809: <ul><!-- XXX all need to be checked/updated 2023-03-04 -->
1.5 matthieu 810: <li>Xenocara (based on X.Org 7.7 with xserver 21.1.8 + patches,
811: freetype 2.13.0, fontconfig 2.14.2, Mesa 22.3.7, xterm 378,
1.1 deraadt 812: xkeyboard-config 2.20, fonttosfnt 1.2.2 and more)
813: <li>LLVM/Clang 13.0.0 (+ patches)
814: <li>GCC 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.5 matthieu 815: <li>Perl 5.36.1 (+ patches)
816: <li>NSD 4.7.0
817: <li>Unbound 1.18.0
1.1 deraadt 818: <li>Ncurses 5.7
819: <li>Binutils 2.17 (+ patches)
820: <li>Gdb 6.3 (+ patches)
1.5 matthieu 821: <li>Awk September 12, 2023
822: <li>Expat 2.5.0
1.1 deraadt 823: </ul>
824:
825: </ul>
826: </section>
827:
828: <hr>
829:
830: <section id=install>
831: <h3>How to install</h3>
832: <p>
833: Please refer to the following files on the mirror site for
834: extensive details on how to install OpenBSD 7.4 on your machine:
835:
836: <ul>
837: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/alpha/INSTALL.alpha">
1.2 jsg 838: .../OpenBSD/7.4/alpha/INSTALL.alpha</a>
1.1 deraadt 839: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/amd64/INSTALL.amd64">
1.2 jsg 840: .../OpenBSD/7.4/amd64/INSTALL.amd64</a>
1.1 deraadt 841: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/arm64/INSTALL.arm64">
1.2 jsg 842: .../OpenBSD/7.4/arm64/INSTALL.arm64</a>
1.1 deraadt 843: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/armv7/INSTALL.armv7">
1.2 jsg 844: .../OpenBSD/7.4/armv7/INSTALL.armv7</a>
1.1 deraadt 845: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/hppa/INSTALL.hppa">
1.2 jsg 846: .../OpenBSD/7.4/hppa/INSTALL.hppa</a>
1.1 deraadt 847: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/i386/INSTALL.i386">
1.2 jsg 848: .../OpenBSD/7.4/i386/INSTALL.i386</a>
1.1 deraadt 849: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/landisk/INSTALL.landisk">
1.2 jsg 850: .../OpenBSD/7.4/landisk/INSTALL.landisk</a>
1.1 deraadt 851: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/loongson/INSTALL.loongson">
1.2 jsg 852: .../OpenBSD/7.4/loongson/INSTALL.loongson</a>
1.1 deraadt 853: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/luna88k/INSTALL.luna88k">
1.2 jsg 854: .../OpenBSD/7.4/luna88k/INSTALL.luna88k</a>
1.1 deraadt 855: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/macppc/INSTALL.macppc">
1.2 jsg 856: .../OpenBSD/7.4/macppc/INSTALL.macppc</a>
1.1 deraadt 857: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/octeon/INSTALL.octeon">
1.2 jsg 858: .../OpenBSD/7.4/octeon/INSTALL.octeon</a>
1.1 deraadt 859: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/powerpc64/INSTALL.powerpc64">
1.2 jsg 860: .../OpenBSD/7.4/powerpc64/INSTALL.powerpc64</a>
1.1 deraadt 861: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/riscv64/INSTALL.riscv64">
1.2 jsg 862: .../OpenBSD/7.4/riscv64/INSTALL.riscv64</a>
1.1 deraadt 863: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/7.4/sparc64/INSTALL.sparc64">
1.2 jsg 864: .../OpenBSD/7.4/sparc64/INSTALL.sparc64</a>
1.1 deraadt 865: </ul>
866: </section>
867:
868: <hr>
869:
870: <section id=quickinstall>
871: <p>
872: Quick installer information for people familiar with OpenBSD, and the use of
873: the "<a href="https://man.openbsd.org/disklabel.8">disklabel</a> -E" command.
874: If you are at all confused when installing OpenBSD, read the relevant
875: INSTALL.* file as listed above!
876:
877: <h3>OpenBSD/alpha:</h3>
878:
879: <p>
880: If your machine can boot from CD, you can write <i>install74.iso</i> or
881: <i>cd74.iso</i> to a CD and boot from it.
882: Refer to INSTALL.alpha for more details.
883:
884: <h3>OpenBSD/amd64:</h3>
885:
886: <p>
887: If your machine can boot from CD, you can write <i>install74.iso</i> or
888: <i>cd74.iso</i> to a CD and boot from it.
889: You may need to adjust your BIOS options first.
890:
891: <p>
892: If your machine can boot from USB, you can write <i>install74.img</i> or
893: <i>miniroot74.img</i> to a USB stick and boot from it.
894:
895: <p>
896: If you can't boot from a CD, floppy disk, or USB,
897: you can install across the network using PXE as described in the included
898: INSTALL.amd64 document.
899:
900: <p>
901: If you are planning to dual boot OpenBSD with another OS, you will need to
902: read INSTALL.amd64.
903:
904: <h3>OpenBSD/arm64:</h3>
905:
906: <p>
907: Write <i>install74.img</i> or <i>miniroot74.img</i> to a disk and boot from it
908: after connecting to the serial console. Refer to INSTALL.arm64 for more
909: details.
910:
911: <h3>OpenBSD/armv7:</h3>
912:
913: <p>
914: Write a system specific miniroot to an SD card and boot from it after connecting
915: to the serial console. Refer to INSTALL.armv7 for more details.
916:
917: <h3>OpenBSD/hppa:</h3>
918:
919: <p>
920: Boot over the network by following the instructions in INSTALL.hppa or the
921: <a href="hppa.html#install">hppa platform page</a>.
922:
923: <h3>OpenBSD/i386:</h3>
924:
925: <p>
926: If your machine can boot from CD, you can write <i>install74.iso</i> or
927: <i>cd74.iso</i> to a CD and boot from it.
928: You may need to adjust your BIOS options first.
929:
930: <p>
931: If your machine can boot from USB, you can write <i>install74.img</i> or
932: <i>miniroot74.img</i> to a USB stick and boot from it.
933:
934: <p>
935: If you can't boot from a CD, floppy disk, or USB,
936: you can install across the network using PXE as described in
937: the included INSTALL.i386 document.
938:
939: <p>
940: If you are planning on dual booting OpenBSD with another OS, you will need to
941: read INSTALL.i386.
942:
943: <h3>OpenBSD/landisk:</h3>
944:
945: <p>
946: Write <i>miniroot74.img</i> to the start of the CF
947: or disk, and boot normally.
948:
949: <h3>OpenBSD/loongson:</h3>
950:
951: <p>
952: Write <i>miniroot74.img</i> to a USB stick and boot bsd.rd from it
953: or boot bsd.rd via tftp.
954: Refer to the instructions in INSTALL.loongson for more details.
955:
956: <h3>OpenBSD/luna88k:</h3>
957:
958: <p>
959: Copy 'boot' and 'bsd.rd' to a Mach or UniOS partition, and boot the bootloader
960: from the PROM, and then bsd.rd from the bootloader.
961: Refer to the instructions in INSTALL.luna88k for more details.
962:
963: <h3>OpenBSD/macppc:</h3>
964:
965: <p>
966: Burn the image from a mirror site to a CDROM, and power on your machine
967: while holding down the <i>C</i> key until the display turns on and
968: shows <i>OpenBSD/macppc boot</i>.
969:
970: <p>
971: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
1.2 jsg 972: /7.4/macppc/bsd.rd</i>
1.1 deraadt 973:
974: <h3>OpenBSD/octeon:</h3>
975:
976: <p>
977: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
978: Refer to the instructions in INSTALL.octeon for more details.
979:
980: <h3>OpenBSD/powerpc64:</h3>
981:
982: <p>
983: To install, write <i>install74.img</i> or <i>miniroot74.img</i> to a
984: USB stick, plug it into the machine and choose the <i>OpenBSD
985: install</i> menu item in Petitboot.
986: Refer to the instructions in INSTALL.powerpc64 for more details.
987:
988: <h3>OpenBSD/riscv64:</h3>
989:
990: <p>
991: To install, write <i>install74.img</i> or <i>miniroot74.img</i> to a
992: USB stick, and boot with that drive plugged in.
993: Make sure you also have the microSD card plugged in that shipped with the
994: HiFive Unmatched board.
995: Refer to the instructions in INSTALL.riscv64 for more details.
996:
997: <h3>OpenBSD/sparc64:</h3>
998:
999: <p>
1000: Burn the image from a mirror site to a CDROM, boot from it, and type
1001: <i>boot cdrom</i>.
1002:
1003: <p>
1004: If this doesn't work, or if you don't have a CDROM drive, you can write
1005: <i>floppy74.img</i> or <i>floppyB74.img</i>
1006: (depending on your machine) to a floppy and boot it with <i>boot
1007: floppy</i>. Refer to INSTALL.sparc64 for details.
1008:
1009: <p>
1010: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
1011: will most likely fail.
1012:
1013: <p>
1014: You can also write <i>miniroot74.img</i> to the swap partition on
1015: the disk and boot with <i>boot disk:b</i>.
1016:
1017: <p>
1018: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1019: </section>
1020:
1021: <hr>
1022:
1023: <section id=upgrade>
1024: <h3>How to upgrade</h3>
1025: <p>
1.3 jsg 1026: If you already have an OpenBSD 7.3 system, and do not want to reinstall,
1.1 deraadt 1027: upgrade instructions and advice can be found in the
1028: <a href="faq/upgrade74.html">Upgrade Guide</a>.
1029: </section>
1030:
1031: <hr>
1032:
1033: <section id=sourcecode>
1034: <h3>Notes about the source code</h3>
1035: <p>
1036: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
1037: This file contains everything you need except for the kernel sources,
1038: which are in a separate archive.
1039: To extract:
1040: <blockquote><pre>
1041: # <kbd>mkdir -p /usr/src</kbd>
1042: # <kbd>cd /usr/src</kbd>
1043: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
1044: </pre></blockquote>
1045: <p>
1046: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
1047: This file contains all the kernel sources you need to rebuild kernels.
1048: To extract:
1049: <blockquote><pre>
1050: # <kbd>mkdir -p /usr/src/sys</kbd>
1051: # <kbd>cd /usr/src</kbd>
1052: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
1053: </pre></blockquote>
1054: <p>
1055: Both of these trees are a regular CVS checkout. Using these trees it
1056: is possible to get a head-start on using the anoncvs servers as
1057: described <a href="anoncvs.html">here</a>.
1058: Using these files
1059: results in a much faster initial CVS update than you could expect from
1060: a fresh checkout of the full OpenBSD source tree.
1061: </section>
1062:
1063: <hr>
1064:
1065: <section id=ports>
1066: <h3>Ports Tree</h3>
1067: <p>
1068: A ports tree archive is also provided. To extract:
1069: <blockquote><pre>
1070: # <kbd>cd /usr</kbd>
1071: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
1072: </pre></blockquote>
1073: <p>
1074: Go read the <a href="faq/ports/index.html">ports</a> page
1075: if you know nothing about ports
1076: at this point. This text is not a manual of how to use ports.
1077: Rather, it is a set of notes meant to kickstart the user on the
1078: OpenBSD ports system.
1079: <p>
1080: The <i>ports/</i> directory represents a CVS checkout of our ports.
1081: As with our complete source tree, our ports tree is available via
1082: <a href="anoncvs.html">AnonCVS</a>.
1083: So, in order to keep up to date with the -stable branch, you must make
1084: the <i>ports/</i> tree available on a read-write medium and update the tree
1085: with a command like:
1086: <blockquote><pre>
1087: # <kbd>cd /usr/ports</kbd>
1.2 jsg 1088: # <kbd>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_7_4</kbd>
1.1 deraadt 1089: </pre></blockquote>
1090: <p>
1091: [Of course, you must replace the server name here with a nearby anoncvs
1092: server.]
1093: <p>
1094: Note that most ports are available as packages on our mirrors. Updated
1095: ports for the 7.4 release will be made available if problems arise.
1096: <p>
1097: If you're interested in seeing a port added, would like to help out, or just
1098: would like to know more, the mailing list
1099: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1100: </section>
1101: </body>
1102: </html>