kmod.mk revision 154974 
1#	From: @(#)bsd.prog.mk	5.26 (Berkeley) 6/25/91
2# $FreeBSD: head/sys/conf/kmod.mk 154974 2006-01-29 02:52:42Z mlaier $
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}
106.endif
107
108# Disallow common variables, and if we end up with commons from
109# somewhere unexpected, allocate storage for them in the module itself.
110.if ${CC} != "icc"
111CFLAGS+=	-fno-common
112.endif
113LDFLAGS+=	-d -warn-common
114
115CFLAGS+=	${DEBUG_FLAGS}
116.if ${MACHINE_ARCH} == amd64
117CFLAGS+=	-fno-omit-frame-pointer
118.endif
119
120.if ${MACHINE_ARCH} == "powerpc"
121CFLAGS+=	-mlongcall -fno-omit-frame-pointer
122.endif
123
124.if defined(FIRMWS)
125.if !exists(@)
126${KMOD:S/$/.c/}: @
127.else
128${KMOD:S/$/.c/}: @/tools/fw_stub.awk
129.endif
130	${AWK} -f @/tools/fw_stub.awk ${FIRMWS} -m${KMOD} -c${KMOD:S/$/.c/g}
131
132SRCS+=	${KMOD:S/$/.c/}
133CLEANFILES+=	${KMOD:S/$/.c/}
134
135.for _firmw in ${FIRMWS}
136${_firmw:C/\:.*$/.fwo/}:	${_firmw:C/\:.*$//}
137	@${ECHO} ${_firmw:C/\:.*$//} ${.ALLSRC:M*${_firmw:C/\:.*$//}}
138.if !exists(${.CURDIR}/${_firmw:C/\:.*$//})
139	ln -s ${.ALLSRC:M*${_firmw:C/\:.*$//}} ${_firmw:C/\:.*$//}
140	${LD} -b binary ${LDFLAGS} -r -d -o ${.TARGET} ${_firmw:C/\:.*$//}
141	rm -f ${_firmw:C/\:.*$//}
142.else
143	${LD} -b binary ${LDFLAGS} -r -d -o ${.TARGET} ${_firmw:C/\:.*$//}
144.endif
145
146OBJS+=	${_firmw:C/\:.*$/.fwo/}
147.endfor
148.endif
149
150OBJS+=	${SRCS:N*.h:R:S/$/.o/g}
151
152.if !defined(PROG)
153PROG=	${KMOD}.ko
154.endif
155
156.if !defined(DEBUG_FLAGS)
157FULLPROG=	${PROG}
158.else
159FULLPROG=	${PROG}.debug
160${PROG}: ${FULLPROG} ${PROG}.symbols
161	${OBJCOPY} --strip-debug --add-gnu-debuglink=${PROG}.symbols\
162	    ${FULLPROG} ${.TARGET}
163${PROG}.symbols: ${FULLPROG}
164	${OBJCOPY} --only-keep-debug ${FULLPROG} ${.TARGET}
165.endif
166
167.if ${MACHINE_ARCH} != amd64
168${FULLPROG}: ${KMOD}.kld
169	${LD} -Bshareable ${LDFLAGS} -o ${.TARGET} ${KMOD}.kld
170.if !defined(DEBUG_FLAGS)
171	${OBJCOPY} --strip-debug ${.TARGET}
172.endif
173.endif
174
175EXPORT_SYMS?=	NO
176.if ${EXPORT_SYMS} != YES
177CLEANFILES+=	export_syms
178.endif
179
180.if ${MACHINE_ARCH} != amd64
181${KMOD}.kld: ${OBJS}
182.else
183${FULLPROG}: ${OBJS}
184.endif
185	${LD} ${LDFLAGS} -r -d -o ${.TARGET} ${OBJS}
186.if defined(EXPORT_SYMS)
187.if ${EXPORT_SYMS} != YES
188.if ${EXPORT_SYMS} == NO
189	touch export_syms
190.elif !exists(${.CURDIR}/${EXPORT_SYMS})
191	echo ${EXPORT_SYMS} > export_syms
192.else
193	grep -v '^#' < ${EXPORT_SYMS} > export_syms
194.endif
195	awk -f ${SYSDIR}/conf/kmod_syms.awk ${.TARGET} \
196	    export_syms | xargs -J% ${OBJCOPY} % ${.TARGET}
197.endif
198.endif
199.if !defined(DEBUG_FLAGS) && ${MACHINE_ARCH} == amd64
200	${OBJCOPY} --strip-debug ${.TARGET}
201.endif
202
203_ILINKS=@ machine
204.if ${MACHINE} != ${MACHINE_ARCH}
205_ILINKS+=${MACHINE_ARCH}
206.endif
207
208all: objwarn ${PROG}
209
210beforedepend: ${_ILINKS}
211
212# Ensure that the links exist without depending on it when it exists which
213# causes all the modules to be rebuilt when the directory pointed to changes.
214.for _link in ${_ILINKS}
215.if !exists(${.OBJDIR}/${_link})
216${OBJS}: ${_link}
217.endif
218.endfor
219
220# Search for kernel source tree in standard places.
221.for _dir in ${.CURDIR}/../.. ${.CURDIR}/../../.. /sys /usr/src/sys
222.if !defined(SYSDIR) && exists(${_dir}/kern/)
223SYSDIR=	${_dir}
224.endif
225.endfor
226.if !defined(SYSDIR) || !exists(${SYSDIR}/kern/)
227.error "can't find kernel source tree"
228.endif
229
230${_ILINKS}:
231	@case ${.TARGET} in \
232	${MACHINE_ARCH}) \
233		path=${SYSDIR}/${MACHINE_ARCH}/include ;; \
234	machine) \
235		path=${SYSDIR}/${MACHINE}/include ;; \
236	@) \
237		path=${SYSDIR} ;; \
238	esac ; \
239	path=`(cd $$path && /bin/pwd)` ; \
240	${ECHO} ${.TARGET} "->" $$path ; \
241	ln -s $$path ${.TARGET}
242
243CLEANFILES+= ${PROG} ${KMOD}.kld ${OBJS} ${_ILINKS}
244
245.if defined(DEBUG_FLAGS)
246CLEANFILES+= ${FULLPROG} ${PROG}.symbols
247.endif
248
249.if !target(install)
250
251_INSTALLFLAGS:=	${INSTALLFLAGS}
252.for ie in ${INSTALLFLAGS_EDIT}
253_INSTALLFLAGS:=	${_INSTALLFLAGS${ie}}
254.endfor
255
256.if !target(realinstall)
257realinstall: _kmodinstall
258.ORDER: beforeinstall _kmodinstall
259_kmodinstall:
260	${INSTALL} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \
261	    ${_INSTALLFLAGS} ${PROG} ${DESTDIR}${KMODDIR}
262.if defined(DEBUG_FLAGS) && !defined(INSTALL_NODEBUG)
263	${INSTALL} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \
264	    ${_INSTALLFLAGS} ${PROG}.symbols ${DESTDIR}${KMODDIR}
265.endif
266
267.include <bsd.links.mk>
268
269.if !defined(NO_XREF)
270afterinstall: _kldxref
271.ORDER: realinstall _kldxref
272.ORDER: _installlinks _kldxref
273_kldxref:
274	@if type kldxref >/dev/null 2>&1; then \
275		${ECHO} kldxref ${DESTDIR}${KMODDIR}; \
276		kldxref ${DESTDIR}${KMODDIR}; \
277	fi
278.endif
279.endif # !target(realinstall)
280
281.endif # !target(install)
282
283.if !target(load)
284load: ${PROG}
285	${KMODLOAD} -v ${.OBJDIR}/${PROG}
286.endif
287
288.if !target(unload)
289unload:
290	${KMODUNLOAD} -v ${PROG}
291.endif
292
293.if defined(KERNBUILDDIR)
294.PATH: ${KERNBUILDDIR}
295CFLAGS+=	-I${KERNBUILDDIR}
296.for _src in ${SRCS:Mopt_*.h}
297CLEANFILES+=	${_src}
298.if !target(${_src})
299${_src}:
300	ln -s ${KERNBUILDDIR}/${_src} ${.TARGET}
301.endif
302.endfor
303.else
304.for _src in ${SRCS:Mopt_*.h}
305CLEANFILES+=	${_src}
306.if !target(${_src})
307${_src}:
308	touch ${.TARGET}
309.endif
310.endfor
311.endif
312
313MFILES?= dev/acpica/acpi_if.m dev/ata/ata_if.m dev/eisa/eisa_if.m \
314	dev/iicbus/iicbb_if.m dev/iicbus/iicbus_if.m \
315	dev/mii/miibus_if.m dev/ofw/ofw_bus_if.m \
316	dev/pccard/card_if.m dev/pccard/power_if.m dev/pci/pci_if.m \
317	dev/pci/pcib_if.m dev/ppbus/ppbus_if.m dev/smbus/smbus_if.m \
318	dev/sound/pcm/ac97_if.m dev/sound/pcm/channel_if.m \
319	dev/sound/pcm/feeder_if.m dev/sound/pcm/mixer_if.m dev/uart/uart_if.m \
320	dev/usb/usb_if.m isa/isa_if.m \
321	kern/bus_if.m kern/cpufreq_if.m kern/device_if.m \
322	libkern/iconv_converter_if.m opencrypto/crypto_if.m \
323	pc98/pc98/canbus_if.m pci/agp_if.m
324
325.for _srcsrc in ${MFILES}
326.for _ext in c h
327.for _src in ${SRCS:M${_srcsrc:T:R}.${_ext}}
328CLEANFILES+=	${_src}
329.if !target(${_src})
330.if !exists(@)
331${_src}: @
332.else
333${_src}: @/tools/makeobjops.awk @/${_srcsrc}
334.endif
335	${AWK} -f @/tools/makeobjops.awk @/${_srcsrc} -${_ext}
336.endif
337.endfor # _src
338.endfor # _ext
339.endfor # _srcsrc
340
341.if !empty(SRCS:Mvnode_if.c)
342CLEANFILES+=	vnode_if.c
343.if !exists(@)
344vnode_if.c: @
345.else
346vnode_if.c: @/tools/vnode_if.awk @/kern/vnode_if.src
347.endif
348	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -c
349.endif
350
351.if !empty(SRCS:Mvnode_if.h)
352CLEANFILES+=	vnode_if.h vnode_if_newproto.h vnode_if_typedef.h
353.if !exists(@)
354vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: @
355.else
356vnode_if.h vnode_if_newproto.h vnode_if_typedef.h: @/tools/vnode_if.awk \
357    @/kern/vnode_if.src
358.endif
359vnode_if.h: vnode_if_newproto.h vnode_if_typedef.h
360	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -h
361vnode_if_newproto.h:
362	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -p
363vnode_if_typedef.h:
364	${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -q
365.endif
366
367.for _i in mii pccard
368.if !empty(SRCS:M${_i}devs.h)
369CLEANFILES+=	${_i}devs.h
370.if !exists(@)
371${_i}devs.h: @
372.else
373${_i}devs.h: @/tools/${_i}devs2h.awk @/dev/${_i}/${_i}devs
374.endif
375	${AWK} -f @/tools/${_i}devs2h.awk @/dev/${_i}/${_i}devs
376.endif
377.endfor # _i
378
379.if !empty(SRCS:Musbdevs.h)
380CLEANFILES+=	usbdevs.h
381.if !exists(@)
382usbdevs.h: @
383.else
384usbdevs.h: @/tools/usbdevs2h.awk @/dev/usb/usbdevs
385.endif
386	${AWK} -f @/tools/usbdevs2h.awk @/dev/usb/usbdevs -h
387.endif
388
389.if !empty(SRCS:Musbdevs_data.h)
390CLEANFILES+=	usbdevs_data.h
391.if !exists(@)
392usbdevs_data.h: @
393.else
394usbdevs_data.h: @/tools/usbdevs2h.awk @/dev/usb/usbdevs
395.endif
396	${AWK} -f @/tools/usbdevs2h.awk @/dev/usb/usbdevs -d
397.endif
398
399.if !empty(SRCS:Macpi_quirks.h)
400CLEANFILES+=	acpi_quirks.h
401.if !exists(@)
402acpi_quirks.h: @
403.else
404acpi_quirks.h: @/tools/acpi_quirks2h.awk @/dev/acpica/acpi_quirks
405.endif
406	${AWK} -f @/tools/acpi_quirks2h.awk @/dev/acpica/acpi_quirks
407.endif
408
409.if !empty(SRCS:Massym.s)
410CLEANFILES+=	assym.s genassym.o
411assym.s: genassym.o
412.if !exists(@)
413assym.s: @
414.else
415assym.s: @/kern/genassym.sh
416.endif
417	sh @/kern/genassym.sh genassym.o > ${.TARGET}
418.if exists(@)
419genassym.o: @/${MACHINE_ARCH}/${MACHINE_ARCH}/genassym.c
420.endif
421genassym.o: @ machine ${SRCS:Mopt_*.h}
422	${CC} -c ${CFLAGS:N-fno-common} \
423	    @/${MACHINE_ARCH}/${MACHINE_ARCH}/genassym.c
424.endif
425
426lint: ${SRCS}
427	${LINT} ${LINTKERNFLAGS} ${CFLAGS:M-[DILU]*} ${.ALLSRC:M*.c}
428
429.include <bsd.dep.mk>
430
431.if !exists(${.OBJDIR}/${DEPENDFILE})
432${OBJS}: ${SRCS:M*.h}
433.endif
434
435.include <bsd.obj.mk>
436.include "kern.mk"
437