History

Akihiro Suda 5a1b06d7fd rerun vndr * run latest vndr so as to collect more LICENSE files * remove unused packages * vendor github.com/philhofer/fwd with LICENSE.md (MIT) * vendor github.com/bsphere/le_go with LICENSE (MIT) Signed-off-by: Akihiro Suda <suda.akihiro@lab.ntt.co.jp>		2017-03-08 02:29:34 +00:00
..
LICENSE	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00
README.md	rerun vndr	2017-03-08 02:29:34 +00:00
error.go	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00
utils.go	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00
utils_notsolaris.go	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00
utils_solaris.go	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00
zfs.go	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00
zpool.go	project: use vndr for vendoring	2016-11-03 15:31:46 -07:00

README.md

Go Wrapper for ZFS

Simple wrappers for ZFS command line tools.

Requirements

You need a working ZFS setup. To use on Ubuntu 14.04, setup ZFS:

sudo apt-get install python-software-properties
sudo apt-add-repository ppa:zfs-native/stable
sudo apt-get update
sudo apt-get install ubuntu-zfs libzfs-dev

Developed using Go 1.3, but currently there isn't anything 1.3 specific. Don't use Ubuntu packages for Go, use http://golang.org/doc/install

Generally you need root privileges to use anything zfs related.

Status

This has been only been tested on Ubuntu 14.04

In the future, we hope to work directly with libzfs.

Hacking

The tests have decent examples for most functions.

//assuming a zpool named test
//error handling ommitted


f, err := zfs.CreateFilesystem("test/snapshot-test", nil)
ok(t, err)

s, err := f.Snapshot("test", nil)
ok(t, err)

// snapshot is named "test/snapshot-test@test"

c, err := s.Clone("test/clone-test", nil)

err := c.Destroy()
err := s.Destroy()
err := f.Destroy()

Contributing

See the contributing guidelines