kmod.mk revision 95356
1# From: @(#)bsd.prog.mk 5.26 (Berkeley) 6/25/91 2# $FreeBSD: head/sys/conf/kmod.mk 95356 2002-04-24 11:26:19Z ru $ 3# 4# The include file <bsd.kmod.mk> handles installing Kernel Loadable Device 5# drivers (KLD's). 6# 7# 8# +++ variables +++ 9# 10# CLEANFILES Additional files to remove for the clean and cleandir targets. 11# 12# DISTRIBUTION Name of distribution. [bin] 13# 14# KMOD The name of the kernel module to build. 15# 16# KMODDIR Base path for kernel modules (see kld(4)). [/boot/kernel] 17# 18# KMODOWN KLD owner. [${BINOWN}] 19# 20# KMODGRP KLD group. [${BINGRP}] 21# 22# KMODMODE KLD mode. [${BINMODE}] 23# 24# LINKS The list of KLD links; should be full pathnames, the 25# linked-to file coming first, followed by the linked 26# file. The files are hard-linked. For example, to link 27# /modules/master and /modules/meister, use: 28# 29# LINKS= /modules/master /modules/meister 30# 31# KMODLOAD Command to load a kernel module [/sbin/kldload] 32# 33# KMODUNLOAD Command to unload a kernel module [/sbin/kldunload] 34# 35# PROG The name of the kernel module to build. 36# If not supplied, ${KMOD}.o is used. 37# 38# SRCS List of source files 39# 40# SUBDIR A list of subdirectories that should be built as well. 41# Each of the targets will execute the same target in the 42# subdirectories. 43# 44# SYMLINKS Same as LINKS, except it creates symlinks and the 45# linked-to pathname may be relative. 46# 47# DESTDIR, DISTDIR are set by other Makefiles (e.g. bsd.own.mk) 48# 49# MFILES Optionally a list of interfaces used by the module. 50# This file contains a default list of interfaces. 51# 52# EXPORT_SYMS A list of symbols that should be exported from the module, 53# or the name of a file containing a list of symbols, or YES 54# to export all symbols. If not defined, no symbols are 55# exported. 56# 57# +++ targets +++ 58# 59# distribute: 60# This is a variant of install, which will 61# put the stuff into the right "distribution". 62# 63# install: 64# install the kernel module; if the Makefile 65# does not itself define the target install, the targets 66# beforeinstall and afterinstall may also be used to cause 67# actions immediately before and after the install target 68# is executed. 69# 70# load: 71# Load KLD. 72# 73# unload: 74# Unload KLD. 75# 76# bsd.obj.mk: clean, cleandir and obj 77# bsd.dep.mk: cleandepend, depend and tags 78# 79 80AWK?= awk 81KMODLOAD?= /sbin/kldload 82KMODUNLOAD?= /sbin/kldunload 83OBJCOPY?= objcopy 84 85.include <bsd.init.mk> 86 87.SUFFIXES: .out .o .c .cc .cxx .C .y .l .s .S 88 89CFLAGS+= ${COPTS} -D_KERNEL ${CWARNFLAGS} 90CFLAGS+= -DKLD_MODULE 91 92# Don't use any standard or source-relative include directories. 93# Since -nostdinc will annull any previous -I paths, we repeat all 94# such paths after -nostdinc. It doesn't seem to be possible to 95# add to the front of `make' variable. 96_ICFLAGS:= ${CFLAGS:M-I*} 97CFLAGS+= -nostdinc -I- ${INCLMAGIC} ${_ICFLAGS} 98 99# Add -I paths for system headers. Individual KLD makefiles don't 100# need any -I paths for this. Similar defaults for .PATH can't be 101# set because there are no standard paths for non-headers. 102CFLAGS+= -I. -I@ -I@/dev 103 104# Add a -I path to standard headers like <stddef.h>. Use a relative 105# path to src/include if possible. If the @ symlink hasn't been built 106# yet, then we can't tell if the relative path exists. Add both the 107# potential relative path and an absolute path in that case. 108.if exists(@) 109.if exists(@/../include) 110CFLAGS+= -I@/../include 111.else 112CFLAGS+= -I${DESTDIR}/usr/include 113.endif 114.else # !@ 115CFLAGS+= -I@/../include -I${DESTDIR}/usr/include 116.endif # @ 117 118# Disallow common variables, and if we end up with commons from 119# somewhere unexpected, allocate storage for them in the module itself. 120CFLAGS+= -fno-common 121LDFLAGS+= -d -warn-common 122 123CFLAGS+= ${DEBUG_FLAGS} 124 125.if ${OBJFORMAT} == elf 126CLEANFILES+= setdef0.c setdef1.c setdefs.h 127CLEANFILES+= setdef0.o setdef1.o 128.endif 129 130OBJS+= ${SRCS:N*.h:R:S/$/.o/g} 131 132.if !defined(PROG) 133PROG= ${KMOD}.ko 134.endif 135 136.if !defined(DEBUG) 137FULLPROG= ${PROG} 138.else 139FULLPROG= ${PROG}.debug 140${PROG}: ${FULLPROG} 141 ${OBJCOPY} --strip-debug ${FULLPROG} ${PROG} 142.endif 143 144${FULLPROG}: ${KMOD}.kld 145 ${LD} -Bshareable ${LDFLAGS} -o ${.TARGET} ${KMOD}.kld 146 147EXPORT_SYMS?= NO 148.if ${EXPORT_SYMS} != YES 149CLEANFILES+= ${.OBJDIR}/export_syms 150.endif 151 152${KMOD}.kld: ${OBJS} 153 ${LD} ${LDFLAGS} -r -d -o ${.TARGET} ${OBJS} 154.if defined(EXPORT_SYMS) 155.if ${EXPORT_SYMS} != YES 156.if ${EXPORT_SYMS} == NO 157 touch ${.OBJDIR}/export_syms 158.elif !exists(${.CURDIR}/${EXPORT_SYMS}) 159 echo ${EXPORT_SYMS} > ${.OBJDIR}/export_syms 160.else 161 grep -v '^#' < ${EXPORT_SYMS} > ${.OBJDIR}/export_syms 162.endif 163 awk -f ${SYSDIR}/conf/kmod_syms.awk ${.TARGET} \ 164 ${.OBJDIR}/export_syms | \ 165 xargs -J% ${OBJCOPY} % ${.TARGET} 166.endif 167.endif 168 169 170_ILINKS=@ machine 171 172all: objwarn ${PROG} 173 174beforedepend: ${_ILINKS} 175 @rm -f .depend 176 177# Ensure that the links exist without depending on it when it exists which 178# causes all the modules to be rebuilt when the directory pointed to changes. 179.for _link in ${_ILINKS} 180.if !exists(${.OBJDIR}/${_link}) 181${OBJS}: ${_link} 182.endif 183.endfor 184 185# Search for kernel source tree in standard places. 186.for _dir in ${.CURDIR}/../.. ${.CURDIR}/../../.. /sys /usr/src/sys 187.if !defined(SYSDIR) && exists(${_dir}/kern/) 188SYSDIR= ${_dir} 189.endif 190.endfor 191.if !defined(SYSDIR) || !exists(${SYSDIR}/kern) 192.error "can't find kernel source tree" 193.endif 194 195${_ILINKS}: 196 @case ${.TARGET} in \ 197 machine) \ 198 path=${SYSDIR}/${MACHINE_ARCH}/include ;; \ 199 @) \ 200 path=${SYSDIR} ;; \ 201 esac ; \ 202 path=`(cd $$path && /bin/pwd)` ; \ 203 ${ECHO} ${.TARGET} "->" $$path ; \ 204 ln -s $$path ${.TARGET} 205 206CLEANFILES+= ${PROG} ${FULLPROG} ${KMOD}.kld ${OBJS} ${_ILINKS} symb.tmp tmp.o 207 208.if !target(install) 209.if !target(beforeinstall) 210beforeinstall: 211.endif 212.if !target(afterinstall) 213afterinstall: 214.endif 215 216_INSTALLFLAGS:= ${INSTALLFLAGS} 217.for ie in ${INSTALLFLAGS_EDIT} 218_INSTALLFLAGS:= ${_INSTALLFLAGS${ie}} 219.endfor 220 221.if defined(DEBUG) 222install.debug: 223 cd ${.CURDIR}; ${MAKE} -DINSTALL_DEBUG install 224.endif 225 226realinstall: 227.if defined(DEBUG) && defined(INSTALL_DEBUG) 228 ${INSTALL} ${COPY} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \ 229 ${_INSTALLFLAGS} ${FULLPROG} ${DESTDIR}${KMODDIR}/ 230.else 231 ${INSTALL} ${COPY} -o ${KMODOWN} -g ${KMODGRP} -m ${KMODMODE} \ 232 ${_INSTALLFLAGS} ${PROG} ${DESTDIR}${KMODDIR}/ 233.if defined(LINKS) && !empty(LINKS) 234 @set ${LINKS}; \ 235 while test $$# -ge 2; do \ 236 l=${DESTDIR}$$1; \ 237 shift; \ 238 t=${DESTDIR}$$1; \ 239 shift; \ 240 ${ECHO} $$t -\> $$l; \ 241 ln -f $$l $$t; \ 242 done; true 243.endif 244.if defined(SYMLINKS) && !empty(SYMLINKS) 245 @set ${SYMLINKS}; \ 246 while test $$# -ge 2; do \ 247 l=$$1; \ 248 shift; \ 249 t=${DESTDIR}$$1; \ 250 shift; \ 251 ${ECHO} $$t -\> $$l; \ 252 ln -fs $$l $$t; \ 253 done; true 254.endif 255.if !defined(NO_XREF) 256 -kldxref ${DESTDIR}${KMODDIR} 257.endif 258.endif 259 260install: afterinstall 261afterinstall: realinstall 262realinstall: beforeinstall 263.endif 264 265DISTRIBUTION?= bin 266.if !target(distribute) 267distribute: 268.for dist in ${DISTRIBUTION} 269 cd ${.CURDIR} ; $(MAKE) install DESTDIR=${DISTDIR}/${dist} SHARED=copies 270.endfor 271.endif 272 273.if !target(load) 274load: ${PROG} 275 ${KMODLOAD} -v ${.CURDIR}/${KMOD}.ko 276.endif 277 278.if !target(unload) 279unload: 280 ${KMODUNLOAD} -v ${KMOD} 281.endif 282 283.for _src in ${SRCS:Mopt_*.h} 284CLEANFILES+= ${_src} 285.if !target(${_src}) 286${_src}: 287 touch ${.TARGET} 288.endif 289.endfor 290 291MFILES?= kern/bus_if.m kern/device_if.m dev/iicbus/iicbb_if.m \ 292 dev/iicbus/iicbus_if.m isa/isa_if.m \ 293 libkern/iconv_converter_if.m \ 294 dev/mii/miibus_if.m \ 295 dev/pccard/card_if.m dev/pccard/power_if.m dev/pci/pci_if.m \ 296 dev/pci/pcib_if.m dev/ppbus/ppbus_if.m dev/smbus/smbus_if.m \ 297 dev/usb/usb_if.m dev/sound/pcm/ac97_if.m dev/sound/pcm/channel_if.m \ 298 dev/sound/pcm/feeder_if.m dev/sound/pcm/mixer_if.m pci/agp_if.m 299 300.for _srcsrc in ${MFILES} 301.for _ext in c h 302.for _src in ${SRCS:M${_srcsrc:T:R}.${_ext}} 303CLEANFILES+= ${_src} 304.if !target(${_src}) 305.if !exists(@) 306${_src}: @ 307.endif 308.if exists(@) 309${_src}: @/kern/makeobjops.pl @/${_srcsrc} 310.endif 311 perl @/kern/makeobjops.pl -${_ext} @/${_srcsrc} 312.endif 313.endfor # _src 314.endfor # _ext 315.endfor # _srcsrc 316 317.for _ext in c h 318.if ${SRCS:Mvnode_if.${_ext}} != "" 319CLEANFILES+= vnode_if.${_ext} 320.if !exists(@) 321vnode_if.${_ext}: @ 322.endif 323.if exists(@) 324vnode_if.${_ext}: @/tools/vnode_if.awk @/kern/vnode_if.src 325.endif 326 ${AWK} -f @/tools/vnode_if.awk @/kern/vnode_if.src -${_ext} 327.endif 328.endfor 329 330regress: 331 332lint: ${SRCS} 333 ${LINT} ${LINTKERNFLAGS} ${CFLAGS:M-[DILU]*} ${.ALLSRC:M*.c} 334 335.include <bsd.dep.mk> 336 337.if !exists(${DEPENDFILE}) 338${OBJS}: ${SRCS:M*.h} 339.endif 340 341.include <bsd.obj.mk> 342 343.include <bsd.kern.mk> 344