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