Annotation of www/50.html, Revision 1.31
1.31 ! bentley 1: <!doctype html>
! 2: <html lang=en id=release>
! 3: <meta charset=utf-8>
! 4:
1.14 deraadt 5: <title>OpenBSD 5.0</title>
1.1 deraadt 6: <meta name="description" content="OpenBSD 5.0">
1.24 tj 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.26 tb 9: <link rel="canonical" href="https://www.openbsd.org/50.html">
1.31 ! 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.31 ! bentley 24: <h2 id=OpenBSD>
1.1 deraadt 25: <a href="index.html">
1.31 ! bentley 26: <i>Open</i><b>BSD</b></a>
! 27: 5.0
1.24 tj 28: </h2>
1.1 deraadt 29:
1.31 ! bentley 30: <table>
! 31: <tr>
! 32: <td>
1.1 deraadt 33: <a href="images/MAD.jpg">
1.31 ! bentley 34: <img width="227" height="343" src="images/MAD.jpg" alt="MAD"></a>
! 35: <td>
1.7 dcoppa 36: Released Nov 1, 2011<br>
1.1 deraadt 37: Copyright 1997-2011, Theo de Raadt.<br>
1.31 ! bentley 38: <cite class=isbn>ISBN 978-0-9784475-8-8</cite>
1.1 deraadt 39: <br>
1.21 deraadt 40: 5.0 Song: <a href="lyrics.html#50">"What Me Worry?"</a>
1.30 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.31 ! bentley 46: <li>Go to the <code class=reldir>pub/OpenBSD/5.0/</code> directory on
1.1 deraadt 47: one of the mirror sites.
48: <li>Have a look at <a href="errata50.html">The 5.0 Errata page</a> for a list
49: of bugs and workarounds.
50: <li>See a <a href="plus50.html">detailed log of changes</a> between the
51: 4.9 and 5.0 releases.
52: </ul>
1.24 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.31 ! bentley 57: </table>
1.24 tj 58:
59: <hr>
1.1 deraadt 60:
1.31 ! 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.0.
66: For a comprehensive list, see the <a href="plus50.html">changelog</a> leading
67: to 5.0.
68: <p>
69:
70: <ul>
71:
1.2 deraadt 72: <li>Improved hardware support, including:
73: <ul>
74: <li>MSI interrupts for many devices, on those architectures which can
75: support them (amd64, i386, sparc64 only so far).
1.31 ! bentley 76: <li>A new <a href="https://man.openbsd.org/dma_alloc.9">dma_alloc(9)</a> API makes it easier for kernel code to allocate
1.2 deraadt 77: dma-safe memory. Many drivers (especially network drivers) and
78: subsystems (in particular scsi and the buffer cache) were adapted
79: to use this.
80: <li>As a result, big-memory support has been enabled on all possible
81: architectures.
1.31 ! bentley 82: <li>The rather rare <a href="https://man.openbsd.org/bce.4">bce(4)</a> driver now copies mbufs all the time, to cope
1.2 deraadt 83: with the hardware having a 1GB limit.
1.31 ! bentley 84: <li>Added <a href="https://man.openbsd.org/hds.4">hds(4)</a>, a driver for Hitachi Modular Storage SCSI devices.
! 85: <li>Added <a href="https://man.openbsd.org/myx.4">myx(4)</a>, a driver for the Myricom Myri-10G 10GB Ethernet devices.
! 86: <li>Added <a href="https://man.openbsd.org/macppc/dfs.4">dfs(4)</a>, a driver for Dynamic Frequency Switching on some macppc
1.2 deraadt 87: systems.
1.31 ! bentley 88: <li><a href="https://man.openbsd.org/cardbus.4">cardbus(4)</a> and <a href="https://man.openbsd.org/pcmcia.4">pcmcia(4)</a> support on sgi.
1.2 deraadt 89: <li>Suspend/resume support on Loongson Yeelong laptops.
90: </ul>
91: <p>
92:
93: <li>Generic network stack improvements:
94: <ul>
1.31 ! bentley 95: <li>Added support for sending Wake on Lan packets using <a href="https://man.openbsd.org/arp.8">arp(8)</a>.
! 96: <li>Permit turning Wake on Lan support on/off using <a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a>.
! 97: <li>Added Wake on Lan support to <a href="https://man.openbsd.org/xl.4">xl(4)</a>, <a href="https://man.openbsd.org/re.4">re(4)</a>, and <a href="https://man.openbsd.org/vr.4">vr(4)</a>.
! 98: <li>Allow <a href="https://man.openbsd.org/ftp-proxy.8">ftp-proxy(8)</a> to proxy across rdomains.
1.2 deraadt 99: <li>The IPv4 stack will no longer accept ICMP redirects when
100: acting as a router.
101: <li>By default the IPv6 stack will not process ICMP6 redirects.
1.31 ! bentley 102: <a href="https://man.openbsd.org/rtsol.8">rtsol(8)</a> will turn it back if -F is used.
! 103: <li>Reworked large parts of the <a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> options processing for better
1.2 deraadt 104: interoperability.
1.31 ! bentley 105: <li>Fixed <a href="https://man.openbsd.org/carp.4">carp(4)</a> to work in IPv6 only setups.
! 106: <li>Make it possible to <a href="https://man.openbsd.org/bind.2">bind(2)</a> to the local network broadcast address
1.2 deraadt 107: on datagram and raw sockets.
108: <li>The default multicast reject route is now ignored if the UDP socket
109: uses the IP_MULTICAST_IF socket option.
1.31 ! bentley 110: <li>Make <a href="https://man.openbsd.org/gre.4">gre(4)</a> work between systems in the same LAN.
! 111: <li>Removed the link1 mode special addressing mode on <a href="https://man.openbsd.org/lo.4">lo(4)</a>.
1.2 deraadt 112: <li>Kernel randomization speed and quality improved substantially.
113: </ul>
114: <p>
115:
116: <li>Routing daemons and other userland network improvements:
117: <ul>
1.31 ! bentley 118: <li><a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> no longer bumps the rlimits: the rc.d framework respects
1.2 deraadt 119: login classes which is a much better solution.
1.31 ! bentley 120: <li>Correctly set the network filtersets on reload in <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>.
1.2 deraadt 121: <li>The routing socket is now sending RTM_DESYNC messages if the
122: socketbuffer overflows.
1.31 ! bentley 123: <li>Allow <a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a> to send out LS updates and other messages
1.2 deraadt 124: larger than the MTU.
1.31 ! bentley 125: <li>Fixed nexthop calculation in <a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a> for directly connected P2P links.
! 126: <li>First bits to support opaque LSA in <a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a>. Only basic redistribute
1.2 deraadt 127: logic and LSDB handling for now.
1.31 ! bentley 128: <li>Creating new interfaces will no longer cause a fatal error in <a href="https://man.openbsd.org/ospf6d.8">ospf6d(8)</a>.
! 129: <li><a href="https://man.openbsd.org/ospf6d.8">ospf6d(8)</a> handles link-state changes better.
! 130: <li>Better loopback handling in <a href="https://man.openbsd.org/ospf6d.8">ospf6d(8)</a>.
! 131: <li>No longer install extra multicast routes in <a href="https://man.openbsd.org/ripd.8">ripd(8)</a> and <a href="https://man.openbsd.org/ldpd.8">ldpd(8)</a>.
! 132: <li>Make <a href="https://man.openbsd.org/kqueue.2">kqueue(2)</a> work with <a href="https://man.openbsd.org/sosplice.9">sosplice(9)</a>.
! 133: <li>Enabled <a href="https://man.openbsd.org/sosplice.9">sosplice(9)</a> in <a href="https://man.openbsd.org/relayd.8">relayd(8)</a> for TCP.
1.2 deraadt 134: <li>Added support for divert-to which provides some benefits over
1.31 ! bentley 135: rdr-to in <a href="https://man.openbsd.org/relayd.8">relayd(8)</a>.
! 136: <li>Fixed trap sending in <a href="https://man.openbsd.org/snmpd.8">snmpd(8)</a>.
! 137: <li>Make <a href="https://man.openbsd.org/ping6.8">ping6(8)</a> compare minimum amount of bytes between what
1.2 deraadt 138: was received and what was sent out.
1.31 ! bentley 139: <li>Make <a href="https://man.openbsd.org/traceroute.8">traceroute(8)</a> with type-of-service setted (-t) display
1.2 deraadt 140: a message if the returned packet has a different tos type.
141: <li>Added the socket splicing fields of struct socket to netstat -vP output.
142: </ul>
143: <p>
144:
1.31 ! bentley 145: <li><a href="https://man.openbsd.org/pf.4">pf(4)</a> improvements:
1.2 deraadt 146: <ul>
1.31 ! bentley 147: <li>Make <a href="https://man.openbsd.org/pf.4">pf(4)</a> reassemble IPv6 fragments. In the forward case, pf
1.2 deraadt 148: refragments the packets with the same maximum size.
1.31 ! bentley 149: <li>Allow <a href="https://man.openbsd.org/pf.4">pf(4)</a> to filter on the rdomain a packet belongs to.
! 150: <li>Make <a href="https://man.openbsd.org/pf.4">pf(4)</a> allow userland proxies to establish cross rdomain
1.2 deraadt 151: proxy sessions.
1.31 ! bentley 152: <li>Added IPv6 ACK prioritization in <a href="https://man.openbsd.org/pf.4">pf(4)</a>.
1.12 nick 153: <li>Change 'set skip on <...>' to work with interface groups.
1.31 ! bentley 154: <li><a href="https://man.openbsd.org/pfsync.4">pfsync(4)</a> supports IPv6 as network protocol.
! 155: <li>Switched <a href="https://man.openbsd.org/ftp-proxy.8">ftp-proxy(8)</a> over to divert-to instead of rdr-to.
! 156: <li><a href="https://man.openbsd.org/tftp-proxy.8">tftp-proxy(8)</a> uses 'divert-to' as well.
1.2 deraadt 157: </ul>
158: <p>
159:
160: <li>SCSI improvements:
161: <ul>
162: <li>most SCSI hardware drivers now use the new iopools infrastructure.
1.31 ! bentley 163: <li><a href="https://man.openbsd.org/sci.4">scsi(4)</a> devices are now all provided with a unique devid, which
1.2 deraadt 164: is displayed during the probe process.
165: <li>ASC/ASCQ error codes and verbiage now in sync with
166: http://www.t10.org/lists/asc-num.txt.
167: <li>progress on iSCSI includes better login, better logout, preliminary
1.31 ! bentley 168: FSM support in <a href="https://man.openbsd.org/iscsid.8">iscsid(8)</a>, and improved logging and debug information.
! 169: <li><a href="https://man.openbsd.org/uk.4">uk(4)</a> can now safely and reliably detach an unknown SCSI device.
! 170: <li><a href="https://man.openbsd.org/mpath.4">mpath(4)</a> device and kernel support is improved.
! 171: <li><a href="https://man.openbsd.org/vscsi.4">vscsi(4)</a> now ensures output always goes to the correct connection.
! 172: <li><a href="https://man.openbsd.org/vscsi.4">vscsi(4)</a> connections can now be reset gracefully.
! 173: <li><a href="https://man.openbsd.org/scsi.4">scsi(4)</a> devices on fibre channel fabrics no longer inherit the adapter's
1.2 deraadt 174: address.
175: </ul>
176: <p>
177:
178: <li>Assorted improvements:
179: <ul>
1.31 ! bentley 180: <li>For additional security, <a href="https://man.openbsd.org/security.8">security(8)</a> was rewritten in Perl.
! 181: <li>Mandoc 1.11.4: Now accepts <a href="https://man.openbsd.org/eqn.7">eqn(7)</a> input (no fancy formatting yet)
1.2 deraadt 182: and supports -Tutf8 output (but no utf8 input yet).
183: <li>Removed a variety of OS-compat emulation code, leaving just the Linux
184: support.
185: <li>Small improvements to Linux compat (only available on i386).
1.31 ! bentley 186: <li>Improved our own <a href="https://man.openbsd.org/pkg-config.1">pkg-config(1)</a> implementation with extended comparison
1.2 deraadt 187: scheme and implementing various new options.
188: <li>The math library, libm, was fully fleshed out to support all C99 required
189: parts. Many bugs for various architectures were fixed along the way.
1.31 ! bentley 190: <li><a href="https://man.openbsd.org/malloc.3">malloc(3)</a> is a lot faster and has a few further security features (more
1.2 deraadt 191: randomization, as well as the 'S' flag to enable all paranoia checks).
192: <li>'make depend' is no longer neccessary in kernel compilation directories
193: since the dependencies are calculated automatically.
194: <li>Increased the default size of the buffer cache.
1.31 ! bentley 195: <li><a href="https://man.openbsd.org/kqueue.2">kqueue(2)</a> now works on /dev/random and spliced sockets
1.2 deraadt 196: <li>On MBR-based disks, scan through up to 256 extended partition tables
197: when looking for an OpenBSD partition table.
1.31 ! bentley 198: <li>Added POSIX 2008 <a href="https://man.openbsd.org/fdopendir.3">fdopendir(3)</a> and <a href="https://man.openbsd.org/opennat.2">openat(2)</a> functions, as well as the
1.2 deraadt 199: O_CLOEXEC, O_DIRECTORY, and F_DUPFD_CLOEXEC flags.
200: <li>Improved lint format string checks and added a few other checks.
1.31 ! bentley 201: <li><a href="https://man.openbsd.org/kdump.1">kdump(1)</a> now dumps stat and sockaddr structures, sysctl mib
1.2 deraadt 202: strings, and decodes syscall flags and operation bits.
203: <li>Improved kernel pool debug checking.
204: <li>Improved correctness of signals and various syscalls when rthreads
205: are in use.
1.31 ! bentley 206: <li>Kernel <a href="https://man.openbsd.org/malloc.9">malloc(9)</a> space and stacks moved to non-dma memory.
1.2 deraadt 207: <li>Fixed some shutdown/reboot hangs on NFS clients.
208: <li>UNIX-domain socket paths are now guaranteed to be NUL-terminated.
1.31 ! bentley 209: <li>Added support for <a href="https://man.openbsd.org/wprintf.3">*wprintf(3)</a>, <a href="https://man.openbsd.org/wcscasecmp.3">wcs{,n}casecmp(3)</a>, and <a href="https://man.openbsd.org/wcsdup.3">wcsdup(3)</a>.
1.2 deraadt 210: <li>NULL is now a (void *).
211: </ul>
212: <p>
213:
214: <li>Install/Upgrade process changes:
215: <ul>
216: <li>Completed support for DUID disk installs, and enabled it fully.
1.31 ! bentley 217: <li>Tried to make <a href="https://man.openbsd.org/sysmerge.8">sysmerge(8)</a> work in the installer, but ran into small
1.2 deraadt 218: problems and decided to disable it.
219: <li>Install non-free firmwares from the internet upon first boot, based on a
220: question in the installer.
1.31 ! bentley 221: <li><a href="https://man.openbsd.org/svnd.4">svnd(4)</a>-like behaviour became the default for <a href="https://man.openbsd.org/vnd.4">vnd(4)</a> devices. This is
1.2 deraadt 222: what is used to build the media.
223: </ul>
224: <p>
225:
1.31 ! bentley 226: <li><a href="https://man.openbsd.org/rc.d.8">rc.d(8)</a> framework improvements:
1.2 deraadt 227: <ul>
1.31 ! bentley 228: <li><a href="https://man.openbsd.org/rc.d.8">rc.d(8)</a> is now also used for the base system daemons.
1.2 deraadt 229: <li>Backward compatible with the historic way of starting daemons.
230: <li>Notify the user by appending (ok) or (failed) in interactive mode.
231: <li>Better diagnostics with the introduction of RC_DEBUG.
232: </ul>
233: <p>
234:
1.5 djm 235: <li>OpenSSH 5.9:
1.2 deraadt 236: <ul>
237: <li>New features:
238: <ul>
1.5 djm 239: <li>Introduce sandboxing of the pre-auth privsep child using an optional
1.31 ! bentley 240: <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
1.5 djm 241: "UsePrivilegeSeparation=sandbox" mode that enables mandatory
242: restrictions on the syscalls the privsep child can perform.
243: <li>Add new SHA256-based HMAC transport integrity modes from
1.28 tb 244: https://www.ietf.org/id/draft-dbider-sha2-mac-for-ssh-02.txt
1.5 djm 245: These modes are hmac-sha2-256, hmac-sha2-256-96, hmac-sha2-512,
246: and hmac-sha2-512-96, and are available by default in
1.31 ! bentley 247: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.5 djm 248: and
1.31 ! bentley 249: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>.
1.5 djm 250: <li>The pre-authentication
1.31 ! bentley 251: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.5 djm 252: privilege separation slave process now logs via a socket shared with
253: the master process, avoiding the need to maintain /dev/log inside the
254: chroot.
1.31 ! bentley 255: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.5 djm 256: now warns when a server refuses X11 forwarding.
1.31 ! bentley 257: <li><a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>'s
1.5 djm 258: AuthorizedKeysFile now accepts multiple paths, separated by whitespace.
259: The undocumented AuthorizedKeysFile2 option is deprecated (though the
260: default for AuthorizedKeysFile includes .ssh/authorized_keys2).
1.31 ! bentley 261: <li><a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>:
1.5 djm 262: similarly deprecate UserKnownHostsFile2 and GlobalKnownHostsFile2 by
263: making UserKnownHostsFile and GlobalKnownHostsFile accept multiple
264: options and default to include known_hosts2.
1.31 ! bentley 265: <li><a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>'s
1.5 djm 266: ControlPath option now expands %L to the host portion of the
267: destination host name.
1.31 ! bentley 268: <li><a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
1.5 djm 269: "Host" options now support negated Host matching.
1.31 ! bentley 270: <li><a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>:
1.5 djm 271: a new RequestTTY option provides control over when a TTY is requested
272: for a connection, similar to the existing -t/-tt/-T
1.31 ! bentley 273: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.5 djm 274: commandline options.
1.31 ! bentley 275: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.5 djm 276: Add -A option. For each of the key types (rsa1, rsa, dsa and ecdsa) for
277: which host keys do not exist, generate the host keys with the default
278: key file path, an empty passphrase, default bits for the key type, and
279: default comment. This is useful for system initialisation scripts.
1.31 ! bentley 280: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.5 djm 281: Allow graceful shutdown of multiplexing: request that a mux server
282: removes its listener socket and refuse future multiplexing requests but
283: don't kill existing connections. This may be requested using
284: "ssh -O stop ...".
1.31 ! bentley 285: <li><a href="https://man.openbsd.org/ssh-add.1">ssh-add(1)</a>:
1.5 djm 286: now accepts keys piped from standard input.
1.2 deraadt 287: </ul>
288: <li>The following significant bugs have been fixed in this release:
289: <ul>
1.5 djm 290: <li>Retain key comments when loading v.2 keys. These will be visible in
291: "ssh-add -l" and other places. (bz#439)
1.31 ! bentley 292: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.5 djm 293: and
1.31 ! bentley 294: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.5 djm 295: set IPv6 traffic class from IPQoS (as well as IPv4 ToS/DSCP). (bz#1855)
1.31 ! bentley 296: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.5 djm 297: allow GSSAPI authentication to detect when a server-side failure causes
298: authentication failure and don't count such failures against
299: MaxAuthTries. (bz#1244)
1.31 ! bentley 300: <li><a href="https://man.openbsd.org/ssh-keysign.8">ssh-keysign(8)</a>:
1.5 djm 301: now signs hostbased authentication challenges correctly using ECDSA
302: keys. (bz#1858)
1.31 ! bentley 303: <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
1.5 djm 304: document that sftp accepts square brackets to delimit addresses
305: (useful for IPv6). (bz#1847a)
1.31 ! bentley 306: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.5 djm 307: when using session multiplexing, the master process will change its
308: process title to reflect the control path in use and when a
309: ControlPersist-ed master is waiting to close. (bz#1883 and bz#1911)
1.9 sobrado 310: <li>Other minor bugs fixed: bz#1849, bz#1861, bz#1862, bz#1869, bz#1875,
311: bz#1878, bz#1879, bz#1892, bz#1900, bz#1905, and bz#1913.
1.2 deraadt 312: </ul>
313: </ul>
314: <p>
315:
316: <li>Over 7,200 ports, major robustness and speed improvements in package tools.
317: <li>Many pre-built packages for each architecture:
1.31 ! bentley 318: <ul style="column-count: 4">
1.2 deraadt 319: <li>i386: 7008
320: <li>sparc64: 6456
321: <li>alpha: 6046
322: <li>sh: 3721
323: <li>amd64: 6960
324: <li>powerpc: 6691
325: <li>sparc: 3277
326: <li>arm: 2963
327: <li>hppa: 6125
328: <li>vax: 1409
329: <li>mips64: 5689
330: <li>mips64el: 5709
1.31 ! bentley 331: </ul>
1.2 deraadt 332: <p>
333:
334: <li>Some highlights:
335: <ul>
336: <li>Gnome 2.32.2 <li>KDE 3.5.10
337: <li>Xfce 4.8.0 <li>MySQL 5.1.54
338: <li>PostgreSQL 9.0.5 <li>Postfix 2.8.4
339: <li>OpenLDAP 2.3.43 and 2.4.25 <li>Mozilla Firefox 3.5.19, 3.6.18 and 5.0
340: <li>Mozilla Thunderbird 5.0 <li>GHC 7.0.4
341: <li>LibreOffice 3.4.1.3 <li>Emacs 21.4, 22.3 and 23.3
342: <li>Vim 7.3.154 <li>PHP 5.2.17 and 5.3.6
343: <li>Python 2.4.6, 2.5.4 and 2.7.1 <li>Ruby 1.8.7.352 and 1.9.2.200
1.10 stu 344: <li>Tcl 8.5.9 <li>Jdk 1.7
1.2 deraadt 345: <li>Mono 2.10.2 <li>Chromium 12.0.742.122
346: <li>Groff 1.21
347: </ul>
348: <p>
349:
350: <li>As usual, steady improvements in manual pages and other documentation.
351: <li>Base system and Xenocara manuals are now installed as source code,
1.31 ! bentley 352: making <a href="https://man.openbsd.org/grep.1">grep(1)</a> more useful in /usr/share/man/ and /usr/X11R6/man/.
1.2 deraadt 353: <li>If both formatted and source versions of manuals are installed,
1.31 ! bentley 354: <a href="https://man.openbsd.org/man.1">man(1)</a> automatically displays the newer version of each page.
1.2 deraadt 355:
1.31 ! bentley 356: <li>The system includes the following major components from outside suppliers:
! 357: <ul>
1.2 deraadt 358: <li>Xenocara (based on X.Org 7.6 with xserver 1.9 + patches,
359: freetype 2.4.5, fontconfig 2.8.0, Mesa 7.8.2, xterm 270,
360: xkeyboard-config 2.3 and more)
361: <li>Gcc 2.95.3 (+ patches), 3.3.5 (+ patches) and 4.2.1 (+patches)
362: <li>Perl 5.12.2 (+ patches)
363: <li>Our improved and secured version of Apache 1.3, with
364: SSL/TLS and DSO support
365: <li>OpenSSL 1.0.0a (+ patches)
366: <li>Sendmail 8.14.5, with libmilter
367: <li>Bind 9.4.2-P2 (+ patches)
368: <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
369: <li>Sudo 1.7.2p8
370: <li>Ncurses 5.7
371: <li>Heimdal 0.7.2 (+ patches)
372: <li>Arla 0.35.7
373: <li>Binutils 2.15 (+ patches)
374: <li>Gdb 6.3 (+ patches)
375: </ul>
1.1 deraadt 376:
377: </ul>
1.31 ! bentley 378: </section>
1.1 deraadt 379:
380: <hr>
1.31 ! bentley 381:
! 382: <section id=install>
! 383: <h3>How to install</h3>
! 384:
1.1 deraadt 385: <p>
386: Following this are the instructions which you would have on a piece of
387: paper if you had purchased a CDROM set instead of doing an alternate
388: form of install. The instructions for doing an FTP (or other style
389: of) install are very similar; the CDROM instructions are left intact
390: so that you can see how much easier it would have been if you had
391: purchased a CDROM instead.
392: <p>
393:
394: <hr>
395: Please refer to the following files on the three CDROMs or FTP mirror for
396: extensive details on how to install OpenBSD 5.0 on your machine:
397: <p>
398: <ul>
399: <li>CD1:5.0/i386/INSTALL.i386
400: <p>
401: <li>CD2:5.0/amd64/INSTALL.amd64
402: <li>CD2:5.0/macppc/INSTALL.macppc
403: <p>
404: <li>CD3:5.0/sparc64/INSTALL.sparc64
405: <p>
406: <li>FTP:.../OpenBSD/5.0/alpha/INSTALL.alpha
407: <li>FTP:.../OpenBSD/5.0/armish/INSTALL.armish
408: <li>FTP:.../OpenBSD/5.0/hp300/INSTALL.hp300
409: <li>FTP:.../OpenBSD/5.0/hppa/INSTALL.hppa
410: <li>FTP:.../OpenBSD/5.0/landisk/INSTALL.landisk
411: <li>FTP:.../OpenBSD/5.0/loongson/INSTALL.loongson
412: <li>FTP:.../OpenBSD/5.0/mvme68k/INSTALL.mvme68k
413: <li>FTP:.../OpenBSD/5.0/mvme88k/INSTALL.mvme88k
414: <li>FTP:.../OpenBSD/5.0/sgi/INSTALL.sgi
415: <li>FTP:.../OpenBSD/5.0/socppc/INSTALL.socppc
416: <li>FTP:.../OpenBSD/5.0/sparc/INSTALL.sparc
417: <li>FTP:.../OpenBSD/5.0/vax/INSTALL.vax
418: <li>FTP:.../OpenBSD/5.0/zaurus/INSTALL.zaurus
419: </ul>
420: <hr>
421:
1.31 ! bentley 422: <section id=quickinstall>
! 423:
1.1 deraadt 424: <p>
425: Quick installer information for people familiar with OpenBSD, and the
426: use of the "disklabel -E" command. If you are at all confused when
427: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.31 ! bentley 428:
! 429: <h3>OpenBSD/i386:</h3>
! 430:
1.1 deraadt 431: <p>
432: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
433: release is on CD1. If your BIOS does not support booting from CD, you will need
434: to create a boot floppy to install from. To create a boot floppy write
435: <i>CD1:5.0/i386/floppy50.fs</i> to a floppy and boot via the floppy drive.
436:
437: <p>
438: Use <i>CD1:5.0/i386/floppyB50.fs</i> instead for greater SCSI controller
439: support, or <i>CD1:5.0/i386/floppyC50.fs</i> for better laptop support.
440:
441: <p>
442: If you can't boot from a CD or a floppy disk,
443: you can install across the network using PXE as described in
444: the included INSTALL.i386 document.
445:
446: <p>
447: If you are planning on dual booting OpenBSD with another OS, you will need to
448: read INSTALL.i386.
449:
450: <p>
451: To make a boot floppy under MS-DOS, use the "rawrite" utility located
452: at <i>CD1:5.0/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
453: use the
1.31 ! bentley 454: <a href="https://man.openbsd.org/dd.1">dd(1)</a>
1.1 deraadt 455: utility. The following is an example usage of
1.31 ! bentley 456: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.1 deraadt 457: where the device could be "floppy", "rfd0c", or
458: "rfd0a".
459:
1.31 ! bentley 460: <blockquote><pre>
1.1 deraadt 461: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
1.31 ! bentley 462: </pre></blockquote>
1.1 deraadt 463:
464: <p>
465: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
466: your install will most likely fail. For more information on creating a boot
467: floppy and installing OpenBSD/i386 please refer to
1.25 tj 468: <a href="faq/faq4.html#MkFlop">this page</a>.
1.31 ! bentley 469:
! 470: <h3>OpenBSD/amd64:</h3>
1.1 deraadt 471:
472: <p>
473: The 5.0 release of OpenBSD/amd64 is located on CD2.
474: Boot from the CD to begin the install - you may need to adjust
475: your BIOS options first.
476: If you can't boot from the CD, you can create a boot floppy to install from.
477: To do this, write <i>CD2:5.0/amd64/floppy50.fs</i> to a floppy, then
478: boot from the floppy drive.
479:
480: <p>
481: If you can't boot from a CD or a floppy disk,
482: you can install across the network using PXE as described in the included
483: INSTALL.amd64 document.
484:
485: <p>
486: If you are planning to dual boot OpenBSD with another OS, you will need to
487: read INSTALL.amd64.
1.31 ! bentley 488:
! 489: <h3>OpenBSD/macppc:</h3>
1.1 deraadt 490:
491: <p>
492: Put CD2 in your CDROM drive and poweron your machine while holding down the
493: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
494:
495: <p>
496: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
497: /5.0/macppc/bsd.rd</i>
1.31 ! bentley 498:
! 499: <h3>OpenBSD/sparc64:</h3>
1.1 deraadt 500:
501: <p>
502: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
503:
504: <p>
505: If this doesn't work, or if you don't have a CDROM drive, you can write
506: <i>CD3:5.0/sparc64/floppy50.fs</i> or <i>CD3:5.0/sparc64/floppyB50.fs</i>
507: (depending on your machine) to a floppy and boot it with <i>boot
508: floppy</i>. Refer to INSTALL.sparc64 for details.
509:
510: <p>
511: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
512: will most likely fail.
513:
514: <p>
515: You can also write <i>CD3:5.0/sparc64/miniroot50.fs</i> to the swap partition on
516: the disk and boot with <i>boot disk:b</i>.
517:
518: <p>
519: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.31 ! bentley 520:
! 521: <h3>OpenBSD/alpha:</h3>
1.1 deraadt 522:
523: <p>
524: <p>Write <i>FTP:5.0/alpha/floppy50.fs</i> or
525: <i>FTP:5.0/alpha/floppyB50.fs</i> (depending on your machine) to a diskette and
526: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
527:
528: <p>
529: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
530: will most likely fail.
531:
1.31 ! bentley 532: <h3>OpenBSD/armish:</h3>
1.1 deraadt 533:
534: <p>
535: After connecting a serial port, Thecus can boot directly from the network
536: either tftp or http. Configure the network using fconfig, reset,
537: then load bsd.rd, see INSTALL.armish for specific details.
538: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
539: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
540: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
541: More details are available in INSTALL.armish.
1.31 ! bentley 542:
! 543: <h3>OpenBSD/hp300:</h3>
1.1 deraadt 544:
545: <p>
546: Boot over the network by following the instructions in INSTALL.hp300.
547:
1.31 ! bentley 548: <h3>OpenBSD/hppa:</h3>
! 549:
1.1 deraadt 550: <p>
551: Boot over the network by following the instructions in INSTALL.hppa or the
552: <a href="hppa.html#install">hppa platform page</a>.
1.31 ! bentley 553:
! 554: <h3>OpenBSD/landisk:</h3>
1.1 deraadt 555:
556: <p>
557: Write <i>miniroot50.fs</i> to the start of the CF
558: or disk, and boot normally.
559:
1.31 ! bentley 560: <h3>OpenBSD/loongson:</h3>
! 561:
1.1 deraadt 562: <p>
563: Write <i>miniroot50.fs</i> to a USB stick and boot bsd.rd from it
564: or boot bsd.rd via tftp.
565: Refer to the instructions in INSTALL.loongson for more details.
1.31 ! bentley 566:
! 567: <h3>OpenBSD/mvme68k:</h3>
1.1 deraadt 568:
569: <p>
570: You can create a bootable installation tape or boot over the network.<br>
571: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
572: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
573: for more details.
574:
1.31 ! bentley 575: <h3>OpenBSD/mvme88k:</h3>
! 576:
1.1 deraadt 577: <p>
578: You can create a bootable installation tape or boot over the network.<br>
579: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
580: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
581: for more details.
1.31 ! bentley 582:
! 583: <h3>OpenBSD/sgi:</h3>
1.1 deraadt 584:
585: <p>
586: To install on an O2, burn cd50.iso on a CD-R, put it in the CD drive of your
587: machine and select <i>Install System Software</i> from the System Maintenance
588: menu.
589:
590: <p>
591: On other systems, or if your machine doesn't have a CD drive, you can
592: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
593: the kernel matching your system type.
594: Refer to the instructions in INSTALL.sgi for more details.
1.31 ! bentley 595:
! 596: <h3>OpenBSD/socppc:</h3>
1.1 deraadt 597:
598: <p>
599: After connecting a serial port, boot over the network via DHCP/tftp.
600: Refer to the instructions in INSTALL.socppc for more details.
1.31 ! bentley 601:
! 602: <h3>OpenBSD/sparc:</h3>
1.1 deraadt 603:
604: <p>
605: Boot from one of the provided install ISO images, using one of the two
606: commands listed below, depending on the version of your ROM.
607:
1.31 ! bentley 608: <blockquote><pre>
! 609: ok <kbd>boot cdrom 5.0/sparc/bsd.rd</kbd>
1.1 deraadt 610: or
1.31 ! bentley 611: > <kbd>b sd(0,6,0)5.0/sparc/bsd.rd</kbd>
! 612: </pre></blockquote>
1.1 deraadt 613:
614: <p>
615: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
616: To do so you need to write <i>floppy50.fs</i> to a floppy.
1.25 tj 617: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.1 deraadt 618: To boot from the floppy use one of the two commands listed below,
619: depending on the version of your ROM.
620:
1.31 ! bentley 621: <blockquote><pre>
! 622: ok <kbd>boot floppy</kbd>
1.1 deraadt 623: or
1.31 ! bentley 624: > <kbd>b fd()</kbd>
! 625: </pre></blockquote>
1.1 deraadt 626:
627: <p>
628: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
629: will most likely fail.
630:
631: <p>
632: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
633: setup a bootable tape, or install via network, as told in the
634: INSTALL.sparc file.
1.31 ! bentley 635:
! 636: <h3>OpenBSD/vax:</h3>
1.1 deraadt 637:
638: <p>
639: Boot over the network via mopbooting as described in INSTALL.vax.
640:
1.31 ! bentley 641: <h3>OpenBSD/zaurus:</h3>
! 642:
1.1 deraadt 643: <p>
644: Using the Linux built-in graphical ipkg installer, install the
645: openbsd50_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
646: for a few important details.
1.31 ! bentley 647:
! 648: </section>
! 649:
! 650: <section id=sourcecode>
! 651: <h3>Notes about the source code:</h3>
1.1 deraadt 652:
653: <p>
654: src.tar.gz contains a source archive starting at /usr/src. This file
655: contains everything you need except for the kernel sources, which are
656: in a separate archive. To extract:
1.31 ! bentley 657:
! 658: <blockquote><pre>
! 659: # <kbd>mkdir -p /usr/src</kbd>
! 660: # <kbd>cd /usr/src</kbd>
! 661: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
! 662: </pre></blockquote>
! 663:
1.1 deraadt 664: <p>
665: sys.tar.gz contains a source archive starting at /usr/src/sys.
666: This file contains all the kernel sources you need to rebuild kernels.
667: To extract:
1.31 ! bentley 668:
! 669: <blockquote><pre>
! 670: # <kbd>mkdir -p /usr/src/sys</kbd>
! 671: # <kbd>cd /usr/src</kbd>
1.1 deraadt 672: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
1.31 ! bentley 673: </pre></blockquote>
! 674:
1.1 deraadt 675: <p>
676: Both of these trees are a regular CVS checkout. Using these trees it
677: is possible to get a head-start on using the anoncvs servers as
678: described <a href="anoncvs.html">here</a>.
679: Using these files
680: results in a much faster initial CVS update than you could expect from
681: a fresh checkout of the full OpenBSD source tree.
682:
1.31 ! bentley 683: </section>
! 684: </section>
! 685:
1.1 deraadt 686: <hr>
1.31 ! bentley 687:
! 688: <section id=upgrade>
! 689: <h3>How to upgrade</h3>
1.1 deraadt 690: <p>
691: If you already have an OpenBSD 4.9 system, and do not want to reinstall,
692: upgrade instructions and advice can be found in the
693: <a href="faq/upgrade50.html">Upgrade Guide</a>.
1.31 ! bentley 694: </section>
1.1 deraadt 695:
696: <hr>
1.31 ! bentley 697:
! 698: <section id=ports>
! 699: <h3>Ports Tree</h3>
1.1 deraadt 700: <p>
701: A ports tree archive is also provided. To extract:
702: <p>
1.31 ! bentley 703: <blockquote><pre>
! 704: # <kbd>cd /usr</kbd>
! 705: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
! 706: # <kbd>cd ports</kbd>
! 707: </pre></blockquote>
1.1 deraadt 708: <p>
709: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
710: read the <a href="faq/ports/index.html">ports</a> page
711: if you know nothing about ports
712: at this point. This text is not a manual of how to use ports.
713: Rather, it is a set of notes meant to kickstart the user on the
714: OpenBSD ports system.
715: <p>
716: The <i>ports/</i> directory represents a CVS (see the manpage for
1.31 ! bentley 717: <a href="https://man.openbsd.org/cvs.1">
1.1 deraadt 718: cvs(1)</a> if
719: you aren't familiar with CVS) checkout of our ports. As with our complete
720: source tree, our ports tree is available via anoncvs. So, in
721: order to keep current with it, you must make the <i>ports/</i> tree
722: available on a read-write medium and update the tree with a command
723: like:
724: <p>
1.31 ! bentley 725: <blockquote><pre>
1.4 nick 726: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_0</strong>
1.31 ! bentley 727: </pre></blockquote>
1.1 deraadt 728: <p>
729: [Of course, you must replace the local directory and server name here
730: with the location of your ports collection and a nearby anoncvs
731: server.]
732: <p>
733: Note that most ports are available as packages through FTP. Updated
734: packages for the 5.0 release will be made available if problems arise.
735: <p>
736: If you're interested in seeing a port added, would like to help out, or just
737: would like to know more, the mailing list ports@openbsd.org is a good
738: place to know.
1.31 ! bentley 739: </section>