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