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

Annotation of www/ports.html, Revision 1.14

1.11      deraadt     1: <html>
                      2: <head>
                      3: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
                      4: <meta name="resource-type" content="document">
                      5: <meta name="description" CONTENT="How OpenBSD can make use of the FreeBSD ports">
                      6: <meta name="keywords" content="openbsd,ports">
                      7: <meta name="distribution" content="global">
                      8: <meta name="copyright" content="This document copyright 1997 by the OpenBSD project">
                      9: <title>OpenBSD ports mechanism</title>
                     10: <link rev="made" HREF="mailto:www@openbsd.org">
                     11: </head>
                     12: <body text="#000000" bgcolor="#FFFFFF" link="#23238E">
1.12      deraadt    13: <img src=images/smalltitle.gif alt="[OpenBSD]" >
1.9       joey       14:
1.11      deraadt    15: <h2>OpenBSD ports mechanism</H2>
                     16:
1.14    ! deraadt    17: <h3>History</h3>
1.9       joey       18: OpenBSD is a fairly complete system of its own, but still there is a lot
                     19: of software that one might want see added. However there is the problem
1.11      deraadt    20: on where to draw the line as to what to include, as well as the occasional
                     21: licensing and export restriction problems.
                     22: In what is supposed to be small stand-alone unix-like operating system,
                     23: some things just can't be shipped with the system.
1.10      deraadt    24: We wanted to find a way for users to easily get software we don't provide
                     25: and started to look around. We didn't have to look far as a sibling project,
1.11      deraadt    26: <a href="http://www.freebsd.org/">FreeBSD</a>, had an excellent mechanism
                     27: for exactly this purpose called
                     28: <a href="http://www.freebsd.org/ports/">"The ports collection"</a>.
                     29: At first we tried to use their collection as-is, but due to incompatibility
                     30: problems between FreeBSD and OpenBSD we decided to branch out and create
                     31: our very own OpenBSD Ports Project using FreeBSD's as a starting point.
                     32: This also allows us to tune the ports better to our system.
1.14    ! deraadt    33: <h3>Short description and setup</h3>
1.9       joey       34: The ports idea is to have, for each piece of software, a Makefile that
1.11      deraadt    35: <ul>
                     36: <li>Describes where to fetch it,
                     37: <li>How to do the fetch,
                     38: <li>What it is depending upon (if anything),
                     39: <li>how to alter the sources (if needed),
                     40: <li>and how to configure, build and install it.
                     41: </ul>
                     42: <p>
                     43: Normally this information is kept in an hierarchy under /usr/ports
1.10      deraadt    44: (however, this is configurable).
                     45: <p>
1.11      deraadt    46: We recommend reading the <a href="http://www.freebsd.org/handbook/ports.html">ports
                     47: chapter</a> in the <a href="http://www.freebsd.org/handbook/">FreeBSD handbook</a>
1.9       joey       48: to get information on how to setup this hierarchy until OpenBSD can complete
1.10      deraadt    49: its own ports.helpfile
1.14    ! deraadt    50: <h3>Getting the Ports tree</h3>
        !            51: The ports source tree is available in several ways:
        !            52: <ul>
        !            53: <li>You can ftp the 2.2 version of it from the pub/OpenBSD/2.2 directory
        !            54:        on any of the <a href=ftp.html>ftp mirror sites</a>.
        !            55: <li>You can use <a href=anoncvs.html>AnonCVS</a> to get the most recent
        !            56:        version of it, using essentially "<strong>cvs get ports</strong>".
        !            57: </ul>
        !            58: (Note: the version of the ports tree on the 2.2 CDROM is not the most
        !            59: recent version.  You likely want to get and use a newer version).
        !            60:
        !            61: <h3>Example use of the Ports tree</h3>
1.9       joey       62: Let's say you managed to get a ports tree sitting under /usr/ports, then
                     63: you should be able to something like this:
1.11      deraadt    64: <pre>
1.10      deraadt    65: % cd /usr/ports/archivers/unzip
                     66: % make
                     67: % su
                     68: # make install
                     69: # exit
1.11      deraadt    70: </pre>
1.9       joey       71: Easy, huh?
1.14    ! deraadt    72: <h3>Problems and contacts</h3>
1.11      deraadt    73: Our <a href="mailto:joey@openbsd.org">ports coordinator</a> is currently
                     74: working on a ports status page.
                     75: <p>
                     76: If you have trouble with ports contact
                     77: <a href="mailto:joey@openbsd.org">Ejovi Nuwere</a> (preferably),
                     78: <a href="mailto:gene@openbsd.org">Gene Skonicki</a>, or
                     79: <a href="mailto:todd@openbsd.org">Todd Tyrone Fries</a>.
                     80: <p>
                     81: Please provide either patches or enough details for repair, if you
                     82: cannot do this, point us at the problematic port and tell us what
                     83: fails and we shall try to fix it.
                     84:
                     85: <hr>
                     86: <a href="index.html"><img src=back.gif border=0 alt=OpenBSD></a>
                     87: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
1.14    ! deraadt    88: <br><small>$OpenBSD: ports.html,v 1.13 1997/11/30 14:31:46 deraadt Exp $</small>
1.11      deraadt    89:
                     90: </body>
                     91: </html>