Home | History | Annotate | Line # | Download | only in src
Makefile revision 1.206
      1 #	$NetBSD: Makefile,v 1.206 2003/05/10 07:12:37 lukem Exp $
      2 
      3 #
      4 # This is the top-level makefile for building NetBSD. For an outline of
      5 # how to build a snapshot or release, as well as other release engineering
      6 # information, see http://www.netbsd.org/developers/releng/index.html
      7 #
      8 # Not everything you can set or do is documented in this makefile. In
      9 # particular, you should review the files in /usr/share/mk (especially
     10 # bsd.README) for general information on building programs and writing
     11 # Makefiles within this structure, and see the comments in src/etc/Makefile
     12 # for further information on installation and release set options.
     13 #
     14 # Variables listed below can be set on the make command line (highest
     15 # priority), in /etc/mk.conf (middle priority), or in the environment
     16 # (lowest priority).
     17 #
     18 # Variables:
     19 #   DESTDIR is the target directory for installation of the compiled
     20 #	software. It defaults to /. Note that programs are built against
     21 #	libraries installed in DESTDIR.
     22 #   MKMAN, if set to `no', will prevent building of manual pages.
     23 #   MKOBJDIRS, if not set to `no', will build object directories at
     24 #	an appropriate point in a build.
     25 #   MKSHARE, if set to `no', will prevent building and installing
     26 #	anything in /usr/share.
     27 #   UPDATE, if defined, will avoid a `make cleandir' at the start of
     28 #	`make build', as well as having the effects listed in
     29 #	/usr/share/mk/bsd.README.
     30 #   NOCLEANDIR, if defined, will avoid a `make cleandir' at the start
     31 #	of the `make build'.
     32 #   NOINCLUDES will avoid the `make includes' usually done by `make build'.
     33 #
     34 # Targets:
     35 #   build:
     36 #	Builds a full release of NetBSD in DESTDIR, except for the
     37 #	/etc configuration files.
     38 #	If BUILD_DONE is set, this is an empty target.
     39 #   distribution:
     40 #	Builds a full release of NetBSD in DESTDIR, including the /etc
     41 #	configuration files.
     42 #   buildworld:
     43 #	As per `make distribution', except that it ensures that DESTDIR
     44 #	is not the root directory.
     45 #   installworld:
     46 #	Install the distribution from DESTDIR to INSTALLWORLDDIR (which
     47 #	defaults to the root directory).  Ensures that INSTALLWORLDDIR
     48 #	is the not root directory if cross compiling.
     49 #   release:
     50 #	Does a `make build', and then tars up the DESTDIR files
     51 #	into RELEASEDIR/${MACHINE}, in release(7) format.
     52 #	(See etc/Makefile for more information on this.)
     53 #   regression-tests:
     54 #	Runs the regression tests in "regress" on this host.
     55 #   sets:
     56 #	Populate ${RELEASEDIR}/${MACHINE}/binary/sets from ${DESTDIR}
     57 #   sourcesets:
     58 #	Populate ${RELEASEDIR}/source/sets from ${NETBSDSRCDIR}
     59 #
     60 # Targets invoked by `make build,' in order:
     61 #   cleandir:        cleans the tree.
     62 #   obj:             creates object directories.
     63 #   do-tools:        builds host toolchain.
     64 #   do-tools-compat: builds the "libnbcompat" library; needed for some
     65 #                    random host tool programs in the source tree.
     66 #   do-distrib-dirs: creates the distribution directories.
     67 #   includes:        installs include files.
     68 #   do-lib-csu:      builds and installs prerequisites from lib/csu.
     69 #   do-lib-libc:     builds and installs prerequisites from lib/libc.
     70 #   do-lib:          builds and installs prerequisites from lib.
     71 #   do-gnu-lib:      builds and installs prerequisites from gnu/lib.
     72 #   do-ld.so:        builds and installs prerequisites from libexec/ld.*_so.
     73 #   do-build:        builds and installs the entire system.
     74 #
     75 
     76 .if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
     77 .MAKEFLAGS: -m ${.CURDIR}/share/mk
     78 .endif
     79 
     80 #
     81 # If _SRC_TOP_OBJ_ gets set here, we will end up with a directory that may
     82 # not be the top level objdir, because "make obj" can happen in the *middle*
     83 # of "make build" (long after <bsd.own.mk> is calculated it).  So, pre-set
     84 # _SRC_TOP_OBJ_ here so it will not be added to ${.MAKEOVERRIDES}.
     85 #
     86 _SRC_TOP_OBJ_=
     87 
     88 .include <bsd.own.mk>
     89 
     90 #
     91 # Sanity check: make sure that "make build" is not invoked simultaneously
     92 # with a standard recursive target.
     93 #
     94 
     95 .if make(build) || make(release) || make(snapshot)
     96 .for targ in ${TARGETS:Nobj:Ncleandir}
     97 .if make(${targ}) && !target(.BEGIN)
     98 .BEGIN:
     99 	@echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
    100 	@false
    101 .endif
    102 .endfor
    103 .endif
    104 
    105 _SUBDIR=	tools lib include gnu bin games libexec sbin usr.bin
    106 _SUBDIR+=	usr.sbin share rescue sys etc .WAIT distrib regress
    107 
    108 #
    109 # Weed out directories that don't exist.
    110 #
    111 
    112 .for dir in ${_SUBDIR}
    113 .if exists(${dir}/Makefile) && (${BUILD_${dir}:Uyes} != "no")
    114 SUBDIR+=	${dir}
    115 .endif
    116 .endfor
    117 
    118 .if exists(regress)
    119 regression-tests:
    120 	@echo Running regression tests...
    121 	@(cd ${.CURDIR}/regress && ${MAKE} regress)
    122 .endif
    123 
    124 .if defined(UNPRIVED)
    125 NOPOSTINSTALL=	# defined
    126 .endif
    127 
    128 afterinstall:
    129 .if ${MKMAN} != "no"
    130 	(cd ${.CURDIR}/share/man && ${MAKE} makedb)
    131 .endif
    132 .if defined(UNPRIVED) && (${MKINFO} != "no")
    133 	(cd ${.CURDIR}/gnu/usr.bin/texinfo/install-info && ${MAKE} infodir-meta)
    134 .endif
    135 .if !defined(NOPOSTINSTALL)
    136 	(cd ${.CURDIR} && ${MAKE} postinstall-check)
    137 .endif
    138 
    139 postinstall-check:
    140 	@echo "   === Post installation checks ==="
    141 	sh ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ check
    142 	@echo "   ================================"
    143 
    144 postinstall-fix: .NOTMAIN
    145 	@echo "   === Post installation fixes ==="
    146 	sh ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ fix
    147 	@echo "   ================================"
    148 
    149 
    150 #
    151 # Targets (in order!) called by "make build".
    152 #
    153 
    154 BUILDTARGETS+=	check-tools
    155 .if !defined(UPDATE) && !defined(NOCLEANDIR)
    156 BUILDTARGETS+=	cleandir
    157 .endif
    158 .if ${MKOBJDIRS} != "no"
    159 BUILDTARGETS+=	obj
    160 .endif
    161 .if ${USETOOLS} == "yes"
    162 BUILDTARGETS+=	do-tools
    163 .endif
    164 .if !defined(NODISTRIBDIRS)
    165 BUILDTARGETS+=	do-distrib-dirs
    166 .endif
    167 .if !defined(NOINCLUDES)
    168 BUILDTARGETS+=	includes
    169 .endif
    170 BUILDTARGETS+=	do-tools-compat
    171 BUILDTARGETS+=	do-lib-csu do-lib-libc do-lib do-gnu-lib do-ld.so do-build
    172 BUILDTARGETS+=	do-obsolete
    173 
    174 #
    175 # Enforce proper ordering of some rules.
    176 #
    177 
    178 .ORDER:		${BUILDTARGETS}
    179 includes-lib:	includes-include includes-sys
    180 includes-gnu:	includes-lib
    181 
    182 #
    183 # Build the system and install into DESTDIR.
    184 #
    185 
    186 START_TIME!=	date
    187 
    188 build:
    189 .if defined(BUILD_DONE)
    190 	@echo "Build already installed into ${DESTDIR}"
    191 .else
    192 	@echo "Build started at: ${START_TIME}"
    193 .for tgt in ${BUILDTARGETS}
    194 	@(cd ${.CURDIR} && ${MAKE} ${tgt})
    195 .endfor
    196 	@echo   "Build started at:  ${START_TIME}"
    197 	@printf "Build finished at: " && date
    198 .endif
    199 
    200 #
    201 # Build a full distribution, but not a release (i.e. no sets into
    202 # ${RELEASEDIR}).  "buildworld" enforces a build to ${DESTDIR} != /
    203 #
    204 
    205 distribution buildworld:
    206 .if make(buildworld) && \
    207     (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
    208 	@echo "Won't make ${.TARGET} with DESTDIR=/"
    209 	@false
    210 .endif
    211 	(cd ${.CURDIR} && ${MAKE} NOPOSTINSTALL=1 build)
    212 	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 distribution)
    213 .if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
    214 	(cd ${.CURDIR}/distrib/sets && ${MAKE} checkflist)
    215 .endif
    216 	@echo   "make ${.TARGET} started at:  ${START_TIME}"
    217 	@printf "make ${.TARGET} finished at: " && date
    218 
    219 #
    220 # Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
    221 # If installing to /, ensures that the host's operating system is NetBSD and
    222 # the host's `uname -m` == ${MACHINE}.
    223 #
    224 
    225 HOST_UNAME_S!=	uname -s
    226 HOST_UNAME_M!=	uname -m
    227 
    228 installworld:
    229 .if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
    230 	@echo "Can't make ${.TARGET} to DESTDIR=/"
    231 	@false
    232 .endif
    233 .if !defined(INSTALLWORLDDIR) || \
    234     ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
    235 .if (${HOST_UNAME_S} != "NetBSD")
    236 	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
    237 	@false
    238 .endif
    239 .if (${HOST_UNAME_M} != ${MACHINE})
    240 	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
    241 	@false
    242 .endif
    243 .endif
    244 	(cd ${.CURDIR}/distrib/sets && \
    245 	    ${MAKE} INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS= installsets)
    246 	(cd ${.CURDIR} && \
    247 	    ${MAKE} DESTDIR=${INSTALLWORLDDIR} postinstall-check)
    248 	@echo   "make ${.TARGET} started at:  ${START_TIME}"
    249 	@printf "make ${.TARGET} finished at: " && date
    250 
    251 #
    252 # Create sets from $DESTDIR or $NETBSDSRCDIR into $RELEASEDIR
    253 #
    254 
    255 .for tgt in sets sourcesets
    256 ${tgt}:
    257 	(cd ${.CURDIR}/distrib/sets && ${MAKE} $@)
    258 .endfor
    259 
    260 #
    261 # Build a release or snapshot (implies "make build").  Note that
    262 # in this case, the set lists will be checked before the tar files
    263 # are made.
    264 #
    265 
    266 release snapshot:
    267 	(cd ${.CURDIR} && ${MAKE} NOPOSTINSTALL=1 build)
    268 	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 release)
    269 	@echo   "make ${.TARGET} started at:  ${START_TIME}"
    270 	@printf "make ${.TARGET} finished at: " && date
    271 
    272 #
    273 # Special components of the "make build" process.
    274 #
    275 
    276 check-tools:
    277 .if ${TOOLCHAIN_MISSING} == "yes" && !defined(EXTERNAL_TOOLCHAIN)
    278 	@echo '*** WARNING:  Building on MACHINE=${MACHINE} with missing toolchain.'
    279 	@echo '*** May result in a failed build or corrupt binaries!'
    280 .elif defined(EXTERNAL_TOOLCHAIN)
    281 	@echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
    282 .endif
    283 .if defined(NBUILDJOBS)
    284 	@echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!'
    285 .endif
    286 
    287 do-distrib-dirs:
    288 .if !defined(DESTDIR) || ${DESTDIR} == ""
    289 	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=/ distrib-dirs)
    290 .else
    291 	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=${DESTDIR} distrib-dirs)
    292 .endif
    293 
    294 .for targ in cleandir obj includes
    295 do-${targ}: ${targ}
    296 	@true
    297 .endfor
    298 
    299 .for dir in tools tools/compat lib/csu lib/libc lib gnu/lib
    300 do-${dir:S/\//-/}:
    301 .for targ in dependall install
    302 	(cd ${.CURDIR}/${dir} && ${MAKE} ${targ})
    303 .endfor
    304 .endfor
    305 
    306 do-ld.so:
    307 .for targ in dependall install
    308 .if (${OBJECT_FMT} == "a.out")
    309 	(cd ${.CURDIR}/libexec/ld.aout_so && ${MAKE} ${targ})
    310 .endif
    311 .if (${OBJECT_FMT} == "ELF")
    312 	(cd ${.CURDIR}/libexec/ld.elf_so && ${MAKE} ${targ})
    313 .endif
    314 .endfor
    315 
    316 do-build:
    317 .for targ in dependall install
    318 	(cd ${.CURDIR} && ${MAKE} ${targ} BUILD_tools=no BUILD_lib=no)
    319 .endfor
    320 
    321 do-obsolete:
    322 	(cd ${.CURDIR}/etc && ${MAKE} install-obsolete-lists)
    323 
    324 #
    325 # Speedup stubs for some subtrees that don't need to run these rules.
    326 # (Tells <bsd.subdir.mk> not to recurse for them.)
    327 #
    328 
    329 .for dir in bin etc distrib games libexec regress sbin usr.sbin tools
    330 includes-${dir}:
    331 	@true
    332 .endfor
    333 .for dir in etc distrib regress
    334 install-${dir}:
    335 	@true
    336 .endfor
    337 
    338 #
    339 # XXX this needs to change when distrib Makefiles are recursion compliant
    340 # XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
    341 #
    342 dependall-distrib depend-distrib all-distrib:
    343 	@true
    344 
    345 .include <bsd.obj.mk>
    346 .include <bsd.subdir.mk>
    347 
    348 build-docs: ${.CURDIR}/BUILDING
    349 ${.CURDIR}/BUILDING: doc/BUILDING.mdoc
    350 	groff -mdoc -Tascii -P-b -P-u -P-o $> >$@
    351