Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

hostmaintenance

package

Go to main page

Versions in this module

v0

v0.47.4

Sep 26, 2026

v0.47.3

Sep 26, 2026

v0.47.2

Sep 26, 2026

v0.47.1

Sep 26, 2026

v0.47.0

Sep 26, 2026

v0.46.9

Sep 26, 2026

v0.46.8

Sep 26, 2026

v0.46.7

Sep 25, 2026

v0.46.6

Sep 25, 2026

Changes in this version

+ const ApplyWaitTimeout

+ const CodeControlPlaneHost

+ const CodeDpkgBroken

+ const CodePackageManagerBusy

+ const CodePlanStale

+ const CodeUnattendedRebootUnsupported

+ const CodeUnsupportedOS

+ const CodeUnsupportedPackageManager

+ const ControlPlaneCommand

+ const ControlPlaneExecutable

+ const ControlPlaneImage

+ const ControlPlaneService

+ const ControlPlaneUnit

+ const FailureHostProbe

+ const FailureInstall

+ const FailureInstallSetRejected

+ const FailureRefresh

+ const FailureSchedule

+ const FailureSimulation

+ const FailureWaitExpired

+ const HoldScope

+ const MaintenanceLockPath

+ const MaxRebootDelay

+ const MinRebootDelay

+ const OperationReboot

+ const OperationUpdatesApply

+ const OperationUpdatesPlan

+ const OutcomeApplied

+ const OutcomeFailed

+ const OutcomeNoop

+ const OutcomeRunning

+ const PlanTimeout

+ const RebootGuardMaxWait

+ const RebootUnitPrefix

+ const SchemaVersion

+ const UpdateUnitPrefix

+ var ErrRebootAbandoned = errors.New("reboot abandoned")

+ var ErrStillRunning = errors.New("host update is still running in its systemd unit")

+ func IsHeld(name string) bool

+ func PlanDigest(packages []Package) string

+ type Change struct

+ After string

+ Before string

+ Name string

+ type Command struct

+ Args []string

+ Name string

+ type Engine struct

+ Host Host

+ Progress func(phase, status, message string, attrs map[string]string)

+ func (e Engine) Apply(ctx context.Context, planDigest string) (Result, error)

+ func (e Engine) Plan(ctx context.Context) (Result, error)

+ func (e Engine) Reboot(ctx context.Context, delay time.Duration) (Result, error)

+ func (e Engine) RebootGuard(ctx context.Context, maxWait time.Duration) error

+ type FailureError struct

+ Problem Problem

+ func (e *FailureError) Error() string

+ type Host interface

+ Executable func() (string, error)

+ Exists func(path string) bool

+ LockHolder func(path string) (held bool, pid int, err error)

+ LookPath func(name string) (string, error)

+ Now func() time.Time

+ Processes func() ([]Process, error)

+ ReadFile func(path string) ([]byte, error)

+ Run func(ctx context.Context, command Command) (Output, error)

+ Sleep func(ctx context.Context, d time.Duration) error

+ TryLock func(path string, createMode os.FileMode) (release func(), acquired bool, err error)

+ type LocalHost struct

+ func (LocalHost) Executable() (string, error)

+ func (LocalHost) Exists(path string) bool

+ func (LocalHost) LockHolder(path string) (bool, int, error)

+ func (LocalHost) LookPath(name string) (string, error)

+ func (LocalHost) Now() time.Time

+ func (LocalHost) Processes() ([]Process, error)

+ func (LocalHost) ReadFile(path string) ([]byte, error)

+ func (LocalHost) Run(ctx context.Context, command Command) (Output, error)

+ func (LocalHost) Sleep(ctx context.Context, d time.Duration) error

+ func (LocalHost) TryLock(path string, createMode os.FileMode) (func(), bool, error)

+ type OSInfo struct

+ ID string

+ PrettyName string

+ VersionID string

+ type Output struct

+ ExitCode int

+ Stderr string

+ Stdout string

+ type Package struct

+ From string

+ Name string

+ Security bool

+ To string

+ type Problem struct

+ Code string

+ Guidance []string

+ Message string

+ type Process struct

+ Args []string

+ Exe string

+ PID int

+ type RefusalError struct

+ Problem Problem

+ func (e *RefusalError) Error() string

+ type Result struct

+ AutoMarksNotRestored []string

+ BootIDBefore string

+ Changes []Change

+ DelaySeconds int

+ DpkgProblems []string

+ Failure *Problem

+ FinishedAt time.Time

+ Held []Package

+ HoldScope string

+ KeptBack []string

+ OS *OSInfo

+ ObservedAt time.Time

+ Operation string

+ Outcome string

+ PackageManager string

+ Packages []Package

+ PendingCount *int

+ PlanDigest string

+ RebootLikely *bool

+ RebootRequired *bool

+ RebootRequiredPackages []string

+ Refusal *Problem

+ Scheduled *bool

+ ScheduledAt time.Time

+ SchemaVersion string

+ SecurityCount *int

+ StartedAt time.Time

+ Unit string