Annotation of www/ports.html, Revision 1.19
1.11 deraadt 1: <html>
1.19 ! marc 2: <head>
! 3: <meta http-equiv="Content-Type"
! 4: content="text/html; charset=iso-8859-1">
! 5: <meta name="resource-type"
! 6: content="document">
! 7: <meta name="description"
! 8: CONTENT="How OpenBSD can make use of the FreeBSD ports">
! 9: <meta name="keywords"
! 10: content="openbsd,ports">
! 11: <meta name="distribution"
! 12: content="global">
! 13: <meta name="copyright"
! 14: content="This document copyright 1997,1998 by the OpenBSD project">
! 15: <title>OpenBSD ports mechanism</title>
! 16: <link rev="made" HREF="mailto:www@openbsd.org">
! 17: </head>
! 18: <body text="#000000" bgcolor="#FFFFFF" link="#23238E">
! 19: <img src=images/smalltitle.gif alt="[OpenBSD]" >
! 20: <h2><font color=#e00000>OpenBSD ports mechanism</font></H2>
! 21: <h3><font color=#0000e0>History</font></h3>
! 22: <p>
! 23: OpenBSD is a fairly complete system of its own, but still there is a lot
! 24: of software that one might want see added. However there is the problem
! 25: on where to draw the line as to what to include, as well as the occasional
! 26: licensing and export restriction problems. In what is supposed to be
! 27: small stand-alone UNIX-like operating system, some things just can't be
! 28: shipped with the system.
! 29: <p>
! 30: We wanted to find a way for users to easily get software we don't provide
! 31: and started to look around. We didn't have to look far as a sibling project,
! 32: <a href="http://www.freebsd.org/">FreeBSD</a>, had an excellent mechanism
! 33: for exactly this purpose called
! 34: <a href="http://www.freebsd.org/ports/">"The ports collection"</a>.
! 35: <p>
! 36: At first we tried to use their collection as-is, but due to
! 37: incompatibility problems between FreeBSD and OpenBSD we decided to branch
! 38: out and create our very own OpenBSD Ports Project using FreeBSD's as a
! 39: starting point. This also allows us to tune the ports better to our
! 40: system.
! 41: <h3><font color=#0000e0>Short description and setup</font></h3>
! 42: <p>
! 43: The ports idea is to have, for each piece of software, a Makefile that
! 44: controls
! 45: <ul>
! 46: <li>where to fetch it,
! 47: <li>how to do the fetch,
! 48: <li>what it depends upon (if anything),
! 49: <li>how to alter the sources (if needed),
! 50: <li>and how to configure, build and install it.
! 51: </ul>
! 52: <p>
! 53: This information is kept in a directory hierarchy under the
! 54: /usr/ports directory.
! 55: <h3><font color=#0000e0>Getting the Ports tree</font></h3>
! 56: <p>
! 57: The ports source tree can be retrieved via:
! 58: <ul>
! 59: <li><a href=anoncvs.html>Anonymous CVS</a> (see link). The command is
! 60: essentially <strong>cvs get ports</strong>.
! 61: <li>Anonymous ftp from
! 62: <a href="ftp://ftp.openbsd.org/pub/OpenBSD/snapshots/ports.tar.gz">
! 63: ftp://ftp.openbsd.org/pub/OpenBSD/snapshots/ports.tar.gz</a>.
! 64: This archive is updated nightly.
! 65: </ul>
! 66: <p>
! 67: You can also ftp the 2.2 version from the pub/OpenBSD/2.2 directory
! 68: on any of the <a href=ftp.html>ftp mirror sites</a>.
! 69: Note: this version, also on the 2.2 CDROM, is not the most
! 70: recent version. You likely want to get and use a newer version.
! 71: <h3><font color=#0000e0>Example use of the Ports tree</font></h3>
! 72: <p>
! 73: Let's say you managed to get a ports tree and you want to compile and
! 74: install the archiving utility <code>unzip</code>. You should be able to
! 75: something like:
1.11 deraadt 76: <pre>
1.10 deraadt 77: % cd /usr/ports/archivers/unzip
78: % su
1.17 joey 79: # make
1.10 deraadt 80: # make install
81: # exit
1.11 deraadt 82: </pre>
1.19 ! marc 83: Easy, huh?
! 84: <h3><font color=#0000e0>Creating new ports</font></h3>
! 85: <p>
! 86: If you are interested in helping to expand the OpenBSD ports tree
! 87: you should first read <a href="porting.html">porting.html</a>.
! 88: That page references the porting section of the
! 89: <a href="http://www.freebsd.org/handbook/">FreeBSD handbook</a>
! 90: as well as OpenBSD specific policies and hints.
! 91: <h3><font color=#0000e0>Problems and contacts</font></h3>
! 92: <p>
! 93: Our <a href="mailto:joey@openbsd.org">ports coordinator</a> is currently
! 94: working on a port
! 95: <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/">status page.</a>
! 96: <p>
! 97: If you have trouble with ports please send mail to the OpenBSD
! 98: ports mailing list, <a href="mailto:ports@openbsd.org">ports@OpenBSD.ORG</a>.
! 99: Patches are always appreciated, but in any case please provide:
! 100: <ul>
! 101: <li>The output of <code>uname -a</code>
! 102: <li>Your OpenBSD version, including any patches you may have applied.
! 103: <li>A complete description of the problem.
! 104: </ul>
! 105: <hr>
! 106: <a href="index.html"><img src=back.gif border=0 alt=OpenBSD></a>
! 107: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
! 108: <br><small>$OpenBSD: ports.html,v 1.17 1998/01/25 05:44:48 joey Exp $</small>
! 109: </body>
1.11 deraadt 110: </html>