kmod.mk revision 151750
135129Sjb#	From: @(#)bsd.prog.mk	5.26 (Berkeley) 6/25/91
235129Sjb# $FreeBSD: head/sys/conf/kmod.mk 151750 2005-10-27 17:39:03Z ru $
335129Sjb#
435129Sjb# The include file <bsd.kmod.mk> handles building and installing loadable
535129Sjb# kernel modules.
635129Sjb#
735129Sjb#
835129Sjb# +++ variables +++
935129Sjb#
1035129Sjb# CLEANFILES	Additional files to remove for the clean and cleandir targets.
1135129Sjb#
1235129Sjb# EXPORT_SYMS	A list of symbols that should be exported from the module,
13165968Simp#		or the name of a file containing a list of symbols, or YES
1435129Sjb#		to export all symbols.  If not defined, no symbols are
1535129Sjb#		exported.
1635129Sjb#
1735129Sjb# KMOD		The name of the kernel module to build.
1835129Sjb#
1935129Sjb# KMODDIR	Base path for kernel modules (see kld(4)). [/boot/kernel]
2035129Sjb#
2135129Sjb# KMODOWN	Module file owner. [${BINOWN}]
2235129Sjb#
2335129Sjb# KMODGRP	Module file group. [${BINGRP}]
2435129Sjb#
2535129Sjb# KMODMODE	Module file mode. [${BINMODE}]
2635129Sjb#
2735129Sjb# KMODLOAD	Command to load a kernel module [/sbin/kldload]
2835129Sjb#
2935129Sjb# KMODUNLOAD	Command to unload a kernel module [/sbin/kldunload]
3072373Sdeischen#
3172373Sdeischen# MFILES	Optionally a list of interfaces used by the module.
3272373Sdeischen#		This file contains a default list of interfaces.
3372373Sdeischen#
3472373Sdeischen# PROG		The name of the kernel module to build.
3572373Sdeischen#		If not supplied, ${KMOD}.ko is used.
3672373Sdeischen#
3792986Sobrien# SRCS		List of source files.
3892986Sobrien#
3992986Sobrien# DESTDIR	The tree where the module gets installed. [not set]
4072373Sdeischen#
4135129Sjb# +++ targets +++
4272373Sdeischen#
4372373Sdeischen# 	install:
4472373Sdeischen#               install the kernel module; if the Makefile
4572373Sdeischen#               does not itself define the target install, the targets
4635129Sjb#               beforeinstall and afterinstall may also be used to cause
4773254Sdeischen#               actions immediately before and after the install target
4873254Sdeischen#		is executed.
4973254Sdeischen#
5035129Sjb# 	load:
5172373Sdeischen#		Load a module.
5235129Sjb#
5375368Sdeischen# 	unload:
5475368Sdeischen#		Unload a module.
5575368Sdeischen#
5675368Sdeischen
5735129SjbAWK?=		awk
58291336SngieKMODLOAD?=	/sbin/kldload
59291336SngieKMODUNLOAD?=	/sbin/kldunload
60291336SngieOBJCOPY?=	objcopy
6135129Sjb
6272373Sdeischen.if defined(KMODDEPS)
6335129Sjb.error "Do not use KMODDEPS on 5.0+; use MODULE_VERSION/MODULE_DEPEND"
6472373Sdeischen.endif
6572373Sdeischen
66178287Sjhb.include <bsd.init.mk>
67178287Sjhb
6873254Sdeischen.SUFFIXES: .out .o .c .cc .cxx .C .y .l .s .S
6973254Sdeischen
7073254Sdeischen.if ${CC} == "icc"
7173254SdeischenCFLAGS:=	${CFLAGS:C/(-x[^M^K^W]+)[MKW]+|-x[MKW]+/\1/}
7273254Sdeischen.else
73178287Sjhb. if !empty(CFLAGS:M-O[23s]) && empty(CFLAGS:M-fno-strict-aliasing)
74178287SjhbCFLAGS+=	-fno-strict-aliasing
75178287Sjhb. endif
7672373SdeischenWERROR?=	-Werror
7735129Sjb.endif
7835129SjbCFLAGS+=	${WERROR}
7935129SjbCFLAGS+=	-D_KERNEL
8072373SdeischenCFLAGS+=	-DKLD_MODULE
8135129Sjb
8235129Sjb# Don't use any standard or source-relative include directories.
8335129Sjb.if ${CC} == "icc"
8435129SjbNOSTDINC=	-X
8572373Sdeischen.else
8635129SjbNOSTDINC=	-nostdinc
8735129Sjb.endif
8835129SjbCFLAGS:=	${CFLAGS:N-I*} ${NOSTDINC} -I- ${INCLMAGIC} ${CFLAGS:M-I*}
8972373Sdeischen.if defined(KERNBUILDDIR)
9035129SjbCFLAGS+=	-DHAVE_KERNEL_OPTION_HEADERS -include ${KERNBUILDDIR}/opt_global.h
9172373Sdeischen.endif
9272373Sdeischen
9372373Sdeischen# Add -I paths for system headers.  Individual module makefiles don't
94178287Sjhb# need any -I paths for this.  Similar defaults for .PATH can't be
95178287Sjhb# set because there are no standard paths for non-headers.
9672373SdeischenCFLAGS+=	-I. -I@
9773254Sdeischen
9873254Sdeischen# Add -I path for altq headers as they are included via net/if_var.h
9972373Sdeischen# for example.
100178287SjhbCFLAGS+=	-I@/contrib/altq
101178287Sjhb
102178287Sjhb# Add a -I path to standard headers like <stddef.h>.  Use a relative
10372373Sdeischen# path to src/include if possible.  If the @ symlink hasn't been built
10472373Sdeischen# yet, then we can't tell if the relative path exists.  Add both the
10572373Sdeischen# potential relative path and an absolute path in that case.
10672373Sdeischen.if exists(@)
10735129Sjb.if exists(@/../include)
10835129SjbCFLAGS+=	-I@/../include
10972373Sdeischen.else
11072373SdeischenCFLAGS+=	-I${DESTDIR}/usr/include
11135129Sjb.endif
11272373Sdeischen.else # !@
11372373SdeischenCFLAGS+=	-I@/../include -I${DESTDIR}/usr/include
11472373Sdeischen.endif # @
11573254Sdeischen
11672373Sdeischen.if ${CC} != "icc"
117178287SjhbCFLAGS+=	-finline-limit=${INLINE_LIMIT}
11872373Sdeischen.endif
11972373Sdeischen
12072373Sdeischen# Disallow common variables, and if we end up with commons from
12172373Sdeischen# somewhere unexpected, allocate storage for them in the module itself.
122178287Sjhb.if ${CC} != "icc"
12372373SdeischenCFLAGS+=	-fno-common
12472373Sdeischen.endif
12572373SdeischenLDFLAGS+=	-d -warn-common
12672373Sdeischen
12772373SdeischenCFLAGS+=	${DEBUG_FLAGS}
128178287Sjhb.if ${MACHINE_ARCH} == amd64
12972373SdeischenCFLAGS+=	-fno-omit-frame-pointer
13072373Sdeischen.endif
13172373Sdeischen
13272373Sdeischen.if ${MACHINE_ARCH} == "powerpc"
13372373SdeischenCFLAGS+=	-mlongcall -fno-omit-frame-pointer
134178287Sjhb.endif
135178287Sjhb
136178287SjhbOBJS+=	${SRCS:N*.h:R:S/$/.o/g}
13772373Sdeischen
13872373Sdeischen.if !defined(PROG)
13935129SjbPROG=	${KMOD}.ko
140.endif
141
142.if !defined(DEBUG_FLAGS)
143FULLPROG=	${PROG}
144.else
145FULLPROG=	${PROG}.debug
146${PROG}: ${FULLPROG} ${PROG}.symbols
147	${OBJCOPY} --strip-debug --add-gnu-debuglink=${PROG}.symbols\
148	    ${FULLPROG} ${.TARGET}
149${PROG}.symbols: ${FULLPROG}
150	${OBJCOPY} --only-keep-debug ${FULLPROG} ${.TARGET}
151.endif
152
153.if ${MACHINE_ARCH} != amd64
154${FULLPROG}: ${KMOD}.kld
155	${LD} -Bshareable ${LDFLAGS} -o ${.TARGET} ${KMOD}.kld
156.if !defined(DEBUG_FLAGS)
157	${OBJCOPY} --strip-debug ${.TARGET}
158.endif
159.endif
160
161EXPORT_SYMS?=	NO
162.if ${EXPORT_SYMS} != YES
163CLEANFILES+=	export_syms
164.endif
165
166.if ${MACHINE_ARCH} != amd64
167${KMOD}.kld: ${OBJS}
168.else
169${FULLPROG}: ${OBJS}
170.endif
171	${LD} ${LDFLAGS} -r -d -o ${.TARGET} ${OBJS}
172.if defined(EXPORT_SYMS)
173.if ${EXPORT_SYMS} != YES
174.if ${EXPORT_SYMS} == NO
175	touch export_syms
176.elif !exists(${.CURDIR}/${EXPORT_SYMS})
177	echo ${EXPORT_SYMS} > export_syms
178.else
179	grep -v '^#' < ${EXPORT_SYMS} > export_syms
180.endif
181	awk -f ${SYSDIR}/conf/kmod_syms.awk ${.TARGET} \
182	    export_syms | xargs -J% ${OBJCOPY} % ${.TARGET}
183.endif
184.endif
185.if !defined(DEBUG_FLAGS) && ${MACHINE_ARCH} == amd64
186	${OBJCOPY} --strip-debug ${.TARGET}
187.endif
188
189_ILINKS=@ machine
190.if ${MACHINE} != ${MACHINE_ARCH}
191_ILINKS+=${MACHINE_ARCH}
192.endif
193
194all: objwarn ${PROG}
195
196beforedepend: ${_ILINKS}
197
198# Ensure that the links exist without depending on it when it exists which
199# causes all the modules to be rebuilt when the directory pointed to changes.
200.for _link in ${_ILINKS}
201.if !exists(${.OBJDIR}/${_link})
202${OBJS}: ${_link}
203.endif
204.endfor
205
206# Search for kernel source tree in standard places.
207.for _dir in ${.CURDIR}/../.. ${.CURDIR}/../../.. /sys /usr/src/sys
208.if !defined(SYSDIR) && exists(${_dir}/kern/)
209SYSDIR=	${_dir}
210.endif
211.endfor
212.if !defined(SYSDIR) || !exists(${SYSDIR}/kern/)
213.error "can't find kernel source tree"
214.endif
215
216${_ILINKS}:
217	@case ${.TARGET} in \
218	${MACHINE_ARCH}) \
219		path=${SYSDIR}/${MACHINE_ARCH}/include ;; \
220	machine) \
221		path=${SYSDIR}/${MACHINE}/include ;; \
222	@) \
223		path=${SYSDIR} ;; \
224	esac ; \
225	path=`(cd $$path && /bin/pwd)` ; \
226	${ECHO} ${.TARGET} "->" $$path ; \
227	ln -s $$path ${.TARGET}
228
229CLEANFILES+= ${PROG} ${KMOD}.kld ${OBJS} ${_ILINKS}
230
231.if defined(DEBUG_FLAGS)
232CLEANFILES+= ${FULLPROG} ${PROG}.symbols
233.endif
234
235.if !target(install)
236
237_INSTALLFLAGS:=	${INSTALLFLAGS}
238.for ie in ${INSTALLFLAGS_EDIT}
239_INSTALLFLAGS:=	${_INSTALLFLAGS${ie}}
240.endfor
241
242.if !target(realinstall)
243realinstall: _kmodinstall
244.ORDER: beforeinstall _kmodinstall
245_kmodinstall:
246	${INSTALL} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \
247	    ${_INSTALLFLAGS} ${PROG} ${DESTDIR}${KMODDIR}
248.if defined(DEBUG_FLAGS) && !defined(INSTALL_NODEBUG)
249	${INSTALL} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \
250	    ${_INSTALLFLAGS} ${PROG}.symbols ${DESTDIR}${KMODDIR}
251.endif
252
253.include <bsd.links.mk>
254
255.if !defined(NO_XREF)
256afterinstall: _kldxref
257.ORDER: realinstall _kldxref
258.ORDER: _installlinks _kldxref
259_kldxref:
260	@if type kldxref >/dev/null 2>&1; then \
261		${ECHO} kldxref ${DESTDIR}${KMODDIR}; \
262		kldxref ${DESTDIR}${KMODDIR}; \
263	fi
264.endif
265.endif # !target(realinstall)
266
267.endif # !target(install)
268
269.if !target(load)
270load: ${PROG}
271	${KMODLOAD} -v ${.OBJDIR}/${PROG}
272.endif
273
274.if !target(unload)
275unload:
276	${KMODUNLOAD} -v ${PROG}
277.endif
278
279.if defined(KERNBUILDDIR)
280.PATH: ${KERNBUILDDIR}
281CFLAGS+=	-I${KERNBUILDDIR}
282.for _src in ${SRCS:Mopt_*.h}
283CLEANFILES+=	${_src}
284.if !target(${_src})
285${_src}:
286	ln -s ${KERNBUILDDIR}/${_src} ${.TARGET}
287.endif
288.endfor
289.else
290.for _src in ${SRCS:Mopt_*.h}
291CLEANFILES+=	${_src}
292.if !target(${_src})
293${_src}:
294	touch ${.TARGET}
295.endif
296.endfor
297.endif
298
299MFILES?= dev/acpica/acpi_if.m dev/ata/ata_if.m dev/eisa/eisa_if.m \
300	dev/iicbus/iicbb_if.m dev/iicbus/iicbus_if.m \
301	dev/mii/miibus_if.m dev/ofw/ofw_bus_if.m \
302	dev/pccard/card_if.m dev/pccard/power_if.m dev/pci/pci_if.m \
303	dev/pci/pcib_if.m dev/ppbus/ppbus_if.m dev/smbus/smbus_if.m \
304	dev/sound/pcm/ac97_if.m dev/sound/pcm/channel_if.m \
305	dev/sound/pcm/feeder_if.m dev/sound/pcm/mixer_if.m dev/uart/uart_if.m \
306	dev/usb/usb_if.m isa/isa_if.m \
307	kern/bus_if.m kern/cpufreq_if.m kern/device_if.m \
308	libkern/iconv_converter_if.m opencrypto/crypto_if.m \
309	pc98/pc98/canbus_if.m pci/agp_if.m
310
311.for _srcsrc in ${MFILES}
312.for _ext in c h
313.for _src in ${SRCS:M${_srcsrc:T:R}.${_ext}}
314CLEANFILES+=	${_src}
315.if !target(${_src})
316.if !exists(@)
317${_src}: @
318.else
319${_src}: @/tools/makeobjops.awk @/${_srcsrc}
320.endif
321	${AWK} -f @/tools/makeobjops.awk @/${_srcsrc} -${_ext}
322.endif
323.endfor # _src
324.endfor # _ext
325.endfor # _srcsrc
326
327.if !empty(SRCS:Mvnode_if.c)
328CLEANFILES+=	vnode_if.c
329.if !exists(@)
330vnode_if.c: @
331.else
332vnode_if.c: @/tools/vnode_if.awk @/kern/vnode_if.src
333.endif
334	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -c
335.endif
336
337.if !empty(SRCS:Mvnode_if.h)
338CLEANFILES+=	vnode_if.h vnode_if_newproto.h vnode_if_typedef.h
339.if !exists(@)
340vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: @
341.else
342vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: @/tools/vnode_if.awk \
343    @/kern/vnode_if.src
344.endif
345vnode_if.h: vnode_if_newproto.h vnode_if_typedef.h
346	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -h
347vnode_if_newproto.h:
348	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -p
349vnode_if_typedef.h:
350	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -q
351.endif
352
353.for _i in mii pccard
354.if !empty(SRCS:M${_i}devs.h)
355CLEANFILES+=	${_i}devs.h
356.if !exists(@)
357${_i}devs.h: @
358.else
359${_i}devs.h: @/tools/${_i}devs2h.awk @/dev/${_i}/${_i}devs
360.endif
361	${AWK} -f @/tools/${_i}devs2h.awk @/dev/${_i}/${_i}devs
362.endif
363.endfor # _i
364
365.if !empty(SRCS:Musbdevs.h)
366CLEANFILES+=	usbdevs.h
367.if !exists(@)
368usbdevs.h: @
369.else
370usbdevs.h: @/tools/usbdevs2h.awk @/dev/usb/usbdevs
371.endif
372	${AWK} -f @/tools/usbdevs2h.awk @/dev/usb/usbdevs -h
373.endif
374
375.if !empty(SRCS:Musbdevs_data.h)
376CLEANFILES+=	usbdevs_data.h
377.if !exists(@)
378usbdevs_data.h: @
379.else
380usbdevs_data.h: @/tools/usbdevs2h.awk @/dev/usb/usbdevs
381.endif
382	${AWK} -f @/tools/usbdevs2h.awk @/dev/usb/usbdevs -d
383.endif
384
385.if !empty(SRCS:Macpi_quirks.h)
386CLEANFILES+=	acpi_quirks.h
387.if !exists(@)
388acpi_quirks.h: @
389.else
390acpi_quirks.h: @/tools/acpi_quirks2h.awk @/dev/acpica/acpi_quirks
391.endif
392	${AWK} -f @/tools/acpi_quirks2h.awk @/dev/acpica/acpi_quirks
393.endif
394
395.if !empty(SRCS:Massym.s)
396CLEANFILES+=	assym.s genassym.o
397assym.s: genassym.o
398.if !exists(@)
399assym.s: @
400.else
401assym.s: @/kern/genassym.sh
402.endif
403	sh @/kern/genassym.sh genassym.o > ${.TARGET}
404.if exists(@)
405genassym.o: @/${MACHINE_ARCH}/${MACHINE_ARCH}/genassym.c
406.endif
407genassym.o: @ machine ${SRCS:Mopt_*.h}
408	${CC} -c ${CFLAGS:N-fno-common} \
409	    @/${MACHINE_ARCH}/${MACHINE_ARCH}/genassym.c
410.endif
411
412lint: ${SRCS}
413	${LINT} ${LINTKERNFLAGS} ${CFLAGS:M-[DILU]*} ${.ALLSRC:M*.c}
414
415.include <bsd.dep.mk>
416
417.if !exists(${.OBJDIR}/${DEPENDFILE})
418${OBJS}: ${SRCS:M*.h}
419.endif
420
421.include <bsd.obj.mk>
422.include "kern.mk"
423