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