The following attributes can be set on link actions to control how mediated links are delivered:
Specifies the entry in the mediation namespace shared by all path names that participate in a given mediation group. Examples include java, python, and ruby.
Every link that has a mediator attribute must also have either a mediator-version attribute or a mediator-implementation attribute. All mediated links for a given path name must specify the same mediator. However, not all mediator versions and implementations need to provide a link at a given path. If a mediation participant does not provide a link, then the link is removed when that participant is selected as the preferred implementation.
Specifies the version of the interface described by the mediator attribute. This attribute is required if mediator is specified and mediator-implementation is not specified. The value of mediator-version is a dot-separated sequence of integers. For ease of use, the value specified should match the version of the package that is delivering the link. For example, the runtime/ruby-19 package should specify mediator-version=1.9. Setting the version value appropriately helps administrators determine what software is participating in the mediation, which packages delivered that software, and which version of the software is currently set as the preferred version. If no participant in the mediation has a mediator-priority set, pkg(5) selects the mediation participant with the highest value mediator-version as the preferred implementation.
Specifies the implementation of the interface described by the mediator attribute. This attribute is required if mediator is specified and mediator-version is not specified. Implementation strings are not considered to be ordered. An implementation is arbitrarily selected by pkg(5) as the preferred implementation if no participant in the mediation has a mediator-version or mediator-priority set.
The value of mediator-implementation can be a string of arbitrary length composed of alphanumeric characters and spaces. If the implementation itself can be versioned, then the version should be specified at the end of the string, after an at sign (@). The version is a dot-separated sequence of integers. If multiple versions of an implementation exist, the implementation with the highest version is selected. For example, a mediator-implementation value of 4DB@12 would be selected over a mediator-implementation value of 4DB@11.
Specifies the priority of the interface described by the mediator attribute. Either a mediator-version or a mediator-implementation must also be specified. For example, if one participant in the mediation has a mediator-version value of 1.6 and another participant has a mediator-version value of 1.7, the participant with the mediator-version value of 1.6 can be specified as the preferred implementation by assigning a mediator-priority attribute.
The mediator-priority attribute can have one of the following values:
The link is preferred over those that do not have a mediator-priority specified.
The link is preferred over those that do not have a mediator-priority specified and over those that have a mediator-priority value of vendor.