zfs + replication: migrate dead zfs/diff_test.go to replication/logic/diff

(and remove the dead code from package zfs)

zfs/placeholder.go

@@ -0,0 +1,107 @@
+package zfs
+
+import (
+	"bytes"
+	"crypto/sha512"
+	"encoding/hex"
+	"fmt"
+	"io"
+	"os/exec"
+)
+
+const ZREPL_PLACEHOLDER_PROPERTY_NAME string = "zrepl:placeholder"
+
+type FilesystemState struct {
+	Placeholder bool
+	// TODO extend with resume token when that feature is finally added
+}
+
+// A somewhat efficient way to determine if a filesystem exists on this host.
+// Particularly useful if exists is called more than once (will only fork exec once and cache the result)
+func ZFSListFilesystemState() (localState map[string]FilesystemState, err error) {
+
+	var actual [][]string
+	if actual, err = ZFSList([]string{"name", ZREPL_PLACEHOLDER_PROPERTY_NAME}, "-t", "filesystem,volume"); err != nil {
+		return
+	}
+
+	localState = make(map[string]FilesystemState, len(actual))
+	for _, e := range actual {
+		dp, err := NewDatasetPath(e[0])
+		if err != nil {
+			return nil, fmt.Errorf("ZFS does not return parseable dataset path: %s", e[0])
+		}
+		placeholder, _ := IsPlaceholder(dp, e[1])
+		localState[e[0]] = FilesystemState{
+			placeholder,
+		}
+	}
+	return
+
+}
+
+// Computes the value for the ZREPL_PLACEHOLDER_PROPERTY_NAME ZFS user property
+// to mark the given DatasetPath p as a placeholder
+//
+// We cannot simply use booleans here since user properties are always
+// inherited.
+//
+// We hash the DatasetPath and use it to check for a given path if it is the
+// one originally marked as placeholder.
+//
+// However, this prohibits moving datasets around via `zfs rename`. The
+// placeholder attribute must be re-computed for the dataset path after the
+// move.
+//
+// TODO better solution available?
+func PlaceholderPropertyValue(p *DatasetPath) string {
+	ps := []byte(p.ToString())
+	sum := sha512.Sum512_256(ps)
+	return hex.EncodeToString(sum[:])
+}
+
+func IsPlaceholder(p *DatasetPath, placeholderPropertyValue string) (isPlaceholder bool, err error) {
+	expected := PlaceholderPropertyValue(p)
+	isPlaceholder = expected == placeholderPropertyValue
+	if !isPlaceholder {
+		err = fmt.Errorf("expected %s, has %s", expected, placeholderPropertyValue)
+	}
+	return
+}
+
+// for nonexistent FS, isPlaceholder == false && err == nil
+func ZFSIsPlaceholderFilesystem(p *DatasetPath) (isPlaceholder bool, err error) {
+	props, err := zfsGet(p.ToString(), []string{ZREPL_PLACEHOLDER_PROPERTY_NAME}, sourceAny)
+	if err == io.ErrUnexpectedEOF {
+		// interpret this as an early exit of the zfs binary due to the fs not existing
+		return false, nil
+	} else if err != nil {
+		return false, err
+	}
+	isPlaceholder, _ = IsPlaceholder(p, props.Get(ZREPL_PLACEHOLDER_PROPERTY_NAME))
+	return
+}
+
+func ZFSCreatePlaceholderFilesystem(p *DatasetPath) (err error) {
+	v := PlaceholderPropertyValue(p)
+	cmd := exec.Command(ZFS_BINARY, "create",
+		"-o", fmt.Sprintf("%s=%s", ZREPL_PLACEHOLDER_PROPERTY_NAME, v),
+		"-o", "mountpoint=none",
+		p.ToString())
+
+	stderr := bytes.NewBuffer(make([]byte, 0, 1024))
+	cmd.Stderr = stderr
+
+	if err = cmd.Start(); err != nil {
+		return err
+	}
+
+	if err = cmd.Wait(); err != nil {
+		err = &ZFSError{
+			Stderr:  stderr.Bytes(),
+			WaitErr: err,
+		}
+	}
+
+	return
+}