2 # Part of a unified Makefile for building kernels. This part includes all
3 # the definitions that need to be after all the % directives except %RULES
4 # and ones that act like they are part of %RULES.
6 # Most make variables should not be defined in this file. Instead, they
7 # should be defined in the kern.pre.mk so that port makefiles can
8 # override or augment them.
10 .if defined(DTS) || defined(DTSO) || defined(FDT_DTS_FILE)
11 .include "dtb.build.mk"
13 KERNEL_EXTRA+= ${DTB} ${DTBO}
14 CLEAN+= ${DTB} ${DTBO}
16 kernel-install: _dtbinstall
17 .ORDER: beforeinstall _dtbinstall
20 # In case the config had a makeoptions DESTDIR...
22 MKMODULESENV+= DESTDIR="${DESTDIR}"
24 SYSDIR?= ${S:C;^[^/];${.CURDIR}/&;:tA}
25 MKMODULESENV+= KERNBUILDDIR="${.CURDIR}" SYSDIR="${SYSDIR}"
26 MKMODULESENV+= MODULE_TIED=yes
28 .if defined(CONF_CFLAGS)
29 MKMODULESENV+= CONF_CFLAGS="${CONF_CFLAGS}"
33 MKMODULESENV+= WITH_CTF="${WITH_CTF}"
36 .if !empty(KCSAN_ENABLED)
37 MKMODULESENV+= KCSAN_ENABLED="yes"
40 .if defined(SAN_CFLAGS)
41 MKMODULESENV+= SAN_CFLAGS="${SAN_CFLAGS}"
44 .if defined(GCOV_CFLAGS)
45 MKMODULESENV+= GCOV_CFLAGS="${GCOV_CFLAGS}"
48 .if !empty(COMPAT_FREEBSD32_ENABLED)
49 MKMODULESENV+= COMPAT_FREEBSD32_ENABLED="yes"
52 # Allow overriding the kernel debug directory, so kernel and user debug may be
53 # installed in different directories. Setting it to "" restores the historical
54 # behavior of installing debug files in the kernel directory.
55 KERN_DEBUGDIR?= ${DEBUGDIR}
59 .if !defined(NO_MODULES)
60 # Default prefix used for modules installed from ports
61 LOCALBASE?= /usr/local
63 LOCAL_MODULES_DIR?= ${LOCALBASE}/sys/modules
65 # Default to installing all modules installed by ports unless overridden
67 .if !defined(LOCAL_MODULES) && exists(${LOCAL_MODULES_DIR})
68 LOCAL_MODULES!= ls ${LOCAL_MODULES_DIR}
72 .for target in all clean cleandepend cleandir clobber depend install \
73 ${_obj} reinstall tags
74 ${target}: kernel-${target}
75 .if !defined(NO_MODULES)
76 ${target}: modules-${target}
78 .if !defined(MODULES_WITH_WORLD) && exists($S/modules)
79 cd $S/modules; ${MKMODULESENV} ${MAKE} \
80 ${target:S/^reinstall$/install/:S/^clobber$/cleandir/}
82 .for module in ${LOCAL_MODULES}
83 @${ECHODIR} "===> ${module} (${target:S/^reinstall$/install/:S/^clobber$/cleandir/})"
84 @cd ${LOCAL_MODULES_DIR}/${module}; ${MKMODULESENV} ${MAKE} \
85 DIRPRFX="${module}/" \
86 ${target:S/^reinstall$/install/:S/^clobber$/cleandir/}
91 # Handle ports (as defined by the user) that build kernel modules
92 .if !defined(NO_MODULES) && defined(PORTS_MODULES)
94 # The ports tree needs some environment variables defined to match the new kernel
96 # SRC_BASE is how the ports tree refers to the location of the base source files
97 .if !defined(SRC_BASE)
98 SRC_BASE= ${SYSDIR:H:tA}
100 # OSVERSION is used by some ports to determine build options
101 .if !defined(OSRELDATE)
102 # Definition copied from src/Makefile.inc1
103 OSRELDATE!= awk '/^\#define[[:space:]]*__FreeBSD_version/ { print $$3 }' \
104 ${MAKEOBJDIRPREFIX}${SRC_BASE}/include/osreldate.h
106 # Keep the related ports builds in the obj directory so that they are only rebuilt once per kernel build
108 # Ports search for some dependencies in PATH, so add the location of the
110 WRKDIRPREFIX?= ${.OBJDIR}
119 MAKEFLAGS="${MAKEFLAGS:M*:tW:S/^-m /-m_/g:S/ -m / -m_/g:tw:N-m_*:NMK_AUTO_OBJ=*}" \
121 PATH=${PATH}:${LOCALBASE}/bin:${LOCALBASE}/sbin \
122 SRC_BASE=${SRC_BASE} \
123 OSVERSION=${OSRELDATE} \
124 WRKDIRPREFIX=${WRKDIRPREFIX}
126 # The WRKDIR needs to be cleaned before building, and trying to change the target
127 # with a :C pattern below results in install -> instclean
129 .for __i in ${PORTS_MODULES}
130 @${ECHO} "===> Ports module ${__i} (all)"
131 cd ${PORTSDIR:U/usr/ports}/${__i}; ${PORTSMODULESENV} ${MAKE} -B clean build
134 .for __target in install reinstall clean
135 ${__target}: ports-${__target}
137 .for __i in ${PORTS_MODULES}
138 @${ECHO} "===> Ports module ${__i} (${__target})"
139 cd ${PORTSDIR:U/usr/ports}/${__i}; ${PORTSMODULESENV} ${MAKE} -B ${__target:C/(re)?install/deinstall reinstall/}
144 # Generate the .bin (booti images) kernel as an extra build output.
145 # The targets and rules to generate these appear in Makefile.$MACHINE
146 # if the platform supports it.
147 .if ${MK_KERNEL_BIN} != "no"
148 KERNEL_EXTRA+= ${KERNEL_KO}.bin
149 KERNEL_EXTRA_INSTALL+= ${KERNEL_KO}.bin
150 CLEAN+= ${KERNEL_KO}.bin
153 .ORDER: kernel-install modules-install
156 kernel-all: beforebuild .WAIT ${KERNEL_KO} ${KERNEL_EXTRA}
158 kernel-cleandir: kernel-clean kernel-cleandepend
161 find . -maxdepth 1 ! -type d ! -name version -delete
165 .if !defined(NO_MODULES)
167 modules-depend: beforebuild
168 modules-all: beforebuild
170 .if !defined(NO_MODULES_OBJ)
171 modules-all modules-depend: modules-obj
176 FULLKERNEL= ${KERNEL_KO}
178 FULLKERNEL= ${KERNEL_KO}.full
179 ${KERNEL_KO}: ${FULLKERNEL} ${KERNEL_KO}.debug
180 ${OBJCOPY} --strip-debug --add-gnu-debuglink=${KERNEL_KO}.debug \
181 ${FULLKERNEL} ${.TARGET}
182 ${KERNEL_KO}.debug: ${FULLKERNEL}
183 ${OBJCOPY} --only-keep-debug ${FULLKERNEL} ${.TARGET}
184 install.debug reinstall.debug: gdbinit
185 cd ${.CURDIR}; ${MAKE} ${.TARGET:R}
187 # Install gdbinit files for kernel debugging.
189 grep -v '# XXX' ${S}/../tools/debugscripts/dot.gdbinit | \
190 sed "s:MODPATH:${.OBJDIR}/modules:" > .gdbinit
191 cp ${S}/../tools/debugscripts/gdbinit.kernel ${.CURDIR}
192 .if exists(${S}/../tools/debugscripts/gdbinit.${MACHINE_CPUARCH})
193 cp ${S}/../tools/debugscripts/gdbinit.${MACHINE_CPUARCH} \
194 ${.CURDIR}/gdbinit.machine
198 ${FULLKERNEL}: ${SYSTEM_DEP} vers.o
200 @echo linking ${.TARGET}
202 .if !empty(MD_ROOT_SIZE_CONFIGURED) && defined(MFS_IMAGE)
203 @sh ${S}/tools/embed_mfs.sh ${.TARGET} ${MFS_IMAGE}
205 .if ${MK_CTF} != "no"
206 @echo ${CTFMERGE} ${CTFFLAGS} -o ${.TARGET} ...
207 @${CTFMERGE} ${CTFFLAGS} -o ${.TARGET} ${SYSTEM_OBJS} vers.o
210 ${OBJCOPY} --strip-debug ${.TARGET}
214 OBJS_DEPEND_GUESS+= offset.inc assym.inc vnode_if.h ${BEFORE_DEPEND:M*.h} \
215 ${MFILES:T:S/.m$/.h/}
217 .for mfile in ${MFILES}
218 # XXX the low quality .m.o rules gnerated by config are normally used
219 # instead of the .m.c rules here.
220 ${mfile:T:S/.m$/.c/}: ${mfile}
221 ${AWK} -f $S/tools/makeobjops.awk ${mfile} -c
222 ${mfile:T:S/.m$/.h/}: ${mfile}
223 ${AWK} -f $S/tools/makeobjops.awk ${mfile} -h
227 rm -f *.o *.so *.pico *.ko *.s eddep errs \
228 ${FULLKERNEL} ${KERNEL_KO} ${KERNEL_KO}.debug \
230 vnode_if.c vnode_if.h vnode_if_newproto.h vnode_if_typedef.h \
231 ${MFILES:T:S/.m$/.c/} ${MFILES:T:S/.m$/.h/} \
234 # This is a hack. BFD "optimizes" away dynamic mode if there are no
235 # dynamic references. We could probably do a '-Bforcedynamic' mode like
236 # in the a.out ld. For now, this works.
237 force-dynamic-hack.c:
240 force-dynamic-hack.pico: force-dynamic-hack.c Makefile
241 ${CC} ${CCLDFLAGS} -shared ${CFLAGS} -nostdlib \
242 force-dynamic-hack.c -o ${.TARGET}
244 offset.inc: $S/kern/genoffset.sh genoffset.o
245 NM='${NM}' NMFLAGS='${NMFLAGS}' sh $S/kern/genoffset.sh genoffset.o > ${.TARGET}
247 genoffset.o: $S/kern/genoffset.c
248 ${CC} -c ${CFLAGS:N-flto*:N-fno-common:N-fsanitize*:N-fno-sanitize*} \
249 -fcommon $S/kern/genoffset.c
251 # genoffset_test.o is not actually used for anything - the point of compiling it
252 # is to exercise the CTASSERT that checks that the offsets in the offset.inc
253 # _lite struct(s) match those in the original(s).
254 genoffset_test.o: $S/kern/genoffset.c offset.inc
255 ${CC} -c ${CFLAGS:N-flto*:N-fno-common:N-fsanitize*:N-fno-sanitize*} \
256 -fcommon -DOFFSET_TEST $S/kern/genoffset.c -o ${.TARGET}
258 assym.inc: $S/kern/genassym.sh genassym.o genoffset_test.o
259 NM='${NM}' NMFLAGS='${NMFLAGS}' sh $S/kern/genassym.sh genassym.o > ${.TARGET}
261 genassym.o: $S/$M/$M/genassym.c offset.inc
262 ${CC} -c ${CFLAGS:N-flto*:N-fno-common:N-fsanitize*:N-fno-sanitize*} \
263 -fcommon $S/$M/$M/genassym.c
265 OBJS_DEPEND_GUESS+= opt_global.h
266 genoffset.o genassym.o vers.o: opt_global.h
268 .if !empty(.MAKE.MODE:Unormal:Mmeta) && empty(.MAKE.MODE:Unormal:Mnofilemon)
271 .if ${MK_DIRDEPS_BUILD} == "no"
272 # Skip reading .depend when not needed to speed up tree-walks and simple
273 # lookups. For install, only do this if no other targets are specified.
274 # Also skip generating or including .depend.* files if in meta+filemon mode
275 # since it will track dependencies itself. OBJS_DEPEND_GUESS is still used
276 # for _meta_filemon but not for _SKIP_DEPEND.
277 .if !defined(NO_SKIP_DEPEND) && \
278 ((!empty(.MAKEFLAGS:M-V) && empty(.MAKEFLAGS:M*DEP*)) || \
279 ${.TARGETS:M*obj} == ${.TARGETS} || \
280 ${.TARGETS:M*clean*} == ${.TARGETS} || \
281 ${.TARGETS:M*install*} == ${.TARGETS})
284 .if defined(_SKIP_DEPEND) || defined(_meta_filemon)
285 .MAKE.DEPENDFILE= /dev/null
289 kernel-depend: .depend
290 SRCS= assym.inc offset.inc vnode_if.h ${BEFORE_DEPEND} ${CFILES} \
291 ${SYSTEM_CFILES} ${GEN_CFILES} ${SFILES} \
292 ${MFILES:T:S/.m$/.h/}
293 DEPENDOBJS+= ${SYSTEM_OBJS} genassym.o genoffset.o genoffset_test.o
294 DEPENDOBJS+= ${CLEAN:M*.o}
295 DEPENDFILES= ${DEPENDOBJS:O:u:C/^/.depend./}
296 .if ${MAKE_VERSION} < 20160220
299 .if defined(_SKIP_DEPEND)
300 # Don't bother reading any .meta files
301 ${DEPENDOBJS}: .NOMETA
303 # Unset these to avoid looping/statting on them later.
306 .endif # defined(_SKIP_DEPEND)
307 DEPEND_CFLAGS+= -MD ${DEPEND_MP} -MF.depend.${.TARGET}
308 DEPEND_CFLAGS+= -MT${.TARGET}
309 .if !defined(_meta_filemon)
310 .if !empty(DEPEND_CFLAGS)
311 # Only add in DEPEND_CFLAGS for CFLAGS on files we expect from DEPENDOBJS
312 # as those are the only ones we will include.
313 DEPEND_CFLAGS_CONDITION= "${DEPENDOBJS:M${.TARGET}}" != ""
314 CFLAGS+= ${${DEPEND_CFLAGS_CONDITION}:?${DEPEND_CFLAGS}:}
316 .for __depend_obj in ${DEPENDFILES}
317 .if ${MAKE_VERSION} < 20160220
318 .sinclude "${.OBJDIR}/${__depend_obj}"
320 .dinclude "${.OBJDIR}/${__depend_obj}"
323 .endif # !defined(_meta_filemon)
325 # Always run 'make depend' to generate dependencies early and to avoid the
326 # need for manually running it. For the kernel this is mostly a NOP since
327 # all dependencies are correctly added or accounted for. This is mostly to
328 # ensure downstream uses of kernel-depend are handled.
329 beforebuild: kernel-depend
331 # Guess some dependencies for when no ${DEPENDFILE}.OBJ is generated yet.
332 # For meta+filemon the .meta file is checked for since it is the dependency
334 .for __obj in ${DEPENDOBJS:O:u}
335 .if defined(_meta_filemon)
336 _depfile= ${.OBJDIR}/${__obj}.meta
338 _depfile= ${.OBJDIR}/.depend.${__obj}
340 .if !exists(${_depfile})
341 .if ${SYSTEM_OBJS:M${__obj}}
342 ${__obj}: ${OBJS_DEPEND_GUESS}
344 ${__obj}: ${OBJS_DEPEND_GUESS.${__obj}}
345 .elif defined(_meta_filemon)
346 # For meta mode we still need to know which file to depend on to avoid
347 # ambiguous suffix transformation rules from .PATH. Meta mode does not
348 # use .depend files. We really only need source files, not headers since
349 # they are typically in SRCS/beforebuild already. For target-specific
350 # guesses do include headers though since they may not be in SRCS.
351 .if ${SYSTEM_OBJS:M${__obj}}
352 ${__obj}: ${OBJS_DEPEND_GUESS:N*.h}
354 ${__obj}: ${OBJS_DEPEND_GUESS.${__obj}}
355 .endif # !exists(${_depfile})
358 .NOPATH: .depend ${DEPENDFILES}
360 .depend: .PRECIOUS ${SRCS}
363 .if ${MACHINE} != ${MACHINE_CPUARCH} && ${MACHINE} != "arm64"
364 _ILINKS+= ${MACHINE_CPUARCH}
366 .if ${MACHINE_CPUARCH} == "i386" || ${MACHINE_CPUARCH} == "amd64"
369 .if ${MACHINE_CPUARCH} == "amd64"
373 # Ensure that the link exists without depending on it when it exists.
374 # Ensure that debug info references the path in the source tree.
375 .for _link in ${_ILINKS}
376 .if !exists(${.OBJDIR}/${_link})
377 ${SRCS} ${DEPENDOBJS}: ${_link}
379 .if ${_link} == "machine"
380 CFLAGS+= -fdebug-prefix-map=./machine=${SYSDIR}/${MACHINE}/include
382 CFLAGS+= -fdebug-prefix-map=./${_link}=${SYSDIR}/${_link}/include
387 @case ${.TARGET} in \
389 path=${S}/${MACHINE}/include ;; \
391 path=${S}/${.TARGET}/include ;; \
393 ${ECHO} ${.TARGET} "->" $$path ; \
394 ln -fns $$path ${.TARGET}
396 # .depend needs include links so we remove them only together.
397 kernel-cleandepend: .PHONY
398 rm -f .depend .depend.* ${_ILINKS}
401 @ls .depend.* > /dev/null 2>&1 || \
402 { echo "you must make all first"; exit 1; }
403 sh $S/conf/systags.sh
405 kernel-install: .PHONY
406 @if [ ! -f ${KERNEL_KO} ] ; then \
407 echo "You must build a kernel first." ; \
410 .if exists(${DESTDIR}${KODIR})
411 -thiskernel=`sysctl -n kern.bootfile || echo /boot/kernel/kernel` ; \
412 if [ ! "`dirname "$$thiskernel"`" -ef ${DESTDIR}${KODIR} ] ; then \
413 chflags -R noschg ${DESTDIR}${KODIR} ; \
414 rm -rf ${DESTDIR}${KODIR} ; \
415 rm -rf ${DESTDIR}${KERN_DEBUGDIR}${KODIR} ; \
417 if [ -d ${DESTDIR}${KODIR}.old ] ; then \
418 chflags -R noschg ${DESTDIR}${KODIR}.old ; \
419 rm -rf ${DESTDIR}${KODIR}.old ; \
421 mv ${DESTDIR}${KODIR} ${DESTDIR}${KODIR}.old ; \
422 if [ -n "${KERN_DEBUGDIR}" -a \
423 -d ${DESTDIR}${KERN_DEBUGDIR}${KODIR} ]; then \
424 rm -rf ${DESTDIR}${KERN_DEBUGDIR}${KODIR}.old ; \
425 mv ${DESTDIR}${KERN_DEBUGDIR}${KODIR} ${DESTDIR}${KERN_DEBUGDIR}${KODIR}.old ; \
427 sysctl kern.bootfile=${DESTDIR}${KODIR}.old/"`basename "$$thiskernel"`" ; \
430 mkdir -p ${DESTDIR}${KODIR}
431 ${INSTALL} -p -m ${KMODMODE} -o ${KMODOWN} -g ${KMODGRP} ${KERNEL_KO} ${DESTDIR}${KODIR}/
432 .if defined(DEBUG) && !defined(INSTALL_NODEBUG) && ${MK_KERNEL_SYMBOLS} != "no"
433 mkdir -p ${DESTDIR}${KERN_DEBUGDIR}${KODIR}
434 ${INSTALL} -p -m ${KMODMODE} -o ${KMODOWN} -g ${KMODGRP} ${KERNEL_KO}.debug ${DESTDIR}${KERN_DEBUGDIR}${KODIR}/
436 .if defined(KERNEL_EXTRA_INSTALL)
437 ${INSTALL} -p -m ${KMODMODE} -o ${KMODOWN} -g ${KMODGRP} ${KERNEL_EXTRA_INSTALL} ${DESTDIR}${KODIR}/
443 @-chflags -R noschg ${DESTDIR}${KODIR}
444 ${INSTALL} -p -m ${KMODMODE} -o ${KMODOWN} -g ${KMODGRP} ${KERNEL_KO} ${DESTDIR}${KODIR}/
445 .if defined(DEBUG) && !defined(INSTALL_NODEBUG) && ${MK_KERNEL_SYMBOLS} != "no"
446 ${INSTALL} -p -m ${KMODMODE} -o ${KMODOWN} -g ${KMODGRP} ${KERNEL_KO}.debug ${DESTDIR}${KERN_DEBUGDIR}${KODIR}/
449 config.o env.o hints.o vers.o vnode_if.o:
453 NEWVERS_ENV+= MAKE="${MAKE}"
454 .if ${MK_REPRODUCIBLE_BUILD} != "no"
457 vers.c: .NOMETA_CMP $S/conf/newvers.sh $S/sys/param.h ${SYSTEM_DEP:Nvers.*}
458 ${NEWVERS_ENV} sh $S/conf/newvers.sh ${NEWVERS_ARGS} ${KERN_IDENT}
460 vnode_if.c: $S/tools/vnode_if.awk $S/kern/vnode_if.src
461 ${AWK} -f $S/tools/vnode_if.awk $S/kern/vnode_if.src -c
463 vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: $S/tools/vnode_if.awk \
465 vnode_if.h: vnode_if_newproto.h vnode_if_typedef.h
466 ${AWK} -f $S/tools/vnode_if.awk $S/kern/vnode_if.src -h
468 ${AWK} -f $S/tools/vnode_if.awk $S/kern/vnode_if.src -p
470 ${AWK} -f $S/tools/vnode_if.awk $S/kern/vnode_if.src -q
472 .if ${MFS_IMAGE:Uno} != "no"
473 .if empty(MD_ROOT_SIZE_CONFIGURED)
474 embedfs_${MFS_IMAGE:T:R}.o: ${MFS_IMAGE} $S/dev/md/embedfs.S
475 ${CC} ${CFLAGS} ${ACFLAGS} -DMFS_IMAGE=\""${MFS_IMAGE}"\" -c \
476 $S/dev/md/embedfs.S -o ${.TARGET}