kmod.mk revision 155275 
1#	From: @(#)bsd.prog.mk	5.26 (Berkeley) 6/25/91
2# $FreeBSD: head/sys/conf/kmod.mk 155275 2006-02-04 06:22:27Z imp $
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# FIRMWS	List of firmware images in format filename:shortname:version
40#
41# DESTDIR	The tree where the module gets installed. [not set]
42#
43# +++ targets +++
44#
45# 	install:
46#               install the kernel module; if the Makefile
47#               does not itself define the target install, the targets
48#               beforeinstall and afterinstall may also be used to cause
49#               actions immediately before and after the install target
50#		is executed.
51#
52# 	load:
53#		Load a module.
54#
55# 	unload:
56#		Unload a module.
57#
58
59AWK?=		awk
60KMODLOAD?=	/sbin/kldload
61KMODUNLOAD?=	/sbin/kldunload
62OBJCOPY?=	objcopy
63
64.if defined(KMODDEPS)
65.error "Do not use KMODDEPS on 5.0+; use MODULE_VERSION/MODULE_DEPEND"
66.endif
67
68.include <bsd.init.mk>
69
70.SUFFIXES: .out .o .c .cc .cxx .C .y .l .s .S
71
72.if ${CC} == "icc"
73CFLAGS:=	${CFLAGS:C/(-x[^M^K^W]+)[MKW]+|-x[MKW]+/\1/}
74.else
75. if !empty(CFLAGS:M-O[23s]) && empty(CFLAGS:M-fno-strict-aliasing)
76CFLAGS+=	-fno-strict-aliasing
77. endif
78WERROR?=	-Werror
79.endif
80CFLAGS+=	${WERROR}
81CFLAGS+=	-D_KERNEL
82CFLAGS+=	-DKLD_MODULE
83
84# Don't use any standard or source-relative include directories.
85.if ${CC} == "icc"
86NOSTDINC=	-X
87.else
88NOSTDINC=	-nostdinc
89.endif
90CFLAGS:=	${CFLAGS:N-I*} ${NOSTDINC} -I- ${INCLMAGIC} ${CFLAGS:M-I*}
91.if defined(KERNBUILDDIR)
92CFLAGS+=	-DHAVE_KERNEL_OPTION_HEADERS -include ${KERNBUILDDIR}/opt_global.h
93.endif
94
95# Add -I paths for system headers.  Individual module makefiles don't
96# need any -I paths for this.  Similar defaults for .PATH can't be
97# set because there are no standard paths for non-headers.
98CFLAGS+=	-I. -I@
99
100# Add -I path for altq headers as they are included via net/if_var.h
101# for example.
102CFLAGS+=	-I@/contrib/altq
103
104.if ${CC} != "icc"
105CFLAGS+=	-finline-limit=${INLINE_LIMIT}
106CFLAGS+= --param inline-unit-growth=100
107CFLAGS+= --param large-function-growth=1000
108.endif
109
110# Disallow common variables, and if we end up with commons from
111# somewhere unexpected, allocate storage for them in the module itself.
112.if ${CC} != "icc"
113CFLAGS+=	-fno-common
114.endif
115LDFLAGS+=	-d -warn-common
116
117CFLAGS+=	${DEBUG_FLAGS}
118.if ${MACHINE_ARCH} == amd64
119CFLAGS+=	-fno-omit-frame-pointer
120.endif
121
122.if ${MACHINE_ARCH} == "powerpc"
123CFLAGS+=	-mlongcall -fno-omit-frame-pointer
124.endif
125
126.if defined(FIRMWS)
127.if !exists(@)
128${KMOD:S/$/.c/}: @
129.else
130${KMOD:S/$/.c/}: @/tools/fw_stub.awk
131.endif
132	${AWK} -f @/tools/fw_stub.awk ${FIRMWS} -m${KMOD} -c${KMOD:S/$/.c/g}
133
134SRCS+=	${KMOD:S/$/.c/}
135CLEANFILES+=	${KMOD:S/$/.c/}
136
137.for _firmw in ${FIRMWS}
138${_firmw:C/\:.*$/.fwo/}:	${_firmw:C/\:.*$//}
139	@${ECHO} ${_firmw:C/\:.*$//} ${.ALLSRC:M*${_firmw:C/\:.*$//}}
140.if !exists(${.CURDIR}/${_firmw:C/\:.*$//})
141	ln -s ${.ALLSRC:M*${_firmw:C/\:.*$//}} ${_firmw:C/\:.*$//}
142	${LD} -b binary ${LDFLAGS} -r -d -o ${.TARGET} ${_firmw:C/\:.*$//}
143	rm -f ${_firmw:C/\:.*$//}
144.else
145	${LD} -b binary ${LDFLAGS} -r -d -o ${.TARGET} ${_firmw:C/\:.*$//}
146.endif
147
148OBJS+=	${_firmw:C/\:.*$/.fwo/}
149.endfor
150.endif
151
152OBJS+=	${SRCS:N*.h:R:S/$/.o/g}
153
154.if !defined(PROG)
155PROG=	${KMOD}.ko
156.endif
157
158.if !defined(DEBUG_FLAGS)
159FULLPROG=	${PROG}
160.else
161FULLPROG=	${PROG}.debug
162${PROG}: ${FULLPROG} ${PROG}.symbols
163	${OBJCOPY} --strip-debug --add-gnu-debuglink=${PROG}.symbols\
164	    ${FULLPROG} ${.TARGET}
165${PROG}.symbols: ${FULLPROG}
166	${OBJCOPY} --only-keep-debug ${FULLPROG} ${.TARGET}
167.endif
168
169.if ${MACHINE_ARCH} != amd64
170${FULLPROG}: ${KMOD}.kld
171	${LD} -Bshareable ${LDFLAGS} -o ${.TARGET} ${KMOD}.kld
172.if !defined(DEBUG_FLAGS)
173	${OBJCOPY} --strip-debug ${.TARGET}
174.endif
175.endif
176
177EXPORT_SYMS?=	NO
178.if ${EXPORT_SYMS} != YES
179CLEANFILES+=	export_syms
180.endif
181
182.if ${MACHINE_ARCH} != amd64
183${KMOD}.kld: ${OBJS}
184.else
185${FULLPROG}: ${OBJS}
186.endif
187	${LD} ${LDFLAGS} -r -d -o ${.TARGET} ${OBJS}
188.if defined(EXPORT_SYMS)
189.if ${EXPORT_SYMS} != YES
190.if ${EXPORT_SYMS} == NO
191	touch export_syms
192.elif !exists(${.CURDIR}/${EXPORT_SYMS})
193	echo ${EXPORT_SYMS} > export_syms
194.else
195	grep -v '^#' < ${EXPORT_SYMS} > export_syms
196.endif
197	awk -f ${SYSDIR}/conf/kmod_syms.awk ${.TARGET} \
198	    export_syms | xargs -J% ${OBJCOPY} % ${.TARGET}
199.endif
200.endif
201.if !defined(DEBUG_FLAGS) && ${MACHINE_ARCH} == amd64
202	${OBJCOPY} --strip-debug ${.TARGET}
203.endif
204
205_ILINKS=@ machine
206.if ${MACHINE} != ${MACHINE_ARCH}
207_ILINKS+=${MACHINE_ARCH}
208.endif
209
210all: objwarn ${PROG}
211
212beforedepend: ${_ILINKS}
213
214# Ensure that the links exist without depending on it when it exists which
215# causes all the modules to be rebuilt when the directory pointed to changes.
216.for _link in ${_ILINKS}
217.if !exists(${.OBJDIR}/${_link})
218${OBJS}: ${_link}
219.endif
220.endfor
221
222# Search for kernel source tree in standard places.
223.for _dir in ${.CURDIR}/../.. ${.CURDIR}/../../.. /sys /usr/src/sys
224.if !defined(SYSDIR) && exists(${_dir}/kern/)
225SYSDIR=	${_dir}
226.endif
227.endfor
228.if !defined(SYSDIR) || !exists(${SYSDIR}/kern/)
229.error "can't find kernel source tree"
230.endif
231
232${_ILINKS}:
233	@case ${.TARGET} in \
234	${MACHINE_ARCH}) \
235		path=${SYSDIR}/${MACHINE_ARCH}/include ;; \
236	machine) \
237		path=${SYSDIR}/${MACHINE}/include ;; \
238	@) \
239		path=${SYSDIR} ;; \
240	esac ; \
241	path=`(cd $$path && /bin/pwd)` ; \
242	${ECHO} ${.TARGET} "->" $$path ; \
243	ln -s $$path ${.TARGET}
244
245CLEANFILES+= ${PROG} ${KMOD}.kld ${OBJS} ${_ILINKS}
246
247.if defined(DEBUG_FLAGS)
248CLEANFILES+= ${FULLPROG} ${PROG}.symbols
249.endif
250
251.if !target(install)
252
253_INSTALLFLAGS:=	${INSTALLFLAGS}
254.for ie in ${INSTALLFLAGS_EDIT}
255_INSTALLFLAGS:=	${_INSTALLFLAGS${ie}}
256.endfor
257
258.if !target(realinstall)
259realinstall: _kmodinstall
260.ORDER: beforeinstall _kmodinstall
261_kmodinstall:
262	${INSTALL} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \
263	    ${_INSTALLFLAGS} ${PROG} ${DESTDIR}${KMODDIR}
264.if defined(DEBUG_FLAGS) && !defined(INSTALL_NODEBUG)
265	${INSTALL} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \
266	    ${_INSTALLFLAGS} ${PROG}.symbols ${DESTDIR}${KMODDIR}
267.endif
268
269.include <bsd.links.mk>
270
271.if !defined(NO_XREF)
272afterinstall: _kldxref
273.ORDER: realinstall _kldxref
274.ORDER: _installlinks _kldxref
275_kldxref:
276	@if type kldxref >/dev/null 2>&1; then \
277		${ECHO} kldxref ${DESTDIR}${KMODDIR}; \
278		kldxref ${DESTDIR}${KMODDIR}; \
279	fi
280.endif
281.endif # !target(realinstall)
282
283.endif # !target(install)
284
285.if !target(load)
286load: ${PROG}
287	${KMODLOAD} -v ${.OBJDIR}/${PROG}
288.endif
289
290.if !target(unload)
291unload:
292	${KMODUNLOAD} -v ${PROG}
293.endif
294
295.if defined(KERNBUILDDIR)
296.PATH: ${KERNBUILDDIR}
297CFLAGS+=	-I${KERNBUILDDIR}
298.for _src in ${SRCS:Mopt_*.h}
299CLEANFILES+=	${_src}
300.if !target(${_src})
301${_src}:
302	ln -s ${KERNBUILDDIR}/${_src} ${.TARGET}
303.endif
304.endfor
305.else
306.for _src in ${SRCS:Mopt_*.h}
307CLEANFILES+=	${_src}
308.if !target(${_src})
309${_src}:
310	touch ${.TARGET}
311.endif
312.endfor
313.endif
314
315MFILES?= dev/acpica/acpi_if.m dev/ata/ata_if.m dev/eisa/eisa_if.m \
316	dev/iicbus/iicbb_if.m dev/iicbus/iicbus_if.m \
317	dev/mii/miibus_if.m dev/ofw/ofw_bus_if.m \
318	dev/pccard/card_if.m dev/pccard/power_if.m dev/pci/pci_if.m \
319	dev/pci/pcib_if.m dev/ppbus/ppbus_if.m dev/smbus/smbus_if.m \
320	dev/sound/pcm/ac97_if.m dev/sound/pcm/channel_if.m \
321	dev/sound/pcm/feeder_if.m dev/sound/pcm/mixer_if.m dev/uart/uart_if.m \
322	dev/usb/usb_if.m isa/isa_if.m \
323	kern/bus_if.m kern/cpufreq_if.m kern/device_if.m \
324	libkern/iconv_converter_if.m opencrypto/crypto_if.m \
325	pc98/pc98/canbus_if.m pci/agp_if.m
326
327.for _srcsrc in ${MFILES}
328.for _ext in c h
329.for _src in ${SRCS:M${_srcsrc:T:R}.${_ext}}
330CLEANFILES+=	${_src}
331.if !target(${_src})
332.if !exists(@)
333${_src}: @
334.else
335${_src}: @/tools/makeobjops.awk @/${_srcsrc}
336.endif
337	${AWK} -f @/tools/makeobjops.awk @/${_srcsrc} -${_ext}
338.endif
339.endfor # _src
340.endfor # _ext
341.endfor # _srcsrc
342
343.if !empty(SRCS:Mvnode_if.c)
344CLEANFILES+=	vnode_if.c
345.if !exists(@)
346vnode_if.c: @
347.else
348vnode_if.c: @/tools/vnode_if.awk @/kern/vnode_if.src
349.endif
350	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -c
351.endif
352
353.if !empty(SRCS:Mvnode_if.h)
354CLEANFILES+=	vnode_if.h vnode_if_newproto.h vnode_if_typedef.h
355.if !exists(@)
356vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: @
357.else
358vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: @/tools/vnode_if.awk \
359    @/kern/vnode_if.src
360.endif
361vnode_if.h: vnode_if_newproto.h vnode_if_typedef.h
362	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -h
363vnode_if_newproto.h:
364	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -p
365vnode_if_typedef.h:
366	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -q
367.endif
368
369.for _i in mii pccard
370.if !empty(SRCS:M${_i}devs.h)
371CLEANFILES+=	${_i}devs.h
372.if !exists(@)
373${_i}devs.h: @
374.else
375${_i}devs.h: @/tools/${_i}devs2h.awk @/dev/${_i}/${_i}devs
376.endif
377	${AWK} -f @/tools/${_i}devs2h.awk @/dev/${_i}/${_i}devs
378.endif
379.endfor # _i
380
381.if !empty(SRCS:Musbdevs.h)
382CLEANFILES+=	usbdevs.h
383.if !exists(@)
384usbdevs.h: @
385.else
386usbdevs.h: @/tools/usbdevs2h.awk @/dev/usb/usbdevs
387.endif
388	${AWK} -f @/tools/usbdevs2h.awk @/dev/usb/usbdevs -h
389.endif
390
391.if !empty(SRCS:Musbdevs_data.h)
392CLEANFILES+=	usbdevs_data.h
393.if !exists(@)
394usbdevs_data.h: @
395.else
396usbdevs_data.h: @/tools/usbdevs2h.awk @/dev/usb/usbdevs
397.endif
398	${AWK} -f @/tools/usbdevs2h.awk @/dev/usb/usbdevs -d
399.endif
400
401.if !empty(SRCS:Macpi_quirks.h)
402CLEANFILES+=	acpi_quirks.h
403.if !exists(@)
404acpi_quirks.h: @
405.else
406acpi_quirks.h: @/tools/acpi_quirks2h.awk @/dev/acpica/acpi_quirks
407.endif
408	${AWK} -f @/tools/acpi_quirks2h.awk @/dev/acpica/acpi_quirks
409.endif
410
411.if !empty(SRCS:Massym.s)
412CLEANFILES+=	assym.s genassym.o
413assym.s: genassym.o
414.if !exists(@)
415assym.s: @
416.else
417assym.s: @/kern/genassym.sh
418.endif
419	sh @/kern/genassym.sh genassym.o > ${.TARGET}
420.if exists(@)
421genassym.o: @/${MACHINE_ARCH}/${MACHINE_ARCH}/genassym.c
422.endif
423genassym.o: @ machine ${SRCS:Mopt_*.h}
424	${CC} -c ${CFLAGS:N-fno-common} \
425	    @/${MACHINE_ARCH}/${MACHINE_ARCH}/genassym.c
426.endif
427
428lint: ${SRCS}
429	${LINT} ${LINTKERNFLAGS} ${CFLAGS:M-[DILU]*} ${.ALLSRC:M*.c}
430
431.include <bsd.dep.mk>
432
433.if !exists(${.OBJDIR}/${DEPENDFILE})
434${OBJS}: ${SRCS:M*.h}
435.endif
436
437.include <bsd.obj.mk>
438.include "kern.mk"
439