On Mon, Aug 07, 2006 at 04:53:27AM -0700, Thomas Maier-Komor wrote: > > I have noticed that the signature of zpool_iter has changed in the > latest NV builds in comparison to Solaris 10 update 2. Unfortunately > libzfs.h did not state that this is a private interface, so I assumed > that it would be stable across various releases. >
For future reference, if there is no manpage for a function or library, then it should be assumed to be private (or use elfdump -sv to see the symbol is SUNWprivate_1.1). In the past, we used to play tricks to 'hide' private interfaces, such as not shipping header files, shipping files in alternate locations, and not delivering .so links. This was found to be painful and unnecessary for those users who understood that the interfaces might change, but wanted to use them anyway. The more common practice today is to inform stability through documentation. But without any documentation or indication otherwise, please do not assume that any interface is public. We currently have no plans to make the libzfs interface stable. If we do undertake this task, it would likely be after the majority of the planned features have been implemented. - Eric -- Eric Schrock, Solaris Kernel Development http://blogs.sun.com/eschrock
