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

Annotation of www/63.html, Revision 1.81

1.81    ! bentley     1: <!doctype html>
        !             2: <html lang=en id=release>
        !             3: <meta charset=utf-8>
        !             4:
1.1       deraadt     5: <title>OpenBSD 6.3</title>
                      6: <meta name="description" content="OpenBSD 6.3">
                      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/63.html">
                     10:
                     11:
1.81    ! bentley    12: <h2 id=OpenBSD>
1.1       deraadt    13: <a href="index.html">
1.81    ! bentley    14: <i>Open</i><b>BSD</b></a>
        !            15: 6.3
1.1       deraadt    16: </h2>
                     17:
1.81    ! bentley    18: <table>
        !            19: <tr>
        !            20: <td>
1.70      deraadt    21: <a href="images/Harry.gif">
1.81    ! bentley    22: <img alt="Harry" width="227" height="343" src="images/Harry.gif"></a>
        !            23: <td>
1.1       deraadt    24: Released Apr 15, 2018<br>
                     25: Copyright 1997-2018, Theo de Raadt.<br>
                     26: <br>
                     27: <br>
1.79      job        28: Artwork by Sam Hester.<br>
1.1       deraadt    29: <ul>
                     30: <li>See the information on <a href="ftp.html">the FTP page</a> for
                     31:     a list of mirror machines.
1.81    ! bentley    32: <li>Go to the <code class=reldir>pub/OpenBSD/6.3/</code> directory on
1.1       deraadt    33:     one of the mirror sites.
                     34: <li>Have a look at <a href="errata63.html">the 6.3 errata page</a> for a list
                     35:     of bugs and workarounds.
                     36: <li>See a <a href="plus63.html">detailed log of changes</a> between the
                     37:     6.2 and 6.3 releases.
                     38: <p>
                     39: <li><a href="https://man.openbsd.org/signify.1">signify(1)</a>
1.80      deraadt    40:     pubkeys for this release:<p>
                     41:
1.81    ! bentley    42: <table class=signify>
        !            43: <tr><td>
        !            44: openbsd-63-base.pub:
1.80      deraadt    45: <td>
                     46: RWRxzbLwAd76ZZxHU7wuIFUOVGwl6SjNNzanKWTql8w+hui7WLE/72mW
1.81    ! bentley    47: <tr><td>
1.80      deraadt    48: openbsd-63-fw.pub:
1.81    ! bentley    49: <td>
1.80      deraadt    50: RWT3tdmiAc+DH/CJOxPFT10kUM90/UcLTgSEUEKzhKm9QEhy+UD4CWPy
1.81    ! bentley    51: <tr><td>
1.80      deraadt    52: openbsd-63-pkg.pub:
1.81    ! bentley    53: <td>
1.80      deraadt    54: RWT58k1AWz/zZO9DHcPHXiHhDNP6hdwGjxNkyMoc/sh4O5NI8Zz1R1lD
                     55: </table>
                     56:
1.1       deraadt    57: <p>
                     58: All applicable copyrights and credits are in the src.tar.gz,
                     59: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
                     60: files fetched via ports.tar.gz.
                     61: </ul>
1.81    ! bentley    62: </table>
1.1       deraadt    63:
                     64: <hr>
                     65:
1.81    ! bentley    66: <section id=new>
        !            67: <h3>What's New</h3>
1.1       deraadt    68:
1.81    ! bentley    69: <p>
1.1       deraadt    70: This is a partial list of new features and systems included in OpenBSD 6.3.
                     71: For a comprehensive list, see the <a href="plus63.html">changelog</a> leading
                     72: to 6.3.
                     73:
                     74: <ul>
                     75:
                     76: <li>Improved hardware support, including:
                     77:     <ul>
1.26      kettenis   78:     <li>SMP support on OpenBSD/arm64 platforms.
1.28      kettenis   79:     <li>VFP and NEON support on OpenBSD/armv7 platforms.
1.21      jsg        80:     <li>New <a href="https://man.openbsd.org/acrtc.4">acrtc(4)</a> driver
                     81:        for X-Powers AC100 audio codec and Real Time Clock.
                     82:     <li>New <a href="https://man.openbsd.org/axppmic.4">axppmic(4)</a> driver
                     83:        for X-Powers AXP Power Management ICs.
                     84:     <li>New <a href="https://man.openbsd.org/bcmrng.4">bcmrng(4)</a> driver
                     85:        for Broadcom BCM2835/BCM2836/BCM2837 random number generator.
                     86:     <li>New <a href="https://man.openbsd.org/bcmtemp.4">bcmtemp(4)</a> driver
                     87:        for Broadcom BCM2835/BCM2836/BCM2837 temperature monitor.
                     88:     <li>New <a href="https://man.openbsd.org/bgw.4">bgw(4)</a> driver
                     89:        for Bosch motion sensor.
                     90:     <li>New <a href="https://man.openbsd.org/bwfm.4">bwfm(4)</a> driver
1.59      stsp       91:        for Broadcom and Cypress FullMAC 802.11 devices (still experimental and not compiled into the kernel by default)
1.21      jsg        92:     <li>New <a href="https://man.openbsd.org/efi.4">efi(4)</a> driver
                     93:        for EFI runtime services.
                     94:     <li>New <a href="https://man.openbsd.org/imxanatop.4">imxanatop(4)</a> driver
                     95:        for i.MX6 integrated regulator.
                     96:     <li>New <a href="https://man.openbsd.org/rkpcie.4">rkpcie(4)</a> driver
                     97:        for Rockchip RK3399 Host/PCIe bridge.
                     98:     <li>New <a href="https://man.openbsd.org/sxirsb.4">sxirsb(4)</a> driver
                     99:        for Allwinner Reduced Serial Bus controller.
                    100:     <li>New <a href="https://man.openbsd.org/sxitemp.4">sxitemp(4)</a> driver
                    101:        for Allwinner temperature monitor.
                    102:     <li>New <a href="https://man.openbsd.org/sxits.4">sxits(4)</a> driver
                    103:        for temperature sensor on Allwinner A10/A20 touchpad controller.
                    104:     <li>New <a href="https://man.openbsd.org/sxitwi.4">sxitwi(4)</a> driver
                    105:        for two-wire bus found on several Allwinner SoCs.
                    106:     <li>New <a href="https://man.openbsd.org/sypwr.4">sypwr(4)</a> driver
                    107:        for the Silergy SY8106A regulator.
1.53      bcook     108:     <li>Support for Rockchip RK3328 SoCs has been added to the
1.26      kettenis  109:         <a href="https://man.openbsd.org/dwge.4">dwge(4)</a>,
                    110:         <a href="https://man.openbsd.org/rkgrf.4">rkgrf(4)</a>,
                    111:        <a href="https://man.openbsd.org/rkclock.4">rkclock(4)</a> and
                    112:        <a href="https://man.openbsd.org/rkpinctrl.4">rkpinctrl(4)</a>
                    113:        drivers.
1.53      bcook     114:     <li>Support for Rockchip RK3288/RK3328 SoCs has been added to the
1.26      kettenis  115:         <a href="https://man.openbsd.org/rktemp.4">rktemp(4)</a>
                    116:        driver.
                    117:     <li>Support for Allwinner A10/A20, A23/A33, A80 and R40/V40
                    118:         SoCs has been added to the
                    119:        <a href="https://man.openbsd.org/sxiccmu.4">sxiccmu(4)</a> driver.
                    120:     <li>Support for Allwinner A33, GR8 and R40/V40 SoCs has been
                    121:         added to the
                    122:        <a href="https://man.openbsd.org/sxipio.4">sxipio(4)</a> driver.
1.44      jsg       123:     <li>Support for SAS3.5 MegaRAIDs has been added to the
1.21      jsg       124:         <a href="https://man.openbsd.org/mfii.4">mfii(4)</a> driver.
1.44      jsg       125:     <li>Support for Intel Cannon Lake and Ice Lake integrated Ethernet
                    126:         has been added to the
1.21      jsg       127:         <a href="https://man.openbsd.org/em.4">em(4)</a> driver.
1.23      visa      128:     <li><a href="https://man.openbsd.org/cnmac.4">cnmac(4)</a> ports are now
                    129:         assigned to different CPU cores for distributed interrupt processing.
1.24      anton     130:     <li>The <a href="https://man.openbsd.org/pms.4">pms(4)</a> driver now
                    131:         detects and handles reset announcements.
1.25      jsg       132:     <li>On amd64 Intel CPU microcode is loaded on boot and installed/updated by
                    133:         <a href="https://man.openbsd.org/fw_update.1">fw_update(1)</a>.
1.35      kettenis  134:     <li>Support the sun4v hypervisor interrupt cookie API, adding support
                    135:         for SPARC T7-1/2/4 machines.
1.43      jmatthew  136:     <li>Hibernate support has been added for SD/MMC storage attached to
                    137:         <a href="https://man.openbsd.org/sdhc.4">sdhc(4)</a> controllers.
1.61      schwarze  138:     <li><a href="https://man.openbsd.org/clang.1">clang(1)</a>
                    139:         is now used as the system compiler on armv7,
                    140:         and it is also provided on sparc64.
1.1       deraadt   141:     </ul>
                    142:
                    143: <li><a href="https://man.openbsd.org/amd64/vmm.4">vmm(4)</a>/
                    144:     <a href="https://man.openbsd.org/amd64/vmd.8">vmd(8)</a> improvements:
                    145:     <ul>
1.8       ccardena  146:     <li>Add CD-ROM/DVD ISO support to <a
                    147:         href="https://man.openbsd.org/amd64/vmd.8">vmd(8)</a> via <a
                    148:        href="https://man.openbsd.org/vioscsi.4">vioscsi(4)</a>.
                    149:     <li><a href="https://man.openbsd.org/amd64/vmd.8">vmd(8)</a> no longer
                    150:        creates an underlying bridge interface for virtual switches defined in
1.45      jsg       151:        <a href="https://man.openbsd.org/amd64/vm.conf.5">vm.conf(5)</a>.
1.8       ccardena  152:     <li><a href="https://man.openbsd.org/amd64/vmd.8">vmd(8)</a> receives
                    153:        switch information (rdomain, etc) from underlying switch interface in
                    154:        conjunction of settings in <a
1.45      jsg       155:        href="https://man.openbsd.org/amd64/vm.conf.5">vm.conf(5)</a>.
                    156:     <li>Time Stamp Counter (TSC) support in guest VMs.
1.18      mlarkin   157:     <li>Support ukvm/Solo5 unikernels in
1.45      jsg       158:         <a href="https://man.openbsd.org/amd64/vmm.4">vmm(4)</a>.
                    159:     <li>Handle valid (but uncommon) instruction encodings better.
                    160:     <li>Better PAE paging support for 32-bit Linux guest VMs.
1.18      mlarkin   161:     <li><a href="https://man.openbsd.org/amd64/vmd.8">vmd(8)</a> now allows up
1.45      jsg       162:         to four network interfaces in each VM.
1.17      pd        163:     <li>Add paused migration and snapshotting support to <a
                    164:         href="https://man.openbsd.org/amd64/vmm.4">vmm(4)</a> for AMD SVM/RVI
                    165:         hosts.
1.37      deraadt   166:     <li>BREAK commands sent over a
1.33      mpi       167:      <a href="https://man.openbsd.org/pty.4">pty(4)</a> are now understood by
                    168:      <a href="https://man.openbsd.org/vmd.8">vmd(8)</a>.
1.8       ccardena  169:     <li>Many fixes to <a href="https://man.openbsd.org/amd64/vmctl.8">vmctl(8)</a>
1.45      jsg       170:         and <a href="https://man.openbsd.org/amd64/vmd.8">vmd(8)</a> error handling.
1.1       deraadt   171:     </ul>
                    172:
                    173: <li>IEEE 802.11 wireless stack improvements:
                    174:     <ul>
1.34      stsp      175:     <li>The <a href="https://man.openbsd.org/iwm.4">iwm(4)</a> and
1.37      deraadt   176:        <a href="https://man.openbsd.org/iwn.4">iwn(4)</a> drivers will
                    177:        automatically roam between access points which share an ESSID.
                    178:         Forcing a particular AP's MAC address with ifconfig's <b>bssid</b>
                    179:         command disables roaming.
                    180:     <li>Automatically clear configured WEP/WPA keys when a new network ESSID
                    181:        is configured.
                    182:     <li>Removed the ability for userland to read configured WEP/WPA keys back
                    183:        from the kernel.
                    184:     <li>The <a href="https://man.openbsd.org/iwm.4">iwm(4)</a> driver can now
                    185:        connect to networks with a hidden SSID.
                    186:     <li>USB devices supported by the
                    187:        <a href="https://man.openbsd.org/athn.4">athn(4)</a> driver
                    188:         now use an open source firmware, and hostap mode now works with
                    189:        these devices.
1.1       deraadt   190:     </ul>
                    191:
                    192: <li>Generic network stack improvements:
                    193:     <ul>
1.37      deraadt   194:     <li>The network stack no longer runs with the KERNEL_LOCK() when IPsec is
1.46      deraadt   195:         enabled.
1.42      bluhm     196:     <li>Processing of incoming TCP/UDP packets is now done without
1.46      deraadt   197:         KERNEL_LOCK().
1.42      bluhm     198:     <li>The socket splicing task runs without KERNEL_LOCK().
1.37      deraadt   199:     <li>Cleanup and removal of code in sys/netinet6 since autoconfiguration
                    200:         runs in userland now.
                    201:     <li><a href="https://man.openbsd.org/bridge.4">bridge(4)</a> members can
                    202:         now be prevented to talk to each others with the new <b>protected</b>
                    203:         option.
1.42      bluhm     204:     <li>The pf divert-packet feature has been simplified.
                    205:        The IP_DIVERTFL socket option has been removed from <a
                    206:        href="https://man.openbsd.org/divert.4">divert(4)</a>.
                    207:     <li>Various corner cases of pf divert-to and divert-reply are
                    208:        more consistent now.
                    209:     <li>Enforce in <a href="https://man.openbsd.org/pf.4">pf(4)</a>
                    210:        that all neighbor discovery packets have 255 in their IPv6
                    211:        header hop limit field.
1.61      schwarze  212:     <li>New <code>set syncookies</code> option in
                    213:         <a href="https://man.openbsd.org/pf.conf.5">pf.conf(5)</a>.
1.50      jsg       214:     <li>Support for GRE over IPv6.
1.48      dlg       215:     <li>New <a href="https://man.openbsd.org/egre.4">egre(4)</a>
                    216:         driver for Ethernet over GRE tunnels.
1.53      bcook     217:     <li>Support for the optional GRE key header and GRE key entropy in
1.48      dlg       218:         <a href="https://man.openbsd.org/gre.4">gre(4)</a> and
                    219:         <a href="https://man.openbsd.org/egre.4">egre(4)</a>.
                    220:     <li>New <a href="https://man.openbsd.org/nvgre.4">nvgre(4)</a>
1.51      jsg       221:         driver for Network Virtualization using Generic Routing Encapsulation.
1.71      dlg       222:     <li>Support for configuring the Don't Fragment flag on packets encapsulated
1.48      dlg       223:         by tunnel interfaces.
1.1       deraadt   224:     </ul>
                    225:
                    226: <li>Installer improvements:
                    227:     <ul>
1.60      tb        228:     <li>if install.site or upgrade.site fails, notify the user and error out
                    229:       after storing rand.seed.
1.55      krw       230:     <li>allow CIDR notation when entering IPv4 and IPv6 addresses.
                    231:     <li>repair selection of a HTTP mirror from the list of mirrors.
                    232:     <li>allow '-' in usernames.
                    233:     <li>ask a question at the end of the install/upgrade process so
                    234:       carriage return causes the appropriate action, e.g. reboot.
1.60      tb        235:     <li>display the mode (install or upgrade) shell prompts as
                    236:       long as no hostname is known.
1.55      krw       237:     <li>correctly detect which interface has the default route and if it was
                    238:       configured via DHCP.
                    239:     <li>ensure sets can be read from the prefetch area.
                    240:     <li>ensure URL redirection is effective for entire install/upgrade.
                    241:     <li>add the HTTP proxy used when fetching sets to rc.firsttime, where
                    242:       fw_update and syspatch can find and use it.
1.60      tb        243:     <li>add logic to support RFC 7217 with SLAAC.
1.55      krw       244:     <li>ensure that IPv6 is configured for dynamically created network
1.60      tb        245:       interfaces like <a href="https://man.openbsd.org/vlan.4">vlan(4)</a>.
1.55      krw       246:     <li>create correct hostname when both domain-name and
                    247:       domain-search options are provided in the DHCP lease.
1.1       deraadt   248:     </ul>
                    249:
                    250: <li>Routing daemons and other userland network improvements:
                    251:     <ul>
1.10      deraadt   252:     <li><a href="https://man.openbsd.org/bgpctl.8">bgpctl(8)</a> has a new
1.45      jsg       253:         <b>ssv</b> option which outputs rib entries as a single semicolon-separated
1.10      deraadt   254:         like for selection before output.
1.13      florian   255:     <li><a href="https://man.openbsd.org/slaacd.8">slaacd(8)</a> generates
                    256:         random but stable IPv6 stateless autoconfiguration addresses according
                    257:         to RFC 7217.
                    258:         These are enabled per default in accordance with RFC 8064.
1.52      phessler  259:     <li><a href="https://man.openbsd.org/slaacd.8">slaacd(8)</a> follows
                    260:         RFC 4862 by removing an artificial limitation on /64 sized prefixes
                    261:         using RFC 7217 (random but stable) and RFC 4941 (privacy) style
                    262:         stateless autoconfiguration addresses.
1.27      remi      263:     <li><a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a> can now set the
                    264:         metric for a route depending on the status of an interface.
1.37      deraadt   265:     <li><a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a> has a new
                    266:         <b>staticarp</b> option to make interfaces reply to ARP requests only.
                    267:     <li><a href="https://man.openbsd.org/ipsecctl.8">ipsecctl(8)</a> can now
1.45      jsg       268:         collapse flow outputs having the same source or destination.
1.81    ! bentley   269:     <li>The <code>-n</code> option in
1.36      tb        270:         <a href="https://man.openbsd.org/netstart.8">netstart(8)</a> no longer
                    271:         messes with the default route.
                    272:         It is now documented as well.
1.1       deraadt   273:     </ul>
                    274:
                    275: <li>Security improvements:
                    276:     <ul>
1.10      deraadt   277:     <li>Use even more trap-sleds on various architectures.
                    278:     <li>More use of .rodata for constant variables in assembly source.
                    279:     <li>Stop using x86 "repz ret" in dusty corners of the tree.
                    280:     <li>Introduce "execpromises" in
                    281:         <a href="https://man.openbsd.org/pledge.2">pledge(2)</a>.
1.61      schwarze  282:     <li>The elfrdsetroot utility used to build ramdisks and the
                    283:         <a href="https://man.openbsd.org/rebound">rebound(8)</a>
                    284:         monitoring process now use
                    285:         <a href="https://man.openbsd.org/pledge.2">pledge(2)</a>.
1.53      bcook     286:     <li>Prepare for the introduction of <b>MAP_STACK</b> to
1.10      deraadt   287:         <a href="https://man.openbsd.org/mmap.2">mmap(2)</a> after 6.3.
                    288:     <li>Push a small piece of KARL-linked kernel text into the random
                    289:         number generator as entropy at startup.
                    290:     <li>Put a small random gap at the top of thread stacks, so that attackers
                    291:         have yet another calculation to perform for their ROP work.
1.45      jsg       292:     <li>Mitigation for Meltdown vulnerability for Intel brand amd64 CPUs.
1.26      kettenis  293:     <li>OpenBSD/arm64 now uses kernel page table isolation to mitigate
                    294:         Spectre variant 3 (Meltdown) attacks.
1.50      jsg       295:     <li>OpenBSD/armv7 and OpenBSD/arm64 now flush the Branch Target Buffer
                    296:         (BTB) on processors that do speculative execution to
1.26      kettenis  297:         mitigate Spectre variant 2 attacks.
1.49      dlg       298:     <li><a href="https://man.openbsd.org/pool_get.9">pool_get(9)</a> perturbs
                    299:         the order of items on newly allocated pages, making the kernel heap
                    300:         layout harder to predict.
1.61      schwarze  301:     <li>The
                    302:         <a href="https://man.openbsd.org/OpenBSD-6.2/ktrace.2">fktrace(2)</a>
                    303:         system call was deleted.
1.1       deraadt   304:     </ul>
                    305:
                    306: <li><a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> improvements:
                    307:     <ul>
1.44      jsg       308:       <li>Parsing <a href="https://man.openbsd.org/dhclient.conf.5">
1.32      krw       309:        dhclient.conf(5)</a> no longer leaks SSID strings, strings that are
                    310:        too long for the parsing buffer or repeated string options and commands.
1.44      jsg       311:       <li>Storing leases in <a href="https://man.openbsd.org/dhclient.conf.5">
1.32      krw       312:          dhclient.conf(5)</a> is no longer supported.
                    313:       <li>'DENY' is no longer valid in  <a href="https://man.openbsd.org/dhclient.conf.5">
                    314:          dhclient.conf(5)</a>.
                    315:       <li><a href="https://man.openbsd.org/dhclient.conf.5">
                    316:          dhclient.conf(5)</a> and
                    317:        <a href="https://man.openbsd.org/dhclient.leases.5">
                    318:          dhclient.leases(5)</a>
                    319:        parsing error messages have been simplified and clarified, with
                    320:        improved behaviour in the presence of unexpected semicolons.
1.44      jsg       321:       <li>More care is taken to only use configuration information that was
1.32      krw       322:        successfully parsed.
1.41      krw       323:       <li>'-n' has been added, which causes
                    324:        <a href="https://man.openbsd.org/dhclient.8">
                    325:          dhclient(8)</a> to exit after parsing
                    326:        <a href="https://man.openbsd.org/dhclient.conf.5">
                    327:          dhclient.conf(5)</a>.
1.44      jsg       328:       <li>Default routes in options classless-static-routes (121) and
1.41      krw       329:        classless-ms-static-routes (249) are now correctly represented in
                    330:        <a href="https://man.openbsd.org/dhclient.leases.5">
                    331:          dhclient.leases(5)</a> files.
1.44      jsg       332:     <li>Overwrite the file specified with '-L' rather than appending to it.
                    333:     <li>Leases in <a href="https://man.openbsd.org/dhclient.leases.5">
1.41      krw       334:        dhclient.leases(5)</a> now contain an 'epoch' attribute recording
                    335:       the time the lease was accepted, which is used to calculate correct
                    336:       renewal, rebinding and expiry times.
1.44      jsg       337:     <li>No longer nag about underscores in names violating RFC 952.
                    338:     <li>Unconditionally send host-name information when
1.41      krw       339:       requesting a lease, eliminating the need for
                    340:        <a href="https://man.openbsd.org/dhclient.conf.5">
                    341:          dhclient.conf(5)</a> in the default installation.
1.44      jsg       342:     <li>Be quiet by default. '-q' has been removed and '-v' added to
1.41      krw       343:       enable verbose logging.
1.44      jsg       344:     <li>Decline duplicate offers for the requested address.
                    345:     <li>Unconditionally go into the background after link-timeout seconds.
                    346:     <li>Significantly reduce logging when being quiet, but make '-v' log
1.41      krw       347:       all debug information without needing to compile a custom executable.
1.44      jsg       348:     <li>Ignore 'interface' statements in
1.41      krw       349:        <a href="https://man.openbsd.org/dhclient.leases.5">
                    350:          dhclient.leases(5)</a> and assume all leases in the file are
                    351:        for the interface being configured.
1.44      jsg       352:     <li>Display the source of the lease bound to the interface.
1.41      krw       353:     <li>'ignore', 'request' and 'require' declarations in
                    354:        <a href="https://man.openbsd.org/dhclient.conf.5">
                    355:          dhclient.conf(5)</a> now add the specified options to the relevant
                    356:        list rather than replacing the list.
1.44      jsg       357:     <li>Eliminate a startup race that could result in
1.41      krw       358:        <a href="https://man.openbsd.org/dhclient.8">
                    359:          dhclient(8)</a> exiting without configuring the interface.
1.1       deraadt   360:     </ul>
                    361:
                    362: <li>Assorted improvements:
                    363:     <ul>
1.9       otto      364:     <li>Code reorganization and other improvements to
                    365:         <a href="https://man.openbsd.org/malloc.3">malloc(3)</a>
                    366:        and friends to make them more efficient.
1.10      deraadt   367:     <li>When performing suspend or hibernate operations, ensure all filesystems
1.44      jsg       368:         are properly synchronized and marked clean, or if they cannot be
1.10      deraadt   369:         put into perfectly clean state on disk (due to open+unlinked files)
1.44      jsg       370:         then mark them dirty, so that a failed resume/unhibernate is guaranteed
                    371:        to perform <a href="https://man.openbsd.org/fsck.8">fsck(8)</a>.
1.16      florian   372:     <li><a href="https://man.openbsd.org/acme-client.1">acme-client(1)</a>
1.44      jsg       373:         autodetects the agreement URL and follows 30x HTTP redirects.
1.45      jsg       374:     <li>Added __cxa_thread_atexit() to support modern C++ tool chains.
1.20      guenther  375:     <li>Added EVFILT_DEVICE support to
                    376:        <a href="https://man.openbsd.org/kqueue.2">kqueue(2)</a> for
1.44      jsg       377:        monitoring changes to
                    378:        <a href="https://man.openbsd.org/drm.4">drm(4)</a> devices.
1.23      visa      379:     <li><a href="https://man.openbsd.org/ldexp.3">ldexp(3)</a> now handles
1.30      krw       380:       the sign of denormal numbers correctly on mips64.
1.61      schwarze  381:     <li>New <a href="https://man.openbsd.org/sincos.3">sincos(3)</a>
                    382:         functions in libm.
1.30      krw       383:     <li><a href="https://man.openbsd.org/fdisk.8">fdisk(8)</a> now ensures the
                    384:       validity of MBR partition offsets entered while editing.
                    385:     <li><a href="https://man.openbsd.org/fdisk.8">fdisk(8)</a> now ensures that
                    386:       default values lie within the valid range.
                    387:     <li><a href="https://man.openbsd.org/less.1">less(1)</a> now splits only
1.32      krw       388:       the environment variable LESS on '$'.
1.30      krw       389:     <li><a href="https://man.openbsd.org/less.1">less(1)</a> no longer creates
                    390:       a spurious file when encountering '$' in the initial command.
                    391:     <li><a href="https://man.openbsd.org/softraid.4">softraid(4)</a> now validates
                    392:       the number of chunks when assembling a volume, ensuring the on-disk
                    393:       and in-memory metadata are in sync.
1.31      krw       394:     <li><a href="https://man.openbsd.org/disklabel.8">disklabel(8)</a> now
                    395:       always offers to edit an FFS partition's fragment size before offering to
                    396:       edit the blocksize.
                    397:     <li><a href="https://man.openbsd.org/disklabel.8">disklabel(8)</a> now
                    398:       allows editing the cylinders/group (cpg) attribute whenever the partition
                    399:       blocksize can be edited.
                    400:     <li><a href="https://man.openbsd.org/disklabel.8">disklabel(8)</a> now
                    401:       detects ^D and invalid input during (R)esize commands.
                    402:     <li><a href="https://man.openbsd.org/disklabel.8">disklabel(8)</a> now
                    403:       detects underflows and overflows when -/+ operators are used.
                    404:     <li><a href="https://man.openbsd.org/disklabel.8">disklabel(8)</a> now
                    405:       avoids an off-by-one when calculating the number of cylinders in a free
                    406:       chunk.
                    407:     <li><a href="https://man.openbsd.org/disklabel.8">disklabel(8)</a> now
                    408:       validates the requested partition size against the size of the largest free
                    409:       chunk instead of the total free space.
1.37      deraadt   410:     <li>Support for dumping USB transfers via
1.45      jsg       411:         <a href="https://man.openbsd.org/bpf.4">bpf(4)</a>.
1.37      deraadt   412:     <li><a href="https://man.openbsd.org/tcpdump.8">tcpdump(8)</a> can now
1.38      deraadt   413:         understand dumps of USB transfers in the
1.37      deraadt   414:         <a href="http://desowin.org/usbpcap/captureformat.html">USBPcap</a>
                    415:         format.
1.36      tb        416:     <li>The default prompts of <a href="https://man.openbsd.org/csh.1">csh(1)</a>,
                    417:         <a href="https://man.openbsd.org/ksh.1">ksh(1)</a> and
                    418:         <a href="https://man.openbsd.org/sh.1">sh(1)</a> now include the hostname.
1.44      jsg       419:     <li>Memory allocation in
                    420:         <a href="https://man.openbsd.org/ksh.1">ksh(1)</a> was switched from
1.36      tb        421:         <a href="https://man.openbsd.org/calloc.3">calloc(3)</a> back to
                    422:         <a href="https://man.openbsd.org/malloc.3">malloc(3)</a>,
                    423:         making it easier to recognize uninitialized memory.
                    424:         As a result, a history-related bug in emacs editing mode was discovered
                    425:         and fixed.
1.61      schwarze  426:     <li>New <a href="https://man.openbsd.org/script.1">script(1)</a>
                    427:         <code>-c</code> option to run a command instead of a shell.
                    428:     <li>New <a href="https://man.openbsd.org/grep.1">grep(1)</a>
                    429:         <code>-m</code> option to limit the number of matches.
                    430:     <li>New <a href="https://man.openbsd.org/uniq.1">uniq(1)</a>
                    431:         <code>-i</code> option for case-insensitive comparison.
1.36      tb        432:     <li>The <a href="https://man.openbsd.org/printf.3">printf(3)</a> format
1.81    ! bentley   433:         string is no longer validated when looking for <code>%</code> formats.
1.36      tb        434:         Based on a commit by android and following most other operating systems.
                    435:     <li>Improved error checking in
                    436:         <a href="https://man.openbsd.org/vfwprintf.3">vfwprintf(3)</a>.
                    437:     <li>Many base programs have been audited and fixed for stale file descriptors,
                    438:         including
                    439:         <a href="https://man.openbsd.org/cron.8">cron(8)</a>,
                    440:         <a href="https://man.openbsd.org/ftp.1">ftp(1)</a>,
                    441:         <a href="https://man.openbsd.org/mandoc.1">mandoc(1)</a>,
                    442:         <a href="https://man.openbsd.org/openssl.1">openssl(1)</a>,
                    443:         <a href="https://man.openbsd.org/ssh.1">ssh(1)</a> and
                    444:         <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>.
                    445:     <li>Various bug fixes and improvements in
                    446:         <a href="https://man.openbsd.org/jot.1">jot(1)</a>:
                    447:         <ul>
                    448:           <li>Arbitrary length limits for the arguments for the
1.81    ! bentley   449:               <code>-b</code>, <code>-s</code>, <code>-w</code> options were removed.
        !           450:           <li>The <code>%F</code> format specifier is now supported and a bug
        !           451:               in the <code>%D</code> format was fixed.
1.36      tb        452:           <li>Better code coverage in regression tests.
                    453:           <li>Several buffer overruns were fixed.
                    454:         </ul>
                    455:     <li>The <a href="https://man.openbsd.org/patch.1">patch(1)</a> utility now
                    456:         copes better with git diffs that create or delete files.
1.42      bluhm     457:     <li><a href="https://man.openbsd.org/pkg_add.1">pkg_add(1)</a>
                    458:        now has improved support for HTTP(S) redirectors such as
                    459:        <i>cdn.openbsd.org</i>.
1.56      espie     460:     <li><a href="https://man.openbsd.org/ftp.1">ftp(1)</a> and
                    461:        <a href="https://man.openbsd.org/pkg_add.1">pkg_add(1)</a>
                    462:        now support HTTPS session resumption for improved speed.
1.61      schwarze  463:     <li><a href="https://man.openbsd.org/mandoc.1">mandoc(1)</a>
                    464:         <code>-T ps</code> output file size reduced by more than 50%.
1.42      bluhm     465:     <li><a href="https://man.openbsd.org/syslogd.8">syslogd(8)</a>
                    466:        logs if there were warnings during startup.
                    467:     <li><a href="https://man.openbsd.org/syslogd.8">syslogd(8)</a>
                    468:        stopped logging to files in a full filesystem.  Now it
                    469:        writes a warning and continues after space has been made
                    470:        available.
1.43      jmatthew  471:     <li><a href="https://man.openbsd.org/vmt.4">vmt(4)</a> now allows cloning and
                    472:       taking disk-only snapshots of running guests.
1.1       deraadt   473:     </ul>
                    474:
1.22      jsg       475: <li>OpenSMTPD 6.0.4
1.1       deraadt   476:     <ul>
1.47      deraadt   477:     <li>Add <b>spf walk</b> option to
1.54      gilles    478:       <a href="https://man.openbsd.org/smtpctl.8">smtpctl(8)</a>.
                    479:     <li>Assorted cleanups and improvements.
                    480:     <li>Numerous manual page fixes and improvements.
1.1       deraadt   481:     </ul>
                    482:
1.22      jsg       483: <li>OpenSSH 7.7
1.1       deraadt   484:     <ul>
                    485:     <li>New/changed features:
                    486:       <ul>
1.47      deraadt   487:       <li>All: Add experimental support for PQC XMSS keys (Extended Hash-
                    488:           Based Signatures) based on the algorithm described in
                    489:           https://tools.ietf.org/html/draft-irtf-cfrg-xmss-hash-based-signatures-12
                    490:           The XMSS signature code is experimental and not compiled in by
                    491:           default.
                    492:       <li>sshd(8): Add a "rdomain" criteria for the sshd_config Match keyword
                    493:           to allow conditional configuration that depends on which routing
                    494:           domain a connection was received on (currently supported on OpenBSD
                    495:           and Linux).
                    496:       <li>sshd_config(5): Add an optional rdomain qualifier to the
                    497:           ListenAddress directive to allow listening on different routing
                    498:           domains. This is supported only on OpenBSD and Linux at present.
                    499:       <li>sshd_config(5): Add RDomain directive to allow the authenticated
                    500:           session to be placed in an explicit routing domain. This is only
                    501:           supported on OpenBSD at present.
                    502:       <li>sshd(8): Add "expiry-time" option for authorized_keys files to
                    503:           allow for expiring keys.
                    504:       <li>ssh(1): Add a BindInterface option to allow binding the outgoing
                    505:           connection to an interface's address (basically a more usable
1.50      jsg       506:           BindAddress).
1.47      deraadt   507:       <li>ssh(1): Expose device allocated for tun/tap forwarding via a new
                    508:           %T expansion for LocalCommand. This allows LocalCommand to be used
                    509:           to prepare the interface.
                    510:       <li>sshd(8): Expose the device allocated for tun/tap forwarding via a
                    511:           new SSH_TUNNEL environment variable. This allows automatic setup of
                    512:           the interface and surrounding network configuration automatically on
                    513:           the server.
                    514:       <li>ssh(1)/scp(1)/sftp(1): Add URI support to ssh, sftp and scp, e.g.
                    515:           ssh://user@host or sftp://user@host/path.  Additional connection
                    516:           parameters described in draft-ietf-secsh-scp-sftp-ssh-uri-04 are not
                    517:           implemented since the ssh fingerprint format in the draft uses the
                    518:           deprecated MD5 hash with no way to specify the any other algorithm.
                    519:       <li>ssh-keygen(1): Allow certificate validity intervals that specify
                    520:           only a start or stop time (instead of both or neither).
                    521:       <li>sftp(1): Allow "cd" and "lcd" commands with no explicit path
                    522:           argument. lcd will change to the local user's home directory as
                    523:           usual. cd will change to the starting directory for session (because
                    524:           the protocol offers no way to obtain the remote user's home
                    525:           directory). bz#2760
                    526:       <li>sshd(8): When doing a config test with sshd -T, only require the
                    527:           attributes that are actually used in Match criteria rather than (an
                    528:           incomplete list of) all criteria.
1.1       deraadt   529:       </ul>
                    530:     <li>The following significant bugs have been fixed in this release:
                    531:       <ul>
1.47      deraadt   532:       <li>ssh(1)/sshd(8): More strictly check signature types during key
                    533:           exchange against what was negotiated. Prevents downgrade of RSA
                    534:           signatures made with SHA-256/512 to SHA-1.
                    535:       <li>sshd(8): Fix support for client that advertise a protocol version
                    536:           of "1.99" (indicating that they are prepared to accept both SSHv1 and
                    537:           SSHv2). This was broken in OpenSSH 7.6 during the removal of SSHv1
                    538:           support. bz#2810
                    539:       <li>ssh(1): Warn when the agent returns a ssh-rsa (SHA1) signature when
                    540:           a rsa-sha2-256/512 signature was requested. This condition is possible
                    541:           when an old or non-OpenSSH agent is in use. bz#2799
                    542:       <li>ssh-agent(1): Fix regression introduce in 7.6 that caused ssh-agent
                    543:           to fatally exit if presented an invalid signature request message.
                    544:       <li>sshd_config(5): Accept yes/no flag options case-insensitively, as
                    545:           has been the case in ssh_config(5) for a long time. bz#2664
                    546:       <li>ssh(1): Improve error reporting for failures during connection.
                    547:           Under some circumstances misleading errors were being shows. bz#2814
                    548:       <li>ssh-keyscan(1): Add -D option to allow printing of results directly
                    549:           in SSHFP format. bz#2821
                    550:       <li>regress tests: fix PuTTY interop test broken in last release's SSHv1
                    551:           removal. bz#2823
                    552:       <li>ssh(1): Compatibility fix for some servers that erroneously drop the
                    553:           connection when the IUTF8 (RFC8160) option is sent.
                    554:       <li>scp(1): Disable RemoteCommand and RequestTTY in the ssh session
                    555:           started by scp (sftp was already doing this.)
                    556:       <li>ssh-keygen(1): Refuse to create a certificate with an unusable
                    557:           number of principals.
                    558:       <li>ssh-keygen(1): Fatally exit if ssh-keygen is unable to write all the
                    559:           public key during key generation. Previously it would silently
                    560:           ignore errors writing the comment and terminating newline.
                    561:       <li>ssh(1): Do not modify hostname arguments that are addresses by
                    562:           automatically forcing them to lower-case. Instead canonicalise them
                    563:           to resolve ambiguities (e.g. ::0001 => ::1) before they are matched
                    564:           against known_hosts. bz#2763
                    565:       <li>ssh(1): Don't accept junk after "yes" or "no" responses to hostkey
                    566:           prompts. bz#2803
                    567:       <li>sftp(1): Have sftp print a warning about shell cleanliness when
                    568:           decoding the first packet fails, which is usually caused by shells
                    569:           polluting stdout of non-interactive startups. bz#2800
                    570:       <li>ssh(1)/sshd(8): Switch timers in packet code from using wall-clock
                    571:           time to monotonic time, allowing the packet layer to better function
                    572:           over a clock step and avoiding possible integer overflows during
                    573:           steps.
                    574:       <li>Numerous manual page fixes and improvements.
1.1       deraadt   575:       </ul>
                    576:     </ul>
                    577:
1.22      jsg       578: <li>LibreSSL 2.7.2
1.29      beck      579:    <ul>
                    580:    <li> Added support for many OpenSSL 1.0.2 and 1.1 APIs, based on
                    581:    observations of real-world usage in applications. These are
                    582:    implemented in parallel with existing OpenSSL 1.0.1 APIs - visibility
                    583:    changes have not been made to existing structs, allowing code written
                    584:    for older OpenSSL APIs to continue working.
                    585:    <li> Extensive corrections, improvements, and additions to the
                    586:    API documentation, including new public APIs from OpenSSL that had
                    587:    no pre-existing documentation.
                    588:    <li> Added support for automatic library initialization in libcrypto,
                    589:    libssl, and libtls. Support for pthread_once or a compatible
                    590:    equivalent is now required of the target operating system. As a
                    591:    side-effect, minimum Windows support is Vista or higher.
                    592:    <li> Converted more packet handling methods to CBB, which improves
                    593:    resiliency when generating TLS messages.
                    594:    <li> Completed TLS extension handling rewrite, improving consistency of
                    595:    checks for malformed and duplicate extensions.
                    596:    <li>Rewrote ASN1_TYPE_{get,set}_octetstring() using templated ASN.1.
                    597:    This removes the last remaining use of the old M_ASN1_* macros
                    598:    (asn1_mac.h) from API that needs to continue to exist.
                    599:    <li> Added support for client-side session resumption in libtls.
                    600:    A libtls client can specify a session file descriptor (a regular
                    601:    file with appropriate ownership and permissions) and libtls will
                    602:    manage reading and writing of session data across TLS handshakes.
                    603:    <li> Improved support for strict alignment on ARMv7 architectures,
                    604:    conditionally enabling assembly in those cases.
                    605:    <li> Fixed a memory leak in libtls when reusing a tls_config.
                    606:    <li> Merged more DTLS support into the regular TLS code path, removing
                    607:    duplicated code.
                    608:    </ul>
1.37      deraadt   609:
1.81    ! bentley   610: <li><p>Ports and packages:
1.56      espie     611:     <ul>
1.58      espie     612:       <li><a href="https://man.openbsd.org/dpb.1">dpb(1)</a> and normal
1.56      espie     613:          <a href="https://man.openbsd.org/ports.7">ports(7)</a> can
                    614:          now enjoy the same privilege separated model by setting
1.81    ! bentley   615:          <code>PORTS_PRIVSEP=Yes</code>
1.56      espie     616:     </ul>
1.81    ! bentley   617:
        !           618:     <p>Many pre-built packages for each architecture:
1.1       deraadt   619:     <!-- number of FTP packages minus SHA256, SHA256.sig, index.txt -->
1.81    ! bentley   620:     <ul style="column-count: 4">
1.64      phessler  621:       <li>aarch64:    7990
1.67      deraadt   622:       <li>alpha:         1
1.62      deraadt   623:       <li>amd64:      9912
1.73      sthen     624:       <li>arm:        6582
1.63      sthen     625:       <li>i386:       9861
1.77      naddy     626:       <li>mips64:     8149
1.76      naddy     627:       <li>mips64el:   8254
1.75      landry    628:       <li>powerpc:    8809
1.77      naddy     629:       <li>sh:            1
1.74      landry    630:       <li>sparc64:    8401
1.81    ! bentley   631:     </ul>
1.1       deraadt   632:
1.81    ! bentley   633:     <p>Some highlights:
        !           634:     <ul style="column-count: 2">
1.3       lteo      635:        <li>AFL 2.52b
                    636:        <li>CMake 3.10.2
1.14      kn        637:        <li>Chromium 65.0.3325.181
1.1       deraadt   638:        <li>Emacs 21.4 and 25.3
                    639:        <li>GCC 4.9.4
1.3       lteo      640:        <li>GHC 8.2.2
1.1       deraadt   641:        <li>Gimp 2.8.22
1.3       lteo      642:        <li>GNOME 3.26.2
                    643:        <li>Go 1.10
1.1       deraadt   644:        <li>Groff 1.22.3
                    645:        <li>JDK 8u144
                    646:        <li>KDE 3.5.10 and 4.14.3 (plus KDE4 core updates)
1.3       lteo      647:        <li>LLVM/Clang 5.0.1
                    648:        <li>LibreOffice 6.0.2.1
                    649:        <li>Lua 5.1.5, 5.2.4 and 5.3.4
                    650:        <li>MariaDB 10.0.34
1.40      landry    651:        <li>Mozilla Firefox 52.7.3esr and 59.0.2
                    652:        <li>Mozilla Thunderbird 52.7.0
1.3       lteo      653:        <li>Mutt 1.9.4 and NeoMutt 20180223
                    654:        <li>Node.js 8.9.4
1.1       deraadt   655:        <li>Ocaml 4.03.0
                    656:        <li>OpenLDAP 2.3.43 and 2.4.45
1.3       lteo      657:        <li>PHP 5.6.34 and 7.0.28
                    658:        <li>Postfix 3.3.0 and 3.4-20180203
                    659:        <li>PostgreSQL 10.3
                    660:        <li>Python 2.7.14 and 3.6.4
1.7       lteo      661:        <li>R 3.4.4
1.3       lteo      662:        <li>Ruby 2.3.6, 2.4.3 and 2.5.0
                    663:        <li>Rust 1.24.0
1.1       deraadt   664:        <li>Sendmail 8.16.0.21
1.14      kn        665:        <li>SQLite3 3.22.0
1.3       lteo      666:        <li>Sudo 1.8.22
                    667:        <li>Tcl/Tk 8.5.19 and 8.6.8
                    668:        <li>TeX Live 2017
                    669:        <li>Vim 8.0.1589
1.1       deraadt   670:        <li>Xfce 4.12
1.81    ! bentley   671:     </ul>
1.1       deraadt   672:
                    673: <li>As usual, steady improvements in manual pages and other documentation.
                    674:
                    675: <li>The system includes the following major components from outside suppliers:
                    676:     <ul>
1.4       matthieu  677:     <li>Xenocara (based on X.Org 7.7 with xserver 1.19.6 + patches,
                    678:       freetype 2.8.1, fontconfig 2.12.4, Mesa 13.0.6, xterm 330,
1.1       deraadt   679:       xkeyboard-config 2.20 and more)
1.4       matthieu  680:     <li>LLVM/Clang 5.0.1 (+ patches)
1.1       deraadt   681:     <li>GCC 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.4       matthieu  682:     <li>Perl 5.24.3 (+ patches)
                    683:     <li>NSD 4.1.20
                    684:     <li>Unbound 1.6.8
1.1       deraadt   685:     <li>Ncurses 5.7
                    686:     <li>Binutils 2.17 (+ patches)
                    687:     <li>Gdb 6.3 (+ patches)
                    688:     <li>Awk Aug 10, 2011 version
1.4       matthieu  689:     <li>Expat 2.2.5
1.1       deraadt   690:     </ul>
                    691: </ul>
1.81    ! bentley   692: </section>
1.1       deraadt   693:
                    694: <hr>
                    695:
1.81    ! bentley   696: <section id=install>
        !           697: <h3>How to install</h3>
1.1       deraadt   698:
                    699: Please refer to the following files on the mirror site for
                    700: extensive details on how to install OpenBSD 6.3 on your machine:
                    701:
                    702: <ul>
                    703: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/alpha/INSTALL.alpha">
                    704:        .../OpenBSD/6.3/alpha/INSTALL.alpha</a>
                    705: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/amd64/INSTALL.amd64">
                    706:        .../OpenBSD/6.3/amd64/INSTALL.amd64</a>
                    707: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/arm64/INSTALL.arm64">
                    708:        .../OpenBSD/6.3/arm64/INSTALL.arm64</a>
                    709: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/armv7/INSTALL.armv7">
                    710:        .../OpenBSD/6.3/armv7/INSTALL.armv7</a>
                    711: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/hppa/INSTALL.hppa">
                    712:        .../OpenBSD/6.3/hppa/INSTALL.hppa</a>
                    713: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/i386/INSTALL.i386">
                    714:        .../OpenBSD/6.3/i386/INSTALL.i386</a>
                    715: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/landisk/INSTALL.landisk">
                    716:        .../OpenBSD/6.3/landisk/INSTALL.landisk</a>
                    717: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/loongson/INSTALL.loongson">
                    718:        .../OpenBSD/6.3/loongson/INSTALL.loongson</a>
                    719: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/luna88k/INSTALL.luna88k">
                    720:        .../OpenBSD/6.3/luna88k/INSTALL.luna88k</a>
                    721: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/macppc/INSTALL.macppc">
                    722:        .../OpenBSD/6.3/macppc/INSTALL.macppc</a>
                    723: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/octeon/INSTALL.octeon">
                    724:        .../OpenBSD/6.3/octeon/INSTALL.octeon</a>
                    725: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/sgi/INSTALL.sgi">
                    726:        .../OpenBSD/6.3/sgi/INSTALL.sgi</a>
                    727: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/6.3/sparc64/INSTALL.sparc64">
                    728:        .../OpenBSD/6.3/sparc64/INSTALL.sparc64</a>
                    729: </ul>
                    730:
                    731: <hr>
                    732:
1.81    ! bentley   733: <section id=quickinstall>
1.1       deraadt   734: <p>
                    735: Quick installer information for people familiar with OpenBSD, and the use of
                    736: the "<a href="https://man.openbsd.org/disklabel.8">disklabel</a> -E" command.
                    737: If you are at all confused when installing OpenBSD, read the relevant
                    738: INSTALL.* file as listed above!
                    739:
1.81    ! bentley   740: <h3>OpenBSD/alpha:</h3>
1.1       deraadt   741:
1.81    ! bentley   742: <p>
1.1       deraadt   743: Write <i>floppy63.fs</i> or <i>floppyB63.fs</i> (depending on your machine)
                    744: to a diskette and enter <i>boot dva0</i>.
                    745: Refer to INSTALL.alpha for more details.
1.81    ! bentley   746:
1.1       deraadt   747: <p>
                    748: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    749: will most likely fail.
                    750:
1.81    ! bentley   751: <h3>OpenBSD/amd64:</h3>
1.1       deraadt   752:
1.81    ! bentley   753: <p>
1.1       deraadt   754: If your machine can boot from CD, you can write <i>install63.iso</i> or
                    755: <i>cd63.iso</i> to a CD and boot from it.
                    756: You may need to adjust your BIOS options first.
1.81    ! bentley   757:
1.1       deraadt   758: <p>
                    759: If your machine can boot from USB, you can write <i>install63.fs</i> or
                    760: <i>miniroot63.fs</i> to a USB stick and boot from it.
1.81    ! bentley   761:
1.1       deraadt   762: <p>
                    763: If you can't boot from a CD, floppy disk, or USB,
                    764: you can install across the network using PXE as described in the included
                    765: INSTALL.amd64 document.
1.81    ! bentley   766:
1.1       deraadt   767: <p>
                    768: If you are planning to dual boot OpenBSD with another OS, you will need to
                    769: read INSTALL.amd64.
                    770:
1.81    ! bentley   771: <h3>OpenBSD/arm64:</h3>
1.1       deraadt   772:
1.81    ! bentley   773: <p>
1.1       deraadt   774: Write <i>miniroot63.fs</i> to a disk and boot from it after connecting
                    775: to the serial console.  Refer to INSTALL.arm64 for more details.
                    776:
1.81    ! bentley   777: <h3>OpenBSD/armv7:</h3>
1.1       deraadt   778:
1.81    ! bentley   779: <p>
1.1       deraadt   780: Write a system specific miniroot to an SD card and boot from it after connecting
                    781: to the serial console.  Refer to INSTALL.armv7 for more details.
                    782:
1.81    ! bentley   783: <h3>OpenBSD/hppa:</h3>
1.1       deraadt   784:
1.81    ! bentley   785: <p>
1.1       deraadt   786: Boot over the network by following the instructions in INSTALL.hppa or the
                    787: <a href="hppa.html#install">hppa platform page</a>.
                    788:
1.81    ! bentley   789: <h3>OpenBSD/i386:</h3>
1.1       deraadt   790:
1.81    ! bentley   791: <p>
1.1       deraadt   792: If your machine can boot from CD, you can write <i>install63.iso</i> or
                    793: <i>cd63.iso</i> to a CD and boot from it.
                    794: You may need to adjust your BIOS options first.
1.81    ! bentley   795:
1.1       deraadt   796: <p>
                    797: If your machine can boot from USB, you can write <i>install63.fs</i> or
                    798: <i>miniroot63.fs</i> to a USB stick and boot from it.
1.81    ! bentley   799:
1.1       deraadt   800: <p>
                    801: If you can't boot from a CD, floppy disk, or USB,
                    802: you can install across the network using PXE as described in
                    803: the included INSTALL.i386 document.
1.81    ! bentley   804:
1.1       deraadt   805: <p>
                    806: If you are planning on dual booting OpenBSD with another OS, you will need to
                    807: read INSTALL.i386.
                    808:
1.81    ! bentley   809: <h3>OpenBSD/landisk:</h3>
1.1       deraadt   810:
1.81    ! bentley   811: <p>
1.1       deraadt   812: Write <i>miniroot63.fs</i> to the start of the CF
                    813: or disk, and boot normally.
                    814:
1.81    ! bentley   815: <h3>OpenBSD/loongson:</h3>
1.1       deraadt   816:
1.81    ! bentley   817: <p>
1.1       deraadt   818: Write <i>miniroot63.fs</i> to a USB stick and boot bsd.rd from it
                    819: or boot bsd.rd via tftp.
                    820: Refer to the instructions in INSTALL.loongson for more details.
                    821:
1.81    ! bentley   822: <h3>OpenBSD/luna88k:</h3>
1.1       deraadt   823:
1.81    ! bentley   824: <p>
        !           825: Copy 'boot' and 'bsd.rd' to a Mach or UniOS partition, and boot the bootloader
1.1       deraadt   826: from the PROM, and then bsd.rd from the bootloader.
                    827: Refer to the instructions in INSTALL.luna88k for more details.
                    828:
1.81    ! bentley   829: <h3>OpenBSD/macppc:</h3>
1.1       deraadt   830:
1.81    ! bentley   831: <p>
1.1       deraadt   832: Burn the image from a mirror site to a CDROM, and power on your machine
                    833: while holding down the <i>C</i> key until the display turns on and
                    834: shows <i>OpenBSD/macppc boot</i>.
1.81    ! bentley   835:
1.1       deraadt   836: <p>
                    837: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
                    838: /6.3/macppc/bsd.rd</i>
                    839:
1.81    ! bentley   840: <h3>OpenBSD/octeon:</h3>
1.1       deraadt   841:
1.81    ! bentley   842: <p>
1.1       deraadt   843: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
                    844: Refer to the instructions in INSTALL.octeon for more details.
                    845:
1.81    ! bentley   846: <h3>OpenBSD/sgi:</h3>
1.1       deraadt   847:
1.81    ! bentley   848: <p>
1.1       deraadt   849: To install, burn cd63.iso on a CD-R, put it in the CD drive of your
                    850: machine and select <i>Install System Software</i> from the System Maintenance
                    851: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
                    852: CD-ROM, and need a proper invocation from the PROM prompt.
                    853: Refer to the instructions in INSTALL.sgi for more details.
                    854:
                    855: <p>
                    856: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
                    857: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
                    858: system type. Refer to the instructions in INSTALL.sgi for more details.
                    859:
1.81    ! bentley   860: <h3>OpenBSD/sparc64:</h3>
1.1       deraadt   861:
1.81    ! bentley   862: <p>
1.1       deraadt   863: Burn the image from a mirror site to a CDROM, boot from it, and type
                    864: <i>boot cdrom</i>.
1.81    ! bentley   865:
1.1       deraadt   866: <p>
                    867: If this doesn't work, or if you don't have a CDROM drive, you can write
                    868: <i>floppy63.fs</i> or <i>floppyB63.fs</i>
                    869: (depending on your machine) to a floppy and boot it with <i>boot
                    870: floppy</i>. Refer to INSTALL.sparc64 for details.
1.81    ! bentley   871:
1.1       deraadt   872: <p>
                    873: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    874: will most likely fail.
1.81    ! bentley   875:
1.1       deraadt   876: <p>
                    877: You can also write <i>miniroot63.fs</i> to the swap partition on
                    878: the disk and boot with <i>boot disk:b</i>.
1.81    ! bentley   879:
1.1       deraadt   880: <p>
                    881: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.81    ! bentley   882:
        !           883: </section>
1.1       deraadt   884:
                    885: <hr>
                    886:
1.81    ! bentley   887: <section id=upgrade>
        !           888: <h3>How to upgrade</h3>
1.1       deraadt   889:
1.5       matthieu  890: If you already have an OpenBSD 6.2 system, and do not want to reinstall,
1.1       deraadt   891: upgrade instructions and advice can be found in the
                    892: <a href="faq/upgrade63.html">Upgrade Guide</a>.
1.81    ! bentley   893: </section>
1.1       deraadt   894:
                    895: <hr>
                    896:
1.81    ! bentley   897: <section id=sourcecode>
        !           898: <h3>Notes about the source code</h3>
1.1       deraadt   899:
1.81    ! bentley   900: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
1.1       deraadt   901: This file contains everything you need except for the kernel sources,
                    902: which are in a separate archive.
                    903: To extract:
                    904:
                    905: <blockquote><pre>
                    906: # <b>mkdir -p /usr/src</b>
                    907: # <b>cd /usr/src</b>
                    908: # <b>tar xvfz /tmp/src.tar.gz</b>
                    909: </pre></blockquote>
                    910:
1.81    ! bentley   911: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
1.1       deraadt   912: This file contains all the kernel sources you need to rebuild kernels.
                    913: To extract:
                    914:
                    915: <blockquote><pre>
                    916: # <b>mkdir -p /usr/src/sys</b>
                    917: # <b>cd /usr/src</b>
                    918: # <b>tar xvfz /tmp/sys.tar.gz</b>
                    919: </pre></blockquote>
                    920:
                    921: Both of these trees are a regular CVS checkout.  Using these trees it
                    922: is possible to get a head-start on using the anoncvs servers as
                    923: described <a href="anoncvs.html">here</a>.
                    924: Using these files
                    925: results in a much faster initial CVS update than you could expect from
                    926: a fresh checkout of the full OpenBSD source tree.
1.81    ! bentley   927: </section>
        !           928: </section>
1.1       deraadt   929:
                    930: <hr>
                    931:
1.81    ! bentley   932: <section id=ports>
        !           933: <h3>Ports Tree</h3>
1.1       deraadt   934:
                    935: A ports tree archive is also provided.  To extract:
                    936:
                    937: <blockquote><pre>
                    938: # <b>cd /usr</b>
                    939: # <b>tar xvfz /tmp/ports.tar.gz</b>
                    940: </pre></blockquote>
                    941:
                    942: Go read the <a href="faq/ports/index.html">ports</a> page
                    943: if you know nothing about ports
                    944: at this point.  This text is not a manual of how to use ports.
                    945: Rather, it is a set of notes meant to kickstart the user on the
                    946: OpenBSD ports system.
                    947: <p>
                    948: The <i>ports/</i> directory represents a CVS checkout of our ports.
                    949: As with our complete source tree, our ports tree is available via
                    950: <a href="anoncvs.html">AnonCVS</a>.
                    951: So, in order to keep up to date with the -stable branch, you must make
                    952: the <i>ports/</i> tree available on a read-write medium and update the tree
                    953: with a command like:
                    954:
                    955: <blockquote><pre>
                    956: # <b>cd /usr/ports</b>
                    957: # <b>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_6_3</b>
                    958: </pre></blockquote>
                    959:
                    960: [Of course, you must replace the server name here with a nearby anoncvs
                    961: server.]
                    962: <p>
                    963: Note that most ports are available as packages on our mirrors. Updated
                    964: ports for the 6.3 release will be made available if problems arise.
                    965: <p>
                    966: If you're interested in seeing a port added, would like to help out, or just
                    967: would like to know more, the mailing list
                    968: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.81    ! bentley   969: </section>