ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# CDDL HEADER START
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# The contents of this file are subject to the terms of the
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Common Development and Distribution License (the "License").
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# You may not use this file except in compliance with the License.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# or http://www.opensolaris.org/os/licensing.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# See the License for the specific language governing permissions
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# and limitations under the License.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# When distributing Covered Code, include this CDDL HEADER in each
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# If applicable, add the following below this CDDL HEADER, with the
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# fields enclosed by brackets "[]" replaced with your own identifying
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# information: Portions Copyright [yyyy] [name of copyright owner]
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# CDDL HEADER END
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# For packagers:
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# This ruleset is useful for "system" components-- ones which are expected
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# to appear primarily in the global zone, but which may have some small
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# pieces (man pages, header files) which may need to appear in all zones.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# The current rules specify that all payload-bearing actions (file,
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# dir, hardlink, link) should appear *only* in the global zone, with
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# the following exceptions:
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# - man pages appear in all zones
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# - header files appear in all zones
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# - mdb(1) modules appear in all zones
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# You may well have other actions which you wish to appear in all zones.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# An example would be an administrative utility for a driver which has
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# been virtualized to work within zones. For those actions you wish to
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# appear in all zones, add the following attribute to your action.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# variant.opensolaris.zone=__NODEFAULT
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# You DO NOT need to specify __NODEFAULT for man pages, headers, or
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# mdb modules, as those are covered by the automatic rules below.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Note: When you specify variant.opensolaris.zone=__NODEFAULT, the
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# net effect is that *no* variant.opensolaris.zone attribute will
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# appear in the post-processed manifest.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# For packaging nerds:
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# We have a problem to solve here: To make an action appear in all zones,
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# it should have *no* variant.opensolaris.zone attribute. So it's a bit
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# more complicated to use "default".
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Here's what we do: we use "default" to set all payload bearing actions
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# which have no variant.opensolaris.zone attribute to be
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# variant.opensolaris.zone=global. For those actions which need to appear
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# in all zones, the packager must specify
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# variant.opensolaris.zone=__NODEFAULT. Additionally we have some rules
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# which set __NODEFAULT for a few classes of well known things, like man
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# pages and headers.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# We then go through and clean up all of the __NODEFAULTed attributes by
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# simply deleting them.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Man pages should appear in all zones.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir file link hardlink path=.*/man/.* -> default variant.opensolaris.zone __NODEFAULT>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir path=.*/man$ -> default variant.opensolaris.zone __NODEFAULT>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Headers should appear in all zones.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir file link hardlink path=.*/include/.* -> default variant.opensolaris.zone __NODEFAULT>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir path=.*/include$ -> default variant.opensolaris.zone __NODEFAULT>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# MDB modules should appear in all zones, as one might debug a crash dump
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# in a zone.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir file link hardlink path=.*/mdb/.* -> default variant.opensolaris.zone __NODEFAULT>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir path=.*/mdb$ -> default variant.opensolaris.zone __NODEFAULT>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Everything else is global zone only unless the user overrides
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# action-by-action with __NODEFAULT.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir file link hardlink -> default variant.opensolaris.zone global>
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price# Buff out the __NODEFAULT attributes.
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price#
ebbab6bbae913efeadfa3c6a1b082664a125f95bDan Price<transform dir file link hardlink -> delete variant.opensolaris.zone __NODEFAULT>