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

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 (&gt;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 (&gt;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.&lt;arch&gt; 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 &quot;rawrite&quot; 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 &quot;floppy&quot;, &quot;rfd0c&quot;, or
                    472: &quot;rfd0a&quot;.
                    473:
1.87      bentley   474: <blockquote><pre>
1.90      deraadt   475: # <kbd>dd if=&lt;file&gt; of=/dev/&lt;device&gt; 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>