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