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

File: [local] / www / 54.html (download) (as text)

Revision 1.51, Thu Jun 13 06:16:25 2019 UTC (4 years, 11 months ago) by deraadt
Branch: MAIN
CVS Tags: HEAD
Changes since 1.50: +0 -4 lines

settle on a single pattern for the untar related blockquotes

<!doctype html>
<html lang=en id=release>
<meta charset=utf-8>

<title>OpenBSD 5.4</title>
<meta name="description" content="OpenBSD 5.4">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" type="text/css" href="openbsd.css">
<link rel="canonical" href="https://www.openbsd.org/54.html">

<h2 id=OpenBSD>
<a href="index.html">
<i>Open</i><b>BSD</b></a>
5.4
</h2>

<table>
<tr>
<td>
<a href="images/Puffia.jpg">
<img width="227" height="343" src="images/Puffia.jpg" alt="Puffia"></a>
<td>
Released Nov 1, 2013<br>
Copyright 1997-2013, Theo de Raadt.<br>
<cite class=isbn>ISBN 978-0-9881561-2-8</cite>
<br>
5.4 Song: <a href="lyrics.html#54">"Our favorite hacks"</a>
<br>
<br>
<ul>
<li>See the information on <a href="ftp.html">the FTP page</a> for
    a list of mirror machines.
<li>Go to the <code class=reldir>pub/OpenBSD/5.4/</code> directory on
    one of the mirror sites.
<li>Have a look at <a href="errata54.html">The 5.4 Errata page</a> for a list
    of bugs and workarounds.
<li>See a <a href="plus54.html">detailed log of changes</a> between the
    5.3 and 5.4 releases.
</ul>
<p>
All applicable copyrights and credits are in the src.tar.gz,
sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
files fetched via <code>ports.tar.gz</code>.
</table>

<hr>

<section id=new>
<h3>What's New</h3>
<p>
This is a partial list of new features and systems included in OpenBSD 5.4.
For a comprehensive list, see the <a href="plus54.html">changelog</a> leading
to 5.4.
<p>

<ul>
<li>New/extended platforms:
    <ul>
    <li><a href="octeon.html">OpenBSD/octeon</a><br>
        New platform for systems based on the Cavium Octeon MIPS-compatible
        processors. Supported machines include:
        <ul>
        <li>Portwell CAM-0100
        <li>Ubiquiti Networks EdgeRouter LITE (no local storage)
        </ul>
    <li><a href="beagle.html">OpenBSD/beagle</a><br>
        New platform for OMAP3/4 and AM335x systems using an ARM Cortex-A8 or
        Cortex-A9 CPU. Supported boards include:
        <ul>
        <li>BeagleBoard C4 / xM
        <li>BeagleBone and BeagleBone Black
        <li>PandaBoard and PandaBoard ES
        </ul>
    </ul>
<p>

<li>Improved hardware support, including:
    <ul>
    <li><a href="https://man.openbsd.org/inteldrm.4">inteldrm(4)</a>
        has been overhauled, including:
        <ul>
        <li>Now mostly in sync with Linux 3.8.13.
        <li>Support for Kernel Mode Setting (KMS) including support for additional output types such as DisplayPort.
        <li>Sandy Bridge and newer parts which previously had only ShadowFB acceleration
            now have full hardware acceleration including use of the 3D rings.
        <li><a href="https://man.openbsd.org/wsdisplay.4">wsdisplay(4)</a> now attaches to
            <a href="https://man.openbsd.org/inteldrm.4">inteldrm(4)</a> and providers a
            framebuffer console.
        </ul>
    <li><a href="https://man.openbsd.org/macppc/vgafb.4">vgafb(4/macppc)</a> now supports multiple virtual consoles.
    <li>Support for Elantech touchpads version 4 (clickpad) added to <a href="https://man.openbsd.org/pms.4">pms(4)</a>.
    <li>Fixed <a href="https://man.openbsd.org/st.4">st(4)</a> EOM handling, enabling much better Bacula support.
    <li>Support for <a href="https://man.openbsd.org/sparc64/vdsk.4">vdsk(4)</a> disks larger than 2TB.
    </ul>
<p>

<li>Generic network stack improvements:
    <ul>
    <li>Reworked checksum handling for network protocols.
    <li><a href="https://man.openbsd.org/divert.4">divert(4)</a> now recalculates the IP and protocol checksums of reinjected packets.
    <li>No longer attempt to delete the undeletable RNF_ROOT route.
    </ul>
<p>

<li>Routing daemons and other userland network improvements:
    <ul>
    <li>Support SSL inspection in <a href="https://man.openbsd.org/relayd.8">relayd(8)</a>.
    <li>Added <a href="https://man.openbsd.org/slowcgi.8">slowcgi(8)</a>, a libevent-based FastCGI implementation.
    <li>Enabled ECDHE support in <a href="https://man.openbsd.org/httpd.8">httpd(8)</a>.
    <li>Do not start <a href="https://man.openbsd.org/inetd.8">inetd(8)</a> by default any more.
    <li>Many <a href="https://man.openbsd.org/ldpd.8">ldpd(8)</a> improvements, including a speed-up of the session establishment process, support for adjacencies and targeted hellos, support for multiple addresses per interface, and more.
    </ul>
<p>

<li><a href="https://man.openbsd.org/dhcpd.8">dhcpd(8)</a> improvements:
    <ul>
    <li>Improved compliance with RFC 2131 strictures on client-identifiers.
    <li>Fixed synchronization of leases.
    <li>Replaced manual date parsing and printing with strftime and strptime.
    <li>Explicitly label dates in leases files as being UTC dates.
    </ul>

<p>

<li><a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> improvements:
    <ul>
    <li>Delete routes added by defunct dhclient processes.
    <li>Improved handling of client-identifier option.
    <li>Increased ip_ttl on packets to 128, allowing more distant servers to provide leases.
    <li>Replaced manual date parsing and printing with strftime and strptime.
    <li>Explicitly label dates in leases files as being UTC dates.
    <li>Improved interactions between dhclient processes to make the most recent dhclient started the most likely to persist.
    <li>Support for static routes and classless static routes options.
    <li>Fixed log messages to print correct addresses.
    <li>Reduced log verbosity by emitting debug messages only when debugging.
    <li>Eliminated unnecessary address and route churn during lease renewal by not binding leases identical to the current one.
    </ul>

<p>

<li>OpenSMTPD 5.3.3:
    <ul>
    <li>New features:
      <ul>
	<li>Add support for LMTP local deliveries
	<li>Add SECURE and AUTH transmission types
	<li>Add support for transparent queue compression
	<li>helo names can now be looked up in a db(3) table
	<li>New "error:" alias kind allows aliasing a user-part to an error
	<li>Traces can be (de)activated at runtime
      </ul>

    <li>Improvements:
      <ul>
	<li>More robust queue can cope with runtime errors
	<li>Improved routing strategies
	<li>Assorted minor bug fixes and cleanups
      </ul>
    </ul>
<p>

<li>Performance improvements:
    <ul>
    <li>Don't require the kernel lock when processing audio interrupts.
    <li>Improved kernel bcopy/memmove/memcpy implementations and made more careful choices between them.
    <li>Implemented symbol caching and RELCOUNT/RELACOUNT optimizations in <a href="https://man.openbsd.org/ld.so.1">ld.so(1)</a>.
    </ul>
<p>

<li>Threading improvements:
    <ul>
    <li>Closed various race conditions between exit/fork/execve/__tfork/__threxit/ptrace in both the kernel and libpthread.
    </ul>
<p>

<li>Assorted improvements:
    <ul>
    <li>Added a <a href="https://man.openbsd.org/locale.1">locale(1)</a> utility.
    <li>Added <a href="https://man.openbsd.org/ltrace.1">ltrace(1)</a>, a tool to trace PLT calls.
    <li>Added a new implementation of <a href="https://man.openbsd.org/cu.1">cu(1)</a>.
    <li>Added <a href="https://man.openbsd.org/shm_open.3">shm_open(3)/shm_unlink(3)</a>.
    <li>Added <a href="https://man.openbsd.org/getprogname.3">getprogname(3)/setprogname(3)</a>.
    <li>Added <a href="https://man.openbsd.org/clock_getcpuclockid.3">clock_getcpuclockid(3)</a> and
        <a href="https://man.openbsd.org/pthread_getcpuclockid.3">pthread_getcpuclockid(3)</a>.
    <li>Added <a href="https://man.openbsd.org/fmemopen.3">fmemopen(3)</a>.
    <li>Added <a href="https://man.openbsd.org/open_memstream.3">open_memstream(3)/open_wmemstream(3)</a>.
    <li>Added <a href="https://man.openbsd.org/memmem.3">memmem(3)</a>.
    <li>Added <a href="https://man.openbsd.org/fdatasync.2">fdatasync(2)</a>.
    <li>Added <a href="https://man.openbsd.org/ppoll.2">ppoll(2)</a>.
    <li>Added <a href="https://man.openbsd.org/pselect.2">pselect(2)</a>.
    <li>Added <a href="https://man.openbsd.org/utrace.2">utrace(2)</a>.
    <li>Switched the <a href="vax.html">VAX</a> platform to <a href="https://man.openbsd.org/elf.5">ELF</a>.
    <li>Fixed kernel profiling on multiprocessor systems.
    <li>Experimental support for <a href="https://man.openbsd.org/fuse.4">fuse(4)</a>.
    <li>Added support for <code>write_opt=nodir</code> and the 'path' and 'linkpath' extended headers to <a href="https://man.openbsd.org/pax.1">pax(1)</a> (aka <a href="https://man.openbsd.org/tar.1">tar(1)</a>).
    <li>Brought <a href="https://man.openbsd.org/getconf.1">getconf(1)</a> up to date with recent POSIX updates.
    <li>Added -L and -P options to <a href="https://man.openbsd.org/ln.1">ln(1)</a>.
    <li>More structures and symbolic values displayed by <a href="https://man.openbsd.org/kdump.1">kdump(1)</a>.
    <li><a href="https://man.openbsd.org/pkill.1">pkill(1)</a> now accepts an -I option to ask for confirmation on killing processes.
    </ul>
<p>

<li>OpenSSH 6.3:
    <ul>
    <li>New features:
      <ul>
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        add
        <a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>
        support to
        <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>;
        allows encrypted hostkeys, or hostkeys on smartcards.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
        and
        <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        allow optional time-based rekeying via a second argument to the
        existing <code>RekeyLimit</code> option.  <code>RekeyLimit</code> is now
        supported in
        <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
        as well as on the client.
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        standardise logging of information during user authentication.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        add the ability to query supported ciphers, MAC algorithms, key types
        and key exchange methods.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        support <code>ProxyCommand=-</code> to allow support cases where stdin and
        stdout already point to the proxy.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        allow <code>IdentityFile=none</code>.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
        and
        <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        add <code>-E</code> option to
        <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
        and
        <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
        to append debugging logs to a specified file instead of stderr or
        syslog.
      <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
        add support for resuming partial downloads using the <code>reget</code>
        command and on the
        <a href="https://man.openbsd.org/sftp.1">sftp(1)</a>
        commandline or on the get commandline using the <code>-a</code>
        (append) option.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        add an <code>IgnoreUnknown</code> configuration option to selectively
        suppress errors arising from unknown configuration directives.
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        add support for submethods to be appended to required authentication
        methods listed via <code>AuthenticationMethods</code>.
      </ul>
    <li>The following significant bugs have been fixed in this release:
      <ul>
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        fix refusal to accept certificate if a key of a different type to the
        CA key appeared in <code>authorized_keys</code> before the CA key.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
        <a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>
        and
        <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        Use a monotonic time source for timers so that things like keepalives
        and rekeying will work properly over clock steps.
      <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
        update progressmeter when data is acknowledged, not when it's sent.
        (bz#2108)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
        and
        <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
        improve error messages when the current user does not exist in
        <code>/etc/passwd</code>. (bz#2125)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        reset the order in which public keys are tried after partial
        authentication success.
      <li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
        clean up socket files after SIGINT when in debug mode. (bz#2120)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
        and others: avoid confusing error messages in the case of broken system
        resolver configurations. (bz#2122)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        set TCP nodelay for connections started with <code>-N</code>. (bz#2124)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        correct manual for permission requirements on <code>~/.ssh/config</code>.
        (bz#2078)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        fix <code>ControlPersist</code> timeout not triggering in cases where TCP
        connections have hung. (bz#1917)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        properly detach a <code>ControlPersist</code> master from its controlling
        terminal.
      <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
        avoid crashes in libedit when it has been compiled with multi-byte
        character support. (bz#1990)
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        when running <code>sshd -D</code>, close stderr unless we have explicitly
        requested logging to stderr. (bz#1976)
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        fix incomplete bzero. (bz#2100)
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        log and error and exit if <code>ChrootDirectory</code> is specified and
        running without root privileges.
      <li>Many improvements to the regression test suite. In particular log
        files are now saved from
        <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
        and
        <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
        after failures.
      <li>Fix a number of memory leaks. (bz#1967, bz#2096 and others)
      <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
        fix public key authentication when a <code>:style</code> is appended to the
        requested username.
      <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
        do not fatally exit when attempting to cleanup multiplexing-created
        channels that are incompletely opened. (bz#2079)
      </ul>
    </ul>
<p>

<li>Over 7,800 ports, major stability improvements in
the package build process
    <ul>
    <li>The parallel ports builder is better at catching up errors on older
slower platforms, thus allowing release engineers to better concentrate on
real errors.
    </ul>
<p>
<li>Many pre-built packages for each architecture:
    <ul style="column-count: 4">
      <li>i386:       7976
      <li>sparc64:    6959
      <li>alpha:      6062
      <li>m68k:       3862
      <li>sh:          989
      <li>amd64:      7941
      <li>powerpc:    7483
      <li>m88k:       3951
      <li>sparc:      4823
      <li>arm:        5582
      <li>hppa:       6607
      <li>vax:        2226
      <li>mips64:     6739
      <li>mips64el:   6306
    </ul>
<p>

<li>Some highlights:
    <ul>
    <li>GNOME 3.8.3			<li>KDE 3.5.10
    <li>Xfce 4.10			<li>MySQL 5.1.70
    <li>PostgreSQL 9.2.4		<li>Postfix 2.10.1
    <li>OpenLDAP 2.3.43 and 2.4.35	<li>Mozilla Firefox 3.6.28 and 22.0
    <li>Mozilla Thunderbird 17.0.7	<li>GHC 7.6.3
    <li>LibreOffice 4.0.4.2		<li>Emacs 21.4 and 24.3
    <li>Vim 7.3.850			<li>PHP 5.2.17 and 5.3.27
    <li>Python 2.7.5 and 3.3.2		<li>Ruby 1.8.7.374, 1.9.3.448 and 2.0.0.247
    <li>Tcl/Tk 8.4.20, 8.5.14 and 8.6.0	<li>JDK 1.6.0.32 and 1.7.0.21
    <li>Mono 2.10.9			<li>Chromium 28.0.1500.45
    <li>Groff 1.22.2			<li>Go 1.1.1
    <li>GCC 4.6.4 and 4.8.1		<li>LLVM/Clang 3.3
    <li>Node.js 0.10.12
    </ul>
<p>

<li>As usual, steady improvements in manual pages and other documentation.
<p>

<li>The system includes the following major components from outside suppliers:
    <ul>
    <li>Xenocara (based on X.Org 7.7 with xserver 1.14.1 + patches,
      freetype 2.4.12, fontconfig 2.10.91, Mesa 7.11.2, xterm 293,
      xkeyboard-config 2.7 and more)
    <li>Gcc 4.2.1 (+patches), 3.3.6 (+ patches) and 2.95.3 (+ patches)
    <li>Perl 5.16.3 (+ patches)
    <li>Our improved and secured version of Apache 1.3, with
      SSL/TLS and DSO support
    <li>Nginx 1.4.1 (+ patches)
    <li>OpenSSL 1.0.1c (+ patches)
    <li>SQLite 3.7.17 (+ patches)
    <li>Sendmail 8.14.7, with libmilter
    <li>Bind 9.4.2-P2 (+ patches)
    <li>NSD 3.2.15
    <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
    <li>Sudo 1.7.2p8
    <li>Ncurses 5.7
    <li>Heimdal 1.5.2 (+ patches)
    <li>Binutils 2.15 (+ patches)
    <li>Gdb 6.3 (+ patches)
    <li>Less 444 (+ patches)
    <li>Awk Aug 10, 2011 version
    </ul>
</ul>
</section>

<hr>

<section id=install>
<h3>How to install</h3>
<p>
Following this are the instructions which you would have on a piece of
paper if you had purchased a CDROM set instead of doing an alternate
form of install.  The instructions for doing an FTP (or other style
of) install are very similar; the CDROM instructions are left intact
so that you can see how much easier it would have been if you had
purchased a CDROM instead.
<p>

<hr>
Please refer to the following files on the three CDROMs or FTP mirror for
extensive details on how to install OpenBSD 5.4 on your machine:
<p>
<ul>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/i386/INSTALL.i386">
	.../OpenBSD/5.4/i386/INSTALL.i386 (on CD1)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/amd64/INSTALL.amd64">
	.../OpenBSD/5.4/amd64/INSTALL.amd64 (on CD2)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/sparc64/INSTALL.sparc64">
	.../OpenBSD/5.4/sparc64/INSTALL.sparc64 (on CD3)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/alpha/INSTALL.alpha">
	.../OpenBSD/5.4/alpha/INSTALL.alpha</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/armish/INSTALL.armish">
	.../OpenBSD/5.4/armish/INSTALL.armish</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/beagle/INSTALL.beagle">
	.../OpenBSD/5.4/beagle/INSTALL.beagle</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/hp300/INSTALL.hp300">
	.../OpenBSD/5.4/hp300/INSTALL.hp300</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/hppa/INSTALL.hppa">
	.../OpenBSD/5.4/hppa/INSTALL.hppa</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/landisk/INSTALL.landisk">
	.../OpenBSD/5.4/landisk/INSTALL.landisk</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/loongson/INSTALL.loongson">
	.../OpenBSD/5.4/loongson/INSTALL.loongson</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/luna88k/INSTALL.luna88k">
	.../OpenBSD/5.4/luna88k/INSTALL.luna88k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/macppc/INSTALL.macppc">
	.../OpenBSD/5.4/macppc/INSTALL.macppc</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/mvme68k/INSTALL.mvme68k">
	.../OpenBSD/5.4/mvme68k/INSTALL.mvme68k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/mvme88k/INSTALL.mvme88k">
	.../OpenBSD/5.4/mvme88k/INSTALL.mvme88k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/octeon/INSTALL.octeon">
	.../OpenBSD/5.4/octeon/INSTALL.octeon</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/sgi/INSTALL.sgi">
	.../OpenBSD/5.4/sgi/INSTALL.sgi</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/socppc/INSTALL.socppc">
	.../OpenBSD/5.4/socppc/INSTALL.socppc</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/sparc/INSTALL.sparc">
	.../OpenBSD/5.4/sparc/INSTALL.sparc</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/vax/INSTALL.vax">
	.../OpenBSD/5.4/vax/INSTALL.vax</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.4/zaurus/INSTALL.zaurus">
	.../OpenBSD/5.4/zaurus/INSTALL.zaurus</a>
</ul>
</section>

<hr>

<section id=quickinstall>

<p>
Quick installer information for people familiar with OpenBSD, and the
use of the "disklabel -E" command.  If you are at all confused when
installing OpenBSD, read the relevant INSTALL.* file as listed above!

<h3>OpenBSD/i386:</h3>

<p>
Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
release is on CD1. If your BIOS does not support booting from CD, you will need
to create a boot floppy to install from. To create a boot floppy write
<i>CD1:5.4/i386/floppy54.fs</i> to a floppy and boot via the floppy drive.

<p>
Use <i>CD1:5.4/i386/floppyB54.fs</i> instead for greater SCSI controller
support, or <i>CD1:5.4/i386/floppyC54.fs</i> for better laptop support.

<p>
If you can't boot from a CD or a floppy disk,
you can install across the network using PXE as described in
the included INSTALL.i386 document.

<p>
If you are planning on dual booting OpenBSD with another OS, you will need to
read INSTALL.i386.

<p>
To make a boot floppy under MS-DOS, use the &quot;rawrite&quot; utility located
at <i>CD1:5.4/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
use the
<a href="https://man.openbsd.org/dd.1">dd(1)</a>
utility. The following is an example usage of
<a href="https://man.openbsd.org/dd.1">dd(1)</a>,
where the device could be &quot;floppy&quot;, &quot;rfd0c&quot;, or
&quot;rfd0a&quot;.

<blockquote><pre>
# <kbd>dd if=&lt;file&gt; of=/dev/&lt;device&gt; bs=32k</kbd>
</pre></blockquote>

<p>
Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
your install will most likely fail. For more information on creating a boot
floppy and installing OpenBSD/i386 please refer to
<a href="faq/faq4.html#MkFlop">this page</a>.

<h3>OpenBSD/amd64:</h3>

<p>
The 5.4 release of OpenBSD/amd64 is located on CD2.
Boot from the CD to begin the install - you may need to adjust
your BIOS options first.
If you can't boot from the CD, you can create a boot floppy to install from.
To do this, write <i>CD2:5.4/amd64/floppy54.fs</i> to a floppy, then
boot from the floppy drive.

<p>
If you can't boot from a CD or a floppy disk,
you can install across the network using PXE as described in the included
INSTALL.amd64 document.

<p>
If you are planning to dual boot OpenBSD with another OS, you will need to
read INSTALL.amd64.

<h3>OpenBSD/macppc:</h3>

<p>
Burn the image from the FTP site to a CDROM, and power on your machine
while holding down the <i>C</i> key until the display turns on and
shows <i>OpenBSD/macppc boot</i>.

<p>
Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
/5.4/macppc/bsd.rd</i>

<h3>OpenBSD/sparc64:</h3>

<p>
Put CD3 in your CDROM drive and type <i>boot cdrom</i>.

<p>
If this doesn't work, or if you don't have a CDROM drive, you can write
<i>CD3:5.4/sparc64/floppy54.fs</i> or <i>CD3:5.4/sparc64/floppyB54.fs</i>
(depending on your machine) to a floppy and boot it with <i>boot
floppy</i>. Refer to INSTALL.sparc64 for details.

<p>
Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
will most likely fail.

<p>
You can also write <i>CD3:5.4/sparc64/miniroot54.fs</i> to the swap partition on
the disk and boot with <i>boot disk:b</i>.

<p>
If nothing works, you can boot over the network as described in INSTALL.sparc64.

<h3>OpenBSD/alpha:</h3>

<p>
Write <i>5.4/alpha/floppy54.fs</i> or
<i>5.4/alpha/floppyB54.fs</i> (depending on your machine) to a diskette and
enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.

<p>
Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
will most likely fail.

<h3>OpenBSD/armish:</h3>

<p>
After connecting a serial port, Thecus can boot directly from the network
either tftp or http. Configure the network using fconfig, reset,
then load bsd.rd, see INSTALL.armish for specific details.
IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
More details are available in INSTALL.armish.

<h3>OpenBSD/hp300:</h3>

<p>
Boot over the network by following the instructions in INSTALL.hp300.

<h3>OpenBSD/hppa:</h3>

<p>
Boot over the network by following the instructions in INSTALL.hppa or the
<a href="hppa.html#install">hppa platform page</a>.

<h3>OpenBSD/landisk:</h3>

<p>
Write <i>miniroot54.fs</i> to the start of the CF
or disk, and boot normally.

<h3>OpenBSD/loongson:</h3>

<p>
Write <i>miniroot54.fs</i> to a USB stick and boot bsd.rd from it
or boot bsd.rd via tftp.
Refer to the instructions in INSTALL.loongson for more details.

<h3>OpenBSD/luna88k:</h3>

<p>
Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
Alternatively, you can create a bootable tape and boot from it. Refer to
the instructions in INSTALL.luna88k for more details.

<h3>OpenBSD/mvme68k:</h3>

<p>
You can create a bootable installation tape or boot over the network.<br>
The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
for more details.

<h3>OpenBSD/mvme88k:</h3>

<p>
You can create a bootable installation tape or boot over the network.<br>
The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
for more details.

<h3>OpenBSD/octeon:</h3>

<p>
After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
Refer to the instructions in INSTALL.octeon for more details.

<h3>OpenBSD/sgi:</h3>

<p>
To install on an O2, burn cd54.iso on a CD-R, put it in the CD drive of your
machine and select <i>Install System Software</i> from the System Maintenance
menu.

<p>
On other systems, or if your machine doesn't have a CD drive, you can
setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
the kernel matching your system type.
Refer to the instructions in INSTALL.sgi for more details.

<h3>OpenBSD/socppc:</h3>

<p>
After connecting a serial port, boot over the network via DHCP/tftp.
Refer to the instructions in INSTALL.socppc for more details.

<h3>OpenBSD/sparc:</h3>

<p>
Boot from one of the provided install ISO images, using one of the two
commands listed below, depending on the version of your ROM.

<blockquote><pre>
ok <kbd>boot cdrom 5.4/sparc/bsd.rd</kbd>
or
> <kbd>b sd(0,6,0)5.4/sparc/bsd.rd</kbd>
</pre></blockquote>

<p>
If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
To do so you need to write <i>floppy54.fs</i> to a floppy.
For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
To boot from the floppy use one of the two commands listed below,
depending on the version of your ROM.

<blockquote><pre>
ok <kbd>boot floppy</kbd>
or
> <kbd>b fd()</kbd>
</pre></blockquote>

<p>
Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
will most likely fail.

<p>
If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
setup a bootable tape, or install via network, as told in the
INSTALL.sparc file.

<h3>OpenBSD/vax:</h3>

<p>
Boot over the network via mopbooting as described in INSTALL.vax.

<h3>OpenBSD/zaurus:</h3>

<p>
Using the Linux built-in graphical ipkg installer, install the
openbsd54_arm.ipk package.  Reboot, then run it.  Read INSTALL.zaurus
for a few important details.
</section>

<hr>

<section id=sourcecode>
<h3>Notes about the source code</h3>
<p>
<code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
This file contains everything you need except for the kernel sources, which are
in a separate archive.  To extract:
<blockquote><pre>
# <kbd>mkdir -p /usr/src</kbd>
# <kbd>cd /usr/src</kbd>
# <kbd>tar xvfz /tmp/src.tar.gz</kbd>
</pre></blockquote>
<p>
<code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
This file contains all the kernel sources you need to rebuild kernels.
To extract:
<blockquote><pre>
# <kbd>mkdir -p /usr/src/sys</kbd>
# <kbd>cd /usr/src</kbd>
# <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
</pre></blockquote>
<p>
Both of these trees are a regular CVS checkout.  Using these trees it
is possible to get a head-start on using the anoncvs servers as
described <a href="anoncvs.html">here</a>.
Using these files
results in a much faster initial CVS update than you could expect from
a fresh checkout of the full OpenBSD source tree.
</section>

<hr>

<section id=upgrade>
<h3>How to upgrade</h3>
<p>
If you already have an OpenBSD 5.3 system, and do not want to reinstall,
upgrade instructions and advice can be found in the
<a href="faq/upgrade54.html">Upgrade Guide</a>.
</section>

<hr>

<section id=ports>
<h3>Ports Tree</h3>
<p>
A ports tree archive is also provided.  To extract:
<blockquote><pre>
# <kbd>cd /usr</kbd>
# <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
</pre></blockquote>
<p>
The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree.  Go
read the <a href="faq/ports/index.html">ports</a> page
if you know nothing about ports
at this point.  This text is not a manual of how to use ports.
Rather, it is a set of notes meant to kickstart the user on the
OpenBSD ports system.
<p>
The <i>ports/</i> directory represents a CVS (see the manpage for
<a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
you aren't familiar with CVS) checkout of our ports.  As with our complete
source tree, our ports tree is available via
<a href="anoncvs.html">AnonCVS</a>.
So, in order to keep current with it, you must make the <i>ports/</i> tree
available on a read-write medium and update the tree with a command
like:
<blockquote><pre>
# <kbd>cd /usr/ports</kbd>
# <kbd>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_4</kbd>
</pre></blockquote>
<p>
[Of course, you must replace the server name here with a nearby anoncvs
server.]
<p>
Note that most ports are available as packages on our mirrors. Updated
packages for the 5.4 release will be made available if problems arise.
<p>
If you're interested in seeing a port added, would like to help out, or just
would like to know more, the mailing list
<a href="mail.html">ports@openbsd.org</a> is a good place to know.
</section>