[BACK]Return to porting.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/porting.html, Revision 1.1

1.1     ! marc        1: <html>
        !             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 to make an OpenBSD port">
        !             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 by the OpenBSD project">
        !            15:   <title>Building an OpenBSD port</title>
        !            16:   <link rev="made" HREF="mailto:www@openbsd.org">
        !            17:  </head>
        !            18:  <body text="#000000" bgcolor="#FFFFFF" link="#23238E">
        !            19:   <img src=images/smalltitle.gif alt="[OpenBSD]" >
        !            20:
        !            21:   <h2><font color=#0000e0>Building an OpenBSD port</font></h2>
        !            22:
        !            23:    So you've just compiled your favorite software package on your
        !            24:    OpenBSD machine and you want to share your effort by turning
        !            25:    it into a standard port.  What to do?
        !            26:   <p>
        !            27:    This page will, when completed, provide the necessary guidance.
        !            28:    Until then, however, please look at the available porting information,
        !            29:    the OpenBSD porting policy, and the other helpful hints provided
        !            30:    on this page.
        !            31:   <p>
        !            32:    If you are not capable of doing all the steps in a port, please do as
        !            33:    much as you can before submitting it.  When you do submit the port,
        !            34:    make sure you point out which parts you didn't do.
        !            35:   <p>
        !            36:   <h3><font color=#0000e0>Available Porting Information</font></h3>
        !            37:   <ul>
        !            38:    <li>The file <code>/usr/share/mk/bsd.port.mk</code>.  This is the
        !            39:        system ports makefile included at the end of each individual
        !            40:        port makefile.  Read the comments at the start of the makefile.
        !            41:        They do a good job of describing the available make options.
        !            42:    <li>The
        !            43:        <a href="http://www.netbsd.org/Documentation/netbsd/Packages.txt">NetBSD
        !            44:        Package System</a> documentation.  This document describes NetBSD's
        !            45:        version of the FreeBSD ports system and is quite helpful.
        !            46:    <li>ChapterSection 17.2.5 of the
        !            47:        <a href="http://www.freebsd.org/handbook/porting.html">FreeBSD
        !            48:        Handbook</a>.  This is the FreeBSD porting bible.
        !            49:    <li>The OpenBSD ports mailing list,
        !            50:        <a href="mailto:ports@openbsd.org">ports@OpenBSD.ORG</a>.
        !            51:   </ul>
        !            52:   <h3><font color=#0000e0>OpenBSD Porting Policy</font></h3>
        !            53:   <ul>
        !            54:    <li>OpenBSD does NOT use /usr/local/etc/rc.d.<br>
        !            55:        <code>/usr/local</code> is often NFS mounted; shared between
        !            56:        machines in a cluster.  For this reason per machine configuration
        !            57:        files are places in <code>/etc</code>.
        !            58:    <li>OpenBSD does NOT compress man pages.
        !            59:    <li>OpenBSD does NOT require <code>-lcrypt</code>.<br>
        !            60:        DES encryption is part of the standard <code>libc</code>.
        !            61:    <li>OpenBSD requests all <code>mktemp</code> warnings to be fixed.
        !            62:        This is not as simple as <code>s/mktemp/mkstemp/g</code>.  If
        !            63:        you are not absulutly sure of what you are doing please request
        !            64:        help from the <a href="mailto:ports@openbsd.org">ports</a> mailing
        !            65:        list.
        !            66:    <li>Any software to be installed as a server should be scanned
        !            67:        for buffer overflows, especially unsafe use of
        !            68:        <code>strcat/strcpy/strcmp/sprintf</code>.  In general,
        !            69:        <code>sprintf</code> should be replaced with <code>snprintf</code>.
        !            70:   </ul>
        !            71:   <h3><font color=#0000e0>Other Helpful Hints</font></h3>
        !            72:   <ul>
        !            73:    <li>Do not assume <code>/usr/local/bin</code> or
        !            74:        <code>/usr/X11R6/bin</code> is in the installers path.  A good
        !            75:        way to verify this is to create and install your port while
        !            76:        running as <code>root</code> with only <code>/bin</code> and
        !            77:        <code>/usr/bin</code> in your path.
        !            78:    <li>Do NOT generate shared libraries for <code>${MACHINE_ARCH} ==
        !            79:        alpha</code>
        !            80:    <li>In OpenBSD <code>curses.h/libcurses/libtermlib</code> are the
        !            81:        ``new curses''.  Change:<br>
        !            82:        <code>ncurses.h ==> curses.h</code><br>
        !            83:        <code>-lncurses ==> -lcurses</code><br>
        !            84:        ``Old curses'' is available as <code>ocurses.h/libocurses</code>.
        !            85:   </ul>
        !            86:   <hr>
        !            87:   <a href="index.html"><img src=back.gif border=0 alt=OpenBSD></a>
        !            88:   <a href=mailto:www@openbsd.org>www@openbsd.org</a>
        !            89:   <br><small>$OpenBSD: porting.html,v 1.17 1998/01/25 05:44:48 joey Exp $</small>
        !            90:  </body>
        !            91: </html>