mirror of https://github.com/taigrr/systemctl.git synced 2024-08-25 20:51:29 +08:00

Provides idiomatic systemctl bindings for go developers, in order to make it easier to write system tooling using golang.

go golang hacktoberfest systemctl systemd wrapper-library

Go to file

Tai Groot 50f85eb623 Adds 0bsd license		2021-05-14 14:39:38 -07:00
go.mod	Initial commit	2021-05-14 14:27:29 -07:00
LICENSE	Adds 0bsd license	2021-05-14 14:39:38 -07:00
README.md	Initial commit	2021-05-14 14:27:29 -07:00
systemctl.go	Initial commit	2021-05-14 14:27:29 -07:00

README.md

systemctl

This library aims at providing idiomatic systemctl bindings for go developers, in order to make it easier to write system tooling using golang.

What is systemctl

systemctl is a command-line program which grants the user control over the systemd system and service manager.

systemctl may be used to introspect and control the state of the "systemd" system and service manager. Please refer to systemd(1) for an introduction into the basic concepts and functionality this tool manages.

Supported functions

systemctl is-failed
systemctl is-active
systemctl status
systemctl restart
systemctl start
systemctl stop
systemctl enable
systemctl disable
systemctl is-enabled
systemctl daemon-reload
systemctl show

TODO

Add additional bindings for systemctl options I (the author) don't use frequently (or ever) for others to use.
Set up go test testing

Simple example

package main

import (
    "context"
    "fmt"
    "log"
    "time"

    "github.com/taigrr/systemctl/v1"
)

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()

    // Equivalent to `systemctl enable dhcpd` with a 10 second timeout
    err := systemctl.Enable("dhcpd", ctx)
    if err != nil {
        log.Fatalf("unable to enable unit %s: %v", "dhcpd", err)
    }
}