Annotation of www/34.html, Revision 1.20
1.1 david 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 3.4 Release</title>
5: <link rev=made href="mailto:www@openbsd.org">
6: <meta name="resource-type" content="document">
7: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
8: <meta name="description" content="OpenBSD 3.4">
9: <meta name="keywords" content="openbsd,main">
10: <meta name="distribution" content="global">
11: <meta name="copyright" content="This document copyright 2003 by OpenBSD.">
12: </head>
13:
14: <body bgcolor="#ffffff" text="#000000" link="#24248E">
15:
16: <a href="index.html">
17: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
18: <hr>
19:
20: <p>
21: <a href="images/Hood.gif">
22: <img align="left" width="255" height="343" hspace="24"
23: src="images/Hood.gif" alt="OpenBSD 3.4 logo"></a>
24: <h2><font color="#0000e0">The OpenBSD 3.4 Release:</font></h2>
25: <p>
26:
27: Released Nov 1, 2003<br>
28: Copyright 1997-2003, Theo de Raadt.<br>
29: <font color="#e00000">ISBN 0-9731791-2-0</font>
30: <p>
31:
32: <a href="#new">What's New</a><br>
33: <a href="#install">How to install</a><br>
34: <a href="#ports">How to use the ports tree</a><br>
35: <a href="orders.html">Ordering a CD set</a><br>
36:
37: <p>
38: <h3><font color="#0000e0">
39: To get the files for this release:
40: <ul>
41: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
42: <li>See the information on <a href="ftp.html">The FTP page</a> for
1.8 david 43: a list of mirror machines.
1.1 david 44: <li>Go to the <font color="#e00000">pub/OpenBSD/3.4/</font> directory on
1.8 david 45: one of the mirror sites.
1.1 david 46: <li>Briefly read the rest of this document.
47: <li>Have a look at <a href="errata.html">The 3.4 Errata page</a> for a list
1.8 david 48: of bugs and workarounds.
1.1 david 49: <li>See a <a href="plus.html">detailed log of changes</a> between the
1.8 david 50: 3.3 and 3.4 releases.
1.1 david 51: </ul>
52: </font></h3>
53: <br clear=all>
54: <br>
55: <p>
56:
57: <strong>Note:</strong> All applicable copyrights and credits can be found
58: in the applicable file sources found in the files src.tar.gz, sys.tar.gz,
59: XF4.tar.gz, or in the files fetched via ports.tar.gz. The distribution
60: files used to build packages from the ports.tar.gz file are not included on
61: the CDROM because of lack of space.
62: <p>
63:
64: <a name="new"></a>
65: <hr>
66: <p>
67: <h3><font color="#0000e0">What's New</font></h3>
68: <p>
69: This is a partial list of new features and systems included in OpenBSD 3.4.
70: For a comprehensive list, see the <a href="plus.html">changelog</a> leading
71: to 3.4.
72: <p>
73:
74: <ul>
75:
1.13 david 76: <li>The i386 architecture has been switched to the ELF executable format so
77: i386 upgrades are not possible for this release.
1.1 david 78: <p>
79:
1.6 tedu 80: <li>Further W^X improvements, including support for the i386 architecture.
81: Native i386 binaries have their executable segments rearranged to support
1.14 deraadt 82: isolating code from data, and the cpu CS limit is used to impose a best
83: effort limit on code execution.
1.1 david 84: <p>
85:
1.20 ! deraadt 86: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ld.so">ld.so(1)</a>
! 87: on ELF platforms now loads libraries in a random order for
1.14 deraadt 88: greater resistance to attacks. The i386 architecture also maps libraries
89: somewhat randomized addresses. Together with W^X and ProPolice, these
90: changes increase the difficulty of successfully exploiting an application
91: error, such as a buffer overflow.
1.1 david 92: <p>
93:
94: <li>A static bounds checker has been added to the compiler to perform basic
1.4 avsm 95: checks on functions which accept buffers and sizes. The checker aims to
1.8 david 96: find common mistakes in the use of library functions such as
1.4 avsm 97: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strlcpy">strlcpy(3)</a>
98: or <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sscanf">sscanf(3)</a>
99: without emitting any false positives. Running it over the source and ports
100: trees revealed over a hundred real bugs, which were fixed and submitted back
101: to the original authors where possible.
1.1 david 102: <p>
103:
1.20 ! deraadt 104: <li>Privilege separation has been implemented for the
! 105: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=syslogd">syslogd(8)</a>
! 106: daemon, making
1.6 tedu 107: it much more robust against future errors. The child which listens to
108: network traffic now runs as a normal user and chroots itself, while the
109: parent process tracks the state of the child and performs privileged
110: operations on its behalf.
1.1 david 111: <p>
112:
113: <li>Many unsafe string functions have been removed from the kernel and userland
1.6 tedu 114: utilities. This audit is one of the most comprehensive OpenBSD has ever
115: done, with thousands of occurrences of
1.12 deraadt 116: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strcpy">strcpy(3)</a>,
117: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strcat">strcat(3)</a>,
118: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sprintf">sprintf(3)</a>,
1.8 david 119: and
1.12 deraadt 120: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vsprintf">vsprintf(3)</a>
1.4 avsm 121: being replaced with safer, bounded alternatives such as
1.12 deraadt 122: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strlcpy">strlcpy(3)</a>,
123: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strlcat">strlcat(3)</a>,
124: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=snprintf">snprintf(3)</a>,
125: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vsnprintf">vsnprintf(3)</a>,
126: and
127: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=asprintf">asprintf(3)</a>.
1.1 david 128: <p>
129:
1.13 david 130: <li><a href="http://www.research.ibm.com/trl/projects/security/ssp/">
131: ProPolice</a> stack protection has been enabled in the kernel as well.
1.1 david 132: <p>
133:
1.18 avsm 134: <li>Privilege separation has been implemented in the X server. The privileged
1.15 david 135: child process is responsible for the operations that can't be done after the
136: main process has switched to a non-privileged user. This greatly reduces the
137: potential damage that could be caused by malicious X clients, in case of
138: bugs in the X server.
139: <p>
140:
1.20 ! deraadt 141: <li>Emulation support for binary compatibility is now controlled via
! 142: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sysctl">sysctl(1)</a>
1.19 tedu 143: Emulation is now disabled by default to limit exposure to malicious
144: binaries, and can be enabled in
145: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sysctl.conf">
146: sysctl.conf(5)</a>.
1.16 tedu 147: <p>
148:
1.1 david 149: <li>Manual pages have been greatly cleaned up and improved.
150: <p>
151:
1.8 david 152: <li>The ports tree now supports building programs under
153: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=systrace">
154: systrace(1)</a>, preventing the possibility of applications harming the
155: system at compile-time via trojaned configuration scripts or otherwise.
1.1 david 156: <p>
157:
1.3 jason 158: <li>More licenses fixes, including the removal of the advertising clause
1.6 tedu 159: for large parts of the source tree.
160: <p>
161:
1.20 ! deraadt 162: <li>Replacement of GNU
! 163: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=diff">diff</a>,
! 164: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=diff3">diff3</a>,
! 165: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=grep">grep</a>,
! 166: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=egrep">egrep</a>,
! 167: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fgrep">fgrep</a>,
! 168: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zgrep">zgrep</a>,
! 169: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zegrep">zegrep</a>,
! 170: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zfgrep">zfgrep</a>,
! 171: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gzip">gzip</a>,
! 172: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zcat">zcat</a>,
! 173: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gunzip">gunzip</a>,
! 174: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gzcat">gzcat</a>,
! 175: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zcmp">zcmp</a>,
! 176: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zmore">zmore</a>,
! 177: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zdiff">zdiff</a>,
! 178: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=zforce">zforce</a>,
! 179: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gzexe">gzexe</a>,
! 180: and
! 181: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=znew">znew</a>
! 182: commands with BSD licensed equivalents.
! 183: <p>
! 184:
! 185: <li>Addition of read-only support for
! 186: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mount_ntfs">NTFS</a>
! 187: file systems.
! 188: <p>
! 189:
! 190: <li>Reliability improvements to layered file systems, enabling
! 191: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mount_null">NULLFS</a>
! 192: to work again.
1.6 tedu 193: <p>
194:
1.19 tedu 195: <li>Improvements to the Linux emulator enabling more applications to run.
1.6 tedu 196: <p>
197:
1.16 tedu 198: <li>Significant improvements to the pthread library.
199: <p>
200:
1.20 ! deraadt 201: <li>Replace many static fd_set uses, to instead use
! 202: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=poll">poll(2)</a>
! 203: or dynamic allocation.
1.16 tedu 204: <p>
205:
1.13 david 206: <li>Legacy KerberosIV support has been removed, and the remaining KerberosV
207: codebase has been restructured for easier management.
1.3 jason 208: <p>
209:
1.13 david 210: <li>Over 2400 ports, 2200 pre-built packages.
1.1 david 211: <p>
212:
213: <li>A large number of bug fixes, changes, and optimizations to our packet filter
1.20 ! deraadt 214: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf">pf(4)</a>
1.1 david 215: including:
216: <ul>
1.20 ! deraadt 217: <li>packet tagging (e.g. filter on tags added by bridge based on MAC address)
1.10 frantzen 218: <li>stateful TCP normalization (prevent uptime calculation and NAT detection)
1.9 dhartmei 219: <li>passive OS detection (filter or redirect connections based on source OS)
220: <li>SYN proxy (protect servers against SYN flood attacks)
221: <li>adaptive state timeouts (prevent state table overflows under attack)
1.1 david 222: </ul>
223: <p>
224:
1.16 tedu 225: <li>Improved hardware support, including:
226: <ul>
227: <li>Kauai ATA controllers (Apple ATA100 wdc) enabling support for
228: Powerbook 12" and 17" models.
229: <li>Support for controlling LongRun registers on Transmeta CPUs.
1.19 tedu 230: <li>Many fixes to
231: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=aac">aac(4)</a>,
232: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ahc">ahc(4)</a>,
233: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=osiop">osiop(4)</a>,
234: and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=siop">siop(4)</a>
235: SCSI drivers.
236: <li>New
237: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=it">it(4)</a>,
238: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=lm">lm(4)</a>,
239: and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=viaenv">viaenv(4)</a>
240: hardware monitor drivers.
241: <li>New
242: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=safe">safe(4)</a>
243: driver for SafeNet crypto acclerators.
244: <li>New
245: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mtd">mtd(4)</a>
246: driver for Myson Technologies network cards.
247: <li>More ethernet cards supported by
248: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fxp">fxp(4)</a>
249: and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dc&sektion=4">dc(4)</a>.
250: <li>Massive overhaul and sync with NetBSD of the entire
251: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=usb&sektion=4">usb(4)</a>
252: support system.
253: <li>New and better support for various controllers in
254: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pciide">pciide(4)</a>,
255: including experimental support for Serial ATA.
1.16 tedu 256: </ul>
257: <p>
258:
1.1 david 259: <li>The system includes the following major components from outside suppliers:
260: <ul>
1.7 david 261: <li>XFree86 4.3.0 (+ patches, and i386 contains 3.3.X servers also, thus
262: providing support for all chipsets)
1.1 david 263: <li>Gcc 2.95.3 (+ patches)
264: <li>Perl 5.8.0 (+ patches)
265: <li>Apache 1.3.28, mod_ssl 2.8.15, DSO support (+ patches)
266: <li>OpenSSL 0.9.7beta3 (+ patches)
267: <li>Groff 1.15
268: <li>Sendmail 8.12.9
269: <li>Bind 9.2.2 (+ patches)
1.5 avsm 270: <li>Lynx 2.8.4rel.1 with HTTPS and IPv6 support (+ patches)
1.1 david 271: <li>Sudo 1.6.7p5
272: <li>Ncurses 5.2
273: <li>Latest KAME IPv6
274: <li>Heimdal 0.6rc1 (+ patches)
275: <li>Arla-current
1.17 david 276: <li>OpenSSH 3.7 (now with GSSAPI support)
1.1 david 277: </ul>
278: <p>
279:
280: <p>
281: <li>Many improvements for security and reliability (look for the red
282: print in the <a href="plus.html">complete changelog</a>).
283: <p>
284: <li> and much more.
285:
286: </ul>
287:
288: <a name="install"></a>
289: <hr>
290: <p>
291: <h3><font color="#0000e0">How to install</font></h3>
292: <p>
293: Following this are the instructions which you would have on a piece of
294: paper if you had purchased a CDROM set instead of doing an alternate
295: form of install. The instructions for doing an ftp (or other style
296: of) install are very similar; the CDROM instructions are left intact
297: so that you can see how much easier it would have been if you had
298: purchased a CDROM instead.
299: <p>
300:
301: <hr>
302: Please refer to the following files on the three CDROMs or ftp mirror for
303: extensive details on how to install OpenBSD 3.4 on your machine:
304: <p>
305: <ul>
1.8 david 306: <li>CD1:3.4/i386/INSTALL.i386
1.1 david 307: <p>
1.8 david 308: <li>CD2:3.4/macppc/INSTALL.macppc
309: <li>CD2:3.4/vax/INSTALL.vax
1.1 david 310: <p>
1.8 david 311: <li>CD3:3.4/sparc/INSTALL.sparc
312: <li>CD3:3.4/sparc64/INSTALL.sparc64
1.1 david 313: <p>
1.8 david 314: <li>FTP:.../OpenBSD/3.4/alpha/INSTALL.alpha
315: <li>FTP:.../OpenBSD/3.4/hp300/INSTALL.hp300
316: <li>FTP:.../OpenBSD/3.4/hppa/INSTALL.hppa
317: <li>FTP:.../OpenBSD/3.4/mac68k/INSTALL.mac68k
318: <li>FTP:.../OpenBSD/3.4/mvme68k/INSTALL.mvme68k
1.1 david 319: </ul>
320: <hr>
321:
322: <p>
323: Quick installer information for people familiar with OpenBSD, and the
324: use of the "disklabel -E" command. If you are at all confused when
325: installing OpenBSD, read the relevant INSTALL.* file as listed above!
326: <p>
327:
328: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
329: <ul>
330: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
331: release is on CD1. If your BIOS does not support booting from CD, you will need
332: to create a boot floppy to install from. To create a boot floppy write
333: <i>CD1:3.4/i386/floppy34.fs</i> to a floppy and boot via the floppy drive.
334:
335: <p>
336: Use <i>CD1:3.4/i386/floppyB34.fs</i> instead for greater scsi controller
337: support, or <i>CD1:3.4/i386/floppyC34.fs</i> for better laptop support.
338:
339: <p>
1.2 david 340: If you are planning on dual booting OpenBSD with another OS, you will need to
341: read the included INSTALL.i386 document.
1.1 david 342:
343: <p>
344: To make a boot floppy under MS-DOS, use the "rawrite" utility located
1.2 david 345: at <i>CD:/3.4/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
346: use the <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=
347: dd&sektion=1">dd(1)</a> utility. The following is an example usage of
348: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)
349: </a>, where the device could be "floppy", "rfd0c", or
350: "rfd0a".
1.1 david 351:
352: <ul><pre>
353: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
354: </pre></ul>
355:
356: <p>
1.2 david 357: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
358: your install will most likely fail. For more information on creating a boot
359: floppy and installing OpenBSD/i386 please refer to
360: <a href="faq/faq4.html#MkFlop">FAQ4.1</a>.
1.1 david 361: </ul>
362:
363: <p>
364: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
365: <ul>
366: Put the CD2 in your CDROM drive and poweron your machine while holding down the
367: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
368:
369: <p>
370: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
371: /3.4/macppc/bsd.rd</i>
372: </ul>
373:
374: <p>
375: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
376: <ul>
377: Boot over the network via mopbooting as described in INSTALL.vax.
378: </ul>
379:
380: <p>
381: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
382: <ul>
1.2 david 383: The 3.4 release of OpenBSD/sparc is located on CD3. To boot off of this CD you
384: can use one of the two commands listed below, depending on the version of your
385: ROM.
1.1 david 386:
387: <ul><pre>
1.8 david 388: > <strong>boot cdrom 3.4/sparc/bsd.rd</strong>
1.1 david 389: or
1.8 david 390: > <strong>boot sd(0,6,0)3.4/sparc/bsd.rd</strong>
1.1 david 391: </pre></ul>
392:
393: <p>
394: If your sparc does not have a CD drive, you can alternatively boot from floppy.
1.2 david 395: To do so you need to write "CD3:3.4/sparc/floppy34.fs" to a floppy.
396: For more information see <a href="faq/faq4.html#MkFlop">FAQ4.1</a>. To boot from
397: the floppy use one of the two commands listed below, depending on the version of
398: your ROM.
1.1 david 399:
400: <ul><pre>
1.8 david 401: > <strong>boot floppy</strong>
1.1 david 402: or
1.8 david 403: > <strong>boot fd()</strong>
1.1 david 404: </pre></ul>
405:
406: <p>
1.2 david 407: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
408: will most likely fail.
1.1 david 409:
410: <p>
411: If your sparc doesn't have a floppy drive nor a CD drive, you can either
412: setup a bootable tape, or install via network, as told in the
413: INSTALL.sparc file.
414: </ul>
415:
416: <p>
417: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
418: <ul>
419: Put the CD3 in your CDROM drive and type <i>boot cdrom</i>.
420:
421: <p>
422: If this doesn't work, or if you don't have a CDROM drive, you can write
423: <i>CD3:3.4/sparc64/floppy34.fs</i> to a floppy and boot it with <i>boot
424: floppy</i>.<br>
1.2 david 425: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
426: will most likely fail.
1.1 david 427:
428: <p>
429: You can also write <i>CD3:3.4/sparc64/miniroot34.fs</i> to the swap partition on
430: the disk and boot with <i>boot disk:b</i>.
431:
432: <p>
433: If nothing works, you can boot over the network as described in INSTALL.sparc64
434: </ul>
435:
436: <p>
437: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
438: <ul>
439: <p>Write <i>FTP:3.4/alpha/floppy34.fs</i> or
440: <i>FTP:3.4/alpha/floppyB34.fs</i> (depending on your machine) to a diskette and
441: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
442:
443: <p>
1.2 david 444: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
445: will most likely fail.
1.1 david 446:
447: </ul>
448:
449: <p>
450: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
451: <ul>
452: <p>
453: Boot over the network by following the instructions in INSTALL.hp300.
454: </ul>
455:
456: <p>
457: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
458: <ul>
459: <p>
460: Boot over the network by following the instructions in INSTALL.hppa or the
461: <a href="hppa.html#netboot">hppa platform page</a>.
462: </ul>
463:
464: <p>
465: <h3><font color="#e00000">OpenBSD/mac68k:</font></h3>
466: <ul>
467: <p>
468: Boot MacOS as normal and partition your disk with the appropriate A/UX
469: configurations. Then, extract the Macside utilities from
470: <i>FTP:3.4/mac68k/utils</i> onto your hard disk. Run Mkfs to create your
471: filesystems on the A/UX partitions you just made. Then, use the
472: "BSD/Mac68k Installer" to copy all the sets in <i>FTP:3.4/mac68k/</i> onto your
473: partitions. Finally, you will be ready to configure the "BSD/Mac68k
474: Booter" with the location of your kernel and boot the system.
475: </ul>
476:
477: <p>
478: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
479: <ul>
480: <p>
481: You can create a bootable installation tape or boot over the network.<br>
482: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
483: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
484: for more details.
485: </ul>
486:
487: <p>
488: <h3><font color="#e00000">Notes about the source code:</font></h3>
489: <ul>
490: src.tar.gz contains a source archive starting at /usr/src. This file
491: contains everything you need except for the kernel sources, which are
492: in a separate archive. To extract:
493: <p>
494: <ul><pre>
495: # <strong>mkdir -p /usr/src</strong>
496: # <strong>cd /usr/src</strong>
497: # <strong>tar xvfz /tmp/src.tar.gz</strong>
498: </pre></ul>
499: <p>
500: sys.tar.gz contains a source archive starting at /usr/src/sys.
501: This file contains all the kernel sources you need to rebuild kernels.
502: To extract:
503: <p>
504: <ul><pre>
505: # <strong>mkdir -p /usr/src/sys</strong>
506: # <strong>cd /usr/src</strong>
507: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
508: </pre></ul>
509: <p>
510: Both of these trees are a regular CVS checkout. Using these trees it
511: is possible to get a head-start on using the anoncvs servers as
512: described <a href="anoncvs.html">here</a>.
513: Using these files
514: results in a much faster initial CVS update than you could expect from
515: a fresh checkout of the full OpenBSD source tree.
516: <p>
517: </ul>
518: <a name="ports"></a>
519: <hr>
520: <p>
521: <h3><font color="#0000e0">Ports Tree</font></h3>
522: <p>
523: A ports tree archive is also provided. To extract:
524: <p>
525: <ul><pre>
526: # <strong>cd /usr</strong>
527: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
528: # <strong>cd ports</strong>
529: </pre></ul>
530: <p>
531: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
532: read the <a href="ports.html">ports</a> page
533: if you know nothing about ports
534: at this point. This text is not a manual of how to use ports.
535: Rather, it is a set of notes meant to kickstart the user on the
536: OpenBSD ports system.
537: <p>
538: Certainly, the OpenBSD ports system is not complete. It is doubtful it
539: will ever be. However, it is growing very fast and getting more stable.
540: Almost all ports provided with this release should build without problems
541: on most architectures (over 2400 packages build on i386, for instance).
542: <p>
543: The <i>ports/</i> directory represents a CVS (see the manpage for
544: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&apropos=0&sektion=1&manpath=OpenBSD+Current&arch=i386&format=html">
545: cvs(1)</a> if
546: you aren't familiar with CVS) checkout of our ports. As with our complete
547: source tree, our ports tree is available via anoncvs. So, in
548: order to keep current with it, you must make the <i>ports/</i> tree
549: available on a read-write medium and update the tree with a command
550: like:
551: <p>
552: <ul><pre>
553: # <strong>cd [portsdir]/; cvs -d anoncvsserver.openbsd.org:/cvs update -Pd -rOPENBSD_3_4</strong>
554: </pre></ul>
555: <p>
556: [Of course, you must replace the local directory and server name here
557: with the location of your ports collection and a nearby anoncvs
558: server.]
559: <p>
560: Note that most ports are available as packages through ftp. Updated
561: packages for the 3.4 release will be made available if problems arise.
562: <p>
563: If you're interested in seeing a port added, would like to help out, or just
564: would like to know more, the mailing list ports@openbsd.org is a good
565: place to know.
566: <p>
567:
568: <hr>
569: <a href="index.html"><img height="24" width="24" src="back.gif" border="0"
570: alt="OpenBSD"></a>
571: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
572: <br><small>
1.20 ! deraadt 573: $OpenBSD: 34.html,v 1.19 2003/09/05 00:30:26 tedu Exp $
1.1 david 574: </small>
575:
576: </body>
577: </html>