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