Annotation of www/ports.html, Revision 1.23
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">
1.21 pauls 19: <img height=30 width=141 src=images/smalltitle.gif alt="[OpenBSD]" >
1.19 marc 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
1.23 ! espie 26: licensing and export restriction problems. As OpenBSD is supposed to be
! 27: a small stand-alone UNIX-like operating system, some things just can't be
1.19 marc 28: shipped with the system.
29: <p>
30: We wanted to find a way for users to easily get software we don't provide
1.23 ! espie 31: and started to look around. We didn't have to look far, as sibling project
! 32: <a href="http://www.freebsd.org/">FreeBSD</a> already had an
! 33: excellent mechanism
1.19 marc 34: for exactly this purpose called
35: <a href="http://www.freebsd.org/ports/">"The ports collection"</a>.
36: <p>
37: At first we tried to use their collection as-is, but due to
38: incompatibility problems between FreeBSD and OpenBSD we decided to branch
39: out and create our very own OpenBSD Ports Project using FreeBSD's as a
40: starting point. This also allows us to tune the ports better to our
41: system.
42: <h3><font color=#0000e0>Short description and setup</font></h3>
43: <p>
44: The ports idea is to have, for each piece of software, a Makefile that
45: controls
46: <ul>
47: <li>where to fetch it,
48: <li>how to do the fetch,
49: <li>what it depends upon (if anything),
50: <li>how to alter the sources (if needed),
51: <li>and how to configure, build and install it.
52: </ul>
53: <p>
54: This information is kept in a directory hierarchy under the
55: /usr/ports directory.
56: <h3><font color=#0000e0>Getting the Ports tree</font></h3>
57: <p>
58: The ports source tree can be retrieved via:
59: <ul>
60: <li><a href=anoncvs.html>Anonymous CVS</a> (see link). The command is
61: essentially <strong>cvs get ports</strong>.
62: <li>Anonymous ftp from
63: <a href="ftp://ftp.openbsd.org/pub/OpenBSD/snapshots/ports.tar.gz">
64: ftp://ftp.openbsd.org/pub/OpenBSD/snapshots/ports.tar.gz</a>.
65: This archive is updated nightly.
1.20 marc 66: <li>Your web browser using the
67: <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/">CVS
68: web interface</a>.
1.19 marc 69: </ul>
70: <p>
1.22 marc 71: You can also ftp the 2.3 version from the pub/OpenBSD/2.3 directory
1.19 marc 72: on any of the <a href=ftp.html>ftp mirror sites</a>.
1.22 marc 73: Note: this version, also on the 2.3 CDROM, is not the most
1.23 ! espie 74: recent version. You likely will want to get and use a newer version
1.19 marc 75: <h3><font color=#0000e0>Example use of the Ports tree</font></h3>
76: <p>
77: Let's say you managed to get a ports tree and you want to compile and
78: install the archiving utility <code>unzip</code>. You should be able to
1.23 ! espie 79: do something like this:
1.11 deraadt 80: <pre>
1.10 deraadt 81: % cd /usr/ports/archivers/unzip
82: % su
1.17 joey 83: # make
1.10 deraadt 84: # make install
85: # exit
1.11 deraadt 86: </pre>
1.19 marc 87: Easy, huh?
1.20 marc 88: <h3><font color=#0000e0>Port status information</font></h3>
89: <p>
90: The <a href="portstat.html">ports status page</a> is updated as
91: team members add new ports and verify existing ports. Existing
92: ports are continually verified to validate source availability and
93: proper operation with the current OpenBSD sources. The page notes
94: the date last checked and the nature of any change. This is a new
95: resource that is not yet complete. If you have any information to
96: add to the status page please send it to
97: <a href="mailto:ports@openbsd.org">ports@OpenBSD.ORG</a>.
1.19 marc 98: <h3><font color=#0000e0>Creating new ports</font></h3>
99: <p>
100: If you are interested in helping to expand the OpenBSD ports tree
101: you should first read <a href="porting.html">porting.html</a>.
102: That page references the porting section of the
103: <a href="http://www.freebsd.org/handbook/">FreeBSD handbook</a>
104: as well as OpenBSD specific policies and hints.
105: <h3><font color=#0000e0>Problems and contacts</font></h3>
106: <p>
1.23 ! espie 107: If you have trouble with ports please send e-mail to the OpenBSD
1.19 marc 108: ports mailing list, <a href="mailto:ports@openbsd.org">ports@OpenBSD.ORG</a>.
1.23 ! espie 109: Corrections are always welcome, but in any case do please provide:
1.19 marc 110: <ul>
1.23 ! espie 111: <li>The output of <code>uname -a</code>,
! 112: <li>Your OpenBSD version, including any patches you may have applied,
1.19 marc 113: <li>A complete description of the problem.
114: </ul>
115: <hr>
1.21 pauls 116: <a href="index.html"><img height=24 width=24 src=back.gif border=0 alt=OpenBSD></a>
1.19 marc 117: <a href=mailto:www@openbsd.org>www@openbsd.org</a>
1.23 ! espie 118: <br><small>$OpenBSD: ports.html,v 1.22 1998/07/04 22:02:41 marc Exp $</small>
1.19 marc 119: </body>
1.11 deraadt 120: </html>