commit 61cd16367aebea23fe2bfc805f1929e08ae6a4a7 from: Stefan Sperling date: Wed Oct 23 18:43:37 2024 UTC it seems we won't have a gotsys(8) tool; update docs accordingly commit - 7c546bd8e9b2fe34f22db71d0cb0b6cc5fc182d6 commit + 61cd16367aebea23fe2bfc805f1929e08ae6a4a7 blob - 29ef49d47f77689f73bf132c16476a2ae949c029 blob + d7a1edc56eda56b81ad79e1f978d24510379b00f --- gotsys/gotsys.conf.5 +++ gotsys/gotsys.conf.5 @@ -21,9 +21,18 @@ .Nd gotsys configuration file .Sh DESCRIPTION .Nm -is the run-time configuration file for -.Xr gotsys 8 . +provides Git repository configuration information to +.Xr gotsysd 8 . .Pp +.Nm +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 Git repository hosted by +.Xr gotd 8 +which contains +.Nm . +.Pp The file format is line-based, with one configuration directive per line. Any lines beginning with a .Sq # @@ -69,7 +78,7 @@ If not specified, password-based authentication will b Allow this user to authenticate with an empty password. This must only be used for accounts which represent an anonymous user for public read-only repository access. -.Xr gotsys 1 +.Xr gotsysd 8 will reject any attempts to grant write access to this user. .It Ic ssh-pubkey Ar type Ar key Allow the user to authenticate with an SSH public key. @@ -121,9 +130,7 @@ or .\" If not specified, the user _gotd will be used. .El .Sh REPOSITORY CONFIGURATION -At least one repository context must exist for -.Xr gotsys 8 -to function. +At least one repository context must exist. For each repository, access rules must be configured using the .Ic permit and @@ -410,4 +417,4 @@ repository "secret" { .Sh SEE ALSO .Xr got 1 , .Xr gotd 8 , -.Xr gotsys 8 +.Xr gotsysd 8 blob - 4cdf6c9a893942c66e4d0c66f2e7361fce8bd818 blob + fc49a013d2b66d4e210926f49e5a935f72839a57 --- gotsysd/gotsysd.8 +++ gotsysd/gotsysd.8 @@ -32,11 +32,15 @@ repositores, and the addition and deletion of user acc the .Xr gotsh 1 shell. +.Pp .Nm allows remote administrators to configure aspects of Git repository -services without having shell access to the operating system. +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 Git repository. +special-purpose Git repository hosted by +.Xr gotd 8 +which contains +.Xr gotsys.conf 5 . .Pp .Nm listens on a