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>