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