persist

Documentation

Overview

Package persist contains the Persist type.

Index

• type Persist
  • func (src *Persist) Clone() *Persist
  • func (p *Persist) Equals(p2 *Persist) bool
  • func (p *Persist) Pretty() string
  • func (p *Persist) PublicNodeKey() key.NodePublic
  • func (p *Persist) PublicNodeKeyOK() (pub key.NodePublic, ok bool)
  • func (p *Persist) View() PersistView
• type PersistView
  • func (v PersistView) AsStruct() *Persist
  • func (v PersistView) DisallowedTKAStateIDs() views.Slice[string]
  • func (p PersistView) Equals(p2 PersistView) bool
  • func (v PersistView) LegacyFrontendPrivateMachineKey() key.MachinePrivate
  • func (v PersistView) MarshalJSON() ([]byte, error)
  • func (v PersistView) NetworkLockKey() key.NLPrivate
  • func (v PersistView) NodeID() tailcfg.StableNodeID
  • func (v PersistView) OldPrivateNodeKey() key.NodePrivate
  • func (v PersistView) PrivateNodeKey() key.NodePrivate
  • func (p PersistView) PublicNodeKey() key.NodePublic
  • func (p PersistView) PublicNodeKeyOK() (_ key.NodePublic, ok bool)
  • func (v *PersistView) UnmarshalJSON(b []byte) error
  • func (v PersistView) UserProfile() tailcfg.UserProfile
  • func (v PersistView) Valid() bool

Types

type Persist

type Persist struct {

	// LegacyFrontendPrivateMachineKey is here temporarily
	// (starting 2020-09-28) during migration of Windows users'
	// machine keys from frontend storage to the backend. On the
	// first LocalBackend.Start call, the backend will initialize
	// the real (backend-owned) machine key from the frontend's
	// provided value (if non-zero), picking a new random one if
	// needed. This field should be considered read-only from GUI
	// frontends. The real value should not be written back in
	// this field, lest the frontend persist it to disk.
	LegacyFrontendPrivateMachineKey key.MachinePrivate `json:"PrivateMachineKey"`

	PrivateNodeKey    key.NodePrivate
	OldPrivateNodeKey key.NodePrivate // needed to request key rotation
	UserProfile       tailcfg.UserProfile
	NetworkLockKey    key.NLPrivate
	NodeID            tailcfg.StableNodeID

	// DisallowedTKAStateIDs stores the tka.State.StateID values which
	// this node will not operate network lock on. This is used to
	// prevent bootstrapping TKA onto a key authority which was forcibly
	// disabled.
	DisallowedTKAStateIDs []string `json:",omitempty"`
	// contains filtered or unexported fields
}

Persist is the JSON type stored on disk on nodes to remember their settings between runs. This is stored as part of ipn.Prefs and is persisted per ipn.LoginProfile.

func (*Persist) Clone

func (src *Persist) Clone() *Persist

Clone makes a deep copy of Persist. The result aliases no memory with the original.

func (*Persist) Equals

func (p *Persist) Equals(p2 *Persist) bool

func (*Persist) Pretty

func (p *Persist) Pretty() string

func (*Persist) PublicNodeKey

func (p *Persist) PublicNodeKey() key.NodePublic

PublicNodeKey returns the public key for the node key.

func (*Persist) PublicNodeKeyOK

func (p *Persist) PublicNodeKeyOK() (pub key.NodePublic, ok bool)

PublicNodeKeyOK returns the public key for the node key.

Unlike PublicNodeKey, it returns ok=false if there is no node private key instead of panicking.

func (*Persist) View

func (p *Persist) View() PersistView

View returns a readonly view of Persist.

type PersistView

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

PersistView provides a read-only view over Persist.

Its methods should only be called if `Valid()` returns true.

func (PersistView) AsStruct

func (v PersistView) AsStruct() *Persist

AsStruct returns a clone of the underlying value which aliases no memory with the original.

func (PersistView) DisallowedTKAStateIDs

func (v PersistView) DisallowedTKAStateIDs() views.Slice[string]

func (PersistView) Equals

func (p PersistView) Equals(p2 PersistView) bool

func (PersistView) LegacyFrontendPrivateMachineKey

func (v PersistView) LegacyFrontendPrivateMachineKey() key.MachinePrivate

func (PersistView) MarshalJSON

func (v PersistView) MarshalJSON() ([]byte, error)

func (PersistView) NetworkLockKey

func (v PersistView) NetworkLockKey() key.NLPrivate

func (PersistView) NodeID

func (v PersistView) NodeID() tailcfg.StableNodeID

func (PersistView) OldPrivateNodeKey

func (v PersistView) OldPrivateNodeKey() key.NodePrivate

func (PersistView) PrivateNodeKey

func (v PersistView) PrivateNodeKey() key.NodePrivate

func (PersistView) PublicNodeKey

func (p PersistView) PublicNodeKey() key.NodePublic

PublicNodeKey returns the public key for the node key.

It panics if there is no node private key. See PublicNodeKeyOK.

func (PersistView) PublicNodeKeyOK

func (p PersistView) PublicNodeKeyOK() (_ key.NodePublic, ok bool)

PublicNodeKeyOK returns the public key for the node key.

Unlike PublicNodeKey, it returns ok=false if there is no node private key instead of panicking.

func (*PersistView) UnmarshalJSON

func (v *PersistView) UnmarshalJSON(b []byte) error

func (PersistView) UserProfile

func (v PersistView) UserProfile() tailcfg.UserProfile

func (PersistView) Valid

func (v PersistView) Valid() bool

Valid reports whether underlying value is non-nil.