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