unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OpenBSD-3.6)
Page:
Section:
Apropos / Subsearch:
optional field

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

NAME
     mk.conf - system-specific configuration parameters

SYNOPSIS
     .include <&lt;bsd.own.mk>&gt;

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]

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.

     MANZ                   Compress manual pages at installation time.

     NOLINT                 Do not build lint libraries.  [yes; set
                            unconditionally]

     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 to be
                            skipped during "make build".

     SUDO                   Command to run when doing "make install" portion
                            of "make build".  If set to sudo, this allows one
                            to run "make build" as a user other than root (as-
                            suming 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).

     WARNINGS               Adds appropriate warning flags (defined in
                            CDIAGFLAGS, e.g.  -Wall...) to compiles.  [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 3.6                     March 19, 2003                               3