This is an archive of past FreeBSD releases; it's part of the FreeBSD Documentation Archive.

Quick Porting

FreeBSD Porter's Handbook
Prev		Next

Chapter 2. Quick Porting

Table of Contents
2.1. Writing the Makefile
2.2. Writing the description files
2.3. Creating the checksum file
2.4. Testing the port
2.5. Checking your port with portlint
2.6. Submitting the port

This section tells you how to do a quick port. In many cases, it is not enough, but we will see.

First, get the original tarball and put it into DISTDIR, which defaults to /usr/ports/distfiles.

Note: The following assumes that the software compiled out-of-the-box, i.e., there was absolutely no change required for the port to work on your FreeBSD box. If you needed to change something, you will have to refer to the next section too.

2.1. Writing the `Makefile`

The minimal Makefile would look something like this:

    # New ports collection makefile for:   oneko
    # Date created:        5 December 1994
    # Whom:                asami
    #
    # $FreeBSD$
    #
    
    PORTNAME=      oneko
    PORTVERSION=   1.1b
    CATEGORIES=    games
    MASTER_SITES=  ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/
    
    MAINTAINER=    asami@FreeBSD.org
    
    MAN1=          oneko.1
    MANCOMPRESSED= yes
    USE_IMAKE=     yes
    
    .include <bsd.port.mk>

See if you can figure it out. Do not worry about the contents of the $FreeBSD$ line, it will be filled in automatically by CVS when the port is imported to our main ports tree. You can find a more detailed example in the sample Makefile section.

Prev	Home	Next
Making a port yourself		Writing the description files

For questions about the FreeBSD ports system, e-mail <ports@freebsd.org>.
For questions about this documentation, e-mail <doc@freebsd.org>.