Re: impossible to use <libzfs.h> out-of-tree

On Wed, Jun 11, 2025 at 9:53 PM Lexi Winter <ivy@freebsd.org> wrote:

> Alan Somers:
> > libzfs is unstable, and out-of-tree utilities should avoid using it, if
> > possible.  If an out-of-tree utility links to it, then that utility might
> > break as a result of an OS upgrade, even a minor one.
>
> understood, but right now no out-of-tree utility can link to libzfs
> since we don't ship the required headers.
>
> > [...] libzfs_core is stable, and its use is encouraged.
>
> i don't suppose there's any documentation somewhere on how to use it?
> the header file is rather uninformative.
>

I think the best documentation is to be found in the Python bindings:
https://pyzfs.readthedocs.io/en/latest/ .  They mostly apply to the C
library too, though.  And BTW, if anybody is interested in using
py-libzfs_core, I actually already wrote a port for it.  But I haven't
committed it to the public ports tree.  I'll do that if anybody would have
a use for it.
-Alan