Annotation of www/33.html, Revision 1.38
1.27 david 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1.1 miod 2: <html>
3: <head>
1.36 deraadt 4: <title>OpenBSD 3.3</title>
1.1 miod 5: <meta name="resource-type" content="document">
6: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7: <meta name="description" content="OpenBSD 3.3">
8: <meta name="keywords" content="openbsd,main">
9: <meta name="distribution" content="global">
10: <meta name="copyright" content="This document copyright 2003 by OpenBSD.">
11: </head>
12:
13: <body bgcolor="#ffffff" text="#000000" link="#24248E">
14:
15: <a href="index.html">
16: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
1.38 ! deraadt 17: <p>
1.1 miod 18:
1.5 deraadt 19: <a href="images/Barbarian.gif">
20: <img align="left" width="255" height="343" hspace="24"
21: src="images/Barbarian.gif" alt="OpenBSD 3.3 logo"></a>
1.36 deraadt 22: <h2><font color="#0000e0">OpenBSD 3.3</font></h2>
1.1 miod 23: <p>
24:
25: Released May 1, 2003<br>
26: Copyright 1997-2003, Theo de Raadt.<br>
27: <font color="#e00000">ISBN 0-9731791-1-2</font>
1.32 deraadt 28: <br>
29: <a href="lyrics.html#33">3.3 Song: "Puff the Barbarian"</a>
1.1 miod 30: <p>
31: <ul>
32: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
33: <li>See the information on <a href="ftp.html">The FTP page</a> for
34: a list of mirror machines.
35: <li>Go to the <font color="#e00000">pub/OpenBSD/3.3/</font> directory on
36: one of the mirror sites.
37: <li>Briefly read the rest of this document.
1.31 david 38: <li>Have a look at <a href="errata33.html">The 3.3 Errata page</a> for a list
1.1 miod 39: of bugs and workarounds.
1.14 deraadt 40: <li>See a <a href="plus33.html">detailed log of changes</a> between the
1.1 miod 41: 3.2 and 3.3 releases.
42: </ul>
43: <br clear=all>
1.37 deraadt 44: <p>
1.36 deraadt 45: All applicable copyrights and credits can be found in the applicable
46: file sources found in the files src.tar.gz, sys.tar.gz,
47: xenocara.tar.gz, or in the files fetched via ports.tar.gz. The
48: distribution files used to build packages from the ports.tar.gz file
49: are not included on the CDROM because of lack of space.
1.1 miod 50: <p>
51:
52: <a name="new"></a>
53: <hr>
54: <p>
55: <h3><font color="#0000e0">What's New</font></h3>
56: <p>
57: This is a partial list of new features and systems included in OpenBSD 3.3.
1.18 deraadt 58: For a comprehensive list, see the <a href="plus33.html">changelog</a> leading
1.1 miod 59: to 3.3.
60: <p>
61:
62: <ul>
63: <li>Integration of the
1.30 david 64: <a href="http://www.research.ibm.com/trl/projects/security/ssp/">ProPolice</a>
1.26 deraadt 65: stack protection technology, by Hiroaki Etoh, into the system
66: compiler. This protection is enabled by default. With this change,
67: function prologues are modified to rearrange the stack: a random
68: canary is placed before the return address, and buffer variables are
69: moved closer to the canary so that regular variables are below, and
70: harder to smash. The function epilogue then checks if the canary is
71: still intact. If it is not, the process is terminated. This change
72: makes it very hard for an attacker to modify the return address used
73: when returning from a function.
1.2 deraadt 74: <p>
1.1 miod 75:
1.22 deraadt 76: <li>W^X (pronounced: "W xor X") on architectures capable of
1.10 deraadt 77: pure execute-bit support in the MMU (sparc, sparc64, alpha,
78: hppa). This is a fine-grained memory permissions layout, ensuring that
79: memory which can be written to by application programs can not be
1.22 deraadt 80: executable at the same time and vice versa. This raises the bar on
81: potential buffer overflows and other attacks: as a result, an attacker
82: is unable to write code anywhere in memory where it can be executed.
1.26 deraadt 83: (NOTE: i386 and powerpc do not support W^X in 3.3; however, 3.3-current
84: already supports it on i386, and both these processors are expected to
85: support this change in 3.4).
1.1 miod 86: <p>
87:
1.2 deraadt 88: <li>Still more reduction in setuid and setgid binaries, and more chroot
1.22 deraadt 89: use throughout the system. While some programs are still setuid or
90: setgid, almost all of them grab a resource and then quickly revoke
91: privilege.
1.1 miod 92: <p>
93:
1.22 deraadt 94: <li>The X window server and xconsole now use privilege separation,
95: for better security. Also, xterm has been modified to do privilege
96: revocation. xdm runs as a special user and group, to further constrain
97: what might go wrong.
1.1 miod 98: <p>
99:
100: <li>As usual, improvements to the documentation, notably the man pages and
1.7 jsyn 101: the Web FAQ. An increasingly large part of the website is available in several
1.1 miod 102: languages.
103: <p>
104:
105: <li>More complete collection and better tested set of "ports".
106: setuid/setgid ports have been significantly reduced as well. Many of the
107: ones that remain setuid have been modified to revoke privileges as early
108: as possible.
109: <p>
110:
111: <li>Over 2000 pre-built and tested packages.
112: <p>
113:
114: <li>Significant improvements to the pthread library.
115: <p>
116:
117: <li>An incredible amount of enhancements and stability improvements to
118: our packet filter, <a
119: href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf&sektion=4">pf</a>,
1.8 henning 120: including:
1.1 miod 121: <ul>
1.17 deraadt 122: <li>Queue, a bandwidth management system (uses altq underneath)
123: <li>Anchors, allowing subrulesets which can be loaded and modified independently
124: <li>Tables, a very efficient way for large address lists in rules
125: <li>Address pools, redirect/NAT to multiple addresses and thus load balancing
126: <li>Configuration language has been made much more flexible
127: <li>TCP window scaling support
128: <li>Full CIDR support
129: <li>Early checksum verification return on invalid packets
130: <li>Performance boost: large rulesets load much faster now
1.22 deraadt 131: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=spamd">spamd</a>,
132: a spam deferral daemon, which SMTP connections can be redirected to.
133: This daemon handles connections based on black lists and white lists,
134: tar-pits the connections, and ensures that the spammer knows why their
135: mail has not been accepted.
1.1 miod 136: </ul>
1.11 jason 137:
138: <p>
139:
140: <li>Much improved <a href="sparc64.html">sparc64</a> support: support for
1.13 miod 141: more models and several major bugs eradicated.
1.8 henning 142:
1.1 miod 143: <p>
144:
145: <li>The system includes the following major components from outside suppliers:
146: <ul>
147: <li>XFree86 4.2.1 (and i386 contains 3.3.X servers also, thus providing support for all chipsets)
1.4 miod 148: <li>Gcc 2.95.3 (+ patches)
149: <li>Perl 5.8.0 (+ patches)
1.3 henning 150: <li>Apache 1.3.27, mod_ssl 2.8.12, DSO support (+ patches)
1.1 miod 151: <li>OpenSSL 0.9.7beta3 (+ patches)
1.4 miod 152: <li>Groff 1.15
1.24 miod 153: <li>Sendmail 8.12.9
1.4 miod 154: <li>Bind 9.2.2 (+ patches)
1.23 margarid 155: <li>Lynx 2.8.2rel.1 with HTTPS support added (+ patches)
1.4 miod 156: <li>Sudo 1.6.7
157: <li>Ncurses 5.2
1.1 miod 158: <li>Latest KAME IPv6
1.12 hin 159: <li>KTH Kerberos 1.1.1
1.1 miod 160: <li>Heimdal 0.4e (+ patches)
161: <li>OpenSSH 3.6
162: </ul>
163: <p>
164:
165: <li>Many improvements for security and reliability (look for the red
1.18 deraadt 166: print in the <a href="plus33.html">complete changelog</a>).
1.1 miod 167: <p>
1.11 jason 168: <li> and much more.
169:
1.1 miod 170: </ul>
171:
172: <a name="install"></a>
173: <hr>
174: <p>
175: <h3><font color="#0000e0">How to install</font></h3>
176: <p>
177: Following this are the instructions which you would have on a piece of
178: paper if you had purchased a CDROM set instead of doing an alternate
179: form of install. The instructions for doing an ftp (or other style
180: of) install are very similar; the CDROM instructions are left intact
181: so that you can see how much easier it would have been if you had
182: purchased a CDROM instead.
183: <p>
184:
185: <hr>
1.15 drahn 186: Please refer to the following files on the three CDROMs or ftp mirror for
187: extensive details on how to install OpenBSD 3.3 on your machine:
1.1 miod 188: <p>
189: <ul>
190: <li> CD1:3.3/i386/INSTALL.i386
191: <p>
192: <li> CD2:3.3/macppc/INSTALL.macppc
193: <li> CD2:3.3/vax/INSTALL.vax
194: <p>
195: <li> CD3:3.3/sparc/INSTALL.sparc
196: <li> CD3:3.3/sparc64/INSTALL.sparc64
1.15 drahn 197: <p>
198: <li> FTP:.../OpenBSD/3.3/alpha/INSTALL.alpha
199: <li> FTP:.../OpenBSD/3.3/hp300/INSTALL.hp300
1.20 mickey 200: <li> FTP:.../OpenBSD/3.3/hppa/INSTALL.hppa
1.15 drahn 201: <li> FTP:.../OpenBSD/3.3/mac68k/INSTALL.mac68k
202: <li> FTP:.../OpenBSD/3.3/mvme68k/INSTALL.mvme68k
1.1 miod 203: </ul>
204: <hr>
205:
206: <p>
207: Quick installer information for people familiar with OpenBSD, and the
208: use of the "disklabel -E" command. If you are at all confused when
209: installing OpenBSD, read the relevant INSTALL.* file as listed above!
210: <p>
211:
212: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
213: <ul>
214: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
215: release is on CD1. If your BIOS does not support booting from CD, you will need
216: to create a boot floppy to install from. To create a boot floppy write
217: <i>CD1:3.3/i386/floppy33.fs</i> to a floppy and boot via the floppy drive.
218:
219: <p>
220: Use <i>CD1:3.3/i386/floppyB33.fs</i> instead for greater scsi controller
221: support, or <i>CD1:3.3/i386/floppyC33.fs</i> for better laptop support.
222:
223: <p>
224: If you are planning on dual booting OpenBSD with another OS, you will need to read the included INSTALL.i386 document.
225:
226: <p>
227: To make a boot floppy under MS-DOS, use the "rawrite" utility located
228: at <i>CD:/3.3/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".
229:
230: <ul><pre>
231: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
232: </pre></ul>
233:
234: <p>
1.18 deraadt 235: 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#MkFlop">FAQ4.1</a>.
1.1 miod 236: </ul>
237:
238: <p>
239: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
240: <ul>
241: Put the CD2 in your CDROM drive and poweron your machine while holding down the
242: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
243:
244: <p>
245: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
246: /3.3/macppc/bsd.rd</i>
247: </ul>
248:
249: <p>
250: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
251: <ul>
252: Boot over the network via mopbooting as described in INSTALL.vax.
253: </ul>
254:
255: <p>
256: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
257: <ul>
258: The 3.3 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.
259:
260: <ul><pre>
261: > <strong>boot cdrom 3.3/sparc/bsd.rd</strong>
262: or
263: > <strong>b sd(0,6,0)3.3/sparc/bsd.rd</strong>
264: </pre></ul>
265:
266: <p>
267: If your sparc does not have a CD drive, you can alternatively boot from floppy.
1.18 deraadt 268: To do so you need to write "CD3:3.3/sparc/floppy33.fs" to a floppy. For more information see <a href="faq/faq4.html#MkFlop">FAQ4.1</a>. To boot from the floppy use one of the two commands listed below, depending on the version of your ROM.
1.1 miod 269:
270: <ul><pre>
271: > <strong>boot floppy</strong>
272: or
273: > <strong>boot fd()</strong>
274: </pre></ul>
275:
276: <p>
277: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
278:
279: <p>
280: If your sparc doesn't have a floppy drive nor a CD drive, you can either
281: setup a bootable tape, or install via network, as told in the
282: INSTALL.sparc file.
283: </ul>
284:
285: <p>
286: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
287: <ul>
288: Put the CD3 in your CDROM drive and type <i>boot cdrom</i>.
289:
290: <p>
291: If this doesn't work, or if you don't have a CDROM drive, you can write
292: <i>CD3:3.3/sparc64/floppy33.fs</i> to a floppy and boot it with <i>boot
293: floppy</i>.<br>
294: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
295:
296: <p>
297: You can also write <i>CD3:3.3/sparc64/miniroot33.fs</i> to the swap partition on
298: the disk and boot with <i>boot disk:b</i>.
299:
300: <p>
301: If nothing works, you can boot over the network as described in INSTALL.sparc64
302: </ul>
303:
304: <p>
1.15 drahn 305: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
306: <ul>
307: <p>Write <i>FTP:3.3/alpha/floppy33.fs</i> or
308: <i>FTP:3.3/alpha/floppyB33.fs</i> (depending on your machine) to a diskette and
309: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
310:
311: <p>
312: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install will most likely fail.
313:
314: </ul>
315:
316: <p>
317: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
318: <ul>
319: <p>
320: Boot over the network by following the instructions in INSTALL.hp300.
321: </ul>
322:
323: <p>
1.28 miod 324: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
325: <ul>
326: <p>
327: Boot over the network by following the instructions in INSTALL.hppa or the
328: <a href="hppa.html#netboot">hppa platform page</a>.
329: </ul>
330:
331: <p>
1.15 drahn 332: <h3><font color="#e00000">OpenBSD/mac68k:</font></h3>
333: <ul>
334: <p>
335: Boot MacOS as normal and partition your disk with the appropriate A/UX
336: configurations. Then, extract the Macside utilities from
1.25 nick 337: <i>FTP:3.3/mac68k/utils</i> onto your hard disk. Run Mkfs to create your
1.15 drahn 338: filesystems on the A/UX partitions you just made. Then, use the
1.25 nick 339: "BSD/Mac68k Installer" to copy all the sets in <i>FTP:3.3/mac68k/</i> onto your
340: partitions. Finally, you will be ready to configure the "BSD/Mac68k
341: Booter" with the location of your kernel and boot the system.
1.15 drahn 342: </ul>
343:
344: <p>
345: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
346: <ul>
347: <p>
348: You can create a bootable installation tape or boot over the network.<br>
349: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
350: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
351: for more details.
352: </ul>
353:
354: <p>
1.1 miod 355: <h3><font color="#e00000">Notes about the source code:</font></h3>
356: <ul>
357: src.tar.gz contains a source archive starting at /usr/src. This file
358: contains everything you need except for the kernel sources, which are
359: in a separate archive. To extract:
360: <p>
361: <ul><pre>
362: # <strong>mkdir -p /usr/src</strong>
363: # <strong>cd /usr/src</strong>
364: # <strong>tar xvfz /tmp/src.tar.gz</strong>
365: </pre></ul>
366: <p>
1.29 pb 367: sys.tar.gz contains a source archive starting at /usr/src/sys.
1.1 miod 368: This file contains all the kernel sources you need to rebuild kernels.
369: To extract:
370: <p>
371: <ul><pre>
372: # <strong>mkdir -p /usr/src/sys</strong>
373: # <strong>cd /usr/src</strong>
1.29 pb 374: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
1.1 miod 375: </pre></ul>
376: <p>
377: Both of these trees are a regular CVS checkout. Using these trees it
378: is possible to get a head-start on using the anoncvs servers as
1.18 deraadt 379: described <a href="anoncvs.html">here</a>.
1.1 miod 380: Using these files
381: results in a much faster initial CVS update than you could expect from
382: a fresh checkout of the full OpenBSD source tree.
383: <p>
384: </ul>
385: <a name="ports"></a>
386: <hr>
387: <p>
388: <h3><font color="#0000e0">Ports Tree</font></h3>
389: <p>
390: A ports tree archive is also provided. To extract:
391: <p>
392: <ul><pre>
393: # <strong>cd /usr</strong>
394: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
395: # <strong>cd ports</strong>
396: </pre></ul>
397: <p>
398: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
1.34 jasper 399: read the <a href="faq/faq15.html">ports</a> page
1.1 miod 400: if you know nothing about ports
401: at this point. This text is not a manual of how to use ports.
402: Rather, it is a set of notes meant to kickstart the user on the
403: OpenBSD ports system.
404: <p>
405: Certainly, the OpenBSD ports system is not complete. It is doubtful it
406: will ever be. However, it is growing very fast and getting more stable.
407: Almost all ports provided with this release should build without problems
408: on most architectures (over 2000 packages build on i386, for instance).
409: <p>
410: The <i>ports/</i> directory represents a CVS (see the manpage for
411: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&apropos=0&sektion=1&manpath=OpenBSD+Current&arch=i386&format=html">
412: cvs(1)</a> if
413: you aren't familiar with CVS) checkout of our ports. As with our complete
414: source tree, our ports tree is available via anoncvs. So, in
415: order to keep current with it, you must make the <i>ports/</i> tree
416: available on a read-write medium and update the tree with a command
417: like:
418: <p>
419: <ul><pre>
1.33 deraadt 420: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_3</strong>
1.1 miod 421: </pre></ul>
422: <p>
423: [Of course, you must replace the local directory and server name here
424: with the location of your ports collection and a nearby anoncvs
425: server.]
426: <p>
427: Note that most ports are available as packages through ftp. Updated
428: packages for the 3.3 release will be made available if problems arise.
429: <p>
430: If you're interested in seeing a port added, would like to help out, or just
431: would like to know more, the mailing list ports@openbsd.org is a good
432: place to know.
433: <p>
434:
435: </body>
436: </html>