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