#

# CDDL HEADER START

#

# The contents of this file are subject to the terms of the

# Common Development and Distribution License (the "License").

# You may not use this file except in compliance with the License.

#

# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

# or http://www.opensolaris.org/os/licensing.

# See the License for the specific language governing permissions

# and limitations under the License.

#

# When distributing Covered Code, include this CDDL HEADER in each

# file and include the License file at usr/src/OPENSOLARIS.LICENSE.

# If applicable, add the following below this CDDL HEADER, with the

# fields enclosed by brackets "[]" replaced with your own identifying

# information: Portions Copyright [yyyy] [name of copyright owner]

#

# CDDL HEADER END

#

#

# Copyright 2006 Sun Microsystems, Inc. All rights reserved.

# Use is subject to license terms.

#

# ident "%Z%%M% %I% %E% SMI"

#

################################################################################

#

# Linting the Linker Libraries

#

# Several of the linker's libraries are, in whole or in part, built in two

# passes, once as Elf32 and once as Elf64 (i.e. with -D_ELF64 defined). Lint

# needs to be able to do both passes, but combining the two is problematic for

# the 2nd pass of lint, as it sees many interfaces as being defined both ways

# and considers them to be incompatible. The targets defined here allow for

# both passes to live independently. This means that both the lint.out, and

# the lint library itself get generated separately, to different output files.

# The lint.out's get combined into a single lint.out report, and the lint

# libraries get generated with a 32/64 suffix. The dependents on these lint

# libraries, then, choose which version they need to use. Substitutions can

# be made automatically if the macro's defined in ./Makefile.com are used to

# specify the dependency, for those libs that need them.

#

# Don't

#

# Don't use the /*LINTLIBRARY*/ directive in linker libraries, this disables

# some important checks, including the ability to test format strings from the

# msg.h files.

#

# Don't use the `-x' option to lint when linting linker libraries. This masks

# all the dead wood in our own header files. Instead, there has been added to

# the relevant common directories a file called `lintsup.c' which is used to

# mask out the headers that we aren't interested in. This method is used for

# libraries, like libld, which have their own header files, but is irrelevant

# to libraries like libldstab which exports no interface of it's own.

#

# The `lintsup.c' file can also be used, in some cases, to mask out other

# issues that lint won't otherwise shut up about.

#

# Other Lint Options

#

# `-m' has been added to the LINTFLAGS. Warnings about globals that could be

# static are irrelevant as we use mapfiles to scope down unnecessary globals.

#

# `-u' is used in the LINTFLAGS for libraries, otherwise lint tends to be very

# noisy.

#

# `-x' is avoided for libraries, but is used for executables because all we

# care about is that what we use is defined, not about declarations in public

# headers that we don't use.

#

# Relevant variables:

#

# */Makefile.com

# SRCS= ../common/llib-l<libname>

# LINTSRCS= <source files>

# LDLIBS= ... [$(LDDBG_LIB) $(LD_LIB)]

# LINTFLAGS= ...

# LINTFLAGS64= ...

# CLEANFILES += ... $(LINTOUTS)

# CLOBBERFILES += ... $(LINTLIBS)

#

# Relevant targets:

#

# */Makefile.targ

# # this file for SGS lint targets.

# include $(SRC)/cmd/sgs/Makefile.targ

#

# lint: <choose the desired functionality> $(SGSLINTOUT)

#

# $(LINTLIB32),

# $(LINTLIB64) Create an Elf32 or Elf64 lint library from

# a proto file indicated by the $(SRCS) variable.

#

# $(LINTOUT32),

# $(LINTOUT64) Run lint on the sources indicated by the

# $(LINTSRCS) variable with respect to Elf32

# or Elf64. Dependencies are gathered from

# the $(LDLIBS) variable.

#

# $(SGSLINTOUT) Create a `lint.out' file as the concatination

# of the lint output from the previous targets.

# This should be specified *last* in the list.

#

################################################################################

#

# Override the OS's $(LINTOUT) target to avoid confusion.

#

LINTOUT = $(LINTOUT1)

#

# If LD_LIB, LDDBG_LIB, or CONV_LIB is added to LDLIBS, then the right lint

# library should be picked up automatically.

#

$(LINTOUT32) := LD_LIB=$(LD_LIB32)

$(LINTOUT32) := LDDBG_LIB=$(LDDBG_LIB32)

$(LINTOUT32) := CONV_LIB=$(CONV_LIB32)

$(LINTOUT64) := LD_LIB=$(LD_LIB64)

$(LINTOUT64) := LDDBG_LIB=$(LDDBG_LIB64)

$(LINTOUT64) := CONV_LIB=$(CONV_LIB64)

#

# Force $(LINTLIB) in order to help the $(SGSLINTOUT)

# target produce the same output on successive runs.

#

$(LINTLIB): FRC

$(LINTLIB32): $(SRCS)

$(LINT.c) -o $(LIBNAME32) $(SRCS)

$(LINTLIB64): $(SRCS)

$(LINT.c) -D_ELF64 -o $(LIBNAME64) $(SRCS)

$(LINTOUT32): $(LINTSRCS) $(LINTSRCS32)

$(LINT.c) $(LINTSRCS) $(LINTSRCS32) $(LDLIBS) > $(LINTOUT32) 2>&1

$(LINTOUT64): $(LINTSRCS) $(LINTSRCS64)

$(LINT.c) -D_ELF64 $(LINTSRCS) $(LINTSRCS64) \

$(LDLIBS) > $(LINTOUT64) 2>&1

$(SGSLINTOUT): FRC

@ rm -f $(SGSLINTOUT)

@ if [ -r $(LINTOUT1) ]; then \

echo "\n"$(LINTLIB) >> $(SGSLINTOUT); \

echo $(DASHES) >> $(SGSLINTOUT); \

cat $(LINTOUT1) >> $(SGSLINTOUT); \

fi

@ if [ -r $(LINTOUT32) ]; then \

if [ -n "$(DYNLIB)" ] ; then \

echo "\nElf32 - $(DYNLIB)" >> $(SGSLINTOUT); \

elif [ -n "$(RTLD)" ] ; then \

echo "\nElf32 - $(RTLD)" >> $(SGSLINTOUT); \

else echo "\nElf32 - $(PROG)" >> $(SGSLINTOUT); \

fi; \

echo $(DASHES) >> $(SGSLINTOUT); \

cat $(LINTOUT32) >> $(SGSLINTOUT); \

fi

@ if [ -r $(LINTOUT64) ]; then \

if [ -n "$(DYNLIB)" ] ; then \

if [ $(DYNLIB) = "libld.so.2" ] ; then \

echo "\nElf64 - libld.so.3" >> $(SGSLINTOUT); \

else \

echo "\nElf64 - $(DYNLIB)" >> $(SGSLINTOUT); \

fi; \

elif [ -n "$(RTLD)" ] ; then \

echo "\nElf64 - $(RTLD)" >> $(SGSLINTOUT); \

else echo "\nElf64 - $(PROG)" >> $(SGSLINTOUT); \

fi; \

echo $(DASHES) >> $(SGSLINTOUT); \

cat $(LINTOUT64) >> $(SGSLINTOUT); \

fi

@ rm -f $(LINTOUT1) $(LINTOUT32) $(LINTOUT64)

#

# For those that install the lint library source file.

#

$(ROOTLIBDIR)/$(LINTLIBSRC): ../common/$(LINTLIBSRC)

$(INS.file) ../common/$(LINTLIBSRC)

$(VAR_POUND_1)$(ROOTFS_LIBDIR)/$(LIBLINKS): \

$(ROOTFS_LIBDIR)/$(LIBLINKS)$(VERS)

$(VAR_POUND_1) $(INS.liblink)

$(VAR_POUND_1)$(ROOTFS_LIBDIR64)/$(LIBLINKS): \

$(ROOTFS_LIBDIR64)/$(LIBLINKS)$(VERS)

$(VAR_POUND_1) $(INS.liblink64)

$(VAR_POUND_1)$(ROOTFS_LIBDIR)/$(LIBLINKSCCC): \

$(ROOTFS_LIBDIR)/$(LIBLINKSCCC)$(VERS)

$(VAR_POUND_1) $(INS.liblinkccc)

$(VAR_POUND_1)$(ROOTFS_LIBDIR64)/$(LIBLINKSCCC): \

$(ROOTFS_LIBDIR64)/$(LIBLINKSCCC)$(VERS)

$(VAR_POUND_1) $(INS.liblinkccc64)

FRC: