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