systemd

Documentation

Overview

Package systemd facilitates systemd status queries via dbus.

Index

• Constants
• Variables
• type Condition
• type UnitStatus
  • func ListUnitStatuses(ctx context.Context, units ...string) ([]UnitStatus, error)
  • func (s UnitStatus) ActiveStateCondition() Condition
  • func (s UnitStatus) Duration() time.Duration
  • func (s UnitStatus) LoadStateCondition() Condition
  • func (s UnitStatus) State() string

Constants

const (
	ConditionNeutral = 0
	ConditionHealthy = 1
	ConditionBad     = 2
)

Condition values.

Variables

var ErrNotSupported = errors.New("not supported on systems without systemd")

ErrNotSupported is returned by calls on systems that don't support the systemd.

Types

type Condition

type Condition int8

Condition indicates the health of a particular systemd state.

type UnitStatus

type UnitStatus struct {
	Name                   string
	Description            string
	LoadState              string
	ActiveState            string
	SubState               string
	InactiveExitTimestamp  time.Time
	ActiveEnterTimestamp   time.Time
	ActiveExitTimestamp    time.Time
	InactiveEnterTimestamp time.Time
}

UnitStatus describes the current status of a machina systemd unit.

func ListUnitStatuses

func ListUnitStatuses(ctx context.Context, units ...string) ([]UnitStatus, error)

ListUnitStatuses returns a slice of systemd unit status entries, one for each requested unit.

func (UnitStatus) ActiveStateCondition

func (s UnitStatus) ActiveStateCondition() Condition

ActiveStateCondition returns an evaluation of the unit's active state.

func (UnitStatus) Duration

func (s UnitStatus) Duration() time.Duration

Duration returns the duration of the current status condition.

func (UnitStatus) LoadStateCondition

func (s UnitStatus) LoadStateCondition() Condition

LoadStateCondition returns an evaluation of the unit's load state.

func (UnitStatus) State

func (s UnitStatus) State() string

State returns a string describing the state of the unit.