Annotation of www/63.html, Revision 1.85
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
59: files fetched via ports.tar.gz.
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>