Annotation of www/42.html, Revision 1.96
1.87 bentley 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
1.71 deraadt 5: <title>OpenBSD 4.2</title>
1.1 jasper 6: <meta name="description" content="OpenBSD 4.2">
1.81 tj 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.83 tb 9: <link rel="canonical" href="https://www.openbsd.org/42.html">
1.1 jasper 10:
1.87 bentley 11: <h2 id=OpenBSD>
1.1 jasper 12: <a href="index.html">
1.87 bentley 13: <i>Open</i><b>BSD</b></a>
14: 4.2
1.81 tj 15: </h2>
1.1 jasper 16:
1.87 bentley 17: <table>
18: <tr>
19: <td>
1.55 deraadt 20: <a href="images/Marathon.jpg">
1.96 ! deraadt 21: <img width="227" height="343" src="images/Marathon.jpg" alt="Marathon"></a>
1.87 bentley 22: <td>
1.67 deraadt 23: Released Nov 1, 2007<br>
1.1 jasper 24: Copyright 1997-2007, Theo de Raadt.<br>
1.87 bentley 25: <cite class=isbn>ISBN 978-0-9784475-0-2</cite>
1.1 jasper 26: <br>
1.78 deraadt 27: 4.2 Song: <a href="lyrics.html#42">"100001 1010101"</a>
1.86 deraadt 28: <br>
29: <br>
1.1 jasper 30: <ul>
1.93 deraadt 31: <li>See the information on <a href="ftp.html">the FTP page</a> for
1.1 jasper 32: a list of mirror machines.
1.87 bentley 33: <li>Go to the <code class=reldir>pub/OpenBSD/4.2/</code> directory on
1.1 jasper 34: one of the mirror sites.
1.20 deraadt 35: <li>Have a look at <a href="errata42.html">The 4.2 Errata page</a> for a list
1.1 jasper 36: of bugs and workarounds.
1.20 deraadt 37: <li>See a <a href="plus42.html">detailed log of changes</a> between the
1.1 jasper 38: 4.1 and 4.2 releases.
39: </ul>
1.81 tj 40: <p>
41: All applicable copyrights and credits are in the src.tar.gz,
42: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
1.92 deraadt 43: files fetched via <code>ports.tar.gz</code>.
1.87 bentley 44: </table>
1.81 tj 45:
46: <hr>
1.1 jasper 47:
1.87 bentley 48: <section id=new>
49: <h3>What's New</h3>
1.1 jasper 50: <p>
51: This is a partial list of new features and systems included in OpenBSD 4.2.
1.20 deraadt 52: For a comprehensive list, see the <a href="plus42.html">changelog</a> leading
1.1 jasper 53: to 4.2.
54: <p>
55:
56: <ul>
57:
58: <li>New/extended platforms:
59: <ul>
1.15 kettenis 60: <li><a href="sparc64.html">OpenBSD/sparc64</a>.<br>
61: The PCIe UltraSPARC IIIi machines like the V215 and V245 are now
62: supported.
1.18 kettenis 63: <li><a href="hppa.html">OpenBSD/hppa</a>.<br>
1.15 kettenis 64: Four-digit B/C/J-class workstations like the B2000, C3750 or J6750
65: are now supported (in 32-bit mode).
1.41 matthieu 66: <li><a href="alpha.html">OpenBSD/alpha</a>.<br>
67: Add support in the alpha platform for a couple of new Alpha
68: models, AlphaServer 1200 and 4100.
1.1 jasper 69: </ul>
70: <p>
71:
1.34 deraadt 72: <li>Platforms skipped this release:
1.1 jasper 73: <ul>
1.34 deraadt 74: <li><a href="sgi.html">OpenBSD/sgi</a>.<br>
1.35 jasper 75: Due to various issues, this architecture will not be released
1.34 deraadt 76: this time.
1.1 jasper 77: </ul>
78: <p>
79:
80: <li>Improved hardware support, including:
81: <ul>
1.11 matthieu 82: <li> Native Serial-ATA support:
83: <ul>
1.87 bentley 84: <li><a href="https://man.openbsd.org/ahci.4">ahci(4)</a>
1.24 dlg 85: driver for SATA controllers conforming to the Advanced Host Controller
86: Interface specification.
1.87 bentley 87: <li><a href=https://man.openbsd.org/jmb.4>jmb(4)</a> driver for the JMicron JMB36x SATA II and PATA Host Controller.
88: <li><a href="https://man.openbsd.org/sili.4">sili(4)</a>
1.24 dlg 89: driver for SATA controllers using the Silicon Image 3124/3132/3531 SATALink
90: chipsets.
1.11 matthieu 91: </ul>
1.87 bentley 92: <li>The <a href="https://man.openbsd.org/pciide.4">pciide(4)</a> driver has had support added for newer chipsets, including:
1.39 matthieu 93: <ul>
94: <li>Intel ICH8M PATA
95: <li>JMicron JMB36x PATA
96: <li>VIA CX700/VX700 PATA
97: </ul>
1.87 bentley 98: <li>The <a href="https://man.openbsd.org/lm.4">lm(4)</a>
1.43 cnst 99: driver now supports Winbond W83627DHG and W83627EHF-A Super I/O Hardware Monitors.
1.22 kettenis 100: <li> The <a
1.87 bentley 101: href="https://man.openbsd.org/siop.4">siop(4)</a>
1.22 kettenis 102: driver now has support for NCR 53C720/770 controllers in big endian mode.
103: In particular this means that the onboard Fast-Wide SCSI on many hppa
104: machines is supported now.
1.87 bentley 105: <li> New <a href="https://man.openbsd.org/tht.4">tht(4)</a>
1.39 matthieu 106: driver for Tehuti Networks 10Gb Ethernet controllers.
1.25 jsg 107: <li> The <a
1.87 bentley 108: href="https://man.openbsd.org/malo.4">malo(4)</a>
1.25 jsg 109: driver now supports Marvell 88W8385 802.11g based Compact Flash devices.
1.39 matthieu 110: <li> New <a
1.87 bentley 111: href="https://man.openbsd.org/uts.4">uts(4)</a>
1.39 matthieu 112: driver for USB touch screens, and the <a
1.87 bentley 113: href="https://man.openbsd.org/xtsscale.=1">xtsscale(1)</a>
1.39 matthieu 114: calibration utility.
1.41 matthieu 115: <li> The <a
1.87 bentley 116: href="https://man.openbsd.org/i810.4">i810(4)</a>
1.41 matthieu 117: X.Org driver and the PCI AGP driver now support Intel i965GM chips.
1.27 jasper 118: <li> New <a
1.87 bentley 119: href="https://man.openbsd.org/sparc64/led.4">led(4)</a>
1.27 jasper 120: driver for the front panel LEDs on the V215/245.
121: <li> New <a
1.87 bentley 122: href="https://man.openbsd.org/sparc64/bbc.4">bbc(4)</a>
1.27 jasper 123: driver providing support for the BootBus Controllers in UltraSparc III systems.
124: <li> New <a
1.87 bentley 125: href="https://man.openbsd.org/sparc64/pmc.4">pmc(4)</a>
1.27 jasper 126: driver for the
1.87 bentley 127: <a href="https://man.openbsd.org/watchdog.4">
1.27 jasper 128: watchdog(4)</a> timer on the National Semiconductor PC87317 SuperIO chip.
1.87 bentley 129: <li>New <a href=https://man.openbsd.org/sparc64/pyro.4>pyro(4)</a> driver for the SPARC64 Host/PCIe bridge.
130: <li>New <a href=https://man.openbsd.org/hppa/astro.4>astro(4)</a> driver for the Astro Memory and I/O controller on hppa.
131: <li>New <a href=https://man.openbsd.org/hppa/elroy.4>elroy(4)</a> driver for the Elroy PCI hostbridge on hppa.
132: <li>New <a href=https://man.openbsd.org/hppa/lcd.4>lcd(4)</a> driver for the front panel LCD display on hppa.
133: <li>New <a href=https://man.openbsd.org/hppa/ssio.4>ssio(4)</a> driver for the National Semiconductor PC87560 Legacy IO on hppa.
134: <li>New <a href=https://man.openbsd.org/zaurus/pxammc.4>pxammc(4)</a> driver for the MMC/SD/SDIO controller on zaurus.
135: <li>New <a href=https://man.openbsd.org/macppc/xlights.4>xlights(4)</a> driver for the front panel lights on the Xserve G4.
136: <li>New <a href=https://man.openbsd.org/macppc/sysbutton.4>sysbutton(4)</a> driver for the system identification button on the Xserve G4.
137: <li>New <a href=https://man.openbsd.org/i386/piixpcib.4>piixpcib(4)</a> driver for System Management Mode initiated speedstep frequency scaling on certain pairings of the Intel PIIX4 ISA bridges and Intel Pentium 3 processors.
1.33 gwk 138: <li>CPU frequency and voltage can now be scaled on all CPUs when running GENERIC.MP on a multiprocessor i386 or AMD64 machine with enhanced speedstep or powernow.
139: <li>Intel enhanced speedstep is now supported on OpenBSD/amd64.
1.39 matthieu 140: <li>New support for the on die CPU temperature sensor found on the Intel Core family of processors.
1.87 bentley 141: <li>The <a href=https://man.openbsd.org/amd64/nvram.4>nvram(4)</a> driver is now available on OpenBSD/amd64.
1.1 jasper 142: </ul>
143: <p>
1.8 matthieu 144:
1.1 jasper 145:
146: <li>New tools:
147: <ul>
1.10 matthieu 148: <li> <a
1.87 bentley 149: href="https://man.openbsd.org/cwm.1">cwm(1)</a>
1.10 matthieu 150: has replaced wm2 as a simple-looking low-resource window manager.
1.26 jsg 151: <li> <a
1.87 bentley 152: href="https://man.openbsd.org/zless.1">zless(1)</a>,
1.26 jsg 153: view compressed files with
1.87 bentley 154: <a href="https://man.openbsd.org/less.1">less(1)</a>.
155: <li><a href=https://man.openbsd.org/mount_vnd.8>mount_vnd(8)</a>, a utility to configure vnode disks from <a href=https://man.openbsd.org/fstab.5>fstab(5)</a>.
1.1 jasper 156: </ul>
157: <p>
1.10 matthieu 158:
1.1 jasper 159:
160: <li>New functionality:
161: <ul>
1.14 otto 162: <li>FFS2, the updated version of the fast file system.
1.23 kili 163: <li><a
1.87 bentley 164: href="https://man.openbsd.org/ftp.1">ftp(1)</a>
1.23 kili 165: now can send cookies loaded from a netscape-like cookiejar, supports
166: proxies requiring a password, and has a keep-alive option to avoid
1.59 ray 167: overly aggressive control connection dropping.
1.89 deraadt 168: <li><a href="https://man.openbsd.org/pkg_add.1">pkg_add(1)</a> has been vastly improved. It is more robust, outputs more
1.29 espie 169: consistent error messages, and can deal with a lot more update scenarios
170: gracefully. It also has much better look-up capabilities for multiple entries
1.89 deraadt 171: in <code>PKG_PATH</code>, stopping at the first directory with suitable
1.29 espie 172: candidates.
1.30 simon 173: <li><a
1.87 bentley 174: href="https://man.openbsd.org/ftp-proxy.8">ftp-proxy(8)</a>
1.30 simon 175: is now able to automatically tag packets passing through the <a
1.87 bentley 176: href="https://man.openbsd.org/pf.4">pf(4)</a> rule with a supplied name.
1.89 deraadt 177: <li>Kernel work queues,
1.87 bentley 178: <a href=https://man.openbsd.org/workq_add_task.9>workq_add_task(9)</a>,
179: <a href=https://man.openbsd.org/workq_create.9>workq_create(9)</a>,
180: <a href=https://man.openbsd.org/workq_destroy.9>workq_destroy(9)</a> provides a mechanism to defer tasks to a process context when it is impossible to run such a task in the current context.
181: <li><a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a>
1.37 henning 182: now understands IP address/mask in CIDR notation.
1.87 bentley 183: <li>Add IP (v4 and v6) load balancing to <a href="https://man.openbsd.org/carp.4">carp(4)</a>, similar to the ARP balancing.
184: <li><a href="https://man.openbsd.org/sensorsd.8">sensorsd(8)</a>
1.43 cnst 185: now supports a zero-configuration monitoring and has a more intuitive logging
186: for all sensors that automatically provide sensor state. It also features
187: advancements in user-specified monitoring, including monitoring of sensors
188: that are periodically flagged as invalid.
1.87 bentley 189: <li><a href="https://man.openbsd.org/sensorsd.conf.5">sensorsd.conf(5)</a>
1.43 cnst 190: now supports sensor matching by sensor type, allowing easier configuration.
1.46 kettenis 191: <li>The i386 bootloader can now load amd64 kernels.
192: <li>The amd64 bootloader can now load i386 kernels.
1.1 jasper 193: </ul>
194: <p>
195:
196: <li>Assorted improvements and code cleanup:
197: <ul>
1.56 cloder 198: <li>Huge performance improvements in the network stack, including:
199: <ul>
1.57 henning 200: <li>In pf, store routing table ID, queue ID etc directly in the packet header mbuf instead of using
201: mbuf tags (which use malloc'd memory). This yields a 100% improvement in pf performance.
1.56 cloder 202: <li>Packet forwarding can skip IPSEC stack if no IPSEC flows are defined. This
203: yields a further 5% improvement in packet forwarding performance.
1.57 henning 204: <li>Skip TCP/UDP/ICMP/ICMP6 checksumming when not necessary.
1.56 cloder 205: This yields a further 10% improvement in pf performance.
206: <li>A change in the way the kernel random pool is stirred greatly increases
207: performance with network interface cards that support interrupt mitigation, especially
208: on architectures where reading the clock is expensive (such as amd64).
1.87 bentley 209: <li>Enable interrupt holdoff on <a href="https://man.openbsd.org/sis.4">sis(4)</a>
1.56 cloder 210: chips that support it. Significant performance gain for slower CPU devices with sis(4), such as Soekris.
211: </ul>
1.29 espie 212: <li>Large (>1TB) disk and partition support in the disklabel and buffer cache
1.14 otto 213: code and in the userland utilities that manipulate disk blocks. Note
214: that some parts of the system are not 64-bit disk block clean yet, so partition
215: larger than 2TB cannot be used at the moment.
1.38 krw 216: <li>Large (>2^32-1 sectors) SCSI disk sizes now probed.
1.16 jasper 217: <li>Thread support for the Objective-C library (libobjc).
1.87 bentley 218: <li><a href="https://man.openbsd.org/carp.4">carp</a>
1.42 ray 219: route handling has been fixed, solving some problems the routing daemons were exhibiting.
1.38 krw 220: <li>i386 TLB handling improved to avoid possible corruption on Core2Duo processors.
1.65 chl 221: <li>Rework TLB shootdown code for i386 and amd64, gives fairly large speed
222: improvements.
1.38 krw 223: <li>i386 and amd64 use the BIOS disk geometry when creating default disklabels.
1.42 ray 224: <li>Default disk geometry changed from 64 heads/32 sectors to 255 heads/63 sectors.
225: <li>More usb devices with various quirks coaxed to work.
1.38 krw 226: <li>Archive/Wangtek cartridge tape drives (wt*) no longer supported.
1.87 bentley 227: <li><a href="https://man.openbsd.org/rcs.1">rcs</a> has improved GNU compatibility.
228: <li><a href="https://man.openbsd.org/make.1">make(1)</a> has improved stability of -j option.
229: <li><a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a> now allows key exchange with RSA signature authentication to work with Cisco IOS.
230: <li>Fixed <a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a> interop-issues with peers, that start rekeying on port 4500 for NAT-T (e.g. Cisco, Openswan)
1.49 deraadt 231: <li>The stability of <a href="alpha.html">OpenBSD/alpha</a> has been greatly improved.
232: <li>The stability of <a href="hppa.html">OpenBSD/hppa</a> has been greatly improved.
1.1 jasper 233: </ul>
234: <p>
235:
236: <li>Install/Upgrade process changes:
237: <ul>
1.38 krw 238: <li>Allow the specification of an NTP server during installation.
239: <li>Allow no fsck'ing of clean non-root partitions during upgrade.
240: <li>Check for INSTALL.<arch> to confirm sets are for the correct architecture.
241: <li>Create and format the MSDOS partition for macppc installs in a more flexible and reliable way.
1.1 jasper 242: </ul>
243: <p>
244:
245: <li>OpenBGPD 4.2:
246: <ul>
1.28 claudio 247: <li>Include support for Four-octet AS Number Space.
248: <li>Allow matching on communities using 0 in the AS part.
249: <li>Filtering on IPv6 prefixes is now possible.
250: <li>Various bugs in the encoding of multiprotocol updates were fixed.
251: <li>Allow the use of pkill -HUP bgpd to reload the config.
1.37 henning 252: <li>bgpctl can filter prefix output by community now
1.1 jasper 253: </ul>
254: <p>
255:
256: <li>OpenNTPD 4.2:
257: <ul>
1.47 kettenis 258: <li>Improved support for timedelta sensors.
1.1 jasper 259: </ul>
260: <p>
261:
262: <li>OpenOSPFD 4.2:
263: <ul>
1.28 claudio 264: <li>Added support for RFC 3137: OSPF Stub Router Advertisement
265: <li>It is possible to specify a carp demote group on interfaces and areas.
266: <li>Added support for mapping route labels to AS-external route tags and vice versa.
267: <li>Allow the use of pkill -HUP ospfd to reload the config.
1.1 jasper 268: </ul>
269: <p>
270:
1.45 pyr 271: <li>Hoststated 4.2:
272: <ul>
1.88 deraadt 273: <li>Added support for Layer 7 load balancing (or relay).
274: <li>Added support for reloading through hoststatectl or SIGHUP.
1.45 pyr 275: </ul>
276: <p>
277:
1.1 jasper 278: <li>OpenSSH 4.7:
279: <ul>
1.44 deraadt 280: <li>Prevent
1.87 bentley 281: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.44 deraadt 282: from using a trusted X11 cookie if creation of an
283: untrusted cookie fails; found and fixed by Jan Pechanec.
1.87 bentley 284: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.44 deraadt 285: in new installations defaults to SSH Protocol 2 only.
286: Existing installations are unchanged.
287: <li>The SSH channel window size has been increased, and both
1.87 bentley 288: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.44 deraadt 289: and
1.87 bentley 290: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.44 deraadt 291: now send window updates more aggressively.<br>
292: These improves performance on high-BDP (Bandwidth Delay Product) networks.
1.87 bentley 293: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.44 deraadt 294: and
1.87 bentley 295: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.44 deraadt 296: now preserve MAC contexts between packets, which
297: saves 2 hash calls per packet and results in 12-16% speedup for
298: arcfour256/hmac-md5.
299: <li>A new MAC algorithm has been added, UMAC-64 (RFC4418) which is
300: approximately 20% faster than HMAC-MD5.
301: <li>A -K flag was added to
1.87 bentley 302: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.44 deraadt 303: to set GSSAPIAuthentication=Yes.
304: <li>Failure to establish a
1.87 bentley 305: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.44 deraadt 306: TunnelForward is now treated as a
307: fatal error when the ExitOnForwardFailure option is set.
1.87 bentley 308: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.44 deraadt 309: returns a sensible exit status if the control master goes
310: away without passing the full exit status. (bz #1261)
1.1 jasper 311: </ul>
312: <p>
313:
1.44 deraadt 314: <li>Over 4,500 ports, minor robustness improvements in package tools.
315: <li>Many pre-built packages for each architecture:
1.87 bentley 316: <ul style="column-count: 3">
1.44 deraadt 317: <li>i386: 4360
318: <li>sparc64: 4205
319: <li>alpha: 3779
1.61 deraadt 320: <li>sh: 817
1.44 deraadt 321: <li>amd64: 4283
322: <li>powerpc: 4230
1.58 deraadt 323: <li>sparc: 3283
1.60 martin 324: <li>m68k: 1107
1.61 deraadt 325: <li>arm: 2131
1.44 deraadt 326: <li>hppa: 3215
1.61 deraadt 327: <li>vax: 108
1.87 bentley 328: </ul>
1.1 jasper 329: Some highlights:
330: <ul>
1.44 deraadt 331: <!-- XXX double check versions -->
1.4 jasper 332: <li>Gnome 2.18.
1.16 jasper 333: <li>GNUstep 1.14.
1.4 jasper 334: <li>KDE 3.5.7 and koffice 1.6.3.
1.7 steven 335: <li>Xfce 4.4.1.
1.35 jasper 336: <li>OpenMotif 2.3.0.
1.9 steven 337: <li>OpenOffice.org 2.2.1.
338: <li>Mozilla Firefox 2.0.0.6.
1.4 jasper 339: <li>PostgreSQL 8.2.4.
1.5 jasper 340: <li>GHC 6.6.1 (amd64 and i386 only)
1.1 jasper 341: </ul>
342: <p>
343:
344: <li>As usual, steady improvements in manual pages and other documentation.
345: <p>
346:
347: <li>The system includes the following major components from outside suppliers:
348: <ul>
1.19 matthieu 349: <li>Xenocara (based on X.Org 7.2 + patches, freetype 2.2.1, fontconfig
1.1 jasper 350: 2.4.2, expat 2.0.0, Mesa 6.5.2, xterm 225 and more)
351: <li>Gcc 2.95.3
1.87 bentley 352: (+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
1.1 jasper 353: and 3.3.5
1.87 bentley 354: (+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
1.1 jasper 355: <li>Perl 5.8.8 (+ patches)
356: <li>Our improved and secured version of Apache 1.3, with SSL/TLS and DSO support
357: <li>OpenSSL 0.9.7j (+ patches)
358: <li>Groff 1.15
359: <li>Sendmail 8.14.1, with libmilter
360: <li>Bind 9.3.4 (+ patches)
361: <li>Lynx 2.8.5rel.4 with HTTPS and IPv6 support (+ patches)
362: <li>Sudo 1.6.9p4
363: <li>Ncurses 5.2
364: <li>Latest KAME IPv6
365: <li>Heimdal 0.7.2 (+ patches)
366: <li>Arla 0.35.7
367: <li>Binutils 2.15 (+ patches)
368: <li>Gdb 6.3 (+ patches)
369: <!-- XXX double check versions -->
370: </ul>
371:
372: </ul>
1.87 bentley 373: </section>
1.1 jasper 374:
375: <hr>
1.87 bentley 376:
377: <section id=install>
378: <h3>How to install</h3>
1.1 jasper 379: <p>
380: Following this are the instructions which you would have on a piece of
381: paper if you had purchased a CDROM set instead of doing an alternate
382: form of install. The instructions for doing an FTP (or other style
383: of) install are very similar; the CDROM instructions are left intact
384: so that you can see how much easier it would have been if you had
385: purchased a CDROM instead.
386: <p>
387:
388: <hr>
389: Please refer to the following files on the three CDROMs or FTP mirror for
390: extensive details on how to install OpenBSD 4.2 on your machine:
391: <p>
392: <ul>
1.90 deraadt 393: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/i386/INSTALL.i386">
394: .../OpenBSD/4.2/i386/INSTALL.i386 (on CD1)</a>
1.1 jasper 395: <p>
1.90 deraadt 396: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/amd64/INSTALL.amd64">
397: .../OpenBSD/4.2/amd64/INSTALL.amd64 (on CD2)</a>
398: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/macppc/INSTALL.macppc">
399: .../OpenBSD/4.2/macppc/INSTALL.macppc (on CD2)</a>
400: <p>
401: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/sparc64/INSTALL.sparc64">
402: .../OpenBSD/4.2/sparc64/INSTALL.sparc64 (on CD3)</a>
403: <p>
404: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/alpha/INSTALL.alpha">
405: .../OpenBSD/4.2/alpha/INSTALL.alpha</a>
406: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/armish/INSTALL.armish">
407: .../OpenBSD/4.2/armish/INSTALL.armish</a>
408: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/hp300/INSTALL.hp300">
409: .../OpenBSD/4.2/hp300/INSTALL.hp300</a>
410: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/hppa/INSTALL.hppa">
411: .../OpenBSD/4.2/hppa/INSTALL.hppa</a>
412: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/landisk/INSTALL.landisk">
413: .../OpenBSD/4.2/landisk/INSTALL.landisk</a>
414: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/mac68k/INSTALL.mac68k">
415: .../OpenBSD/4.2/mac68k/INSTALL.mac68k</a>
416: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/mvme68k/INSTALL.mvme68k">
417: .../OpenBSD/4.2/mvme68k/INSTALL.mvme68k</a>
418: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/mvme88k/INSTALL.mvme88k">
419: .../OpenBSD/4.2/mvme88k/INSTALL.mvme88k</a>
420: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/sparc/INSTALL.sparc">
421: .../OpenBSD/4.2/sparc/INSTALL.sparc</a>
422: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/vax/INSTALL.vax">
423: .../OpenBSD/4.2/vax/INSTALL.vax</a>
424: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/4.2/zaurus/INSTALL.zaurus">
425: .../OpenBSD/4.2/zaurus/INSTALL.zaurus</a>
1.1 jasper 426: </ul>
1.90 deraadt 427: </section>
428:
1.1 jasper 429: <hr>
430:
1.87 bentley 431: <section id=quickinstall>
432:
1.1 jasper 433: <p>
434: Quick installer information for people familiar with OpenBSD, and the
435: use of the "disklabel -E" command. If you are at all confused when
436: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.87 bentley 437:
438: <h3>OpenBSD/i386:</h3>
439:
1.1 jasper 440: <p>
441: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
442: release is on CD1. If your BIOS does not support booting from CD, you will need
443: to create a boot floppy to install from. To create a boot floppy write
444: <i>CD1:4.2/i386/floppy42.fs</i> to a floppy and boot via the floppy drive.
445:
446: <p>
447: Use <i>CD1:4.2/i386/floppyB42.fs</i> instead for greater SCSI controller
448: support, or <i>CD1:4.2/i386/floppyC42.fs</i> for better laptop support.
449:
450: <p>
1.66 tom 451: NOTE: some older BIOSes appear to have problems booting CD1.
452: A workaround can be found on the
453: <a href="errata42.html#003_i386_boot">4.2 errata page</a>.
454:
455: <p>
1.1 jasper 456: If you can't boot from a CD or a floppy disk,
457: you can install across the network using PXE as described in
458: the included INSTALL.i386 document.
459:
460: <p>
461: If you are planning on dual booting OpenBSD with another OS, you will need to
462: read INSTALL.i386.
463:
464: <p>
465: To make a boot floppy under MS-DOS, use the "rawrite" utility located
466: at <i>CD1:4.2/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
467: use the
1.87 bentley 468: <a href="https://man.openbsd.org/dd.1">dd(1)</a>
1.1 jasper 469: utility. The following is an example usage of
1.87 bentley 470: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.1 jasper 471: where the device could be "floppy", "rfd0c", or
472: "rfd0a".
473:
1.87 bentley 474: <blockquote><pre>
1.90 deraadt 475: # <kbd>dd if=<file> of=/dev/<device> bs=32k</kbd>
1.87 bentley 476: </pre></blockquote>
1.1 jasper 477:
478: <p>
479: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
480: your install will most likely fail. For more information on creating a boot
481: floppy and installing OpenBSD/i386 please refer to
1.82 tj 482: <a href="faq/faq4.html#MkFlop">this page</a>.
1.87 bentley 483:
484:
485: <h3>OpenBSD/amd64:</h3>
1.1 jasper 486:
487: <p>
488: The 4.2 release of OpenBSD/amd64 is located on CD2.
489: Boot from the CD to begin the install - you may need to adjust
490: your BIOS options first.
491: If you can't boot from the CD, you can create a boot floppy to install from.
492: To do this, write <i>CD2:4.2/amd64/floppy42.fs</i> to a floppy, then
493: boot from the floppy drive.
494:
495: <p>
496: If you can't boot from a CD or a floppy disk,
497: you can install across the network using PXE as described in the included
498: INSTALL.amd64 document.
499:
500: <p>
501: If you are planning to dual boot OpenBSD with another OS, you will need to
502: read INSTALL.amd64.
1.87 bentley 503:
504: <h3>OpenBSD/macppc:</h3>
1.1 jasper 505:
506: <p>
507: Put CD2 in your CDROM drive and poweron your machine while holding down the
508: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
509:
510: <p>
511: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
512: /4.2/macppc/bsd.rd</i>
1.87 bentley 513:
514: <h3>OpenBSD/sparc64:</h3>
1.1 jasper 515:
516: <p>
517: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
518:
519: <p>
520: If this doesn't work, or if you don't have a CDROM drive, you can write
521: <i>CD3:4.2/sparc64/floppy42.fs</i> or <i>CD3:4.2/sparc64/floppyB42.fs</i>
522: (depending on your machine) to a floppy and boot it with <i>boot
523: floppy</i>. Refer to INSTALL.sparc64 for details.
524:
525: <p>
526: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
527: will most likely fail.
528:
529: <p>
530: You can also write <i>CD3:4.2/sparc64/miniroot42.fs</i> to the swap partition on
531: the disk and boot with <i>boot disk:b</i>.
532:
533: <p>
534: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.87 bentley 535:
536: <h3>OpenBSD/alpha:</h3>
1.1 jasper 537:
538: <p>
1.90 deraadt 539: Write <i>4.2/alpha/floppy42.fs</i> or
540: <i>4.2/alpha/floppyB42.fs</i> (depending on your machine) to a diskette and
1.1 jasper 541: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
542:
543: <p>
544: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
545: will most likely fail.
546:
1.87 bentley 547: <h3>OpenBSD/armish:</h3>
1.1 jasper 548:
549: <p>
550: After connecting a serial port, Thecus can boot directly from the network
551: either tftp or http. Configure the network using fconfig, reset,
552: then load bsd.rd, see INSTALL.armish for specific details.
553: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
554: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
555: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
556: More details are available in INSTALL.armish.
557:
1.87 bentley 558: <h3>OpenBSD/hp300:</h3>
559:
1.1 jasper 560: <p>
561: Boot over the network by following the instructions in INSTALL.hp300.
1.87 bentley 562:
563: <h3>OpenBSD/hppa:</h3>
1.1 jasper 564:
565: <p>
566: Boot over the network by following the instructions in INSTALL.hppa or the
567: <a href="hppa.html#install">hppa platform page</a>.
568:
1.87 bentley 569: <h3>OpenBSD/landisk:</h3>
570:
1.1 jasper 571: <p>
1.21 deraadt 572: Write <i>miniroot42.fs</i> to the start of the CF
1.1 jasper 573: or disk, and boot normally.
574:
1.68 miod 575: <!--
1.87 bentley 576: <h3>OpenBSD/luna88k:</h3>
577:
1.1 jasper 578: <p>
579: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
580: Alternatively, you can create a bootable tape and boot from it. Refer to
581: the instructions in INSTALL.luna88k for more details.
1.68 miod 582: -->
1.1 jasper 583:
1.87 bentley 584: <h3>OpenBSD/mac68k:</h3>
585:
1.1 jasper 586: <p>
587: Boot MacOS as normal and extract the Macside "BSD/Mac68k Booter" utility from
1.90 deraadt 588: <i>4.2/mac68k/utils</i> onto your hard disk. Configure the "BSD/Mac68k
1.1 jasper 589: Booter" with the location of your bsd.rd kernel and boot into the installer.
590: Refer to the instructions in INSTALL.mac68k for more details.
1.87 bentley 591:
592: <h3>OpenBSD/mvme68k:</h3>
1.1 jasper 593:
594: <p>
595: You can create a bootable installation tape or boot over the network.<br>
596: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
597: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
598: for more details.
599:
1.87 bentley 600: <h3>OpenBSD/mvme88k:</h3>
601:
1.1 jasper 602: <p>
603: You can create a bootable installation tape or boot over the network.<br>
604: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
605: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
606: for more details.
1.87 bentley 607:
608: <h3>OpenBSD/sparc:</h3>
1.1 jasper 609:
610: <p>
1.21 deraadt 611: Boot from one of the provided install ISO images, using one of the two
612: commands listed below, depending on the version of your ROM.
1.1 jasper 613:
1.87 bentley 614: <blockquote><pre>
615: ok <kbd>boot cdrom 4.2/sparc/bsd.rd</kbd>
1.1 jasper 616: or
1.87 bentley 617: > <kbd>b sd(0,6,0)4.2/sparc/bsd.rd</kbd>
618: </pre></blockquote>
1.1 jasper 619:
620: <p>
621: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
1.21 deraadt 622: To do so you need to write <i>floppy42.fs</i> to a floppy.
1.82 tj 623: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.1 jasper 624: To boot from the floppy use one of the two commands listed below,
625: depending on the version of your ROM.
626:
1.87 bentley 627: <blockquote><pre>
628: ok <kbd>boot floppy</kbd>
1.1 jasper 629: or
1.87 bentley 630: > <kbd>b fd()</kbd>
631: </pre></blockquote>
1.1 jasper 632:
633: <p>
634: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
635: will most likely fail.
636:
637: <p>
638: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
639: setup a bootable tape, or install via network, as told in the
640: INSTALL.sparc file.
1.87 bentley 641:
642: <h3>OpenBSD/vax:</h3>
1.1 jasper 643:
644: <p>
645: Boot over the network via mopbooting as described in INSTALL.vax.
1.87 bentley 646:
647: <h3>OpenBSD/zaurus:</h3>
1.1 jasper 648:
649: <p>
650: Using the Linux built-in graphical ipkg installer, install the
651: openbsd42_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
652: for a few important details.
1.90 deraadt 653: </section>
1.87 bentley 654:
1.90 deraadt 655: <hr>
1.87 bentley 656:
657: <section id=sourcecode>
1.90 deraadt 658: <h3>Notes about the source code</h3>
1.1 jasper 659: <p>
1.92 deraadt 660: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
661: This file contains everything you need except for the kernel sources, which are
1.1 jasper 662: in a separate archive. To extract:
1.87 bentley 663: <blockquote><pre>
664: # <kbd>mkdir -p /usr/src</kbd>
665: # <kbd>cd /usr/src</kbd>
666: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
667: </pre></blockquote>
1.1 jasper 668: <p>
1.92 deraadt 669: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
1.1 jasper 670: This file contains all the kernel sources you need to rebuild kernels.
671: To extract:
1.87 bentley 672: <blockquote><pre>
673: # <kbd>mkdir -p /usr/src/sys</kbd>
674: # <kbd>cd /usr/src</kbd>
1.90 deraadt 675: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
1.87 bentley 676: </pre></blockquote>
1.1 jasper 677: <p>
678: Both of these trees are a regular CVS checkout. Using these trees it
679: is possible to get a head-start on using the anoncvs servers as
680: described <a href="anoncvs.html">here</a>.
681: Using these files
682: results in a much faster initial CVS update than you could expect from
683: a fresh checkout of the full OpenBSD source tree.
1.87 bentley 684: </section>
685:
1.1 jasper 686: <hr>
1.87 bentley 687:
688: <section id=upgrade>
689: <h3>How to upgrade</h3>
1.1 jasper 690: <p>
691: If you already have an OpenBSD 4.1 system, and do not want to reinstall,
692: upgrade instructions and advice can be found in the
693: <a href="faq/upgrade42.html">Upgrade Guide</a>.
1.87 bentley 694: </section>
1.1 jasper 695:
696: <hr>
1.87 bentley 697:
698: <section id=ports>
699: <h3>Ports Tree</h3>
1.1 jasper 700: <p>
701: A ports tree archive is also provided. To extract:
1.87 bentley 702: <blockquote><pre>
703: # <kbd>cd /usr</kbd>
704: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
705: </pre></blockquote>
1.1 jasper 706: <p>
707: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
1.69 jasper 708: read the <a href="faq/faq15.html">ports</a> page
1.1 jasper 709: if you know nothing about ports
710: at this point. This text is not a manual of how to use ports.
711: Rather, it is a set of notes meant to kickstart the user on the
712: OpenBSD ports system.
713: <p>
714: The <i>ports/</i> directory represents a CVS (see the manpage for
1.91 bentley 715: <a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
1.1 jasper 716: you aren't familiar with CVS) checkout of our ports. As with our complete
717: source tree, our ports tree is available via anoncvs. So, in
718: order to keep current with it, you must make the <i>ports/</i> tree
719: available on a read-write medium and update the tree with a command
720: like:
1.87 bentley 721: <blockquote><pre>
1.90 deraadt 722: # <kbd>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_4_2</kbd>
1.87 bentley 723: </pre></blockquote>
1.1 jasper 724: <p>
725: [Of course, you must replace the local directory and server name here
726: with the location of your ports collection and a nearby anoncvs
727: server.]
728: <p>
1.90 deraadt 729: Note that most ports are available as packages on our mirrors. Updated
1.1 jasper 730: packages for the 4.2 release will be made available if problems arise.
731: <p>
732: If you're interested in seeing a port added, would like to help out, or just
1.90 deraadt 733: would like to know more, the mailing list
734: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.87 bentley 735: </section>