launchd

Documentation

Index

• func Install(plist Plist) (err error)
• func Restart(label string) error
• func ShowServices(filter string, name string) (err error)
• func ShowStatus(label string) error
• func Start(label string) error
• func Stop(label string) error
• func Uninstall(label string) error
• type Plist
  • func NewPlist(label string, binPath string, args []string, envVars map[string]string) Plist
• type Service
  • func ListServices(filter string) ([]Service, error)
  • func NewService(label string) Service
  • func (s Service) Install(p Plist) (err error)
  • func (s Service) Label() string
  • func (s Service) Load(restart bool) error
  • func (s Service) Status() (*ServiceStatus, error)
  • func (s Service) StatusDescription() string
  • func (s Service) Uninstall() (err error)
  • func (s Service) Unload() error
• type ServiceStatus
  • func (s ServiceStatus) Description() string
  • func (s ServiceStatus) IsRunning() bool
  • func (s ServiceStatus) Label() string
  • func (s ServiceStatus) Pid() string

Functions

func Install

func Install(plist Plist) (err error)

Install will install a service

func Restart

func Restart(label string) error

Restart restarts a service

func ShowServices

func ShowServices(filter string, name string) (err error)

ShowServices ouputs keybase service info.

func ShowStatus

func ShowStatus(label string) error

ShowStatus shows status info for a service

func Start

func Start(label string) error

Start will start a keybase service

func Stop

func Stop(label string) error

Stop will stop a keybase service

func Uninstall

func Uninstall(label string) error

Uninstall will uninstall a keybase service

Types

type Plist

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

Plist defines a launchd plist

func NewPlist

func NewPlist(label string, binPath string, args []string, envVars map[string]string) Plist

NewPlist constructs a launchd service.

type Service

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

Service defines a service

func ListServices

func ListServices(filter string) ([]Service, error)

ListServices will return service with label containing the filter string.

func NewService

func NewService(label string) Service

NewService constructs a launchd service.

func (Service) Install

func (s Service) Install(p Plist) (err error)

Install will install the launchd service

func (Service) Label

func (s Service) Label() string

Label for service

func (Service) Load

func (s Service) Load(restart bool) error

Load will load the service. If restart=true, then we'll unload it first.

func (Service) Status

func (s Service) Status() (*ServiceStatus, error)

Status returns service status

func (Service) StatusDescription

func (s Service) StatusDescription() string

StatusDescription returns the service status description

func (Service) Uninstall

func (s Service) Uninstall() (err error)

Uninstall will uninstall the launchd service

func (Service) Unload

func (s Service) Unload() error

Unload will unload the service

type ServiceStatus

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

ServiceStatus defines status for a service

func (ServiceStatus) Description

func (s ServiceStatus) Description() string

Description returns service status info

func (ServiceStatus) IsRunning

func (s ServiceStatus) IsRunning() bool

IsRunning is true if the service is running (with a pid)

func (ServiceStatus) Label

func (s ServiceStatus) Label() string

Label for status

func (ServiceStatus) Pid

func (s ServiceStatus) Pid() string

Pid for status (empty string if not running)