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