Folks, Is the API for zfs documented anywhere? Specifically, I am looking at zpool_create() method. I have looked at the source code for zpool command line. However, it is not clear on what the last three parameters to the function are and how to fill them. Thank you in advance for your help. Regards, Peter -- This message posted from opensolaris.org
On 09/21/10 06:23 PM, Peter Taps wrote:> Folks, > > Is the API for zfs documented anywhere? > > Specifically, I am looking at zpool_create() method. I have looked at the source code for zpool command line. However, it is not clear on what the last three parameters to the function are and how to fill them. > >The best documentation for libzfs functions is the user command code that uses them. -- Ian.
On Wed, Sep 22, 2010 at 08:49:25AM +1200, Ian Collins wrote:> On 09/21/10 06:23 PM, Peter Taps wrote: > >Folks, > > > >Is the API for zfs documented anywhere? > > > >Specifically, I am looking at zpool_create() method. I have looked at > >the source code for zpool command line. However, it is not clear on > >what the last three parameters to the function are and how to fill > >them. > > > The best documentation for libzfs functions is the user command code > that uses them.And they are not public, and may change in completely incompatible ways without notice. That''s why all of the symbols are versioned "SUNWprivate_1.1". Cheers, - jonathan
On 09/22/10 11:24 AM, Jonathan Adams wrote:> On Wed, Sep 22, 2010 at 08:49:25AM +1200, Ian Collins wrote: > >> On 09/21/10 06:23 PM, Peter Taps wrote: >> >>> Folks, >>> >>> Is the API for zfs documented anywhere? >>> >>> Specifically, I am looking at zpool_create() method. I have looked at >>> the source code for zpool command line. However, it is not clear on >>> what the last three parameters to the function are and how to fill >>> them. >>> >>> >> The best documentation for libzfs functions is the user command code >> that uses them. >> > And they are not public, and may change in completely incompatible ways without > notice. That''s why all of the symbols are versioned "SUNWprivate_1.1". > >Where is this versioning documented? There''s nothing in the header and libzfs doesn''t have a man page. -- Ian.
On Wed, Sep 22, 2010 at 11:28:15AM +1200, Ian Collins wrote:> On 09/22/10 11:24 AM, Jonathan Adams wrote: > >On Wed, Sep 22, 2010 at 08:49:25AM +1200, Ian Collins wrote: > >>On 09/21/10 06:23 PM, Peter Taps wrote: > >>>Folks, > >>> > >>>Is the API for zfs documented anywhere? > >>> > >>>Specifically, I am looking at zpool_create() method. I have looked at > >>>the source code for zpool command line. However, it is not clear on > >>>what the last three parameters to the function are and how to fill > >>>them. > >>> > >>The best documentation for libzfs functions is the user command code > >>that uses them. > >And they are not public, and may change in completely incompatible ways without > >notice. That''s why all of the symbols are versioned "SUNWprivate_1.1". > > > Where is this versioning documented? > > There''s nothing in the header and libzfs doesn''t have a man page.The lack of a manpage is the first clue that it''s not a public interface. Most private-only libraries don''t ship a "libfoo.so" symlink, but for some reason libzfs.so exists; not sure why. Cheers, - jonathan