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

Annotation of www/31.html, Revision 1.20

1.1       deraadt     1: <!DOCTYPE HTML PUBLIC  "-//IETF//DTD HTML Strict//EN">
                      2: <html>
                      3: <head>
1.20    ! deraadt     4: <title>OpenBSD 3.1</title>
1.1       deraadt     5: <meta name="resource-type" content="document">
1.6       miod        6: <meta name="description" content="OpenBSD 3.1">
1.1       deraadt     7: <meta name="keywords" content="openbsd,main">
                      8: <meta name="distribution" content="global">
                      9: <meta name="copyright" content="This document copyright 1999-2002 by OpenBSD.">
                     10: </head>
                     11:
1.15      david      12: <body bgcolor="#ffffff" text="#000000" link="#24248e">
1.1       deraadt    13:
1.13      jufi       14: <a href="index.html">
                     15: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
1.1       deraadt    16: <hr>
                     17:
                     18: <p>
1.20    ! deraadt    19: <a href=images/Systemagic.jpg>
        !            20: <img align="left" width="255" height="323" hspace="24"
        !            21: src="images/Systemagic.jpg"></a>
        !            22: <h2><font color="#0000e0">OpenBSD 3.1</font></h2>
1.1       deraadt    23: <p>
1.11      jsyn       24: Released May 19, 2002<br>
1.1       deraadt    25: Copyright 1997-2002, Theo de Raadt.<br>
1.6       miod       26: <font color="#e00000">ISBN 0-9683637-9-2</font>
1.16      deraadt    27: <br>
                     28: <a href="lyrics.html#31">3.1 Song: "Systemagic"</a>
1.1       deraadt    29: <p>
                     30: <ul>
1.13      jufi       31: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
1.6       miod       32: <li>See the information on <a href="ftp.html">The FTP page</a> for
1.1       deraadt    33:        a list of mirror machines.
1.6       miod       34: <li>Go to the <font color="#e00000">pub/OpenBSD/3.1/</font> directory on
1.1       deraadt    35:        one of the mirror sites.
                     36: <li>Briefly read the rest of this document.
1.14      deraadt    37: <li>Have a look at <a href="errata31.html">The 3.1 Errata page</a> for a list
1.1       deraadt    38:        of bugs and workarounds.
1.6       miod       39: <li>See a <a href="plus31.html">detailed log of changes</a> between the
1.1       deraadt    40:        3.0 and 3.1 releases.
                     41: </ul>
                     42: <br clear=all>
1.20    ! deraadt    43: All applicable copyrights and credits can be found in the applicable
        !            44: file sources found in the files src.tar.gz, sys.tar.gz,
        !            45: xenocara.tar.gz, or in the files fetched via ports.tar.gz.  The
        !            46: distribution files used to build packages from the ports.tar.gz file
        !            47: are not included on the CDROM because of lack of space.
1.1       deraadt    48: <p>
                     49:
1.6       miod       50: <a name="new"></a>
1.1       deraadt    51: <hr>
                     52: <p>
1.6       miod       53: <h3><font color="#0000e0">What's New</font></h3>
1.1       deraadt    54: <p>
                     55: This is a partial list of new features and systems included in OpenBSD 3.1.
1.6       miod       56: For a comprehensive list, see the <a href="plus31.html">changelog</a> leading
1.1       deraadt    57: to 3.1.
                     58: <p>
                     59:
                     60: <ul>
                     61: <li><a href="http://www.OpenSSH.com">OpenSSH</a> (supporting both the
                     62: SSH1 and SSH2 protocols) is now at version 3.2. Secure file transfers are
1.7       miod       63: encouraged using the greatly enhanced SFTP subsystem which comes both with
1.1       deraadt    64: an SFTP server and client.
                     65: <p>
                     66:
1.5       miod       67: <li>As usual, improvements to the documentation, notably the man pages and
                     68: the Web FAQ. A larger part of the website is now available in several
                     69: languages.
1.1       deraadt    70: <p>
                     71:
                     72: <li>More complete collection and better tested set of "ports".
                     73: <p>
                     74:
                     75: <li>Over 1000 pre-built and tested packages.
                     76: <p>
                     77:
1.5       miod       78: <li>Greatly improved hardware support in the
                     79: <a href="sparc64.html">OpenBSD/sparc64</a> port, and the addition of X11
                     80: support.
1.1       deraadt    81: <p>
                     82:
1.5       miod       83: <li>Numerous performance improvements to the <a
                     84: href="macppc.html">OpenBSD/macppc</a> port, as well as accelerated X11 servers
                     85: for some models.
                     86: <p>
                     87:
                     88: <li>A lot of enhancements to our new packet filter, <a
1.7       miod       89: href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf&sektion=4">pf</a>,
                     90: including performance improvements, as well as the ability to filter other
                     91: protocols than the usual tcp, udp and icmp, such as esp.
                     92: <p>
                     93:
                     94: <li>An utility to achieve per-user pf rules changes, typically intended for
                     95: gateways, <a
                     96: href="http://www.openbsd.org/cgi-bin/man.cgi?query=authpf&sektion=8">authpf</a>.
                     97: <p>
                     98:
1.10      tdeval     99: <li>The in-kernel software <a
                    100: href="http://www.openbsd.org/cgi-bin/man.cgi?query=raid&sektion=4">raid</a>
                    101: (RAIDframe) can now automatically detect and configure its raid devices at boot.
                    102: Taking advantage of this, the system can have its root partition directly
                    103: mounted from an auto-detected raid partition.
                    104: <p>
                    105:
1.7       miod      106: <li>Wavelan bridging is now possible on Prism-II based cards.
1.1       deraadt   107: <p>
                    108:
                    109: <li>The system includes the following major components from outside suppliers:
                    110: <p>
                    111: <ul>
1.6       miod      112: <li>XFree86 4.2.0 (and i386 contains 3.3.X servers also, thus providing support for all chipsets)</li>
                    113: <li>gcc 2.95.3 (+ patches)</li>
                    114: <li>perl 5.6.1 (+ patches)</li>
                    115: <li>Apache 1.3.24, mod_ssl 2.8.8, OpenSSL 0.9.6b (+ patches), DSO support</li>
                    116: <li>groff 1.15</li>
                    117: <li>sendmail 8.12.2</li>
                    118: <li>lynx 2.8.2rel.1 with HTTPS support added</li>
                    119: <li>sudo 1.6.5p2</li>
                    120: <li>ncurses 5.2</li>
                    121: <li>Latest KAME IPv6</li>
                    122: <li>KTH Kerberos 1.0.8</li>
                    123: <li>Heimdal 0.4e (+ patches)</li>
                    124: <li>OpenSSH 3.2</li>
1.1       deraadt   125: </ul>
                    126: <p>
                    127:
                    128: <li>Many improvements for security and reliability (look for the red
1.6       miod      129: print in the <a href="plus31.html">complete changelog</a>).
1.1       deraadt   130: <p>
                    131: </ul>
                    132:
1.6       miod      133: <a name="install"></a>
1.1       deraadt   134: <hr>
                    135: <p>
1.6       miod      136: <h3><font color="#0000e0">How to install</font></h3>
1.1       deraadt   137: <p>
                    138: Following this are the instructions which you would have on a piece of
                    139: paper if you had purchased a CDROM set instead of doing an alternate
                    140: form of install.  The instructions for doing an ftp (or other style
                    141: of) install are very similar; the CDROM instructions are left intact
                    142: so that you can see how much easier it would have been if you had
                    143: purchased a CDROM instead.
                    144: <p>
                    145:
                    146: <hr>
                    147: Please refer to the following files on the three CDROMs for extensive
                    148: details on how to install OpenBSD 3.1 on your machine:
                    149: <p>
                    150: <ul>
1.6       miod      151: <li>   CD1:3.1/i386/INSTALL.i386</li>
                    152: <li>   CD1:3.1/alpha/INSTALL.alpha</li>
1.1       deraadt   153: <p>
1.6       miod      154: <li>   CD2:3.1/macppc/INSTALL.macppc</li>
                    155: <li>   CD2:3.1/vax/INSTALL.vax</li>
1.1       deraadt   156: <p>
1.6       miod      157: <li>   CD3:3.1/sparc/INSTALL.sparc</li>
                    158: <li>   CD3:3.1/sparc64/INSTALL.sparc64</li>
1.1       deraadt   159: <p>
                    160: Only available via FTP:<br>
1.6       miod      161: <li>   CD4:3.1/mvme68k/INSTALL.mvme68k</li>
                    162: <li>   CD4:3.1/amiga/INSTALL.amiga</li>
                    163: <li>   CD4:3.1/mac68k/INSTALL.mac68k</li>
                    164: <li>   CD4:3.1/hp300/INSTALL.hp300</li>
1.1       deraadt   165: </ul>
                    166: <hr>
                    167:
                    168: <p>
                    169: Quick installer information for people familiar with OpenBSD, and the
                    170: use of the "disklabel -E" command.  If you are at all confused when
                    171: installing OpenBSD, read the relevant INSTALL.* file as listed above!
                    172: <p>
                    173:
1.6       miod      174: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
1.1       deraadt   175: <ul>
                    176: <p>
                    177: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386 release is on CD1. If your BIOS does not support booting from CD, you will need to create a boot floppy to install from. To create a boot floppy write <i>CD1:3.1/i386/floppy31.fs</i> to a floppy and boot via the floppy drive.
                    178:
                    179: <p>
                    180: Use <i>CD1:3.1/i386/floppyB31.fs</i> instead for greater scsi controller
                    181: support, or <i>CD1:3.1/i386/floppyC31.fs</i> for better laptop support.
                    182:
                    183: <p>
                    184: If you are planning on dual booting OpenBSD with another OS, you will need to read the included INSTALL.i386 document.
                    185:
                    186: <p>
1.8       miod      187: To make a boot floppy under MS-DOS, use the &quot;rawrite&quot; utility located at <i>CD:/3.1/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS, use the <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a> utility. The following is an example usage of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>, where the device could be &quot;floppy&quot;, &quot;rfd0c&quot;, or &quot;rfd0a&quot;.
1.1       deraadt   188:
                    189: <ul><pre>
                    190: # <strong>dd if=&lt;file&gt; of=/dev/&lt;device&gt; bs=32k</strong>
                    191: </pre></ul>
                    192:
                    193: <p>
                    194: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or your install will most likely fail. For more information on creating a boot floppy and installing OpenBSD/i386 please refer to <a href="faq/faq4.html#4.1">FAQ4.1</a>.
                    195: </ul>
                    196:
                    197: <p>
1.6       miod      198: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
1.1       deraadt   199: <ul>
                    200: <p>
                    201: At the SRM prompt, enter <i>boot -fi 3.1/alpha/bsd.rd dka6</i> where <i>dka6</i>
                    202: is the short name for the CDROM drive (you can check with <i>show dev</i>).
                    203:
                    204: <p>If you can't boot from CDROM, write <i>CD1:3.1/alpha/floppy31.fs</i> or
                    205: <i>CD1:3.1/alpha/floppyB31.fs</i> (depending on your machine) to a diskette and
                    206: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
                    207:
                    208: <p>
                    209: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
                    210:
                    211: </ul>
                    212:
                    213: <p>
1.6       miod      214: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
1.1       deraadt   215: <ul>
                    216: <p>
                    217: Put the CD2 in your CDROM drive and poweron your machine while holding down the
                    218: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
                    219:
                    220: <p>
                    221: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
                    222: /3.1/macppc/bsd.rd</i>
                    223: </ul>
                    224:
                    225: <p>
1.6       miod      226: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
1.1       deraadt   227: <ul>
                    228: <p>
                    229: Put the CD4 in your CDROM drive and press the spacebar during the poweron
                    230: self-test. Enter the boot choice that corresponds to <i>SYS_CDBOOT</i>.
                    231:
                    232: <p>
                    233: Alternatively, you can boot over the network by following the instructions in
                    234: INSTALL.hp300.
                    235: </ul>
                    236:
                    237: <p>
1.6       miod      238: <h3><font color="#e00000">OpenBSD/amiga:</font></h3>
1.1       deraadt   239: <ul>
                    240: <p>
                    241: Create BSD partitions according to INSTALL.amiga's preparation section.
                    242: Mount the CD4 under AmigaOS as device CD0: Next, execute the following
                    243: CLI command: "CD0:3.1/amiga/utils/loadbsd CD0:3.1/amiga/bsd.rd".
                    244: </ul>
                    245:
                    246: <p>
1.6       miod      247: <h3><font color="#e00000">OpenBSD/mac68k:</font></h3>
1.1       deraadt   248: <ul>
                    249: <p>
                    250: Boot MacOS as normal and partition your disk with the appropriate A/UX
                    251: configurations.  Then, extract the Macside utilities from
                    252: CD4:3.1/mac68k/utils onto your hard disk.  Run Mkfs to create your
                    253: filesystems on the A/UX partitions you just made.  Then, use the
                    254: BSD/Mac68k Installer to copy all the sets in CD4:3.1/mac68k/ onto your
                    255: partitions.  Finally, you will be ready to configure the BSD/Mac68k
                    256: Booter with the location of your kernel and boot the system.
                    257: </ul>
                    258:
                    259: <p>
1.6       miod      260: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
1.1       deraadt   261: <ul>
                    262: <p>
                    263: You can create a bootable installation tape or boot over the network.<br>
                    264: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
                    265: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
                    266: for more details.
                    267: </ul>
                    268:
                    269: <p>
1.6       miod      270: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
1.1       deraadt   271: <ul>
                    272: <p>
                    273: Boot over the network via mopbooting as described in INSTALL.vax.
                    274: </ul>
                    275:
                    276: <p>
1.6       miod      277: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
1.1       deraadt   278: <ul>
                    279: <p>
                    280: The 3.1 release of OpenBSD/sparc is located on CD3. To boot off of this CD you can use one of the two commands listed below, depending on the version of your ROM.
                    281:
                    282: <ul><pre>
                    283: > <strong>boot cdrom 3.1/sparc/bsd.rd</strong>
                    284: or
                    285: > <strong>b sd(0,6,0)3.1/sparc/bsd.rd</strong>
                    286: </pre></ul>
                    287:
                    288: <p>
                    289: If your sparc does not have a CD drive, you can alternatively boot from floppy. To do so you need to write &quot;CD3:3.1/sparc/floppy31.fs&quot; to a floppy. For more information see <a href="faq/faq4.html#4.1">FAQ4.1</a>. To boot from the floppy use one of the two commands listed below, depending on the version of your ROM.
                    290:
                    291: <ul><pre>
                    292: > <strong>boot floppy</strong>
                    293: or
                    294: > <strong>boot fd()</strong>
                    295: </pre></ul>
                    296:
                    297: <p>
                    298: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
                    299:
                    300: <p>
                    301: If your sparc doesn't have a floppy drive nor a CD drive, you can either
                    302: setup a bootable tape, or install via network, as told in the
                    303: INSTALL.sparc file.
                    304: </ul>
                    305:
                    306: <p>
1.6       miod      307: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
1.1       deraadt   308: <ul>
                    309: <p>
                    310: Put the CD3 in your CDROM drive and type <i>boot cdrom</i>.
                    311:
                    312: <p>
                    313: If this doesn't work, or if you don't have a CDROM drive, you can write
                    314: <i>CD3:3.1/sparc64/floppy31.fs</i> to a floppy and boot it with <i>boot
                    315: floppy</i>.<br>
                    316: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
                    317:
                    318: <p>
                    319: You can also write <i>CD3:3.1/sparc64/miniroot31.fs</i> to the swap partition on
                    320: the disk and boot with <i>boot disk:b</i>.
                    321:
                    322: <p>
                    323: If nothing works, you can boot over the network as described in INSTALL.sparc64
                    324: </ul>
                    325:
                    326: <p>
1.6       miod      327: <h3><font color="#e00000">Notes about the source code:</font></h3>
1.1       deraadt   328: <ul>
                    329: <p>
                    330: src.tar.gz contains a source archive starting at /usr/src.  This file
                    331: contains everything you need except for the kernel sources, which are
                    332: in a separate archive.  To extract:
                    333: <p>
                    334: <ul><pre>
                    335: # <strong>mkdir -p /usr/src</strong>
                    336: # <strong>cd /usr/src</strong>
                    337: # <strong>tar xvfz /tmp/src.tar.gz</strong>
                    338: </pre></ul>
                    339: <p>
                    340: srcsys.tar.gz contains a source archive starting at /usr/src/sys.
                    341: This file contains all the kernel sources you need to rebuild kernels.
                    342: To extract:
                    343: <p>
                    344: <ul><pre>
                    345: # <strong>mkdir -p /usr/src/sys</strong>
                    346: # <strong>cd /usr/src</strong>
                    347: # <strong>tar xvfz /tmp/srcsys.tar.gz</strong>
                    348: </pre></ul>
                    349: <p>
                    350: Both of these trees are a regular CVS checkout.  Using these trees it
                    351: is possible to get a head-start on using the anoncvs servers as
                    352: described at <a href=anoncvs.html>http://www.OpenBSD.org/anoncvs.html</a>.
                    353: Using these files
                    354: results in a much faster initial CVS update than you could expect from
                    355: a fresh checkout of the full OpenBSD source tree.
                    356: <p>
                    357: </ul>
1.6       miod      358: <a name="ports"></a>
1.1       deraadt   359: <hr>
                    360: <p>
1.6       miod      361: <h3><font color="#0000e0">Ports Tree</font></h3>
1.1       deraadt   362: <p>
                    363: A ports tree archive is also provided.  To extract:
                    364: <p>
                    365: <ul><pre>
                    366: # <strong>cd /usr</strong>
                    367: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
                    368: # <strong>cd ports</strong>
                    369: </pre></ul>
                    370: <p>
                    371: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree.  Go
1.18      jasper    372: read <a href="faq/faq15.html">http://www.OpenBSD.org/faq/faq15.html</a>
1.1       deraadt   373: if you know nothing about ports
                    374: at this point.  This text is not a manual of how to use ports.
                    375: Rather, it is a set of notes meant to kickstart the user on the
                    376: OpenBSD ports system.
                    377: <p>
                    378: Certainly, the OpenBSD ports system is not complete.  It is doubtful it
                    379: will ever be. However, it is growing very fast and getting more stable.
                    380: Almost all ports provided with this release should build without problems
1.3       miod      381: on most architectures (over 1500 packages build on i386, for instance).
1.1       deraadt   382: <p>
                    383: The <i>ports/</i> directory represents a CVS (see the manpage for
                    384: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&apropos=0&sektion=1&manpath=OpenBSD+Current&arch=i386&format=html">
                    385: cvs(1)</a> if
                    386: you aren't familiar with CVS) checkout of our ports.  As with our complete
                    387: source tree, our ports tree is available via anoncvs.  So, in
                    388: order to keep current with it, you must make the <i>ports/</i> tree
                    389: available on a read-write medium and update the tree with a command
                    390: like:
                    391: <p>
                    392: <ul><pre>
1.17      deraadt   393: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_1</strong>
1.1       deraadt   394: </pre></ul>
                    395: <p>
                    396: [Of course, you must replace the local directory and server name here
                    397: with the location of your ports collection and a nearby anoncvs
                    398: server.]
                    399: <p>
                    400: Note that most ports are available as packages through ftp. Updated
                    401: packages for the 3.1 release will be made available if problems arise.
                    402: <p>
                    403: If you're interested in seeing a port added, would like to help out, or just
                    404: would like to know more, the mailing list ports@openbsd.org is a good
                    405: place to know.
                    406: <p>
                    407:
                    408: </body>
                    409: </html>