www/37.html

661 lines
23 KiB
HTML

<!doctype html>
<html lang=en id=release>
<meta charset=utf-8>
<title>OpenBSD 3.7</title>
<meta name="description" content="OpenBSD 3.7">
<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/37.html">
<h2 id=OpenBSD>
<a href="index.html">
<i>Open</i><b>BSD</b></a>
3.7
</h2>
<table>
<tr>
<td>
<a href="images/Wizard.jpg">
<img width="255" height="343" src="images/Wizard.jpg" alt="Wizard"></a>
<td>
Released May 19, 2005<br>
Copyright 1997-2005, Theo de Raadt.<br>
<cite class=isbn>ISBN 0-9731791-5-5</cite>
<br>
3.7 Song: <a href="lyrics.html#37">"The Wizard of OS"</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/3.7/</code> directory on
one of the mirror sites.
<li>Have a look at <a href="errata37.html">The 3.7 Errata page</a> for a list
of bugs and workarounds.
<li>See a <a href="plus37.html">detailed log of changes</a> between the
3.6 and 3.7 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 3.7.
For a comprehensive list, see the <a href="plus37.html">changelog</a> leading
to 3.7.
<p>
<ul>
<li>New platforms:
<ul>
<li><a href="zaurus.html">OpenBSD/zaurus</a>.<br>
Expanding the arm porting effort by supporting the Sharp Zaurus SL-C3000,
bringing a secure ssh-capable machine to your pocket.
<li><a href="sgi.html">OpenBSD/sgi</a>.<br>
A 64-bit port supporting O2 machines with R5000, RM5200, RM7000, R10000
and R12000 CPUs.
</ul>
<p>
<li>Support for a number of much faster 64-bit machines (in 32-bit mode) in
the <a href="hppa.html">OpenBSD/hppa</a> port.
<p>
<li>Improved hardware support, including:
<ul>
<li>New <a href="https://man.openbsd.org/i386/ath.4">ath(4)</a>
driver for Atheros IEEE 802.11a/b/g wireless network adapters.
<li>New <a href="https://man.openbsd.org/i386/iwi.4">iwi(4)</a>
driver for Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network adapters.
<li>New <a href="https://man.openbsd.org/i386/ipw.4">ipw(4)</a>
driver for Intel PRO/Wireless 2100 IEEE 802.11b wireless network adapters.
<li>New <a href="https://man.openbsd.org/i386/atu.4">atu(4)</a>
driver for Atmel AT76C50x USB IEEE 802.11b wireless network adapters.
<li>New <a href="https://man.openbsd.org/i386/ral.4">ral(4)</a>
and <a href="https://man.openbsd.org/i386/ural.4">ural(4)</a> [USB]
drivers for Ralink Technology RT25x0 IEEE 802.11a/b/g wireless network adapters.
<li>New <a href="https://man.openbsd.org/i386/rtw.4">rtw(4)</a>
driver for Realtek 8180 IEEE 802.11b wireless network adapters.
<li>Added support to <a href="https://man.openbsd.org/i386/re.4">re(4)</a>
driver for Realtek 8169 CardBus Ethernet adapters.
<li>New <a href="https://man.openbsd.org/i386/udav.4">udav(4)</a>
driver for Davicom DM9601 USB Ethernet adapters.
<li>New <a href="https://man.openbsd.org/i386/vge.4">vge(4)</a>
driver for VIA Networking Technologies VT6122 PCI Gigabit Ethernet adapters.
<li>New <a href="https://man.openbsd.org/i386/piixpm.4">piixpm(4)</a>
driver for the Intel PIIX Power Management controller.
<li>New <a href="https://man.openbsd.org/i386/ubt.4">ubt(4)</a>
driver for USB Bluetooth adapters.
</ul>
<p>
<li>Many enhancements in the <a href="mac68k.html">OpenBSD/mac68k</a> port.
<ul>
<li>Switch to a bsd.rd-based install.
<li>Improved interrupt system.
<li>Create partitions with <a href="https://man.openbsd.org/mac68k/pdisk.8">pdisk(8)</a>.
<li>Add <a href="https://man.openbsd.org/mac68k/mc.4">mc(4)</a>
support and enhance
<a href="https://man.openbsd.org/mac68k/zsc.4">zsc(4)</a>
support.
</ul>
<p>
<li>New tools:
<ul>
<li><a href="https://man.openbsd.org/ospfd">ospfd(8)</a>,
implementing the <a href="https://www.rfc-editor.org/rfc/rfc2328.txt">OSPFv2</a>
routing protocol.
<li><a href="https://man.openbsd.org/i386/getcap.1">getcap(1)</a>,
providing easy access to the capability database.
</ul>
<p>
<li>New functionality:
<ul>
<li>Repaired mirroring mode in <a href="https://man.openbsd.org/i386/ccd.4">ccd(4)</a>.
<li>Privilege separation for <a href="https://man.openbsd.org/i386/ftpd.8">ftpd(8)</a>.
<li>Bash-style prompt expansion and POSIX hex and octal constants in
<a href="https://man.openbsd.org/i386/ksh.1">ksh(1)</a>.
<li>Improved TCP send performance.
<li>Reentrant
<a href="https://man.openbsd.org/i386/getprotobyname_r.3">getproto*_r(3)</a>
and
<a href="https://man.openbsd.org/i386/getservbyname_r.3">getserv*_r(3)</a>
functions.
<li>In-kernel <a href="https://man.openbsd.org/i386/pppoe.4">pppoe(4)</a>
support.
<li><a href="https://man.openbsd.org/i386/pim.4">pim(4)</a>
(Protocol Independent Multicast) support added.
</ul>
<p>
<li>New functionality for <a href="https://man.openbsd.org/ntpd.8">ntpd(8)</a>,
the Network Time Protocol Daemon:
<ul>
<li>ntpd can now set the time immediately on startup itself, eliminating
the need to run rdate -n beforehand.
<li>Use median instead of average when collapsing all the peers' offsets
into one, greatly improving resistance against falsetickers.
<li>Calculate rootdelay, stratum, and precision properly; include these in
replies sent out in server mode.
<li>Many logging improvements: ntpd is now almost completely silent in normal
operation (unless in debug mode, of course).
</ul>
<p>
<li>New functionality for <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>,
the Border Gateway Protocol Daemon:
<ul>
<li>Allow sessions to depend on a CARP interface's master/backup state,
reducing failover times in redundant setups.
<li>Lower latency for requests from other peers or bgpctl while under heavy
load, e.g. initial table transfer when a session comes up.
<li>Allow for the peer descriptions to be used in bgpctl commands where
previously only their IPs were allowed.
<li>Allow bgpd to not prepend its own AS number and to not modify the nexthop
on updates sent out.
<li>Show associated interfaces and their state on &quot;show nexthop&quot;,
to help pointing out why nexthops are invalid.
<li>Allow for relative metrics modification, i.e.
&quot;set localpref +20&quot;.
</ul>
<p>
<li>New functionality and improvements for <a href="https://man.openbsd.org/pf.4">pf(4)</a>, the packet filter:
<ul>
<li>Improved <a href="https://man.openbsd.org/carp.4">carp(4)</a>, new <i>carpdev</i> mode for IP-less interfaces.
<li>Support limiting TCP connections by establishment rate, automatically
adding flooding IP addresses to tables and flushing states
(<i>max-src-conn-rate</i>, <i>overload &lt;table&gt;</i>,
<i>flush global</i>).
<li>Improved functionality of tags (<i>tag</i> and <i>tagged</i> for
translation rules, tagging of all packets matching state entries).
<li>Improved diagnostics (error messages and additional counters from
<i>pfctl -si</i>).
<li>New keyword <i>set skip on</i> to skip filtering on arbitrary interfaces,
like loopback.
<li>Filtering on <a href="https://man.openbsd.org/route.8">route(8)</a> labels.
<li>Several bugfixes improving stability.
</ul>
<p>
<li>New functionality and improvements for <a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a>,
the Internet Security Association and Key Management Daemon:
<ul>
<li>Allow the Address, Network, or Netmask values of the &quot;IPsec-ID&quot;
to be specified with an interface name or the keyword &quot;default&quot;
(in which case the address is selected based on the default route).
<li>Improved NAT-T and DPD stability and interoperability.
</ul>
<p>
<li>New functionality and improvements for <a href="https://man.openbsd.org/spamd.8">spamd(8)</a>,
the Spamd Spam Deferral Daemon
<ul>
<li> Allow the addition of spamtrap addresses to the spamd database
using <a href="https://man.openbsd.org/spamdb.8">spamdb(8)</a>.
Spamd will automatically blacklist hosts that attempt to deliver mail to a
spamtrap address while greylisted.
</ul>
<p>
<li>New functionality and many improvements for the <a href="https://man.openbsd.org/pkg_add.1">package tools</a>:
<ul>
<li>Major overhaul of the package format, simplifying common tasks like user
creation.
<li>In-place updates of packages with pkg_add -r.
<li>Progress meters, which make installing big packages a more pleasant
experience.
<li>Reliable dependencies on shared libraries, including the base system.
<li>Many performance improvements.
</ul>
<p>
<li>Over 3000 ports, 2800 pre-built packages.
<p>
<li>Many improvements for security and reliability.
Cleaner source code for
<a href="https://man.openbsd.org/ksh.1">ksh(1)</a>,
<a href="https://man.openbsd.org/httpd.8">httpd(8)</a>, and many more programs.
<p>
<li>As usual, many improvements in manual pages and other documentation.
<p>
<li>OpenSSH 4.1:
<ul>
<li>Local, remote and dynamic port forwards may be configured to listen on
specific IP addresses.
<li><a href="https://man.openbsd.org/sshd_config.5">
sshd_config(5)</a> now understands
"GatewayPorts clientspecified" to allow client-specified
listen addresses in remote port forwards. The existing
behaviour for "yes" and "no" is maintained.
<li>known_hosts files may be hashed to provide privacy if they are later
disclosed.
<li><a href="https://man.openbsd.org/ssh-keygen.1">
ssh-keygen(1)</a> has additional modes to generate and manage hashed
known_hosts files.
<li>Users will be warned of impending password and account expiry.
<li>Corrupt keys in authorized_keys are now handled gracefully.
<li><a href="https://man.openbsd.org/sftp.1">
sftp(1)</a> has speed improvements for "ls" and now uses
libedit for command line editing and history.
<li><a href="https://man.openbsd.org/sshd.8">
sshd(8)</a> will now log the source of connections denied by AllowUsers,
DenyUsers, AllowGroups and DenyGroups.
<li>AddressFamily option in
<a href="https://man.openbsd.org/sshd_config.5">
sshd_config(5)</a> now has an AddressFamily option to provide global
control of IPv4 and IPv6 usage by
<a href="https://man.openbsd.org/sshd.8">
sshd(8)</a>.
<li><a href="https://man.openbsd.org/ssh.1">
ssh(1)</a>'s multiplex (ControlMaster) mode has been improved and now
provides additional capabilities such as checking if the master is alive,
obtaining its process ID and requesting that it shut down.
</ul>
<p>
<li><a href="i386.html">OpenBSD/i386</a> and
<a href="macppc.html">OpenBSD/macppc</a> now use
<a href="https://man.openbsd.org/gcc-local.1">gcc 3.3.5</a>.
<p>
<li><a href="amd64.html">OpenBSD/amd64</a>,
<a href="cats.html">OpenBSD/cats</a>,
<a href="macppc.html">OpenBSD/macppc</a>,
<a href="hppa.html">OpenBSD/hppa</a>,
<a href="sgi.html">OpenBSD/sgi</a>,
<a href="sparc64.html">OpenBSD/sparc64</a> and
<a href="zaurus.html">OpenBSD/zaurus</a> now use
DWARF2 (C++) exception handling.
<p>
<li>The system includes the following major components from outside suppliers:
<ul>
<li>X.Org 6.8.2 (+ patches, and i386 contains XFree86 3.3.6 servers
(+ patches) for legacy chipsets not supported by X.Org)
<li>Gcc 2.95.3
(+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
and 3.3.5
(+ <a href="https://man.openbsd.org/gcc-local.1">patches</a>)
<li>Perl 5.8.6 (+ patches)
<li>Apache 1.3.29, mod_ssl 2.8.16, DSO support (+ patches)
<li>OpenSSL 0.9.7d (+ patches)
<li>Groff 1.15
<li>Sendmail 8.13.3, with libmilter
<li>Bind 9.3.0 (+ patches)
<li>Lynx 2.8.5rel.2 with HTTPS and IPv6 support (+ patches)
<li>Sudo 1.6.8p6
<li>Ncurses 5.2
<li>Latest KAME IPv6
<li>Heimdal 0.6rc1 (+ patches)
<li>Arla 0.35.7
<li>Binutils 2.15
<li>Gdb 6.3
</ul>
<p>
</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 3.7 on your machine:
<p>
<ul>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/i386/INSTALL.i386">
.../OpenBSD/3.7/i386/INSTALL.i386 (on CD1)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/vax/INSTALL.vax">
.../OpenBSD/3.7/vax/INSTALL.vax (on CD1)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/amd64/INSTALL.amd64">
.../OpenBSD/3.7/amd64/INSTALL.amd64 (on CD2)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/macppc/INSTALL.macppc">
.../OpenBSD/3.7/macppc/INSTALL.macppc (on CD2)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/sparc/INSTALL.sparc">
.../OpenBSD/3.7/sparc/INSTALL.sparc (on CD3)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/sparc64/INSTALL.sparc64">
.../OpenBSD/3.7/sparc64/INSTALL.sparc64 (on CD3)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/alpha/INSTALL.alpha">
.../OpenBSD/3.7/alpha/INSTALL.alpha</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/cats/INSTALL.cats">
.../OpenBSD/3.7/cats/INSTALL.cats</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/hp300/INSTALL.hp300">
.../OpenBSD/3.7/hp300/INSTALL.hp300</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/hppa/INSTALL.hppa">
.../OpenBSD/3.7/hppa/INSTALL.hppa</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/luna88k/INSTALL.luna88k">
.../OpenBSD/3.7/luna88k/INSTALL.luna88k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/mac68k/INSTALL.mac68k">
.../OpenBSD/3.7/mac68k/INSTALL.mac68k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/mvme68k/INSTALL.mvme68k">
.../OpenBSD/3.7/mvme68k/INSTALL.mvme68k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/mvme88k/INSTALL.mvme88k">
.../OpenBSD/3.7/mvme88k/INSTALL.mvme88k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/sgi/INSTALL.sgi">
.../OpenBSD/3.7/sgi/INSTALL.sgi</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.7/zaurus/INSTALL.zaurus">
.../OpenBSD/3.7/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:3.7/i386/floppy37.fs</i> to a floppy and boot via the floppy drive.
<p>
Use <i>CD1:3.7/i386/floppyB37.fs</i> instead for greater SCSI controller
support, or <i>CD1:3.7/i386/floppyC37.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:3.7/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/vax:</h3>
<p>
Boot over the network via mopbooting as described in INSTALL.vax.
<h3>OpenBSD/amd64:</h3>
<p>
The 3.7 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:3.7/amd64/floppy37.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>
Put CD2 in your CDROM drive and poweron 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
/3.7/macppc/bsd.rd</i>
<h3>OpenBSD/sparc:</h3>
<p>
The 3.7 release of OpenBSD/sparc is located on CD3. To boot off of this CD you
can use one of the two commands listed below, depending on the version of your
ROM.
<blockquote><pre>
ok <kbd>boot cdrom 3.7/sparc/bsd.rd</kbd>
or
> <kbd>b sd(0,6,0)3.7/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>CD3:3.7/sparc/floppy37.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>boot 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/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:3.7/sparc64/floppy37.fs</i> to a floppy and boot it with <i>boot
floppy</i>.<br>
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:3.7/sparc64/miniroot37.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>3.7/alpha/floppy37.fs</i> or
<i>3.7/alpha/floppyB37.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/cats:</h3>
<p>
After updating the firmware to at least ABLE 1.95 if necessary, boot
<i>3.7/cats/bsd.rd</i> from an ABLE-supported device (such as a CD-ROM
or an existing FFS or EXT2FS partition).
<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/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/mac68k:</h3>
<p>
Boot MacOS as normal and extract the Macside "BSD/Mac68k Booter" utility from
<i>3.7/mac68k/utils</i> onto your hard disk. Configure the "BSD/Mac68k
Booter" with the location of your bsd.rd kernel and boot into the installer.
Refer to the instructions in INSTALL.mac68k 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/sgi:</h3>
<p>
Setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd".
Refer to the instructions in INSTALL.sgi for more details.
<h3>OpenBSD/zaurus:</h3>
<p>
Using the Linux built-in graphical ipkg installer, install the
openbsd37_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 3.6 system, and do not want to reinstall,
upgrade instructions and advice can be found in the
<a href="faq/upgrade37.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/faq15.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 anoncvs. 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 [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_7</kbd>
</pre></blockquote>
<p>
[Of course, you must replace the local directory and server name here
with the location of your ports collection and a nearby anoncvs
server.]
<p>
Note that most ports are available as packages on our mirrors. Updated
packages for the 3.7 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>