| 1 |
# xenlight |
| 2 |
|
| 3 |
## About |
| 4 |
|
| 5 |
The xenlight package provides Go bindings to Xen's libxl C library via cgo. |
| 6 |
The package is currently in an unstable "experimental" state. This means |
| 7 |
the package is ready for initial use and evaluation, but is not yet fully |
| 8 |
functional. Namely, only a subset of libxl's API is implemented, and |
| 9 |
breaking changes may occur in future package versions. |
| 10 |
|
| 11 |
Much of the package is generated using the libxl IDL. Changes to the |
| 12 |
generated code can be made by modifying `tools/golang/xenlight/gengotypes.py` |
| 13 |
in the xen.git tree. |
| 14 |
|
| 15 |
## Getting Started |
| 16 |
|
| 17 |
```go |
| 18 |
import ( |
| 19 |
"xenbits.xenproject.org/git-http/xen.git/tools/golang/xenlight" |
| 20 |
) |
| 21 |
``` |
| 22 |
|
| 23 |
The module is not yet tagged independently of xen.git; if you don’t specify |
| 24 |
the version, you’ll get the most recent development version, which is |
| 25 |
probably not what you want. A better option would be to specify a Xen |
| 26 |
release tag; for instance: |
| 27 |
|
| 28 |
go get xenbits.xenproject.org/git-http/xen.git/tools/golang/[email protected]. |