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