systemd

Documentation

Index

• Variables
• func IsTimeout(err error) bool
• type Error
  • func (e *Error) Error() string
• type Log
  • func (l Log) Message() string
  • func (l Log) RawTimestamp() string
  • func (l Log) SID() string
  • func (l Log) String() string
  • func (l Log) Timestamp() string
• type ServiceDescription
• type ServiceStatus
• type Systemd
  • func New(rootDir string, rep reporter) Systemd
• type Timeout
  • func (e *Timeout) Error() string

Variables

var JournalctlCmd = jctl

JournalctlCmd is called from Logs to run journalctl; exported for testing.

var SystemctlCmd = run

SystemctlCmd is called from the commands to actually call out to systemctl. It's exported so it can be overridden by testing.

Functions

func IsTimeout

func IsTimeout(err error) bool

IsTimeout checks whether the given error is a Timeout

Types

type Error

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

Error is returned if the systemd action failed

func (*Error) Error

func (e *Error) Error() string

type Log

type Log map[string]interface{}

A Log is a single entry in the systemd journal

func (Log) Message

func (l Log) Message() string

Message of the Log, if any; otherwise, "-".

func (Log) RawTimestamp

func (l Log) RawTimestamp() string

RawTimestamp of the log: microseconds since epoch UTC, as a decimal string, or "-" if missing.

func (Log) SID

func (l Log) SID() string

SID is the syslog identifier of the Log, if any; otherwise, "-".

func (Log) String

func (l Log) String() string

func (Log) Timestamp

func (l Log) Timestamp() string

Timestamp of the Log, formatted like RFC3339 to µs precision.

If no timestamp, the string "-(no timestamp!)-" -- and something is wrong with your system. Some other "impossible" error conditions also result in "-(errror message)-" timestamps.

type ServiceDescription

type ServiceDescription struct {
	AppName         string
	ServiceName     string
	Version         string
	Description     string
	AppPath         string
	Start           string
	Stop            string
	PostStop        string
	StopTimeout     time.Duration
	AaProfile       string
	IsFramework     bool
	IsNetworked     bool
	BusName         string
	UdevAppName     string
	Forking         bool
	Socket          bool
	SocketFileName  string
	ListenStream    string
	SocketMode      string
	SocketUser      string
	SocketGroup     string
	ServiceFileName string
}

ServiceDescription describes a snappy systemd service

type ServiceStatus

type ServiceStatus struct {
	ServiceFileName string `json:"service_file_name"`
	LoadState       string `json:"load_state"`
	ActiveState     string `json:"active_state"`
	SubState        string `json:"sub_state"`
	UnitFileState   string `json:"unit_file_state"`
}

A ServiceStatus holds structured service status information.

type Systemd

type Systemd interface {
	DaemonReload() error
	Enable(service string) error
	Disable(service string) error
	Start(service string) error
	Stop(service string, timeout time.Duration) error
	Kill(service, signal string) error
	Restart(service string, timeout time.Duration) error
	GenServiceFile(desc *ServiceDescription) string
	GenSocketFile(desc *ServiceDescription) string
	Status(service string) (string, error)
	ServiceStatus(service string) (*ServiceStatus, error)
	Logs(services []string) ([]Log, error)
}

Systemd exposes a minimal interface to manage systemd via the systemctl command.

func New

func New(rootDir string, rep reporter) Systemd

New returns a Systemd that uses the given rootDir

type Timeout

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

Timeout is returned if the systemd action failed to reach the expected state in a reasonable amount of time

func (*Timeout) Error

func (e *Timeout) Error() string