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

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>