Makefile revision 824
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Copyright 2007-2008 Sun Microsystems, Inc. All Rights Reserved.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# This code is free software; you can redistribute it and/or modify it
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# under the terms of the GNU General Public License version 2 only, as
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# published by the Free Software Foundation. Sun designates this
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# particular file as subject to the "Classpath" exception as provided
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# by Sun in the LICENSE file that accompanied this code.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# This code is distributed in the hope that it will be useful, but WITHOUT
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# version 2 for more details (a copy is included in the LICENSE file that
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# accompanied this code).
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# You should have received a copy of the GNU General Public License version
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# 2 along with this work; if not, write to the Free Software Foundation,
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# CA 95054 USA or visit www.sun.com if you need additional information or
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# have any questions.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Makefile for building jce.jar and the various cryptographic strength
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# policy jar files.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# (The terms "OpenJDK" and "JDK" below refer to OpenJDK and Sun JDK builds
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# respectively.)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# JCE builds are very different between OpenJDK and JDK. The OpenJDK JCE
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# jar files do not require signing, but those for JDK do. If an unsigned
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# jar file is installed into JDK, things will break when the crypto
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# routines are called.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# This Makefile does the "real" build of the JCE files. There are some
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# javac options currently specific to JCE, so we recompile now to make
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# sure any implicit compilations didn't use any incorrect flags.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# For OpenJDK, the jar files built here are installed directly into the
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# For JDK, the binaries use pre-built/pre-signed/pre-obfuscated binary
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# files stored in the closed workspace that are not shipped in the
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# OpenJDK workspaces. We still build the JDK files here to verify the
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# files compile, and in preparation for possible signing and
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# obfuscation. Developers working on JCE in JDK must sign the JCE files
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# before testing: obfuscation is optional during development. The JCE
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# signing key is kept separate from the JDK workspace to prevent its
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# disclosure. The obfuscation tool has not been licensed for general
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# SPECIAL NOTE TO JCE/JDK developers: The source files must eventually
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# be built, obfuscated, signed, and the resulting jar files *MUST BE
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# CHECKED INTO THE CLOSED PART OF THE WORKSPACE*. This separate step
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# *MUST NOT BE FORGOTTEN*, otherwise a bug fixed in the source code will
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# not be reflected in the shipped binaries. The "release" target should
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# be used to generate the required files.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# There are a number of targets to help both JDK/OpenJDK developers.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Main Targets (JDK/OPENJDK):
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If OpenJDK, installs
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# jce.jar/limited policy files.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If JDK, installs prebuilt
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# jce.jar/limited policy files.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If OpenJDK, does not sign
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If JDK, tries to sign
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Other lesser-used Targets (JDK/OPENJDK):
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# build-jar Builds jce.jar (does not sign/install)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# build-policy Builds policy files (does not sign/install)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# install-jar Alias for "jar" above
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# install-limited Builds/installs limited policy files
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If OpenJDK, does not sign
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If JDK, tries to sign
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# install-unlimited Builds/nstalls unlimited policy files
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If OpenJDK, does not sign
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# If JDK, tries to sign
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Other targets (JDK only):
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# sign Alias for sign-jar and sign-policy
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# sign-jar Builds/signs jce.jar file (no install)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# sign-policy Builds/signs policy files (no install)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# release Builds all targets in preparation
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# for workspace integration.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# install-prebuilt Installs the pre-built jar files
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# This makefile was written to support parallel target execution.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# The following is for when we need to do postprocessing
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# (signing/obfuscation) against a read-only build. If the OUTPUTDIR
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# isn't writable, the build currently crashes out.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet # =====================================================
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet # Where to place the output, in case we're building from a read-only
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet # build area. (e.g. a release engineering build.)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Location for the newly built classfiles.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Subdirectories of these are automatically included.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Some licensees do not get the security sources, but we still need to
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# be able to build "all" for them. Check here to see if the sources were
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# available. If not, then we don't need to continue this rule.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreetall: build-jar install-jar build-policy install-limited
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreetelse # OPENJDK
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreetelse # FILES_java/policy files available
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# We use a variety of subdirectories in the $(TEMPDIR) depending on what
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# part of the build we're doing. Both OPENJDK/JDK builds are initially
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# done in the unsigned area. When files are signed or obfuscated in JDK,
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# they will be placed in the appropriate areas.
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# =====================================================
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# Build the unsigned jce.jar file. Signing/obfuscation comes later.
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# JCE building is somewhat involved.
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# OpenJDK: Since we do not ship prebuilt JCE files, previous compiles
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# in the build may have needed JCE class signatures. There were then
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# implicitly built by javac (likely using the boot javac). While using
8aec91825357bbeaf2ab5d30fc97fe5051a6b8ddstephh# those class files was fine for signatures, we need to rebuild using
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# the right compiler.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# JDK: Even through the jce.jar was previously installed, since the
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# source files are accessible in the source directories, they will
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# always be "newer" than the prebuilt files inside the jar, and thus
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# make will always rebuild them. (We could "hide" the JCE source in a
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# separate directory, but that would make the build logic for JDK and
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# OpenJDK more complicated.)
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Thus in either situation, we shouldn't use these files.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# To make sure the classes were built with the right compiler options,
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# delete the existing files in $(CLASSBINDIR), rebuild the right way in a
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# directory under $(TEMPDIR), then copy the files back to
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# $(CLASSBINDIR). Building in $(TEMPDIR) allows us to use our make
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# infrastructure without modification: .classes.list, macros, etc.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# The list of directories that will be remade from scratch, using the
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreetDELETE_DIRS = $(patsubst %, $(CLASSBINDIR)/%, $(AUTO_FILES_JAVA_DIRS))
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# Since the -C option to jar is used below, each directory entry must be
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreet# preceded with the appropriate directory to "cd" into.
00d0963faf2e861a4aef6b1bf28f99a5b2b20755dilpreetJAR_DIRS = $(patsubst %, -C $(CLASSDESTDIR) %, $(AUTO_FILES_JAVA_DIRS))
# Build jce.jar, then replace the previously built JCE files in the
unlimited: \
limited: \
@if [ ! -d $(CLASSDESTDIR) ] ; then \
$(presign)
$(preobfus)
@# The sun.security.internal classes are currently not obfuscated
@# so that they are included in the jce.jar file.
$(RM) -r \
$(CP) \
$(CP) \
# Install jce.jar, depending on which type is requested.
$(RM) \
$(RM) \
$(CP) \