commit 742bb3a1b2e5b453a0342a433901b60612f437e7 from: Stefan Sperling date: Mon Oct 24 11:40:25 2022 UTC sync man pages commit - 5645e45bcc7b9a292dd452824a35998c9c491416 commit + 742bb3a1b2e5b453a0342a433901b60612f437e7 blob - 56b1efeb971dca525b28221251e42d0078122904 blob + d91ebfd5bd4d5d4512a9eff154b04bd2584fc316 --- git-repository.5.html +++ git-repository.5.html @@ -214,7 +214,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - 9189e91d7ced813a006b6a6f498c9e762f7c74cd blob + a81a11860d20a76ada8040cf8dcad11edc0e63e5 --- got-worktree.5.html +++ got-worktree.5.html @@ -186,7 +186,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - 07a25be5ddff9ebe5678b18787d232c89a3e3dd9 blob + a45272356912027e21c5c7eee7a6b27c1f6a39a0 --- got.1.html +++ got.1.html @@ -37,7 +37,7 @@ -
gotcommand [-h] + [-hV] command [arg ...]
@@ -3034,7 +3034,7 @@ remote "origin" {
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - a8a399a83515b6f498ce9b231cf8c8cfd7ae326f blob + fda77f6007360b525e2f6df0cf30c2d7160aa66b --- got.conf.5.html +++ got.conf.5.html @@ -299,7 +299,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - ca04cf76c4d3dbf6cfde3bb456642b4fc04e9f3f blob + ddd223dd8504bc6e9889ad018bc138c27458063d --- gotadmin.1.html +++ gotadmin.1.html @@ -38,7 +38,7 @@ -
gotadmincommand [-h] + [-hV] command [arg ...]
@@ -344,7 +344,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - ce553cbdf66c9c27aaa6aa46b4e1e329dd06767a blob + e7a676923f54c35afd7a8a1ad2cda8d0a3494e08 --- gotweb.8.html +++ gotweb.8.html @@ -162,7 +162,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - /dev/null blob + c3382c4d18318d9d11c431d7659dc27c45cc9c36 (mode 644) --- /dev/null +++ gotd.8.html @@ -0,0 +1,99 @@ + + + + + + + GOTD(8) + + + +
GOTD(8) System + Manager's Manual GOTD(8)
+
+
+

+

gotd — + Game of Trees Daemon

+
+
+

+ + + + + +
gotd[-dv] [-f + config-file]
+
+
+

+

gotd is a Git repository server which + listens on a unix(4) socket + and relies on its companion tool gotsh(1) to handle Git-protocol communication over the network, via + ssh(1).

+

The Git repository format is described in + git-repository(5).

+

gotd requires a configuration file in + order to run. The configuration file format is described in + gotd.conf(5).

+

The options for gotd are as follows:

+
+
+
Do not daemonize and log to stderr.
+
+ config-file
+
Set the path to the configuration file. If not specified, the file + /etc/gotd.conf will be used.
+
+
Verbose mode. Verbosity increases if this option is used multiple + times.
+
+
+
+

+
+
/etc/gotd.conf
+
Default location of the configuration file.
+
/var/run/gotd.sock
+
Default location of the unix socket which gotd is + listening on. This path can be configured in + gotd.conf(5).
+
+
+
+

+

got(1), + gotsh(1), + git-repository(5), + gotd.conf(5)

+
+
+

+

Stefan Sperling + <stsp@openbsd.org>

+
+
+
October 24, + 2022 OpenBSD 7.2
+ + blob - 78646d73ecb4d4c1fd8b13ceba8184e12c317255 blob + 9088a211458d7c10b9789a65e03cc905f7be42d5 --- gotweb.conf.5.html +++ gotweb.conf.5.html @@ -162,7 +162,7 @@ got_logo_url "https://gameoftrees.org"
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - /dev/null blob + 1775937c2e358e0212f7599cfacaa3cd85d6ec81 (mode 644) --- /dev/null +++ gotd.conf.5.html @@ -0,0 +1,139 @@ + + + + + + + GOTD.CONF(5) + + + +
GOTD.CONF(5) + File Formats Manual + GOTD.CONF(5)
+
+
+

+

gotd.conf — + gotd configuration file

+
+
+

+

gotd.conf is the run-time configuration + file for gotd(8).

+

The file format is line-based, with one configuration directive + per line. Any lines beginning with a ‘#’ are treated as + comments and ignored.

+
+
+

+

The available global configuration directives are as follows:

+
+
+ path
+
Set the path to the unix socket which gotd(8) should listen on. If not specified, the path + /var/run/gotd.sock will be used.
+
+ group
+
Set the group, defined in the + group(5) file, which is + allowed to access gotd(8) + via gotsh(1). The + gotd(8) user must be a + secondary member of this group. If not specified, the group _gotsh will be + used.
+
+ user
+
Set the user which will run + gotd(8). Initially, + gotd(8) requires root + privileges in order to create its unix socket and start child processes in + a chroot(2) environment. + Afterwards, gotd(8) drops + privileges to the specified user. If not specified, + the user _gotd will be used.
+
+
+
+

+

At least one repository context must exist for + gotd(8) to function.

+

A repository context is declared with a unique + name, followed by repository-specific configuration + directives inside curly braces:

+

repository name + {...}

+

got(1) and + git(1) clients can connect to + a repository by including the repository's unique name + in the request URL. Clients appending the string “.git” to the + name will also be accepted.

+

If desired, the name may contain + path-separators, “/”, to expose repositories as part of a + virtual client-visible directory hierarchy.

+

The available repository configuration directives are as + follows:

+
+
+ path
+
Set the path to the Git repository.
+
+
+
+

+
+
/etc/gotd.conf
+
Location of the gotd.conf configuration file.
+
+
+
+

+
+
# Default unix_group and user values:
+unix_group _gotsh
+user _gotd
+
+# This repository can be accessed via ssh://user@example.com/src
+repository "src" {
+	path "/var/git/src.git"
+}
+
+# This repository can be accessed via
+# ssh://user@example.com/openbsd/ports
+repository "openbsd/ports" {
+	path "/var/git/ports.git"
+}
+
+
+
+

+

got(1), + gotsh(1), + group(5), + gotd(8)

+
+
+
October 24, + 2022 OpenBSD 7.2
+ + blob - 5c52d1fe8a9055bd9516e3b4e9416e53dad41763 blob + b02453e2be7a8d1dc07915ad866df0c602a27b6e --- gotwebd.8.html +++ gotwebd.8.html @@ -39,8 +39,8 @@ gotwebd [-dnv] [-D - macro=value] [-f - file] + macro=value] + [-f file] @@ -56,8 +56,10 @@
Do not daemonize and log to stderr.
- macro=value
-
Override the value of a macro used in the configuration file.
+ macro=value +
Define macro to be set to + value. Overrides the definition of + macro in the configuration file.
file
Set the path to the configuration file. If not specified, the file @@ -183,7 +185,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2
blob - /dev/null blob + ba586387eb579ae90f9dbb5b2cd4b021637be008 (mode 644) --- /dev/null +++ gotsh.1.html @@ -0,0 +1,132 @@ + + + + + + + GOTSH(1) + + + +
GOTSH(1) General + Commands Manual GOTSH(1)
+
+
+

+

gotsh — + Game of Trees Shell

+
+
+

+ + + + + +
gotsh -c + ‘git-receive-pack + repository-path’
+
+ + + + + +
gotsh -c + ‘git-upload-pack + repository-path’
+
+
+

+

gotsh is the network-facing interface to + gotd(8). It implements the + server-side part of the Git network protocol used by + git(1) and + got(1).

+

gotsh is not an interactive shell. + gotsh is intended to be configured as the login + shell of Git repository user accounts on servers running + gotd(8). If users require a + different login shell, gotsh can be installed in the + command search path under the names git-receive-pack + and git-upload-pack.

+

The users can then interact with gotd(8) over the network. When users invoke commands such as + got send and got fetch on + client machines, got(1) will + connect to the server with ssh(1). gotsh will facilitate communication + between gotd(8) running on + the server machine and the got(1) or git(1) + program running on the client machine.

+

Users running gotsh must be members of the + group which has read/write permission to the gotd(8) unix socket. The group used for this purpose can be + configured in gotd.conf(5). Users running gotsh should not + have access to Git repositories by means other than accessing the unix + socket of gotd(8) via + gotsh.

+

It is recommended to restrict ssh(1) features available to users of + gotsh. See the EXAMPLES section for details.

+
+
+

+
+
+
Set the path to the unix socket which gotd(8) is listening on. If not specified, the default path + /var/run/gotd.sock will be used.
+
+
+
+

+

The following sshd_config(5) directives are recommended to protect the server + machine and any systems reachable from it via ssh(1) forwarding features. This example assumes the group + called “_gotsh” has read/write access to the + gotd(8) unix socket.

+
+
Match Group _gotsh
+    DisableForwarding
+    PermitTTY no
+
+
+
+

+

got(1), + ssh(1), + gotd.conf(5), + sshd_config(5), + gotd(8)

+
+
+

+

Stefan Sperling + <stsp@openbsd.org>

+
+
+
October 24, + 2022 OpenBSD 7.2
+ + blob - ae15b7be5cc4c69b2c5e7c5c6e067548989ac827 blob + 5a85f237e22a950d53fdc16320278fc6775a11ff --- gotwebd.conf.5.html +++ gotwebd.conf.5.html @@ -39,6 +39,14 @@

The file format is line-based, with one configuration directive per line. Any lines beginning with a ‘#’ are treated as comments and ignored.

+

Macros can be defined that are later expanded in context. Macro + names must start with a letter, digit, or underscore, and may contain any of + those characters, but may not be reserved words. Macros are not expanded + inside quotes. For example:

+
+
lan_addr = "192.168.0.1"
+listen on $lan_addr
+

Paths mentioned in gotwebd.conf must be relative to /var/www, the chroot(2) environment of @@ -239,7 +247,7 @@ server "localhost-unix" {

September 23, + line">October 24, 2022 OpenBSD 7.2
blob - 32c7e93cb3250e884ca4b8c8543069ea825fba2a blob + 7f5b34cf46ad38fd690c1b92b266d5af1e4c38a9 --- sync-man.sh +++ sync-man.sh @@ -13,6 +13,10 @@ done for f in gotwebd.8 gotwebd.conf.5; do $CONVERT $HOME/src/got/gotwebd/$f > ./${f}.html done +for f in gotd.8 gotd.conf.5; do + $CONVERT $HOME/src/got/gotd/$f > ./${f}.html +done +$CONVERT $HOME/src/got/gotsh/gotsh.1 > ./gotsh.1.html got st blob - 4bccc4ad49219ee8d49c71b7c7a601e69229ee72 blob + a9ed065f02ed269b35e40055c49cc8dcaa496c83 --- tog.1.html +++ tog.1.html @@ -36,7 +36,7 @@ -
tog[command] [-h] + [-hV] command [arg ...]
@@ -81,6 +81,15 @@ unmapped key. Once a compound command is executed, the operation can be cancelled with C-g or Backspace.

+

Global options must precede the command name, and are as + follows:

+
+
+
Display usage information.
+
, + --version
+
Display program version and exit immediately.
+

The global key bindings are:

Go to line N in the view (default: first line).
-

Global options must precede the command name, and are as - follows:

-
-
-
Display usage information.
-
, - --version
-
Display program version and exit immediately.
-

The commands for tog are as follows:

@@ -778,7 +778,7 @@
September 23, + line">October 24, 2022 OpenBSD 7.2