[Swan] About libreswan library and man page

[Paul Wouters]

On Fri, 22 Sep 2023, Linzhang Liang wrote:

> I am interested in accessing the programming interfaces of libreswan, which in my opinion is to use the
> lib-libreswan. I can find the actual libraries and the header files under "/lib" and "/include" of the source code
> base, respectively, but I can't seem to find the corresponding documentation for the use of the library. Is there a
> documentation site just for the library of libreswan?
> 
> I installed libreswan on my Ubuntu 22.04 VM but I cannot find the man page of "ipsec". Is there a way that I can
> install the man page onto my VM?

Unfortunately, we don't have a library and API that is stable for that.
You can use various commands to get status:
ipsec status
ipsec trafficstatus
ipsec shuntstatus
ipsec globalstatus

We had wanted to build a varlink API to avoid needing to do a dbus API,
as dbus libraries are horrible, but it seems varlink never gained
momentum either. So we are now pondering just doing raw json output
so other tools can read and parse what they want.

Paul