apps/service
1
0
Fork 0
mirror of https://github.com/kardianos/service.git synced 2025-09-27 05:06:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

service: go fmt comments

Browse Source
This commit is contained in:
Daniel Theophanes
2024-06-13 08:31:55 -05:00
parent 9832e01049
commit 4ac50d86f3
7 changed files with 86 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
example/logging/main.go
View File

@@ -16,7 +16,8 @@ import (
var logger service.Logger var logger service.Logger
// Program structures. // Program structures.
// Define Start and Stop methods. //
// Define Start and Stop methods.
type program struct { type program struct {
exit chan struct{} exit chan struct{}
} }
@@ -54,11 +55,12 @@ func (p *program) Stop(s service.Service) error {
} }
// Service setup. // Service setup.
// Define service config. //
// Create the service. // Define service config.
// Setup the logger. // Create the service.
// Handle service controls (optional). // Setup the logger.
// Run the service. // Handle service controls (optional).
// Run the service.
func main() { func main() {
svcFlag := flag.String("service", "", "Control the system service.") svcFlag := flag.String("service", "", "Control the system service.")
flag.Parse() flag.Parse()

114
service.go
View File

@@ -167,42 +167,70 @@ func New(i Interface, c *Config) (Service, error) {
} }
// KeyValue provides a list of system specific options. // KeyValue provides a list of system specific options.
// * OS X
// - LaunchdConfig string () - Use custom launchd config.
// - KeepAlive bool (true) - Prevent the system from stopping the service automatically.
// - RunAtLoad bool (false) - Run the service after its job has been loaded.
// - SessionCreate bool (false) - Create a full user session.
// //
// * Solaris // - OS X
// - Prefix string ("application") - Service FMRI prefix.
// //
// * POSIX // - LaunchdConfig string () - Use custom launchd config.
// - UserService bool (false) - Install as a current user service.
// - SystemdScript string () - Use custom systemd script.
// - UpstartScript string () - Use custom upstart script.
// - SysvScript string () - Use custom sysv script.
// - OpenRCScript string () - Use custom OpenRC script.
// - RunWait func() (wait for SIGNAL) - Do not install signal but wait for this function to return.
// - ReloadSignal string () [USR1, ...] - Signal to send on reload.
// - PIDFile string () [/run/prog.pid] - Location of the PID file.
// - LogOutput bool (false) - Redirect StdErr & StandardOutPath to files.
// - Restart string (always) - How shall service be restarted.
// - SuccessExitStatus string () - The list of exit status that shall be considered as successful,
// in addition to the default ones.
// - LogDirectory string(/var/log) - The path to the log files directory
// //
// * Linux (systemd) // - KeepAlive bool (true) - Prevent the system from stopping the service automatically.
// - LimitNOFILE int (-1) - Maximum open files (ulimit -n) //
// (https://serverfault.com/questions/628610/increasing-nproc-for-processes-launched-by-systemd-on-centos-7) // - RunAtLoad bool (false) - Run the service after its job has been loaded.
// * Windows //
// - DelayedAutoStart bool (false) - After booting, start this service after some delay. // - SessionCreate bool (false) - Create a full user session.
// - Password string () - Password to use when interfacing with the system service manager. //
// - Interactive bool (false) - The service can interact with the desktop. (more information https://docs.microsoft.com/en-us/windows/win32/services/interactive-services) // - Solaris
// - DelayedAutoStart bool (false) - after booting start this service after some delay. //
// - StartType string ("automatic") - Start service type. (automatic | manual | disabled) // - Prefix string ("application") - Service FMRI prefix.
// - OnFailure string ("restart" ) - Action to perform on service failure. (restart | reboot | noaction) //
// - OnFailureDelayDuration string ( "1s" ) - Delay before restarting the service, time.Duration string. // - POSIX
// - OnFailureResetPeriod int ( 10 ) - Reset period for errors, seconds. //
// - UserService bool (false) - Install as a current user service.
//
// - SystemdScript string () - Use custom systemd script.
//
// - UpstartScript string () - Use custom upstart script.
//
// - SysvScript string () - Use custom sysv script.
//
// - OpenRCScript string () - Use custom OpenRC script.
//
// - RunWait func() (wait for SIGNAL) - Do not install signal but wait for this function to return.
//
// - ReloadSignal string () [USR1, ...] - Signal to send on reload.
//
// - PIDFile string () [/run/prog.pid] - Location of the PID file.
//
// - LogOutput bool (false) - Redirect StdErr & StandardOutPath to files.
//
// - Restart string (always) - How shall service be restarted.
//
// - SuccessExitStatus string () - The list of exit status that shall be considered as successful,
// in addition to the default ones.
//
// - LogDirectory string(/var/log) - The path to the log files directory
//
// - Linux (systemd)
//
// - LimitNOFILE int (-1) - Maximum open files (ulimit -n)
// (https://serverfault.com/questions/628610/increasing-nproc-for-processes-launched-by-systemd-on-centos-7)
//
// - Windows
//
// - DelayedAutoStart bool (false) - After booting, start this service after some delay.
//
// - Password string () - Password to use when interfacing with the system service manager.
//
// - Interactive bool (false) - The service can interact with the desktop. (more information https://docs.microsoft.com/en-us/windows/win32/services/interactive-services)
//
// - DelayedAutoStart bool (false) - after booting start this service after some delay.
//
// - StartType string ("automatic") - Start service type. (automatic | manual | disabled)
//
// - OnFailure string ("restart" ) - Action to perform on service failure. (restart | reboot | noaction)
//
// - OnFailureDelayDuration string ( "1s" ) - Delay before restarting the service, time.Duration string.
//
// - OnFailureResetPeriod int ( 10 ) - Reset period for errors, seconds.
type KeyValue map[string]interface{} type KeyValue map[string]interface{}
// bool returns the value of the given name, assuming the value is a boolean. // bool returns the value of the given name, assuming the value is a boolean.
@@ -325,16 +353,16 @@ type System interface {
// Interface represents the service interface for a program. Start runs before // Interface represents the service interface for a program. Start runs before
// the hosting process is granted control and Stop runs when control is returned. // the hosting process is granted control and Stop runs when control is returned.
// //
// 1. OS service manager executes user program. // 1. OS service manager executes user program.
// 2. User program sees it is executed from a service manager (IsInteractive is false). // 2. User program sees it is executed from a service manager (IsInteractive is false).
// 3. User program calls Service.Run() which blocks. // 3. User program calls Service.Run() which blocks.
// 4. Interface.Start() is called and quickly returns. // 4. Interface.Start() is called and quickly returns.
// 5. User program runs. // 5. User program runs.
// 6. OS service manager signals the user program to stop. // 6. OS service manager signals the user program to stop.
// 7. Interface.Stop() is called and quickly returns. // 7. Interface.Stop() is called and quickly returns.
// - For a successful exit, os.Exit should not be called in Interface.Stop(). // - For a successful exit, os.Exit should not be called in Interface.Stop().
// 8. Service.Run returns. // 8. Service.Run returns.
// 9. User program should quickly exit. // 9. User program should quickly exit.
type Interface interface { type Interface interface {
// Start provides a place to initiate the service. The service doesn't // Start provides a place to initiate the service. The service doesn't
// signal a completed start until after this function returns, so the // signal a completed start until after this function returns, so the

3
service_aix.go
View File

@@ -1,4 +1,5 @@
//+build aix //go:build aix
// +build aix
// Copyright 2015 Daniel Theophanes. // Copyright 2015 Daniel Theophanes.
// Use of this source code is governed by a zlib-style // Use of this source code is governed by a zlib-style

3
service_go1.8.go
View File

@@ -1,4 +1,5 @@
//+build go1.8 //go:build go1.8
// +build go1.8
package service package service

1
service_nosu_test.go
View File

@@ -2,6 +2,7 @@
// Use of this source code is governed by a zlib-style // Use of this source code is governed by a zlib-style
// license that can be found in the LICENSE file. // license that can be found in the LICENSE file.
//go:build !su
// +build !su // +build !su
package service_test package service_test

1
service_su_test.go
View File

@@ -3,6 +3,7 @@
// license that can be found in the LICENSE file. // license that can be found in the LICENSE file.
// This needs to be run as root/admin hence the reason there is a build tag // This needs to be run as root/admin hence the reason there is a build tag
//go:build su
// +build su // +build su
package service_test package service_test

1
servicetest_unix_test.go
View File

@@ -2,6 +2,7 @@
// Use of this source code is governed by a zlib-style // Use of this source code is governed by a zlib-style
// license that can be found in the LICENSE file. // license that can be found in the LICENSE file.
//go:build darwin || dragonfly || freebsd || linux || nacl || netbsd || openbsd || solaris
// +build darwin dragonfly freebsd linux nacl netbsd openbsd solaris // +build darwin dragonfly freebsd linux nacl netbsd openbsd solaris
package service_test package service_test