xref: /illumos-gate/usr/src/cmd/mdb/Makefile.module (revision 4c28a617e3922d92a58e813a5b955eb526b9c386)
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License (the "License").
6# You may not use this file except in compliance with the License.
7#
8# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9# or http://www.opensolaris.org/os/licensing.
10# See the License for the specific language governing permissions
11# and limitations under the License.
12#
13# When distributing Covered Code, include this CDDL HEADER in each
14# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15# If applicable, add the following below this CDDL HEADER, with the
16# fields enclosed by brackets "[]" replaced with your own identifying
17# information: Portions Copyright [yyyy] [name of copyright owner]
18#
19# CDDL HEADER END
20#
21#
22# Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
23# Use is subject to license terms.
24#
25# Copyright (c) 2013 by Delphix. All rights reserved.
26# Copyright 2015, Joyent, Inc.
27#
28
29.KEEP_STATE:
30.SUFFIXES:
31
32include $(SRC)/cmd/mdb/Makefile.tools
33
34#
35# Make sure we're getting a consistent execution environment for the
36# embedded scripts.
37#
38SHELL= /usr/bin/ksh93
39
40$(KMOD_SOURCES_DIFFERENT)KMODSRCS = $(MODSRCS)
41$(KMOD_SOURCES_DIFFERENT)KMODASMSRCS = $(MODASMSRCS)
42
43MODOBJS = $(MODSRCS:%.c=dmod/%.o) $(MODASMSRCS:%.s=dmod/%.o)
44KMODOBJS = $(KMODSRCS:%.c=kmod/%.o) $(KMODASMSRCS:%.s=kmod/%.o)
45
46MODNAME_cmd = if [ -n "$(MODULE_NAME)" ]; then print $(MODULE_NAME); else print $(MODULE)| sed -e 's:\.so$$::'; fi
47MODNAME = $(MODNAME_cmd:sh)
48KMODULE = $(MODNAME)
49
50MODFILE = dmod/$(MODULE)
51KMODFILE = kmod/$(KMODULE)
52
53#
54# The mess below is designed to pick the right set of objects to build and/or
55# lint.  We have three flavors:
56#
57#  1. proc and raw modules.  Only $(MODOBJS) are built.
58#  2. kvm modules for systems without kmdb.  Only $(MODOBJS) are built.
59#  3. kvm modules for systems with kmdb.  $(MODOBJS) and $(KMODOBJS) are built.
60#
61# Complicating matters, we'd like to make the distinction between 2 and 3 before
62# this Makefile is loaded.  By default, we'll assume that all kvm modules should
63# be built for kmdb.  If, however, the user sets $(MODULE_BUILD_TYPE) to `mdb',
64# the kmdb variant of the module won't be built.
65#
66
67# Which flavors are to be built?
68TARGETS_kvm_type_	= both	# Build both if $(MODULE_BUILD_TYPE) is unset
69TARGETS_kvm_type_kmdb	= both
70TARGETS_kvm_type_mdb	= mdb
71TARGETS_kvm_type	= $(TARGETS_kvm_type_$(MODULE_BUILD_TYPE))
72
73# What should we build?
74TARGETS_kvm_kmdb	= $(KMODFILE)
75TARGETS_kvm_mdb		= $(MODFILE)
76TARGETS_kvm_both	= $(TARGETS_kvm_mdb) $(TARGETS_kvm_kmdb)
77TARGETS_kvm		= $(TARGETS_kvm_$(TARGETS_kvm_type))
78TARGETS_proc		= $(MODFILE)
79TARGETS_raw		= $(MODFILE)
80TARGETS			= $(TARGETS_$(MDBTGT))
81
82# Where should we install that which we've built?
83ROOTTGTS_kvm_type	= $(TARGETS_kvm_type)	# overridden by mdb_ks
84ROOTTGTS_kvm_kmdb	= $(ROOTKMOD)/$(KMODULE)
85ROOTTGTS_kvm_mdb	= $(ROOTMOD)/$(MODULE)
86ROOTTGTS_kvm_both	= $(ROOTTGTS_kvm_mdb) $(ROOTTGTS_kvm_kmdb)
87ROOTTGTS_kvm		= $(ROOTTGTS_kvm_$(ROOTTGTS_kvm_type))
88ROOTTGTS_proc		= $(ROOTMOD)/$(MODULE)
89ROOTTGTS_raw		= $(ROOTMOD)/$(MODULE)
90ROOTTGTS		= $(ROOTTGTS_$(MDBTGT))
91
92# What should we lint?
93KLINTOBJS		= $(KMODOBJS:%.o=%.ln)
94LINTOBJS		= $(MODOBJS:%.o=%.ln)
95
96LINTFILES_kvm_type	= $(TARGETS_kvm_type)
97LINTFILES_kvm_both	= $(KLINTOBJS) $(LINTOBJS)
98LINTFILES_kvm_mdb	= $(LINTOBJS)
99LINTFILES_kvm		= $(LINTFILES_kvm_$(LINTFILES_kvm_type))
100LINTFILES_proc		= $(LINTOBJS)
101LINTFILES_raw		= $(LINTOBJS)
102LINTFILES		= $(LINTFILES_$(MDBTGT))
103
104#
105# Python specific flags. To try and make life easier for folks how are
106# building with an LFS python, we attempt to use -isystem when it's
107# available.
108#
109PYCPPFLAGS		= -_gcc=-isystem -_gcc=$(ADJUNCT_PROTO)/usr/include/python$(PYTHON_VERSION)
110PYCPPFLAGS		+= -_cc=-I$(ADJUNCT_PROTO)/usr/include/python$(PYTHON_VERSION)
111PYLNFLAGS		= -I$(ADJUNCT_PROTO)/usr/include/python$(PYTHON_VERSION)
112
113kvm_TGTFLAGS		= -D_KERNEL
114proc_TGTFLAGS		= -D_USER
115
116CSTD			= $(CSTD_GNU99)
117
118CFLAGS			+= $(CCVERBOSE)
119CFLAGS64		+= $(CCVERBOSE)
120CPPFLAGS		+= $($(MDBTGT)_TGTFLAGS) -I../../../common
121LDFLAGS			+= $(ZTEXT)
122LDFLAGS64		+= $(ZTEXT)
123ASFLAGS			+= -P
124AS_CPPFLAGS		+= -D_ASM
125
126# Module type-specific compiler flags
127$(MODOBJS) :=			CFLAGS += $(C_BIGPICFLAGS) $(XREGSFLAG)
128$(MODOBJS) :=			CFLAGS64 += $(C_BIGPICFLAGS) $(XREGSFLAG)
129$(KMODOBJS) $(KLINTOBJS) :=	CPPFLAGS += -D_KMDB
130$(KMODOBJS) :=			V9CODESIZE = $(CCABS32)
131$(KMODOBJS) :=			DTS_ERRNO =
132
133# Modules aren't allowed to export symbols
134MAPFILE		= $(SRC)/cmd/mdb/common/modules/conf/mapfile
135
136# Modules typically make external references.  To provide for -zdefs use
137# and clean ldd(1) processing, explicitly define all external references.
138MAPFILE-EXT	= $(SRC)/cmd/mdb/common/modules/conf/mapfile-extern
139
140#
141# kmdb is a kernel module, so we'll use the kernel's build flags.
142$(KMODOBJS) := CFLAGS64 += $(STAND_FLAGS_64)
143
144#
145# Override this to pull source files from another directory
146#
147MODSRCS_DIR = ../../../common/modules/genunix
148
149all: $$(TARGETS)
150
151install: all $$(ROOTTGTS)
152
153dmods: install
154
155clean.lint:
156	$(RM) $(LINTFILES) $(MODSRCS:.c=.ln)
157
158clean:
159	$(RM) $(MODOBJS) $(KMODOBJS) $(CLEANFILES)
160
161clobber: clean clean.lint
162	$(RM) $(MODFILE) $(KMODFILE) $(CLOBBERFILES)
163
164lint: $$(LINTFILES)
165
166.NO_PARALLEL:
167.PARALLEL: $(MODOBJS) $(KMODOBJS) mdb_tgt kmdb_tgt dmod kmod \
168	$(TARGETS) $(LINTFILES)
169
170$(MODFILE): dmod .WAIT $(MODOBJS) $$(MAPFILE-EXT)
171	$(LINK.c) $(ZDEFS) $(ZIGNORE) $(MAPFILE-EXT:%=-M%) $(GSHARED) \
172	    $(MODOBJS) -o $@ $(LDLIBS) -lc
173	$(CTFMERGE) -L VERSION -o $@ $(MODOBJS)
174	$(POST_PROCESS_SO)
175
176#
177# kmdb dmods must *not* stray from the module API.  To ensure that they don't,
178# we try to link them, at build time, against an object that exports the symbols
179# that they can legally use.  The link test object is, however, only built when
180# kmdb itself is built.  Requiring module developers to build kmdb first would
181# be painful, so by default, module-level builds don't do the link test (the
182# $(POUND_SIGN) assignment below takes care of that).  Builds of the entire
183# tree can, however, guarantee the construction of kmdb first, and as such can
184# override the setting of $(KMDB_LINKTEST_ENABLE).  This override causes the
185# link test to be run.
186#
187# Developers wanting to force a link test for a single module can use the
188# `linktest' target from within a module directory.
189#
190LINKTESTOBJ = $(KMDBDIR)/kmdb_modlinktest.o
191
192KMDB_LINKTEST = \
193	$(LD) $(ZDEFS) -dy -r -o $@.linktest $(KMODOBJS) \
194	$(STANDOBJS) $(LINKTESTOBJ) && \
195	$(RM) $@.linktest
196
197KMDB_LINKTEST_ENABLE=$(POUND_SIGN)
198$(KMDB_LINKTEST_ENABLE)KMDB_LINKTEST_CMD = $(KMDB_LINKTEST)
199
200#
201# Ensure that dmods don't use floating point
202#
203KMDB_FPTEST_CMD = $(KMDB_FPTEST)
204
205$(KMODFILE): kmod .WAIT $(KMODOBJS) $(MAPFILE)
206	$(LD) -dy -r $(MAPFILE:%=-M%) -Nmisc/kmdbmod -o $@ $(KMODOBJS) \
207	$(STANDOBJS)
208	$(KMDB_LINKTEST_CMD)
209	$(KMDB_FPTEST_CMD)
210	$(CTFMERGE) -f -L VERSION -o $@ $(KMODOBJS)
211	$(POST_PROCESS)
212	$(SETDYNFLAG) -f DF_1_NOKSYMS $@
213
214linktest: linktest_check .WAIT kmod .WAIT $(KMODOBJS)
215	$(KMDB_LINKTEST)
216
217linktest_check:
218	@if [ "$(MDBTGT)" != "kvm" ] ; then \
219		echo "ERROR: linktest is not supported non-kvm/disasm dmods" \
220		    >&2 ; \
221		exit 1 ; \
222	fi
223
224#
225# Dynamic rules for object construction
226#
227dmod/%.o kmod/%.o: %.c
228	$(COMPILE.c) -o $@ $<
229	$(CTFCONVERT_O)
230
231dmod/%.o kmod%.o: %.s
232	$(COMPILE.s) -o $@ $<
233	$(CTFCONVERT_O)
234
235dmod/%.o kmod/%.o: ../%.c
236	$(COMPILE.c) -o $@ $<
237	$(CTFCONVERT_O)
238
239dmod/%.o kmod%.o: ../%.s
240	$(COMPILE.s) -o $@ $<
241	$(CTFCONVERT_O)
242
243dmod/%.o kmod/%.o: ../../../common/modules/$(MODNAME)/%.c
244	$(COMPILE.c) -o $@ $<
245	$(CTFCONVERT_O)
246
247dmod/%.o kmod%.o: ../../../common/modules/$(MODNAME)/%.s
248	$(COMPILE.s) -o $@ $<
249	$(CTFCONVERT_O)
250
251dmod/%.o kmod/%.o: $$(MODSRCS_DIR)/%.c
252	$(COMPILE.c) -o $@ $<
253	$(CTFCONVERT_O)
254
255dmod/%.o kmod%.o: $$(MODSRCS_DIR)/%.s
256	$(COMPILE.s) -o $@ $<
257	$(CTFCONVERT_O)
258
259#
260# Lint
261#
262dmod/%.ln kmod/%.ln: %.c
263	$(LINT.c) -dirout=$(@D) -c $<
264
265dmod/%.ln kmod/%.ln: %.s
266	$(LINT.s) -dirout=$(@D) -c $<
267
268dmod/%.ln kmod/%.ln: ../%.c
269	$(LINT.c) -dirout=$(@D) -c $<
270
271dmod/%.ln kmod/%.ln: ../%.s
272	$(LINT.s) -dirout=$(@D) -c $<
273
274dmod/%.ln kmod/%.ln: ../../../common/modules/$(MODNAME)/%.c
275	$(LINT.c) -dirout=$(@D) -c $<
276
277dmod/%.ln kmod/%.ln: ../../../common/modules/$(MODNAME)/%.s
278	$(LINT.s) -dirout=$(@D) -c $<
279
280dmod/%.ln kmod/%.ln: $$(MODSRCS_DIR)/%.c
281	$(LINT.c) -dirout=$(@D) -c $<
282
283dmod/%.ln kmod/%.ln: $$(MODSRCS_DIR)/%.s
284	$(LINT.s) -dirout=$(@D) -c $<
285
286#
287# Installation targets
288#
289
290$(ROOT)/usr/lib/mdb/$(MDBTGT): $(ROOT)/usr/lib/mdb
291	$(INS.dir)
292
293$(ROOT)/usr/lib/mdb:
294	$(INS.dir)
295
296$(ROOT)/kernel/kmdb:
297	$(INS.dir)
298
299$(ROOTMOD)/$(MODULE): $(ROOTMOD)
300
301$(ROOTKMOD)/$(KMODULE): $(ROOTKMOD)
302
303kmod dmod:
304	-@mkdir -p $@
305