1 # from: @(#)bsd.subdir.mk 5.9 (Berkeley) 2/1/91
4 # The include file <bsd.subdir.mk> contains the default targets
5 # for building subdirectories.
7 # For all of the directories listed in the variable SUBDIRS, the
8 # specified directory will be visited and the target made. There is
9 # also a default target which allows the command "make subdir" where
10 # subdir is any directory listed in the variable SUBDIRS.
15 # DISTRIBUTION Name of distribution. [base]
17 # SUBDIR A list of subdirectories that should be built as well.
18 # Each of the targets will execute the same target in the
19 # subdirectories. SUBDIR.yes is automatically appended
25 # This is a variant of install, which will
26 # put the stuff into the right "distribution".
28 # See SUBDIR_TARGETS for list of targets that will recurse.
30 # Targets defined in STANDALONE_SUBDIR_TARGETS will always be ran
31 # with SUBDIR_PARALLEL and will not respect .WAIT or SUBDIR_DEPEND_
34 # SUBDIR_TARGETS and STANDALONE_SUBDIR_TARGETS can be appended to
35 # via make.conf or src.conf.
38 .if !target(__<bsd.subdir.mk>__)
42 all all-man analyze buildconfig buildfiles buildincludes \
43 checkdpadd clean cleandepend cleandir cleanilinks \
44 cleanobj depend distribute files includes installconfig \
45 installfiles installincludes realinstall lint maninstall \
46 manlint obj objlink tags \
49 STANDALONE_SUBDIR_TARGETS+= \
50 all-man buildconfig buildfiles buildincludes check checkdpadd \
51 clean cleandepend cleandir cleanilinks cleanobj files includes \
52 installconfig installincludes installfiles maninstall manlint \
55 # It is safe to install in parallel when staging.
57 STANDALONE_SUBDIR_TARGETS+= realinstall
60 .include <bsd.init.mk>
62 .if !defined(NEED_SUBDIR)
63 .if ${.MAKE.LEVEL} == 0 && ${MK_DIRDEPS_BUILD} == "yes" && !empty(SUBDIR) && !(make(clean*) || make(destroy*))
64 .include <meta.subdir.mk>
71 .if !target(distribute)
73 .for dist in ${DISTRIBUTION}
74 ${_+_}cd ${.CURDIR}; \
75 ${MAKE} install installconfig -DNO_SUBDIR DESTDIR=${DISTDIR}/${dist} SHARED=copies
78 # Convenience targets to run 'build${target}' and 'install${target}' when
79 # calling 'make ${target}'.
80 .for __target in files includes
81 .if !target(${__target})
82 ${__target}: build${__target} install${__target}
83 .ORDER: build${__target} install${__target}
87 # Make 'install' supports a before and after target. Actual install
88 # hooks are placed in 'realinstall'.
90 .for __stage in before real after
91 .if !target(${__stage}install)
95 install: beforeinstall realinstall afterinstall
96 .ORDER: beforeinstall realinstall afterinstall
100 # SUBDIR recursing may be disabled for MK_DIRDEPS_BUILD
104 SUBDIR:=${SUBDIR} ${SUBDIR.yes}
108 # Subdir code shared among 'make <subdir>', 'make <target>' and SUBDIR_PARALLEL.
110 if test -d ${.CURDIR}/$${dir}.${MACHINE_ARCH}; then \
111 dir=$${dir}.${MACHINE_ARCH}; \
113 ${ECHODIR} "===> ${DIRPRFX}$${dir} ($${target})"; \
114 cd ${.CURDIR}/$${dir}; \
115 ${MAKE} $${target} DIRPRFX=${DIRPRFX}$${dir}/
117 # This is kept for compatibility only. The normal handling of attaching to
118 # SUBDIR_TARGETS will create a target for each directory.
120 .if defined(SUBDIR) && !empty(SUBDIR) && !defined(NO_SUBDIR)
121 @${_+_}target=${.TARGET:realinstall=install}; \
122 for dir in ${SUBDIR:N.WAIT}; do ( ${_SUBDIR_SH} ); done
125 # Create 'make subdir' targets to run the real 'all' target.
126 .for __dir in ${SUBDIR:N.WAIT}
127 ${__dir}: all_subdir_${DIRPRFX}${__dir} .PHONY
130 .for __target in ${SUBDIR_TARGETS}
131 # Can ordering be skipped for this and SUBDIR_PARALLEL forced?
132 .if ${STANDALONE_SUBDIR_TARGETS:M${__target}}
133 _is_standalone_target= 1
134 SUBDIR:= ${SUBDIR:N.WAIT}
136 _is_standalone_target= 0
139 .for __dir in ${SUBDIR}
140 .if ${__dir} == .WAIT
141 __subdir_targets+= .WAIT
144 .if ${_is_standalone_target} == 0
145 .if defined(SUBDIR_PARALLEL)
146 # Apply SUBDIR_DEPEND dependencies for SUBDIR_PARALLEL.
147 .for __dep in ${SUBDIR_DEPEND_${__dir}}
148 __deps+= ${__target}_subdir_${DIRPRFX}${__dep}
151 # For non-parallel builds, directories depend on all targets before them.
152 __deps:= ${__subdir_targets}
153 .endif # defined(SUBDIR_PARALLEL)
154 .endif # ${_is_standalone_target} == 0
155 ${__target}_subdir_${DIRPRFX}${__dir}: .PHONY .MAKE .SILENT ${__deps}
156 @${_+_}target=${__target:realinstall=install}; \
159 __subdir_targets+= ${__target}_subdir_${DIRPRFX}${__dir}
160 .endif # ${__dir} == .WAIT
161 .endfor # __dir in ${SUBDIR}
163 # Attach the subdir targets to the real target.
164 # Only recurse on directly-called targets. I.e., don't recurse on dependencies
165 # such as 'install' becoming {before,real,after}install, just recurse
166 # 'install'. Despite that, 'realinstall' is special due to ordering issues
167 # with 'afterinstall'.
168 .if !defined(NO_SUBDIR) && (make(${__target}) || \
169 (${__target} == realinstall && make(install)))
170 ${__target}: ${__subdir_targets} .PHONY
171 .endif # make(${__target})
172 .endfor # __target in ${SUBDIR_TARGETS}
174 .endif # !target(_SUBDIR)
176 # Ensure all targets exist
177 .for __target in ${SUBDIR_TARGETS}
178 .if !target(${__target})