MK.CONF(5)                OpenBSD Programmer's Manual               MK.CONF(5)

NAME
     mk.conf - system-specific configuration parameters

SYNOPSIS
     .include <bsd.own.mk>

DESCRIPTION
     To get system-specific configuration parameters, <bsd.own.mk> will try to
     include the file specified by the MAKECONF variable.  If MAKECONF is not
     set, or no such file exists, the system make configuration file
     /etc/mk.conf is included, if it exists.  By default, this file does not
     exist, and must be created from scratch.  For more information on how the
     make process works, and details of the format of make files, see make(1).

     <bsd.own.mk> is generally useful when building Makefiles, so that they
     use the same default owners, etc. as the rest of the tree.  These files
     may define any of the variables described below.  Additionally, see
     bsd.port.mk(5) for a list of variables that can be set by the ports(7)
     subsystem.

VARIABLES
     The following variables are set by <bsd.own.mk>, if they are not already
     defined.  Defaults are in brackets.

     BINGRP         Binary group.  [bin]

     BINMODE        Binary mode.  [555]

     BINOWN         Binary owner.  [root]

     BSDOBJDIR      The real path to the system 'obj' tree, so that 'make obj'
                    will work correctly.  [/usr/obj]

     BSDSRCDIR      The real path to the system sources, so that 'make obj'
                    will work correctly.  [/usr/src]

     DIRMODE        Mode for new directories.  [755]

     DOCDIR         Base path for system documentation (e.g. PSD, USD, etc.)
                    installation.  [/usr/share/doc]

     DOCGRP         Documentation group.  [bin]

     DOCMODE        Documentation mode.  [${NONBINMODE}]

     DOCOWN         Documentation owner.  [root]

     INSTALL_COPY   The old usage of this flag is obsolescent, since
                    install(1) now copies by default.  However, it can also be
                    used to specify that a file not be copied unless it is
                    different (via the -p option).  See install(1) for de-
                    tails.  This is to be used when building an install script
                    so that the entire system can either be installed with
                    copies, or copy-if-different using a single knob.  [-c]

     INSTALL_STRIP  The flag passed to the install program to cause the binary
                    to be stripped.  This is to be used when building an in-
                    stall script so that the entire system can be made
                    stripped/not-stripped using a single knob.  Note that
                    INSTALL_STRIP is not set if ${DEBUG} is defined.  [-s]

     LIBDIR         Base path for library installation.  [/usr/lib]

     LIBGRP         Library group.  [${BINGRP}]

     LIBMODE        Library mode.  [${NONBINMODE}]

     LIBOWN         Library owner.  [${BINOWN}]

     LINTLIBDIR     Base path for lint(1) library installation.
                    [/usr/libdata/lint]

     MANDIR         Base path for manual installation.  [/usr/share/man/cat]

     MANGRP         Manual group.  [bin]

     MANMODE        Manual mode.  [${NONBINMODE}]

     MANOWN         Manual owner.  [root]

     NLSDIR         Base path for National Language Support files installa-
                    tion.  [/usr/share/nls]

     NLSGRP         National Language Support files group.  [bin]

     NLSMODE        National Language Support files mode.  [${NONBINMODE}]

     NLSOWN         National Language Support files owner.  [root]

     NONBINMODE     Mode for non-executable files.  [444]

     XOBJDIR        The real path to the 'obj' tree for building the X Window
                    System.  [/usr/xobj]

     XSRCDIR        The real path to the X Window System sources.
                    [/usr/xenocara]

ADDITIONAL VARIABLES
     Additionally, the following variables may be set by <bsd.own.mk> or in a
     make configuration file to modify the behaviour of the system build pro-
     cess (default values are in brackets along with comments, if set by
     <bsd.own.mk>):

     DEBUG                  Add -g to assembly, C compiler and linking passes.
                            Also doesn't set INSTALL_STRIP to -s per default
                            if defined.

     DEBUGLIBS              Create libraries with -g debug information, and
                            install them in /usr/lib/debug.

     GLOBAL_AUTOCONF_CACHE  Set to the name of a file that all cached GNU au-
                            toconf test results will be saved in.  Reduces re-
                            dundant tests.  Be careful!  Redundant tests may
                            not be redundant when installing substantially up-
                            dated GNU programs.

     MANPS                  Define to have PostScript manual pages generated.
                            Use for BSDSRCDIR only.

     MANZ                   Compress manual pages at installation time.

     NOPIC                  Do not build PIC versions of system libraries, and
                            do not build shared libraries.

     NOPROFILE              Do not build profiled versions of system li-
                            braries.

     PIPE                   If set to "-pipe", gcc(1) will be given the -pipe
                            option which can speed up compiles on machines
                            with memory to spare.  Instead of using temp
                            files, gcc(1) uses pipes for the temporary data.

     SKEY                   Compile in support for S/key authentication.
                            [yes; set unconditionally]

     SKIPDIR                A space separated list of directories, relative to
                            BSDSRCDIR, to be skipped during "make build".

     SUDO                   Command run by make(1) when doing certain opera-
                            tions requiring root privileges (e.g. the "make
                            install" portion of "make build").  If set to
                            /usr/bin/sudo, this allows one to run "make build"
                            as a user other than root (assuming sudo is set up
                            for that user).

     SYS_INCLUDE            Copy or symlink kernel include files into
                            /usr/include.  Possible values are "symlinks" or
                            "copies" (which is the same as the variable being
                            unset).

     WANTLINT               Build lint libraries.  [no]

     WARNINGS               Adds appropriate warning flags (defined in
                            CDIAGFLAGS, e.g. -Wall...) to compiles.  [no]

     XENOCARA_BUILD_DRI     Build X with Direct Rendering Infrastructure (DRI)
                            support, providing some hardware acceleration.
                            This is on by default for amd64/i386 architec-
                            tures.

     XENOCARA_RERUN_AUTOCONF
                            Forces X builds to re-run automake and autoconf in
                            each module before configuring them.  This option
                            requires that the automake, autoconf and libtool
                            packages are installed.  [no]

FILES
     /etc/mk.conf     System make configuration file.
     /usr/share/mk/*  System include make files.

SEE ALSO
     make(1), bsd.port.mk(5), ports(7)

HISTORY
     The mk.conf manual page first appeared in OpenBSD 3.4.

OpenBSD 4.7                     April 11, 2009                               3
