How to use Yosys as a library

## Using Yosys as a library

First you need to build Yosys with lib support. Go into the Yosys top level `Makefile` and set the build flag `ENABLE_LIBYOSYS := 1`

Then, build Yosys as usual.

After this is done there should be a `libyosys.so` build artifact. This needs to made available to the C++ compiler/linker. The easiest way to do this is to copy it to `/usr/local/lib/libyosys.so`.

Next, the header files need to be made available for inclusion in your code. To achieve this, symlink the `yosys/share/include/kernel` folder into your `/usr/local/include` e.g. `cd /usr/local/include/` and then `sudo ln -s <YOSYS_DIR>/share/include/kernel` where `<YOSYS_DIR>` should be replaced by the location of your Yosys tree.