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

Annotation of www/69.html, Revision 1.7

1.1       deraadt     1: <!doctype html>
                      2: <html lang=en id=release>
                      3: <meta charset=utf-8>
                      4:
                      5: <title>OpenBSD 6.9</title>
                      6: <meta name="description" content="OpenBSD 6.9">
                      7: <meta name="viewport" content="width=device-width, initial-scale=1">
                      8: <link rel="stylesheet" type="text/css" href="openbsd.css">
                      9: <link rel="canonical" href="https://www.openbsd.org/69.html">
                     10:
                     11: <h2 id=OpenBSD>
                     12: <a href="index.html">
                     13: <i>Open</i><b>BSD</b></a>
                     14: 6.9
                     15: </h2>
                     16:
                     17: <table>
                     18: <tr>
                     19: <td>
                     20: <a href="images/XXX.png">
                     21: <img width="227" height="303" src="images/XXX-s.gif" alt="XXX"></a>
                     22: <td>
1.2       kn         23: Released May 1, 2021.<br>
                     24: Copyright 1997-2021, Theo de Raadt.<br>
1.1       deraadt    25: <br>
                     26: 6.9 Song:
                     27: <a href="lyrics.html#69">"XXX"</a>.
                     28: <br>
1.7     ! job        29: Artwork by Joy San.
1.1       deraadt    30: <br>
                     31: <ul>
                     32: <li>See the information on <a href="ftp.html">the FTP page</a> for
                     33:     a list of mirror machines.
                     34: <li>Go to the <code class=reldir>pub/OpenBSD/6.9/</code> directory on
                     35:     one of the mirror sites.
                     36: <li>Have a look at <a href="errata69.html">the 6.9 errata page</a> for a list
                     37:     of bugs and workarounds.
                     38: <li>See a <a href="plus69.html">detailed log of changes</a> between the
                     39:     6.8 and 6.9 releases.
                     40: <p>
                     41: <li><a href="https://man.openbsd.org/signify.1">signify(1)</a>
                     42:     pubkeys for this release:<p>
                     43:
                     44: <table class=signify>
                     45: <tr><td>
                     46: openbsd-69-base.pub:
                     47: <td>
                     48: <a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/openbsd-69-base.pub">
                     49: RWQZj25CSG5R2oLo5735Hh6C48kkjFsj5rJDjW+fGZwyY+BkD5/zps8f</a>
                     50: <tr><td>
                     51: openbsd-69-fw.pub:
                     52: <td>
                     53: RWSYx4htNi/zavF8ZToMBDFz2xymRfFnnR1MEKV9csYbvnrTBwdkXhdy
                     54: <tr><td>
                     55: openbsd-69-pkg.pub:
                     56: <td>
                     57: RWQlDXyHx5KlPoEiz4yWRK/Gt/rvPwI8KEAt3utge/dBS7R+EscdzA5K
                     58: <tr><td>
                     59: openbsd-69-syspatch.pub:
                     60: <td>
                     61: RWRWuHkSV0U8PUX24vGa3ywrvKNQY6llV3PLvKEzDTiTVPfIRaXPfvzR
                     62: </table>
                     63: </ul>
                     64: <p>
                     65: All applicable copyrights and credits are in the src.tar.gz,
                     66: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
                     67: files fetched via <code>ports.tar.gz</code>.
                     68: </table>
                     69:
                     70: <hr>
                     71:
                     72: <section id=new>
                     73: <h3>What's New</h3>
                     74: <p>
                     75: This is a partial list of new features and systems included in OpenBSD 6.9.
                     76: For a comprehensive list, see the <a href="plus69.html">changelog</a> leading
                     77: to 6.9.
                     78:
                     79: <ul>
                     80:
                     81: <li>New/extended platforms:
                     82:   <ul>
1.3       benno      83:        <li>Added <a href="https://man.openbsd.org/astfb.4">astfb(4)</a>, a
                     84:                driver for the framebuffer of the Aspeed BMC found on many POWER8 and
                     85:                POWER9 systems.
                     86:        <li>Added bsd.mp to powerpc64's installXX.{img,iso}.
                     87:        <li>Added RETGUARD implementation for powerpc and powerpc64.
                     88:        <li>Added powerpc64 retguard macros for setjmp/longjmp.
                     89:        <li>Added retguard macros to powerpc64 locore functions.
                     90:        <li>Added a workaround for PCIO devices that cannot address the full
                     91:                64-bit PCI address space to powerpc64. Needed for <a
                     92:                href="https://man.openbsd.org/radeondrm.4">radeondrm(4)</a> and <a
                     93:                href="https://man.openbsd.org/amdgpu.4">amdgpu(4)</a> since Radeon
                     94:                GPUs only implement 36, 40, or 44 bits of address space.
                     95:        <li>Added limited emulation of unaligned access in the powerpc64 kernel.
                     96:        <li>Changed <a href="https://man.openbsd.org/astfb.4">astfb(4)</a> to
                     97:                allow it to become the console on powerpc64.
                     98:        <li>Added support for passing a bootmac command line argument to
                     99:                RAMDISK on powerpc64.
1.5       benno     100:        <li>Fixed booting on powerpc64 machines with memory banks higher in
                    101:                physical address space, needing a larger TCE table.
                    102:        <li>Introduced power-saving mode on POWER9 (ISA v3).
1.3       benno     103:
                    104:
1.1       deraadt   105:   </ul>
                    106:
                    107: <li>Improvements to time measurements, mostly in the kernel:
                    108:   <ul>
                    109:        <li>...
                    110:   </ul>
                    111:
                    112: <li>Various kernel improvements:
                    113:   <ul>
1.5       benno     114:        <li>Added basic support for kclock timeouts to <a
                    115:                href="https://man.openbsd.org/timeout.9">timeout(9)</a>.
                    116:        <li>Added a top-level 'reboot' command to <a
                    117:                href="https://man.openbsd.org/ddb.4">ddb(4)</a>.
                    118:        <li>Fixed the "entry point at 0x10010000" hang reported on amd64
                    119:                machines by using a 64MB block to load the kernel.
                    120:        <li>Added <a href="https://man.openbsd.org/witness.4">witness(4)</a>
                    121:                check for uninitialized (or zeroed) lock usage.
                    122:        <li>Added fd close notification for kqueue-based <a
                    123:                href="https://man.openbsd.org/poll.2">poll(2)</a> and <a
                    124:                href="https://man.openbsd.org/select.2">select(2)</a>.
                    125:        <li>Added a global "nowake" channel for threads avoiding <a
                    126:                href="https://man.openbsd.org/wakeup.9">wakeup(9)</a> to <a
                    127:                href="https://man.openbsd.org/tsleep.9">tsleep(9)</a>.
                    128:        <li>Corrected accounting of zero length Transfer Descriptors in <a
                    129:                href="https://man.openbsd.org/xhci.4">xhci(4)</a>, preventing running
                    130:                out of free Transfer Ring Blocks.
                    131:        <li>Used per-CPU counter for fault and stats counters reached in uvm_fault().
                    132:        <li>Introduced kern.video.record for <a
                    133:                href="https://man.openbsd.org/video.4">video(4)</a> devices, an analog
                    134:                to the kern.audio.record <a
                    135:                href="https://man.openbsd.org/sysctl.8">sysctl(8)</a> parameter for <a
                    136:                href="https://man.openbsd.org/audio.4">audio(4)</a> devices. By
                    137:                default, kern.video.record will be set to zero and blank all data
                    138:                delivered by drivers attaching to <a
                    139:                href="https://man.openbsd.org/video.4">video(4)</a>.
                    140:        <li>Added trace points for <a
                    141:                href="https://man.openbsd.org/malloc.9">malloc(9)</a> and <a
                    142:                href="https://man.openbsd.org/free.9">free(9)</a>, making them
                    143:                traceabe via <a href="https://man.openbsd.org/dt.4">dt(4)</a> and <a
                    144:                href="https://man.openbsd.org/btrace.8">btrace(8)</a>.
                    145:
1.3       benno     146:
                    147: <!-- SMP -->
                    148: <li>Introduced "if_cloners_lock" rwlock and used it to serialize if_clone_{create,destroy}(), avoiding multiple race conditions.
                    149: <li>Introduced a system-wide mutex that serializes msgbuf operations.
1.5       benno     150: <li>Made <a href="https://man.openbsd.org/uvm_pagealloc.9">uvm_pagealloc(9)</a> of the physical memory allocator mp-safe.
1.3       benno     151:
                    152: <!-- DRM -->
                    153: <li>Implemented linux interval tree functions for <a href="https://man.openbsd.org/drm.4">drm(4)</a>.
                    154: <li>Fixed <a href="https://man.openbsd.org/wsconsctl.8">wsconsctl(8)</a> display commands when using <a href="https://man.openbsd.org/drm.4">drm(4)</a> drivers on macppc.
                    155: <li>Changed from <a href="https://man.openbsd.org/rwlock.9">rwlock(9)</a> to <a href="https://man.openbsd.org/mutex.9">mutex(9)</a> for linux rwlocks.
                    156: <li>Fixed a panic associated with locks and <a href="https://man.openbsd.org/drm.4">drm(4)</a> on macppc with Powerbook5,6 and RV350.
                    157: <li>Revised the initialization of the <a href="https://man.openbsd.org/drm.4">drm(4)</a> Linux emulation layer to call it only when the first drm instance attaches.
1.5       benno     158: <li>Fixed DRI3 support on <a href="https://man.openbsd.org/amdgpu.4">amdgpu(4)</a> and <a href="https://man.openbsd.org/ati.4">ati(4)</a>.
1.3       benno     159:
                    160:
1.1       deraadt   161:   </ul>
                    162:
                    163: <li>Various new userland features:
                    164:   <ul>
1.3       benno     165:        <li>Added <a
                    166:                href="https://man.openbsd.org/doas.conf.5">doas.conf(5)</a> "nolog"
                    167:                option to avoid <a
                    168:                href="https://man.openbsd.org/syslog.3">syslog(3)</a>.
                    169:        <li>Allowed specific <a
                    170:                href="https://man.openbsd.org/sndio.7">sndio(7)</a> devices to be used
                    171:                for play-only and rec-only modes.
                    172:
1.1       deraadt   173:   </ul>
                    174:
                    175: <li>Various bugfixes and tweaks in userland:
                    176:   <ul>
1.3       benno     177:        <li>Fixed a pledge violation in <a
                    178:                href="https://man.openbsd.org/csh.1">csh(1)</a> where redirecting
                    179:                input from a file containing ^T would cause csh(1) to perform a tty
                    180:                ioctl operation against a non-tty.
                    181:        <li>Prevented a crash due to <a
                    182:                href="https://man.openbsd.org/httpd.8">httpd(8)</a> listening on port
                    183:                443 with missing TLS certificates.
                    184:        <li>Stopped exempting file systems from <a
                    185:                href="https://man.openbsd.org/security.8">security(8)</a> on the basis
                    186:                of nodev and nosuid options, which may not be used for file systems
                    187:                mounted beneath.
                    188:        <li>Modified <a href="https://man.openbsd.org/daily.8">daily(8)</a>
                    189:                to stop reporting disk status and networking statistics.
                    190:        <li>Made <a
                    191:                href="https://man.openbsd.org/sysupgrade.8">sysupgrade(8)</a> specify
                    192:                a version when it uses <a
                    193:                href="https://man.openbsd.org/fw_update.1">fw_update(1)</a> to avoid
                    194:                the situation where upgrading a pre-6.8 snapshot to 6.8 release with
                    195:                "-r" would install firmware packages from snapshots.
                    196:        <li>Increased speed of the dependency check pass for <a
                    197:                href="https://man.openbsd.org/pkg_add.1">pkg_add(1)</a>.
                    198:
                    199:        <li>Prevented process exit in multithreaded programs from reporting
                    200:                the wrong error code.
                    201:
1.5       benno     202:        <li>Allowed booting of amd64/i386 from 4TB GPT formatted disks.
                    203:
                    204:        <li>When using the <a href="https://man.openbsd.org/cat.1">cat(1)</a>
                    205:                -n flag, correctly enumerate files with more than INT_MAX lines.
                    206:        <li>Fixed a memory leak in ld.so's malloc.
1.6       otto      207:        <li>Inproved performance of <a
                    208:                href="https://man.openbsd.org/malloc.3">malloc(3)</a>'s cache.
1.1       deraadt   209:   </ul>
                    210:
                    211: <li>Improved hardware support and driver bugfixes, including:
                    212:   <ul>
1.3       benno     213:
                    214:        <li>Moved mfokclock(4) from loongson to make it available for other
                    215:                platforms and renamed it to <a
                    216:                href="https://man.openbsd.org/mfokrtc.4">mfokrtc(4)</a>.
                    217:        <li>Fixed brightness setting on MacBooks.
                    218:        <li>Added AMD Vi and Intel VTD IOMMU support. This creates separate
                    219:                domains for each PCI device and can provide protection against invalid
                    220:                memory access.
                    221:        <li>Enabled brightness keys on powerbooks where the keyboard attaches
                    222:                as <a href="https://man.openbsd.org/ukbd.4">ukbd(4)</a>.
                    223:        <li>Set initial default display brightness on macppc via
                    224:                of_setbrightness() to ensure <a
                    225:                href="https://man.openbsd.org/wscons.4">wscons(4)</a> and ofw are in
                    226:                sync.
                    227:        <li>Added the ClearFog GT 8K to <a
                    228:                href="https://man.openbsd.org/mvclock.4">mvclock(4)</a>.
                    229:        <li>Added support for the PL2303HXN series chips to <a
                    230:                href="https://man.openbsd.org/uplcom.4">uplcom(4)</a>.
                    231:        <li>Added support for the PCA9547 I2C mux to <a
                    232:                href="https://man.openbsd.org/pcamux.4">pcamux(4)</a>.
                    233:        <li>Extended <a href="https://man.openbsd.org/pcamux.4">pcamux(4)</a>
                    234:                with ACPI support.
                    235:        <li>Added <a href="https://man.openbsd.org/acpige.4">acpige(4)</a>, a
                    236:                driver for ACPI generic event devices, used on te HoneyComb LX2K to
                    237:                implement power button handling.
                    238:        <li>Added <a href="https://man.openbsd.org/pchgpio.4">pchgpio(4)</a>,
                    239:                a driver for the GPIO controllers found on modern Intel PCHs.
                    240:        <li>Added ACPI support to <a
                    241:                href="https://man.openbsd.org/imxiic.4">imxiic(4)</a>.
                    242:        <li>Fixed panics on the HoneyComb LX2K with <a
                    243:                href="https://man.openbsd.org/amdgpu.4">amdgpu(4)</a>.
                    244:        <li>Fixed very old <a
                    245:                href="https://man.openbsd.org/umass.4">umass(4)</a> devices where the
                    246:                INQUIRY command succeeds but with a residue equal to the requested
                    247:                bytes.
1.5       benno     248:        <li>Added Gemini Lake I2C id to <a
                    249:                href="https://man.openbsd.org/dwiic.4">dwiic(4)</a>, making the
                    250:                touchpad work on the Teclast F7 Plus laptop.
1.3       benno     251:
                    252: <!-- ARM64 -->
                    253:        <li>Optimized arm64 <a
                    254:                href="https://man.openbsd.org/copyin.9">copyin(9)</a>, <a
                    255:                href="https://man.openbsd.org/copyout.9">copyout(9)</a> and <a
                    256:                href="https://man.openbsd.org/kcopy.9">kcopy(9)</a> by doing 16-byte
                    257:                copies if possible.
                    258:        <li>Added recognition of Cortex-A78AE, Cortex-X1 and Neoverse V1 arm64 CPUs.
                    259:        <li>Added clock support for i.MX8MP.
                    260:        <li>Added support for the VF610 I2C controller to <a
                    261:                href="https://man.openbsd.org/imxiic.4">imxiic(4)</a>.
                    262:        <li>Fixed a panic seen with mbuf chains on arm64.
1.5       benno     263:        <li>Added <a href="https://man.openbsd.org/dwgpio.4">dwgpio(4)</a>, a
                    264:                driver for the Synopsys DesignWare GPIO controller.
                    265:        <li>Added "amlogic,meson-g12a-dwmac" to <a
                    266:                href="https://man.openbsd.org/dwge.4">dwge(4)</a>.
                    267:        <li>Added <a
                    268:                href="https://man.openbsd.org/amlpinctrl.4">amlpinctrl(4)</a> support
                    269:                for the "Always On" GPIOs.
                    270:        <li>Added PCIe clocks to <a
                    271:                href="https://man.openbsd.org/amlclock.4">amlclock(4)</a>.
                    272:        <li>Made large read and write transactions work in <a
                    273:                href="https://man.openbsd.org/amliic.4">amliic(4)</a>.
                    274:        <li>Added PCIe support to <a href="https://man.openbsd.org/amlpciephy.4">amlpciephy(4)</a>.
                    275:        <li>Added support to <a href="https://man.openbsd.org/dwpcie.4">dwpcie(4)</a> for the PCIe controller found on Amlogic G12A/G12B/SM1 SoCs.
1.3       benno     276:
                    277:
1.1       deraadt   278:   </ul>
                    279:
                    280: <li>New or improved network hardware support:
                    281:   <ul>
1.3       benno     282:        <li>Fixed link state change behavior in 82598 <a
                    283:                href="https://man.openbsd.org/ix.4">ix(4)</a> chips.
                    284:        <li>Fixed issues with network stopping after the first down/up cycle
                    285:                in <a href="https://man.openbsd.org/mvpp.4">mvpp(4)</a> Marvel Armada
                    286:                Ethernet device.
                    287:        <li>Added SFP+ support to ofw, including support for direct attach cables.
                    288:        <li>Added 10G media support to <a
                    289:                href="https://man.openbsd.org/mvpp.4">mvpp(4)</a>.
                    290:        <li>Added support for 1000base-x and 2500base-x connections to <a
                    291:                href="https://man.openbsd.org/mvneta.4">mvneta(4)</a>.
                    292:        <li>Added <a href="https://man.openbsd.org/mvsw.4">mvsw(4)</a>, a
                    293:                driver for Marvel "SOHO" switches.
                    294:
1.5       benno     295:        <li>Enabled auto-negotiation on the SerDes links, allowing
                    296:                in-band-status to work between <a
                    297:                href="https://man.openbsd.org/mvpp.4">mvpp(4)</a> and <a
                    298:                href="https://man.openbsd.org/mvsw.4">mvsw(4)</a> on the ClearFog GT
                    299:                8K.
                    300:        <li>Added support for the i.MX8MP PCIe clocks, USB clocks and second
                    301:                ethernet.
                    302:        <li>Added Wake on LAN support to <a
                    303:                href="https://man.openbsd.org/rge.4">rge(4)</a>.
                    304:        <li>Enabled IPv4 and TCP/UDP checksum offload on transmission in <a
                    305:                href="https://man.openbsd.org/ogx.4">ogx(4)</a>.
                    306:
                    307:
1.1       deraadt   308:   </ul>
                    309:
                    310: <li>Added or improved wireless network drivers:
                    311:   <ul>
1.3       benno     312:        <li>Fixed <a href="https://man.openbsd.org/athn.4">athn(4)</a> in
                    313:                client mode against APs that use WPA1/TKIP as the group cipher.
                    314:        <li>Fixed <a href="https://man.openbsd.org/urtwn.4">urtwn(4)</a>
                    315:                against access points using WPA1/TKIP as the group cipher.
                    316:        <li>Added multicast support to <a
                    317:                href="https://man.openbsd.org/bwfm.4">bwfm(4)</a> to allow IPv6.
                    318:        <li>Fixed <a href="https://man.openbsd.org/urtwn.4">urtwn(4)</a>
                    319:                repeated DEAUTH and loss/restoration of link.
1.5       benno     320:        <li>Introduced a delay to work around an issue in <a
                    321:                href="https://man.openbsd.org/bwfm.4">bwfm(4)</a> on the BCM43602 that
                    322:                was triggering "unexpected pairwise key update" errors.
1.3       benno     323:
1.1       deraadt   324:   </ul>
                    325:
                    326: <li>IEEE 802.11 wireless stack improvements and bugfixes:
                    327:   <ul>
1.5       benno     328:        <li>Fixed the calculation of "maxlen" in <a
                    329:                href="https://man.openbsd.org/iwm.4">iwm(4)</a> and <a
                    330:                href="https://man.openbsd.org/iwx.4">iwx(4)</a> when there are
                    331:                multiple MPDUs in one packet.
                    332:        <li>Fixed 802.11 RSN capabilities announced to peers.
                    333:        <li>Flushed the reorder buffer after gap timeout to prevent frames
                    334:                from remaining in the buffer until the next frame is received.
                    335:        <li>Avoided spurious "input packet decapsulations failed" errors in
                    336:                <a href="https://man.openbsd.org/netstat.1">netstat(1)</a> -W with
                    337:                A-MSDU enabled.
                    338:
                    339:
1.1       deraadt   340:   </ul>
                    341:
                    342: <li>Generic network stack improvements and bugfixes:
                    343:   <ul>
1.3       benno     344:        <li>Prevented kernel reuse of mbuf memory when generating the ICMP6
                    345:                response to an IPv6 packet.
                    346:        <li>Added the ability to force the selection of source IP address for
                    347:                programs that do not specify a source IP, configurable via <a
                    348:                href="https://man.openbsd.org/route.8">route(8)</a>.
                    349:        <li>For IPv6 addresses, added tracking of address proposal creation
                    350:                times to be able to establish total lifetime. This information is used
                    351:                to renew pltime/vltime of privacy addresse per RFC 4941.
                    352:        <li>Fixed <a href="https://man.openbsd.org/wg.4">wg(4)</a> on macppc
                    353:                by keeping track of allowed ips pointer correctly.
                    354:
                    355:
1.1       deraadt   356:   </ul>
                    357:
                    358: <li>Installer improvements:
                    359:   <ul>
1.5       benno     360:        <li>Prevented a race in <a
                    361:                href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> privsep
                    362:                which could cause autoinstall to fail by calling <a
                    363:                href="https://man.openbsd.org/ftp.1">ftp(1)</a> without a local
                    364:                address.
                    365:        <li>Fixed hangs on amd64 bsd.rd due to misreported core clock
                    366:                frequency on newer Intel Comet Lake models.
                    367:
1.1       deraadt   368:  </ul>
                    369:
                    370: <li>Security improvements:
                    371:   <ul>
1.3       benno     372:        <li>Added notices to syslog whenever the "%n" format string component of <a href="https://man.openbsd.org/printf.3">printf(3)</a> is used.
1.1       deraadt   373:   </ul>
                    374:
                    375: <li>Routing daemons and other userland network improvements:
                    376:   <ul>
1.3       benno     377: <!-- BGP -->
                    378:        <li>Fixed a memory leak when parsing <a
                    379:                href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> roa-set lists.
                    380:        <li>Stopped allowing configuration of the same neighbor multiple
                    381:                times in <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>.
1.5       benno     382:        <li>When exporting prefixes from multiple sessions in <a
                    383:                href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> into the same <a
                    384:                href="https://man.openbsd.org/pf.4">pf(4)</a> table, now prefixes are
                    385:                only removed from the table when withdrawn from all sessions that
                    386:                announced them.
                    387:        <li>Introduced a send hold timer in <a
                    388:                href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> to detect stalls on
                    389:                the sending side of a TCP connection, acting as a last resort to
                    390:                detect faulty peers.
                    391:        <li>Added <a href="https://man.openbsd.org/bgpctl.8">bgpctl(8)</a>
                    392:                "show sets" to display information about the roa-set, as-sets and
                    393:                prefix-sets loaded into <a
                    394:                href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>.
                    395:
                    396:
1.3       benno     397: <!-- HTTPD -->
                    398:        <li>Created a new "location (found|notfound)" option for <a
                    399:                href="https://man.openbsd.org/httpd.conf.5">httpd.conf(5)</a> to allow
                    400:                testing for resource path existence.
                    401:        <li>Added a directive to <a
                    402:                href="https://man.openbsd.org/httpd.8">httpd(8)</a> to check if a path
                    403:                is accessible.
                    404:        <li>Fixed detection of duplicate locations in <a
                    405:                href="https://man.openbsd.org/httpd.8">httpd(8)</a>.
                    406:
                    407:
                    408: <!-- IKE/IPSEC -->
                    409:        <li>Added support to request IP addresses as IKEv2 initiator to <a
                    410:                href="https://man.openbsd.org/iked.8">iked(8)</a>. If 'request addr
                    411:                0.0.0.0' is configured, any address will be accepted.
                    412:        <li>Make <a href="https://man.openbsd.org/iked.8">iked(8)</a> accept
                    413:                ANY dynamic address with 'request addr 0.0.0.0'.
                    414:        <li>Added 'dynamic' keyword to <a
                    415:                href="https://man.openbsd.org/iked.conf.5">iked.conf(5)</a> to allow
                    416:                configuration of flows to dynamically assigned addresses.
                    417:        <li>Added the 'any' keyword to <a
                    418:                href="https://man.openbsd.org/iked.conf.5">iked.conf(5)</a> for
                    419:                requests to allow "request address any".
                    420:        <li>Enabled <a href="https://man.openbsd.org/iked.8">iked(8)</a>
                    421:                support for ASN1_DN ipsec identifiers.
                    422:        <li>Implemented <a href="https://man.openbsd.org/iked.8">iked(8)</a>
                    423:                "from dynamic," installing flows where "dynamic" is replaced by the
                    424:                received dynamic IP address.
                    425:        <li>Made sure not to replace 0.0.0.0 with a dynamic address in <a
                    426:                href="https://man.openbsd.org/iked.8">iked(8)</a> if it is a network
                    427:                address.
                    428:        <li>Added <a href="https://man.openbsd.org/iked.8">iked(8)</a> -s
                    429:                socket option to specify a control socket.
                    430:        <li>Used a counter instead of random IV for AES-GCM in <a
                    431:                href="https://man.openbsd.org/iked.8">iked(8)</a>, eliminating the
                    432:                risk of random collisions.
                    433:        <li>Added <a href="https://man.openbsd.org/iked.8">iked(8)</a>
                    434:                support for multiple address pools.
                    435:        <li>Added the <a href="https://man.openbsd.org/iked.8">iked(8)</a>
                    436:                "set stickyaddress" option, which attempts to assign the same "config
                    437:                address" when an IKESA is negotiated with the DSTID of an existing
                    438:                IKESA.
                    439:        <li>Ensured rekeying of every child SA in <a
                    440:                href="https://man.openbsd.org/iked.8">iked(8)</a>.
1.5       benno     441:        <li>Added <a href="https://man.openbsd.org/iked.8">iked(8)</a> support
                    442:                for RSASSA-PSS signature verification (RFC 7427).
                    443:        <li>Corrected the first packet of an <a
                    444:                href="https://man.openbsd.org/ipsec.4">ipsec(4)</a> SA to have
                    445:                sequence number 1.
                    446:        <li>Accepted reject and blackhole routes for IPsec PMTU discovery.
                    447:        <li>Prevented leaking of ipsec_hosts in <a
                    448:                href="https://man.openbsd.org/iked.8">iked(8)</a> when building
                    449:                hosts_list.
                    450:        <li>Prevented initiation of new additional SAs for each policy upon
                    451:                every <a href="https://man.openbsd.org/ikectl.8">ikectl(8)</a> config
                    452:                reload.
                    453:        <li>Fixed "any" and "dynamic" keywords for flows in <a
                    454:                href="https://man.openbsd.org/iked.8">iked(8)</a> and added proper
                    455:                IPv6 support.
1.3       benno     456:
                    457:
                    458: <!-- LDAP -->
                    459:        <li>Fixed <a href="https://man.openbsd.org/ldapd.8">ldapd(8)</a> cert
                    460:                and key path inference for absolute paths.
                    461:
                    462:
                    463: <!-- PF -->
                    464:        <li>Relaxed checks in <a
                    465:                href="https://man.openbsd.org/pfctl.8">pfctl(8)</a> and <a
                    466:                href="https://man.openbsd.org/pf.4">pf(4)</a> to accept any valid
                    467:                routing domain, even if it does not yet exist.
                    468:
1.5       benno     469:        <li>Made <a href="https://man.openbsd.org/pfctl.8">pfctl(8)</a>
                    470:                detect and reject bogus ranges before loading the ruleset to prevent a
                    471:                panic.
                    472:
                    473:
1.3       benno     474:
1.5       benno     475: <!-- dig -->
                    476:        <li>Implemented RFC 8914 Extended DNS Errors for <a
                    477:                href="https://man.openbsd.org/dig.1">dig(1)</a>.
                    478:        <li>Fixed <a href="https://man.openbsd.org/dig.1">dig(1)</a> EDNS
                    479:                Client Subnet option (+subnet=).
                    480:        <li>Fixed IPv6 link-local address handling for nameservers to talk to
                    481:                and address to bind to in <a
                    482:                href="https://man.openbsd.org/dig.1">dig(1)</a>.
                    483:
                    484: <!-- dhclient -->
                    485:        <li>Fixed incorrect behavior when using <a
                    486:                href="https://man.openbsd.org/dhclient.conf.5">dhclient.conf(5)</a> to
                    487:                change the lease renew/rebind/expiry timing.
                    488:        <li>Allowed the provision of <a
                    489:                href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> options on
                    490:                "dhcp" lines in <a
                    491:                href="https://man.openbsd.org/hostname.if.5">hostname.if(5)</a> files.
                    492:
                    493:
                    494: <!-- other -->
1.3       benno     495:        <li>Changed <a href="https://man.openbsd.org/ping.8">ping(8)</a> to
                    496:                drain the raw socket of packets received before we were fully setup to
                    497:                avoid reporting ICMP responses intended for other instances of ping(8)
                    498:                running in parallel.
                    499:
                    500:        <li>Changed <a href="https://man.openbsd.org/slaacd.8">slaacd(8)</a>
                    501:                Duplicate Address Detection (DAD) to only generate a new address if we
                    502:                are using Semantically Opaque Interface Identifiers.
                    503:        <li>Handled an autoconf interface changing its rdomain in <a
                    504:                href="https://man.openbsd.org/slaacd.8">slaacd(8)</a>.
                    505:        <li>Fixed rare crashes of <a
                    506:                href="https://man.openbsd.org/unwind.8">unwind(8)</a> when DNS answers
                    507:                are larger than the maximum imsg size.
                    508:        <li>Removed the -L option from <a
                    509:                href="https://man.openbsd.org/dhclient.8">dhclient(8)</a>.
                    510:        <li>Added a simple --timeout implementation to <a
                    511:                href="https://man.openbsd.org/openrsync.1">openrsync(1)</a>.
                    512:        <li>Added support for the use of !command to <a
                    513:                href="https://man.openbsd.org/mygate.5">mygate(5)</a>, so that
                    514:                netstart has a late opportunity to perform network configuration.
1.5       benno     515:        <li>Make <a href="https://man.openbsd.org/rad.8">rad(8)</a> to handle
                    516:                multiple rdomains in a single daemon (instead of running it in
                    517:                multiple rdomains).
                    518:        <li>Added a specific headline to <a
                    519:                href="https://man.openbsd.org/netstat.1">netstat(1)</a> for TCP state
                    520:                and IP protocol.
                    521:        <li>Handled permanent redirects (RFC 7538) in <a
                    522:                href="https://man.openbsd.org/ftp.1">ftp(1)</a> fetch.
1.3       benno     523:
1.1       deraadt   524:   </ul>
                    525:
                    526: <li><a href="https://man.openbsd.org/tmux">tmux(1)</a> improvements and bug fixes:
                    527:   <ul>
1.5       benno     528:        <li>Made <a href="https://man.openbsd.org/tmux.1">tmux(1)</a> synchronize-panes a pane option and added set-option -U flag to unset an option on all panes.
1.1       deraadt   529:   </ul>
                    530:
                    531: <li>OpenSMTPD 6.9.0
                    532:   <ul>
1.5       benno     533:        <li>Introduced <a href="https://man.openbsd.org/smtp.1">smtp(1)</a>
                    534:                -a to perform authentication before sending a message.
                    535:        <li>Fixed a memory leak in <a href="https://man.openbsd.org/smtpd.8">smtpd(8)</a> resolver.
                    536:        <li>Prevented a crash due to premature release of resources by the <a
                    537:                href="https://man.openbsd.org/smtpd.8">smtpd(8)</a> filter state
                    538:                machine.
                    539:
1.1       deraadt   540:   </ul>
                    541:
                    542: <li>LibreSSL 3.2.2
                    543:   <ul>
                    544:     <li>New Features
                    545:     <ul>
1.3       benno     546: <!-- XXX not sorted into categories yet -->
                    547:        <li>Added a -legacy_verify flag to <a href="https://man.openbsd.org/openssl.1">openssl(1)</a> to force use of the old validator.
                    548:        <li>Changed <a href="https://man.openbsd.org/crypto.3">crypto(3)</a>
                    549:                to call its get_issuer() callback to try and find a suitable
                    550:                certificate in cases where it has failed to find a print certificate
                    551:                from the supplied roots and intermediates.
                    552:        <li>Corrected an issue where <a href="https://man.openbsd.org/openssl.1">openssl(1)</a> verify might not error on expired certificates.
                    553:        <li>Fixed an issue in the TLS 1.3 code that caused stalls in haproxy and other software.
                    554:        <li>Implemented auto chain for the TLSv1.3 server.
                    555:        <li>Implemented the key material exporter for TLSv1.3.
                    556:
                    557:
1.1       deraadt   558:     </ul>
                    559:
                    560:     <li>API and Documentation Enhancements
                    561:     <ul>
                    562:        <li>...
                    563:     </ul>
                    564:
                    565:     <li>Compatibility Changes
                    566:     <ul>
                    567:        <li>...
                    568:     </ul>
                    569:
                    570:     <li>Testing and Proactive Security
                    571:     <ul>
                    572:        <li>...
                    573:     </ul>
                    574:
                    575:     <li>Internal Improvements
                    576:       <ul>
                    577:        <li>...
                    578:       </ul>
                    579:
                    580:     <li>Portable Improvements
                    581:     <ul>
                    582:        <li>...
                    583:     </ul>
                    584:
                    585:     <li>Bug Fixes
                    586:     <ul>
                    587:        <li>...
                    588:     </ul>
                    589:   </ul>
                    590:
                    591: <li>OpenSSH 8.4
1.3       benno     592:
1.1       deraadt   593:   <ul>
1.3       benno     594:
                    595: <!-- XXX not sorted into categories yet -->
                    596:        <li>Preferred ed25519 signature algorithm variants over ECDSA in <a
                    597:                href="https://man.openbsd.org/ssh_config.5">ssh_config(5)</a> and <a
                    598:                href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>.
                    599:        <li>Enabled <a
                    600:                href="https://man.openbsd.org/ssh_config.5">ssh_config(5)</a>
                    601:                UpdateHostkeys by default when the configuration has not overridden
                    602:                UserKnownHostFile.
                    603:        <li>Prefixed <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
                    604:                keyboard interactive prompts with "user@host" for easier
                    605:                identification of connections.
                    606:        <li>Displayed any other hostnames/addresses associated with a new
                    607:                hostkey when <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
                    608:                prompts the user to accept it.
                    609:        <li>When doing an <a href="https://man.openbsd.org/sftp.1">sftp(1)</a>
                    610:                recursive upload or download of a read-only directory, ensured that
                    611:                the directory was created with write and execute permissions in the
                    612:                interim to allow the transfer.
                    613:        <li>Set the specified TOS/DSCP for interactive use prior to TCP
                    614:                connect in <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>.
                    615:        <li>CLeaned up passing of struct passwd from monitor to preauth
                    616:                privsep process in <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>.
1.5       benno     617:        <li>Added an <a
                    618:                href="https://man.openbsd.org/ssh_config.5">ssh_config(5)</a>
                    619:                KnownHostsCommand that allows the client to obtain known_hosts data
                    620:                from a command in addition to the usual files.
1.3       benno     621:
                    622:
1.1       deraadt   623:     <li>Potentially incompatible changes.
                    624:     <ul>
                    625:        <li>...
                    626:     </ul>
                    627:     <li>New Features
                    628:     <ul>
                    629:        <li>...
                    630:     </ul>
                    631:     <li>Bugfixes
                    632:     <ul>
                    633:        <li>...
                    634:     </ul>
                    635:   </ul>
                    636:
                    637: <li>Ports and packages:
                    638:   <p>Many pre-built packages for each architecture:
                    639:   <!-- number of FTP packages minus SHA256, SHA256.sig, index.txt -->
                    640:   <ul style="column-count: 3">
                    641:     <li>aarch64:     XXX
                    642:     <li>amd64:       XXX
                    643:     <li>arm:         XXX
                    644:     <li>i386:        XXX
                    645:     <li>mips64:      XXX
                    646:     <li>mips64el:    XXX
                    647:     <li>powerpc:     XXX
                    648:     <li>powerpc64:   XXX
                    649:     <li>sparc64:     XXX
                    650:   </ul>
                    651:
                    652: <li>As usual, steady improvements in manual pages and other documentation.
                    653:
                    654: <li>The system includes the following major components from outside suppliers:
                    655:   <ul>
1.5       benno     656:
                    657:     <li>Xenocara (based on X.Org 7.7 with xserver 1.20.10 + patches,
1.3       benno     658:         freetype 2.10.4, fontconfig 2.12.4, Mesa 20.0.8, xterm 351,
1.5       benno     659:         xkeyboard-config 2.20, fonttosfnt 1.2.1 and more)
1.1       deraadt   660:     <li>LLVM/Clang 10.0.1 (+ patches)
                    661:     <li>GCC 4.2.1 (+ patches) and 3.3.6 (+ patches)
                    662:     <li>Perl 5.30.3 (+ patches)
1.5       benno     663:     <li>NSD 4.3.4
                    664:     <li>Unbound 1.13.0
1.1       deraadt   665:     <li>Ncurses 5.7
                    666:     <li>Binutils 2.17 (+ patches)
                    667:     <li>Gdb 6.3 (+ patches)
1.5       benno     668:     <li>Awk December 18, 2020 version
                    669:     <li>Expat 2.2.10
1.1       deraadt   670:   </ul>
                    671:
                    672: </ul>
                    673: </section>
                    674:
                    675: <hr>
                    676:
                    677: <section id=install>
                    678: <h3>How to install</h3>
                    679: <p>
                    680: Please refer to the following files on the mirror site for
                    681: extensive details on how to install OpenBSD 6.9 on your machine:
                    682:
                    683: <ul>
                    684: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/alpha/INSTALL.alpha">
                    685:        .../OpenBSD/6.9/alpha/INSTALL.alpha</a>
                    686: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/amd64/INSTALL.amd64">
                    687:        .../OpenBSD/6.9/amd64/INSTALL.amd64</a>
                    688: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/arm64/INSTALL.arm64">
                    689:        .../OpenBSD/6.9/arm64/INSTALL.arm64</a>
                    690: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/armv7/INSTALL.armv7">
                    691:        .../OpenBSD/6.9/armv7/INSTALL.armv7</a>
                    692: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/hppa/INSTALL.hppa">
                    693:        .../OpenBSD/6.9/hppa/INSTALL.hppa</a>
                    694: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/i386/INSTALL.i386">
                    695:        .../OpenBSD/6.9/i386/INSTALL.i386</a>
                    696: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/landisk/INSTALL.landisk">
                    697:        .../OpenBSD/6.9/landisk/INSTALL.landisk</a>
                    698: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/loongson/INSTALL.loongson">
                    699:        .../OpenBSD/6.9/loongson/INSTALL.loongson</a>
                    700: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/luna88k/INSTALL.luna88k">
                    701:        .../OpenBSD/6.9/luna88k/INSTALL.luna88k</a>
                    702: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/macppc/INSTALL.macppc">
                    703:        .../OpenBSD/6.9/macppc/INSTALL.macppc</a>
                    704: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/octeon/INSTALL.octeon">
                    705:        .../OpenBSD/6.9/octeon/INSTALL.octeon</a>
                    706: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/powerpc64/INSTALL.powerpc64">
1.4       landry    707:        .../OpenBSD/6.9/powerpc64/INSTALL.powerpc64</a>
1.1       deraadt   708: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/sgi/INSTALL.sgi">
                    709:        .../OpenBSD/6.9/sgi/INSTALL.sgi</a>
                    710: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.9/sparc64/INSTALL.sparc64">
                    711:        .../OpenBSD/6.9/sparc64/INSTALL.sparc64</a>
                    712: </ul>
                    713: </section>
                    714:
                    715: <hr>
                    716:
                    717: <section id=quickinstall>
                    718: <p>
                    719: Quick installer information for people familiar with OpenBSD, and the use of
                    720: the "<a href="https://man.openbsd.org/disklabel.8">disklabel</a> -E" command.
                    721: If you are at all confused when installing OpenBSD, read the relevant
                    722: INSTALL.* file as listed above!
                    723:
                    724: <h3>OpenBSD/alpha:</h3>
                    725:
                    726: <p>
                    727: If your machine can boot from CD, you can write <i>install69.iso</i> or
                    728: <i>cd69.iso</i> to a CD and boot from it.
                    729: Refer to INSTALL.alpha for more details.
                    730:
                    731: <h3>OpenBSD/amd64:</h3>
                    732:
                    733: <p>
                    734: If your machine can boot from CD, you can write <i>install69.iso</i> or
                    735: <i>cd69.iso</i> to a CD and boot from it.
                    736: You may need to adjust your BIOS options first.
                    737:
                    738: <p>
                    739: If your machine can boot from USB, you can write <i>install69.img</i> or
                    740: <i>miniroot69.img</i> to a USB stick and boot from it.
                    741:
                    742: <p>
                    743: If you can't boot from a CD, floppy disk, or USB,
                    744: you can install across the network using PXE as described in the included
                    745: INSTALL.amd64 document.
                    746:
                    747: <p>
                    748: If you are planning to dual boot OpenBSD with another OS, you will need to
                    749: read INSTALL.amd64.
                    750:
                    751: <h3>OpenBSD/arm64:</h3>
                    752:
                    753: <p>
                    754: Write <i>miniroot69.img</i> to a disk and boot from it after connecting
                    755: to the serial console.  Refer to INSTALL.arm64 for more details.
                    756:
                    757: <h3>OpenBSD/armv7:</h3>
                    758:
                    759: <p>
                    760: Write a system specific miniroot to an SD card and boot from it after connecting
                    761: to the serial console.  Refer to INSTALL.armv7 for more details.
                    762:
                    763: <h3>OpenBSD/hppa:</h3>
                    764:
                    765: <p>
                    766: Boot over the network by following the instructions in INSTALL.hppa or the
                    767: <a href="hppa.html#install">hppa platform page</a>.
                    768:
                    769: <h3>OpenBSD/i386:</h3>
                    770:
                    771: <p>
                    772: If your machine can boot from CD, you can write <i>install69.iso</i> or
                    773: <i>cd69.iso</i> to a CD and boot from it.
                    774: You may need to adjust your BIOS options first.
                    775:
                    776: <p>
                    777: If your machine can boot from USB, you can write <i>install69.img</i> or
                    778: <i>miniroot69.img</i> to a USB stick and boot from it.
                    779:
                    780: <p>
                    781: If you can't boot from a CD, floppy disk, or USB,
                    782: you can install across the network using PXE as described in
                    783: the included INSTALL.i386 document.
                    784:
                    785: <p>
                    786: If you are planning on dual booting OpenBSD with another OS, you will need to
                    787: read INSTALL.i386.
                    788:
                    789: <h3>OpenBSD/landisk:</h3>
                    790:
                    791: <p>
                    792: Write <i>miniroot69.img</i> to the start of the CF
                    793: or disk, and boot normally.
                    794:
                    795: <h3>OpenBSD/loongson:</h3>
                    796:
                    797: <p>
                    798: Write <i>miniroot69.img</i> to a USB stick and boot bsd.rd from it
                    799: or boot bsd.rd via tftp.
                    800: Refer to the instructions in INSTALL.loongson for more details.
                    801:
                    802: <h3>OpenBSD/luna88k:</h3>
                    803:
                    804: <p>
                    805: Copy 'boot' and 'bsd.rd' to a Mach or UniOS partition, and boot the bootloader
                    806: from the PROM, and then bsd.rd from the bootloader.
                    807: Refer to the instructions in INSTALL.luna88k for more details.
                    808:
                    809: <h3>OpenBSD/macppc:</h3>
                    810:
                    811: <p>
                    812: Burn the image from a mirror site to a CDROM, and power on your machine
                    813: while holding down the <i>C</i> key until the display turns on and
                    814: shows <i>OpenBSD/macppc boot</i>.
                    815:
                    816: <p>
                    817: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
                    818: /6.9/macppc/bsd.rd</i>
                    819:
                    820: <h3>OpenBSD/octeon:</h3>
                    821:
                    822: <p>
                    823: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
                    824: Refer to the instructions in INSTALL.octeon for more details.
                    825:
                    826: <h3>OpenBSD/powerpc64:</h3>
                    827:
                    828: <p>
                    829: To install, write <i>install69.img</i> or <i>miniroot69.img</i> to a
                    830: USB stick, plug it into the machine and choose the <i>OpenBSD
                    831: install</i> menu item in Petitboot.
                    832: Refer to the instructions in INSTALL.powerpc64 for more details.
                    833:
                    834: <h3>OpenBSD/sgi:</h3>
                    835:
                    836: <p>
                    837: To install, burn cd69.iso on a CD-R, put it in the CD drive of your
                    838: machine and select <i>Install System Software</i> from the System Maintenance
                    839: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
                    840: CD-ROM, and need a proper invocation from the PROM prompt.
                    841: Refer to the instructions in INSTALL.sgi for more details.
                    842:
                    843: <p>
                    844: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
                    845: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
                    846: system type. Refer to the instructions in INSTALL.sgi for more details.
                    847:
                    848: <h3>OpenBSD/sparc64:</h3>
                    849:
                    850: <p>
                    851: Burn the image from a mirror site to a CDROM, boot from it, and type
                    852: <i>boot cdrom</i>.
                    853:
                    854: <p>
                    855: If this doesn't work, or if you don't have a CDROM drive, you can write
                    856: <i>floppy69.img</i> or <i>floppyB69.img</i>
                    857: (depending on your machine) to a floppy and boot it with <i>boot
                    858: floppy</i>. Refer to INSTALL.sparc64 for details.
                    859:
                    860: <p>
                    861: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    862: will most likely fail.
                    863:
                    864: <p>
                    865: You can also write <i>miniroot69.img</i> to the swap partition on
                    866: the disk and boot with <i>boot disk:b</i>.
                    867:
                    868: <p>
                    869: If nothing works, you can boot over the network as described in INSTALL.sparc64.
                    870: </section>
                    871:
                    872: <hr>
                    873:
                    874: <section id=upgrade>
                    875: <h3>How to upgrade</h3>
                    876: <p>
                    877: If you already have an OpenBSD 6.7 system, and do not want to reinstall,
                    878: upgrade instructions and advice can be found in the
                    879: <a href="faq/upgrade69.html">Upgrade Guide</a>.
                    880: </section>
                    881:
                    882: <hr>
                    883:
                    884: <section id=sourcecode>
                    885: <h3>Notes about the source code</h3>
                    886: <p>
                    887: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
                    888: This file contains everything you need except for the kernel sources,
                    889: which are in a separate archive.
                    890: To extract:
                    891: <blockquote><pre>
                    892: # <kbd>mkdir -p /usr/src</kbd>
                    893: # <kbd>cd /usr/src</kbd>
                    894: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
                    895: </pre></blockquote>
                    896: <p>
                    897: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
                    898: This file contains all the kernel sources you need to rebuild kernels.
                    899: To extract:
                    900: <blockquote><pre>
                    901: # <kbd>mkdir -p /usr/src/sys</kbd>
                    902: # <kbd>cd /usr/src</kbd>
                    903: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
                    904: </pre></blockquote>
                    905: <p>
                    906: Both of these trees are a regular CVS checkout.  Using these trees it
                    907: is possible to get a head-start on using the anoncvs servers as
                    908: described <a href="anoncvs.html">here</a>.
                    909: Using these files
                    910: results in a much faster initial CVS update than you could expect from
                    911: a fresh checkout of the full OpenBSD source tree.
                    912: </section>
                    913:
                    914: <hr>
                    915:
                    916: <section id=ports>
                    917: <h3>Ports Tree</h3>
                    918: <p>
                    919: A ports tree archive is also provided.  To extract:
                    920: <blockquote><pre>
                    921: # <kbd>cd /usr</kbd>
                    922: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
                    923: </pre></blockquote>
                    924: <p>
                    925: Go read the <a href="faq/ports/index.html">ports</a> page
                    926: if you know nothing about ports
                    927: at this point.  This text is not a manual of how to use ports.
                    928: Rather, it is a set of notes meant to kickstart the user on the
                    929: OpenBSD ports system.
                    930: <p>
                    931: The <i>ports/</i> directory represents a CVS checkout of our ports.
                    932: As with our complete source tree, our ports tree is available via
                    933: <a href="anoncvs.html">AnonCVS</a>.
                    934: So, in order to keep up to date with the -stable branch, you must make
                    935: the <i>ports/</i> tree available on a read-write medium and update the tree
                    936: with a command like:
                    937: <blockquote><pre>
                    938: # <kbd>cd /usr/ports</kbd>
                    939: # <kbd>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_6_9</kbd>
                    940: </pre></blockquote>
                    941: <p>
                    942: [Of course, you must replace the server name here with a nearby anoncvs
                    943: server.]
                    944: <p>
                    945: Note that most ports are available as packages on our mirrors. Updated
                    946: ports for the 6.9 release will be made available if problems arise.
                    947: <p>
                    948: If you're interested in seeing a port added, would like to help out, or just
                    949: would like to know more, the mailing list
                    950: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
                    951: </section>