inventory

Sep 27, 2026

Changes in this version

type StaticOption

+ func WithoutHosts() StaticOption

Sep 19, 2026

Changes in this version

type Static

+ func (s *Static) ListUserFacts(_ context.Context) ([]directory.User, directory.Revision, error)

Sep 18, 2026

Changes in this version

type AuditEvent

+ func (e AuditEvent) ControlEvent() inventoryapi.HostAuditEvent

type EnrollmentToken

+ func (t EnrollmentToken) ControlToken() inventoryapi.EnrollmentToken

type HostRecord

+ func (r HostRecord) ControlRecord() inventoryapi.HostRecord

type Proposal

+ func ProposalFromControl(p inventoryapi.Proposal) Proposal

+ func (p Proposal) ControlProposal() inventoryapi.Proposal

type StaticOption

+ func WithoutUsers() StaticOption

Sep 13, 2026

Changes in this version

+ var ErrConflict = errors.New("inventory conflict")

+ var ErrNotFound = errors.New("inventory record not found")

+ var ErrRevision = errors.New("record changed; reload before retrying")

+ var ErrStorage = errors.New("managed inventory storage unavailable")

+ var ErrToken = errors.New("invalid, expired, revoked, or used enrollment token")

+ func DecodeYAML(data []byte, dst any) error

+ func RandomSecret() (string, error)

+ type AuditEvent struct

+ Action string

+ Actor string

+ At time.Time

+ Resource string

+ type EnrollmentToken struct

+ ExpiresAt time.Time

+ ID string

+ Revoked bool

+ UsedBy string

+ type HostRecord struct

+ CreatedAt time.Time

+ ID string

+ Pattern string

+ Proposal Proposal

+ Revision uint64

+ ShadowedNames []string

+ Source string

+ SourceFile string

+ Status string

+ UpdatedAt time.Time

+ type Managed struct

+ func OpenManaged(dir string, static *Static) (*Managed, error)

+ func (m *Managed) Audit() ([]AuditEvent, error)

+ func (m *Managed) Change(actor, action, id string, revision uint64, p *Proposal) (*HostRecord, error)

+ func (m *Managed) Close() error

+ func (m *Managed) CreateToken(actor string, lifetime time.Duration) (EnrollmentToken, error)

+ func (m *Managed) Enroll(p Proposal, token string) (*HostRecord, error)

+ func (m *Managed) Get(id string) (*HostRecord, error)

+ func (m *Managed) Health() error

+ func (m *Managed) List() ([]HostRecord, error)

+ func (m *Managed) LookupHost(ctx context.Context, name string) (*ResolvedHost, string, error)

+ func (m *Managed) RevokeToken(actor, id string) error

+ func (m *Managed) Tokens() ([]EnrollmentToken, error)

+ type Proposal struct

+ Accounts []string

+ Domain string

+ Labels map[string]string

+ Names []string

+ PrincipalMode PrincipalMode

+ func ParseProposal(data []byte) (Proposal, error)

+ func (p *Proposal) UnmarshalJSON(data []byte) error

+ func (p *Proposal) UnmarshalYAML(node *yaml.Node) error

+ func (p *Proposal) Validate() error

+ func (p Proposal) MarshalYAML() (any, error)

type Static

+ func (s *Static) Records() []HostRecord

Sep 11, 2026

Changes in this version

+ type Host struct

+ Accounts []string

+ Labels map[string]string

+ Names []string

+ type Hosts interface

+ LookupHost func(context.Context, string) (*ResolvedHost, error)

+ type PrincipalMode string

+ const AccountNamePrincipals

+ const EpithetPrincipalV1

+ func (m PrincipalMode) Effective() PrincipalMode

+ func (m PrincipalMode) Validate() error

+ type ResolvedHost struct

+ Domain principal.Domain

+ Policy Host

+ PrincipalMode PrincipalMode

+ type Static struct

+ func NewStatic(paths []string, options ...StaticOption) (*Static, error)

+ func (s *Static) DirectoryRevision() string

+ func (s *Static) InventoryRevision() string

+ func (s *Static) LookupHost(_ context.Context, name string) (*ResolvedHost, error)

+ func (s *Static) LookupUser(_ context.Context, id string) (*directory.User, error)

+ type StaticOption func(*staticOptions) error

+ func WithDefaultPrincipalMode(mode PrincipalMode) StaticOption