Package libvirt provides a pure Go interface for interacting with Libvirt. Apache 2.0 Licensed.
Go Shell
Latest commit 2609dd2 Jan 20, 2017 @benlemasurier benlemasurier committed on GitHub Add Secrets() (#29)
This adds the `Secrets()` method, used to retrieve all secrets managed
by the libvirt daemon.

libvirt GoDoc Build Status Report Card

Package libvirt provides a pure Go interface for interacting with Libvirt.

Rather than using Libvirt's C bindings, this package makes use of Libvirt's RPC interface, as documented here. Connections to the libvirt server may be local, or remote. RPC packets are encoded using the XDR standard as defined by RFC 4506.

This should be considered a work in progress. Most functionaly provided by the C bindings have not yet made their way into this library. Pull requests are welcome! The definition of the RPC protocol is in the libvirt source tree under src/rpc/virnetprotocol.x.

Feel free to join us in #go-qemu on freenode if you'd like to discuss the project.


All packages contained in this repository should be treated as pre-production software with an unstable API.

While these package are reasonably well-tested and have seen some use inside of DigitalOcean, there may be subtle bugs which could cause the packages to act in unexpected ways. Use at your own risk!

In addition, the API is not considered stable at this time. If you would like to include package libvirt in a project, we highly recommend vendoring it into your project.


package main

import (


func main() {
    //c, err := net.DialTimeout("tcp", "", 2*time.Second)
    //c, err := net.DialTimeout("tcp", "", 2*time.Second)
    c, err := net.DialTimeout("unix", "/var/run/libvirt/libvirt-sock", 2*time.Second)
    if err != nil {
        log.Fatalf("failed to dial libvirt: %v", err)

    l := libvirt.New(c)
    if err := l.Connect(); err != nil {
        log.Fatalf("failed to connect: %v", err)

    v, err := l.Version()
    if err != nil {
        log.Fatalf("failed to retrieve libvirt version: %v", err)
    fmt.Println("Version:", v)

    domains, err := l.Domains()
    if err != nil {
        log.Fatalf("failed to retrieve domains: %v", err)

    for _, d := range domains {
        fmt.Printf("%d\t%s\t%x\n", d.ID, d.Name, d.UUID)

    if err := l.Disconnect(); err != nil {
        log.Fatal("failed to disconnect: %v", err)
Version: 1.3.4
ID  Name        UUID
1   Test-1      dc329f87d4de47198cfd2e21c6105b01
2   Test-2      dc229f87d4de47198cfd2e21c6105b01