service

Documentation

Index

• func Create(u *Unit) error
• func Exists(name string) bool
• func GetUser(name string) string
• func ListSlipgateServices() []string
• func Logs(name string, lines string) (string, error)
• func ReadUnitFile(name string) string
• func Reload(name string) error
• func Remove(name string) error
• func Restart(name string) error
• func Start(name string) error
• func Status(name string) (string, error)
• func Stop(name string) error
• func TunnelServiceName(tag string) string
• type Unit

Functions

func Create

func Create(u *Unit) error

Create writes a systemd unit file and reloads the daemon.

func Exists

func Exists(name string) bool

Exists checks if a systemd unit file exists.

func GetUser

func GetUser(name string) string

GetUser returns the User= value from a service's unit file.

func ListSlipgateServices

func ListSlipgateServices() []string

ListSlipgateServices returns the names of all slipgate-* service files found in the systemd directory (without the .service suffix).

func Logs

func Logs(name string, lines string) (string, error)

Logs returns recent log lines for a service.

func ReadUnitFile

func ReadUnitFile(name string) string

ReadUnitFile returns the raw unit file contents, or empty string if absent.

func Reload

func Reload(name string) error

Reload asks systemd to run the service's ExecReload (typically sending SIGHUP to the main pid). Does not drop live connections.

func Remove

func Remove(name string) error

Remove removes a service unit file. Silently skips if it doesn't exist.

func Restart

func Restart(name string) error

Restart restarts a service.

func Start

func Start(name string) error

Start enables and starts a service.

func Status

func Status(name string) (string, error)

Status returns the active state of a service.

func Stop

func Stop(name string) error

Stop stops and disables a service. Silently skips if the service doesn't exist.

func TunnelServiceName

func TunnelServiceName(tag string) string

TunnelServiceName returns the systemd service name for a tunnel.

Types

type Unit

type Unit struct {
	Name        string
	Description string
	ExecStart   string
	ExecReload  string
	User        string
	Group       string
	After       string
	Restart     string
	WorkingDir  string
	Environment []string
}

Unit represents a systemd unit file.