Annotation of www/31.html, Revision 1.27
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.6 miod 5: <meta name="description" content="OpenBSD 3.1">
1.1 deraadt 6: <meta name="copyright" content="This document copyright 1999-2002 by OpenBSD.">
1.26 sthen 7: <link rel="canonical" href="http://www.openbsd.org/31.html">
1.1 deraadt 8: </head>
9:
1.15 david 10: <body bgcolor="#ffffff" text="#000000" link="#24248e">
1.1 deraadt 11:
1.13 jufi 12: <a href="index.html">
13: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
1.22 deraadt 14: <p>
1.1 deraadt 15:
1.20 deraadt 16: <a href=images/Systemagic.jpg>
17: <img align="left" width="255" height="323" hspace="24"
18: src="images/Systemagic.jpg"></a>
19: <h2><font color="#0000e0">OpenBSD 3.1</font></h2>
1.1 deraadt 20: <p>
1.11 jsyn 21: Released May 19, 2002<br>
1.1 deraadt 22: Copyright 1997-2002, Theo de Raadt.<br>
1.6 miod 23: <font color="#e00000">ISBN 0-9683637-9-2</font>
1.16 deraadt 24: <br>
25: <a href="lyrics.html#31">3.1 Song: "Systemagic"</a>
1.1 deraadt 26: <p>
27: <ul>
1.25 deraadt 28: <li>Order a CDROM from our <a href="https://openbsdstore.com">ordering system</a>.
1.6 miod 29: <li>See the information on <a href="ftp.html">The FTP page</a> for
1.1 deraadt 30: a list of mirror machines.
1.6 miod 31: <li>Go to the <font color="#e00000">pub/OpenBSD/3.1/</font> directory on
1.1 deraadt 32: one of the mirror sites.
1.14 deraadt 33: <li>Have a look at <a href="errata31.html">The 3.1 Errata page</a> for a list
1.1 deraadt 34: of bugs and workarounds.
1.6 miod 35: <li>See a <a href="plus31.html">detailed log of changes</a> between the
1.1 deraadt 36: 3.0 and 3.1 releases.
37: </ul>
38: <br clear=all>
1.21 deraadt 39: <p>
1.20 deraadt 40: All applicable copyrights and credits can be found in the applicable
1.24 jsg 41: file sources found in the files src.tar.gz, srcsys.tar.gz,
42: XF4.tar.gz, or in the files fetched via ports.tar.gz. The
1.20 deraadt 43: distribution files used to build packages from the ports.tar.gz file
44: are not included on the CDROM because of lack of space.
1.1 deraadt 45: <p>
46:
1.6 miod 47: <a name="new"></a>
1.1 deraadt 48: <hr>
49: <p>
1.6 miod 50: <h3><font color="#0000e0">What's New</font></h3>
1.1 deraadt 51: <p>
52: This is a partial list of new features and systems included in OpenBSD 3.1.
1.6 miod 53: For a comprehensive list, see the <a href="plus31.html">changelog</a> leading
1.1 deraadt 54: to 3.1.
55: <p>
56:
57: <ul>
58: <li><a href="http://www.OpenSSH.com">OpenSSH</a> (supporting both the
59: SSH1 and SSH2 protocols) is now at version 3.2. Secure file transfers are
1.7 miod 60: encouraged using the greatly enhanced SFTP subsystem which comes both with
1.1 deraadt 61: an SFTP server and client.
62: <p>
63:
1.5 miod 64: <li>As usual, improvements to the documentation, notably the man pages and
65: the Web FAQ. A larger part of the website is now available in several
66: languages.
1.1 deraadt 67: <p>
68:
69: <li>More complete collection and better tested set of "ports".
70: <p>
71:
72: <li>Over 1000 pre-built and tested packages.
73: <p>
74:
1.5 miod 75: <li>Greatly improved hardware support in the
76: <a href="sparc64.html">OpenBSD/sparc64</a> port, and the addition of X11
77: support.
1.1 deraadt 78: <p>
79:
1.5 miod 80: <li>Numerous performance improvements to the <a
81: href="macppc.html">OpenBSD/macppc</a> port, as well as accelerated X11 servers
82: for some models.
83: <p>
84:
85: <li>A lot of enhancements to our new packet filter, <a
1.7 miod 86: href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf&sektion=4">pf</a>,
87: including performance improvements, as well as the ability to filter other
88: protocols than the usual tcp, udp and icmp, such as esp.
89: <p>
90:
91: <li>An utility to achieve per-user pf rules changes, typically intended for
92: gateways, <a
93: href="http://www.openbsd.org/cgi-bin/man.cgi?query=authpf&sektion=8">authpf</a>.
94: <p>
95:
1.10 tdeval 96: <li>The in-kernel software <a
97: href="http://www.openbsd.org/cgi-bin/man.cgi?query=raid&sektion=4">raid</a>
98: (RAIDframe) can now automatically detect and configure its raid devices at boot.
99: Taking advantage of this, the system can have its root partition directly
100: mounted from an auto-detected raid partition.
101: <p>
102:
1.7 miod 103: <li>Wavelan bridging is now possible on Prism-II based cards.
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>
1.8 miod 184: 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 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: </ul>
221:
222: <p>
1.6 miod 223: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
1.1 deraadt 224: <ul>
225: <p>
226: Put the CD4 in your CDROM drive and press the spacebar during the poweron
227: self-test. Enter the boot choice that corresponds to <i>SYS_CDBOOT</i>.
228:
229: <p>
230: Alternatively, you can boot over the network by following the instructions in
231: INSTALL.hp300.
232: </ul>
233:
234: <p>
1.6 miod 235: <h3><font color="#e00000">OpenBSD/amiga:</font></h3>
1.1 deraadt 236: <ul>
237: <p>
238: Create BSD partitions according to INSTALL.amiga's preparation section.
239: Mount the CD4 under AmigaOS as device CD0: Next, execute the following
240: CLI command: "CD0:3.1/amiga/utils/loadbsd CD0:3.1/amiga/bsd.rd".
241: </ul>
242:
243: <p>
1.6 miod 244: <h3><font color="#e00000">OpenBSD/mac68k:</font></h3>
1.1 deraadt 245: <ul>
246: <p>
247: Boot MacOS as normal and partition your disk with the appropriate A/UX
248: configurations. Then, extract the Macside utilities from
249: CD4:3.1/mac68k/utils onto your hard disk. Run Mkfs to create your
250: filesystems on the A/UX partitions you just made. Then, use the
251: BSD/Mac68k Installer to copy all the sets in CD4:3.1/mac68k/ onto your
252: partitions. Finally, you will be ready to configure the BSD/Mac68k
253: Booter with the location of your kernel and boot the system.
254: </ul>
255:
256: <p>
1.6 miod 257: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
1.1 deraadt 258: <ul>
259: <p>
260: You can create a bootable installation tape or boot over the network.<br>
261: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
262: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
263: for more details.
264: </ul>
265:
266: <p>
1.6 miod 267: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
1.1 deraadt 268: <ul>
269: <p>
270: Boot over the network via mopbooting as described in INSTALL.vax.
271: </ul>
272:
273: <p>
1.6 miod 274: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
1.1 deraadt 275: <ul>
276: <p>
277: 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.
278:
279: <ul><pre>
280: > <strong>boot cdrom 3.1/sparc/bsd.rd</strong>
281: or
282: > <strong>b sd(0,6,0)3.1/sparc/bsd.rd</strong>
283: </pre></ul>
284:
285: <p>
286: 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.
287:
288: <ul><pre>
289: > <strong>boot floppy</strong>
290: or
291: > <strong>boot fd()</strong>
292: </pre></ul>
293:
294: <p>
295: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
296:
297: <p>
298: If your sparc doesn't have a floppy drive nor a CD drive, you can either
299: setup a bootable tape, or install via network, as told in the
300: INSTALL.sparc file.
301: </ul>
302:
303: <p>
1.6 miod 304: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
1.1 deraadt 305: <ul>
306: <p>
307: Put the CD3 in your CDROM drive and type <i>boot cdrom</i>.
308:
309: <p>
310: If this doesn't work, or if you don't have a CDROM drive, you can write
311: <i>CD3:3.1/sparc64/floppy31.fs</i> to a floppy and boot it with <i>boot
312: floppy</i>.<br>
313: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
314:
315: <p>
316: You can also write <i>CD3:3.1/sparc64/miniroot31.fs</i> to the swap partition on
317: the disk and boot with <i>boot disk:b</i>.
318:
319: <p>
320: If nothing works, you can boot over the network as described in INSTALL.sparc64
321: </ul>
322:
323: <p>
1.6 miod 324: <h3><font color="#e00000">Notes about the source code:</font></h3>
1.1 deraadt 325: <ul>
326: <p>
327: src.tar.gz contains a source archive starting at /usr/src. This file
328: contains everything you need except for the kernel sources, which are
329: in a separate archive. To extract:
330: <p>
331: <ul><pre>
332: # <strong>mkdir -p /usr/src</strong>
333: # <strong>cd /usr/src</strong>
334: # <strong>tar xvfz /tmp/src.tar.gz</strong>
335: </pre></ul>
336: <p>
337: srcsys.tar.gz contains a source archive starting at /usr/src/sys.
338: This file contains all the kernel sources you need to rebuild kernels.
339: To extract:
340: <p>
341: <ul><pre>
342: # <strong>mkdir -p /usr/src/sys</strong>
343: # <strong>cd /usr/src</strong>
344: # <strong>tar xvfz /tmp/srcsys.tar.gz</strong>
345: </pre></ul>
346: <p>
347: Both of these trees are a regular CVS checkout. Using these trees it
348: is possible to get a head-start on using the anoncvs servers as
349: described at <a href=anoncvs.html>http://www.OpenBSD.org/anoncvs.html</a>.
350: Using these files
351: results in a much faster initial CVS update than you could expect from
352: a fresh checkout of the full OpenBSD source tree.
353: <p>
354: </ul>
1.6 miod 355: <a name="ports"></a>
1.1 deraadt 356: <hr>
357: <p>
1.6 miod 358: <h3><font color="#0000e0">Ports Tree</font></h3>
1.1 deraadt 359: <p>
360: A ports tree archive is also provided. To extract:
361: <p>
362: <ul><pre>
363: # <strong>cd /usr</strong>
364: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
365: # <strong>cd ports</strong>
366: </pre></ul>
367: <p>
368: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
1.18 jasper 369: read <a href="faq/faq15.html">http://www.OpenBSD.org/faq/faq15.html</a>
1.1 deraadt 370: if you know nothing about ports
371: at this point. This text is not a manual of how to use ports.
372: Rather, it is a set of notes meant to kickstart the user on the
373: OpenBSD ports system.
374: <p>
375: Certainly, the OpenBSD ports system is not complete. It is doubtful it
376: will ever be. However, it is growing very fast and getting more stable.
377: Almost all ports provided with this release should build without problems
1.3 miod 378: on most architectures (over 1500 packages build on i386, for instance).
1.1 deraadt 379: <p>
380: The <i>ports/</i> directory represents a CVS (see the manpage for
381: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&apropos=0&sektion=1&manpath=OpenBSD+Current&arch=i386&format=html">
382: cvs(1)</a> if
383: you aren't familiar with CVS) checkout of our ports. As with our complete
384: source tree, our ports tree is available via anoncvs. So, in
385: order to keep current with it, you must make the <i>ports/</i> tree
386: available on a read-write medium and update the tree with a command
387: like:
388: <p>
389: <ul><pre>
1.17 deraadt 390: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_1</strong>
1.1 deraadt 391: </pre></ul>
392: <p>
393: [Of course, you must replace the local directory and server name here
394: with the location of your ports collection and a nearby anoncvs
395: server.]
396: <p>
397: Note that most ports are available as packages through ftp. Updated
398: packages for the 3.1 release will be made available if problems arise.
399: <p>
400: If you're interested in seeing a port added, would like to help out, or just
401: would like to know more, the mailing list ports@openbsd.org is a good
402: place to know.
403: <p>
404:
405: </body>
406: </html>