commit - 81054e7c725568a029d3b0e7852284f46947f6bc
commit + 47f19dd515895c4e10e541d48978aacc01938d66
blob - 87e7a182ec7b02f70216eb525d265fe931cc0458
blob + 9b1865ca178b0f671ecbd331ce508dc0a6c4e104
--- git-repository.5.html
+++ git-repository.5.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - fe67c58aad76da33900be20a889b7e424b6ab0f7
blob + e512a57be5c268b74cc0c6a20f64b737cda92f3c
--- got-worktree.5.html
+++ got-worktree.5.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 53d6459b2200edd1546a04fd0b9671e1a3377592
blob + 708b13153d8597509212480a1142b2723e559c1a
--- got.1.html
+++ got.1.html
“/”, in a pattern.</p>
</dd>
<dt id="log"><a class="permalink" href="#log"><code class="Cm">log</code></a>
- [<code class="Fl">-bPpRs</code>] [<code class="Fl">-C</code>
+ [<code class="Fl">-bdPpRs</code>] [<code class="Fl">-C</code>
<var class="Ar">number</var>] [<code class="Fl">-c</code>
<var class="Ar">commit</var>] [<code class="Fl">-l</code>
<var class="Ar">N</var>] [<code class="Fl">-r</code>
this option is not specified, default to the work tree's current
branch if invoked in a work tree, or to the repository's HEAD
reference.</dd>
+ <dt id="d~2"><a class="permalink" href="#d~2"><code class="Fl">-d</code></a></dt>
+ <dd>Display diffstat of changes introduced in each commit. Cannot be used
+ with the <code class="Fl">-s</code> option.</dd>
<dt id="l~3"><a class="permalink" href="#l~3"><code class="Fl">-l</code></a>
<var class="Ar">N</var></dt>
<dd>Limit history traversal to a given number of commits. If this option
</dl>
</dd>
<dt id="di"><a class="permalink" href="#diff"><code class="Cm" id="diff">diff</code></a>
- [<code class="Fl">-aPsw</code>] [<code class="Fl">-C</code>
+ [<code class="Fl">-adPsw</code>] [<code class="Fl">-C</code>
<var class="Ar">number</var>] [<code class="Fl">-c</code>
<var class="Ar">commit</var>] [<code class="Fl">-r</code>
<var class="Ar">repository-path</var>] [<var class="Ar">object1</var>
<p class="Pp">Cannot be used together with the
<code class="Fl">-P</code> option.</p>
</dd>
+ <dt id="d~3"><a class="permalink" href="#d~3"><code class="Fl">-d</code></a></dt>
+ <dd>Display diffstat of changes before the actual diff by annotating each
+ file path or blob hash being diffed with the total number of lines
+ added and removed. A summary line will display the total number of
+ changes across all files.</dd>
<dt id="P~2"><a class="permalink" href="#P~2"><code class="Fl">-P</code></a></dt>
<dd>Interpret all arguments as paths only. This option can be used to
resolve ambiguity in cases where paths look like tag names, reference
corresponding commit, tree, tag, or blob object. Cannot be used
together with any other options except
<code class="Fl">-r</code>.</dd>
- <dt id="d~2"><a class="permalink" href="#d~2"><code class="Fl">-d</code></a></dt>
+ <dt id="d~4"><a class="permalink" href="#d~4"><code class="Fl">-d</code></a></dt>
<dd>Delete the reference with the specified <var class="Ar">name</var>
from the repository. Any commit, tree, tag, and blob objects belonging
to deleted references remain in the repository and may be removed
<var class="Ar">commit</var> argument is a commit ID SHA1 hash or an
existing reference or tag name which will be resolved to a commit
ID.</dd>
- <dt id="d~3"><a class="permalink" href="#d~3"><code class="Fl">-d</code></a>
+ <dt id="d~5"><a class="permalink" href="#d~5"><code class="Fl">-d</code></a>
<var class="Ar">name</var></dt>
<dd>Delete the branch with the specified <var class="Ar">name</var> from
the “refs/heads” or “refs/remotes”
current branch if invoked in a work tree, or to the repository's HEAD
reference. Cannot be used together with the <code class="Fl">-a</code>
option.</dd>
- <dt id="d~4"><a class="permalink" href="#d~4"><code class="Fl">-d</code></a>
+ <dt id="d~6"><a class="permalink" href="#d~6"><code class="Fl">-d</code></a>
<var class="Ar">branch</var></dt>
<dd>Delete the specified <var class="Ar">branch</var> from the remote
repository's “refs/heads/” reference namespace. This
the <var class="Ar">branch</var> contains changes to files outside of
the work tree's path prefix, the work tree cannot be used to rebase this
branch.</p>
- <p class="Pp">The <code class="Cm">got update</code> and
- <code class="Cm">got commit</code> commands will refuse to run while a
- rebase operation is in progress. Other commands which manipulate the
- work tree may be used for conflict resolution purposes.</p>
+ <p class="Pp">The <code class="Cm">got update</code>, <code class="Cm">got
+ integrate</code>, <code class="Cm">got merge</code>,
+ <code class="Cm">got commit</code>, and <code class="Cm">got
+ histedit</code> commands will refuse to run while a rebase operation is
+ in progress. Other commands which manipulate the work tree may be used
+ for conflict resolution purposes.</p>
<p class="Pp">If the specified <var class="Ar">branch</var> is already based
on the work tree's current branch, then no commits need to be rebased
and <code class="Cm">got rebase</code> will simply switch the work tree
path prefix, the work tree cannot be used to edit the history of this
branch.</p>
<p class="Pp">The <code class="Cm">got update</code>, <code class="Cm">got
- rebase</code>, and <code class="Cm">got integrate</code> commands will
- refuse to run while a histedit operation is in progress. Other commands
- which manipulate the work tree may be used, and the <code class="Cm">got
- commit</code> command may be used to commit arbitrary changes to the
- temporary branch while the histedit operation is interrupted.</p>
+ rebase</code>, <code class="Cm">got merge</code>, and
+ <code class="Cm">got integrate</code> commands will refuse to run while
+ a histedit operation is in progress. Other commands which manipulate the
+ work tree may be used, and the <code class="Cm">got commit</code>
+ command may be used to commit arbitrary changes to the temporary branch
+ while the histedit operation is interrupted.</p>
<p class="Pp">The options for <code class="Cm">got histedit</code> are as
follows:</p>
<dl class="Bl-tag">
references:</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">$ got branch -l</code></div>
+<p class="Pp">As above, but list the most recently modified branches only:</p>
+<p class="Pp"></p>
+<div class="Bd Bd-indent"><code class="Li">$ got branch -lt | head</code></div>
<p class="Pp">In a work tree or a git repository directory, create a new branch
called “unified-buffer-cache” which is forked off the
“master” branch:</p>
<a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
<a class="Xr" aria-label="got-worktree, section 5">got-worktree(5)</a>,
<a class="Xr" aria-label="got.conf, section 5">got.conf(5)</a>,
- <a class="Xr" aria-label="gotweb, section 8">gotweb(8)</a></p>
+ <a class="Xr" aria-label="gotwebd, section 8">gotwebd(8)</a></p>
</section>
<section class="Sh">
<h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
<<a class="Mt" href="mailto:yzhong@freebsdfoundation.org">yzhong@freebsdfoundation.org</a>></p>
<p class="Pp">Parts of <code class="Nm">got</code>,
<a class="Xr" aria-label="tog, section 1">tog(1)</a>, and
- <a class="Xr" aria-label="gotweb, section 8">gotweb(8)</a> were derived from
- code under copyright by:</p>
+ <a class="Xr" aria-label="gotwebd, section 8">gotwebd(8)</a> were derived
+ from code under copyright by:</p>
<p class="Pp">
<br/>
<span class="An">Caldera International</span>
<p class="Pp"><code class="Nm">got</code> contains code contributed to the
public domain by
<br/>
- <span class="An">Austin Appleby</span></p>
+ <span class="An">Austin Appleby</span>.</p>
</section>
<section class="Sh">
<h2 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h2>
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 8a777c2a250069e806ee1f46c16e1fb81c3fdc08
blob + e951be762a949f4980054447e5acf7db54317362
--- got.conf.5.html
+++ got.conf.5.html
</dl>
</section>
<section class="Sh">
+<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
+<dl class="Bl-tag Bl-compact">
+ <dt><span class="Pa">got.conf</span></dt>
+ <dd>If present, <code class="Nm">got.conf</code> located in the root directory
+ of a Git repository supersedes any relevant settings in Git's
+ <span class="Pa">config</span> file.
+ <p class="Pp"></p>
+ </dd>
+ <dt><span class="Pa">.got/got.conf</span></dt>
+ <dd>If present, <code class="Nm">got.conf</code> located in the
+ <span class="Pa">.got</span> meta-data directory of a
+ <a class="Xr" aria-label="got, section 1">got(1)</a> work tree supersedes
+ any relevant settings in the repository's <code class="Nm">got.conf</code>
+ configuration file and Git's <span class="Pa">config</span> file.</dd>
+</dl>
+</section>
+<section class="Sh">
<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
<p class="Pp">Configure author information:</p>
<div class="Bd Pp Bd-indent Li">
}
}</pre>
</div>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
-<dl class="Bl-tag Bl-compact">
- <dt><span class="Pa">got.conf</span></dt>
- <dd>If present, <code class="Nm">got.conf</code> located in the root directory
- of a Git repository supersedes any relevant settings in Git's
- <span class="Pa">config</span> file.
- <p class="Pp"></p>
- </dd>
- <dt><span class="Pa">.got/got.conf</span></dt>
- <dd>If present, <code class="Nm">got.conf</code> located in the
- <span class="Pa">.got</span> meta-data directory of a
- <a class="Xr" aria-label="got, section 1">got(1)</a> work tree supersedes
- any relevant settings in the repository's <code class="Nm">got.conf</code>
- configuration file and Git's <span class="Pa">config</span> file.</dd>
-</dl>
</section>
<section class="Sh">
<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 8ced2c901409d96bb07e1ad6dd2fec013d547f41
blob + 7198717a32fa9f561c39a519c6cf0ed9cff6dd8f
--- gotadmin.1.html
+++ gotadmin.1.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 8c06429318b03131ea921d28a3db918ba13f462c
blob + 71c7630352b19a9d655b0947b5b871a971591390
--- gotctl.8.html
+++ gotctl.8.html
<dl class="Bl-tag">
<dt id="info"><a class="permalink" href="#info"><code class="Cm">info</code></a></dt>
<dd>Display information about a running <a class="Xr" aria-label="gotd,
- section 8">gotd(8)</a> instance.</dd>
+ section 8">gotd(8)</a> instance. This operation requires root
+ privileges.</dd>
<dt id="stop"><a class="permalink" href="#stop"><code class="Cm">stop</code></a></dt>
<dd>Stop a running <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>
instance. This operation requires root privileges.</dd>
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 9a3d7abd54ab70cefe08570ceb64c44915f0ddca
blob + 571014fb1d185972e28ae9f121a45cef821e54b3
--- gotd.8.html
+++ gotd.8.html
<p class="Pp"><code class="Nm">gotd</code> requires a configuration file in
order to run. The configuration file format is described in
<a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>.</p>
+<p class="Pp">It is recommended to restrict <a class="Xr" aria-label="ssh,
+ section 1">ssh(1)</a> features available to users of
+ <code class="Nm">gotd</code>. See <a class="Xr" aria-label="gotsh, section
+ 1">gotsh(1)</a> for details.</p>
<p class="Pp">The options for <code class="Nm">gotd</code> are as follows:</p>
<dl class="Bl-tag">
<dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt>
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 8b2287f65b8d3ebe9a1c958ddc4e407dd4a8ef80
blob + de4d3567cb5cf6b0bd212827096066a7a62855c7
--- gotd.conf.5.html
+++ gotd.conf.5.html
CONFIGURATION</a></h2>
<p class="Pp">The available global configuration directives are as follows:</p>
<dl class="Bl-tag">
- <dt id="unix_socket"><a class="permalink" href="#unix_socket"><code class="Ic">unix_socket</code></a>
- <var class="Ar">path</var></dt>
+ <dt id="connection"><a class="permalink" href="#connection"><code class="Ic">connection</code></a>
+ <var class="Ar">option</var></dt>
+ <dd>Set the specified options and limits for connections to the
+ <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> unix socket.
+ <p class="Pp">The <code class="Ic">connection</code> directive may be
+ specified multiple times, and multiple <var class="Ar">option</var>
+ arguments may be specified within curly braces:</p>
+ <p class="Pp"><code class="Ic">connection</code>
+ {<var class="Ar">...</var>}</p>
+ <p class="Pp">Each option should only be specified once. If a given option
+ is listed multiple times, the last line which sets this option wins.</p>
+ <p class="Pp">Valid connection options are:</p>
+ <dl class="Bl-tag">
+ <dt id="request"><a class="permalink" href="#request"><code class="Ic">request
+ timeout</code></a> <var class="Ar">seconds</var></dt>
+ <dd>Specify the inactivity timeout for operations between client and
+ server. If this timeout is exceeded while a Git protocol request is
+ being processed, the request will be aborted and the connection will
+ be terminated.
+ <p class="Pp">The timeout value may also have a suffix indicating its
+ unit of measure. Supported suffixes are:</p>
+ <p class="Pp"></p>
+ <dl class="Bl-tag Bl-compact">
+ <dt><var class="Ar">s</var> <span class="No">or</span>
+ <var class="Ar">S</var></dt>
+ <dd>seconds</dd>
+ <dt><var class="Ar">m</var> <span class="No">or</span>
+ <var class="Ar">M</var></dt>
+ <dd>minutes</dd>
+ <dt><var class="Ar">h</var> <span class="No">or</span>
+ <var class="Ar">H</var></dt>
+ <dd>hours</dd>
+ </dl>
+ <p class="Pp">The default timeout is 1h (3600 seconds, one hour). This
+ should only be changed if legitimate requests are exceeding the
+ default timeout for some reason, such as the server spending an
+ extraordinary amount of time generating a pack file.</p>
+ </dd>
+ <dt id="limit"><a class="permalink" href="#limit"><code class="Ic">limit</code></a>
+ <code class="Ic">user</code> <var class="Ar">identity</var>
+ <var class="Ar">number</var></dt>
+ <dd>Limit the maximum amount of concurrent connections by the user with
+ the username <var class="Ar">identity</var> to
+ <var class="Ar">number</var>. Numeric user IDs are also accepted.
+ <p class="Pp">The default per-user limit is 4. This should only be
+ changed if concurrent connections from a given user are expected to
+ exceed the default limit, for example if an anonymous user is
+ granted read access and many concurrent connections will share this
+ anonymous user identity.</p>
+ </dd>
+ </dl>
+ </dd>
+ <dt id="listen"><a class="permalink" href="#listen"><code class="Ic">listen
+ on</code></a> <var class="Ar">path</var></dt>
<dd>Set the path to the unix socket which <a class="Xr" aria-label="gotd,
section 8">gotd(8)</a> should listen on. If not specified, the path
<span class="Pa">/var/run/gotd.sock</span> will be used.</dd>
- <dt id="unix_group"><a class="permalink" href="#unix_group"><code class="Ic">unix_group</code></a>
- <var class="Ar">group</var></dt>
- <dd>Set the <var class="Ar">group</var>, defined in the
- <a class="Xr" aria-label="group, section 5">group(5)</a> file, which is
- allowed to access <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>
- via <a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>. The
- <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> user must be a
- secondary member of this group. If not specified, the group _gotsh will be
- used.</dd>
<dt id="user"><a class="permalink" href="#user"><code class="Ic">user</code></a>
<var class="Ar">user</var></dt>
<dd>Set the <var class="Ar">user</var> which will run
<a class="Xr" aria-label="gotd, section 8">gotd(8)</a>. Initially,
<a class="Xr" aria-label="gotd, section 8">gotd(8)</a> requires root
- privileges in order to create its unix socket and start child processes in
- a <a class="Xr" aria-label="chroot, section 2">chroot(2)</a> environment.
- Afterwards, <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> drops
- privileges to the specified <var class="Ar">user</var>. If not specified,
- the user _gotd will be used.</dd>
+ privileges in order to create its unix socket. Afterwards,
+ <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> drops privileges to
+ the specified <var class="Ar">user</var>. If not specified, the user _gotd
+ will be used.</dd>
</dl>
</section>
<section class="Sh">
<h2 class="Sh" id="REPOSITORY_CONFIGURATION"><a class="permalink" href="#REPOSITORY_CONFIGURATION">REPOSITORY
CONFIGURATION</a></h2>
<p class="Pp">At least one repository context must exist for
- <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> to function.</p>
+ <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> to function. For each
+ repository, access rules must be configured using the
+ <code class="Ic">permit</code> and <code class="Ic">deny</code>
+ configuration directives. Multiple access rules can be specified, and the
+ last matching rule determines the action taken. If no rule matches, access
+ to the repository is denied.</p>
<p class="Pp">A repository context is declared with a unique
<var class="Ar">name</var>, followed by repository-specific configuration
directives inside curly braces:</p>
<p class="Pp">The available repository configuration directives are as
follows:</p>
<dl class="Bl-tag">
+ <dt id="deny"><a class="permalink" href="#deny"><code class="Ic">deny</code></a>
+ <var class="Ar">identity</var></dt>
+ <dd>Deny repository access to users with the username
+ <var class="Ar">identity</var>. Group names may be matched by prepending a
+ colon (‘:’) to <var class="Ar">identity</var>. Numeric IDs
+ are also accepted.</dd>
<dt id="path"><a class="permalink" href="#path"><code class="Ic">path</code></a>
<var class="Ar">path</var></dt>
- <dd>Set the path to the Git repository.</dd>
+ <dd>Set the path to the Git repository. Must be specified.</dd>
+ <dt id="permit"><a class="permalink" href="#permit"><code class="Ic">permit</code></a>
+ <var class="Ar">mode</var> <var class="Ar">identity</var></dt>
+ <dd>Permit repository access to users with the username
+ <var class="Ar">identity</var>. The <var class="Ar">mode</var> argument
+ must be set to either <code class="Ic">ro</code> for read-only access, or
+ <code class="Ic">rw</code> for read-write access. Group names may be
+ matched by prepending a colon (‘:’) to
+ <var class="Ar">identity</var>. Numeric IDs are also accepted.</dd>
</dl>
</section>
<section class="Sh">
<section class="Sh">
<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
<div class="Bd Bd-indent Li">
-<pre># Default unix_group and user values:
-unix_group _gotsh
+<pre># Run as the default user:
user _gotd
+# Listen on the default socket:
+listen on "/var/run/gotd.sock"
+
# This repository can be accessed via ssh://user@example.com/src
repository "src" {
path "/var/git/src.git"
+ permit rw flan_hacker
+ permit rw :developers
+ permit ro anonymous
}
# This repository can be accessed via
# ssh://user@example.com/openbsd/ports
repository "openbsd/ports" {
path "/var/git/ports.git"
+ permit rw :porters
+ permit ro anonymous
+ deny flan_hacker
+}
+
+# Use a larger request timeout value:
+connection request timeout 2h
+
+# Some users are granted a higher concurrent connection limit:
+connection {
+ limit user flan_hacker 16
+ limit user anonymous 32
}</pre>
</div>
</section>
ALSO</a></h2>
<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
<a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>,
- <a class="Xr" aria-label="group, section 5">group(5)</a>,
<a class="Xr" aria-label="gotd, section 8">gotd(8)</a></p>
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 546ab45ca6324cef0c4a0e5962f268473db4aac1
blob + 8e18c8eebb904f8f3d8cecc8dca52d7dc2171e7a
--- gotsh.1.html
+++ gotsh.1.html
the server machine and the <a class="Xr" aria-label="got, section
1">got(1)</a> or <a class="Xr" aria-label="git, section 1">git(1)</a>
program running on the client machine.</p>
-<p class="Pp">Users running <code class="Nm">gotsh</code> must be members of the
- group which has read/write permission to the <a class="Xr" aria-label="gotd,
- section 8">gotd(8)</a> unix socket. The group used for this purpose can be
- configured in <a class="Xr" aria-label="gotd.conf, section
- 5">gotd.conf(5)</a>. Users running <code class="Nm">gotsh</code> should not
- have access to Git repositories by means other than accessing the unix
- socket of <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> via
+<p class="Pp">Users running <code class="Nm">gotsh</code> should not have access
+ to Git repositories by means other than accessing the unix socket of
+ <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> via
<code class="Nm">gotsh</code>.</p>
<p class="Pp">It is recommended to restrict <a class="Xr" aria-label="ssh,
section 1">ssh(1)</a> features available to users of
</section>
<section class="Sh">
<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
-<p class="Pp">The following <a class="Xr" aria-label="sshd_config, section
- 5">sshd_config(5)</a> directives are recommended to protect the server
- machine and any systems reachable from it via <a class="Xr" aria-label="ssh,
- section 1">ssh(1)</a> forwarding features. This example assumes the group
- called “_gotsh” has read/write access to the
- <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> unix socket.</p>
+<p class="Pp"><a class="Xr" aria-label="sshd_config, section
+ 5">sshd_config(5)</a> directives such as the following are recommended to
+ protect the server machine and any systems reachable from it, especially if
+ anonymous users are allowed to connect:</p>
<div class="Bd Pp Bd-indent Li">
-<pre>Match Group _gotsh
+<pre>Match User anonymous
DisableForwarding yes
PermitTTY no</pre>
</div>
+<p class="Pp">It can be convenient to add all relevant users to a common group,
+ such as “developers”, and then use this group as the Match
+ criteria:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>Match Group developers
+ DisableForwarding yes
+ PermitTTY no</pre>
+</div>
</section>
<section class="Sh">
<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - b6c94263d0ec849b3da66176c0e604a091165062
blob + e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
--- gotweb.8.html
+++ gotweb.8.html
-<!DOCTYPE html>
-<html>
-<head>
- <meta charset="utf-8"/>
- <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
- <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
- <title>GOTWEB(8)</title>
-</head>
-<!-- This is an automatically generated file. Do not edit.
- Copyright (c) 2020 Stefan Sperling
-
- Permission to use, copy, modify, and distribute this software for any
- purpose with or without fee is hereby granted, provided that the above
- copyright notice and this permission notice appear in all copies.
-
- THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
- WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
- MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
- ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
- WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
- ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
- OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
- -->
-<body>
-<div class="head" role="doc-pageheader" aria-label="Manual header
- line"><span class="head-ltitle">GOTWEB(8)</span> <span class="head-vol">System
- Manager's Manual</span> <span class="head-rtitle">GOTWEB(8)</span></div>
-<main class="manual-text">
-<section class="Sh">
-<h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
-<p class="Pp"><code class="Nm">gotweb</code> —
- <span class="Nd" role="doc-subtitle">Game of Trees Git repository server for
- web browsers</span></p>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h2>
-<table class="Nm">
- <tr>
- <td><code class="Nm">gotweb</code></td>
- <td></td>
- </tr>
-</table>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
-<p class="Pp"><code class="Nm">gotweb</code> provides a web interface allowing
- Git repository contents to be viewed with a web browser.</p>
-<p class="Pp"><code class="Nm">gotweb</code> is a CGI program based on
- <a class="Xr" aria-label="got, section 1">got(1)</a> and
- <a class="Xr" aria-label="kcgi, section 3">kcgi(3)</a> which is intended to
- run in a <a class="Xr" aria-label="chroot, section 2">chroot(2)</a>
- environment in <span class="Pa">/var/www</span>. The program has been
- designed to work out of the box with the <a class="Xr" aria-label="httpd,
- section 8">httpd(8)</a> web server in conjunction with
- <a class="Xr" aria-label="slowcgi, section 8">slowcgi(8)</a>.</p>
-<p class="Pp">Enabling <code class="Nm">gotweb</code> requires the following
- steps:</p>
-<ol class="Bl-enum">
- <li>The <a class="Xr" aria-label="httpd.conf, section 5">httpd.conf(5)</a>
- configuration file must be adjusted to run <code class="Nm">gotweb</code>
- as a CGI program with <a class="Xr" aria-label="slowcgi, section
- 8">slowcgi(8)</a>. The <a class="Sx" href="#EXAMPLES">EXAMPLES</a> section
- below contains an appropriate configuration file sample.</li>
- <li>httpd(8) and slowcgi(8) must be enabled and started:
- <div class="Bd Pp Bd-indent Li">
- <pre> # rcctl enable httpd slowcgi
- # rcctl start httpd slowcgi</pre>
- </div>
- </li>
- <li>Optionally, the run-time behaviour of <code class="Nm">gotweb</code> can
- be configured via the <a class="Xr" aria-label="gotweb.conf, section
- 5">gotweb.conf(5)</a> configuration file.</li>
- <li id="not">Git repositories must be created at a suitable location inside
- the web server's <a class="Xr" aria-label="chroot, section
- 2">chroot(2)</a> environment. These repositories should
- <a class="permalink" href="#not"><i class="Em">not</i></a> be writable by
- the user ID of the <a class="Xr" aria-label="httpd, section
- 8">httpd(8)</a> server. The default location for repositories published by
- <code class="Nm">gotweb</code> is
- <span class="Pa">/var/www/got/public</span>.</li>
- <li>Git repositories served by <code class="Nm">gotweb</code> should be kept
- up-to-date with a mechanism such as <code class="Cm">got fetch</code>,
- <a class="Xr" aria-label="git-fetch, section 1">git-fetch(1)</a>, or
- <a class="Xr" aria-label="rsync, section 1">rsync(1)</a>, scheduled by
- <a class="Xr" aria-label="cron, section 8">cron(8)</a>.</li>
-</ol>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
-<dl class="Bl-tag Bl-compact">
- <dt><span class="Pa">/var/www/got/public/</span></dt>
- <dd>Default location for Git repositories served by
- <code class="Nm">gotweb</code>. This location can be adjusted in the
- <a class="Xr" aria-label="gotweb.conf, section 5">gotweb.conf(5)</a>
- configuration file.</dd>
- <dt><span class="Pa">/var/www/cgi-bin/gotweb/gotweb</span></dt>
- <dd>The <code class="Nm">gotweb</code> CGI program, statically linked for use
- in a <a class="Xr" aria-label="chroot, section 2">chroot(2)</a>
- environment.</dd>
- <dt><span class="Pa">/var/www/cgi-bin/gotweb/gw_tmpl/</span></dt>
- <dd>Directory for template files used by <code class="Nm">gotweb</code>.</dd>
- <dt><span class="Pa">/var/www/cgi-bin/gotweb/libexec/</span></dt>
- <dd>Directory containing statically linked <a class="Xr" aria-label="got,
- section 1">got(1)</a> helper programs which are run by
- <code class="Nm">gotweb</code> to read Git repositories.</dd>
- <dt><span class="Pa">/var/www/htdocs/gotweb/</span></dt>
- <dd>Directory containing HTML, CSS, and image files used by
- <code class="Nm">gotweb</code>.</dd>
- <dt><span class="Pa">/var/www/got/tmp/</span></dt>
- <dd>Directory for temporary files created by
- <code class="Nm">gotweb</code>.</dd>
-</dl>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
-<p class="Pp">Example configuration for httpd.conf:</p>
-<div class="Bd Pp Bd-indent Li">
-<pre>
- types { include "/usr/share/misc/mime.types" }
- server "gotweb.example.com" {
- listen on * port 80
- root "/htdocs/gotweb"
- location "/cgi-bin/*" {
- root "/"
- fastcgi
- }
- location "/*" {
- directory index "index.html"
- }
- }</pre>
-</div>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
- ALSO</a></h2>
-<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
- <a class="Xr" aria-label="kcgi, section 3">kcgi(3)</a>,
- <a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
- <a class="Xr" aria-label="gotweb.conf, section 5">gotweb.conf(5)</a>,
- <a class="Xr" aria-label="httpd, section 8">httpd(8)</a>,
- <a class="Xr" aria-label="slowcgi, section 8">slowcgi(8)</a></p>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
-<p class="Pp"><span class="An">Christian Weisgerber</span>
- <<a class="Mt" href="mailto:naddy@openbsd.org">naddy@openbsd.org</a>>
- <br/>
- <span class="An">Jerome Kasper</span>
- <<a class="Mt" href="mailto:neon.king.fr@gmail.com">neon.king.fr@gmail.com</a>>
- <br/>
- <span class="An">Josh Rickmar</span>
- <<a class="Mt" href="mailto:jrick@zettaport.com">jrick@zettaport.com</a>>
- <br/>
- <span class="An">Omar Polo</span>
- <<a class="Mt" href="mailto:op@openbsd.org">op@openbsd.org</a>>
- <br/>
- <span class="An">Stefan Sperling</span>
- <<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>>
- <br/>
- <span class="An">Tracey Emery</span>
- <<a class="Mt" href="mailto:tracey@traceyemery.net">tracey@traceyemery.net</a>></p>
-</section>
-</main>
-<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
-</body>
-</html>
blob - ccfee572378be67944026f1c44e71a5b6bfdbd9a
blob + e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
--- gotweb.conf.5.html
+++ gotweb.conf.5.html
-<!DOCTYPE html>
-<html>
-<head>
- <meta charset="utf-8"/>
- <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
- <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
- <title>GOTWEB.CONF(5)</title>
-</head>
-<!-- This is an automatically generated file. Do not edit.
- Copyright (c) 2020 Tracey Emery <tracey@traceyemery.net>
-
- Permission to use, copy, modify, and distribute this software for any
- purpose with or without fee is hereby granted, provided that the above
- copyright notice and this permission notice appear in all copies.
-
- THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
- WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
- MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
- ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
- WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
- ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
- OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
- -->
-<body>
-<div class="head" role="doc-pageheader" aria-label="Manual header
- line"><span class="head-ltitle">GOTWEB.CONF(5)</span>
- <span class="head-vol">File Formats Manual</span>
- <span class="head-rtitle">GOTWEB.CONF(5)</span></div>
-<main class="manual-text">
-<section class="Sh">
-<h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
-<p class="Pp"><code class="Nm">gotweb.conf</code> —
- <span class="Nd" role="doc-subtitle">gotweb configuration file</span></p>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
-<p class="Pp"><code class="Nm">gotweb.conf</code> is the run-time configuration
- file for <a class="Xr" aria-label="gotweb, section 8">gotweb(8)</a>.</p>
-<p class="Pp">The file format is line-based, with one configuration directive
- per line. Any lines beginning with a ‘#’ are treated as
- comments and ignored.</p>
-<p class="Pp">Paths mentioned in <code class="Nm">gotweb.conf</code> must be
- relative to <span class="Pa">/var/www</span>, the
- <a class="Xr" aria-label="chroot, section 2">chroot(2)</a> environment of
- <a class="Xr" aria-label="httpd, section 8">httpd(8)</a>.</p>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="GLOBAL_CONFIGURATION"><a class="permalink" href="#GLOBAL_CONFIGURATION">GLOBAL
- CONFIGURATION</a></h2>
-<p class="Pp">The available configuration directives are as follows:</p>
-<dl class="Bl-tag">
- <dt id="got_max_commits_display"><a class="permalink" href="#got_max_commits_display"><code class="Ic">got_max_commits_display</code></a>
- <var class="Ar">number</var></dt>
- <dd>Set the maximum amount of commits displayed per page.</dd>
- <dt id="got_logo"><a class="permalink" href="#got_logo"><code class="Ic">got_logo</code></a>
- <var class="Ar">path</var></dt>
- <dd>Set the path to an image file containing a logo to be displayed.</dd>
- <dt id="got_logo_url"><a class="permalink" href="#got_logo_url"><code class="Ic">got_logo_url</code></a>
- <var class="Ar">url</var></dt>
- <dd>Set a hyperlink for the logo.</dd>
- <dt id="got_max_repos"><a class="permalink" href="#got_max_repos"><code class="Ic">got_max_repos</code></a>
- <var class="Ar">number</var></dt>
- <dd>Set the maximum amount of repositories <a class="Xr" aria-label="gotweb,
- section 8">gotweb(8)</a> will work with.</dd>
- <dt id="got_max_repos_display"><a class="permalink" href="#got_max_repos_display"><code class="Ic">got_max_repos_display</code></a>
- <var class="Ar">number</var></dt>
- <dd>Set the maximum amount of repositories displayed on the index screen.</dd>
- <dt id="got_show_repo_age"><a class="permalink" href="#got_show_repo_age"><code class="Ic">got_show_repo_age</code></a>
- <var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of last repository modification date.</dd>
- <dt id="got_show_repo_cloneurl"><a class="permalink" href="#got_show_repo_cloneurl"><code class="Ic">got_show_repo_cloneurl</code></a>
- <var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of clone URLs for a repository. This requires the creation
- of a <span class="Pa">cloneurl</span> file inside the repository which
- contains one URL per line.</dd>
- <dt id="got_show_repo_description"><a class="permalink" href="#got_show_repo_description"><code class="Ic">got_show_repo_description</code></a>
- <var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of the repository description. The
- <span class="Pa">description</span> file in the repository should be
- updated with an appropriate description.</dd>
- <dt id="got_repos_path"><a class="permalink" href="#got_repos_path"><code class="Ic">got_repos_path</code></a>
- <var class="Ar">path</var></dt>
- <dd>Set the path to the directory which contains Git repositories that
- <a class="Xr" aria-label="gotweb, section 8">gotweb(8)</a> should
- publish.</dd>
- <dt id="got_show_repo_owner"><a class="permalink" href="#got_show_repo_owner"><code class="Ic">got_show_repo_owner</code></a>
- <var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Set whether to display the repository owner. Displaying the owner requires
- owner information to be added to the <span class="Pa">config</span> file
- in the repository. <a class="Xr" aria-label="gotweb, section
- 8">gotweb(8)</a> will parse owner information from either a [gotweb] or a
- [gitweb] section. For example:
- <div class="Bd Pp Bd-indent Li">
- <pre>[gotweb]
-owner = "Your Name"</pre>
- </div>
- </dd>
- <dt id="got_site_link"><a class="permalink" href="#got_site_link"><code class="Ic">got_site_link</code></a>
- <var class="Ar">string</var></dt>
- <dd>Set the displayed site link name for the index page.</dd>
- <dt id="got_site_name"><a class="permalink" href="#got_site_name"><code class="Ic">got_site_name</code></a>
- <var class="Ar">string</var></dt>
- <dd>Set the displayed site name title.</dd>
- <dt id="got_site_owner"><a class="permalink" href="#got_site_owner"><code class="Ic">got_site_owner</code></a>
- <var class="Ar">string</var></dt>
- <dd>Set the displayed site owner.</dd>
- <dt id="got_show_site_owner"><a class="permalink" href="#got_show_site_owner"><code class="Ic">got_show_site_owner</code></a>
- <var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of the site owner.</dd>
- <dt id="got_www_path"><a class="permalink" href="#got_www_path"><code class="Ic">got_www_path</code></a>
- <var class="Ar">string</var></dt>
- <dd>Set the public gotweb httpd path.</dd>
-</dl>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
-<p class="Pp">These are the currently configurable items for
- <a class="Xr" aria-label="gotweb, section 8">gotweb(8)</a> with their
- default values.</p>
-<div class="Bd Pp Bd-indent Li">
-<pre>
-#
-# gotweb options
-# all paths relative to /var/www (httpd chroot jail)
-#
-
-got_repos_path "/got/public"
-got_www_path "/gotweb"
-
-#got_max_repos 100
-#got_max_repos_display 25
-got_max_commits_display 50
-
-got_site_name "my public repos"
-got_site_owner "Got Owner"
-got_site_link "repos"
-
-got_logo "got.png"
-got_logo_url "https://gameoftrees.org"
-
-# on by default
-#got_show_site_owner off
-#got_show_repo_owner off
-#got_show_repo_age false
-#got_show_repo_description no
-#got_show_repo_cloneurl off</pre>
-</div>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
-<dl class="Bl-tag Bl-compact">
- <dt><span class="Pa">/var/www/etc/gotweb.conf</span></dt>
- <dd>Location of the <code class="Nm">gotweb.conf</code> configuration
- file.</dd>
-</dl>
-</section>
-<section class="Sh">
-<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
- ALSO</a></h2>
-<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
- <a class="Xr" aria-label="gotweb, section 8">gotweb(8)</a></p>
-</section>
-</main>
-<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
-</body>
-</html>
blob - b9032b1f161320886769434a1cba87df4190352d
blob + 7b41a3a13f4b7028a2002bbb760d2f883a4d3c0d
--- gotwebd.8.html
+++ gotwebd.8.html
listen on * port 80
root "/htdocs/gotwebd"
location "/" {
- fastcgi socket tcp localhost 9000
+ fastcgi socket "/run/gotweb.sock"
}
}
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 3c5707209d225da78460f8e929e4ec73da1d4920
blob + 6c2b7c6bbd389af67c0d6d5f4119fb2fe1498563
--- gotwebd.conf.5.html
+++ gotwebd.conf.5.html
changes to the address configuration of the interface will be
ignored.</p>
</dd>
+ <dt id="listen~2"><a class="permalink" href="#listen~2"><code class="Ic">listen
+ on socket off</code></a></dt>
+ <dd>Disable use of unix socket.</dd>
+ <dt id="listen~3"><a class="permalink" href="#listen~3"><code class="Ic">listen
+ on socket</code></a> <var class="Ar">path</var></dt>
+ <dd>Set the path to the unix socket used by the server.</dd>
<dt id="logo"><a class="permalink" href="#logo"><code class="Ic">logo</code></a>
<var class="Ar">path</var></dt>
<dd>Set the path to an image file containing a logo to be displayed.</dd>
<dt id="show_site_owner"><a class="permalink" href="#show_site_owner"><code class="Ic">show_site_owner</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
<dd>Toggle display of the site owner.</dd>
- <dt id="unix_socket~2"><a class="permalink" href="#unix_socket~2"><code class="Ic">unix_socket</code></a>
- <var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Enable or disable use of unix sockets.</dd>
- <dt id="unix_socket_name~2"><a class="permalink" href="#unix_socket_name~2"><code class="Ic">unix_socket_name</code></a>
- <var class="Ar">path</var></dt>
- <dd>Set the path to the unix socket used by the server.</dd>
</dl>
</section>
<section class="Sh">
+<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
+<dl class="Bl-tag Bl-compact">
+ <dt><span class="Pa">/etc/gotwebd.conf</span></dt>
+ <dd>Default location of the <code class="Nm">gotwebd.conf</code> configuration
+ file.</dd>
+</dl>
+</section>
+<section class="Sh">
<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
<p class="Pp">These are the currently configurable items for
<a class="Xr" aria-label="gotwebd, section 8">gotwebd(8)</a> with their
server "localhost-unix" {
repos_path "/got/public"
- unix_socket_name "/run/gotweb.sock"
+ listen on socket "/run/gotweb.sock"
- got_site_name "my public repos"
- got_site_owner "Got Owner"
- got_site_link "repos"
+ site_name "my public repos"
+ site_owner "Got Owner"
+ site_link "repos"
logo "got.png"
logo_url "https://gameoftrees.org"
# Example server context for FCGI over TCP connections:
#server "localhost-tcp" {
# repos_path "/got/public"
-# unix_socket off
+# listen on socket off
# listen on 127.0.0.1 port 9000
# listen on ::1 port 9000
#}</pre>
</div>
</section>
<section class="Sh">
-<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
-<dl class="Bl-tag Bl-compact">
- <dt><span class="Pa">/etc/gotwebd.conf</span></dt>
- <dd>Default location of the <code class="Nm">gotwebd.conf</code> configuration
- file.</dd>
-</dl>
-</section>
-<section class="Sh">
<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h2>
<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
blob - 1f9e3ea4723e41f4fa4d85adb56c85991f1fb7af
blob + 9654f1f2ae49210097ebeb4b5a071d16322495fb
--- tog.1.html
+++ tog.1.html
u</code></a></dt>
<dd>Move the selection cursor up N half pages (default: 1).</dd>
<dt id="Home,"><a class="permalink" href="#Home,"><code class="Cm">Home,
- g</code></a></dt>
+ =</code></a></dt>
<dd>Move the cursor to the newest commit.</dd>
<dt id="End,"><a class="permalink" href="#End,"><code class="Cm">End,
- G</code></a></dt>
+ *</code></a></dt>
<dd>Move the cursor to the oldest commit. This will traverse all commits
on the current branch which may take a long time depending on the
number of commits in branch history. If needed, this operation can be
cancelled with <code class="Cm">C-g</code> or
<code class="Cm">Backspace</code>.</dd>
+ <dt id="g~2"><a class="permalink" href="#g~2"><code class="Cm">g</code></a></dt>
+ <dd>Move the cursor to commit N (default: 1).</dd>
+ <dt id="G~2"><a class="permalink" href="#G~2"><code class="Cm">G</code></a></dt>
+ <dd>Like <code class="Cm">g</code> but defaults to the oldest commit.</dd>
<dt id="Enter"><a class="permalink" href="#Enter"><code class="Cm">Enter</code></a></dt>
<dd>Open a <code class="Cm">diff</code> view showing file changes made in
the currently selected commit.</dd>
repository. This can then be used to open a new
<code class="Cm">log</code> view for arbitrary branches and tags.</dd>
<dt id="@"><a class="permalink" href="#@"><code class="Cm">@</code></a></dt>
- <dd>Toggle between showing the author and the committer name.</dd>
+ <dd>Toggle between showing the committer name and the author name.</dd>
</dl>
<p class="Pp">The options for <code class="Cm">tog log</code> are as
follows:</p>
<dt id="Ctrl+u,~2"><a class="permalink" href="#Ctrl+u,~2"><code class="Cm">Ctrl+u,
u</code></a></dt>
<dd>Scroll up N half pages (default: 1).</dd>
- <dt id="Home,~2"><a class="permalink" href="#Home,~2"><code class="Cm">Home,
- g</code></a></dt>
+ <dt id="Home"><a class="permalink" href="#Home"><code class="Cm">Home</code></a></dt>
<dd>Scroll to the top of the view.</dd>
- <dt id="End,~2"><a class="permalink" href="#End,~2"><code class="Cm">End,
- G</code></a></dt>
+ <dt id="End"><a class="permalink" href="#End"><code class="Cm">End</code></a></dt>
<dd>Scroll to the bottom of the view.</dd>
+ <dt id="g~3"><a class="permalink" href="#g~3"><code class="Cm">g</code></a></dt>
+ <dd>Scroll to line N (default: 1).</dd>
+ <dt id="G~3"><a class="permalink" href="#G~3"><code class="Cm">G</code></a></dt>
+ <dd>Like <code class="Cm">g</code> but defaults to the last line in the
+ diff.</dd>
<dt id="("><a class="permalink" href="#("><code class="Cm">(</code></a></dt>
<dd>Navigate to the Nth previous file in the diff (default: 1).</dd>
<dt id=")"><a class="permalink" href="#)"><code class="Cm">)</code></a></dt>
<dt id="Ctrl+u,~3"><a class="permalink" href="#Ctrl+u,~3"><code class="Cm">Ctrl+u,
u</code></a></dt>
<dd>Move the selection cursor up N half pages (default: 1).</dd>
- <dt id="Home,~3"><a class="permalink" href="#Home,~3"><code class="Cm">Home,
- g</code></a></dt>
+ <dt id="Home~2"><a class="permalink" href="#Home~2"><code class="Cm">Home</code></a></dt>
<dd>Move the selection cursor to the first line of the file.</dd>
- <dt id="End,~3"><a class="permalink" href="#End,~3"><code class="Cm">End,
- G</code></a></dt>
+ <dt id="End~2"><a class="permalink" href="#End~2"><code class="Cm">End</code></a></dt>
<dd>Move the selection cursor to the last line of the file.</dd>
+ <dt id="g~4"><a class="permalink" href="#g~4"><code class="Cm">g</code></a></dt>
+ <dd>Move the selection cursor to line N (default: 1).</dd>
+ <dt id="G~4"><a class="permalink" href="#G~4"><code class="Cm">G</code></a></dt>
+ <dd>Like <code class="Cm">g</code> but defaults to the last line in the
+ file.</dd>
<dt id="Enter~2"><a class="permalink" href="#Enter~2"><code class="Cm">Enter</code></a></dt>
<dd>Open a <code class="Cm">diff</code> view for the currently selected
line's commit.</dd>
<dt id="Ctrl+u,~4"><a class="permalink" href="#Ctrl+u,~4"><code class="Cm">Ctrl+u,
u</code></a></dt>
<dd>Move the selection cursor up N half pages (default: 1).</dd>
- <dt id="Home,~4"><a class="permalink" href="#Home,~4"><code class="Cm">Home,
- g</code></a></dt>
+ <dt id="Home,~2"><a class="permalink" href="#Home,~2"><code class="Cm">Home,
+ =</code></a></dt>
<dd>Move the selection cursor to the first entry.</dd>
- <dt id="End,~4"><a class="permalink" href="#End,~4"><code class="Cm">End,
- G</code></a></dt>
+ <dt id="End,~2"><a class="permalink" href="#End,~2"><code class="Cm">End,
+ *</code></a></dt>
<dd>Move the selection cursor to the last entry.</dd>
+ <dt id="g~5"><a class="permalink" href="#g~5"><code class="Cm">g</code></a></dt>
+ <dd>Move the selection cursor to entry N (default: 1).</dd>
+ <dt id="G~5"><a class="permalink" href="#G~5"><code class="Cm">G</code></a></dt>
+ <dd>Like <code class="Cm">g</code> but defaults to the last entry.</dd>
<dt id="Enter~3"><a class="permalink" href="#Enter~3"><code class="Cm">Enter</code></a></dt>
<dd>Enter the currently selected directory, or switch to the
<code class="Cm">blame</code> view for the currently selected
<dt id="Ctrl+u,~5"><a class="permalink" href="#Ctrl+u,~5"><code class="Cm">Ctrl+u,
u</code></a></dt>
<dd>Move the selection cursor up N half pages (default: 1).</dd>
- <dt id="Home,~5"><a class="permalink" href="#Home,~5"><code class="Cm">Home,
- g</code></a></dt>
+ <dt id="Home,~3"><a class="permalink" href="#Home,~3"><code class="Cm">Home,
+ =</code></a></dt>
<dd>Move the selection cursor to the first reference.</dd>
- <dt id="End,~5"><a class="permalink" href="#End,~5"><code class="Cm">End,
- G</code></a></dt>
+ <dt id="End,~3"><a class="permalink" href="#End,~3"><code class="Cm">End,
+ *</code></a></dt>
<dd>Move the selection cursor to the last reference.</dd>
+ <dt id="g~6"><a class="permalink" href="#g~6"><code class="Cm">g</code></a></dt>
+ <dd>Move the selection cursor to reference N (default: 1).</dd>
+ <dt id="G~6"><a class="permalink" href="#G~6"><code class="Cm">G</code></a></dt>
+ <dd>Like <code class="Cm">g</code> but defaults to the last
+ reference.</dd>
<dt id="Enter~4"><a class="permalink" href="#Enter~4"><code class="Cm">Enter</code></a></dt>
<dd>Open a <code class="Cm">log</code> view which begins traversing
history at the commit resolved via the currently selected
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">November 8,
- 2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">January 17,
+ 2023</span> <span class="foot-os">OpenBSD 7.2</span></div>
</body>
</html>
