1193N/A#

1466N/A# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.

1193N/A#

1193N/A# Permission is hereby granted, free of charge, to any person obtaining a

1193N/A# copy of this software and associated documentation files (the "Software"),

1193N/A# to deal in the Software without restriction, including without limitation

1193N/A# the rights to use, copy, modify, merge, publish, distribute, sublicense,

1193N/A# and/or sell copies of the Software, and to permit persons to whom the

1193N/A# Software is furnished to do so, subject to the following conditions:

1193N/A#

1193N/A# The above copyright notice and this permission notice (including the next

1193N/A# paragraph) shall be included in all copies or substantial portions of the

1193N/A# Software.

1193N/A#

1193N/A# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

1193N/A# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

1193N/A# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL

1193N/A# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

1193N/A# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

1193N/A# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

1193N/A# DEALINGS IN THE SOFTWARE.

1193N/A

1193N/A#

1193N/A# For packagers:

1193N/A#

1193N/A# This ruleset is useful for "system" components-- ones which are expected

1193N/A# to appear primarily in the global zone, but which may have some small

1193N/A# pieces (man pages, header files) which may need to appear in all zones.

1466N/A#

1466N/A# The current rules specify that all payload-bearing actions (file,

1466N/A# dir, hardlink, link) should appear *only* in the global zone, with

1193N/A# the following exceptions:

1356N/A#

1356N/A# - man pages appear in all zones

1356N/A# - header files appear in all zones

1356N/A# - mdb(1) modules appear in all zones

1356N/A#

1356N/A# You may well have other actions which you wish to appear in all zones.

1356N/A# An example would be an administrative utility for a driver which has

1356N/A# been virtualized to work within zones. For those actions you wish to

1356N/A# appear in all zones, add the following attribute to your action.

1466N/A#

1466N/A# variant.opensolaris.zone=__NODEFAULT

1193N/A#

1193N/A# You DO NOT need to specify __NODEFAULT for man pages, headers, or

1193N/A# mdb modules, as those are covered by the automatic rules below.

1193N/A#

1193N/A# Note: When you specify variant.opensolaris.zone=__NODEFAULT, the

1193N/A# net effect is that *no* variant.opensolaris.zone attribute will

1193N/A# appear in the post-processed manifest.

1193N/A#

1195N/A

1466N/A#

1466N/A# For packaging nerds:

1193N/A#

1193N/A# We have a problem to solve here: To make an action appear in all zones,

# it should have *no* variant.opensolaris.zone attribute. So it's a bit

# more complicated to use "default".

#

# Here's what we do: we use "default" to set all payload bearing actions

# which have no variant.opensolaris.zone attribute to be

# variant.opensolaris.zone=global. For those actions which need to appear

# in all zones, the packager must specify

# variant.opensolaris.zone=__NODEFAULT. Additionally we have some rules

# which set __NODEFAULT for a few classes of well known things, like man

# pages and headers.

#

# We then go through and clean up all of the __NODEFAULTed attributes by

# simply deleting them.

#

# Man pages should appear in all zones.

<transform dir file link hardlink path=.*/man/.* -> default variant.opensolaris.zone __NODEFAULT>

<transform dir path=.*/man$ -> default variant.opensolaris.zone __NODEFAULT>

# Headers should appear in all zones.

<transform dir file link hardlink path=.*/include/.* -> default variant.opensolaris.zone __NODEFAULT>

<transform dir path=.*/include$ -> default variant.opensolaris.zone __NODEFAULT>

# MDB modules should appear in all zones, as one might debug a crash dump

# in a zone.

<transform dir file link hardlink path=.*/mdb/.* -> default variant.opensolaris.zone __NODEFAULT>

<transform dir path=.*/mdb$ -> default variant.opensolaris.zone __NODEFAULT>

# Everything else is global zone only unless the user overrides

# action-by-action with __NODEFAULT.

<transform dir file link hardlink -> default variant.opensolaris.zone global>

#

# Buff out the __NODEFAULT attributes.

#

<transform dir file link hardlink -> delete variant.opensolaris.zone __NODEFAULT>