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