]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/mk/bsd.dep.mk
owc.4: document how to set up the 1-wire bus on a device.hints system
[FreeBSD/FreeBSD.git] / share / mk / bsd.dep.mk
1 # $FreeBSD$
2 #
3 # The include file <bsd.dep.mk> handles Makefile dependencies.
4 #
5 #
6 # +++ variables +++
7 #
8 # CLEANDEPENDDIRS       Additional directories to remove for the cleandepend
9 #                       target.
10 #
11 # CLEANDEPENDFILES      Additional files to remove for the cleandepend target.
12 #
13 # CTAGS         A tags file generation program [gtags]
14 #
15 # CTAGSFLAGS    Options for ctags(1) [not set]
16 #
17 # DEPENDFILE    dependencies file [.depend]
18 #
19 # GTAGSFLAGS    Options for gtags(1) [-o]
20 #
21 # HTAGSFLAGS    Options for htags(1) [not set]
22 #
23 # SRCS          List of source files (c, c++, assembler)
24 #
25 # DPSRCS        List of source files which are needed for generating
26 #               dependencies, ${SRCS} are always part of it.
27 #
28 # +++ targets +++
29 #
30 #       cleandepend:
31 #               remove ${CLEANDEPENDFILES}; remove ${CLEANDEPENDDIRS} and all
32 #               contents.
33 #
34 #       depend:
35 #               Make the dependencies for the source files, and store
36 #               them in the file ${DEPENDFILE}.
37 #
38 #       tags:
39 #               In "ctags" mode, create a tags file for the source files.
40 #               In "gtags" mode, create a (GLOBAL) gtags file for the
41 #               source files.  If HTML is defined, htags(1) is also run
42 #               after gtags(1).
43
44 .if !target(__<bsd.init.mk>__)
45 .error bsd.dep.mk cannot be included directly.
46 .endif
47
48 CTAGS?=         gtags
49 CTAGSFLAGS?=
50 GTAGSFLAGS?=    -o
51 HTAGSFLAGS?=
52
53 .if ${MK_DIRDEPS_BUILD} == "no"
54 .MAKE.DEPENDFILE= ${DEPENDFILE}
55 .endif
56 CLEANDEPENDFILES+=      ${DEPENDFILE} ${DEPENDFILE}.*
57 .if ${MK_META_MODE} == "yes"
58 CLEANDEPENDFILES+=      *.meta
59 .endif
60
61 # Keep `tags' here, before SRCS are mangled below for `depend'.
62 .if !target(tags) && defined(SRCS) && !defined(NO_TAGS)
63 tags: ${SRCS}
64 .if ${CTAGS:T} == "gtags"
65         @cd ${.CURDIR} && ${CTAGS} ${GTAGSFLAGS} ${.OBJDIR}
66 .if defined(HTML)
67         @cd ${.CURDIR} && htags ${HTAGSFLAGS} -d ${.OBJDIR} ${.OBJDIR}
68 .endif
69 .else
70         @${CTAGS} ${CTAGSFLAGS} -f /dev/stdout \
71             ${.ALLSRC:N*.h} | sed "s;${.CURDIR}/;;" > ${.TARGET}
72 .endif
73 .endif
74
75 .if !empty(.MAKE.MODE:Mmeta) && empty(.MAKE.MODE:Mnofilemon)
76 _meta_filemon=  1
77 .endif
78 # By default META_MODE is disabled in bmake if there is no OBJDIR
79 # unless .MAKE.MODE contains "curdirOk=[^0nNfF]"
80 .if defined(_meta_filemon) && ${.OBJDIR} == ${.CURDIR} && \
81     (empty(.MAKE.MODE:tl:Mcurdirok=*) || \
82     !empty(.MAKE.MODE:tl:Mcurdirok=[0NnFf]*))
83 .undef _meta_filemon
84 .endif
85
86 # Skip reading .depend when not needed to speed up tree-walks and simple
87 # lookups.  See _SKIP_BUILD logic in bsd.init.mk for more details.
88 # Also skip generating or including .depend.* files if in meta+filemon mode
89 # since it will track dependencies itself.  OBJS_DEPEND_GUESS is still used
90 # for _meta_filemon but not for _SKIP_DEPEND.
91 .if !defined(NO_SKIP_DEPEND) && defined(_SKIP_BUILD)
92 _SKIP_DEPEND=   1
93 .endif
94 .if ${MK_DIRDEPS_BUILD} == "no"
95 .if defined(_SKIP_DEPEND) || defined(_meta_filemon)
96 .MAKE.DEPENDFILE=       /dev/null
97 .endif
98 .endif
99
100 .if defined(SRCS)
101 CLEANFILES?=
102
103 .for _S in ${SRCS:N*.[dhly]}
104 OBJS_DEPEND_GUESS.${_S:${OBJS_SRCS_FILTER:ts:}}.o+=     ${_S}
105 .endfor
106
107 # Lexical analyzers
108 .for _LSRC in ${SRCS:M*.l:N*/*}
109 .for _LC in ${_LSRC:R}.c
110 ${_LC}: ${_LSRC}
111         ${LEX} ${LFLAGS} -o${.TARGET} ${.ALLSRC}
112 OBJS_DEPEND_GUESS.${_LC:R}.o+=  ${_LC}
113 SRCS:=  ${SRCS:S/${_LSRC}/${_LC}/}
114 CLEANFILES+= ${_LC}
115 .endfor
116 .endfor
117
118 # Yacc grammars
119 .for _YSRC in ${SRCS:M*.y:N*/*}
120 .for _YC in ${_YSRC:R}.c
121 SRCS:=  ${SRCS:S/${_YSRC}/${_YC}/}
122 CLEANFILES+= ${_YC}
123 .if !empty(YFLAGS:M-d) && !empty(SRCS:My.tab.h)
124 .ORDER: ${_YC} y.tab.h
125 y.tab.h: .NOMETA
126 ${_YC} y.tab.h: ${_YSRC}
127         ${YACC} ${YFLAGS} ${.ALLSRC}
128         cp y.tab.c ${_YC}
129 CLEANFILES+= y.tab.c y.tab.h
130 .elif !empty(YFLAGS:M-d)
131 .for _YH in ${_YC:R}.h
132 .ORDER: ${_YC} ${_YH}
133 ${_YH}: .NOMETA
134 ${_YC} ${_YH}: ${_YSRC}
135         ${YACC} ${YFLAGS} -o ${_YC} ${.ALLSRC}
136 SRCS+=  ${_YH}
137 CLEANFILES+= ${_YH}
138 .endfor
139 .else
140 ${_YC}: ${_YSRC}
141         ${YACC} ${YFLAGS} -o ${_YC} ${.ALLSRC}
142 .endif
143 OBJS_DEPEND_GUESS.${_YC:R}.o+=  ${_YC}
144 .endfor
145 .endfor
146
147 # DTrace probe definitions
148 .if ${SRCS:M*.d}
149 CFLAGS+=        -I${.OBJDIR}
150 .endif
151 .for _DSRC in ${SRCS:M*.d:N*/*}
152 .for _D in ${_DSRC:R}
153 SRCS+=  ${_D}.h
154 ${_D}.h: ${_DSRC}
155         ${DTRACE} ${DTRACEFLAGS} -h -s ${.ALLSRC}
156 SRCS:=  ${SRCS:S/^${_DSRC}$//}
157 OBJS+=  ${_D}.o
158 CLEANFILES+= ${_D}.h ${_D}.o
159 ${_D}.o: ${_DSRC} ${OBJS:S/^${_D}.o$//}
160         @rm -f ${.TARGET}
161         ${DTRACE} ${DTRACEFLAGS} -G -o ${.TARGET} -s ${.ALLSRC:N*.h}
162 .if defined(LIB)
163 CLEANFILES+= ${_D}.pico ${_D}.po ${_D}.nossppico
164 ${_D}.pico: ${_DSRC} ${SOBJS:S/^${_D}.pico$//}
165         @rm -f ${.TARGET}
166         ${DTRACE} ${DTRACEFLAGS} -G -o ${.TARGET} -s ${.ALLSRC:N*.h}
167 ${_D}.po: ${_DSRC} ${POBJS:S/^${_D}.po$//}
168         @rm -f ${.TARGET}
169         ${DTRACE} ${DTRACEFLAGS} -G -o ${.TARGET} -s ${.ALLSRC:N*.h}
170 ${_D}.nossppico: ${_DSRC} ${SOBJS:S/^${_D}.nossppico$//}
171         @rm -f ${.TARGET}
172         ${DTRACE} ${DTRACEFLAGS} -G -o ${.TARGET} -s ${.ALLSRC:N*.h}
173 .endif
174 .endfor
175 .endfor
176 .endif  # defined(SRCS)
177
178 .if ${MAKE_VERSION} < 20160220
179 DEPEND_MP?=     -MP
180 .endif
181 # Handle OBJS=../somefile.o hacks.  Just replace '/' rather than use :T to
182 # avoid collisions.
183 DEPEND_FILTER=  C,/,_,g
184 .if !empty(OBJS)
185 DEPENDOBJS+=    ${OBJS}
186 .else
187 DEPENDSRCS+=    ${SRCS:M*.[cSC]} ${SRCS:M*.cxx} ${SRCS:M*.cpp} ${SRCS:M*.cc}
188 DEPENDSRCS+=    ${DPSRCS:M*.[cSC]} ${SRCS:M*.cxx} ${SRCS:M*.cpp} ${SRCS:M*.cc}
189 .if !empty(DEPENDSRCS)
190 DEPENDOBJS+=    ${DEPENDSRCS:${OBJS_SRCS_FILTER:ts:}:S,$,.o,}
191 .endif
192 .endif  # !empty(OBJS)
193 .if !empty(DEPENDOBJS)
194 DEPENDFILES+=   ${DEPENDOBJS:O:u:${DEPEND_FILTER}:C/^/${DEPENDFILE}./}
195 .endif
196 .if defined(_SKIP_DEPEND)
197 # Don't bother statting any .meta files for .depend*
198 ${DEPENDOBJS}:  .NOMETA
199 ${DEPENDFILE}:  .NOMETA
200 # Unset these to avoid looping/statting on them later.
201 .undef DEPENDSRCS
202 .undef DEPENDOBJS
203 .undef DEPENDFILES
204 .endif  # defined(_SKIP_DEPEND)
205 DEPEND_CFLAGS+= -MD ${DEPEND_MP} -MF${DEPENDFILE}.${.TARGET:${DEPEND_FILTER}}
206 DEPEND_CFLAGS+= -MT${.TARGET}
207 .if !defined(_meta_filemon)
208 .if !empty(DEPEND_CFLAGS)
209 # Only add in DEPEND_CFLAGS for CFLAGS on files we expect from DEPENDOBJS
210 # as those are the only ones we will include.
211 DEPEND_CFLAGS_CONDITION= "${DEPENDOBJS:${DEPEND_FILTER}:M${.TARGET:${DEPEND_FILTER}}}" != ""
212 CFLAGS+=        ${${DEPEND_CFLAGS_CONDITION}:?${DEPEND_CFLAGS}:}
213 .endif
214 .for __depend_obj in ${DEPENDFILES}
215 .if ${MAKE_VERSION} < 20160220
216 .sinclude "${.OBJDIR}/${__depend_obj}"
217 .else
218 .dinclude "${.OBJDIR}/${__depend_obj}"
219 .endif
220 .endfor
221 .endif  # !defined(_meta_filemon)
222
223 .if ${MK_DIRDEPS_BUILD} == "yes" && ${.MAKE.DEPENDFILE} != "/dev/null"
224 # Prevent meta.autodep.mk from tracking "local dependencies".
225 .depend:
226 .include <meta.autodep.mk>
227 # If using filemon then _EXTRADEPEND is skipped since it is not needed.
228 .if defined(_meta_filemon)
229 # this depend: bypasses that below
230 # the dependency helps when bootstrapping
231 depend: beforedepend ${DPSRCS} ${SRCS} afterdepend
232 beforedepend:
233 afterdepend: beforedepend
234 .endif
235 .endif
236
237 # Guess some dependencies for when no ${DEPENDFILE}.OBJ is generated yet.
238 # For meta+filemon the .meta file is checked for since it is the dependency
239 # file used.
240 .for __obj in ${DEPENDOBJS:O:u}
241 # If the obj has any '/', then replace with '_'.  For meta files, this is
242 # mimicing what bmake's meta_name() does and adding in the full path
243 # as well to ensure that the expected meta file is read.
244 .if ${__obj:M*/*}
245 .if ${MAKE_VERSION} < 20171028
246 _meta_obj=      ${.OBJDIR:C,/,_,g}_${__obj:C,/,_,g}.meta
247 .else
248 _meta_obj=      ${__obj:C,/,_,g}.meta
249 .endif  # ${MAKE_VERSION} < 20171028
250 .else
251 _meta_obj=      ${__obj}.meta
252 .endif  # ${__obj:M*/*}
253 _dep_obj=       ${DEPENDFILE}.${__obj:${DEPEND_FILTER}}
254 .if defined(_meta_filemon)
255 _depfile=       ${.OBJDIR}/${_meta_obj}
256 .else
257 _depfile=       ${.OBJDIR}/${_dep_obj}
258 .endif
259 .if !exists(${_depfile}) || defined(_meta_filemon)
260 # - Headers are normally built in beforebuild when included in DPSRCS or SRCS.
261 #   So we don't need it as a guessed dependency (it may lead to cyclic problems
262 #   if custom rules are defined).  The only time this causes a problem is when
263 #   'make foo.o' is ran.
264 # - For meta mode we still need to know which file to depend on to avoid
265 #   ambiguous suffix transformation rules from .PATH.  Meta mode does not
266 #   use .depend files when filemon is in use.
267 .if !target(${__obj})
268 ${__obj}: ${OBJS_DEPEND_GUESS}
269 .endif
270 ${__obj}: ${OBJS_DEPEND_GUESS.${__obj}}
271 .endif  # !exists(${_depfile}) || defined(_meta_filemon)
272 .endfor
273
274 # Always run 'make depend' to generate dependencies early and to avoid the
275 # need for manually running it.  The dirdeps build should only do this in
276 # sub-makes though since MAKELEVEL0 is for dirdeps calculations.
277 .if ${MK_DIRDEPS_BUILD} == "no" || ${.MAKE.LEVEL} > 0
278 beforebuild: depend
279 .endif
280
281 .if !target(depend)
282 .if defined(SRCS)
283 depend: beforedepend ${DEPENDFILE} afterdepend
284
285 # Tell bmake not to look for generated files via .PATH
286 .NOPATH: ${DEPENDFILE} ${DEPENDFILES}
287
288 # A .depend file will only be generated if there are commands in
289 # beforedepend/_EXTRADEPEND/afterdepend  The _EXTRADEPEND target is
290 # ignored if using meta+filemon since it handles all dependencies.  The other
291 # targets are kept as they be used for generating something.  The target is
292 # kept to allow 'make depend' to generate files.
293 ${DEPENDFILE}: ${SRCS} ${DPSRCS}
294 .if !defined(_SKIP_DEPEND)
295 .if exists(${.OBJDIR}/${DEPENDFILE}) || \
296     ((commands(beforedepend) || \
297     (!defined(_meta_filemon) && commands(_EXTRADEPEND)) || \
298     commands(afterdepend)) && !empty(.MAKE.MODE:Mmeta))
299         rm -f ${DEPENDFILE}
300 .endif
301 .endif
302 .if !defined(_meta_filemon) && target(_EXTRADEPEND)
303 _EXTRADEPEND: .USE
304 ${DEPENDFILE}: _EXTRADEPEND
305 .endif
306
307 .ORDER: ${DEPENDFILE} afterdepend
308 .else
309 depend: beforedepend afterdepend
310 .endif
311 .if !target(beforedepend)
312 beforedepend:
313 .else
314 .ORDER: beforedepend ${DEPENDFILE}
315 .ORDER: beforedepend afterdepend
316 .endif
317 .if !target(afterdepend)
318 afterdepend:
319 .endif
320 .endif
321
322 .if defined(SRCS)
323 .if ${CTAGS:T} == "gtags"
324 CLEANDEPENDFILES+=      GPATH GRTAGS GSYMS GTAGS
325 .if defined(HTML)
326 CLEANDEPENDDIRS+=       HTML
327 .endif
328 .else
329 CLEANDEPENDFILES+=      tags
330 .endif
331 .endif
332 .if !target(cleandepend)
333 cleandepend:
334 .if !empty(CLEANDEPENDFILES)
335         rm -f ${CLEANDEPENDFILES}
336 .endif
337 .if !empty(CLEANDEPENDDIRS)
338         rm -rf ${CLEANDEPENDDIRS}
339 .endif
340 .endif
341 .ORDER: cleandepend all
342 .ORDER: cleandepend depend
343 .if ${MK_AUTO_OBJ} == "yes"
344 .ORDER: cleanobj depend
345 .ORDER: cleandir depend
346 .endif
347
348 .if !target(checkdpadd) && (defined(DPADD) || defined(LDADD))
349 _LDADD_FROM_DPADD=      ${DPADD:R:T:C;^lib(.*)$;-l\1;g}
350 # Ignore -Wl,--start-group/-Wl,--end-group as it might be required in the
351 # LDADD list due to unresolved symbols
352 _LDADD_CANONICALIZED=   ${LDADD:N:R:T:C;^lib(.*)$;-l\1;g:N-Wl,--[es]*-group}
353 checkdpadd:
354 .if ${_LDADD_FROM_DPADD} != ${_LDADD_CANONICALIZED}
355         @echo ${.CURDIR}
356         @echo "DPADD -> ${_LDADD_FROM_DPADD}"
357         @echo "LDADD -> ${_LDADD_CANONICALIZED}"
358 .endif
359 .endif