usr/src/common/mapfiles/gen/Makefile

   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 #
  23 # Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
  24 # Use is subject to license terms.
  25 # Copyright 2015 Igor Kozhukhov <ikozhukhov@gmail.com>
  26 #
  27
  28 include         $(SRC)/Makefile.master
  29
  30 FILES=  \
  31                 $(MACH)_gcc_map.noexeglobs
  32
  33 $(BUILD64)FILES += \
  34                 $(MACH64)_gcc_map.noexeglobs
  35
  36 SYMS1=          syms.1
  37 SYMS2=          syms.2
  38 MAIN1=          main.1
  39 MAIN2=          main.2
  40
  41 TEMPLATE1=      map.noexeglobs.1.template
  42 TEMPLATE2=      map.noexeglobs.2.template
  43
  44 all install:    $(FILES)
  45
  46 clean:
  47                 $(RM) $(SYMS1) $(SYMS2) $(MAIN1) $(MAIN2)
  48
  49 clobber:        clean
  50                 $(RM) $(FILES)
  51
  52 # A number of dynamic executables have their own definitions of interfaces that
  53 # exist in system libraries.  To prevent name-space pollution it is desirable
  54 # to demote the interfaces within these executable to locals.  However, various
  55 # symbols defined by the compiler drivers crt/values files need to remain
  56 # global in any dynamic object that includes these files.  These symbols
  57 # interpose on symbols in libc, or provide call backs for other system
  58 # libraries.  The various compiler drivers (cc and gcc), and the crt/values
  59 # files that these drivers are configured to include, differ between the
  60 # various compilations environments (platform, 32/64-bit).  Therefore, the
  61 # only means of creating a mapfile to demote symbols is to dynamically generate
  62 # the mapfile for a specific compilation environment.
  63 #
  64 # Here, template mapfiles are used to generate a number of compilation specific
  65 # mapfiles.  These mapfiles are referenced by components of the build through
  66 # the MAPFILE.NGB macro defined in Makefile.master.  These dynamically created
  67 # mapfiles are not delivered into the $ROOT area, and therefore are not
  68 # delivered as packaged components of the OSNet.
  69
  70 $(MACH)_gcc_map.noexeglobs :=   LINK =  $(LINK.c)
  71 $(MACH64)_gcc_map.noexeglobs := LINK =  $(LINK64.c)
  72
  73 # This generic target creates two dynamic executables from an empty "main"
  74 # program.  These objects are not executed, but are analyzed to determine the
  75 # global symbols each provides.
  76 #
  77 # The first executable demotes a family of known interfaces to local and allows
  78 # all other symbol definitions to remain global.  This executables provides the
  79 # base for discovering all symbol definitions provided by the various
  80 # compilation environments.  The second executable demotes all symbols to
  81 # locals.  Within both executables, some symbols remain globals (_end, _etext,
  82 # etc.) as the link-editor has special knowledge of these symbols and their
  83 # expected visibility requirements.  By inspecting the deferences between the
  84 # global symbols within the two executables, a mapfile can be generated to
  85 # ensure the symbols defined by the compilation environments files remain
  86 # global.
  87
  88 %map.noexeglobs:main.c $(TEMPLATE1) $(TEMPLATE2)
  89         $(LINK) -o $(MAIN1) -Wl,-M$(TEMPLATE1) main.c
  90         $(ELFDUMP) -s -N.dynsym $(MAIN1) | $(EGREP) "WEAK|GLOB" | \
  91             $(GREP) -v UNDEF | $(AWK) '{print $$9 }' | $(SORT) > $(SYMS1)
  92         $(LINK) -o $(MAIN2) -Wl,-M$(TEMPLATE2) main.c
  93         $(ELFDUMP) -s -N.dynsym $(MAIN2) | $(EGREP) "WEAK|GLOB" | \
  94             $(GREP) -v UNDEF | $(AWK) '{print $$9 }' | $(SORT) > $(SYMS2)
  95         $(ECHO) "# GENERATED FILE - DO NOT EDIT"        >  $@
  96         $(GREP) MAP-HEAD $(TEMPLATE2) | \
  97             $(SED) -e "s/       *# MAP-HEAD//"          >> $@
  98         $(DIFF) $(SYMS1) $(SYMS2) | $(GREP) "^<" | \
  99             $(SED) -e "s/^< \(.*\)/        \1;/"        >> $@
 100         $(GREP) MAP-TAIL $(TEMPLATE2) | \
 101             $(SED) -e "s/       *# MAP-TAIL//"          >> $@
 102         $(RM) $(SYMS1) $(SYMS2) $(MAIN1) $(MAIN2)