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 (c) 2010, Oracle and/or its affiliates. All rights reserved.
  24 #
  25 
  26 include $(SRC)/Makefile.master
  27 include $(SRC)/Makefile.buildnum
  28 
  29 #
  30 # Make sure we're getting a consistent execution environment for the
  31 # embedded scripts.
  32 #
  33 SHELL= /usr/bin/ksh93
  34 
  35 #
  36 # To suppress package dependency generation on any system, regardless
  37 # of how it was installed, set SUPPRESSPKGDEP=true in the build
  38 # environment.
  39 #
  40 SUPPRESSPKGDEP= false
  41 
  42 #
  43 # Comment this line out or set "PKGDEBUG=" in your build environment
  44 # to get more verbose output from the make processes in usr/src/pkg
  45 #
  46 PKGDEBUG= @
  47 
  48 #
  49 # Cross platform packaging notes
  50 #
  51 # By default, we package the proto area from the same architecture as
  52 # the packaging build.  In other words, if you're running nightly or
  53 # bldenv on an x86 platform, it will take objects from the x86 proto
  54 # area and use them to create x86 repositories.
  55 #
  56 # If you want to create repositories for an architecture that's
  57 # different from $(uname -p), you do so by setting PKGMACH in your
  58 # build environment.
  59 #
  60 # For this to work correctly, the following must all happen:
  61 #
  62 #   1. You need the desired proto area, which you can get either by
  63 #      doing a gatekeeper-style build with the -U option to
  64 #      nightly(1), or by using rsync.  If you don't do this, you will
  65 #      get packaging failures building all packages, because pkgsend
  66 #      is unable to find the required binaries.
  67 #   2. You need the desired tools proto area, which you can get in the
  68 #      same ways as the normal proto area.  If you don't do this, you
  69 #      will get packaging failures building onbld, because pkgsend is
  70 #      unable to find the tools binaries.
  71 #   3. The remainder of this Makefile should never refer directly to
  72 #      $(MACH).  Instead, $(PKGMACH) should be used whenever an
  73 #      architecture-specific path or token is needed.  If this is done
  74 #      incorrectly, then packaging will fail, and you will see the
  75 #      value of $(uname -p) instead of the value of $(PKGMACH) in the
  76 #      commands that fail.
  77 #   4. Each time a rule in this Makefile invokes $(MAKE), it should
  78 #      pass PKGMACH=$(PKGMACH) explicitly on the command line.  If
  79 #      this is done incorrectly, then packaging will fail, and you
  80 #      will see the value of $(uname -p) instead of the value of
  81 #      $(PKGMACH) in the commands that fail.
  82 #
  83 # Refer also to the convenience targets defined later in this
  84 # Makefile.
  85 #
  86 PKGMACH=        $(MACH)
  87 
  88 #
  89 # ROOT, TOOLS_PROTO, and PKGARCHIVE should be set by nightly or
  90 # bldenv.  These macros translate them into terms of $PKGMACH, instead
  91 # of $ARCH.
  92 #
  93 PKGROOT.cmd=    print $(ROOT) | sed -e s:/root_$(MACH):/root_$(PKGMACH):
  94 PKGROOT=        $(PKGROOT.cmd:sh)
  95 TOOLSROOT.cmd=  print $(TOOLS_PROTO) | sed -e s:/root_$(MACH):/root_$(PKGMACH):
  96 TOOLSROOT=      $(TOOLSROOT.cmd:sh)
  97 PKGDEST.cmd=    print $(PKGARCHIVE) | sed -e s:/$(MACH)/:/$(PKGMACH)/:
  98 PKGDEST=        $(PKGDEST.cmd:sh)
  99 
 100 EXCEPTIONS= packaging
 101 
 102 PKGMOGRIFY= pkgmogrify
 103 
 104 #
 105 # Always build the redistributable repository, but only build the
 106 # nonredistributable bits if we have access to closed source.
 107 #
 108 # Some objects that result from the closed build are still
 109 # redistributable, and should be packaged as part of an open-only
 110 # build.  Access to those objects is provided via the closed-bins
 111 # tarball.  See usr/src/tools/scripts/bindrop.sh for details.
 112 #
 113 REPOS= redist
 114 
 115 #
 116 # The packages directory will contain the processed manifests as
 117 # direct build targets and subdirectories for package metadata extracted
 118 # incidentally during manifest processing.
 119 #
 120 # Nothing underneath $(PDIR) should ever be managed by SCM.
 121 #
 122 PDIR= packages.$(PKGMACH)
 123 
 124 #
 125 # The tools proto must be specified for dependency generation.
 126 # Publication from the tools proto area is managed in the
 127 # publication rule.
 128 #
 129 $(PDIR)/developer-build-onbld.dep:= PKGROOT= $(TOOLSROOT)
 130 
 131 PKGPUBLISHER= $(PKGPUBLISHER_REDIST)
 132 
 133 #
 134 # To get these defaults, manifests should simply refer to $(PKGVERS).
 135 #
 136 PKGVERS_COMPONENT= 0.$(RELEASE)
 137 PKGVERS_BUILTON= $(RELEASE)
 138 PKGVERS_BRANCH= 0.$(ONNV_BUILDNUM)
 139 PKGVERS= $(PKGVERS_COMPONENT),$(PKGVERS_BUILTON)-$(PKGVERS_BRANCH)
 140 
 141 #
 142 # The ARCH32 and ARCH64 macros are used in the manifests to express
 143 # architecture-specific subdirectories in the installation paths
 144 # for isaexec'd commands.
 145 #
 146 # We can't simply use $(MACH32) and $(MACH64) here, because they're
 147 # only defined for the build architecture.  To do cross-platform
 148 # packaging, we need both values.
 149 #
 150 i386_ARCH32= i86
 151 sparc_ARCH32= sparcv7
 152 i386_ARCH64= amd64
 153 sparc_ARCH64= sparcv9
 154 
 155 OPENSSL =       /usr/bin/openssl
 156 OPENSSL10.cmd = $(OPENSSL) version | $(NAWK) '{if($$2<1){print "\043";}}'
 157 OPENSSL10_ONLY  =       $(OPENSSL10.cmd:sh)
 158 
 159 #
 160 # macros and transforms needed by pkgmogrify
 161 #
 162 # If you append to this list using target-specific assignments (:=),
 163 # be very careful that the targets are of the form $(PDIR)/pkgname.  If
 164 # you use a higher level target, or a package list, you'll trigger a
 165 # complete reprocessing of all manifests because they'll fail command
 166 # dependency checking.
 167 #
 168 PM_TRANSFORMS= common_actions publish restart_fmri facets defaults \
 169         extract_metadata
 170 PM_INC= transforms manifests
 171 
 172 PKGMOG_DEFINES= \
 173         i386_ONLY=$(POUND_SIGN) \
 174         sparc_ONLY=$(POUND_SIGN) \
 175         OPENSSL10_ONLY=$(OPENSSL10_ONLY) \
 176         $(PKGMACH)_ONLY= \
 177         ARCH=$(PKGMACH) \
 178         ARCH32=$($(PKGMACH)_ARCH32) \
 179         ARCH64=$($(PKGMACH)_ARCH64) \
 180         PKGVERS_COMPONENT=$(PKGVERS_COMPONENT) \
 181         PKGVERS_BUILTON=$(PKGVERS_BUILTON) \
 182         PKGVERS_BRANCH=$(PKGVERS_BRANCH) \
 183         PKGVERS=$(PKGVERS)
 184 
 185 PKGDEP_TOKENS_i386= \
 186         'PLATFORM=i86hvm' \
 187         'PLATFORM=i86pc' \
 188         'PLATFORM=i86xpv' \
 189         'ISALIST=amd64' \
 190         'ISALIST=i386'
 191 PKGDEP_TOKENS_sparc= \
 192         'PLATFORM=sun4u' \
 193         'PLATFORM=sun4v' \
 194         'ISALIST=sparcv9' \
 195         'ISALIST=sparc'
 196 PKGDEP_TOKENS= $(PKGDEP_TOKENS_$(PKGMACH))
 197 
 198 #
 199 # The package lists are generated with $(PKGDEP_TYPE) as their
 200 # dependency types, so that they can be included by either an
 201 # incorporation or a group package.
 202 #
 203 $(PDIR)/osnet-redist.mog := PKGDEP_TYPE= require
 204 $(PDIR)/osnet-incorporation.mog:= PKGDEP_TYPE= incorporate
 205 
 206 PKGDEP_INCORP= \
 207         depend fmri=consolidation/osnet/osnet-incorporation type=require
 208 
 209 #
 210 # All packaging build products should go into $(PDIR), so they don't
 211 # need to be included separately in CLOBBERFILES.
 212 #
 213 CLOBBERFILES= $(PDIR) proto_list_$(PKGMACH)
 214 
 215 #
 216 # By default, PKGS will list all manifests.  To build and/or publish a
 217 # subset of packages, override this on the command line or in the
 218 # build environment and then reference (implicitly or explicitly) the all
 219 # or install targets.
 220 #
 221 MANIFESTS :sh= (cd manifests; print *.mf)
 222 PKGS= $(MANIFESTS:%.mf=%)
 223 DEP_PKGS= $(PKGS:%=$(PDIR)/%.dep)
 224 PROC_PKGS= $(PKGS:%=$(PDIR)/%.mog)
 225 
 226 #
 227 # Track the synthetic manifests separately so we can properly express
 228 # build rules and dependencies.  The synthetic and real packages use
 229 # different sets of transforms and macros for pkgmogrify.
 230 #
 231 SYNTH_PKGS= osnet-incorporation osnet-redist
 232 DEP_SYNTH_PKGS= $(SYNTH_PKGS:%=$(PDIR)/%.dep)
 233 PROC_SYNTH_PKGS= $(SYNTH_PKGS:%=$(PDIR)/%.mog)
 234 
 235 #
 236 # Root of pkg image to use for dependency resolution
 237 # Normally / on the machine used to build the binaries
 238 #
 239 PKGDEP_RESOLVE_IMAGE = /
 240 
 241 #
 242 # For each package, we determine the target repository based on
 243 # manifest-embedded metadata.  Because we make that determination on
 244 # the fly, the publication target cannot be expressed as a
 245 # subdirectory inside the unknown-by-the-makefile target repository.
 246 #
 247 # In order to limit the target set to real files in known locations,
 248 # we use a ".pub" file in $(PDIR) for each processed manifest, regardless
 249 # of content or target repository.
 250 #
 251 PUB_PKGS= $(SYNTH_PKGS:%=$(PDIR)/%.pub) $(PKGS:%=$(PDIR)/%.pub)
 252 
 253 #
 254 # Any given repository- and status-specific package list may be empty,
 255 # but we can only determine that dynamically, so we always generate all
 256 # lists for each repository we're building.
 257 #
 258 # The meanings of each package status are as follows:
 259 #
 260 #       PKGSTAT         meaning
 261 #       ----------      ----------------------------------------------------
 262 #       noincorp        Do not include in incorporation or group package
 263 #       obsolete        Include in incorporation, but not group package
 264 #       renamed         Include in incorporation, but not group package
 265 #       current         Include in incorporation and group package
 266 #
 267 # Since the semantics of the "noincorp" package status dictate that
 268 # such packages are not included in the incorporation or group packages,
 269 # there is no need to build noincorp package lists.
 270 #
 271 PKGLISTS= \
 272         $(REPOS:%=$(PDIR)/packages.%.current) \
 273         $(REPOS:%=$(PDIR)/packages.%.renamed) \
 274         $(REPOS:%=$(PDIR)/packages.%.obsolete)
 275 
 276 .KEEP_STATE:
 277 
 278 .PARALLEL: $(PKGS) $(PROC_PKGS) $(DEP_PKGS) \
 279         $(PROC_SYNTH_PKGS) $(DEP_SYNTH_PKGS) $(PUB_PKGS)
 280 
 281 #
 282 # For a single manifest, the dependency chain looks like this:
 283 #
 284 #       raw manifest (mypkg.mf)
 285 #               |
 286 #               | use pkgmogrify to process raw manifest
 287 #               |
 288 #       processed manifest (mypkg.mog)
 289 #               |
 290 #          *    | use pkgdepend generate to generate dependencies
 291 #               |
 292 #       manifest with TBD dependencies (mypkg.dep)
 293 #               |
 294 #          %    | use pkgdepend resolve to resolve dependencies
 295 #               |
 296 #       manifest with dependencies resolved (mypkg.res)
 297 #               |
 298 #               | use pkgsend to publish the package
 299 #               |
 300 #       placeholder to indicate successful publication (mypkg.pub)
 301 #       
 302 # * This may be suppressed via SUPPRESSPKGDEP.  The resulting
 303 #   packages will install correctly, but care must be taken to
 304 #   install all dependencies, because pkg will not have the input
 305 #   it needs to determine this automatically.
 306 #
 307 # % This is included in this diagram to make the picture complete, but
 308 #   this is a point of synchronization in the build process.
 309 #   Dependency resolution is actually done once on the entire set of
 310 #   manifests, not on a per-package basis.
 311 #
 312 # The full dependency chain for generating everything that needs to be
 313 # published, without actually publishing it, looks like this:
 314 #
 315 #       processed synthetic packages
 316 #               |               |
 317 #       package lists       synthetic package manifests
 318 #               |
 319 #       processed real packages
 320 #           |           |
 321 #       package dir     real package manifests
 322 #
 323 # Here, each item is a set of real or synthetic packages.  For this
 324 # portion of the build, no reference is made to the proto area.  It is
 325 # therefore suitable for the "all" target, as opposed to "install."
 326 #
 327 # Since each of these steps is expressed explicitly, "all" need only
 328 # depend on the head of the chain.
 329 #
 330 # From the end of manifest processing, the publication dependency
 331 # chain looks like this:
 332 #
 333 #               repository metadata (catalogs and search indices)
 334 #                       |
 335 #                       | pkg.depotd
 336 #                       |
 337 #               published packages
 338 #                |              |
 339 #                |              | pkgsend publish
 340 #                |              |
 341 #         repositories      resolved dependencies
 342 #                |                      |
 343 # pkgsend        |                      | pkgdepend resolve
 344 # create-repository                     |
 345 #                |              generated dependencies
 346 #        repo directories               |
 347 #                                       | pkgdepend
 348 #                                       |
 349 #                               processed manifests
 350 # 
 351 
 352 ALL_TARGETS= $(PROC_SYNTH_PKGS) proto_list_$(PKGMACH)
 353 
 354 all: $(ALL_TARGETS)
 355 
 356 #
 357 # This will build the directory to contain the processed manifests
 358 # and the metadata symlinks.
 359 #
 360 $(PDIR):
 361         @print "Creating $(@)"
 362         $(PKGDEBUG)$(INS.dir)
 363 
 364 #
 365 # This rule resolves dependencies across all published manifests.
 366 #
 367 # We shouldn't have to ignore the error from pkgdepend, but until
 368 # 16012 and its dependencies are resolved, pkgdepend will always exit
 369 # with an error.
 370 #
 371 $(PDIR)/gendeps: $(DEP_SYNTH_PKGS) $(DEP_PKGS)
 372         -$(PKGDEBUG)if [ "$(SUPPRESSPKGDEP)" = "true" ]; then \
 373                 print "Suppressing dependency resolution"; \
 374                 for p in $(DEP_PKGS:%.dep=%); do \
 375                         $(CP) $$p.dep $$p.res; \
 376                 done; \
 377         else \
 378                 print "Resolving dependencies"; \
 379                 pkgdepend -R $(PKGDEP_RESOLVE_IMAGE) resolve \
 380                     -m $(DEP_SYNTH_PKGS) $(DEP_PKGS); \
 381                 for p in $(DEP_SYNTH_PKGS:%.dep=%) $(DEP_PKGS:%.dep=%); do \
 382                         if [ "$$(print $$p.metadata.*)" = \
 383                              "$$(print $$p.metadata.noincorp.*)" ]; \
 384                         then \
 385                                 print "Removing dependency versions from $$p"; \
 386                                 $(PKGMOGRIFY) $(PKGMOG_VERBOSE) \
 387                                     -O $$p.res -I transforms \
 388                                     strip_versions $$p.dep.res; \
 389                                 $(RM) $$p.dep.res; \
 390                         else \
 391                                 $(MV) $$p.dep.res $$p.res; \
 392                         fi; \
 393                 done; \
 394         fi
 395         $(PKGDEBUG)$(TOUCH) $(@)
 396 
 397 install: $(ALL_TARGETS) repository-metadata
 398 
 399 repository-metadata: publish_pkgs
 400         @print "Creating repository metadata"
 401         $(PKGDEBUG)for r in $(REPOS); do \
 402                 /usr/lib/pkg.depotd -d $(PKGDEST)/repo.$$r \
 403                         --add-content --exit-ready; \
 404         done
 405 
 406 #
 407 # Since we create zero-length processed manifests for a graceful abort
 408 # from pkgmogrify, we need to detect that here and make no effort to
 409 # publish the package.
 410 #
 411 # For all other packages, we publish them regardless of status.  We
 412 # derive the target repository as a component of the metadata-derived
 413 # symlink for each package.
 414 #
 415 publish_pkgs: $(REPOS:%=$(PKGDEST)/repo.%) $(PDIR)/gendeps .WAIT $(PUB_PKGS)
 416 
 417 #
 418 # Before publishing, we want to pull the license files from $CODEMGR_WS
 419 # into the proto area.  This allows us to NOT pass $SRC (or
 420 # $CODEMGR_WS) as a basedir for publication.
 421 #
 422 $(PUB_PKGS): stage-licenses
 423 
 424 #
 425 # Initialize the empty on-disk repositories
 426 #
 427 $(REPOS:%=$(PKGDEST)/repo.%):
 428         @print "Initializing $(@F)"
 429         $(PKGDEBUG)$(INS.dir)
 430         $(PKGDEBUG)pkgsend -s file://$(@) create-repository \
 431                 --set-property publisher.prefix=$(PKGPUBLISHER)
 432 
 433 #
 434 # rule to process real manifests
 435 #
 436 # To allow redistributability and package status to change, we must
 437 # remove not only the actual build target (the processed manifest), but
 438 # also the incidental ones (the metadata-derived symlinks).
 439 #
 440 # If pkgmogrify exits cleanly but fails to create the specified output
 441 # file, it means that it encountered an abort directive.  That means
 442 # that this package should not be published for this particular build
 443 # environment.  Since we can't prune such packages from $(PKGS)
 444 # retroactively, we need to create an empty target file to keep make
 445 # from trying to rebuild it every time.  For these empty targets, we
 446 # do not create metadata symlinks.
 447 #
 448 # Automatic dependency resolution to files is also done at this phase of
 449 # processing.  The skipped packages are skipped due to existing bugs
 450 # in pkgdepend.
 451 #
 452 # The incorporation dependency is tricky: it needs to go into all
 453 # current and renamed manifests (ie all incorporated packages), but we
 454 # don't know which those are until after we run pkgmogrify.  So
 455 # instead of expressing it as a transform, we tack it on ex post facto.
 456 #
 457 # Implementation notes:
 458 #
 459 # - The first $(RM) must not match other manifests, or we'll run into
 460 #   race conditions with parallel manifest processing.
 461 #
 462 # - The make macros [ie $(MACRO)] are evaluated when the makefile is
 463 #   read in, and will result in a fixed, macro-expanded rule for each
 464 #   target enumerated in $(PROC_PKGS).
 465 #
 466 # - The shell variables (ie $$VAR) are assigned on the fly, as the rule
 467 #   is executed.  The results may only be referenced in the shell in
 468 #   which they are assigned, so from the perspective of make, all code
 469 #   that needs these variables needs to be part of the same line of
 470 #   code.  Hence the use of command separators and line continuation
 471 #   characters.
 472 #
 473 # - The extract_metadata transforms are designed to spit out shell
 474 #   variable assignments to stdout.  Those are published to the
 475 #   .vars temporary files, and then used as input to the eval
 476 #   statement.  This is done in stages specifically so that pkgmogrify
 477 #   can signal failure if the manifest has a syntactic or other error.
 478 #   The eval statement should begin with the default values, and the
 479 #   output from pkgmogrify (if any) should be in the form of a
 480 #   variable assignment to override those defaults.
 481 #
 482 # - When this rule completes execution, it must leave an updated
 483 #   target file ($@) in place, or make will reprocess the package
 484 #   every time it encounters it as a dependency.  Hence the "touch"
 485 #   statement to ensure that the target is created, even when
 486 #   pkgmogrify encounters an abort in the publish transforms.
 487 #
 488 
 489 .SUFFIXES: .mf .mog .dep .res .pub
 490 
 491 $(PDIR)/%.mog: manifests/%.mf
 492         @print "Processing manifest $(<F)"
 493         @env PKGFMT_OUTPUT=v1 pkgfmt -c $<
 494         $(PKGDEBUG)$(RM) $(@) $(@:%.mog=%) $(@:%.mog=%.nodepend) \
 495                 $(@:%.mog=%.lics) $(PDIR)/$(@F:%.mog=%).metadata.* $(@).vars
 496         $(PKGDEBUG)$(PKGMOGRIFY) $(PKGMOG_VERBOSE) $(PM_INC:%= -I %) \
 497                 $(PKGMOG_DEFINES:%=-D %) -P $(@).vars -O $(@) \
 498                 $(<) $(PM_TRANSFORMS)
 499         $(PKGDEBUG)eval REPO=redist PKGSTAT=current NODEPEND=$(SUPPRESSPKGDEP) \
 500                 `$(CAT) -s $(@).vars`; \
 501         if [ -f $(@) ]; then \
 502                 if [ "$$NODEPEND" != "false" ]; then \
 503                          $(TOUCH) $(@:%.mog=%.nodepend); \
 504                 fi; \
 505                 $(LN) -s $(@F) \
 506                         $(PDIR)/$(@F:%.mog=%).metadata.$$PKGSTAT.$$REPO; \
 507                 if [ \( "$$PKGSTAT" = "current" \) -o \
 508                      \( "$$PKGSTAT" = "renamed" \) ]; \
 509                         then print $(PKGDEP_INCORP) >> $(@); \
 510                 fi; \
 511                 print $$LICS > $(@:%.mog=%.lics); \
 512         else \
 513                 $(TOUCH) $(@) $(@:%.mog=%.lics); \
 514         fi
 515         $(PKGDEBUG)$(RM) $(@).vars
 516 
 517 $(PDIR)/%.dep: $(PDIR)/%.mog
 518         @print "Generating dependencies for $(<F)"
 519         $(PKGDEBUG)$(RM) $(@)
 520         $(PKGDEBUG)if [ ! -f $(@:%.dep=%.nodepend) ]; then \
 521                 pkgdepend generate -m $(PKGDEP_TOKENS:%=-D %) $(<) \
 522                         $(PKGROOT) > $(@); \
 523         else \
 524                 $(CP) $(<) $(@); \
 525         fi
 526 
 527 #
 528 # The full chain implies that there should be a .dep.res suffix rule,
 529 # but dependency generation is done on a set of manifests, rather than
 530 # on a per-manifest basis.  Instead, see the gendeps rule above.
 531 #
 532 
 533 $(PDIR)/%.pub: $(PDIR)/%.res
 534         $(PKGDEBUG)m=$$(basename $(@:%.pub=%).metadata.*); \
 535         r=$${m#$(@F:%.pub=%.metadata.)+(?).}; \
 536         if [ -s $(<) ]; then \
 537                 print "Publishing $(@F:%.pub=%) to $$r repository"; \
 538                 pkgsend -s file://$(PKGDEST)/repo.$$r publish \
 539                     -d $(PKGROOT) -d $(TOOLSROOT) \
 540                     -d license_files -d $(PKGROOT)/licenses \
 541                     --fmri-in-manifest --no-index --no-catalog $(<) \
 542                     > /dev/null; \
 543         fi; \
 544         $(TOUCH) $(@);
 545 
 546 #
 547 # rule to build the synthetic manifests
 548 #
 549 # This rule necessarily has PKGDEP_TYPE that changes according to
 550 # the specific synthetic manifest.  Rather than escape command
 551 # dependency checking for the real manifest processing, or failing to
 552 # express the (indirect) dependency of synthetic manifests on real
 553 # manifests, we simply split this rule out from the one above.
 554 #
 555 # The implementation notes from the previous rule are applicable
 556 # here, too.
 557 #
 558 $(PROC_SYNTH_PKGS): $(PKGLISTS) $$(@F:%.mog=%.mf)
 559         @print "Processing synthetic manifest $(@F:%.mog=%.mf)"
 560         $(PKGDEBUG)$(RM) $(@) $(PDIR)/$(@F:%.mog=%).metadata.* $(@).vars
 561         $(PKGDEBUG)$(PKGMOGRIFY) $(PKGMOG_VERBOSE) -I transforms -I $(PDIR) \
 562                 $(PKGMOG_DEFINES:%=-D %) -D PKGDEP_TYPE=$(PKGDEP_TYPE) \
 563                 -P $(@).vars -O $(@) $(@F:%.mog=%.mf) \
 564                 $(PM_TRANSFORMS) synthetic
 565         $(PKGDEBUG)eval REPO=redist PKGSTAT=current `$(CAT) -s $(@).vars`; \
 566         if [ -f $(@) ]; then \
 567                 $(LN) -s $(@F) \
 568                         $(PDIR)/$(@F:%.mog=%).metadata.$$PKGSTAT.$$REPO; \
 569         else \
 570                 $(TOUCH) $(@); \
 571         fi
 572         $(PKGDEBUG)$(RM) $(@).vars
 573 
 574 $(DEP_SYNTH_PKGS): $$(@:%.dep=%.mog)
 575         @print "Skipping dependency generation for $(@F:%.dep=%)"
 576         $(PKGDEBUG)$(CP) $(@:%.dep=%.mog) $(@)
 577 
 578 clean:
 579 
 580 clobber: clean
 581         $(RM) -r $(CLOBBERFILES)
 582 
 583 #
 584 # This rule assumes that all links in the $PKGSTAT directories
 585 # point to valid manifests, and will fail the make run if one
 586 # does not contain an fmri.
 587 #
 588 # We do this in the BEGIN action instead of using pattern matching
 589 # because we expect the fmri to be at or near the first line of each input
 590 # file, and this way lets us avoid reading the rest of the file after we
 591 # find what we need.
 592 #
 593 # We keep track of a failure to locate an fmri, so we can fail the
 594 # make run, but we still attempt to process each package in the
 595 # repo/pkgstat-specific subdir, in hopes of maybe giving some
 596 # additional useful info.
 597 #
 598 # The protolist is used for bfu archive creation, which may be invoked
 599 # interactively by the user.  Both protolist and PKGLISTS targets
 600 # depend on $(PROC_PKGS), but protolist builds them recursively.
 601 # To avoid collisions, we insert protolist into the dependency chain
 602 # here.  This has two somewhat subtle benefits: it allows bfu archive
 603 # creation to work correctly, even when -a was not part of NIGHTLY_OPTIONS,
 604 # and it ensures that a protolist file here will always correspond to the
 605 # contents of the processed manifests, which can vary depending on build
 606 # environment.
 607 #
 608 $(PKGLISTS): $(PROC_PKGS)
 609         $(PKGDEBUG)sdotr=$(@F:packages.%=%); \
 610         r=$${sdotr%.+(?)}; s=$${sdotr#+(?).}; \
 611         print "Generating $$r $$s package list"; \
 612         $(RM) $(@); $(TOUCH) $(@); \
 613         $(NAWK) 'BEGIN { \
 614                 if (ARGC < 2) { \
 615                         exit; \
 616                 } \
 617                 retcode = 0; \
 618                 for (i = 1; i < ARGC; i++) { \
 619                         do { \
 620                                 e = getline f < ARGV[i]; \
 621                         } while ((e == 1) && (f !~ /name=pkg.fmri/)); \
 622                         close(ARGV[i]); \
 623                         if (e == 1) { \
 624                                 l = split(f, a, "="); \
 625                                 print "depend fmri=" a[l], \
 626                                         "type=$$(PKGDEP_TYPE)"; \
 627                         } else { \
 628                                 print "no fmri in " ARGV[i] >> "/dev/stderr"; \
 629                                 retcode = 2; \
 630                         } \
 631                 } \
 632                 exit retcode; \
 633         }' `find $(PDIR) -type l -a \( $(PKGS:%=-name %.metadata.$$s.$$r -o) \
 634                 -name NOSUCHFILE \)` >> $(@)
 635 
 636 #
 637 # rules to validate proto area against manifests, check for safe
 638 # file permission modes, and generate a faux proto list
 639 #
 640 # For the check targets, the dependencies on $(PROC_PKGS) is specified
 641 # as a subordinate make process in order to suppress output.
 642 #
 643 makesilent:
 644         @$(MAKE) -e $(PROC_PKGS) PKGMACH=$(PKGMACH) \
 645                 SUPPRESSPKGDEP=$(SUPPRESSPKGDEP) > /dev/null
 646 
 647 #
 648 # The .lics files were created during pkgmogrification, and list the
 649 # set of licenses to pull from $SRC for each package.  Because
 650 # licenses may be duplicated between packages, we uniquify them as
 651 # well as aggregating them here.
 652 #
 653 license-list: makesilent
 654         $(PKGDEBUG)( for l in `cat $(PROC_PKGS:%.mog=%.lics)`; \
 655                 do print $$l; done ) | sort -u > $@
 656 
 657 #
 658 # Staging the license and description files in the proto area allows
 659 # us to do proper unreferenced file checking of both license and
 660 # description files without blanket exceptions, and to pull license
 661 # content without reference to $CODEMGR_WS during publication.
 662 #
 663 stage-licenses: license-list FRC
 664         $(PKGDEBUG)$(MAKE) -e -f Makefile.lic \
 665                 PKGDEBUG=$(PKGDEBUG) LICROOT=$(PKGROOT)/licenses \
 666                 `$(NAWK) '{ \
 667                         print "$(PKGROOT)/licenses/" $$0; \
 668                         print "$(PKGROOT)/licenses/" $$0 ".descrip"; \
 669                 }' license-list` > /dev/null;
 670 
 671 protocmp: makesilent
 672         @validate_pkg -a $(PKGMACH) -v \
 673                 $(EXCEPTIONS:%=-e $(CODEMGR_WS)/exception_lists/%) \
 674                 -m $(PDIR) -p $(PKGROOT) -p $(TOOLSROOT)
 675 
 676 pmodes: makesilent
 677         @validate_pkg -a $(PKGMACH) -M -m $(PDIR) \
 678                 -e $(CODEMGR_WS)/exception_lists/pmodes 
 679 
 680 check: protocmp pmodes
 681 
 682 protolist: proto_list_$(PKGMACH)
 683 
 684 proto_list_$(PKGMACH): $(PROC_PKGS)
 685         @validate_pkg -a $(PKGMACH) -L -m $(PDIR) > $(@)
 686 
 687 $(PROC_PKGS): $(PDIR)
 688 
 689 #
 690 # This is a convenience target to allow package names to function as
 691 # build targets.  Generally, using it is only useful when iterating on
 692 # development of a manifest.
 693 #
 694 # When processing a manifest, use the basename (without extension) of
 695 # the package.  When publishing, use the basename with a ".pub"
 696 # extension.
 697 #
 698 # Other than during manifest development, the preferred usage is to
 699 # avoid these targets and override PKGS on the make command line and
 700 # use the provided all and install targets.
 701 #
 702 $(PKGS) $(SYNTH_PKGS): $(PDIR)/$$(@:%=%.mog)
 703 
 704 $(PKGS:%=%.pub) $(SYNTH_PKGS:%=%.pub): $(PDIR)/$$(@)
 705 
 706 #
 707 # This is a convenience target to resolve dependencies without publishing
 708 # packages.
 709 #
 710 gendeps: $(PDIR)/gendeps
 711 
 712 #
 713 # These are convenience targets for cross-platform packaging.  If you
 714 # want to build any of "the normal" targets for a different
 715 # architecture, simply use "arch/target" as your build target.
 716 #
 717 # Since the most common use case for this is "install," the architecture
 718 # specific install targets have been further abbreviated to elide "/install."
 719 #
 720 i386/% sparc/%:
 721         $(MAKE) -e $(@F) PKGMACH=$(@D) SUPPRESSPKGDEP=$(SUPPRESSPKGDEP)
 722 
 723 i386 sparc: $$(@)/install
 724 
 725 FRC:
 726 
 727 # EXPORT DELETE START
 728 XMOD_PKGS= \
 729         BRCMbnx \
 730         BRCMbnxe \
 731         SUNWadpu320 \
 732         SUNWibsdpib \
 733         SUNWkdc \
 734         SUNWlsimega \
 735         SUNWwbint \
 736         SUNWwbsup
 737 
 738 EXPORT_SRC: CRYPT_SRC
 739         $(RM) $(XMOD_PKGS:%=manifests/%.mf)
 740         $(RM) Makefile+
 741         $(SED) -e "/^# EXPORT DELETE START/,/^# EXPORT DELETE END/d" \
 742                 < Makefile > Makefile+
 743         $(MV) -f Makefile+ Makefile
 744         $(CHMOD) 444 Makefile
 745 # EXPORT DELETE END