snapper

Documentation

Index

• type Logger
• type Periodic
  • func (s *Periodic) Report() Report
  • func (s *Periodic) Run(ctx context.Context, snapshotsTaken chan<- struct{}, cron *cron.Cron)
  • func (s *Periodic) RunPeriodic() bool
  • func (s *Periodic) Shutdown()
• type PeriodicReport
  • func (self *PeriodicReport) Running() time.Duration
• type Report
  • func (self *Report) Error() string
  • func (self *Report) Running() time.Duration
• type ReportFilesystem
• type SnapState
  • func (i SnapState) String() string
• type Snapper
  • func FromConfig(g *config.Global, fsf zfs.DatasetFilter, in config.SnapshottingEnum) (Snapper, error)
• type State
  • func (i State) String() string
• type Type

Types

type Logger

type Logger = logger.Logger

type Periodic

type Periodic struct {
	// contains filtered or unexported fields
}

func (*Periodic) Report

func (s *Periodic) Report() Report

func (*Periodic) Run

func (s *Periodic) Run(ctx context.Context, snapshotsTaken chan<- struct{},
	cron *cron.Cron,
)

func (*Periodic) RunPeriodic

func (s *Periodic) RunPeriodic() bool

func (*Periodic) Shutdown

func (s *Periodic) Shutdown()

type PeriodicReport

type PeriodicReport struct {
	CronSpec string
	State    State
	// valid in state SyncUp and Waiting
	SleepUntil time.Time
	// valid in state Err
	Error string
	// valid in state Snapshotting
	Progress []*ReportFilesystem
}

func (*PeriodicReport) Running

func (self *PeriodicReport) Running() time.Duration

type Report

type Report struct {
	Type     Type
	Periodic *PeriodicReport
	Manual   *struct{}
}

func (*Report) Error

func (self *Report) Error() string

func (*Report) Running

func (self *Report) Running() time.Duration

type ReportFilesystem

type ReportFilesystem struct {
	Path  string
	State SnapState

	// Valid in SnapStarted and later
	SnapName      string
	StartAt       time.Time
	Hooks         string
	HooksHadError bool

	// Valid in SnapDone | SnapError
	DoneAt time.Time
}

type SnapState

type SnapState uint

const (
	SnapPending SnapState = 1 << iota
	SnapStarted
	SnapDone
	SnapError
)

func (SnapState) String

func (i SnapState) String() string

type Snapper

type Snapper interface {
	RunPeriodic() bool
	Run(ctx context.Context, snapshotsTaken chan<- struct{}, cron *cron.Cron)
	Report() Report
	Shutdown()
}

func FromConfig

func FromConfig(g *config.Global, fsf zfs.DatasetFilter, in config.SnapshottingEnum) (Snapper, error)

type State

type State uint

const (
	SyncUp State = 1 << iota
	SyncUpErrWait
	Planning
	Snapshotting
	Waiting
	ErrorWait
	Stopped
)

func (State) String

func (i State) String() string

type Type

type Type string

const (
	TypePeriodic Type = "periodic"
	TypeCron     Type = "cron"
	TypeManual   Type = "manual"
)