mirror of
https://github.com/kemko/nomad.git
synced 2026-01-01 16:05:42 +03:00
48d91dc1f9
Provides interfaces to the Windows service manager and Windows services. These interfaces support creating new Windows services, deleting Windows services, configuring Windows services, and registering/deregistering services with Windows Eventlog. A path helper is included to support expansion of paths using a subset of known folder IDs. A privileged helper is included to check that the process is currently being executed with elevated privileges, which are required for managing Windows services and modifying the registry.
76 lines
2.4 KiB
Go
76 lines
2.4 KiB
Go
// Copyright (c) HashiCorp, Inc.
|
|
// SPDX-License-Identifier: BUSL-1.1
|
|
|
|
package winsvc
|
|
|
|
type ServiceStartType uint32
|
|
|
|
// extracted from https://pkg.go.dev/golang.org/x/sys@v0.35.0/windows/svc/mgr#StartManual
|
|
const (
|
|
StartManual ServiceStartType = 3
|
|
StartAutomatic ServiceStartType = 2
|
|
StartDisabled ServiceStartType = 4
|
|
)
|
|
|
|
type WindowsServiceConfiguration struct {
|
|
StartType ServiceStartType
|
|
DisplayName string
|
|
Description string
|
|
BinaryPathName string
|
|
}
|
|
|
|
type WindowsPaths interface {
|
|
// Expand expands the path defined by the template. Supports
|
|
// values for:
|
|
// - SystemDrive
|
|
// - SystemRoot
|
|
// - ProgramData
|
|
// - ProgramFiles
|
|
Expand(path string) (string, error)
|
|
|
|
// Creates a new directory if it does not exist. If directory
|
|
// is created and restrict_on_create is true, a restrictive
|
|
// ACL is applied.
|
|
CreateDirectory(path string, restrict_on_create bool) error
|
|
}
|
|
|
|
type WindowsService interface {
|
|
// Name returns the name of the service
|
|
Name() string
|
|
// Configure applies the configuration to the Windows service.
|
|
// NOTE: Full configuration applied so empty values will remove existing values.
|
|
Configure(config WindowsServiceConfiguration) error
|
|
// Start starts the Windows service and waits for the
|
|
// service to be running.
|
|
Start() error
|
|
// Stop requests the service to stop and waits for the
|
|
// service to stop.
|
|
Stop() error
|
|
// Close closes the connection to the Windows service.
|
|
Close() error
|
|
// Delete deletes the Windows service.
|
|
Delete() error
|
|
// IsRunning returns if the service is currently running.
|
|
IsRunning() (bool, error)
|
|
// IsStopped returns if the service is currently stopped.
|
|
IsStopped() (bool, error)
|
|
// EnableEventlog will add or update the Windows Eventlog
|
|
// configuration for the service. It will set supported
|
|
// events as info, warning, and error.
|
|
EnableEventlog() error
|
|
// DisableEventlog will remove the Windows Eventlog configuration
|
|
// for the service.
|
|
DisableEventlog() error
|
|
}
|
|
|
|
type WindowsServiceManager interface {
|
|
// IsServiceRegistered returns if the service is a registered Windows service.
|
|
IsServiceRegistered(name string) (bool, error)
|
|
// GetService opens and returns the named service.
|
|
GetService(name string) (WindowsService, error)
|
|
// CreateService creates a new Windows service.
|
|
CreateService(name, binaryPath string, config WindowsServiceConfiguration) (WindowsService, error)
|
|
// Close closes Windows service manager connection.
|
|
Close() error
|
|
}
|