Makefile revision 175833
1# 2# $FreeBSD: head/Makefile 175833 2008-01-30 19:33:18Z jhb $ 3# 4# The user-driven targets are: 5# 6# universe - *Really* build *everything* (buildworld and 7# all kernels on all architectures). 8# buildworld - Rebuild *everything*, including glue to help do 9# upgrades. 10# installworld - Install everything built by "buildworld". 11# world - buildworld + installworld, no kernel. 12# buildkernel - Rebuild the kernel and the kernel-modules. 13# installkernel - Install the kernel and the kernel-modules. 14# installkernel.debug 15# reinstallkernel - Reinstall the kernel and the kernel-modules. 16# reinstallkernel.debug 17# kernel - buildkernel + installkernel. 18# doxygen - Build API documentation of the kernel, needs doxygen. 19# update - Convenient way to update your source tree (cvs). 20# check-old - List obsolete directories/files/libraries. 21# check-old-dirs - List obsolete directories. 22# check-old-files - List obsolete files. 23# check-old-libs - List obsolete libraries. 24# delete-old - Delete obsolete directories/files/libraries. 25# delete-old-dirs - Delete obsolete directories. 26# delete-old-files - Delete obsolete files. 27# delete-old-libs - Delete obsolete libraries. 28# 29# This makefile is simple by design. The FreeBSD make automatically reads 30# the /usr/share/mk/sys.mk unless the -m argument is specified on the 31# command line. By keeping this makefile simple, it doesn't matter too 32# much how different the installed mk files are from those in the source 33# tree. This makefile executes a child make process, forcing it to use 34# the mk files from the source tree which are supposed to DTRT. 35# 36# The user-driven targets (as listed above) are implemented in Makefile.inc1. 37# 38# If you want to build your system from source be sure that /usr/obj has 39# at least 400MB of diskspace available. 40# 41# For individuals wanting to build from the sources currently on their 42# system, the simple instructions are: 43# 44# 1. `cd /usr/src' (or to the directory containing your source tree). 45# 2. Define `HISTORICAL_MAKE_WORLD' variable (see README). 46# 3. `make world' 47# 48# For individuals wanting to upgrade their sources (even if only a 49# delta of a few days): 50# 51# 1. `cd /usr/src' (or to the directory containing your source tree). 52# 2. `make buildworld' 53# 3. `make buildkernel KERNCONF=YOUR_KERNEL_HERE' (default is GENERIC). 54# 4. `make installkernel KERNCONF=YOUR_KERNEL_HERE' (default is GENERIC). 55# [steps 3. & 4. can be combined by using the "kernel" target] 56# 5. `reboot' (in single user mode: boot -s from the loader prompt). 57# 6. `mergemaster -p' 58# 7. `make installworld' 59# 8. `make delete-old' 60# 9. `mergemaster' 61# 10. `reboot' 62# 11. `make delete-old-libs' (in case no 3rd party program uses them anymore) 63# 64# See src/UPDATING `COMMON ITEMS' for more complete information. 65# 66# If TARGET=machine (e.g. ia64, sparc64, ...) is specified you can 67# cross build world for other machine types using the buildworld target, 68# and once the world is built you can cross build a kernel using the 69# buildkernel target. 70# 71# Define the user-driven targets. These are listed here in alphabetical 72# order, but that's not important. 73# 74# Targets that begin with underscore are internal targets intended for 75# developer convenience only. They are intentionally not documented and 76# completely subject to change without notice. 77# 78# For more information, see the build(7) manual page. 79# 80TGTS= all all-man buildenv buildenvvars buildkernel buildworld \ 81 check-old check-old-dirs check-old-files check-old-libs \ 82 checkdpadd clean cleandepend cleandir \ 83 delete-old delete-old-dirs delete-old-files delete-old-libs \ 84 depend distribute distributeworld distrib-dirs distribution doxygen \ 85 everything hierarchy install installcheck installkernel \ 86 installkernel.debug reinstallkernel reinstallkernel.debug \ 87 installworld kernel-toolchain libraries lint maninstall \ 88 obj objlink regress rerelease showconfig tags toolchain update \ 89 _worldtmp _legacy _bootstrap-tools _cleanobj _obj \ 90 _build-tools _cross-tools _includes _libraries _depend \ 91 build32 distribute32 install32 92TGTS+= ${SUBDIR_TARGETS} 93 94BITGTS= files includes 95BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/} 96TGTS+= ${BITGTS} 97 98.ORDER: buildworld installworld 99.ORDER: buildworld distributeworld 100.ORDER: buildworld buildkernel 101.ORDER: buildkernel installkernel 102.ORDER: buildkernel installkernel.debug 103.ORDER: buildkernel reinstallkernel 104.ORDER: buildkernel reinstallkernel.debug 105 106PATH= /sbin:/bin:/usr/sbin:/usr/bin 107MAKEOBJDIRPREFIX?= /usr/obj 108_MAKEOBJDIRPREFIX!= /usr/bin/env -i PATH=${PATH} ${MAKE} \ 109 ${.MAKEFLAGS:MMAKEOBJDIRPREFIX=*} __MAKE_CONF=${__MAKE_CONF} \ 110 -f /dev/null -V MAKEOBJDIRPREFIX dummy 111.if !empty(_MAKEOBJDIRPREFIX) 112.error MAKEOBJDIRPREFIX can only be set in environment, not as a global\ 113 (in make.conf(5)) or command-line variable. 114.endif 115MAKEPATH= ${MAKEOBJDIRPREFIX}${.CURDIR}/make.${MACHINE} 116BINMAKE= \ 117 `if [ -x ${MAKEPATH}/make ]; then echo ${MAKEPATH}/make; else echo ${MAKE}; fi` \ 118 -m ${.CURDIR}/share/mk 119_MAKE= PATH=${PATH} ${BINMAKE} -f Makefile.inc1 120 121# 122# Make sure we have an up-to-date make(1). Only world and buildworld 123# should do this as those are the initial targets used for upgrades. 124# The user can define ALWAYS_CHECK_MAKE to have this check performed 125# for all targets. 126# 127.if defined(ALWAYS_CHECK_MAKE) 128${TGTS}: upgrade_checks 129.else 130buildworld: upgrade_checks 131.endif 132 133# 134# This 'cleanworld' target is not included in TGTS, because it is not a 135# recursive target. All of the work for it is done right here. It is 136# expected that BW_CANONICALOBJDIR == the CANONICALOBJDIR as would be 137# created by bsd.obj.mk, except that we don't want to .include that file 138# in this makefile. 139# 140# In the following, the first 'rm' in a series will usually remove all 141# files and directories. If it does not, then there are probably some 142# files with chflags set, so this unsets them and tries the 'rm' a 143# second time. There are situations where this target will be cleaning 144# some directories via more than one method, but that duplication is 145# needed to correctly handle all the possible situations. 146# 147BW_CANONICALOBJDIR:=${MAKEOBJDIRPREFIX}${.CURDIR} 148cleanworld: 149.if ${.CURDIR} == ${.OBJDIR} || ${.CURDIR}/obj == ${.OBJDIR} 150.if exists(${BW_CANONICALOBJDIR}/) 151 -rm -rf ${BW_CANONICALOBJDIR}/* 152 -chflags -R 0 ${BW_CANONICALOBJDIR} 153 rm -rf ${BW_CANONICALOBJDIR}/* 154.endif 155 # To be safe in this case, fall back to a 'make cleandir' 156 ${_+_}@cd ${.CURDIR}; ${_MAKE} cleandir 157.else 158 -rm -rf ${.OBJDIR}/* 159 -chflags -R 0 ${.OBJDIR} 160 rm -rf ${.OBJDIR}/* 161.endif 162 163# 164# Handle the user-driven targets, using the source relative mk files. 165# 166 167${TGTS}: 168 ${_+_}@cd ${.CURDIR}; \ 169 ${_MAKE} ${.TARGET} 170 171# Set a reasonable default 172.MAIN: all 173 174STARTTIME!= LC_ALL=C date 175 176.if defined(HISTORICAL_MAKE_WORLD) || defined(DESTDIR) 177# 178# world 179# 180# Attempt to rebuild and reinstall everything. This target is not to be 181# used for upgrading an existing FreeBSD system, because the kernel is 182# not included. One can argue that this target doesn't build everything 183# then. 184# 185world: upgrade_checks 186 @echo "--------------------------------------------------------------" 187 @echo ">>> make world started on ${STARTTIME}" 188 @echo "--------------------------------------------------------------" 189.if target(pre-world) 190 @echo 191 @echo "--------------------------------------------------------------" 192 @echo ">>> Making 'pre-world' target" 193 @echo "--------------------------------------------------------------" 194 ${_+_}@cd ${.CURDIR}; ${_MAKE} pre-world 195.endif 196 ${_+_}@cd ${.CURDIR}; ${_MAKE} buildworld 197 ${_+_}@cd ${.CURDIR}; ${_MAKE} -B installworld 198.if target(post-world) 199 @echo 200 @echo "--------------------------------------------------------------" 201 @echo ">>> Making 'post-world' target" 202 @echo "--------------------------------------------------------------" 203 ${_+_}@cd ${.CURDIR}; ${_MAKE} post-world 204.endif 205 @echo 206 @echo "--------------------------------------------------------------" 207 @echo ">>> make world completed on `LC_ALL=C date`" 208 @echo " (started ${STARTTIME})" 209 @echo "--------------------------------------------------------------" 210.else 211world: 212 @echo "WARNING: make world will overwrite your existing FreeBSD" 213 @echo "installation without also building and installing a new" 214 @echo "kernel. This can be dangerous. Please read the handbook," 215 @echo "'Rebuilding world', for how to upgrade your system." 216 @echo "Define DESTDIR to where you want to install FreeBSD," 217 @echo "including /, to override this warning and proceed as usual." 218 @echo "" 219 @echo "Bailing out now..." 220 @false 221.endif 222 223# 224# kernel 225# 226# Short hand for `make buildkernel installkernel' 227# 228kernel: buildkernel installkernel 229 230# 231# Perform a few tests to determine if the installed tools are adequate 232# for building the world. 233# 234upgrade_checks: 235 @if ! (cd ${.CURDIR}/tools/build/make_check && \ 236 PATH=${PATH} ${BINMAKE} obj >/dev/null 2>&1 && \ 237 PATH=${PATH} ${BINMAKE} >/dev/null 2>&1); \ 238 then \ 239 (cd ${.CURDIR} && ${MAKE} make); \ 240 fi 241 242# 243# Upgrade make(1) to the current version using the installed 244# headers, libraries and tools. Also, allow the location of 245# the system bsdmake-like utility to be overridden. 246# 247MMAKEENV= MAKEOBJDIRPREFIX=${MAKEPATH} \ 248 DESTDIR= \ 249 INSTALL="sh ${.CURDIR}/tools/install.sh" 250MMAKE= ${MMAKEENV} ${MAKE} \ 251 -D_UPGRADING \ 252 -DNOMAN -DNO_MAN -DNOSHARED -DNO_SHARED \ 253 -DNO_CPU_CFLAGS -DNO_WERROR 254 255make: .PHONY 256 @echo 257 @echo "--------------------------------------------------------------" 258 @echo ">>> Building an up-to-date make(1)" 259 @echo "--------------------------------------------------------------" 260 ${_+_}@cd ${.CURDIR}/usr.bin/make; \ 261 ${MMAKE} obj && \ 262 ${MMAKE} depend && \ 263 ${MMAKE} all && \ 264 ${MMAKE} install DESTDIR=${MAKEPATH} BINDIR= 265 266# 267# universe 268# 269# Attempt to rebuild *everything* for all supported architectures, 270# with a reasonable chance of success, regardless of how old your 271# existing system is. 272# 273.if make(universe) 274TARGETS?=amd64 arm i386 ia64 pc98 powerpc sparc64 sun4v 275 276universe: universe_prologue 277universe_prologue: 278 @echo "--------------------------------------------------------------" 279 @echo ">>> make universe started on ${STARTTIME}" 280 @echo "--------------------------------------------------------------" 281.for target in ${TARGETS} 282KERNCONFS!= cd ${.CURDIR}/sys/${target}/conf && \ 283 find [A-Z]*[A-Z] -type f -maxdepth 0 \ 284 ! -name DEFAULTS ! -name LINT 285KERNCONFS:= ${KERNCONFS:S/^NOTES$/LINT/} 286universe: universe_${target} 287.ORDER: universe_prologue universe_${target} universe_epilogue 288universe_${target}: 289 @echo ">> ${target} started on `LC_ALL=C date`" 290 -cd ${.CURDIR} && ${MAKE} ${JFLAG} buildworld \ 291 TARGET=${target} \ 292 __MAKE_CONF=/dev/null \ 293 > _.${target}.buildworld 2>&1 294 @echo ">> ${target} buildworld completed on `LC_ALL=C date`" 295.if exists(${.CURDIR}/sys/${target}/conf/NOTES) 296 -cd ${.CURDIR}/sys/${target}/conf && ${MAKE} LINT \ 297 > ${.CURDIR}/_.${target}.makeLINT 2>&1 298.endif 299.for kernel in ${KERNCONFS} 300 -cd ${.CURDIR} && ${MAKE} ${JFLAG} buildkernel \ 301 TARGET=${target} \ 302 KERNCONF=${kernel} \ 303 __MAKE_CONF=/dev/null \ 304 > _.${target}.${kernel} 2>&1 305.endfor 306 @echo ">> ${target} completed on `LC_ALL=C date`" 307.endfor 308universe: universe_epilogue 309universe_epilogue: 310 @echo "--------------------------------------------------------------" 311 @echo ">>> make universe completed on `LC_ALL=C date`" 312 @echo " (started ${STARTTIME})" 313 @echo "--------------------------------------------------------------" 314.endif 315