Annotation of www/ports.html, Revision 1.10
1.5 tacho 1: <HTML>
1.9 joey 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: <META NAME="GENERATOR" CONTENT="Mozilla/4.03 [en] (Win95; I) [Netscape]">
10: <TITLE>OpenBSD ports mechanism</TITLE>
11: <LINK REV="made" HREF="mailto:www@openbsd.org">
12: </HEAD>
13: <BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#23238E">
14: <IMG SRC="http://www.openbsd.org/images/smalltitle.gif" ALT="[OpenBSD]" >
15: <H2>
16: OpenBSD ports mechanism</H2>
17:
18: <H3>
19: <B>History</B></H3>
20: OpenBSD is a fairly complete system of its own, but still there is a lot
21: of software that one might want see added. However there is the problem
1.10 ! deraadt 22: on where to draw the line on what to include and not in a small unix-like
! 23: operating system, as well as licensing and export restrictions problems.
! 24: Some things just can't be shipped with the system.
! 25: We wanted to find a way for users to easily get software we don't provide
! 26: and started to look around. We didn't have to look far as a sibling project,
! 27: <A HREF="http://www.freebsd.org/">FreeBSD</A>, had an excellent mechanism
! 28: for exactly this purpose called <A HREF="http://www.freebsd.org/ports/">"The
! 29: ports collection"</A>.
! 30: After thinking about it for a while we decided to try to use their
! 31: collection as is, but due to incompatibility problems between FreeBSD
! 32: and OpenBSD we decided to branch out and create our very own OpenBSD
1.9 joey 33: Ports Project using FreeBSD's as a starting point.
34: <BR>
35: <H3>
36: <B>Short description and setup</B></H3>
37: The ports idea is to have, for each piece of software, a Makefile that
38: describes where to fetch it, how to do the fetch, what it is depending
39: upon (if anything), how to alter the sources (if needed) and how to configure,
40: build and install it. Furthermore some patches will have to be kept in
41: the "port" as well as some administration files for the package registry
42: utilities. Normally this information is kept in an hierarchy under /usr/ports
1.10 ! deraadt 43: (however, this is configurable).
! 44: <p>
! 45: We recommend reading the <A HREF="http://www.freebsd.org/handbook/ports.html">ports
1.9 joey 46: chapter</A> in the <A HREF="http://www.freebsd.org/handbook/">FreeBSD handbook</A>
47: to get information on how to setup this hierarchy until OpenBSD can complete
1.10 ! deraadt 48: its own ports.helpfile
1.9 joey 49: <H3>
50: <B>Example</B></H3>
51: Let's say you managed to get a ports tree sitting under /usr/ports, then
52: you should be able to something like this:
1.10 ! deraadt 53: <PRE>
! 54: % cd /usr/ports/archivers/unzip
! 55: % make
! 56: % su
! 57: # make install
! 58: # exit
1.9 joey 59: </PRE>
60: Easy, huh?
61: <H3>
62: <B>Problems and contacts</B></H3>
63: Our <A HREF="mailto:joey@openbsd.org">ports coordinator</A> is currently
64: working on a ports statues page - what is done, what is being worked on
1.10 ! deraadt 65: right now, on what architecture, etc.
! 66: If you have trouble with ports contact either
! 67: <A HREF="mailto:joey@openbsd.org">Ejovi Nuwere</A> (preferably),
! 68: <A HREF="mailto:gene@openbsd.org">Gene Skonicki</A>, or
! 69: <A HREF="mailto:todd@openbsd.org">Todd Tyrone Fries</A>
! 70: and provide either patches or details for how to fix things or,
! 71: if you cannot do this, point us at the problematic port and tell
! 72: us what fails and we shall try to fix it.
1.9 joey 73: <BR>
74: <HR><A HREF="http://www.openbsd.org/index.html"><IMG SRC="http://www.openbsd.org/back.gif" ALT="OpenBSD" BORDER=0 ></A>
75: <A HREF="mailto:www@openbsd.org">www@openbsd.org</A>
76: <BR><FONT SIZE=-1>$OpenBSD: ports.html,v 1.8 1997/11/18 08:12:33 deraadt
77: Exp $</FONT>
78: </BODY>
1.5 tacho 79: </HTML>