usr/src/cmd/mdb/Makefile.module

   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
  32 include $(SRC)/cmd/mdb/Makefile.tools
  33
  34 #
  35 # Make sure we're getting a consistent execution environment for the
  36 # embedded scripts.
  37 #
  38 SHELL= /usr/bin/ksh93
  39
  40 $(KMOD_SOURCES_DIFFERENT)KMODSRCS = $(MODSRCS)
  41 $(KMOD_SOURCES_DIFFERENT)KMODASMSRCS = $(MODASMSRCS)
  42
  43 MODOBJS = $(MODSRCS:%.c=dmod/%.o) $(MODASMSRCS:%.s=dmod/%.o)
  44 KMODOBJS = $(KMODSRCS:%.c=kmod/%.o) $(KMODASMSRCS:%.s=kmod/%.o)
  45
  46 MODNAME_cmd = if [ -n "$(MODULE_NAME)" ]; then print $(MODULE_NAME); else print $(MODULE)| sed -e 's:\.so$$::'; fi
  47 MODNAME = $(MODNAME_cmd:sh)
  48 KMODULE = $(MODNAME)
  49
  50 MODFILE = dmod/$(MODULE)
  51 KMODFILE = kmod/$(KMODULE)
  52
  53 #
  54 # The mess below is designed to pick the right set of objects to build.  We
  55 # 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?
  68 TARGETS_kvm_type_       = both  # Build both if $(MODULE_BUILD_TYPE) is unset
  69 TARGETS_kvm_type_kmdb   = both
  70 TARGETS_kvm_type_mdb    = mdb
  71 TARGETS_kvm_type        = $(TARGETS_kvm_type_$(MODULE_BUILD_TYPE))
  72
  73 # What should we build?
  74 TARGETS_kvm_kmdb        = $(KMODFILE)
  75 TARGETS_kvm_mdb         = $(MODFILE)
  76 TARGETS_kvm_both        = $(TARGETS_kvm_mdb) $(TARGETS_kvm_kmdb)
  77 TARGETS_kvm             = $(TARGETS_kvm_$(TARGETS_kvm_type))
  78 TARGETS_proc            = $(MODFILE)
  79 TARGETS_raw             = $(MODFILE)
  80 TARGETS                 = $(TARGETS_$(MDBTGT))
  81
  82 # Where should we install that which we've built?
  83 ROOTTGTS_kvm_type       = $(TARGETS_kvm_type)   # overridden by mdb_ks
  84 ROOTTGTS_kvm_kmdb       = $(ROOTKMOD)/$(KMODULE)
  85 ROOTTGTS_kvm_mdb        = $(ROOTMOD)/$(MODULE)
  86 ROOTTGTS_kvm_both       = $(ROOTTGTS_kvm_mdb) $(ROOTTGTS_kvm_kmdb)
  87 ROOTTGTS_kvm            = $(ROOTTGTS_kvm_$(ROOTTGTS_kvm_type))
  88 ROOTTGTS_proc           = $(ROOTMOD)/$(MODULE)
  89 ROOTTGTS_raw            = $(ROOTMOD)/$(MODULE)
  90 ROOTTGTS                = $(ROOTTGTS_$(MDBTGT))
  91
  92 #
  93 # Python specific flags. To try and make life easier for folks how are
  94 # building with an LFS python.
  95 #
  96 PYCPPFLAGS              = -isystem $(ADJUNCT_PROTO)/usr/include/python$(PYTHON_VERSION)
  97
  98 kvm_TGTFLAGS            = -D_KERNEL
  99 proc_TGTFLAGS           = -D_USER
 100
 101 C99MODE                 = $(C99_ENABLE)
 102
 103 CPPFLAGS                += $($(MDBTGT)_TGTFLAGS) -I../../../common
 104 CPPFLAGS                += -I$(SRCTOP)/include
 105 LDFLAGS                 += $(ZTEXT)
 106 LDFLAGS64               += $(ZTEXT)
 107 AS_CPPFLAGS             += -D_ASM
 108
 109 # Module type-specific compiler flags
 110 $(MODOBJS) :=                   CFLAGS += $(C_BIGPICFLAGS) $(XREGSFLAG)
 111 $(MODOBJS) :=                   CFLAGS64 += $(C_BIGPICFLAGS) $(XREGSFLAG)
 112 $(KMODOBJS) :=                  CPPFLAGS += -D_KMDB
 113 $(KMODOBJS) :=                  V9CODESIZE = $(CCABS32)
 114
 115 # Modules aren't allowed to export symbols
 116 MAPFILE         = $(SRC)/cmd/mdb/common/modules/conf/mapfile
 117
 118 # Modules typically make external references.  To provide for -zdefs use
 119 # and clean ldd(1) processing, explicitly define all external references.
 120 MAPFILE-EXT     = $(SRC)/cmd/mdb/common/modules/conf/mapfile-extern
 121
 122 #
 123 # kmdb is a kernel module, so we'll use the kernel's build flags.
 124 $(KMODOBJS) := CFLAGS += $(STAND_FLAGS_32)
 125 $(KMODOBJS) := CFLAGS64 += $(STAND_FLAGS_64)
 126
 127 #
 128 # Override this to pull source files from another directory
 129 #
 130 MODSRCS_DIR = ../../../common/modules/genunix
 131
 132 all: $$(TARGETS)
 133
 134 install: all $$(ROOTTGTS)
 135
 136 dmods: install
 137
 138 clean:
 139         $(RM) $(MODOBJS) $(KMODOBJS) $(CLEANFILES)
 140
 141 clobber: clean
 142         $(RM) $(MODFILE) $(KMODFILE) $(CLOBBERFILES)
 143
 144 .NO_PARALLEL:
 145 .PARALLEL: $(MODOBJS) $(KMODOBJS) mdb_tgt kmdb_tgt dmod kmod \
 146         $(TARGETS)
 147
 148 $(MODFILE): dmod .WAIT $(MODOBJS) $$(MAPFILE-EXT)
 149         $(LINK.c) $(ZDEFS) $(ZIGNORE) $(MAPFILE-EXT:%=-Wl,-M%) $(GSHARED) \
 150             $(MODOBJS) -o $@ $(LDLIBS) -lc
 151         $(CTFMERGE) -L VERSION -o $@ $(MODOBJS)
 152         $(POST_PROCESS_SO)
 153
 154 #
 155 # kmdb dmods must *not* stray from the module API.  To ensure that they don't,
 156 # we try to link them, at build time, against an object that exports the symbols
 157 # that they can legally use.  The link test object is, however, only built when
 158 # kmdb itself is built.  Requiring module developers to build kmdb first would
 159 # be painful, so by default, module-level builds don't do the link test (the
 160 # $(POUND_SIGN) assignment below takes care of that).  Builds of the entire
 161 # tree can, however, guarantee the construction of kmdb first, and as such can
 162 # override the setting of $(KMDB_LINKTEST_ENABLE).  This override causes the
 163 # link test to be run.
 164 #
 165 # Developers wanting to force a link test for a single module can use the
 166 # `linktest' target from within a module directory.
 167 #
 168 LINKTESTOBJ = $(KMDBDIR)/kmdb_modlinktest.o
 169
 170 KMDB_LINKTEST = \
 171         $(LD) $(LD_ZDEFS) -dy -r -o $@.linktest $(KMODOBJS) \
 172         $(STANDOBJS) $(LINKTESTOBJ) && \
 173         $(RM) $@.linktest
 174
 175 KMDB_LINKTEST_ENABLE=$(POUND_SIGN)
 176 $(KMDB_LINKTEST_ENABLE)KMDB_LINKTEST_CMD = $(KMDB_LINKTEST)
 177
 178 #
 179 # Ensure that dmods don't use floating point
 180 #
 181 KMDB_FPTEST_CMD = $(KMDB_FPTEST)
 182
 183 $(KMODFILE): kmod .WAIT $(KMODOBJS) $(MAPFILE)
 184         $(LD) -dy -r $(MAPFILE:%=-M%) -Nmisc/kmdbmod -o $@ $(KMODOBJS) \
 185         $(STANDOBJS)
 186         $(KMDB_LINKTEST_CMD)
 187         $(KMDB_FPTEST_CMD)
 188         $(CTFMERGE) -f -L VERSION -o $@ $(KMODOBJS)
 189         $(POST_PROCESS)
 190         $(SETDYNFLAG) -f DF_1_NOKSYMS $@
 191
 192 linktest: linktest_check .WAIT kmod .WAIT $(KMODOBJS)
 193         $(KMDB_LINKTEST)
 194
 195 linktest_check:
 196         @if [ "$(MDBTGT)" != "kvm" ] ; then \
 197                 echo "ERROR: linktest is not supported non-kvm/disasm dmods" \
 198                     >&2 ; \
 199                 exit 1 ; \
 200         fi
 201
 202 #
 203 # Dynamic rules for object construction
 204 #
 205 dmod/%.o kmod/%.o: %.c
 206         $(COMPILE.c) -o $@ $<
 207         $(CTFCONVERT_O)
 208
 209 dmod/%.o kmod%.o: %.s
 210         $(COMPILE.s) -o $@ $<
 211         $(CTFCONVERT_O)
 212
 213 dmod/%.o kmod/%.o: ../%.c
 214         $(COMPILE.c) -o $@ $<
 215         $(CTFCONVERT_O)
 216
 217 dmod/%.o kmod%.o: ../%.s
 218         $(COMPILE.s) -o $@ $<
 219         $(CTFCONVERT_O)
 220
 221 dmod/%.o kmod/%.o: ../../../common/modules/$(MODNAME)/%.c
 222         $(COMPILE.c) -o $@ $<
 223         $(CTFCONVERT_O)
 224
 225 dmod/%.o kmod%.o: ../../../common/modules/$(MODNAME)/%.s
 226         $(COMPILE.s) -o $@ $<
 227         $(CTFCONVERT_O)
 228
 229 dmod/%.o kmod/%.o: $$(MODSRCS_DIR)/%.c
 230         $(COMPILE.c) -o $@ $<
 231         $(CTFCONVERT_O)
 232
 233 dmod/%.o kmod%.o: $$(MODSRCS_DIR)/%.s
 234         $(COMPILE.s) -o $@ $<
 235         $(CTFCONVERT_O)
 236
 237 #
 238 # Installation targets
 239 #
 240
 241 $(ROOT)/usr/lib/mdb/$(MDBTGT): $(ROOT)/usr/lib/mdb
 242         $(INS.dir)
 243
 244 $(ROOT)/usr/lib/mdb:
 245         $(INS.dir)
 246
 247 $(ROOT)/kernel/kmdb:
 248         $(INS.dir)
 249
 250 $(ROOTMOD)/$(MODULE): $(ROOTMOD)
 251
 252 $(ROOTKMOD)/$(KMODULE): $(ROOTKMOD)
 253
 254 kmod dmod:
 255         -@mkdir -p $@