[BACK]Return to 55.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/55.html, Revision 1.33

1.1       deraadt     1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
                      2: <html>
                      3: <head>
1.14      deraadt     4: <title>OpenBSD 5.5</title>
1.1       deraadt     5: <meta name="resource-type" content="document">
                      6: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
                      7: <meta name="description" content="OpenBSD 5.5">
                      8: <meta name="keywords" content="openbsd,main">
                      9: <meta name="distribution" content="global">
                     10: <meta name="copyright" content="This document copyright 2013 by OpenBSD.">
                     11: </head>
                     12:
                     13: <body bgcolor="#ffffff" text="#000000" link="#24248E">
                     14:
                     15: <a href="index.html">
                     16: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
1.33    ! deraadt    17: <p>
1.1       deraadt    18:
1.22      deraadt    19: <a href="images/McFishy.jpg">
                     20: <img align="left" width="227" height="343" hspace="24" src="images/McFishy.jpg"></a>
1.14      deraadt    21: <h2><font color="#0000e0">OpenBSD 5.5</font></h2>
1.1       deraadt    22: <p>
1.14      deraadt    23: To be released May 1, 2014<br>
1.1       deraadt    24: Copyright 1997-2014, Theo de Raadt.<br>
                     25: <font color="#e00000">ISBN 978-0-9881561-3-5</font>
                     26: <br>
                     27: <a href="lyrics.html#55">5.5 Song: "Wrap in Time"</a>
                     28: <p>
                     29:
                     30: <ul>
                     31: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
                     32: <li>See the information on <a href="ftp.html">The FTP page</a> for
                     33:     a list of mirror machines.
                     34: <li>Go to the <font color="#e00000">pub/OpenBSD/5.5/</font> directory on
                     35:     one of the mirror sites.
                     36: <li>Briefly read the rest of this document.
                     37: <li>Have a look at <a href="errata55.html">The 5.5 Errata page</a> for a list
                     38:     of bugs and workarounds.
                     39: <li>See a <a href="plus55.html">detailed log of changes</a> between the
                     40:     5.4 and 5.5 releases.
                     41: </ul>
                     42: <br clear=all>
1.14      deraadt    43: <p>
                     44: All applicable copyrights and credits can be found in the applicable
                     45: file sources found in the files src.tar.gz, sys.tar.gz,
                     46: xenocara.tar.gz, or in the files fetched via ports.tar.gz.  The
                     47: distribution files used to build packages from the ports.tar.gz file
                     48: are not included on the CDROM because of lack of space.
1.1       deraadt    49: <p>
                     50:
                     51: <a name="new"></a>
                     52: <hr>
                     53: <p>
                     54: <h3><font color="#0000e0">What's New</font></h3>
                     55: <p>
                     56: This is a partial list of new features and systems included in OpenBSD 5.5.
                     57: For a comprehensive list, see the <a href="plus55.html">changelog</a> leading
                     58: to 5.5.
                     59: <p>
                     60:
                     61: <ul>
1.24      guenther   62: <li>time_t is now 64 bits on all platforms.
                     63: While many filesystems are limited to 32 bits and thus cannot be
                     64: used to store times after Tue Jan 19 03:14:07 2038 UTC,
                     65: most system operations can now support times after that.
1.15      tedu       66: <li>Releases and packages are now cryptographically signed with the
1.10      tedu       67: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&amp;sektion=1">signify(1)</a> utility.
                     68: <ul>
                     69: <li>The installer will verify all sets before installing.
1.23      deraadt    70: <li>Installing without verification works, but is discouraged.
                     71: <li>Users are advised to verify the installer (bsd.rd, install55.iso, etc.)
                     72:     ahead of time using the
1.25      deraadt    73:     <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=signify&sektion=1#end">signify(1)</a> tool if available.
1.23      deraadt    74: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pkg_add&amp;sektion=1">pkg_add(1)</a> now trusts signed packages only by default.
1.10      tedu       75: </ul>
1.27      benno      76: <li>The installer now supports a scriptable <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=autoinstall&sektion=8">auto-installation</a> method.
1.10      tedu       77: <p>
                     78:
1.8       tedu       79: <li>New/extended platforms:
1.1       deraadt    80:     <ul>
1.32      miod       81:     <li><a href="alpha.html">OpenBSD/alpha</a>:
                     82:        <ul>
                     83:        <li>Multiprocessor support.
                     84:        </ul>
                     85:     <li><a href="aviion.html">OpenBSD/aviion</a>:
                     86:        <ul>
                     87:        <li>First self-hosting release for 88100-based AViiON systems.
                     88:        </ul>
1.1       deraadt    89:     </ul>
                     90: <p>
                     91:
                     92: <li>Improved hardware support, including:
                     93:     <ul>
1.5       jsg        94:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vmx&amp;sektion=4">vmx(4)</a>
                     95:         driver for VMware VMXNET3 Virtual Interface Controller devices.
                     96:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vmwpvs&amp;sektion=4">vmwpvs(4)</a>
                     97:         driver for VMware Paravirtual SCSI.
                     98:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vioscsi&amp;sektion=4">vioscsi(4)</a>
                     99:         driver for VirtIO SCSI adapters.
                    100:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=viornd&amp;sektion=4">viornd(4)</a>
                    101:         driver for VirtIO random number devices.
                    102:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ubcmtp&amp;sektion=4">ubcmtp(4)</a>
                    103:         driver for Broadcom multi-touch trackpads.
                    104:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ugold&amp;sektion=4">ugold(4)</a>
                    105:         driver for TEMPer gold HID thermometers.
                    106:     <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ugl&amp;sektion=4">ugl(4)</a>
                    107:         driver for Genesys Logic based USB host-to-host adapters.
                    108:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=radeondrm&amp;sektion=4">radeondrm(4)</a>
                    109:         has been overhauled, including:
                    110:         <ul>
                    111:         <li>New port of the Radeon code in Linux 3.8.13.19.
                    112:         <li>Support for Kernel Mode Setting (KMS) including support for
                    113:             additional output types such as DisplayPort.
                    114:         <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wsdisplay&amp;sektion=4">wsdisplay(4)</a>
                    115:             now attaches to
                    116:             <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=radeondrm&amp;sektion=4">radeondrm(4)</a>
                    117:             and provides a framebuffer console.
                    118:         </ul>
                    119:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=inteldrm&amp;sektion=4">inteldrm(4)</a>
1.20      sthen     120:         has been updated to Linux 3.8.13.19 notably bringing Haswell stability fixes.
1.5       jsg       121:     <li>Support for Intel 8 Series Ethernet with i217/i218 PHYs, and
                    122:         i210/i211/i354 has been added to
                    123:          <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=em&amp;sektion=4">em(4)</a>.
                    124:     <li>Support for Intel Centrino Wireless-N 2200, 2230 and 105/135 has been added to
                    125:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iwn&amp;sektion=4">iwn(4)</a>.
1.28      chris     126:     <li>Support for Areca ARC-1880, ARC-1882, ARC-1883, ARC-1223, ARC-1214, ARC-1264, ARC-1284 has been added to
                    127:        <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=arc&amp;sektion=4">arc(4)</a>.
1.1       deraadt   128:     </ul>
                    129: <p>
                    130:
                    131: <li>Generic network stack improvements:
                    132:     <ul>
1.17      jsg       133:     <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=vxlan&sektion=4">vxlan(4)</a>
                    134:         a virtual extensible local area network tunnel interface.
1.19      florian   135:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pflow&sektion=4">pflow(4)</a>
                    136:         sends 64 bit time values for pflowproto 10. The changed templates /
                    137:         flows for pflowproto 10 are now parseable by existing receivers.
1.1       deraadt   138:     <li>...
                    139:     </ul>
                    140: <p>
                    141:
                    142: <li>Routing daemons and other userland network improvements:
                    143:     <ul>
1.13      tedu      144:     <li>The popa3d POP3 server has been removed.
1.17      jsg       145:     <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ntpctl&sektion=8">ntpctl(8)</a>
                    146:         a program to control the Network Time Protocol daemon.
1.19      florian   147:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=slowcgi&sektion=8">slowcgi(8)</a>
                    148:         now works with a high number of concurrent connections.
1.1       deraadt   149:     </ul>
                    150: <p>
                    151:
1.7       deraadt   152: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&amp;sektion=8">dhcpd(8)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&amp;sektion=8">dhclient(8)</a> improvements:
1.1       deraadt   153:     <ul>
1.30      krw       154:     <li>no longer create a route to the bound address via 127.0.0.1.
                    155:     <li>the options dhcp-lease-time, dhcp-rebinding-time, and dhcp-renewal-time can now be configured in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&amp;sektion=5">dhclient.conf(5)</a>.
                    156:     <li>'next-server' (a.k.a. siaddr) info now saved in lease files.
                    157:     <li>fall back to broadcasting when unicast renewal fails, as specified in
                    158: RFC 2131 and friends.
                    159:     <li>fix various problems in communications between privileged and non-privileged processes.
                    160:     <li>fix many abuses of memcpy.
                    161:     <li>stop pretending we still support FDDI or token ring hardware types.
                    162:     <li>fix classless static routes option handling and add syntax to parse human readable forms.
                    163:     <li>fix 'effective' lease created by '-L' to have correct address, next_server, timestamp,  and resolv_conf fields.
                    164:     <li>fix handling of non-printable characters in lease file strings.
                    165:     <li>fix many edge cases in config file and lease parsing and ensure error messages refer to correct position in erroneous line.
                    166:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&amp;sektion=5">dhclient.conf(5)</a> can now override anything in an offer or saved lease when creating the effective lease, in particular 'fixed-address', 'next-server', 'filename' and 'server-name'.
                    167:     <li>fix parsing of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&amp;sektion=5">dhclient.conf(5)</a> statements 'fixed-address' and
                    168: 'next-server'.
                    169:     <li>log failures to fchmod() or fchown() files being written.
                    170:     <li>create lease files with permissions 0640.
                    171:     <li>fix possible failure to write <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=resolv.conf&amp;sektion=5">resolv.conf(5)</a> when -L is used.
                    172:     <li>'send dhcp-client-identifier "";' in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient.conf&amp;sektion=5">dhclient.conf(5)</a> will result in no dhcp-client-identifier (option 61) being sent.
1.1       deraadt   173:     </ul>
                    174: <p>
                    175:
1.17      jsg       176: <li>OpenSMTPD 5.4.2:
1.1       deraadt   177:     <ul>
                    178:     <li>...
                    179:     </ul>
                    180: <p>
                    181:
1.16      jsg       182: <li>Security improvements:
                    183:     <ul>
1.23      deraadt   184:     <li>Position-independent executables (PIE) are now used by default on i386.
1.17      jsg       185:     <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=arc4random&sektion=3">arc4random(3)</a>
                    186:         functions now use the ChaCha20 cipher.
1.18      tedu      187:     <li>The kernel random number system is initially seeded by the bootloader,
                    188:         providing better random very early.
1.17      jsg       189:     <li>-Wbounded is now enabled in GCC by default.
                    190:     <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=explicit_bzero&amp;sektion=3">explicit_bzero(3)</a>.
1.16      jsg       191:     </ul>
                    192: <p>
                    193:
1.1       deraadt   194: <li>Performance improvements:
                    195:     <ul>
1.11      tedu      196:     <li>Relations between the buffer cache and swap daemon have been improved.
1.1       deraadt   197:     </ul>
                    198: <p>
                    199:
                    200: <li>Threading improvements:
                    201:     <ul>
1.12      tedu      202:     <li>Interprocess semaphores via <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sem_open&amp;sektion=3">sem_open(3)</a>.
1.26      guenther  203:     <li>Running threaded processes under a debugger no longer causes panics.
                    204:     <li>SIGPROF and SIGVTALRM are now reliably delivered to the thread that was running when they were triggered.
                    205:     <li>Thread stacks now have a random bias.
                    206:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fork&amp;sektion=2">fork(2)</a> no longer changes the pthread_t of the forking thread in the child.
                    207:     <li>Signaling races eliminated from <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_kill&amp;sektion=3">pthread_kill(3)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_cancel&amp;sektion=3">pthread_cancel(3)</a>.
1.1       deraadt   208:     </ul>
                    209: <p>
                    210:
                    211: <li>Assorted improvements:
                    212:     <ul>
1.29      deraadt   213:     <li>New in-memory file system, <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mount_tmpfs&sektion=8">tmpfs</a>.
                    214:     <li>Added POSIX required <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nl&amp;sektion=1">nl(1)</a> utility.
1.16      jsg       215:     <li>OpenBSD/vax has switched to GCC 3.
1.26      guenther  216:     <li>Replaced <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getdirentries&amp;sektion=2&amp;manpath=OpenBSD+5.4">getdirentries(2)</a> with <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getdents&amp;sektion=2">getdents(2)</a>, vastly improving the performance and memory usage of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=telldir&amp;sektion=3">telldir(3)</a>.
                    217:     <li>amd64 and i386 now use the MWAIT instruction for their idle loop where available to reduce latency.
1.29      deraadt   218:     <li>Added support for CLOCK_UPTIME.
1.26      guenther  219:     <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcgetsid&amp;sektion=3">tcgetsid(3)</a>.
                    220:     <li>clock_t is now a 64 bit type, so it no longer wraps around in only 248 days.
                    221:     <li>ino_t is now a 64 bit type, mostly to support large NFS filesystems.
                    222:     <li>Corrected handling of UTIME_OMIT.
                    223:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pax&amp;sektion=1">pax</a> now sets the mode and timestamps correctly on symlinks, and makes hardlinks to symlinks when requested.
                    224:     <li>Corrected handling of shared-library destructors when libc is staticly linked.
1.29      deraadt   225:     <li>Disk images which can be written to a USB flash (miniroot55.fs and install55.fs) are now provided for i386 and amd64.
1.31      krw       226:     <li>Corrected various disk drivers to handle non-512-byte sectors and disk sizes greater than 32-bits.
                    227:     <li>Corrected <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=growfs&amp;sektion=8">growfs(8)</a> to handle non-512-byte sectors and disk sizes greater than 32-bits.
                    228:     <li>All CIRCLEQ uses replaced with TAILQ.
                    229:     <li>Preserve and honour changes to the OpenBSD bounds in a disklabel.
                    230:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fdisk&amp;sektion=8">fdisk(8)</a> now always writes a good signature when MBR is written to disk.
                    231:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&amp;sektion=8">disklabel(8)</a> now writes the disklabel to the correct location on non-512-byte sector devices.
                    232:     <li>Correctly parse nwid's with embedded blanks during install.
                    233:     <li>Fix <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=athn&amp;sektion=4">athn(4)</a> tick calculations to eliminate excessive timeouts.
                    234:     <li>Allow <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&amp;sektion=8">disklabel(8)</a> to set any partition, including 'C', to type UNUSED.
1.1       deraadt   235:     </ul>
                    236: <p>
                    237:
1.3       sobrado   238: <li>OpenSSH 6.6 (including changes to 6.5, a feature-focused release):
1.1       deraadt   239:     <ul>
1.3       sobrado   240:     <li>Security:
1.1       deraadt   241:       <ul>
1.3       sobrado   242:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    243:         when using environment passing with a
                    244:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&amp;sektion=5">sshd_config(5)</a>
                    245:         <tt>AcceptEnv</tt> pattern with a wildcard. OpenSSH prior to 6.6 could
                    246:         be tricked into accepting any enviornment variable that contains the
                    247:         characters before the wildcard character.
                    248:       </ul>
                    249:     <li>New/changed features:
                    250:       <ul>
                    251:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    252:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    253:         Add support for key exchange using <i>elliptic-curve Diffie Hellman</i>
                    254:         in Daniel Bernstein's <i>Curve25519</i>.  This key exchange method is
                    255:         the default when both the client and server support it.
                    256:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    257:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    258:         Add support for <i>ED25519</i> as a public key type.  ED25519 is
                    259:         a elliptic curve signature scheme that offers better security than
                    260:         <i>ECDSA</i> and <i>DSA</i> and good performance.  It may be used for
                    261:         both <i>user</i> and <i>host</i> keys.
                    262:       <li>Add a new private key format that uses a <i>bcrypt KDF</i> to better
                    263:         protect keys at rest.  This format is used unconditionally for
                    264:         ED25519 keys, but may be requested when generating or saving
                    265:         existing keys of other types via the <tt>-o</tt>
                    266:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&amp;sektion=1">ssh-keygen(1)</a>
                    267:         option.  We intend to make the new format the default in the near
                    268:         future.  Details of the new format are in the <tt>PROTOCOL.key</tt>
                    269:         file.
                    270:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    271:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    272:         Add a new transport cipher "chacha20-poly1305@openssh.com" that
                    273:         combines Daniel Bernstein's <i>ChaCha20</i> stream cipher and
                    274:         <i>Poly1305 MAC</i> to build an authenticated encryption mode.  Details
                    275:         are in the <tt>PROTOCOL.chacha20poly1305</tt> file.
                    276:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    277:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    278:         Refuse <i>RSA</i> keys from old proprietary clients and servers that
                    279:         use the obsolete <i>RSA+MD5</i> signature scheme.  It will still be
                    280:         possible to connect with these clients/servers but <b>only DSA keys
                    281:         will be accepted, and OpenSSH will refuse connection entirely in a
                    282:         future release</b>.
                    283:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    284:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    285:         Refuse old proprietary clients and servers that use a weaker key
                    286:         exchange hash calculation.
                    287:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    288:         Increase the size of the <i>Diffie-Hellman groups</i> requested for
                    289:         each symmetric key size.  New values from <i>NIST Special Publication
                    290:         800-57</i> with the upper limit specified by <i>RFC 4419</i>.
                    291:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    292:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&amp;sektion=1">ssh-agent(1)</a>:
                    293:         Support <i>PKCS#11</i> tokens that only provide <i>X.509</i> certs
                    294:         instead of raw public keys.  (requested as bz#1908)
                    295:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    296:         Add a
                    297:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&amp;sektion=5">ssh_config(5)</a>
                    298:         <tt>Match</tt> keyword that allows conditional configuration to be
                    299:         applied by matching on <i>hostname</i>, <i>user</i> and <i>result of
                    300:         arbitrary commands</i>.
                    301:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    302:         Add support for <i>client-side hostname canonicalisation</i> using a
                    303:         set of <i>DNS suffixes</i> and rules in
                    304:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&amp;sektion=5">ssh_config(5)</a>.
                    305:         This allows unqualified names to be canonicalised to fully-qualified
                    306:         domain names to eliminate ambiguity when looking up keys in
                    307:         <tt>known_hosts</tt> or checking host certificate names.
                    308:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp-server&amp;sektion=8">sftp-server(8)</a>:
                    309:         Add the ability to whitelist and/or blacklist sftp protocol requests by
                    310:         name.
                    311:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp-server&amp;sektion=8">sftp-server(8)</a>:
                    312:         Add a sftp "fsync@openssh.com" to support calling
                    313:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fsync&amp;sektion=2">fsync(2)</a>
                    314:         on an open file handle.
                    315:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    316:         Add a
                    317:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&amp;sektion=5">ssh_config(5)</a>
                    318:         <tt>PermitTTY</tt> to disallow <i>TTY</i> allocation, mirroring the
                    319:         longstanding <tt>no-pty</tt> <tt>authorized_keys</tt> option.
                    320:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    321:         Add a
                    322:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&amp;sektion=5">ssh_config(5)</a>
                    323:         <tt>ProxyUseFDPass</tt> option that supports the use of
                    324:         <tt>ProxyCommands</tt> that establish a connection and then pass a
                    325:         connected file descriptor back to
                    326:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>.
                    327:         This allows the <tt>ProxyCommand</tt> to exit rather than staying
                    328:         around to transfer data.
                    329:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    330:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    331:         this release removes the <i>J-PAKE</i> authentication code.  This code
                    332:         was experimental, never enabled and had been unmaintained for some
                    333:         time.
                    334:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    335:         when processing <tt>Match</tt> blocks, skip '<tt>exec</tt>' clauses
                    336:         other clauses predicates failed to match.
                    337:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    338:         if hostname canonicalisation is enabled and results in the destination
                    339:         hostname being changed, then re-parse
                    340:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&amp;sektion=5">ssh_config(5)</a>
                    341:         files using the new destination hostname. This gives '<tt>Host</tt>'
                    342:         and '<tt>Match</tt>' directives that use the expanded hostname a chance
                    343:         to be applied.
1.1       deraadt   344:       </ul>
                    345:     <li>The following significant bugs have been fixed in this release:
                    346:       <ul>
1.3       sobrado   347:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    348:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    349:         Fix potential stack exhaustion caused by nested certificates.
                    350:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    351:         make <tt>BindAddress</tt> work with <tt>UsePrivilegedPort</tt>.
                    352:         (bz#1211)
                    353:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&amp;sektion=1">sftp(1)</a>:
                    354:         fix the progress meter for resumed transfer.  (bz#2137)
                    355:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-add&amp;sektion=1">ssh-add(1)</a>:
                    356:         do not request smartcard PIN when removing keys from
                    357:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&amp;sektion=1">ssh-agent(1)</a>.
                    358:         (bz#2187)
                    359:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    360:         fix re-exec fallback when original
                    361:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>
                    362:         binary cannot be executed.  (bz#2139)
                    363:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&amp;sektion=1">ssh-keygen(1)</a>:
                    364:         Make relative-specified certificate expiry times relative to current
                    365:         time and not the validity start time.
                    366:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    367:         fix <tt>AuthorizedKeysCommand</tt> inside a <tt>Match</tt> block.
                    368:         (bz#2161)
                    369:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&amp;sektion=1">sftp(1)</a>:
                    370:         symlinking a file would incorrectly canonicalise the target path.
                    371:         (bz#2129)
                    372:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent&amp;sektion=1">ssh-agent(1)</a>:
                    373:         fix a use-after-free in the PKCS#11 agent helper executable.
                    374:         (bz#2175)
                    375:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    376:         Improve logging of sessions to include the <i>user name</i>, <i>remote
                    377:         host</i> and <i>port</i>, the <i>session type</i> (shell, command,
                    378:         etc.) and <i>allocated TTY</i> (if any).
                    379:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    380:         tell the client (via a debug message) when their preferred listen
                    381:         address has been overridden by the server's <tt>GatewayPorts</tt>
                    382:         setting.  (bz#1297)
                    383:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    384:         include report port in bad protocol banner message.  (bz#2162)
                    385:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&amp;sektion=1">sftp(1)</a>:
                    386:         fix memory leak in error path in <i>do_readdir()</i>.  (bz#2163)
                    387:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&amp;sektion=1">sftp(1)</a>:
                    388:         don't leak file descriptor on error.  (bz#2171)
                    389:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    390:         include the <i>local address</i> and <i>port</i> in "<tt>Connection
                    391:         from ...</tt>" message.  (only shown at <i>loglevel&gt;=verbose</i>)
                    392:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    393:         avoid spurious "<tt>getsockname failed: Bad file descriptor</tt>" in
                    394:         <tt>ssh -W</tt>.  (bz#2200, debian#738692)
                    395:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    396:         allow the
                    397:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=shutdown&amp;sektion=2">shutdown(2)</a>
                    398:         syscall in seccomp-bpf and systrace sandbox modes, as it is reachable
                    399:         if the connection is terminated during the pre-auth phase.
                    400:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    401:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    402:         fix unsigned overflow that in <i>SSH protocol 1 bignum parsing</i>.
                    403:         Minimum key length checks render this bug unexploitable to compromise
                    404:         SSH 1 sessions.
                    405:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&amp;sektion=5">sshd_config(5)</a>
                    406:         clarify behaviour of a keyword that appears in multiple matching
                    407:         <tt>Match</tt> blocks.  (bz#2184)
                    408:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    409:         avoid unnecessary hostname lookups when canonicalisation is disabled.
                    410:         (bz#2205)
                    411:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    412:         avoid sandbox violation crashes in GSSAPI code by caching the supported
                    413:         list of GSSAPI mechanism OIDs before entering the sandbox.  (bz#2107)
                    414:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    415:         fix possible crashes in SOCKS4 parsing caused by assumption that the
                    416:         SOCKS username is nul-terminated.
                    417:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    418:         fix regression for <tt>UsePrivilegedPort=yes</tt> when
                    419:         <tt>BindAddress</tt> is not specified.
                    420:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>,
                    421:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&amp;sektion=8">sshd(8)</a>:
                    422:         fix memory leak in ECDSA signature verification.
                    423:       <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&amp;sektion=1">ssh(1)</a>:
                    424:         fix matching of '<tt>Host</tt>' directives in
                    425:         <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&amp;sektion=5">ssh_config(5)</a>
                    426:         files to be case-insensitive again.  (regression in 6.5)
1.1       deraadt   427:       </ul>
                    428:     </ul>
                    429: <p>
                    430:
1.2       espie     431: <li>Major overhaul of the package tools:
1.1       deraadt   432:     <ul>
1.23      deraadt   433:     <li>Much better memory usage.
                    434:     <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pkg_add&amp;sektion=1">pkg_add(1)</a> now trusts signed packages only by default.
1.1       deraadt   435:     </ul>
1.2       espie     436: <li>Over 8,700 ports
1.1       deraadt   437: <p>
1.2       espie     438: <li>The build process now allows some limited capability for
                    439: building conflicting packages, yielding kde4 packages as a result,
                    440: along with kde3.
1.1       deraadt   441: <li>Many pre-built packages for each architecture:
                    442:     <table border=0 cellspacing=0 cellpadding=2 width="95%">
                    443:     <tr>
                    444:     <td valign="top" width="25%">
                    445:     <ul>
                    446:       <li>i386:       8468
1.6       deraadt   447:       <li>sparc64:    7969
1.21      sthen     448:       <li>alpha:      6199
1.1       deraadt   449:       <li>m68k:       XXXX
                    450:     </ul></td><td valign=top width="25%"><ul>
                    451:       <li>sh:         XXXX
                    452:       <li>amd64:      8534
                    453:       <li>powerpc:    8057
                    454:       <li>m88k:       XXXX
                    455:     </ul></td><td valign=top width="25%"><ul>
1.21      sthen     456:       <li>sparc:      3992
1.1       deraadt   457:       <li>arm:        XXXX
                    458:       <li>hppa:       6549
                    459:     </ul></td><td valign=top width="25%"><ul>
                    460:       <li>vax:        XXXX
1.21      sthen     461:       <li>mips64:     4726
                    462:       <li>mips64el:   6730
1.1       deraadt   463:   </ul></td></tr></table>
                    464: <p>
                    465:
                    466: <li>Some highlights:
                    467:     <ul>
1.4       jsg       468:     <li>GNOME 3.10.2                   <li>KDE 3.5.10
1.2       espie     469:     <li>KDE 4.11.5
1.4       jsg       470:     <li>Xfce 4.10                      <li>MySQL 5.1.73
                    471:     <li>PostgreSQL 9.3.2               <li>Postfix 2.11.0
                    472:     <li>OpenLDAP 2.3.43 and 2.4.38     <li>Mozilla Firefox 24.3 and 26.0
                    473:     <li>Mozilla Thunderbird 24.3.0     <li>GHC 7.6.3
                    474:     <li>LibreOffice 4.1.4.2            <li>Emacs 21.4 and 24.3
                    475:     <li>Vim 7.4.135                    <li>PHP 5.3.28 and 5.4.24
                    476:     <li>Python 2.7.6 and 3.3.2         <li>Ruby 1.8.7.374, 1.9.3.484, 2.0.0.353 and 2.1.0
                    477:     <li>Tcl/Tk 8.5.15 and 8.6.1                <li>JDK 1.6.0.32 and 1.7.0.21
1.2       espie     478:     <li>Mono 2.10.9                    <li>Chromium 32.0.1700.102
1.4       jsg       479:     <li>Groff 1.22.2                   <li>Go 1.2
                    480:     <li>GCC 4.6.4 and 4.8.2            <li>LLVM/Clang 3.3
                    481:     <li>Node.js 0.10.24
1.1       deraadt   482:     </ul>
                    483: <p>
                    484:
                    485: <li>As usual, steady improvements in manual pages and other documentation.
                    486: <p>
                    487:
                    488: <li>The system includes the following major components from outside suppliers:
                    489:     <ul>
1.4       jsg       490:     <li>Xenocara (based on X.Org 7.7 with xserver 1.14.5 + patches,
                    491:       freetype 2.5.2, fontconfig 2.10.91, Mesa 9.2.5, xterm 301,
                    492:       xkeyboard-config 2.10.1 and more)
1.32      miod      493:     <li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
1.1       deraadt   494:     <li>Perl 5.16.3 (+ patches)
                    495:     <li>Our improved and secured version of Apache 1.3, with
                    496:       SSL/TLS and DSO support
1.4       jsg       497:     <li>Nginx 1.4.4 (+ patches)
1.1       deraadt   498:     <li>OpenSSL 1.0.1c (+ patches)
1.4       jsg       499:     <li>SQLite 3.8.0.2 (+ patches)
                    500:     <li>Sendmail 8.14.8, with libmilter
1.1       deraadt   501:     <li>Bind 9.4.2-P2 (+ patches)
1.4       jsg       502:     <li>NSD 4.0.1
1.1       deraadt   503:     <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
                    504:     <li>Sudo 1.7.2p8
                    505:     <li>Ncurses 5.7
                    506:     <li>Heimdal 1.5.2 (+ patches)
                    507:     <li>Binutils 2.15 (+ patches)
                    508:     <li>Gdb 6.3 (+ patches)
                    509:     <li>Less 444 (+ patches)
                    510:     <li>Awk Aug 10, 2011 version
                    511:     </ul>
                    512:
                    513: </ul>
                    514:
                    515: <a name="install"></a>
                    516: <hr>
                    517: <p>
                    518: <h3><font color="#0000e0">How to install</font></h3>
                    519: <p>
                    520: Following this are the instructions which you would have on a piece of
                    521: paper if you had purchased a CDROM set instead of doing an alternate
                    522: form of install.  The instructions for doing an FTP (or other style
                    523: of) install are very similar; the CDROM instructions are left intact
                    524: so that you can see how much easier it would have been if you had
                    525: purchased a CDROM instead.
                    526: <p>
                    527:
                    528: <hr>
                    529: Please refer to the following files on the three CDROMs or FTP mirror for
                    530: extensive details on how to install OpenBSD 5.5 on your machine:
                    531: <p>
                    532: <ul>
1.9       deraadt   533: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/i386/INSTALL.i386">
1.7       deraadt   534:        .../OpenBSD/5.5/i386/INSTALL.i386 (on CD1)</a>
1.9       deraadt   535: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/vax/INSTALL.vax">
1.7       deraadt   536:        .../OpenBSD/vax/INSTALL.vax (on CD1)</a>
                    537: <p>
1.9       deraadt   538: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/amd64/INSTALL.amd64">
1.7       deraadt   539:        .../OpenBSD/amd64/INSTALL.amd64 (on CD2)</a>
1.9       deraadt   540: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/hppa/INSTALL.hppa">
1.7       deraadt   541:        .../OpenBSD/hppa/INSTALL.hppa (on CD2)</a>
1.9       deraadt   542: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/macppc/INSTALL.macppc">
1.7       deraadt   543:        .../OpenBSD/macppc/INSTALL.macppc (on CD2)</a>
                    544: <p>
1.9       deraadt   545: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sparc64/INSTALL.sparc64">
1.7       deraadt   546:        .../OpenBSD/sparc64/INSTALL.sparc64 (on CD3)</a>
1.9       deraadt   547: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sparc/INSTALL.sparc">
1.7       deraadt   548:        .../OpenBSD/sparc/INSTALL.sparc (on CD3)</a>
                    549: <p>
1.9       deraadt   550: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/alpha/INSTALL.alpha">
1.7       deraadt   551:        .../OpenBSD/5.5/alpha/INSTALL.alpha</a>
1.9       deraadt   552: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/armish/INSTALL.armish">
1.7       deraadt   553:        .../OpenBSD/5.5/armish/INSTALL.armish</a>
1.9       deraadt   554: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/armv7/INSTALL.armv7">
1.7       deraadt   555:        .../OpenBSD/5.5/armv7/INSTALL.armv7</a>
1.32      miod      556: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/aviion/INSTALL.aviion">
                    557:        .../OpenBSD/5.5/aviion/INSTALL.aviion</a>
1.9       deraadt   558: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/hp300/INSTALL.hp300">
1.7       deraadt   559:        .../OpenBSD/5.5/hp300/INSTALL.hp300</a>
1.9       deraadt   560: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/hppa/INSTALL.hppa">
1.7       deraadt   561:        .../OpenBSD/5.5/hppa/INSTALL.hppa</a>
1.9       deraadt   562: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/landisk/INSTALL.landisk">
1.7       deraadt   563:        .../OpenBSD/5.5/landisk/INSTALL.landisk</a>
1.9       deraadt   564: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/loongson/INSTALL.loongson">
1.7       deraadt   565:        .../OpenBSD/5.5/loongson/INSTALL.loongson</a>
1.9       deraadt   566: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/luna88k/INSTALL.luna88k">
1.7       deraadt   567:        .../OpenBSD/5.5/luna88k/INSTALL.luna88k</a>
1.9       deraadt   568: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/macppc/INSTALL.macppc">
1.7       deraadt   569:        .../OpenBSD/5.5/macppc/INSTALL.macppc</a>
1.9       deraadt   570: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/mvme68k/INSTALL.mvme68k">
1.7       deraadt   571:        .../OpenBSD/5.5/mvme68k/INSTALL.mvme68k</a>
1.9       deraadt   572: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/mvme88k/INSTALL.mvme88k">
1.7       deraadt   573:        .../OpenBSD/5.5/mvme88k/INSTALL.mvme88k</a>
1.9       deraadt   574: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/octeon/INSTALL.octeon">
1.7       deraadt   575:        .../OpenBSD/5.5/octeon/INSTALL.octeon</a>
1.9       deraadt   576: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sgi/INSTALL.sgi">
1.7       deraadt   577:        .../OpenBSD/5.5/sgi/INSTALL.sgi</a>
1.9       deraadt   578: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/socppc/INSTALL.socppc">
1.7       deraadt   579:        .../OpenBSD/5.5/socppc/INSTALL.socppc</a>
1.9       deraadt   580: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/sparc/INSTALL.sparc">
1.7       deraadt   581:        .../OpenBSD/5.5/sparc/INSTALL.sparc</a>
1.9       deraadt   582: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/vax/INSTALL.vax">
1.7       deraadt   583:        .../OpenBSD/5.5/vax/INSTALL.vax</a>
1.9       deraadt   584: <li><a href="http://ftp.openbsd.org/pub/OpenBSD/5.5/zaurus/INSTALL.zaurus">
1.7       deraadt   585:        .../OpenBSD/5.5/zaurus/INSTALL.zaurus</a>
1.1       deraadt   586: </ul>
                    587: <hr>
                    588:
                    589: <p>
                    590: Quick installer information for people familiar with OpenBSD, and the
                    591: use of the "disklabel -E" command.  If you are at all confused when
                    592: installing OpenBSD, read the relevant INSTALL.* file as listed above!
                    593: <p>
                    594:
                    595: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
                    596: <ul>
                    597: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
                    598: release is on CD1. If your BIOS does not support booting from CD, you will need
                    599: to create a boot floppy to install from. To create a boot floppy write
                    600: <i>CD1:5.5/i386/floppy55.fs</i> to a floppy and boot via the floppy drive.
                    601:
                    602: <p>
                    603: Use <i>CD1:5.5/i386/floppyB55.fs</i> instead for greater SCSI controller
                    604: support, or <i>CD1:5.5/i386/floppyC55.fs</i> for better laptop support.
                    605:
                    606: <p>
                    607: If you can't boot from a CD or a floppy disk,
                    608: you can install across the network using PXE as described in
                    609: the included INSTALL.i386 document.
                    610:
                    611: <p>
                    612: If you are planning on dual booting OpenBSD with another OS, you will need to
                    613: read INSTALL.i386.
                    614:
                    615: <p>
                    616: To make a boot floppy under MS-DOS, use the &quot;rawrite&quot; utility located
                    617: at <i>CD1:5.5/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
                    618: use the
                    619: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&amp;sektion=1">dd(1)</a>
                    620: utility. The following is an example usage of
                    621: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&amp;sektion=1">dd(1)</a>,
                    622: where the device could be &quot;floppy&quot;, &quot;rfd0c&quot;, or
                    623: &quot;rfd0a&quot;.
                    624:
                    625: <ul><pre>
                    626: # <strong>dd if=&lt;file&gt; of=/dev/&lt;device&gt; bs=32k</strong>
                    627: </pre></ul>
                    628:
                    629: <p>
                    630: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
                    631: your install will most likely fail. For more information on creating a boot
                    632: floppy and installing OpenBSD/i386 please refer to
                    633: <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
                    634: </ul>
                    635:
                    636: <p>
                    637: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
                    638: <ul>
                    639: The 5.5 release of OpenBSD/amd64 is located on CD2.
                    640: Boot from the CD to begin the install - you may need to adjust
                    641: your BIOS options first.
                    642: If you can't boot from the CD, you can create a boot floppy to install from.
                    643: To do this, write <i>CD2:5.5/amd64/floppy55.fs</i> to a floppy, then
                    644: boot from the floppy drive.
                    645:
                    646: <p>
                    647: If you can't boot from a CD or a floppy disk,
                    648: you can install across the network using PXE as described in the included
                    649: INSTALL.amd64 document.
                    650:
                    651: <p>
                    652: If you are planning to dual boot OpenBSD with another OS, you will need to
                    653: read INSTALL.amd64.
                    654: </ul>
                    655:
                    656: <p>
                    657: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
                    658: <ul>
                    659: Burn the image from the FTP site to a CDROM, and power on your machine
                    660: while holding down the <i>C</i> key until the display turns on and
                    661: shows <i>OpenBSD/macppc boot</i>.
                    662:
                    663: <p>
                    664: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
                    665: /5.5/macppc/bsd.rd</i>
                    666: </ul>
                    667:
                    668: <p>
                    669: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
                    670: <ul>
                    671: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
                    672:
                    673: <p>
                    674: If this doesn't work, or if you don't have a CDROM drive, you can write
                    675: <i>CD3:5.5/sparc64/floppy55.fs</i> or <i>CD3:5.5/sparc64/floppyB55.fs</i>
                    676: (depending on your machine) to a floppy and boot it with <i>boot
                    677: floppy</i>. Refer to INSTALL.sparc64 for details.
                    678:
                    679: <p>
                    680: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    681: will most likely fail.
                    682:
                    683: <p>
                    684: You can also write <i>CD3:5.5/sparc64/miniroot55.fs</i> to the swap partition on
                    685: the disk and boot with <i>boot disk:b</i>.
                    686:
                    687: <p>
                    688: If nothing works, you can boot over the network as described in INSTALL.sparc64.
                    689: </ul>
                    690:
                    691: <p>
                    692: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
                    693: <ul>
                    694: <p>Write <i>FTP:5.5/alpha/floppy55.fs</i> or
                    695: <i>FTP:5.5/alpha/floppyB55.fs</i> (depending on your machine) to a diskette and
                    696: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
                    697:
                    698: <p>
                    699: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    700: will most likely fail.
                    701:
                    702: </ul>
                    703:
                    704: <p>
                    705: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
                    706: <ul>
                    707: <p>
                    708: After connecting a serial port, Thecus can boot directly from the network
                    709: either tftp or http. Configure the network using fconfig, reset,
                    710: then load bsd.rd, see INSTALL.armish for specific details.
                    711: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
                    712: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
                    713: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
                    714: More details are available in INSTALL.armish.
                    715: </ul>
                    716:
                    717: <p>
                    718: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
                    719: <ul>
                    720: <p>
                    721: Boot over the network by following the instructions in INSTALL.hp300.
                    722: </ul>
                    723:
                    724: <p>
                    725: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
                    726: <ul>
                    727: <p>
                    728: Boot over the network by following the instructions in INSTALL.hppa or the
                    729: <a href="hppa.html#install">hppa platform page</a>.
                    730: </ul>
                    731:
                    732: <p>
                    733: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
                    734: <ul>
                    735: <p>
                    736: Write <i>miniroot55.fs</i> to the start of the CF
                    737: or disk, and boot normally.
                    738: </ul>
                    739:
                    740: <p>
                    741: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
                    742: <ul>
                    743: <p>
                    744: Write <i>miniroot55.fs</i> to a USB stick and boot bsd.rd from it
                    745: or boot bsd.rd via tftp.
                    746: Refer to the instructions in INSTALL.loongson for more details.
                    747: </ul>
                    748: <p>
                    749:
                    750: <p>
                    751: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
                    752: <ul>
                    753: <p>
1.32      miod      754: Copy `boot' and `bsd.rd' to a Mach or UniOS partition, and boot the bootloader
                    755: from the PROM, and the bsd.rd from the bootloader.
                    756: Refer to the instructions in INSTALL.luna88k for more details.
1.1       deraadt   757: </ul>
                    758:
                    759: <p>
                    760: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
                    761: <ul>
                    762: <p>
                    763: You can create a bootable installation tape or boot over the network.<br>
                    764: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
                    765: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
                    766: for more details.
                    767: </ul>
                    768:
                    769: <p>
                    770: <h3><font color="#e00000">OpenBSD/mvme88k:</font></h3>
                    771: <ul>
                    772: <p>
                    773: You can create a bootable installation tape or boot over the network.<br>
                    774: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
                    775: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
                    776: for more details.
                    777: </ul>
                    778:
                    779: <p>
                    780: <h3><font color="#e00000">OpenBSD/octeon:</font></h3>
                    781: <ul>
                    782: <p>
                    783: After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
                    784: Refer to the instructions in INSTALL.octeon for more details.
                    785: </ul>
                    786:
                    787: <p>
                    788: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
                    789: <ul>
                    790: <p>
1.32      miod      791: To install, burn cd55.iso on a CD-R, put it in the CD drive of your
1.1       deraadt   792: machine and select <i>Install System Software</i> from the System Maintenance
1.32      miod      793: menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
                    794: CD-ROM, and need a proper invocation from the PROM prompt.
                    795: Refer to the instructions in INSTALL.sgi for more details.
1.1       deraadt   796:
                    797: <p>
1.32      miod      798: If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
                    799: server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
                    800: system type. Refer to the instructions in INSTALL.sgi for more details.
1.1       deraadt   801: </ul>
                    802:
                    803: <p>
                    804: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
                    805: <ul>
                    806: <p>
                    807: After connecting a serial port, boot over the network via DHCP/tftp.
                    808: Refer to the instructions in INSTALL.socppc for more details.
                    809: </ul>
                    810:
                    811: <p>
                    812: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
                    813: <ul>
                    814: Boot from one of the provided install ISO images, using one of the two
                    815: commands listed below, depending on the version of your ROM.
                    816:
                    817: <ul><pre>
                    818: ok <strong>boot cdrom 5.5/sparc/bsd.rd</strong>
                    819: or
                    820: &gt; <strong>b sd(0,6,0)5.5/sparc/bsd.rd</strong>
                    821: </pre></ul>
                    822:
                    823: <p>
                    824: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
                    825: To do so you need to write <i>floppy55.fs</i> to a floppy.
                    826: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
                    827: To boot from the floppy use one of the two commands listed below,
                    828: depending on the version of your ROM.
                    829:
                    830: <ul><pre>
                    831: ok <strong>boot floppy</strong>
                    832: or
                    833: &gt; <strong>b fd()</strong>
                    834: </pre></ul>
                    835:
                    836: <p>
                    837: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
                    838: will most likely fail.
                    839:
                    840: <p>
                    841: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
                    842: setup a bootable tape, or install via network, as told in the
                    843: INSTALL.sparc file.
                    844: </ul>
                    845:
                    846: <p>
                    847: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
                    848: <ul>
                    849: Boot over the network via mopbooting as described in INSTALL.vax.
                    850: </ul>
                    851:
                    852: <p>
                    853: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
                    854: <ul>
                    855: <p>
                    856: Using the Linux built-in graphical ipkg installer, install the
                    857: openbsd55_arm.ipk package.  Reboot, then run it.  Read INSTALL.zaurus
                    858: for a few important details.
                    859: </ul>
                    860:
                    861: <p>
                    862: <h3><font color="#e00000">Notes about the source code:</font></h3>
                    863: <ul>
                    864: src.tar.gz contains a source archive starting at /usr/src.  This file
                    865: contains everything you need except for the kernel sources, which are
                    866: in a separate archive.  To extract:
                    867: <p>
                    868: <ul><pre>
                    869: # <strong>mkdir -p /usr/src</strong>
                    870: # <strong>cd /usr/src</strong>
                    871: # <strong>tar xvfz /tmp/src.tar.gz</strong>
                    872: </pre></ul>
                    873: <p>
                    874: sys.tar.gz contains a source archive starting at /usr/src/sys.
                    875: This file contains all the kernel sources you need to rebuild kernels.
                    876: To extract:
                    877: <p>
                    878: <ul><pre>
                    879: # <strong>mkdir -p /usr/src/sys</strong>
                    880: # <strong>cd /usr/src</strong>
                    881: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
                    882: </pre></ul>
                    883: <p>
                    884: Both of these trees are a regular CVS checkout.  Using these trees it
                    885: is possible to get a head-start on using the anoncvs servers as
                    886: described <a href="anoncvs.html">here</a>.
                    887: Using these files
                    888: results in a much faster initial CVS update than you could expect from
                    889: a fresh checkout of the full OpenBSD source tree.
                    890: <p>
                    891: </ul>
                    892:
                    893: <a name="upgrade"></a>
                    894: <hr>
                    895: <p>
                    896: <h3><font color="#0000e0">How to upgrade</font></h3>
                    897: <p>
                    898: If you already have an OpenBSD 5.4 system, and do not want to reinstall,
                    899: upgrade instructions and advice can be found in the
                    900: <a href="faq/upgrade55.html">Upgrade Guide</a>.
                    901:
                    902: <a name="ports"></a>
                    903: <hr>
                    904: <p>
                    905: <h3><font color="#0000e0">Ports Tree</font></h3>
                    906: <p>
                    907: A ports tree archive is also provided.  To extract:
                    908: <p>
                    909: <ul><pre>
                    910: # <strong>cd /usr</strong>
                    911: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
                    912: </pre></ul>
                    913: <p>
                    914: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree.  Go
                    915: read the <a href="faq/ports/index.html">ports</a> page
                    916: if you know nothing about ports
                    917: at this point.  This text is not a manual of how to use ports.
                    918: Rather, it is a set of notes meant to kickstart the user on the
                    919: OpenBSD ports system.
                    920: <p>
                    921: The <i>ports/</i> directory represents a CVS (see the manpage for
                    922: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&amp;sektion=1&amp;arch=i386">
                    923: cvs(1)</a> if
                    924: you aren't familiar with CVS) checkout of our ports.  As with our complete
                    925: source tree, our ports tree is available via
                    926: <a href="anoncvs.html">AnonCVS</a>.
                    927: So, in order to keep current with it, you must make the <i>ports/</i> tree
                    928: available on a read-write medium and update the tree with a command
                    929: like:
                    930: <p>
                    931: <ul><pre>
                    932: # <strong>cd /usr/ports</strong>
                    933: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_5</strong>
                    934: </pre></ul>
                    935: <p>
                    936: [Of course, you must replace the server name here with a nearby anoncvs
                    937: server.]
                    938: <p>
                    939: Note that most ports are available as packages through FTP. Updated
                    940: packages for the 5.5 release will be made available if problems arise.
                    941: <p>
                    942: If you're interested in seeing a port added, would like to help out, or just
                    943: would like to know more, the mailing list
                    944: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
                    945: <p>
                    946: </body>
                    947: </html>