Annotation of www/ports.html, Revision 1.17
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: % su
1.17 ! joey 67: # make
1.10 deraadt 68: # make install
69: # exit
1.11 deraadt 70: </pre>
1.9 joey 71: Easy, huh?
1.15 angelos 72:
73: <h3>Getting ports easily</h3>
74: An easy way of getting the ports (at least for now) is by ftp, in
75: <a href="ftp://ftp.openbsd.org/pub/OpenBSD/snapshots/ports.tar.gz">pub/OpenBSD/snapshots/ports.tar.gz</a>. It is updated every night.
76:
1.14 deraadt 77: <h3>Problems and contacts</h3>
1.11 deraadt 78: Our <a href="mailto:joey@openbsd.org">ports coordinator</a> is currently
1.16 joey 79: working on a ports <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/">status page.</a>
1.11 deraadt 80: <p>
81: If you have trouble with ports contact
82: <a href="mailto:joey@openbsd.org">Ejovi Nuwere</a> (preferably),
83: <a href="mailto:gene@openbsd.org">Gene Skonicki</a>, or
84: <a href="mailto:todd@openbsd.org">Todd Tyrone Fries</a>.
85: <p>
86: Please provide either patches or enough details for repair, if you
87: cannot do this, point us at the problematic port and tell us what
88: fails and we shall try to fix it.
89:
90: <hr>
91: <a href="index.html"><img src=back.gif border=0 alt=OpenBSD></a>
92: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
1.17 ! joey 93: <br><small>$OpenBSD: ports.html,v 1.16 1997/12/09 05:37:01 joey Exp $</small>
1.11 deraadt 94:
95: </body>
96: </html>