Jordan Brown writes: > David Bustos wrote: > > Quoth Jordan Brown on Wed, Sep 10, 2008 at 10:04:47AM -0700: > >> 1) Is there a list of the stabilities of the various properties? I > >> assume that some are stable, but I assume that others are not. > > > > Stable, public properties should be documented as such in the manpages. > > svc.startd(1M) and smf_restarter(5) document a number of properties, but > do not specify stabilities.
In general, things that are documented via man pages without an explicit stability level and that don't have explicit warnings on them about usage are treated as Committed. It turns out to be easy to derive this. The interface taxonomy is here: http://opensolaris.org/os/community/arc/policies/interface-taxonomy/ If it's documented in a man page, then (by definition) it's one of either "Committed," "Uncommitted," or "Volatile" as these are the only public stability levels with specifications. (All else are some form of "Private," as they lack man page documentation.) Digging deeper, "Uncommitted" requires a warning. As the taxonomy says: Any documentation for an Uncommitted interface must contain warnings that "these interfaces are subject to change without warning and should not be used in unbundled products". As does "Volatile:" All Volatile interfaces should be labeled as such in all associated documentation and the consequence of using such interfaces must be explained either as part of that documentation or by reference. That leaves "Committed." That's the only thing those can reasonably be by default. Obviously, if someone needed to assert a different stability level (and could show that there's some reason that changing it would be expected or required or otherwise a Good Thing), then a future ARC case could change that. > Sorry... I was looking for the specification for the syntax of the FMRI, > something that says that an FMRI is > svc:<servicename>:<instancename>/:properties/<propgroup>/<propname> > or whatever it is. The /:properties part was new to me. That was part of the original Greenline case -- PSARC 2002/547. -- James Carlson, Solaris Networking <james.d.carlson at sun.com> Sun Microsystems / 35 Network Drive 71.232W Vox +1 781 442 2084 MS UBUR02-212 / Burlington MA 01803-2757 42.496N Fax +1 781 442 1677
