Annotation of www/38.html, Revision 1.59
1.59 ! bentley 1: <!doctype html>
! 2: <html lang=en id=release>
! 3: <meta charset=utf-8>
! 4:
1.40 deraadt 5: <title>OpenBSD 3.8</title>
1.1 deraadt 6: <meta name="description" content="OpenBSD 3.8">
1.51 tb 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.54 tb 9: <link rel="canonical" href="https://www.openbsd.org/38.html">
1.59 ! bentley 10: <style>
! 11: #sourcecode h3 {
! 12: color: var(--red);
! 13: }
! 14:
! 15: #sourcecode p {
! 16: margin-left: 2.75em;
! 17: }
! 18:
! 19: #sourcecode blockquote {
! 20: margin-left: 4.5em;
! 21: }
! 22: </style>
1.1 deraadt 23:
1.59 ! bentley 24: <h2 id=OpenBSD>
1.1 deraadt 25: <a href="index.html">
1.59 ! bentley 26: <i>Open</i><b>BSD</b></a>
! 27: 3.8
1.51 tb 28: </h2>
1.1 deraadt 29:
1.59 ! bentley 30: <table>
! 31: <tr>
! 32: <td>
1.23 deraadt 33: <a href="images/Jones.jpg">
1.59 ! bentley 34: <img width="255" height="343"
! 35: src="images/Jones.jpg" alt="Jones"></a>
! 36: <td>
1.34 deraadt 37: Released November 1, 2005<br>
1.1 deraadt 38: Copyright 1997-2005, Theo de Raadt.<br>
1.59 ! bentley 39: <cite class=isbn>ISBN 0-9731791-6-3</cite>
1.1 deraadt 40: <br>
1.48 deraadt 41: 3.8 Song: <a href="lyrics.html#38">"Hackers of the Lost RAID"</a>
1.58 deraadt 42: <br>
43: <br>
1.1 deraadt 44: <ul>
45: <li>See the information on <a href="ftp.html">The FTP page</a> for
46: a list of mirror machines.
1.59 ! bentley 47: <li>Go to the <code class=reldir>pub/OpenBSD/3.8/</code> directory on
1.1 deraadt 48: one of the mirror sites.
1.36 deraadt 49: <li>Have a look at <a href="errata38.html">The 3.8 Errata page</a> for a list
1.1 deraadt 50: of bugs and workarounds.
1.22 deraadt 51: <li>See a <a href="plus38.html">detailed log of changes</a> between the
1.1 deraadt 52: 3.7 and 3.8 releases.
53: </ul>
1.52 tb 54: <p>
1.51 tb 55: All applicable copyrights and credits are in the src.tar.gz,
56: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
57: files fetched via ports.tar.gz.
1.59 ! bentley 58: </table>
1.1 deraadt 59:
1.51 tb 60: <hr>
1.59 ! bentley 61:
! 62: <section id=new>
! 63: <h3>What's New</h3>
! 64:
1.1 deraadt 65: <p>
66: This is a partial list of new features and systems included in OpenBSD 3.8.
1.22 deraadt 67: For a comprehensive list, see the <a href="plus38.html">changelog</a> leading
1.1 deraadt 68: to 3.8.
69: <p>
70:
71: <ul>
72:
73: <li>Improved hardware support, including:
74: <ul>
75: <li>New
1.59 ! bentley 76: <a href="https://man.openbsd.org/aps.4">aps</a>
1.1 deraadt 77: driver for the built-in accelerometer found in some IBM ThinkPad laptops.
78: <li>New
1.59 ! bentley 79: <a href="https://man.openbsd.org/art.4">art</a>
1.1 deraadt 80: driver for Accom Networks Artery T1 and E1 cards.
81: <li>New
1.59 ! bentley 82: <a href="https://man.openbsd.org/auixp.4">auixp</a>
1.1 deraadt 83: driver for the ATI IXP series integrated AC'97 audio controller.
84: <li>New
1.59 ! bentley 85: <a href="https://man.openbsd.org/ciss.4">ciss</a>
1.1 deraadt 86: driver for Compaq Smart ARRAY 5 and 6 RAID controllers.
87: <li>New
1.59 ! bentley 88: <a href="https://man.openbsd.org/epic.4">epic</a>
1.1 deraadt 89: driver for SMC 83C170 ethernet adapters.
90: <li>New
1.59 ! bentley 91: <a href="https://man.openbsd.org/ichwdt.4">ichwdt</a>
1.3 jsg 92: driver for Intel 6300ESB ICH watchdog timer.
93: <li>New
1.59 ! bentley 94: <a href="https://man.openbsd.org/pcn.4">pcn</a>
1.1 deraadt 95: driver for the AMD Am79c97x (PCnet) ethernet adapters.
96: <li>New
1.59 ! bentley 97: <a href="https://man.openbsd.org/safte.4">safte</a>
1.1 deraadt 98: driver for SCSI Accessed Fault-Tolerant Enclosures, and a rewritten
1.59 ! bentley 99: <a href="https://man.openbsd.org/ses.4">ses</a>
1.1 deraadt 100: driver for SCSI Enclosure Services, both allowing monitoring through
1.59 ! bentley 101: <a href="https://man.openbsd.org/sysctl.8">sysctl</a>
1.1 deraadt 102: and
1.59 ! bentley 103: <a href="https://man.openbsd.org/sensorsd.8">sensorsd</a>.
1.1 deraadt 104: <li>New
1.59 ! bentley 105: <a href="https://man.openbsd.org/ueagle.4">ueagle</a>
1.1 deraadt 106: driver for Analog Devices Eagle ADSL modems.
1.3 jsg 107: <li>New
1.59 ! bentley 108: <a href="https://man.openbsd.org/uipaq.4">uipaq</a>
1.3 jsg 109: driver for iPAQ USB serial.
110: <li>New
1.59 ! bentley 111: <a href="https://man.openbsd.org/viasio.4">viasio</a>
1.3 jsg 112: driver for VIA VT1211 LPC Super I/O hardware sensors.
1.6 uwe 113: <li>New
1.59 ! bentley 114: <a href="https://man.openbsd.org/zaurus/zaudio.4">zaudio</a>
1.6 uwe 115: driver for the built-in Zaurus audio CODEC.
116: <li>Improved
1.59 ! bentley 117: <a href="https://man.openbsd.org/com.4">com</a>
1.6 uwe 118: driver for serial port PCMCIA cards, such as cellular modems on Zaurus.
1.10 krw 119: <li>Improved support for many
1.59 ! bentley 120: <a href="https://man.openbsd.org/umass.4">umass</a>
1.10 krw 121: devices.
1.27 matthieu 122: <li>Updated driver from X.Org for the Intel
1.59 ! bentley 123: <a href="https://man.openbsd.org/i810.4">i810</a>
1.27 matthieu 124: family graphics chipset, including support for the external VGA output on laptops.
1.10 krw 125: </ul>
1.1 deraadt 126: <p>
127:
128: <li>New tools:
129: <ul>
1.59 ! bentley 130: <li><a href="https://man.openbsd.org/bioctl.8">bioctl(8)</a>,
1.1 deraadt 131: a RAID management interface.
1.59 ! bentley 132: <li><a href="https://man.openbsd.org/ipsecctl.8">ipsecctl(8)</a>,
1.1 deraadt 133: a simple IPsec management tool.
1.59 ! bentley 134: <li><a href="https://man.openbsd.org/stat.1">stat(1)</a>,
1.1 deraadt 135: displaying file status obtained from
1.59 ! bentley 136: <a href="https://man.openbsd.org/stat.2">stat(2)</a>
1.1 deraadt 137: or
1.59 ! bentley 138: <a href="https://man.openbsd.org/lstat.2">lstat(2)</a>.
! 139: <li><a href="https://man.openbsd.org/hostapd.8">hostapd(8)</a>,
1.1 deraadt 140: a wireless Host Access Point daemon.
1.59 ! bentley 141: <li><a href="https://man.openbsd.org/ifstated.8">ifstated(8)</a>,
1.1 deraadt 142: a daemon monitoring ethernet interfaces status.
1.59 ! bentley 143: <li><a href="https://man.openbsd.org/watchdogd.8">watchdogd(8)</a>,
1.1 deraadt 144: companion to the hardware
1.59 ! bentley 145: <a href="https://man.openbsd.org/watchdog.4">watchdog</a>
1.1 deraadt 146: devices.
1.59 ! bentley 147: <li><a href="https://man.openbsd.org/zaurus/ztsscale.8">ztsscale(8)</a>,
1.6 uwe 148: a tool to calibrate the Zaurus touch screen.
1.59 ! bentley 149: <li><a href="https://man.openbsd.org/xidle.1">xidle(1)</a>,
1.11 fgsch 150: a tool to run a program on X inactivity.
1.59 ! bentley 151: <li><a href="https://man.openbsd.org/gzsig.1">gzsig(1)</a>,
1.14 djm 152: create and verify cryptographic signatures built into gzip file headers.
1.59 ! bentley 153: <li><a href="https://man.openbsd.org/sasyncd.8">sasyncd(8)</a>,
1.31 moritz 154: a daemon to synchronize IPSec SA's for failover gateways.
1.1 deraadt 155: </ul>
156: <p>
157:
158: <li>New functionality:
159: <ul>
1.18 otto 160: <li>
1.59 ! bentley 161: <a href="https://man.openbsd.org/mount_udf.8">mount_udf(8)</a>,
1.24 pedro 162: providing UDF (DVD) filesystem support.
1.1 deraadt 163: <li>Network interface aggregation, using the virtual
1.59 ! bentley 164: <a href="https://man.openbsd.org/trunk.4">trunk(4)</a>
1.1 deraadt 165: interface.
1.2 espie 166: <li>Partial wide character and locale support in the C and C++ libraries.
1.59 ! bentley 167: <li><a href="https://man.openbsd.org/wd.4">wd(4)</a>
1.4 jsg 168: disks have the security feature frozen before being attached to prevent
169: malicious users setting a password that would prevent the contents of the drive
170: from being accessed.
1.26 kettenis 171: <li>On the <a href="sparc64.html">OpenBSD/sparc64</a> platform, StackGhost
172: buffer overflow exploit protection has been added.
1.32 robert 173: <li>
1.59 ! bentley 174: <a href="https://man.openbsd.org/zaurus/zaudio.4">zaudio(4)</a>
1.32 robert 175: changes the mute values if the headphones are plugged in or out.
1.1 deraadt 176: </ul>
177: <p>
178:
1.59 ! bentley 179: <li>New functionality for <a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a>,
1.5 norby 180: the Open Shortest Path First Daemon:
181: <ul>
182: <li>ospfd is now able to redistribute static, connected and default routes.
183: <li>ospfctl is now able to display all relevant information.
184: <li>Interoperability with cisco and Extreme has been improved.
185: <li>Support for parsing and displaying parsed configuration file, similar to bgpd.
186: <li>Support for cryptographic authentication has been added.
187: <li>Interface finite state machine has been reworked, primarily to improve interoperability.
188: <li>The performance of the shortest path first calculation has been improved.
189: <li>Numerous bugs have been discovered and fixed during the last 6 months.
190: </ul>
191: <p>
192:
1.59 ! bentley 193: <li>New functionality for <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>,
1.20 claudio 194: the Border Gateway Protocol Daemon:
195: <ul>
196: <li>bgpd is now able to redistribute static and connected routes dynamically.
197: <li>Full route label support;
1.59 ! bentley 198: <a href="https://man.openbsd.org/pf.4">pf(4)</a>
1.20 claudio 199: can filter based on information bgpd attaches to the routes.
200: <li>An additional per prefix weight has been added used to evaluate prefixes
201: with equal AS path length.
1.25 deraadt 202: <li>New route decision tunable <i>rde med compare always</i> to force bgpd
1.20 claudio 203: to compare the MED independent of the peer AS.
204: <li>IPv6 support.
205: </ul>
206: <p>
207:
1.15 otto 208: <li>Assorted improvements and code cleanup:
209: <ul>
1.59 ! bentley 210: <li><a href="https://man.openbsd.org/malloc.3">malloc(3)</a>
1.15 otto 211: has been rewritten to use the
1.59 ! bentley 212: <a href="https://man.openbsd.org/mmap.2">mmap(2)</a>
1.15 otto 213: system call, introducing unpredictable allocation addresses and guard
214: pages, which helps in detecting heap based buffer overflows and prevents
215: various types of attacks.
1.59 ! bentley 216: <li><a href="https://man.openbsd.org/intro.3">libc(3)</a>
1.15 otto 217: source code has been converted to ANSI C.
1.59 ! bentley 218: <li><a href="https://man.openbsd.org/realpath.3">realpath(3)</a>
1.17 otto 219: is now thread safe.
1.15 otto 220: <li>Several pathname races and potential buffer handling problems have been
221: fixed in
1.59 ! bentley 222: <a href="https://man.openbsd.org/pax.1">pax(1)</a>.
1.15 otto 223: <li>Problems with signal delivery on <a href="sparc.html">OpenBSD/sparc</a> and
224: <a href="sparc64.html">OpenBSD/sparc64</a> have been fixed.
225: <li>Reliability of signal handlers using floating point on
226: <a href="i386.html">OpenBSD/i386</a> and
227: <a href="macppc.html">OpenBSD/macppc</a> has been improved.
1.29 otto 228: <li>NFS write performance has been improved greatly.
229: <li>Countermeasures against various blind ICMP attacks have been implemented.
1.15 otto 230: </ul>
231: <p>
232:
1.13 djm 233: <li>OpenSSH 4.2:
234: <ul>
235: <li>Adds a new compression method that delays the start of zlib
1.51 tb 236: compression until the user has been authenticated successfully.
237: The new method ("Compression delayed") is on by default in the
238: server and eliminates the risk of any zlib vulnerability
1.13 djm 239: leading to a compromise of the server from unauthenticated users.
240: <li>Added support for the improved arcfour cipher modes from
241: draft-harris-ssh-arcfour-fixes-02. The improves the cipher's
242: resistance to a number of attacks by discarding early keystream
243: output.
1.51 tb 244: <li>Many improvements to connection multiplexing, including a new
245: opportunistic multiplexing mode, automatic fallback to plain
246: connections when multiplexing fails and support for multiplexed X11
1.13 djm 247: and agent forwarding.
248: <li>Many additional bug fixes and improvements, as described in the
1.55 tb 249: <a href="https://www.openssh.com/txt/release-4.2">release announcement</a>.
1.13 djm 250: </ul>
251: <p>
252:
1.9 pvalchev 253: <li>Over 3200 ports, 3000 pre-built packages, improved package tools.
1.1 deraadt 254: <p>
255:
256: <li>As usual, many improvements in manual pages and other documentation.
257: <p>
258:
259: <li>The system includes the following major components from outside suppliers:
260: <ul>
261: <li>X.Org 6.8.2 (+ patches, and i386 contains XFree86 3.3.6 servers
262: (+ patches) for legacy chipsets not supported by X.Org)
263: <li>Gcc 2.95.3
1.59 ! bentley 264: (+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
1.1 deraadt 265: and 3.3.5
1.59 ! bentley 266: (+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
1.1 deraadt 267: <li>Perl 5.8.6 (+ patches)
268: <li>Apache 1.3.29, mod_ssl 2.8.16, DSO support (+ patches)
269: <li>OpenSSL 0.9.7g (+ patches)
270: <li>Groff 1.15
271: <li>Sendmail 8.13.4, with libmilter
272: <li>Bind 9.3.1 (+ patches)
273: <li>Lynx 2.8.5rel.2 with HTTPS and IPv6 support (+ patches)
274: <li>Sudo 1.6.8p9
275: <li>Ncurses 5.2
276: <li>Latest KAME IPv6
1.30 biorn 277: <li>Heimdal 0.6.3 (+ patches)
1.1 deraadt 278: <li>Arla 0.35.7
279: <li>Binutils 2.15 (+ patches)
280: <li>Gdb 6.3
281: </ul>
282:
283: </ul>
1.59 ! bentley 284: </section>
1.1 deraadt 285:
286: <hr>
1.59 ! bentley 287:
! 288: <section id=install>
! 289: <h3>How to install</h3>
! 290:
1.1 deraadt 291: <p>
292: Following this are the instructions which you would have on a piece of
293: paper if you had purchased a CDROM set instead of doing an alternate
294: form of install. The instructions for doing an FTP (or other style
295: of) install are very similar; the CDROM instructions are left intact
296: so that you can see how much easier it would have been if you had
297: purchased a CDROM instead.
298: <p>
299:
300: <hr>
301: Please refer to the following files on the three CDROMs or FTP mirror for
302: extensive details on how to install OpenBSD 3.8 on your machine:
303: <p>
304: <ul>
305: <li>CD1:3.8/i386/INSTALL.i386
306: <li>CD1:3.8/vax/INSTALL.vax
307: <p>
308: <li>CD2:3.8/amd64/INSTALL.amd64
309: <li>CD2:3.8/macppc/INSTALL.macppc
310: <p>
311: <li>CD3:3.8/sparc/INSTALL.sparc
312: <li>CD3:3.8/sparc64/INSTALL.sparc64
313: <p>
314: <li>FTP:.../OpenBSD/3.8/alpha/INSTALL.alpha
315: <li>FTP:.../OpenBSD/3.8/cats/INSTALL.cats
316: <li>FTP:.../OpenBSD/3.8/hp300/INSTALL.hp300
317: <li>FTP:.../OpenBSD/3.8/hppa/INSTALL.hppa
318: <li>FTP:.../OpenBSD/3.8/luna88k/INSTALL.luna88k
319: <li>FTP:.../OpenBSD/3.8/mac68k/INSTALL.mac68k
320: <li>FTP:.../OpenBSD/3.8/mvme68k/INSTALL.mvme68k
321: <li>FTP:.../OpenBSD/3.8/mvme88k/INSTALL.mvme88k
322: <li>FTP:.../OpenBSD/3.8/sgi/INSTALL.sgi
323: <li>FTP:.../OpenBSD/3.8/zaurus/INSTALL.zaurus
324: </ul>
325: <hr>
326:
1.59 ! bentley 327: <section id=quickinstall>
! 328:
1.1 deraadt 329: <p>
330: Quick installer information for people familiar with OpenBSD, and the
331: use of the "disklabel -E" command. If you are at all confused when
332: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.59 ! bentley 333:
! 334: <h3>OpenBSD/i386:</h3>
! 335:
1.1 deraadt 336: <p>
337: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
338: release is on CD1. If your BIOS does not support booting from CD, you will need
339: to create a boot floppy to install from. To create a boot floppy write
340: <i>CD1:3.8/i386/floppy38.fs</i> to a floppy and boot via the floppy drive.
341:
342: <p>
343: Use <i>CD1:3.8/i386/floppyB38.fs</i> instead for greater SCSI controller
344: support, or <i>CD1:3.8/i386/floppyC38.fs</i> for better laptop support.
345:
346: <p>
347: If you can't boot from a CD or a floppy disk,
348: you can install across the network using PXE as described in
349: the included INSTALL.i386 document.
350:
351: <p>
352: If you are planning on dual booting OpenBSD with another OS, you will need to
353: read INSTALL.i386.
354:
355: <p>
356: To make a boot floppy under MS-DOS, use the "rawrite" utility located
357: at <i>CD1:3.8/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
1.59 ! bentley 358: use the <a href="https://man.openbsd.org/dd.1">dd(1)</a>
! 359: utility. The following is an example usage of
! 360: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.1 deraadt 361: where the device could be "floppy", "rfd0c", or
362: "rfd0a".
363:
1.59 ! bentley 364: <blockquote><pre>
1.1 deraadt 365: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
1.59 ! bentley 366: </pre></blockquote>
1.1 deraadt 367:
368: <p>
369: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
370: your install will most likely fail. For more information on creating a boot
371: floppy and installing OpenBSD/i386 please refer to
1.53 tj 372: <a href="faq/faq4.html#MkFlop">this page</a>.
1.59 ! bentley 373:
! 374: <h3>OpenBSD/vax:</h3>
1.1 deraadt 375:
376: <p>
377: Boot over the network via mopbooting as described in INSTALL.vax.
1.59 ! bentley 378:
! 379: <h3>OpenBSD/amd64:</h3>
1.1 deraadt 380:
381: <p>
382: The 3.8 release of OpenBSD/amd64 is located on CD2.
383: Boot from the CD to begin the install - you may need to adjust
384: your BIOS options first.
385: If you can't boot from the CD, you can create a boot floppy to install from.
386: To do this, write <i>CD2:3.8/amd64/floppy38.fs</i> to a floppy, then
387: boot from the floppy drive.
388:
389: <p>
390: If you can't boot from a CD or a floppy disk,
391: you can install across the network using PXE as described in the included
392: INSTALL.amd64 document.
393:
394: <p>
395: If you are planning to dual boot OpenBSD with another OS, you will need to
396: read INSTALL.amd64.
1.59 ! bentley 397:
! 398: <h3>OpenBSD/macppc:</h3>
1.1 deraadt 399:
400: <p>
401: Put CD2 in your CDROM drive and poweron your machine while holding down the
402: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
403:
404: <p>
405: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
406: /3.8/macppc/bsd.rd</i>
1.59 ! bentley 407:
! 408: <h3>OpenBSD/sparc:</h3>
1.1 deraadt 409:
410: <p>
411: The 3.8 release of OpenBSD/sparc is located on CD3. To boot off of this CD you
412: can use one of the two commands listed below, depending on the version of your
413: ROM.
414:
1.59 ! bentley 415: <blockquote><pre>
! 416: ok <kbd>boot cdrom 3.8/sparc/bsd.rd</kbd>
1.1 deraadt 417: or
1.59 ! bentley 418: > <kbd>b sd(0,6,0)3.8/sparc/bsd.rd</kbd>
! 419: </pre></blockquote>
1.1 deraadt 420:
421: <p>
422: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
423: To do so you need to write <i>CD3:3.8/sparc/floppy38.fs</i> to a floppy.
1.53 tj 424: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.1 deraadt 425: To boot from the floppy use one of the two commands listed below,
426: depending on the version of your ROM.
427:
1.59 ! bentley 428: <blockquote><pre>
! 429: ok <kbd>boot floppy</kbd>
1.1 deraadt 430: or
1.59 ! bentley 431: > <kbd>b fd()</kbd>
! 432: </pre></blockquote>
1.1 deraadt 433:
434: <p>
435: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
436: will most likely fail.
437:
438: <p>
439: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
440: setup a bootable tape, or install via network, as told in the
441: INSTALL.sparc file.
1.59 ! bentley 442:
! 443: <h3>OpenBSD/sparc64:</h3>
1.1 deraadt 444:
445: <p>
446: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
447:
448: <p>
449: If this doesn't work, or if you don't have a CDROM drive, you can write
450: <i>CD3:3.8/sparc64/floppy38.fs</i> or <i>CD3:3.8/sparc64/floppyB38.fs</i>
451: (depending on your machine) to a floppy and boot it with <i>boot
452: floppy</i>. Refer to INSTALL.sparc64 for details.
453:
454: <p>
455: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
456: will most likely fail.
457:
458: <p>
459: You can also write <i>CD3:3.8/sparc64/miniroot38.fs</i> to the swap partition on
460: the disk and boot with <i>boot disk:b</i>.
461:
462: <p>
463: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.59 ! bentley 464:
! 465: <h3>OpenBSD/alpha:</h3>
1.1 deraadt 466:
467: <p>
1.59 ! bentley 468: Write <i>FTP:3.8/alpha/floppy38.fs</i> or
1.1 deraadt 469: <i>FTP:3.8/alpha/floppyB38.fs</i> (depending on your machine) to a diskette and
470: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
471:
472: <p>
473: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
474: will most likely fail.
475:
1.59 ! bentley 476: <h3>OpenBSD/cats:</h3>
1.1 deraadt 477:
478: <p>
479: After updating the firmware to at least ABLE 1.95 if necessary, boot
480: <i>FTP:3.8/cats/bsd.rd</i> from an ABLE-supported device (such as a CD-ROM
481: or an existing FFS or EXT2FS partition).
1.59 ! bentley 482:
! 483: <h3>OpenBSD/hp300:</h3>
1.1 deraadt 484:
485: <p>
486: Boot over the network by following the instructions in INSTALL.hp300.
487:
1.59 ! bentley 488: <h3>OpenBSD/hppa:</h3>
! 489:
1.1 deraadt 490: <p>
491: Boot over the network by following the instructions in INSTALL.hppa or the
492: <a href="hppa.html#install">hppa platform page</a>.
493:
1.59 ! bentley 494: <h3>OpenBSD/luna88k:</h3>
! 495:
1.1 deraadt 496: <p>
497: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
498: Alternatively, you can create a bootable tape and boot from it. Refer to
499: the instructions in INSTALL.luna88k for more details.
1.59 ! bentley 500:
! 501: <h3>OpenBSD/mac68k:</h3>
1.1 deraadt 502:
503: <p>
504: Boot MacOS as normal and extract the Macside "BSD/Mac68k Booter" utility from
505: <i>FTP:3.8/mac68k/utils</i> onto your hard disk. Configure the "BSD/Mac68k
506: Booter" with the location of your bsd.rd kernel and boot into the installer.
507: Refer to the instructions in INSTALL.mac68k for more details.
508:
1.59 ! bentley 509: <h3>OpenBSD/mvme68k:</h3>
! 510:
1.1 deraadt 511: <p>
512: You can create a bootable installation tape or boot over the network.<br>
513: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
514: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
515: for more details.
1.59 ! bentley 516:
! 517: <h3>OpenBSD/mvme88k:</h3>
1.1 deraadt 518:
519: <p>
520: You can create a bootable installation tape or boot over the network.<br>
521: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
522: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
523: for more details.
524:
1.59 ! bentley 525: <h3>OpenBSD/sgi:</h3>
! 526:
1.1 deraadt 527: <p>
1.51 tb 528: Burn cd38.iso on a CD-R, put it in the CD drive of your machine and
1.12 matthieu 529: select <i>Install System Software</i> from the System Maintenance menu.
530:
1.19 matthieu 531: <p>
532: If your machine doesn't have a CD drive, you can
1.12 matthieu 533: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd".
1.1 deraadt 534: Refer to the instructions in INSTALL.sgi for more details.
1.59 ! bentley 535:
! 536: <h3>OpenBSD/zaurus:</h3>
1.1 deraadt 537:
538: <p>
539: Using the Linux built-in graphical ipkg installer, install the
540: openbsd38_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
541: for a few important details.
1.59 ! bentley 542:
! 543: </section>
! 544:
! 545: <section id=sourcecode>
! 546: <h3>Notes about the source code:</h3>
1.1 deraadt 547:
548: <p>
549: src.tar.gz contains a source archive starting at /usr/src. This file
550: contains everything you need except for the kernel sources, which are
551: in a separate archive. To extract:
1.59 ! bentley 552:
! 553: <blockquote><pre>
! 554: # <kbd>mkdir -p /usr/src</kbd>
! 555: # <kbd>cd /usr/src</kbd>
! 556: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
! 557: </pre></blockquote>
! 558:
1.1 deraadt 559: <p>
560: sys.tar.gz contains a source archive starting at /usr/src/sys.
561: This file contains all the kernel sources you need to rebuild kernels.
562: To extract:
1.59 ! bentley 563:
! 564: <blockquote><pre>
! 565: # <kbd>mkdir -p /usr/src/sys</kbd>
! 566: # <kbd>cd /usr/src</kbd>
1.1 deraadt 567: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
1.59 ! bentley 568: </pre></blockquote>
! 569:
1.1 deraadt 570: <p>
571: Both of these trees are a regular CVS checkout. Using these trees it
572: is possible to get a head-start on using the anoncvs servers as
573: described <a href="anoncvs.html">here</a>.
574: Using these files
575: results in a much faster initial CVS update than you could expect from
576: a fresh checkout of the full OpenBSD source tree.
577:
1.59 ! bentley 578: </section>
! 579: </section>
! 580:
1.1 deraadt 581: <hr>
1.59 ! bentley 582:
! 583: <section id=upgrade>
! 584: <h3>How to upgrade</h3>
1.1 deraadt 585: <p>
586: If you already have an OpenBSD 3.7 system, and do not want to reinstall,
587: upgrade instructions and advice can be found in the
588: <a href="faq/upgrade38.html">Upgrade Guide</a>.
1.59 ! bentley 589: </section>
1.1 deraadt 590:
591: <hr>
1.59 ! bentley 592:
! 593: <section id=ports>
! 594: <h3>Ports Tree</h3>
1.1 deraadt 595: <p>
596: A ports tree archive is also provided. To extract:
597: <p>
1.59 ! bentley 598: <blockquote><pre>
! 599: # <kbd>cd /usr</kbd>
! 600: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
! 601: # <kbd>cd ports</kbd>
! 602: </pre></blockquote>
1.1 deraadt 603: <p>
604: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
1.38 jasper 605: read the <a href="faq/faq15.html">ports</a> page
1.1 deraadt 606: if you know nothing about ports
607: at this point. This text is not a manual of how to use ports.
608: Rather, it is a set of notes meant to kickstart the user on the
609: OpenBSD ports system.
610: <p>
611: The <i>ports/</i> directory represents a CVS (see the manpage for
1.59 ! bentley 612: <a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
1.1 deraadt 613: you aren't familiar with CVS) checkout of our ports. As with our complete
614: source tree, our ports tree is available via anoncvs. So, in
615: order to keep current with it, you must make the <i>ports/</i> tree
616: available on a read-write medium and update the tree with a command
617: like:
618: <p>
1.59 ! bentley 619: <blockquote><pre>
1.37 deraadt 620: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_8</strong>
1.59 ! bentley 621: </pre></blockquote>
1.1 deraadt 622: <p>
623: [Of course, you must replace the local directory and server name here
624: with the location of your ports collection and a nearby anoncvs
625: server.]
626: <p>
627: Note that most ports are available as packages through FTP. Updated
628: packages for the 3.8 release will be made available if problems arise.
629: <p>
630: If you're interested in seeing a port added, would like to help out, or just
631: would like to know more, the mailing list ports@openbsd.org is a good
632: place to know.
1.59 ! bentley 633: </section>