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