org.opensolaris.os.dtrace
Enum InterfaceAttributes.Stability

java.lang.Object
  extended by java.lang.Enum<InterfaceAttributes.Stability>
      extended by org.opensolaris.os.dtrace.InterfaceAttributes.Stability
All Implemented Interfaces:
java.io.Serializable, java.lang.Comparable<InterfaceAttributes.Stability>
Enclosing class:
InterfaceAttributes

public static enum InterfaceAttributes.Stability
extends java.lang.Enum<InterfaceAttributes.Stability>

Interface stability level. Assists developers in making risk assessments when developing scripts and tools based on DTrace by indicating how likely an interface or DTrace entity is to change in a future release or patch.


Enum Constant Summary
EVOLVING
          The interface might eventually become Standard or Stable but is still in transition.
EXTERNAL
          The interface is controlled by an entity other than Sun.
INTERNAL
          The interface is private to DTrace itself and represents an implementation detail of DTrace.
OBSOLETE
          The interface is supported in the current release but is scheduled to be removed, most likely in a future minor release.
PRIVATE
          The interface is private to Sun and represents an interface developed for use by other Sun products that is not yet publicly documented for use by customers and ISVs.
STABLE
          The interface is a mature interface under Sun's control.
STANDARD
          The interface complies with an industry standard.
UNSTABLE
          The interface is provided to give developers early access to new or rapidly changing technology or to an implementation artifact that is essential for observing or debugging system behavior for which a more stable solution is anticipated in the future.
 
Method Summary
 java.lang.String toString()
          Overridden to get the default display value.
static InterfaceAttributes.Stability valueOf(java.lang.String name)
          Returns the enum constant of this type with the specified name.
static InterfaceAttributes.Stability[] values()
          Returns an array containing the constants of this enum type, in the order they are declared.
 
Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Enum Constant Detail

INTERNAL

public static final InterfaceAttributes.Stability INTERNAL
The interface is private to DTrace itself and represents an implementation detail of DTrace. Internal interfaces might change in minor or micro releases.


PRIVATE

public static final InterfaceAttributes.Stability PRIVATE
The interface is private to Sun and represents an interface developed for use by other Sun products that is not yet publicly documented for use by customers and ISVs. Private interfaces might change in minor or micro releases.


OBSOLETE

public static final InterfaceAttributes.Stability OBSOLETE
The interface is supported in the current release but is scheduled to be removed, most likely in a future minor release. When support of an interface is to be discontinued, Sun will attempt to provide notification before discontinuing the interface. The D compiler might produce warning messages if you attempt to use an Obsolete interface.


EXTERNAL

public static final InterfaceAttributes.Stability EXTERNAL
The interface is controlled by an entity other than Sun. At Sun's discretion, Sun can deliver updated and possibly incompatible versions as part of any release, subject to their availability from the controlling entity. Sun makes no claims regarding either the source or binary compatibility for External interfaces between two releases. Applications based on these interfaces might not work in future releases, including patches that contain External interfaces.


UNSTABLE

public static final InterfaceAttributes.Stability UNSTABLE
The interface is provided to give developers early access to new or rapidly changing technology or to an implementation artifact that is essential for observing or debugging system behavior for which a more stable solution is anticipated in the future. Sun makes no claims about either source of binary compatibility for Unstable interfaces from one minor release to another.


EVOLVING

public static final InterfaceAttributes.Stability EVOLVING
The interface might eventually become Standard or Stable but is still in transition. Sun will make reasonable efforts to ensure compatibility with previous releases as it eveolves. When non-upward compatible changes become necessary, they will occur in minor and major releases. These changes will be avoided in micro releases whenever possible. If such a change is necessary, it will be documented in the release notes for the affected release, and when feasible, Sun will provide migration aids for binary compatibility and continued D program development.


STABLE

public static final InterfaceAttributes.Stability STABLE
The interface is a mature interface under Sun's control. Sun will try to avoid non-upward-compatible changes to these interfaces, especially in minor or micro releases. If support of a Stable interface must be discontinued, Sun will attempt to provide notification and the stability level changes to Obsolete.


STANDARD

public static final InterfaceAttributes.Stability STANDARD
The interface complies with an industry standard. The corresponding documentation for the interface will describe the standard to which the interface conforms. Standards are typically controlled by a standards development organization, and changes can be made to the interface in accordance with approved changes to the standard. This stability level can also apply to interfaces that have been adopted (without a formal standard) by an industry convention. Support is provided for only the specified versions of a standard; support for later versions is not guaranteed. If the standards development organization approves a non-upward-compatible change to a Standard interface that Sun decides to support, Sun will announce a compatibility and migration strategy.

Method Detail

values

public static InterfaceAttributes.Stability[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
for (InterfaceAttributes.Stability c : InterfaceAttributes.Stability.values())
    System.out.println(c);

Returns:
an array containing the constants of this enum type, in the order they are declared

valueOf

public static InterfaceAttributes.Stability valueOf(java.lang.String name)
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:
name - the name of the enum constant to be returned.
Returns:
the enum constant with the specified name
Throws:
java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
java.lang.NullPointerException - if the argument is null

toString

public java.lang.String toString()
Overridden to get the default display value. To internationalize the display value, use Enum.name() instead as a lookup key.

Overrides:
toString in class java.lang.Enum<InterfaceAttributes.Stability>