What's New

This is a partial list of new features and systems included in OpenBSD 5.8. For a comprehensive list, see the changelog leading to 5.8.

• Improved hardware support, including:
  • New rtwn(4) driver for Realtek RTL8188CE wifi cards.
  • New hpb(4) driver for HyperTransport bridges as found in the IBM CPC945.
  • The ugold(4) driver now supports TEMPerHUMV1.x temperature and humidity sensors.
  • Improved sensor support for the upd(4) driver for USB Power Devices (UPS).
  • Support for jumbo frames on re(4) devices using RTL8168C/D/E/F/G and RTL8411, including PC Engines APU.
  • re(4) now works with newer devices e.g. RTL8111GU.
  • Partial support has been added for full-speed isochronous devices in ehci(4), allowing USB 1.1 audio devices to be used on EHCI-only systems in some cases.
  • Improved macppc stability and G5 performances with MP kernels.
  • acpicpu(4) uses ACPI C-state information to reduce power consumption of idle CPUs.
  • Kernel supports x86 AVX instructions on CPUs that have them.
  • Avoid assigning low address to PCI BARs, fixing various issues on machines whose BIOSes neglect to claim low memory.
  • wscons(4) works with even more odd trackpads.
  • Added pvbus(4) paravirtual device tree root on virtual machines that are running on hypervisors.
  • New octdwctwo(4) driver for USB support on OpenBSD/octeon.
  • New amdcf(4) driver for embedded flash on OpenBSD/octeon.
  • Support for RTL8188EU devices was added to the urtwn(4) driver.

• Removed hardware support:
  • The lmc(4) driver for Lan Media Corporation SSI/T1/DS1/HSSI/DS3 devices has been removed.
  • The san(4) driver for Sangoma Technologies AFT T1/E1 devices has been removed.

• Generic network stack improvements:
  • MTU of vlan(4) devices can now be set independently from the parent interface's MTU.
  • The same network range can now be assigned to multiple interfaces, using interface priorities to choose between them.
  • New MPLS pseudowire driver mpw(4).
  • Much preparatory work for MP unlocking of the network stack.

• Installer improvements:
  • The logic of the 'Allow root ssh login?' question has been changed.
    • The default answer is now 'no'.
    • 'prohibit-password' has been added to the list of possible answers.
  • autoinstall(8) has been extended to allow
    • hostname-mode.conf response file names.
    • response files to be placed in a subdir of the webserver's document root.
    • passing a template file to disklabel(8) to automatically partition the disk.
  • ntpd(8) is now enabled by default at install time.
  • DUID support has improved enough that new installs now use them unconditionally.
  • Installing sets from CD-ROM has been fixed if more than one CD-ROM drive is present.
  • The 'Which CD-ROM contains the install media?' question has been removed. Available cdrom devices are now shown directly in the 'Location of sets?' prompt.

• Routing daemons and other userland network improvements:
  • Many improvements and simplifications in ldpd(8), including configuration reload and support for mpw(4) pseudowire interfaces.
  • bgpd(8) now allows rules to match on the peer AS number.
  • For terminated BGP sessions, bgpctl(8) now displays the number of prefixes received on the last session.
  • ospfd(8) now correctly handles carp(4) interfaces in "backup" mode at startup.
  • Log messages in bgpd(8) and ospfd(8) have been made more specific.
  • The default Diffie-Hellman group for VPNs configured by ipsec.conf(5) has been changed to modp3072.
  • New radiusd(8), Remote Authentication Dial In User Service (RADIUS) daemon.

• Security improvements:
  • sudo in base has been replaced with doas(1), sudo is available as a package.
  • file(1) has been replaced with a new modern implementation, including sandbox and privilege separation.
  • pax(1) (and tar(1) and cpio(1)) now prevent archive extraction from escaping the current directory via symlinks; tar(1) without -P option now strips up through any ".." path components.
  • Static PIE support for sparc.
  • Alpha switched to secure PLT.
  • Improved kernel checks of ELF headers.
  • Support for the NX (No-eXecute) bit on i386, resulting in much better W^X enforcement in userland for hardware that has this feature.
  • Enforcement of W^X in the kernel address space on i386 when using processors with the NX bit.
  • Work started on a new process-containment facility called tame(2).

• Assorted improvements:
  • The worm(6) now grows at a rate proportional to terminal size.
  • dlclose(3) now unregisters handlers registered by a pthread_atfork(3) call from the unloaded libraries.
  • cp(1), mv(1), and pax(1) with the -rw option now preserve timestamps with full nanosecond precision.
  • pax(1) now detects failure to decompress an archive when reading it and errors out immediately.
  • nm(1) now supports the -D option for displaying the dynamic symbol table.
  • dump(8) now uses DUIDs in /etc/dumpdates when present and the -U option has thus been removed.
  • Corrected kdump(1) reporting of lseek(2) return value on ILP32 archs and getsockopt/setsockopt(2) level and optname arguments. iovec, msghdr, and cmsghdr structures are now dumped.
  • sed(1) -i option added.
  • New, much simpler man.conf(5) configuration file format for man(1), apropos(1), and makewhatis(8).
  • When using man(1) with the less(1) pager, support the :t internal command to search for definitions of keywords similar to what ctags(1) provides.
  • Improvements in checking of numeric option values in many utilities.
  • Upgraded to binutils version 2.17 with additional fixes.
  • Improved correctness of poll(2) and poll(2) of O_RDONLY FIFO fds.
  • Restored reporting of closed sockets by netstat(1) and systat(1).
  • fdisk(8) now zeros correct GPT sector at end of disk.
  • fdisk(8) now accepts 'T' sizes for terabytes.
  • fdisk(8) repaired to work on 4K sector disks again.
  • dhcpd(8) now logs correct giaddr and ciaddr information even when DHCP relays are present.
  • dhcpd(8) now accommodates Linux and MS clients by not sending routers or static routes info when classless static routes are sent.
  • dhcpd(8) and dhclient(8) now accept hostnames beginning with a digit.
  • dhclient(8) no longer rejects leases with addresses overlapping existing subnets on other interfaces. Kernel routing logic now just works.
  • Improvements to realloc(3) decrease system calls and increase efficiency.
  • The reaper now tears down dead processes without holding on to the kernel lock. This greatly reduces latency and increases performance on multi-processor systems.

• OpenBSD httpd(8):
  • New features:
    • Added support for matching and redirections with Lua patterns(7).
    • Implemented If-Modified-Since for conditional GET or HEAD requests (RFC 7232).
    • Added byte-range support for range requests (RFC 7233).
    • Allowing to specify a global or per-location default media type instead of application/octet-stream.
    • Added support for HTTP Strict Transport Security (HSTS; RFC 6797).
    • Added initial regression test suite based on relayd(8)'s implementation.
  • Fixes and improvements:
    • TLS in httpd(8) and relayd(8) now defaults to TLSv1.2-only.
    • Fixed support for large TLS keys or certificate bundles with up to 16KB each.
    • Fixed the Content-Length header for files larger than 2 GB on 32-bit architectures.
    • Fixed translation of CGI environment variables in accordance with RFCs 7230 and 3875.
    • Improved memory usage and fixed possible memory exhaustion on large file transfers.
    • Added URL-encoding of specific CGI variables before using them in the Location header.
    • Prepend files or directories containing ":" with "./" in directory indexes as per RFC 3986.
    • Allowing to specify characters like "?" in the Location URI.
    • Various other bug fixes and improvements.

• OpenSMTPD 5.4.4
  • smtpd(8) reliability and bug fixes.
  • NOTE: Some security risks were discovered and fixed after the OpenBSD 5.8 release. See 5.8 errata 004.

• OpenSSH 7.0
  • Security:
    • ssh(1): when forwarding X11 connections with ForwardX11Trusted=no, connections made after ForwardX11Timeout expired could be permitted and no longer subject to XSECURITY restrictions because of an ineffective timeout check in ssh(1) coupled with "fail open" behaviour in the X11 server when clients attempted connections with expired credentials. This problem was reported by Jann Horn.
    • ssh-agent(1): fix weakness of agent locking (ssh-add -x) to password guessing by implementing an increasing failure delay, storing a salted hash of the password rather than the password itself and using a timing-safe comparison function for verifying unlock attempts. This problem was reported by Ryan Castellucci.
    • sshd(8): OpenSSH 6.8 and 6.9 incorrectly set TTYs to be world-writable. Local attackers may be able to write arbitrary messages to logged-in users, including terminal escape sequences.
    • sshd(8): fix circumvention of MaxAuthTries using keyboard-interactive authentication. By specifying a long, repeating keyboard-interactive "devices" string, an attacker could request the same authentication method be tried thousands of times in a single pass. The LoginGraceTime timeout in sshd(8) and any authentication failure delays implemented by the authentication mechanism itself were still applied.
  • Potentially-incompatible changes:
    • Support for the legacy SSH version 1 protocol is disabled by default at compile time.
    • Support for the 1024-bit diffie-hellman-group1-sha1 key exchange is disabled by default at run-time. It may be re-enabled using the instructions at https://www.openssh.com/legacy.html.
    • Support for ssh-dss, ssh-dss-cert-* host and user keys is disabled by default at run-time. These may be re-enabled using the instructions at https://www.openssh.com/legacy.html.
    • Support for the legacy v00 cert format has been removed.
    • The default for the sshd_config(5) PermitRootLogin option has changed from "yes" to "prohibit-password" (but the OpenBSD installer defaults to "no").
    • NOTE: 'PermitRootLogin prohibit-password' is subtly broken in the OpenBSD 5.8 / OpenSSH 7.0. See 5.8 errata 001.
  • New/changed features:
    • ssh(1), sshd(8): promote [email protected] to be the default cipher.
    • sshd(8): support admin-specified arguments to AuthorizedKeysCommand. (bz#2081)
    • sshd(8): add AuthorizedPrincipalsCommand that allows retrieving authorized principals information from a subprocess rather than a file.
    • ssh(1), ssh-add(1): support PKCS#11 devices with external PIN entry devices. (bz#2240)
    • sshd(8): allow GSSAPI host credential check to be relaxed for multihomed hosts via GSSAPIStrictAcceptorCheck option. (bz#928)
    • ssh-keygen(1): support ssh-keygen -lF hostname to search known_hosts and print key hashes rather than full keys.
    • ssh-agent(1): add -D flag to leave ssh-agent(1) in foreground without enabling debug mode. (bz#2381)
    • ssh_config(5): add PubkeyAcceptedKeyTypes option to control which public key types are available for user authentication.
    • sshd_config(5): add HostKeyAlgorithms option to control which public key types are offered for host authentications.
    • ssh(1), sshd(8): extend Ciphers, MACs, KexAlgorithms, HostKeyAlgorithms, PubkeyAcceptedKeyTypes and HostbasedKeyTypes options to allow appending to the default set of algorithms instead of replacing it. Options may now be prefixed with a + to append to the default, e.g. "HostKeyAlgorithms=+ssh-dss".
  • The following significant bugs have been fixed in this release:
    • ssh(1), sshd(8): deprecate legacy SSH2_MSG_KEX_DH_GEX_REQUEST_OLD message and do not try to use it against some 3rd-party SSH implementations that use it (older PuTTY, WinSCP).
    • Many fixes for problems caused by compile-time deactivation of SSH1 support. (including bz#2369)
    • ssh(1), sshd(8): cap DH-GEX group size at 4Kbits for Cisco implementations as some would fail when attempting to use group sizes greater than 4K. (bz#2209)
    • ssh(1): fix out-of-bound read in EscapeChar configuration option parsing. (bz#2396)
    • sshd(8): fix application of PermitTunnel, LoginGraceTime, AuthenticationMethods and StreamLocalBindMask options in Match blocks.
    • ssh(1), sshd(8): improve disconnection message on TCP reset. (bz#2257)
    • ssh(1): remove failed remote forwards established by multiplexing from the list of active forwards. (bz#2363)
    • sshd(8): make parsing of authorized_keys "environment=" options independent of PermitUserEnv being enabled. (bz#2329)
    • sshd(8): fix post-auth crash with permitopen=none. (bz#2355)
    • ssh(1), ssh-add(1), ssh-keygen(1): allow new-format private keys to be encrypted with AEAD ciphers. (bz#2366)
    • ssh(1): allow ListenAddress, Port and AddressFamily configuration options to appear in any order. (bz#86)
    • sshd(8): check for and reject missing arguments for VersionAddendum and ForceCommand. (bz#2281)
    • ssh(1), sshd(8): don't treat unknown certificate extensions as fatal. (bz#2387)
    • ssh-keygen(1): make stdout and stderr output consistent. (bz#2325)
    • ssh(1): mention missing DISPLAY environment in debug log when X11 forwarding requested. (bz#1682)
    • sshd(8): correctly record login when UseLogin is set. (bz#378)
    • sshd(8): add some missing options to sshd -T output and fix output of VersionAddendum and HostCertificate. (bz#2346)
    • Document and improve consistency of options that accept a "none" argument: TrustedUserCAKeys, RevokedKeys (bz#2382), AuthorizedPrincipalsFile (bz#2288).
    • ssh(1): include remote username in debug output. (bz#2368)
    • sshd(8): avoid compatibility problem with some versions of Tera Term, which would crash when they received the hostkeys notification message ([email protected]).
    • sshd(8): mention ssh-keygen -E as useful when comparing legacy MD5 host key fingerprints. (bz#2332)
    • ssh(1): clarify pseudo-terminal request behaviour and use make manual language consistent. (bz#1716)
    • ssh(1): document that the TERM environment variable is not subject to SendEnv and AcceptEnv. (bz#2386)
    • ssh(1), sshd(8): add compatibility workarounds for Cisco and more PuTTY versions. (bz#2424)
    • Fix some omissions and errors in the PROTOCOL and PROTOCOL.mux documentation relating to Unix domain socket forwarding. (bz#2421, bz#2422)
    • ssh(1): Improve the ssh(1) manual page to include a better description of Unix domain socket forwarding. (bz#2423)
    • ssh(1), ssh-agent(1): skip uninitialised PKCS#11 slots, fixing failures to load keys when they are present. (bz#2427)
    • ssh(1), ssh-agent(1): do not ignore PKCS#11 hosted keys that wth empty CKA_ID. (bz#2429)
    • sshd(8): clarify documentation for UseDNS option. (bz#2045)

• LibreSSL
  • User-visible features:
    • Reject all server DH keys smaller than 1024 bits.
    • Multiple CVEs fixed including CVE-2015-0207, CVE-2015-0209, CVE-2015-0286, CVE-2015-0287, CVE-2015-0288, CVE-2015-0289, CVE-2015-1788, CVE-2015-1789, CVE-2015-1792.
    • Protocol parsing conversions to BoringSSL's CRYPTO ByteString (CBS) API.
    • Added EC_curve_nid2nist and EC_curve_nist2nid from OpenSSL.
    • Removed Dynamic Engine support.
    • Removed MDC-2DES support.
    • Switched openssl dhparam default from 512 to 2048 bits.
    • Fixed openssl pkeyutl -verify to exit with a 0 on success.
    • Fixed dozens of Coverity issues including dead code, memory leaks, logic errors and more.
    • Ensure that openssl(1) restores terminal echo state after reading a password.
    • Incorporated fix for OpenSSL issue #3683.
    • Removed SSLv3 support from openssl(1).
    • Modified tls_write in libtls to allow partial writes, clarified with examples in the documentation.
    • Removed RSAX engine.
    • Tested SSLv3 removal with the OpenBSD ports tree and found several applications that were not ready to build without SSLv3 yet. For now, building a program that intentionally uses SSLv3 will result in a linker warning.
    • Added TLS_method, TLS_client_method and TLS_server_method as a replacement for the SSLv23_*method calls.
    • Default cert.pem, openssl.cnf, and x509v3.cnf files are now installed under $sysconfdir/ssl or the directory specified by --with-openssldir. Previous versions of LibreSSL left these empty.
    • NOTE: LibreSSL 2.2.2 in OpenBSD 5.8 incorrectly handles ClientHello messages that do not include TLS extensions, resulting in such handshakes being aborted. See 5.8 errata 002.
    • NOTE: An issue (likely denial of service) was found in LibreSSL; See 5.8 errata 007.
  • Code improvements:
    • Fix incorrect comparison function in openssl(1) certhash command. Thanks to Christian Neukirchen / Void Linux.
    • Removal of OPENSSL_issetugid and all library getenv calls. Applications can and should no longer rely on environment variables for changing library behavior. OPENSSL_CONF and SSLEAY_CONF are still supported with the openssl(1) command, but note that $ENV:: is no longer supported in .cnf files.
    • libtls API and documentation additions.
    • Various bug fixes and simplifications to libssl and libcrypto.
    • Reworked openssl(1) option handling.
    • LibreSSL version define LIBRESSL_VERSION_NUMBER will now be bumped for each portable release.
    • Removed workarounds for TLS client padding bugs.
    • Removed IE 6 SSLv3 workarounds.
    • --with-enginesdir is removed as a configuration parameter.

• Syslogd:
  • OpenBSD syslogd(8) can bind to explicitly given UDP or TCP sockets to receive messages. TCP streams are accepted with the octet counting or the non transparent framing method.
  • Blocks in syslog.conf(5) started with +host process messages created by certain hosts specifically.
  • Handle situations when the file descriptor limit is exhausted gracefully.
  • Since libtls handles short writes smarter, syslogd(8) can use the complete output buffer to save messages, coping with longer TLS server down times without losing messages.

• Ports and packages:

  Many pre-built packages for each architecture:

  • alpha: 7093
  • amd64: 8866
  • hppa: 5813
  • i386: 8839
  • mips64: 4267
  • mips64el: 5922
  • powerpc: 8114
  • sh: 133
  • sparc64: 7851
  • sparc: 3655
  • vax: 1959

  Some highlights:

  • Chromium 44.0.2403.125
  • Emacs 21.4 and 24.5
  • GCC 4.8.4 and 4.9.3
  • GHC 7.8.4
  • GNOME 3.16.2
  • Go 1.4.2
  • Groff 1.22.3
  • JDK 1.7.0.80 and 1.8.0.45
  • KDE 3.5.10 and 4.14.3 (plus KDE4 core updates)
  • LLVM/Clang 3.5 (20140228)
  • LibreOffice 4.4.4.3
  • MariaDB 10.0.20
  • Mono 3.12.1
  • Mozilla Firefox 38.1.1esr and 39.0.3
  • Mozilla Thunderbird 38.1.0
  • Node.js 0.10.35
  • OpenLDAP 2.3.43 and 2.4.41
  • PHP 5.4.43, 5.5.27 and 5.6.11
  • Postfix 3.0.2
  • PostgreSQL 9.4.4
  • Python 2.7.10 and 3.4.3
  • R 3.2.1
  • Ruby 1.8.7.374, 1.9.3.551, 2.0.0.645, 2.1.6, and 2.2.2
  • Sendmail 8.15.2
  • Sudo 1.8.14.3
  • Tcl/Tk 8.5.18 and 8.6.4
  • TeX Live 2014
  • Vim 7.4.769
  • Xfce 4.12
• As usual, steady improvements in manual pages and other documentation.
• The system includes the following major components from outside suppliers:
  • Xenocara (based on X.Org 7.7 with xserver 1.16.4 + patches, freetype 2.6, fontconfig 2.11.1, Mesa 10.2.9, xterm 314, xkeyboard-config 2.14 and more)
  • Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
  • Perl 5.20.2 (+ patches)
  • SQLite 3.8.9 (+ patches)
  • NSD 4.1.3
  • Unbound 1.5.4
  • Ncurses 5.7
  • Binutils 2.17 (+ patches)
  • Gdb 6.3 (+ patches)
  • Less 458 (+ patches)
  • Awk Aug 10, 2011 version

How to install

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 HTTP (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.

• .../OpenBSD/5.8/alpha/INSTALL.alpha (on CD1)
• .../OpenBSD/5.8/i386/INSTALL.i386 (on CD1)
• .../OpenBSD/5.8/hppa/INSTALL.hppa (on CD1)

• .../OpenBSD/5.8/amd64/INSTALL.amd64 (on CD2)
• .../OpenBSD/5.8/macppc/INSTALL.macppc (on CD2)

• .../OpenBSD/5.8/sparc64/INSTALL.sparc64 (on CD3)
• .../OpenBSD/5.8/sparc/INSTALL.sparc (on CD3)

• .../OpenBSD/5.8/alpha/INSTALL.alpha
• .../OpenBSD/5.8/armish/INSTALL.armish
• .../OpenBSD/5.8/hppa/INSTALL.hppa
• .../OpenBSD/5.8/landisk/INSTALL.landisk
• .../OpenBSD/5.8/loongson/INSTALL.loongson
• .../OpenBSD/5.8/luna88k/INSTALL.luna88k
• .../OpenBSD/5.8/macppc/INSTALL.macppc
• .../OpenBSD/5.8/octeon/INSTALL.octeon
• .../OpenBSD/5.8/sgi/INSTALL.sgi
• .../OpenBSD/5.8/socppc/INSTALL.socppc
• .../OpenBSD/5.8/sparc/INSTALL.sparc
• .../OpenBSD/5.8/vax/INSTALL.vax
• .../OpenBSD/5.8/zaurus/INSTALL.zaurus

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!

OpenBSD/i386:

The OpenBSD/i386 release is on CD1. Boot from the CD to begin the install - you may need to adjust your BIOS options first.

If your machine can boot from USB, you can write install58.fs or miniroot58.fs to a USB stick and boot from it.

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

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

OpenBSD/amd64:

The OpenBSD/amd64 release is on CD2. Boot from the CD to begin the install - you may need to adjust your BIOS options first.

If your machine can boot from USB, you can write install58.fs or miniroot58.fs to a USB stick and boot from it.

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

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

OpenBSD/macppc:

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

Alternatively, at the Open Firmware prompt, enter boot cd:,ofwboot /5.8/macppc/bsd.rd

OpenBSD/sparc64:

Put CD3 in your CDROM drive and type boot cdrom.

If this doesn't work, or if you don't have a CDROM drive, you can write CD3:5.8/sparc64/floppy58.fs or CD3:5.8/sparc64/floppyB58.fs (depending on your machine) to a floppy and boot it with boot floppy. Refer to INSTALL.sparc64 for details.

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

You can also write CD3:5.8/sparc64/miniroot58.fs to the swap partition on the disk and boot with boot disk:b.

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

OpenBSD/alpha:

Write 5.8/alpha/floppy58.fs or 5.8/alpha/floppyB58.fs (depending on your machine) to a diskette and enter boot dva0. Refer to INSTALL.alpha for more details.

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

OpenBSD/armish:

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.

OpenBSD/hppa:

Boot over the network by following the instructions in INSTALL.hppa or the hppa platform page.

OpenBSD/landisk:

Write miniroot58.fs to the start of the CF or disk, and boot normally.

OpenBSD/loongson:

Write miniroot58.fs 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.

OpenBSD/luna88k:

Copy 'boot' and 'bsd.rd' to a Mach or UniOS partition, and boot the bootloader from the PROM, and then bsd.rd from the bootloader. Refer to the instructions in INSTALL.luna88k for more details.

OpenBSD/octeon:

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

OpenBSD/sgi:

To install, burn cd58.iso on a CD-R, put it in the CD drive of your machine and select Install System Software from the System Maintenance menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from CD-ROM, and need a proper invocation from the PROM prompt. Refer to the instructions in INSTALL.sgi for more details.

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.

OpenBSD/socppc:

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

OpenBSD/sparc:

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

ok boot cdrom 5.8/sparc/bsd.rd
or
> b sd(0,6,0)5.8/sparc/bsd.rd

If your SPARC system does not have a CD drive, you can alternatively boot from floppy. To do so you need to write floppy58.fs to a floppy. For more information see this page. To boot from the floppy use one of the two commands listed below, depending on the version of your ROM.

ok boot floppy
or
> b fd()

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

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.

OpenBSD/vax:

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

OpenBSD/zaurus:

Using the Linux built-in graphical ipkg installer, install the openbsd58_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus for a few important details.

How to upgrade

If you already have an OpenBSD 5.7 system, and do not want to reinstall, upgrade instructions and advice can be found in the Upgrade Guide.

Notes about the source code

src.tar.gz contains a source archive starting at /usr/src. This file contains everything you need except for the kernel sources, which are in a separate archive. To extract:

# mkdir -p /usr/src
# cd /usr/src
# tar xvfz /tmp/src.tar.gz

sys.tar.gz contains a source archive starting at /usr/src/sys. This file contains all the kernel sources you need to rebuild kernels. To extract:

# mkdir -p /usr/src/sys
# cd /usr/src
# tar xvfz /tmp/sys.tar.gz

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 here. 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.

Ports Tree

A ports tree archive is also provided. To extract:

# cd /usr
# tar xvfz /tmp/ports.tar.gz

Go read the ports 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.

The ports/ directory represents a CVS (see the manpage for cvs(1) if you aren't familiar with CVS) checkout of our ports. As with our complete source tree, our ports tree is available via AnonCVS. So, in order to keep up to date with the -stable branch, you must make the ports/ tree available on a read-write medium and update the tree with a command like:

# cd /usr/ports
# cvs -d [email protected]:/cvs update -Pd -rOPENBSD_5_8

[Of course, you must replace the server name here with a nearby anoncvs server.]

Note that most ports are available as packages on our mirrors. Updated ports for the 5.8 release will be made available if problems arise.

If you're interested in seeing a port added, would like to help out, or just would like to know more, the mailing list [email protected] is a good place to know.