[BACK]Return to 74.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/74.html, Revision 1.40

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