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

Annotation of www/37.html, Revision 1.91

1.86      bentley     1: <!doctype html>
                      2: <html lang=en id=release>
                      3: <meta charset=utf-8>
                      4:
1.67      deraadt     5: <title>OpenBSD 3.7</title>
1.1       henning     6: <meta name="description" content="OpenBSD 3.7">
1.78      tb          7: <meta name="viewport" content="width=device-width, initial-scale=1">
                      8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.81      tb          9: <link rel="canonical" href="https://www.openbsd.org/37.html">
1.1       henning    10:
1.86      bentley    11: <h2 id=OpenBSD>
1.1       henning    12: <a href="index.html">
1.86      bentley    13: <i>Open</i><b>BSD</b></a>
                     14: 3.7
1.78      tb         15: </h2>
1.69      deraadt    16:
1.86      bentley    17: <table>
                     18: <tr>
                     19: <td>
1.17      deraadt    20: <a href="images/Wizard.jpg">
1.86      bentley    21: <img width="255" height="343"
                     22: src="images/Wizard.jpg" alt="Wizard"></a>
                     23: <td>
1.61      david      24: Released May 19, 2005<br>
1.1       henning    25: Copyright 1997-2005, Theo de Raadt.<br>
1.86      bentley    26: <cite class=isbn>ISBN 0-9731791-5-5</cite>
1.60      deraadt    27: <br>
1.75      deraadt    28: 3.7 Song: <a href="lyrics.html#37">"The Wizard of OS"</a>
1.85      deraadt    29: <br>
                     30: <br>
1.1       henning    31: <ul>
1.90      deraadt    32: <li>See the information on <a href="ftp.html">the FTP page</a> for
1.1       henning    33:     a list of mirror machines.
1.86      bentley    34: <li>Go to the <code class=reldir>pub/OpenBSD/3.7/</code> directory on
1.1       henning    35:     one of the mirror sites.
1.63      deraadt    36: <li>Have a look at <a href="errata37.html">The 3.7 Errata page</a> for a list
1.1       henning    37:     of bugs and workarounds.
                     38: <li>See a <a href="plus37.html">detailed log of changes</a> between the
                     39:     3.6 and 3.7 releases.
                     40: </ul>
1.79      tb         41: <p>
1.78      tb         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
1.89      deraadt    44: files fetched via <code>ports.tar.gz</code>.
1.86      bentley    45: </table>
1.1       henning    46:
1.78      tb         47: <hr>
1.86      bentley    48:
                     49: <section id=new>
                     50: <h3>What's New</h3>
1.1       henning    51: <p>
                     52: This is a partial list of new features and systems included in OpenBSD 3.7.
                     53: For a comprehensive list, see the <a href="plus37.html">changelog</a> leading
                     54: to 3.7.
                     55: <p>
                     56:
                     57: <ul>
                     58:
                     59: <li>New platforms:
                     60: <ul>
1.44      niallo     61: <li><a href="zaurus.html">OpenBSD/zaurus</a>.<br>
1.24      deraadt    62: Expanding the arm porting effort by supporting the Sharp Zaurus SL-C3000,
                     63: bringing a secure ssh-capable machine to your pocket.
1.44      niallo     64: <li><a href="sgi.html">OpenBSD/sgi</a>.<br>
1.48      otto       65: A 64-bit port supporting O2 machines with R5000, RM5200, RM7000, R10000
1.49      jaredy     66: and R12000 CPUs.
1.1       henning    67: </ul>
                     68: <p>
1.33      tom        69: <li>Support for a number of much faster 64-bit machines (in 32-bit mode) in
                     70: the <a href="hppa.html">OpenBSD/hppa</a> port.
                     71: <p>
1.1       henning    72:
                     73: <li>Improved hardware support, including:
                     74: <ul>
1.86      bentley    75: <li>New <a href="https://man.openbsd.org/i386/ath.4">ath(4)</a>
1.9       pvalchev   76: driver for Atheros IEEE 802.11a/b/g wireless network adapters.
1.86      bentley    77: <li>New <a href="https://man.openbsd.org/i386/iwi.4">iwi(4)</a>
1.9       pvalchev   78: driver for Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network adapters.
1.86      bentley    79: <li>New <a href="https://man.openbsd.org/i386/ipw.4">ipw(4)</a>
1.9       pvalchev   80: driver for Intel PRO/Wireless 2100 IEEE 802.11b wireless network adapters.
1.86      bentley    81: <li>New <a href="https://man.openbsd.org/i386/atu.4">atu(4)</a>
1.9       pvalchev   82: driver for Atmel AT76C50x USB IEEE 802.11b wireless network adapters.
1.86      bentley    83: <li>New <a href="https://man.openbsd.org/i386/ral.4">ral(4)</a>
                     84: and <a href="https://man.openbsd.org/i386/ural.4">ural(4)</a> [USB]
1.15      deraadt    85: drivers for Ralink Technology RT25x0 IEEE 802.11a/b/g wireless network adapters.
1.86      bentley    86: <li>New <a href="https://man.openbsd.org/i386/rtw.4">rtw(4)</a>
1.9       pvalchev   87: driver for Realtek 8180 IEEE 802.11b wireless network adapters.
1.86      bentley    88: <li>Added support to <a href="https://man.openbsd.org/i386/re.4">re(4)</a>
1.9       pvalchev   89: driver for Realtek 8169 CardBus Ethernet adapters.
1.86      bentley    90: <li>New <a href="https://man.openbsd.org/i386/udav.4">udav(4)</a>
1.16      jsg        91: driver for Davicom DM9601 USB Ethernet adapters.
1.86      bentley    92: <li>New <a href="https://man.openbsd.org/i386/vge.4">vge(4)</a>
1.9       pvalchev   93: driver for VIA Networking Technologies VT6122 PCI Gigabit Ethernet adapters.
1.86      bentley    94: <li>New <a href="https://man.openbsd.org/i386/piixpm.4">piixpm(4)</a>
1.49      jaredy     95: driver for the Intel PIIX Power Management controller.
1.86      bentley    96: <li>New <a href="https://man.openbsd.org/i386/ubt.4">ubt(4)</a>
1.49      jaredy     97: driver for USB Bluetooth adapters.
1.1       henning    98: </ul>
                     99: <p>
                    100:
1.21      claudio   101: <li>Many enhancements in the <a href="mac68k.html">OpenBSD/mac68k</a> port.
                    102: <ul>
1.50      tom       103: <li>Switch to a bsd.rd-based install.
1.52      martin    104: <li>Improved interrupt system.
1.86      bentley   105: <li>Create partitions with <a href="https://man.openbsd.org/mac68k/pdisk.8">pdisk(8)</a>.
                    106: <li>Add <a href="https://man.openbsd.org/mac68k/mc.4">mc(4)</a>
1.21      claudio   107: support and enhance
1.86      bentley   108: <a href="https://man.openbsd.org/mac68k/zsc.4">zsc(4)</a>
1.21      claudio   109: support.
                    110: </ul>
                    111: <p>
                    112:
1.19      claudio   113: <li>New tools:
                    114: <ul>
1.86      bentley   115: <li><a href="https://man.openbsd.org/ospfd">ospfd(8)</a>,
1.83      tb        116: implementing the <a href="https://www.rfc-editor.org/rfc/rfc2328.txt">OSPFv2</a>
1.19      claudio   117: routing protocol.
1.86      bentley   118: <li><a href="https://man.openbsd.org/i386/getcap.1">getcap(1)</a>,
1.49      jaredy    119: providing easy access to the capability database.
1.19      claudio   120: </ul>
                    121: <p>
                    122:
1.11      henning   123: <li>New functionality:
                    124: <ul>
1.86      bentley   125: <li>Repaired mirroring mode in <a href="https://man.openbsd.org/i386/ccd.4">ccd(4)</a>.
                    126: <li>Privilege separation for <a href="https://man.openbsd.org/i386/ftpd.8">ftpd(8)</a>.
1.50      tom       127: <li>Bash-style prompt expansion and POSIX hex and octal constants in
1.86      bentley   128: <a href="https://man.openbsd.org/i386/ksh.1">ksh(1)</a>.
1.49      jaredy    129: <li>Improved TCP send performance.
1.78      tb        130: <li>Reentrant
1.86      bentley   131: <a href="https://man.openbsd.org/i386/getprotobyname_r.3">getproto*_r(3)</a>
1.31      otto      132: and
1.86      bentley   133: <a href="https://man.openbsd.org/i386/getservbyname_r.3">getserv*_r(3)</a>
1.31      otto      134: functions.
1.86      bentley   135: <li>In-kernel <a href="https://man.openbsd.org/i386/pppoe.4">pppoe(4)</a>
1.49      jaredy    136: support.
1.86      bentley   137: <li><a href="https://man.openbsd.org/i386/pim.4">pim(4)</a>
1.59      djm       138: (Protocol Independent Multicast) support added.
1.11      henning   139: </ul>
                    140: <p>
                    141:
1.86      bentley   142: <li>New functionality for <a href="https://man.openbsd.org/ntpd.8">ntpd(8)</a>,
1.10      henning   143: the Network Time Protocol Daemon:
                    144: <ul>
1.56      dtucker   145: <li>ntpd can now set the time immediately on startup itself, eliminating
                    146:     the need to run rdate -n beforehand.
1.34      tom       147: <li>Use median instead of average when collapsing all the peers' offsets
1.43      niallo    148:     into one, greatly improving resistance against falsetickers.
1.49      jaredy    149: <li>Calculate rootdelay, stratum, and precision properly; include these in
1.43      niallo    150:     replies sent out in server mode.
1.49      jaredy    151: <li>Many logging improvements: ntpd is now almost completely silent in normal
1.43      niallo    152:     operation (unless in debug mode, of course).
1.10      henning   153: </ul>
                    154: <p>
                    155:
1.86      bentley   156: <li>New functionality for <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>,
1.7       henning   157: the Border Gateway Protocol Daemon:
                    158: <ul>
                    159: <li>Allow sessions to depend on a CARP interface's master/backup state,
1.43      niallo    160:     reducing failover times in redundant setups.
1.7       henning   161: <li>Lower latency for requests from other peers or bgpctl while under heavy
1.49      jaredy    162:     load, e.g. initial table transfer when a session comes up.
1.7       henning   163: <li>Allow for the peer descriptions to be used in bgpctl commands where
1.49      jaredy    164:     previously only their IPs were allowed.
1.7       henning   165: <li>Allow bgpd to not prepend its own AS number and to not modify the nexthop
1.43      niallo    166:     on updates sent out.
1.7       henning   167: <li>Show associated interfaces and their state on &quot;show nexthop&quot;,
1.43      niallo    168:     to help pointing out why nexthops are invalid.
1.49      jaredy    169: <li>Allow for relative metrics modification, i.e.
1.43      niallo    170:     &quot;set localpref +20&quot;.
1.7       henning   171: </ul>
                    172: <p>
                    173:
1.86      bentley   174: <li>New functionality and improvements for <a href="https://man.openbsd.org/pf.4">pf(4)</a>, the packet filter:
1.57      deraadt   175: <ul>
1.86      bentley   176: <li>Improved <a href="https://man.openbsd.org/carp.4">carp(4)</a>, new <i>carpdev</i> mode for IP-less interfaces.
1.57      deraadt   177: <li>Support limiting TCP connections by establishment rate, automatically
                    178:     adding flooding IP addresses to tables and flushing states
                    179:     (<i>max-src-conn-rate</i>, <i>overload &lt;table&gt;</i>,
                    180:     <i>flush global</i>).
                    181: <li>Improved functionality of tags (<i>tag</i> and <i>tagged</i> for
                    182:     translation rules, tagging of all packets matching state entries).
                    183: <li>Improved diagnostics (error messages and additional counters from
                    184:     <i>pfctl -si</i>).
                    185: <li>New keyword <i>set skip on</i> to skip filtering on arbitrary interfaces,
                    186:     like loopback.
1.86      bentley   187: <li>Filtering on <a href="https://man.openbsd.org/route.8">route(8)</a> labels.
1.57      deraadt   188: <li>Several bugfixes improving stability.
                    189: </ul>
                    190: <p>
                    191:
1.86      bentley   192: <li>New functionality and improvements for <a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a>,
1.20      hshoexer  193: the Internet Security Association and Key Management Daemon:
                    194: <ul>
1.30      tom       195: <li>Allow the Address, Network, or Netmask values of the &quot;IPsec-ID&quot;
                    196:     to be specified with an interface name or the keyword &quot;default&quot;
1.43      niallo    197:     (in which case the address is selected based on the default route).
                    198: <li>Improved NAT-T and DPD stability and interoperability.
1.20      hshoexer  199: </ul>
                    200: <p>
                    201:
1.86      bentley   202: <li>New functionality and improvements for <a href="https://man.openbsd.org/spamd.8">spamd(8)</a>,
1.54      beck      203: the Spamd Spam Deferral Daemon
                    204: <ul>
                    205: <li> Allow the addition of spamtrap addresses to the spamd database
1.86      bentley   206: using <a href="https://man.openbsd.org/spamdb.8">spamdb(8)</a>.
1.54      beck      207: Spamd will automatically blacklist hosts that attempt to deliver mail to a
                    208: spamtrap address while greylisted.
                    209: </ul>
                    210: <p>
                    211:
1.86      bentley   212: <li>New functionality and many improvements for the <a href="https://man.openbsd.org/pkg_add.1">package tools</a>:
1.32      henning   213: <ul>
1.40      sturm     214: <li>Major overhaul of the package format, simplifying common tasks like user
1.43      niallo    215:     creation.
                    216: <li>In-place updates of packages with pkg_add -r.
1.46      jolan     217: <li>Progress meters, which make installing big packages a more pleasant
1.43      niallo    218:     experience.
                    219: <li>Reliable dependencies on shared libraries, including the base system.
                    220: <li>Many performance improvements.
1.32      henning   221: </ul>
                    222: <p>
                    223:
1.8       pvalchev  224: <li>Over 3000 ports, 2800 pre-built packages.
1.1       henning   225: <p>
                    226:
1.3       henning   227: <li>Many improvements for security and reliability.
1.27      otto      228: Cleaner source code for
1.86      bentley   229:  <a href="https://man.openbsd.org/ksh.1">ksh(1)</a>,
                    230:  <a href="https://man.openbsd.org/httpd.8">httpd(8)</a>, and many more programs.
1.1       henning   231: <p>
                    232:
                    233: <li>As usual, many improvements in manual pages and other documentation.
                    234: <p>
                    235:
                    236: <li>OpenSSH 4.1:
                    237: <ul>
1.55      dtucker   238: <li>Local, remote and dynamic port forwards may be configured to listen on
                    239:     specific IP addresses.
1.86      bentley   240: <li><a href="https://man.openbsd.org/sshd_config.5">
1.58      deraadt   241:     sshd_config(5)</a> now understands
1.55      dtucker   242:     "GatewayPorts clientspecified" to allow client-specified
                    243:     listen addresses in remote port forwards.  The existing
                    244:     behaviour for "yes" and "no" is maintained.
                    245: <li>known_hosts files may be hashed to provide privacy if they are later
                    246:     disclosed.
1.86      bentley   247: <li><a href="https://man.openbsd.org/ssh-keygen.1">
1.58      deraadt   248:     ssh-keygen(1)</a> has additional modes to generate and manage hashed
1.55      dtucker   249:     known_hosts files.
                    250: <li>Users will be warned of impending password and account expiry.
                    251: <li>Corrupt keys in authorized_keys are now handled gracefully.
1.86      bentley   252: <li><a href="https://man.openbsd.org/sftp.1">
1.58      deraadt   253:     sftp(1)</a> has speed improvements for "ls" and now uses
1.55      dtucker   254:     libedit for command line editing and history.
1.86      bentley   255: <li><a href="https://man.openbsd.org/sshd.8">
1.58      deraadt   256:     sshd(8)</a> will now log the source of connections denied by AllowUsers,
1.55      dtucker   257:     DenyUsers, AllowGroups and DenyGroups.
1.58      deraadt   258: <li>AddressFamily option in
1.86      bentley   259:     <a href="https://man.openbsd.org/sshd_config.5">
1.58      deraadt   260:     sshd_config(5)</a> now has an AddressFamily option to provide global
1.55      dtucker   261:     control of IPv4 and IPv6 usage by
1.86      bentley   262:     <a href="https://man.openbsd.org/sshd.8">
1.58      deraadt   263:     sshd(8)</a>.
1.86      bentley   264: <li><a href="https://man.openbsd.org/ssh.1">
1.58      deraadt   265:     ssh(1)</a>'s multiplex (ControlMaster) mode has been improved and now
1.55      dtucker   266:     provides additional capabilities such as checking if the master is alive,
                    267:     obtaining its process ID and requesting that it shut down.
1.1       henning   268: </ul>
                    269: <p>
                    270:
1.47      otto      271: <li><a href="i386.html">OpenBSD/i386</a> and
                    272: <a href="macppc.html">OpenBSD/macppc</a> now use
1.86      bentley   273: <a href="https://man.openbsd.org/gcc-local.1">gcc 3.3.5</a>.
1.47      otto      274: <p>
                    275:
1.51      kettenis  276: <li><a href="amd64.html">OpenBSD/amd64</a>,
                    277: <a href="cats.html">OpenBSD/cats</a>,
                    278: <a href="macppc.html">OpenBSD/macppc</a>,
                    279: <a href="hppa.html">OpenBSD/hppa</a>,
                    280: <a href="sgi.html">OpenBSD/sgi</a>,
                    281: <a href="sparc64.html">OpenBSD/sparc64</a> and
                    282: <a href="zaurus.html">OpenBSD/zaurus</a> now use
                    283: DWARF2 (C++) exception handling.
                    284: <p>
                    285:
1.1       henning   286: <li>The system includes the following major components from outside suppliers:
                    287: <ul>
1.6       matthieu  288: <li>X.Org 6.8.2 (+ patches, and i386 contains XFree86 3.3.6 servers
                    289: (+ patches) for legacy chipsets not supported by X.Org)
1.1       henning   290: <li>Gcc 2.95.3
1.86      bentley   291: (+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
1.2       henning   292: and 3.3.5
1.86      bentley   293: (+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
1.2       henning   294: <li>Perl 5.8.6 (+ patches)
1.1       henning   295: <li>Apache 1.3.29, mod_ssl 2.8.16, DSO support (+ patches)
                    296: <li>OpenSSL 0.9.7d (+ patches)
                    297: <li>Groff 1.15
1.2       henning   298: <li>Sendmail 8.13.3, with libmilter
                    299: <li>Bind 9.3.0 (+ patches)
1.1       henning   300: <li>Lynx 2.8.5rel.2 with HTTPS and IPv6 support (+ patches)
1.2       henning   301: <li>Sudo 1.6.8p6
1.1       henning   302: <li>Ncurses 5.2
                    303: <li>Latest KAME IPv6
                    304: <li>Heimdal 0.6rc1 (+ patches)
                    305: <li>Arla 0.35.7
1.2       henning   306: <li>Binutils 2.15
                    307: <li>Gdb 6.3
1.1       henning   308: </ul>
                    309: <p>
                    310:
                    311: </ul>
1.86      bentley   312: </section>
1.1       henning   313:
                    314: <hr>
1.86      bentley   315:
                    316: <section id=install>
                    317: <h3>How to install</h3>
1.1       henning   318: <p>
                    319: Following this are the instructions which you would have on a piece of
                    320: paper if you had purchased a CDROM set instead of doing an alternate
1.49      jaredy    321: form of install.  The instructions for doing an FTP (or other style
1.1       henning   322: of) install are very similar; the CDROM instructions are left intact
                    323: so that you can see how much easier it would have been if you had
                    324: purchased a CDROM instead.
                    325: <p>
                    326:
                    327: <hr>
1.49      jaredy    328: Please refer to the following files on the three CDROMs or FTP mirror for
1.1       henning   329: extensive details on how to install OpenBSD 3.7 on your machine:
                    330: <p>
                    331: <ul>
1.87      deraadt   332: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/i386/INSTALL.i386">
                    333:        .../OpenBSD/3.7/i386/INSTALL.i386 (on CD1)</a>
                    334: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/vax/INSTALL.vax">
                    335:        .../OpenBSD/3.7/vax/INSTALL.vax (on CD1)</a>
                    336: <p>
                    337: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/amd64/INSTALL.amd64">
                    338:        .../OpenBSD/3.7/amd64/INSTALL.amd64 (on CD2)</a>
                    339: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/macppc/INSTALL.macppc">
                    340:        .../OpenBSD/3.7/macppc/INSTALL.macppc (on CD2)</a>
                    341: <p>
                    342: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/sparc/INSTALL.sparc">
                    343:        .../OpenBSD/3.7/sparc/INSTALL.sparc (on CD3)</a>
                    344: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/sparc64/INSTALL.sparc64">
                    345:        .../OpenBSD/3.7/sparc64/INSTALL.sparc64 (on CD3)</a>
                    346: <p>
                    347: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/alpha/INSTALL.alpha">
                    348:        .../OpenBSD/3.7/alpha/INSTALL.alpha</a>
                    349: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/cats/INSTALL.cats">
                    350:        .../OpenBSD/3.7/cats/INSTALL.cats</a>
                    351: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/hp300/INSTALL.hp300">
                    352:        .../OpenBSD/3.7/hp300/INSTALL.hp300</a>
                    353: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/hppa/INSTALL.hppa">
                    354:        .../OpenBSD/3.7/hppa/INSTALL.hppa</a>
                    355: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/luna88k/INSTALL.luna88k">
                    356:        .../OpenBSD/3.7/luna88k/INSTALL.luna88k</a>
                    357: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/mac68k/INSTALL.mac68k">
                    358:        .../OpenBSD/3.7/mac68k/INSTALL.mac68k</a>
                    359: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/mvme68k/INSTALL.mvme68k">
                    360:        .../OpenBSD/3.7/mvme68k/INSTALL.mvme68k</a>
                    361: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/mvme88k/INSTALL.mvme88k">
                    362:        .../OpenBSD/3.7/mvme88k/INSTALL.mvme88k</a>
                    363: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/sgi/INSTALL.sgi">
                    364:        .../OpenBSD/3.7/sgi/INSTALL.sgi</a>
                    365: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/zaurus/INSTALL.zaurus">
                    366:        .../OpenBSD/3.7/zaurus/INSTALL.zaurus</a>
1.1       henning   367: </ul>
1.87      deraadt   368: </section>
                    369:
1.1       henning   370: <hr>
                    371:
1.86      bentley   372: <section id=quickinstall>
                    373:
1.1       henning   374: <p>
                    375: Quick installer information for people familiar with OpenBSD, and the
                    376: use of the "disklabel -E" command.  If you are at all confused when
                    377: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.86      bentley   378:
                    379: <h3>OpenBSD/i386:</h3>
                    380:
1.1       henning   381: <p>
                    382: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
                    383: release is on CD1. If your BIOS does not support booting from CD, you will need
                    384: to create a boot floppy to install from. To create a boot floppy write
                    385: <i>CD1:3.7/i386/floppy37.fs</i> to a floppy and boot via the floppy drive.
                    386:
                    387: <p>
1.49      jaredy    388: Use <i>CD1:3.7/i386/floppyB37.fs</i> instead for greater SCSI controller
1.1       henning   389: support, or <i>CD1:3.7/i386/floppyC37.fs</i> for better laptop support.
                    390:
                    391: <p>
                    392: If you can't boot from a CD or a floppy disk,
                    393: you can install across the network using PXE as described in
                    394: the included INSTALL.i386 document.
                    395:
                    396: <p>
                    397: If you are planning on dual booting OpenBSD with another OS, you will need to
                    398: read INSTALL.i386.
                    399:
                    400: <p>
                    401: To make a boot floppy under MS-DOS, use the &quot;rawrite&quot; utility located
                    402: at <i>CD1:3.7/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
1.86      bentley   403: use the <a href="https://man.openbsd.org/dd.1">dd(1)</a>
                    404: utility. The following is an example usage of
                    405: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.49      jaredy    406: where the device could be &quot;floppy&quot;, &quot;rfd0c&quot;, or
1.1       henning   407: &quot;rfd0a&quot;.
                    408:
1.86      bentley   409: <blockquote><pre>
                    410: # <kbd>dd if=&lt;file&gt; of=/dev/&lt;device&gt; bs=32k</kbd>
                    411: </pre></blockquote>
1.1       henning   412:
                    413: <p>
                    414: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
                    415: your install will most likely fail. For more information on creating a boot
                    416: floppy and installing OpenBSD/i386 please refer to
1.80      tj        417: <a href="faq/faq4.html#MkFlop">this page</a>.
1.86      bentley   418:
                    419: <h3>OpenBSD/vax:</h3>
1.1       henning   420:
                    421: <p>
                    422: Boot over the network via mopbooting as described in INSTALL.vax.
1.86      bentley   423:
                    424: <h3>OpenBSD/amd64:</h3>
1.1       henning   425:
                    426: <p>
                    427: The 3.7 release of OpenBSD/amd64 is located on CD2.
                    428: Boot from the CD to begin the install - you may need to adjust
                    429: your BIOS options first.
                    430: If you can't boot from the CD, you can create a boot floppy to install from.
                    431: To do this, write <i>CD2:3.7/amd64/floppy37.fs</i> to a floppy, then
                    432: boot from the floppy drive.
                    433:
                    434: <p>
                    435: If you can't boot from a CD or a floppy disk,
                    436: you can install across the network using PXE as described in the included
                    437: INSTALL.amd64 document.
                    438:
                    439: <p>
                    440: If you are planning to dual boot OpenBSD with another OS, you will need to
                    441: read INSTALL.amd64.
1.86      bentley   442:
                    443: <h3>OpenBSD/macppc:</h3>
1.1       henning   444:
                    445: <p>
1.49      jaredy    446: Put CD2 in your CDROM drive and poweron your machine while holding down the
1.1       henning   447: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
                    448:
                    449: <p>
                    450: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
                    451: /3.7/macppc/bsd.rd</i>
1.86      bentley   452:
                    453: <h3>OpenBSD/sparc:</h3>
1.1       henning   454:
                    455: <p>
                    456: The 3.7 release of OpenBSD/sparc is located on CD3. To boot off of this CD you
                    457: can use one of the two commands listed below, depending on the version of your
                    458: ROM.
                    459:
1.86      bentley   460: <blockquote><pre>
                    461: ok <kbd>boot cdrom 3.7/sparc/bsd.rd</kbd>
1.1       henning   462: or
1.86      bentley   463: > <kbd>b sd(0,6,0)3.7/sparc/bsd.rd</kbd>
                    464: </pre></blockquote>
1.1       henning   465:
                    466: <p>
                    467: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
                    468: To do so you need to write <i>CD3:3.7/sparc/floppy37.fs</i> to a floppy.
1.80      tj        469: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.39      tom       470: To boot from the floppy use one of the two commands listed below,
                    471: depending on the version of your ROM.
1.1       henning   472:
1.86      bentley   473: <blockquote><pre>
                    474: ok <kbd>boot floppy</kbd>
1.1       henning   475: or
1.86      bentley   476: > <kbd>boot fd()</kbd>
                    477: </pre></blockquote>
1.1       henning   478:
                    479: <p>
                    480: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    481: will most likely fail.
                    482:
                    483: <p>
                    484: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
                    485: setup a bootable tape, or install via network, as told in the
                    486: INSTALL.sparc file.
1.86      bentley   487:
                    488: <h3>OpenBSD/sparc64:</h3>
1.1       henning   489:
                    490: <p>
1.49      jaredy    491: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
1.1       henning   492:
                    493: <p>
                    494: If this doesn't work, or if you don't have a CDROM drive, you can write
                    495: <i>CD3:3.7/sparc64/floppy37.fs</i> to a floppy and boot it with <i>boot
                    496: floppy</i>.<br>
                    497: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    498: will most likely fail.
                    499:
                    500: <p>
                    501: You can also write <i>CD3:3.7/sparc64/miniroot37.fs</i> to the swap partition on
                    502: the disk and boot with <i>boot disk:b</i>.
                    503:
                    504: <p>
                    505: If nothing works, you can boot over the network as described in INSTALL.sparc64
1.86      bentley   506:
                    507: <h3>OpenBSD/alpha:</h3>
1.1       henning   508:
                    509: <p>
1.87      deraadt   510: Write <i>3.7/alpha/floppy37.fs</i> or
                    511: <i>3.7/alpha/floppyB37.fs</i> (depending on your machine) to a diskette and
1.1       henning   512: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
                    513:
                    514: <p>
                    515: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    516: will most likely fail.
                    517:
1.86      bentley   518: <h3>OpenBSD/cats:</h3>
1.1       henning   519:
                    520: <p>
                    521: After updating the firmware to at least ABLE 1.95 if necessary, boot
1.87      deraadt   522: <i>3.7/cats/bsd.rd</i> from an ABLE-supported device (such as a CD-ROM
1.1       henning   523: or an existing FFS or EXT2FS partition).
                    524:
1.86      bentley   525: <h3>OpenBSD/hp300:</h3>
                    526:
1.1       henning   527: <p>
                    528: Boot over the network by following the instructions in INSTALL.hp300.
                    529:
1.86      bentley   530: <h3>OpenBSD/hppa:</h3>
                    531:
1.1       henning   532: <p>
                    533: Boot over the network by following the instructions in INSTALL.hppa or the
1.49      jaredy    534: <a href="hppa.html#install">hppa platform page</a>.
1.1       henning   535:
1.86      bentley   536: <h3>OpenBSD/luna88k:</h3>
                    537:
1.1       henning   538: <p>
                    539: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
                    540: Alternatively, you can create a bootable tape and boot from it. Refer to
                    541: the instructions in INSTALL.luna88k for more details.
1.86      bentley   542:
                    543: <h3>OpenBSD/mac68k:</h3>
1.1       henning   544:
                    545: <p>
1.26      claudio   546: Boot MacOS as normal and extract the Macside "BSD/Mac68k Booter" utility from
1.87      deraadt   547: <i>3.7/mac68k/utils</i> onto your hard disk.  Configure the "BSD/Mac68k
1.26      claudio   548: Booter" with the location of your bsd.rd kernel and boot into the installer.
                    549: Refer to the instructions in INSTALL.mac68k for more details.
1.1       henning   550:
1.86      bentley   551: <h3>OpenBSD/mvme68k:</h3>
                    552:
1.1       henning   553: <p>
                    554: You can create a bootable installation tape or boot over the network.<br>
                    555: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
                    556: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
                    557: for more details.
1.86      bentley   558:
                    559: <h3>OpenBSD/mvme88k:</h3>
1.1       henning   560:
                    561: <p>
                    562: You can create a bootable installation tape or boot over the network.<br>
                    563: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
                    564: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
                    565: for more details.
                    566:
1.86      bentley   567: <h3>OpenBSD/sgi:</h3>
                    568:
1.18      deraadt   569: <p>
                    570: Setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd".
1.53      miod      571: Refer to the instructions in INSTALL.sgi for more details.
1.86      bentley   572:
                    573: <h3>OpenBSD/zaurus:</h3>
1.53      miod      574:
                    575: <p>
                    576: Using the Linux built-in graphical ipkg installer, install the
                    577: openbsd37_arm.ipk package.  Reboot, then run it.  Read INSTALL.zaurus
                    578: for a few important details.
1.87      deraadt   579: </section>
1.86      bentley   580:
1.87      deraadt   581: <hr>
1.86      bentley   582:
                    583: <section id=sourcecode>
1.87      deraadt   584: <h3>Notes about the source code</h3>
1.1       henning   585: <p>
1.89      deraadt   586: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
                    587: This file contains everything you need except for the kernel sources, which are
1.1       henning   588: in a separate archive.  To extract:
1.86      bentley   589:
                    590: <blockquote><pre>
                    591: # <kbd>mkdir -p /usr/src</kbd>
                    592: # <kbd>cd /usr/src</kbd>
                    593: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
                    594: </pre></blockquote>
                    595:
1.1       henning   596: <p>
1.89      deraadt   597: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
1.1       henning   598: This file contains all the kernel sources you need to rebuild kernels.
                    599: To extract:
1.86      bentley   600:
                    601: <blockquote><pre>
                    602: # <kbd>mkdir -p /usr/src/sys</kbd>
                    603: # <kbd>cd /usr/src</kbd>
                    604: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
                    605: </pre></blockquote>
                    606:
1.1       henning   607: <p>
                    608: Both of these trees are a regular CVS checkout.  Using these trees it
                    609: is possible to get a head-start on using the anoncvs servers as
                    610: described <a href="anoncvs.html">here</a>.
                    611: Using these files
                    612: results in a much faster initial CVS update than you could expect from
                    613: a fresh checkout of the full OpenBSD source tree.
1.86      bentley   614: </section>
                    615:
1.1       henning   616: <hr>
1.86      bentley   617:
                    618: <section id=upgrade>
                    619: <h3>How to upgrade</h3>
1.1       henning   620: <p>
1.4       henning   621: If you already have an OpenBSD 3.6 system, and do not want to reinstall,
1.1       henning   622: upgrade instructions and advice can be found in the
                    623: <a href="faq/upgrade37.html">Upgrade Guide</a>.
1.86      bentley   624: </section>
1.1       henning   625:
                    626: <hr>
1.86      bentley   627:
                    628: <section id=ports>
                    629: <h3>Ports Tree</h3>
1.1       henning   630: <p>
                    631: A ports tree archive is also provided.  To extract:
1.86      bentley   632: <blockquote><pre>
                    633: # <kbd>cd /usr</kbd>
                    634: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
                    635: </pre></blockquote>
1.1       henning   636: <p>
                    637: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree.  Go
1.65      jasper    638: read the <a href="faq/faq15.html">ports</a> page
1.1       henning   639: if you know nothing about ports
                    640: at this point.  This text is not a manual of how to use ports.
                    641: Rather, it is a set of notes meant to kickstart the user on the
                    642: OpenBSD ports system.
                    643: <p>
                    644: The <i>ports/</i> directory represents a CVS (see the manpage for
1.88      bentley   645: <a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
1.1       henning   646: you aren't familiar with CVS) checkout of our ports.  As with our complete
                    647: source tree, our ports tree is available via anoncvs.  So, in
                    648: order to keep current with it, you must make the <i>ports/</i> tree
                    649: available on a read-write medium and update the tree with a command
                    650: like:
1.86      bentley   651: <blockquote><pre>
                    652: # <kbd>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_7</kbd>
                    653: </pre></blockquote>
1.1       henning   654: <p>
                    655: [Of course, you must replace the local directory and server name here
                    656: with the location of your ports collection and a nearby anoncvs
                    657: server.]
                    658: <p>
1.87      deraadt   659: Note that most ports are available as packages on our mirrors. Updated
1.1       henning   660: packages for the 3.7 release will be made available if problems arise.
                    661: <p>
                    662: If you're interested in seeing a port added, would like to help out, or just
1.87      deraadt   663: would like to know more, the mailing list
                    664: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.86      bentley   665: </section>