NAME
gotsysd —
Game of Trees System Daemon
SYNOPSIS
gotsysd |
[-dnv] [-f
config-file] |
DESCRIPTION
gotsysd manages the system configuration
of a Git repository server running gotd(8).
gotsysd allows remote
administrators to configure aspects of Git repository services without
having shell access to the Git server's operating system. Remote
administrators merely need to be granted write access to a special-purpose
system repository
called gotsys.git in order to configure Git
repository services.
Tasks carried out by gotsysd include the
creation of Git repositores to be served by gotd(8), and the creation of user accounts which use the
gotsh(1) shell to access
gotd(8). The desired system
configuration is described by the file
gotsys.conf(5) in the
system repository.
The gotsysd configuration file format is
described in gotsysd.conf(5). gotsysd can be run without a
configuration file, using default settings.
gotsysd listens on a
unix(4) socket for
notifications issued by gotd(8), and for commands issued via
gotsysctl(8).
gotd(8) notifications are
sent when a remote administrator modifies the file
gotsys.conf(5) in the
system repository.
Only the users root and _gotd are granted access to the
gotsysd unix socket by default. Alternative access
rules can be configured in gotsysd.conf(5).
The options for gotsysd are as
follows:
-d- Do not daemonize. Send log output to stderr.
-fconfig-file- Set the path to the configuration file. If not specified, the file /etc/gotsysd.conf will be used. This file is not required to exist.
-n- Configtest mode. Only check the configuration file for validity.
-v- Verbose mode. Verbosity increases if this option is used multiple times.
FILES
- /etc/gotsysd.conf
- Default location of the configuration file.
- /git
- Default directory containing Git repositories managed by
gotsysd. This path can be configured in gotsysd.conf(5). - /var/db/gotsysd
- The directory where
gotsysdstores persistent state. Files in this directory are opened with exclusive locks, ensuring that only one instance ofgotsysdruns on a given OpenBSD system. - /var/run/gotsysd.sock
- Default location of the unix socket which
gotsysdis listening on. This path can be configured in gotsysd.conf(5).
SEE ALSO
got(1), gotsh(1), gotsys(1), gotsys.conf(5), gotsysd.conf(5), gotd(8), gotsysctl(8)
AUTHORS
Stefan Sperling <stsp@openbsd.org>