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

Annotation of www/63.html, Revision 1.86

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