kmod.mk revision 151731 
1#	From: @(#)bsd.prog.mk	5.26 (Berkeley) 6/25/91
2# $FreeBSD: head/sys/conf/kmod.mk 151731 2005-10-27 14:24:45Z ru $
3#
4# The include file <bsd.kmod.mk> handles building and installing loadable
5# kernel modules.
6#
7#
8# +++ variables +++
9#
10# CLEANFILES	Additional files to remove for the clean and cleandir targets.
11#
12# EXPORT_SYMS	A list of symbols that should be exported from the module,
13#		or the name of a file containing a list of symbols, or YES
14#		to export all symbols.  If not defined, no symbols are
15#		exported.
16#
17# KMOD		The name of the kernel module to build.
18#
19# KMODDIR	Base path for kernel modules (see kld(4)). [/boot/kernel]
20#
21# KMODOWN	Module file owner. [${BINOWN}]
22#
23# KMODGRP	Module file group. [${BINGRP}]
24#
25# KMODMODE	Module file mode. [${BINMODE}]
26#
27# KMODLOAD	Command to load a kernel module [/sbin/kldload]
28#
29# KMODUNLOAD	Command to unload a kernel module [/sbin/kldunload]
30#
31# MFILES	Optionally a list of interfaces used by the module.
32#		This file contains a default list of interfaces.
33#
34# PROG		The name of the kernel module to build.
35#		If not supplied, ${KMOD}.ko is used.
36#
37# SRCS		List of source files.
38#
39# DESTDIR	The tree where the module gets installed. [not set]
40#
41# +++ targets +++
42#
43# 	install:
44#               install the kernel module; if the Makefile
45#               does not itself define the target install, the targets
46#               beforeinstall and afterinstall may also be used to cause
47#               actions immediately before and after the install target
48#		is executed.
49#
50# 	load:
51#		Load a module.
52#
53# 	unload:
54#		Unload a module.
55#
56
57AWK?=		awk
58KMODLOAD?=	/sbin/kldload
59KMODUNLOAD?=	/sbin/kldunload
60OBJCOPY?=	objcopy
61
62.if defined(KMODDEPS)
63.error "Do not use KMODDEPS on 5.0+; use MODULE_VERSION/MODULE_DEPEND"
64.endif
65
66.include <bsd.init.mk>
67
68.SUFFIXES: .out .o .c .cc .cxx .C .y .l .s .S
69
70.if ${CC} == "icc"
71CFLAGS:=	${CFLAGS:C/(-x[^M^K^W]+)[MKW]+|-x[MKW]+/\1/}
72.else
73. if !empty(CFLAGS:M-O[23s]) && empty(CFLAGS:M-fno-strict-aliasing)
74CFLAGS+=	-fno-strict-aliasing
75. endif
76WERROR?=	-Werror
77.endif
78CFLAGS+=	${WERROR}
79CFLAGS+=	-D_KERNEL
80CFLAGS+=	-DKLD_MODULE
81
82# Don't use any standard or source-relative include directories.
83.if ${CC} == "icc"
84NOSTDINC=	-X
85.else
86NOSTDINC=	-nostdinc
87.endif
88CFLAGS:=	${CFLAGS:N-I*} ${NOSTDINC} -I- ${INCLMAGIC} ${CFLAGS:M-I*}
89.if defined(KERNBUILDDIR)
90CFLAGS+=	-DHAVE_KERNEL_OPTION_HEADERS -include ${KERNBUILDDIR}/opt_global.h
91.endif
92
93# Add -I paths for system headers.  Individual module makefiles don't
94# need any -I paths for this.  Similar defaults for .PATH can't be
95# set because there are no standard paths for non-headers.
96CFLAGS+=	-I. -I@
97
98# Add -I path for altq headers as they are included via net/if_var.h
99# for example.
100CFLAGS+=	-I@/contrib/altq
101
102# Add a -I path to standard headers like <stddef.h>.  Use a relative
103# path to src/include if possible.  If the @ symlink hasn't been built
104# yet, then we can't tell if the relative path exists.  Add both the
105# potential relative path and an absolute path in that case.
106.if exists(@)
107.if exists(@/../include)
108CFLAGS+=	-I@/../include
109.else
110CFLAGS+=	-I${DESTDIR}/usr/include
111.endif
112.else # !@
113CFLAGS+=	-I@/../include -I${DESTDIR}/usr/include
114.endif # @
115
116.if ${CC} != "icc"
117CFLAGS+=	-finline-limit=${INLINE_LIMIT}
118.endif
119
120# Disallow common variables, and if we end up with commons from
121# somewhere unexpected, allocate storage for them in the module itself.
122.if ${CC} != "icc"
123CFLAGS+=	-fno-common
124.endif
125LDFLAGS+=	-d -warn-common
126
127CFLAGS+=	${DEBUG_FLAGS}
128.if ${MACHINE_ARCH} == amd64
129CFLAGS+=	-fno-omit-frame-pointer
130.endif
131
132.if ${MACHINE_ARCH} == "powerpc"
133CFLAGS+=	-mlongcall -fno-omit-frame-pointer
134.endif
135
136OBJS+=	${SRCS:N*.h:R:S/$/.o/g}
137
138.if !defined(PROG)
139PROG=	${KMOD}.ko
140.endif
141
142.if !defined(DEBUG_FLAGS)
143FULLPROG=	${PROG}
144.else
145FULLPROG=	${PROG}.debug
146${PROG}: ${FULLPROG} ${PROG}.dbg
147	${OBJCOPY} --strip-debug --add-gnu-debuglink=${PROG}.dbg\
148	    ${FULLPROG} ${.TARGET}
149${PROG}.dbg: ${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}.dbg
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}.dbg ${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