Note: The ports system makes it easy for you to compile applications
      for your OpenBSD system.  For pre-compiled versions of a number
      of popular applications see CD1:PACKAGES.

CD2:ports.tar.gz is a checkout of the OpenBSD ports tree. Read
http://www.openbsd.org/ports.html if you know nothing about ports at
this point.  This text is not a manual for how to use ports.  Rather,
it is a set of notes meant to kickstart the user with the OpenBSD ports
system.

Certainly, the OpenBSD ports system is not complete.  We believe the
ports that are provided here are stable, but it is most important to
realize that ports will continue to grow a great deal in functionality
in the future.

There are two components to the ports system.  The first component is
the Makefile, patches, and informational files used to automate the
generation of third-party software.  This is found under the ports/
directory.  The second component is the third-party distribution
files.  These files, typically compressed tar files, can be found on the
OpenBSD mirror sites and the official sites for the third party
software. The ports software knows how to ftp these files down.

The ports/ hierarchy, or at least individual ports from within the
hierarchy, must be extracted from the compressed tar archive on CD2,
CD2:ports.tar.gz. Caution: some ports require over 50 Megabytes of
disk space to build the application, so choose a location with plenty
of disk space.

To extract the ports tree to /usr/ports (where it is normally
located), mount CD2 on /mnt and issue the command:

	# cd /usr; tar xzf /mnt/ports.tar.gz

As we said, ports will continue to grow in the future.  The ports/
directory represents a CVS checkout of our ports (see the manpage for
cvs(1) if you aren't familiar with CVS).  So, in order to keep
current, you must update the tree with a command like:

	# cd [portsdir]/; cvs -d anoncvsserver.openbsd.org:/cvs update -PAd

[Of course, you must replace the local directory and server name here
with the location of your ports collection and a nearby anoncvs
server.]

Again, it's important to read the web page for specific and detailed
instructions.

We continue to add ports.  If you're interested in seeing a port
added, would like to help out, or just would like to know more, the
mailing list ports@openbsd.org is a good place to start.