Annotation of www/51.html, Revision 1.58
1.57 bentley 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
1.40 deraadt 5: <title>OpenBSD 5.1</title>
1.1 deraadt 6: <meta name="description" content="OpenBSD 5.1">
1.51 tj 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.53 tb 9: <link rel="canonical" href="https://www.openbsd.org/51.html">
1.57 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.57 bentley 24: <h2 id=OpenBSD>
1.1 deraadt 25: <a href="index.html">
1.57 bentley 26: <i>Open</i><b>BSD</b></a>
27: 5.1
1.51 tj 28: </h2>
1.1 deraadt 29:
1.57 bentley 30: <table>
31: <tr>
32: <td>
1.5 deraadt 33: <a href="images/Bugbusters.jpg">
1.57 bentley 34: <img width="227" height="343" src="images/Bugbusters.jpg" alt="Bugbusters"></a>
35: <td>
1.35 miod 36: Released May 1, 2012<br>
1.1 deraadt 37: Copyright 1997-2012, Theo de Raadt.<br>
1.57 bentley 38: <cite class=isbn>ISBN 978-0-9784475-9-5</cite>
1.1 deraadt 39: <br>
1.47 deraadt 40: 5.1 Song: <a href="lyrics.html#51">"Bug Busters"</a>
1.56 deraadt 41: <br>
42: <br>
1.1 deraadt 43: <ul>
44: <li>See the information on <a href="ftp.html">The FTP page</a> for
45: a list of mirror machines.
1.57 bentley 46: <li>Go to the <code class=reldir>pub/OpenBSD/5.1/</code> directory on
1.1 deraadt 47: one of the mirror sites.
48: <li>Have a look at <a href="errata51.html">The 5.1 Errata page</a> for a list
49: of bugs and workarounds.
50: <li>See a <a href="plus51.html">detailed log of changes</a> between the
51: 5.0 and 5.1 releases.
52: </ul>
1.51 tj 53: <p>
54: All applicable copyrights and credits are in the src.tar.gz,
55: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
56: files fetched via ports.tar.gz.
1.57 bentley 57: </table>
1.51 tj 58:
59: <hr>
1.1 deraadt 60:
1.57 bentley 61: <section id=new>
62: <h3>What's New</h3>
63:
1.1 deraadt 64: <p>
65: This is a partial list of new features and systems included in OpenBSD 5.1.
66: For a comprehensive list, see the <a href="plus51.html">changelog</a> leading
67: to 5.1.
68: <p>
69:
70: <ul>
1.3 guenther 71: <li>Improved hardware support, including:
72: <ul>
1.57 bentley 73: <li><a href="https://man.openbsd.org/umsm.4">umsm(4)</a> supports additional mobile broadband devices.
74: <li>Non-GigE <a href="https://man.openbsd.org/ale.4">ale(4)</a> devices can now establish link to a GigE link partner.
75: <li>Support for Intel 82580 has been added to <a href="https://man.openbsd.org/em.4">em(4)</a>.
76: <li>Support for MegaRAID 9240 has been added to <a href="https://man.openbsd.org/mfi.4">mfi(4)</a>.
77: <li>Support for Nuvoton NCT6776F has been added to <a href="https://man.openbsd.org/lm.4">lm(4)</a>.
78: <li>Support for Centrino Advanced-N 6205 has been added to <a href="https://man.openbsd.org/iwn.4">iwn(4)</a>.
79: <li>Support for SiS 1182/1183 SATA has been added to <a href="https://man.openbsd.org/pciide.4">pciide(4)</a>.
80: <li>Support for Synaptics touch pads through the <a href="https://man.openbsd.org/synaptics.4">synaptics(4)</a> X.Org input driver is now enabled by default.
81: <li>Support for Intel Sandy Bridge integrated graphics cards has been added to the <a href="https://man.openbsd.org/intel.4">intel(4)</a> X.Org driver.
1.20 mikeb 82: <li>Assembler implementation of the AES-GCM mode for new Intel and future AMD CPUs has been added.
1.57 bentley 83: <li><a href="https://man.openbsd.org/usb.4">usb(4)</a> probes bus after resume, improves functionality for some laptops.
1.4 deraadt 84: </ul>
1.3 guenther 85: <p>
86:
87: <li>Generic network stack improvements:
88: <ul>
1.57 bentley 89: <li>RFC4638 MTU negotiation for <a href="https://man.openbsd.org/pppoe.4">pppoe(4)</a>.
90: <li><a href="https://man.openbsd.org/npppdctl.8">npppdctl(8)</a> replaced with <a href="https://man.openbsd.org/npppctl.8">npppctl(8)</a>, written from scratch. Includes support for IPv6 as tunnel source address.
91: <li>Improve performance (throughput and loss rate) for PPTP, <a href="https://man.openbsd.org/pppd.8">pppd(8)</a> or L2TP(/IPsec) on unstable latency networks (eg mobile).
1.17 henning 92: <li>Improved IPv6 fragment handling.
1.7 sthen 93: <li>Many robustness improvements for IEEE 802.11 (particularly hostap).
94: <li>Improved vlan priority support, including mapping to interface queues.
1.13 sperreau 95: <li>Initial rdomains support for IPv6.
1.57 bentley 96: <li>Robustness improvements for <a href="https://man.openbsd.org/carp.4">carp(4)</a>.
97: <li>Various IPv6 and rdomain related improvements for <a href="https://man.openbsd.org/carp.4">carp(4)</a>.
1.4 deraadt 98: </ul>
1.3 guenther 99: <p>
1.24 deraadt 100:
1.3 guenther 101: <li>Routing daemons and other userland network improvements:
102: <ul>
1.57 bentley 103: <li><a href="https://man.openbsd.org/fstat.8">fstat(8)</a> now displays routing table ID and socket-splicing information and ps can display routing table ID.
104: <li><a href="https://man.openbsd.org/traceroute.8">traceroute(8)</a> and <a href="https://man.openbsd.org/traceroute6.8">traceroute6(8)</a> can look up ASNs for each hop.
105: <li><a href="https://man.openbsd.org/snmpd.8">snmpd(8)</a> adds a MIB to show statistics for <a href="https://man.openbsd.org/carp.4">carp(4)</a> interfaces.
106: <li><a href="https://man.openbsd.org/bgpctl.8">bgpctl(8)</a> parses and display MRT routing table dumps.
107: <li><a href="https://man.openbsd.org/ntpd.8">ntpd(8)</a> supports multiple rdomains.
108: <li>When <a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a> detects route socket overflow, it now delays before it reloads the fib.
1.16 deraadt 109: <li>Improved and more consistent ToS support in various network tools
1.57 bentley 110: (<a href="https://man.openbsd.org/tcpbench.8">tcpbench(8)</a>, <a href="https://man.openbsd.org/nc.8">nc(8)</a>, <a href="https://man.openbsd.org/pingt.8">ping(8)</a>, <a href="https://man.openbsd.org/traceroute.8">traceroute(8)</a>).
111: <li>Initial import of <a href="https://man.openbsd.org/login_yubikey.8">login_yubikey(8)</a> for logging in using yubikeys.
1.4 deraadt 112: </ul>
1.3 guenther 113: <p>
1.4 deraadt 114:
1.57 bentley 115: <li><a href="https://man.openbsd.org/pf.4">pf(4)</a> improvements:
1.3 guenther 116: <ul>
1.57 bentley 117: <li>One-shot rule support for <a href="https://man.openbsd.org/pf.4">pf(4)</a>, for use with proxies via anchors.
1.26 deraadt 118: <li>NAT64 support in PF using the <b>af-to</b> keyword.
1.24 deraadt 119: <li>Much improved IPv6 fragment handling.
120: <li>Various enhancements with ICMP and especially ICMPv6 states
121: <li>Improved IPv6 Neighbor Discovery and Multicast Listener Discovery handling.
1.57 bentley 122: <li><a href="https://man.openbsd.org/pfctl.8">pfctl(8)</a> now prints port numbers instead of service names by default.
123: <li>Netflow v9 and ipfix support for <a href="https://man.openbsd.org/pflow.4">pflow(4)</a>.
124: <li>Many <a href="https://man.openbsd.org/pfsync.4">pfsync(4)</a> fixes and improvements including jumbo frames and automatically requesting a bulk update after a physical interface comes online.
1.4 deraadt 125: </ul>
1.3 guenther 126: <p>
1.24 deraadt 127:
1.11 espie 128: <li>Assorted improvements:
129: <ul>
130: <li>Improved locale support.
1.24 deraadt 131: <li>Support for MSG_NOSIGNAL.
1.57 bentley 132: <li>KERN_PROC_CWD <a href="https://man.openbsd.org/sysctl.3">sysctl(3)</a> for fetching the path to a process's working directory.
133: <li>Improved <a href="https://man.openbsd.org/fnmatch.3">fnmatch(3)</a>, <a href="https://man.openbsd.org/glob.3">glob(3)</a>, and <a href="https://man.openbsd.org/regcomp.3">regcomp(3)</a> implementations to resist
1.16 deraadt 134: DoS attacks.
1.11 espie 135: <li>Lots of HISTORY and AUTHORS information added to manpages.
136: <li>Improved checking of file-offset wraparound.
1.57 bentley 137: <li><a href="https://man.openbsd.org/pwrite.2">pwrite(2)</a>/<a href="https://man.openbsd.org/pwritev.2">pwritev(2)</a> now correctly by ignored O_APPEND.
1.11 espie 138: <li>Improved conformance of header files with standards.
139: <li>Improved cancelation support in both user-threads (libpthread) and rthreads.
1.16 deraadt 140: <li>Improved correctness of execing, coredumping, signal delivery,
141: alternate signal stacks, blocking socket accepts(), mutexes and
142: condition variables, per-thread errno, symbol binding, and
143: ktracing when rthreads are in use.
144: <li>Architecture-independent kernel support for thread-control-block
145: handling for rthreads.
1.11 espie 146: <li>Small improvements to Linux compat (only available on i386).
1.57 bentley 147: <li>Multiple bugs have been fixed in the Intel 10Gb driver <a href="https://man.openbsd.org/ix.4">ix(4)</a>.
148: <li><a href="https://man.openbsd.org/softraid.4">softraid(4)</a> now supports a concatenating discipline.
149: <li>On amd64, i386, and sparc64, the root filesystem can reside in a <a href="https://man.openbsd.org/softraid.4">softraid(4)</a> volume. The kernel needs to be booted from a non-softraid partition.
150: <li>On amd64, the system can be booted from a <a href="https://man.openbsd.org/softraid.4">softraid(4)</a> RAID1 volume.
151: <li><a href="https://man.openbsd.org/aucat.1">aucat(1)</a> adds a "device number" component in <a href="https://man.openbsd.org/sndio.7">sndio(7)</a> device names, allowing a single aucat instance to handle all audio and MIDI services.
152: <li>Built-in <a href="https://man.openbsd.org/sndiod.8">sndiod(8)</a> sound daemon now uses default rate 48kHz and the default block size 10ms. These settings ensure video players and programs using MTC are smooth by default.
153: <li>Many updates to <a href="https://man.openbsd.org/smtpd.8">smtpd(8)</a>: a new scheduler_backend API introduced, more MIME 1.0 support added, new filter callbacks for network events, improved DNS error reporting and envelope handling, and the purge/ directory is now cleared via a privilege-separated child.
154: <li><a href="https://man.openbsd.org/tmux.1">tmux(1)</a> is extended to support a larger history, minimizes redundant log messages and does some code reordering for more local and less global variables. Support is added for the ESC[s and ESC[u save/restore cursor-position key sequences. $HOME (or ~) may now be used as default-path in tmux.conf.
155: <li>Enhanced <a href="https://man.openbsd.org/cwm.1">cwm(1)</a> event support, added {r,}cycleingroup to cycle through clients belonging to the same group as the active client, simplified color initialization.
156: <li>The <a href="https://man.openbsd.org/mg.1">mg(1)</a> emacs-like editor: now uses absolute filenames while pushing and popping off the stack. In dired mode: corrected cursor movements and added missing keybindings.
1.11 espie 157: </ul>
158: <p>
1.24 deraadt 159:
1.30 sobrado 160: <li>OpenSSH 6.0:
161: <ul>
162: <li>New features:
163: <ul>
1.57 bentley 164: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.30 sobrado 165: add optional checkpoints for moduli screening.
1.57 bentley 166: <li><a href="https://man.openbsd.org/ssh-add.1">ssh-add(1)</a>:
1.30 sobrado 167: new -k option to load plain keys (skipping certificates).
1.57 bentley 168: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.30 sobrado 169: add wildcard support to PermitOpen, allowing things like
170: "PermitOpen localhost:*". (bz#1857)
1.57 bentley 171: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.30 sobrado 172: support for cancelling local and remote port forwards via the multiplex
173: socket. Use "ssh -O cancel -L xx:xx:xx -R yy:yy:yy user@host" to request
174: the cancellation of the specified forwardings.
175: <li>support cancellation of local/dynamic forwardings from ~C commandline.
176: </ul>
177: <li>The following significant bugs have been fixed in this release:
178: <ul>
1.57 bentley 179: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.30 sobrado 180: ensure that $DISPLAY contains only valid characters before using it to
181: extract xauth data so that it can't be used to play local shell
182: metacharacter games.
1.57 bentley 183: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.30 sobrado 184: unbreak remote port forwarding with dynamic allocated listen ports.
1.57 bentley 185: <li><a href="https://man.openbsd.org/scp.1">scp(1)</a>:
1.33 sthen 186: suppress adding '--' to remote commandlines when the first argument does
1.30 sobrado 187: not start with '-'. Saves breakage on some difficult-to-upgrade
188: embedded/router platforms.
1.57 bentley 189: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.30 sobrado 190: and
1.57 bentley 191: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.30 sobrado 192: fix typo in IPQoS parsing: there is no "AF14" class, but there is an
193: "AF21" class.
1.57 bentley 194: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.30 sobrado 195: and
1.57 bentley 196: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.30 sobrado 197: do not permit SSH2_MSG_SERVICE_REQUEST/ACCEPT during rekeying.
1.57 bentley 198: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.30 sobrado 199: skip attempting to create ~/.ssh when -F is passed.
1.57 bentley 200: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.30 sobrado 201: unbreak stdio forwarding when ControlPersist is in use. (bz#1943)
1.57 bentley 202: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.30 sobrado 203: send tty break to pty master instead of (probably already closed) slave
204: side. (bz#1859)
1.57 bentley 205: <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
1.30 sobrado 206: silence error spam for "ls */foo" in directory with files.
207: (bz#1683)
208: <li>Fixed a number of memory and file descriptor leaks.
209: </ul>
210: </ul>
211: <p>
212:
1.58 ! deraadt 213: <li>Over 7,000 ports, major performance and stability improvements in
1.11 espie 214: the package build process
1.8 espie 215: <ul>
1.16 deraadt 216: <li>Downloading of distfiles is simpler, can resume interrupted download,
1.8 espie 217: discover file moves, and expire old files. Distfiles mirror sites now use
218: the new and improved method.
1.16 deraadt 219: <li>Dependency handling during ports build and package creation is at least
1.8 espie 220: twice as fast, twenty times as fast in pathological cases. This also affects
221: user scripts such as out-of-date
1.16 deraadt 222: <li>More checks are done during package builds, for increased user friendliness
223: <li>The long term process of documenting the infrastructure is now 100% done.
1.8 espie 224: <li>The distributed ports builder (dpb) can now clean up old dependencies,
225: thus helping package builds be more reproducible.
226: This found tens of hidden build dependencies in the ports tree already.
1.16 deraadt 227: <li>The semantics of pkg_add -a have been nailed down and a few minor bugs
1.8 espie 228: have been fixed.
1.16 deraadt 229: <li>The arch-dependent issues are better classified, leading to better builds on
1.8 espie 230: old architectures in some complicated cases. In particular, dpb explicitly
1.58 ! deraadt 231: purges from memory info about packages it cannot build and stuff that
1.8 espie 232: depends on it, leading to better life on sparc and vax which have very
233: small data-size limits.
234: <li>dpb recognizes full builds and trims some duplicate package builds
235: </ul>
236: <p>
1.1 deraadt 237: <li>Many pre-built packages for each architecture:
1.57 bentley 238: <ul style="column-count: 4">
1.1 deraadt 239: <li>i386: 7229
240: <li>sparc64: 6599
241: <li>alpha: 5943
1.28 deraadt 242: <li>sh: 2459
1.1 deraadt 243: <li>amd64: 7181
244: <li>powerpc: 6852
245: <li>sparc: 4152
1.21 sthen 246: <li>arm: 5536
1.1 deraadt 247: <li>hppa: 6159
248: <li>vax: 2199
1.15 deraadt 249: <li>mips64: 5785
1.1 deraadt 250: <li>mips64el: 5807
1.57 bentley 251: </ul>
1.1 deraadt 252: <p>
253:
254: <li>Some highlights:
255: <ul>
1.34 ajacouto 256: <li>GNOME 3.2.1 (fallback mode) <li>KDE 3.5.10
1.21 sthen 257: <li>Xfce 4.8.3 <li>MySQL 5.1.60
258: <li>PostgreSQL 9.1.2 <li>Postfix 2.8.8
259: <li>OpenLDAP 2.3.43 and 2.4.26 <li>Mozilla Firefox 3.5.19, 3.6.25 and 9.0.1
260: <li>Mozilla Thunderbird 9.0.1 <li>GHC 7.0.4
261: <li>LibreOffice 3.4.5.2 <li>Emacs 21.4, 22.3 and 23.4
262: <li>Vim 7.3.154 <li>PHP 5.2.17 and 5.3.10
263: <li>Python 2.5.4, 2.7.1 and 3.2.2 <li>Ruby 1.8.7.357 and 1.9.3.0
1.32 stu 264: <li>Tcl/Tk 8.5.11 <li>Jdk 1.7
1.21 sthen 265: <li>Mono 2.10.6 <li>Chromium 16.0.912.77
1.1 deraadt 266: <li>Groff 1.21
267: </ul>
268: <p>
269:
270: <li>As usual, steady improvements in manual pages and other documentation.
271: <li>Base system and Xenocara manuals are now installed as source code,
1.57 bentley 272: making <a href="https://man.openbsd.org/grep.1">grep(1)</a> more useful in /usr/share/man/ and /usr/X11R6/man/.
1.1 deraadt 273: <li>If both formatted and source versions of manuals are installed,
1.57 bentley 274: <a href="https://man.openbsd.org/man.1">man(1)</a> automatically displays the newer version of each page.
1.29 brett 275: <p>
1.1 deraadt 276:
1.29 brett 277: <li> The system includes the following major components from outside suppliers:
278: <ul>
1.6 matthieu 279: <li>Xenocara (based on X.Org 7.6 with xserver 1.11.4 + patches,
280: freetype 2.4.8, fontconfig 2.8.0, Mesa 7.10.3, xterm 276,
281: xkeyboard-config 2.5 and more)
1.19 matthieu 282: <li>Gcc 4.2.1 (+patches), 3.3.5 (+ patches) and 2.95.3 (+ patches)
1.1 deraadt 283: <li>Perl 5.12.2 (+ patches)
284: <li>Our improved and secured version of Apache 1.3, with
285: SSL/TLS and DSO support
1.22 gsoares 286: <li>OpenSSL 1.0.0f (+ patches)
1.1 deraadt 287: <li>Sendmail 8.14.5, with libmilter
288: <li>Bind 9.4.2-P2 (+ patches)
289: <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
290: <li>Sudo 1.7.2p8
291: <li>Ncurses 5.7
292: <li>Heimdal 0.7.2 (+ patches)
293: <li>Arla 0.35.7
294: <li>Binutils 2.15 (+ patches)
295: <li>Gdb 6.3 (+ patches)
1.29 brett 296: <li>Less 444 (+ patches)
297: <li>Awk Aug 10, 2011 version
1.1 deraadt 298: </ul>
299: </ul>
1.57 bentley 300: </section>
1.1 deraadt 301:
302: <hr>
1.57 bentley 303:
304: <section id=install>
305: <h3>How to install</h3>
306:
1.1 deraadt 307: <p>
308: Following this are the instructions which you would have on a piece of
309: paper if you had purchased a CDROM set instead of doing an alternate
310: form of install. The instructions for doing an FTP (or other style
311: of) install are very similar; the CDROM instructions are left intact
312: so that you can see how much easier it would have been if you had
313: purchased a CDROM instead.
314: <p>
315:
316: <hr>
317: Please refer to the following files on the three CDROMs or FTP mirror for
318: extensive details on how to install OpenBSD 5.1 on your machine:
319: <p>
320: <ul>
321: <li>CD1:5.1/i386/INSTALL.i386
322: <p>
323: <li>CD2:5.1/amd64/INSTALL.amd64
324: <li>CD2:5.1/macppc/INSTALL.macppc
325: <p>
326: <li>CD3:5.1/sparc64/INSTALL.sparc64
327: <p>
328: <li>FTP:.../OpenBSD/5.1/alpha/INSTALL.alpha
329: <li>FTP:.../OpenBSD/5.1/armish/INSTALL.armish
330: <li>FTP:.../OpenBSD/5.1/hp300/INSTALL.hp300
331: <li>FTP:.../OpenBSD/5.1/hppa/INSTALL.hppa
332: <li>FTP:.../OpenBSD/5.1/landisk/INSTALL.landisk
333: <li>FTP:.../OpenBSD/5.1/loongson/INSTALL.loongson
1.14 miod 334: <li>FTP:.../OpenBSD/5.1/luna88k/INSTALL.luna88k
1.1 deraadt 335: <li>FTP:.../OpenBSD/5.1/mvme68k/INSTALL.mvme68k
336: <li>FTP:.../OpenBSD/5.1/mvme88k/INSTALL.mvme88k
337: <li>FTP:.../OpenBSD/5.1/sgi/INSTALL.sgi
338: <li>FTP:.../OpenBSD/5.1/socppc/INSTALL.socppc
339: <li>FTP:.../OpenBSD/5.1/sparc/INSTALL.sparc
340: <li>FTP:.../OpenBSD/5.1/vax/INSTALL.vax
341: <li>FTP:.../OpenBSD/5.1/zaurus/INSTALL.zaurus
342: </ul>
343: <hr>
344:
1.57 bentley 345: <section id=quickinstall>
346:
1.1 deraadt 347: <p>
348: Quick installer information for people familiar with OpenBSD, and the
349: use of the "disklabel -E" command. If you are at all confused when
350: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.57 bentley 351:
352: <h3>OpenBSD/i386:</h3>
353:
1.1 deraadt 354: <p>
355: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
356: release is on CD1. If your BIOS does not support booting from CD, you will need
357: to create a boot floppy to install from. To create a boot floppy write
358: <i>CD1:5.1/i386/floppy51.fs</i> to a floppy and boot via the floppy drive.
359:
360: <p>
361: Use <i>CD1:5.1/i386/floppyB51.fs</i> instead for greater SCSI controller
362: support, or <i>CD1:5.1/i386/floppyC51.fs</i> for better laptop support.
363:
364: <p>
365: If you can't boot from a CD or a floppy disk,
366: you can install across the network using PXE as described in
367: the included INSTALL.i386 document.
368:
369: <p>
370: If you are planning on dual booting OpenBSD with another OS, you will need to
371: read INSTALL.i386.
372:
373: <p>
374: To make a boot floppy under MS-DOS, use the "rawrite" utility located
375: at <i>CD1:5.1/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
376: use the
1.57 bentley 377: <a href="https://man.openbsd.org/dd.1">dd(1)</a>
1.1 deraadt 378: utility. The following is an example usage of
1.57 bentley 379: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.1 deraadt 380: where the device could be "floppy", "rfd0c", or
381: "rfd0a".
382:
1.57 bentley 383: <blockquote><pre>
1.1 deraadt 384: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
1.57 bentley 385: </pre></blockquote>
1.1 deraadt 386:
387: <p>
388: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
389: your install will most likely fail. For more information on creating a boot
390: floppy and installing OpenBSD/i386 please refer to
1.52 tj 391: <a href="faq/faq4.html#MkFlop">this page</a>.
1.57 bentley 392:
393: <h3>OpenBSD/amd64:</h3>
1.1 deraadt 394:
395: <p>
396: The 5.1 release of OpenBSD/amd64 is located on CD2.
397: Boot from the CD to begin the install - you may need to adjust
398: your BIOS options first.
399: If you can't boot from the CD, you can create a boot floppy to install from.
400: To do this, write <i>CD2:5.1/amd64/floppy51.fs</i> to a floppy, then
401: boot from the floppy drive.
402:
403: <p>
404: If you can't boot from a CD or a floppy disk,
405: you can install across the network using PXE as described in the included
406: INSTALL.amd64 document.
407:
408: <p>
409: If you are planning to dual boot OpenBSD with another OS, you will need to
410: read INSTALL.amd64.
1.57 bentley 411:
412: <h3>OpenBSD/macppc:</h3>
1.1 deraadt 413:
414: <p>
415: Put CD2 in your CDROM drive and poweron your machine while holding down the
416: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
417:
418: <p>
419: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
420: /5.1/macppc/bsd.rd</i>
1.57 bentley 421:
422: <h3>OpenBSD/sparc64:</h3>
1.1 deraadt 423:
424: <p>
425: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
426:
427: <p>
428: If this doesn't work, or if you don't have a CDROM drive, you can write
429: <i>CD3:5.1/sparc64/floppy51.fs</i> or <i>CD3:5.1/sparc64/floppyB51.fs</i>
430: (depending on your machine) to a floppy and boot it with <i>boot
431: floppy</i>. Refer to INSTALL.sparc64 for details.
432:
433: <p>
434: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
435: will most likely fail.
436:
437: <p>
438: You can also write <i>CD3:5.1/sparc64/miniroot51.fs</i> to the swap partition on
439: the disk and boot with <i>boot disk:b</i>.
440:
441: <p>
442: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.57 bentley 443:
444: <h3>OpenBSD/alpha:</h3>
1.1 deraadt 445:
446: <p>
1.57 bentley 447: Write <i>FTP:5.1/alpha/floppy51.fs</i> or
1.1 deraadt 448: <i>FTP:5.1/alpha/floppyB51.fs</i> (depending on your machine) to a diskette and
449: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
450:
451: <p>
452: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
453: will most likely fail.
454:
1.57 bentley 455: <h3>OpenBSD/armish:</h3>
1.1 deraadt 456:
457: <p>
458: After connecting a serial port, Thecus can boot directly from the network
459: either tftp or http. Configure the network using fconfig, reset,
460: then load bsd.rd, see INSTALL.armish for specific details.
461: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
462: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
463: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
464: More details are available in INSTALL.armish.
465:
1.57 bentley 466: <h3>OpenBSD/hp300:</h3>
467:
1.1 deraadt 468: <p>
469: Boot over the network by following the instructions in INSTALL.hp300.
1.57 bentley 470:
471: <h3>OpenBSD/hppa:</h3>
1.1 deraadt 472:
473: <p>
474: Boot over the network by following the instructions in INSTALL.hppa or the
475: <a href="hppa.html#install">hppa platform page</a>.
476:
1.57 bentley 477: <h3>OpenBSD/landisk:</h3>
478:
1.1 deraadt 479: <p>
480: Write <i>miniroot51.fs</i> to the start of the CF
481: or disk, and boot normally.
482:
1.57 bentley 483: <h3>OpenBSD/loongson:</h3>
484:
1.1 deraadt 485: <p>
486: Write <i>miniroot51.fs</i> to a USB stick and boot bsd.rd from it
487: or boot bsd.rd via tftp.
488: Refer to the instructions in INSTALL.loongson for more details.
489:
1.57 bentley 490: <h3>OpenBSD/luna88k:</h3>
491:
1.14 miod 492: <p>
493: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
494: Alternatively, you can create a bootable tape and boot from it. Refer to
495: the instructions in INSTALL.luna88k for more details.
496:
1.57 bentley 497: <h3>OpenBSD/mvme68k:</h3>
498:
1.1 deraadt 499: <p>
500: You can create a bootable installation tape or boot over the network.<br>
501: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
502: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
503: for more details.
1.57 bentley 504:
505: <h3>OpenBSD/mvme88k:</h3>
1.1 deraadt 506:
507: <p>
508: You can create a bootable installation tape or boot over the network.<br>
509: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
510: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
511: for more details.
512:
1.57 bentley 513: <h3>OpenBSD/sgi:</h3>
514:
1.1 deraadt 515: <p>
516: To install on an O2, burn cd51.iso on a CD-R, put it in the CD drive of your
517: machine and select <i>Install System Software</i> from the System Maintenance
518: menu.
519:
520: <p>
521: On other systems, or if your machine doesn't have a CD drive, you can
522: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
523: the kernel matching your system type.
524: Refer to the instructions in INSTALL.sgi for more details.
525:
1.57 bentley 526: <h3>OpenBSD/socppc:</h3>
527:
1.1 deraadt 528: <p>
529: After connecting a serial port, boot over the network via DHCP/tftp.
530: Refer to the instructions in INSTALL.socppc for more details.
1.57 bentley 531:
532: <h3>OpenBSD/sparc:</h3>
1.1 deraadt 533:
534: <p>
535: Boot from one of the provided install ISO images, using one of the two
536: commands listed below, depending on the version of your ROM.
537:
1.57 bentley 538: <blockquote><pre>
539: ok <kbd>boot cdrom 5.1/sparc/bsd.rd</kbd>
1.1 deraadt 540: or
1.57 bentley 541: > <kbd>b sd(0,6,0)5.1/sparc/bsd.rd</kbd>
542: </pre></blockquote>
1.1 deraadt 543:
544: <p>
545: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
546: To do so you need to write <i>floppy51.fs</i> to a floppy.
1.52 tj 547: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.1 deraadt 548: To boot from the floppy use one of the two commands listed below,
549: depending on the version of your ROM.
550:
1.57 bentley 551: <blockquote><pre>
552: ok <kbd>boot floppy</kbd>
1.1 deraadt 553: or
1.57 bentley 554: > <kbd>b fd()</kbd>
555: </pre></blockquote>
1.1 deraadt 556:
557: <p>
558: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
559: will most likely fail.
560:
561: <p>
562: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
563: setup a bootable tape, or install via network, as told in the
564: INSTALL.sparc file.
1.57 bentley 565:
566: <h3>OpenBSD/vax:</h3>
1.1 deraadt 567:
568: <p>
569: Boot over the network via mopbooting as described in INSTALL.vax.
1.57 bentley 570:
571: <h3>OpenBSD/zaurus:</h3>
1.1 deraadt 572:
573: <p>
574: Using the Linux built-in graphical ipkg installer, install the
575: openbsd51_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
576: for a few important details.
1.57 bentley 577:
578: </section>
579:
580: <section id=sourcecode>
581: <h3>Notes about the source code:</h3>
1.1 deraadt 582:
583: <p>
584: src.tar.gz contains a source archive starting at /usr/src. This file
585: contains everything you need except for the kernel sources, which are
586: in a separate archive. To extract:
1.57 bentley 587:
588: <blockquote><pre>
589: # <kbd>mkdir -p /usr/src</kbd>
590: # <kbd>cd /usr/src</kbd>
591: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
592: </pre></blockquote>
593:
1.1 deraadt 594: <p>
595: sys.tar.gz contains a source archive starting at /usr/src/sys.
596: This file contains all the kernel sources you need to rebuild kernels.
597: To extract:
1.57 bentley 598:
599: <blockquote><pre>
600: # <kbd>mkdir -p /usr/src/sys</kbd>
601: # <kbd>cd /usr/src</kbd>
1.1 deraadt 602: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
1.57 bentley 603: </pre></blockquote>
604:
1.1 deraadt 605: <p>
606: Both of these trees are a regular CVS checkout. Using these trees it
607: is possible to get a head-start on using the anoncvs servers as
608: described <a href="anoncvs.html">here</a>.
609: Using these files
610: results in a much faster initial CVS update than you could expect from
611: a fresh checkout of the full OpenBSD source tree.
612:
1.57 bentley 613: </section>
614: </section>
615:
1.1 deraadt 616: <hr>
1.57 bentley 617:
618: <section id=upgrade>
619: <h3>How to upgrade</h3>
1.1 deraadt 620: <p>
1.2 deraadt 621: If you already have an OpenBSD 5.0 system, and do not want to reinstall,
1.1 deraadt 622: upgrade instructions and advice can be found in the
623: <a href="faq/upgrade51.html">Upgrade Guide</a>.
1.57 bentley 624: </section>
1.1 deraadt 625:
626: <hr>
1.57 bentley 627:
628: <section id=ports>
629: <h3>Ports Tree</h3>
1.1 deraadt 630: <p>
631: A ports tree archive is also provided. To extract:
632: <p>
1.57 bentley 633: <blockquote><pre>
634: # <kbd>cd /usr</kbd>
635: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
636: # <kbd>cd ports</kbd>
637: </pre></blockquote>
1.1 deraadt 638: <p>
639: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
640: read the <a href="faq/ports/index.html">ports</a> page
641: if you know nothing about ports
642: at this point. This text is not a manual of how to use ports.
643: Rather, it is a set of notes meant to kickstart the user on the
644: OpenBSD ports system.
645: <p>
646: The <i>ports/</i> directory represents a CVS (see the manpage for
1.57 bentley 647: <a href="https://man.openbsd.org/cvs.1">
1.1 deraadt 648: cvs(1)</a> if
649: you aren't familiar with CVS) checkout of our ports. As with our complete
650: source tree, our ports tree is available via anoncvs. So, in
651: order to keep current with it, you must make the <i>ports/</i> tree
652: available on a read-write medium and update the tree with a command
653: like:
654: <p>
1.57 bentley 655: <blockquote><pre>
1.2 deraadt 656: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_1</strong>
1.57 bentley 657: </pre></blockquote>
1.1 deraadt 658: <p>
659: [Of course, you must replace the local directory and server name here
660: with the location of your ports collection and a nearby anoncvs
661: server.]
662: <p>
663: Note that most ports are available as packages through FTP. Updated
664: packages for the 5.1 release will be made available if problems arise.
665: <p>
666: If you're interested in seeing a port added, would like to help out, or just
667: would like to know more, the mailing list ports@openbsd.org is a good
668: place to know.
1.57 bentley 669: </section>