NOTE: This repository is read-only and is used only to mirror the got-portable repository for CI purposes.
This is the portable version of got (Game of Trees), using autotools to provide the library checks required for GoT's dependencies.
The following operating systems are supported:
libbsd(BSD's arc4random routines)
libuuid(for UUID generation)
libz(for Z compression)
pkg-config(for searching libraries)
bison(for configuration file grammar)
To run the test suite:
$ make tests
NOTE: For Linux, you must have the jot(1) command which is typically in the
athena-jot package, or similar.
NOTE: THIS ONLY WORKS AFTER
make install DUE TO HOW PATHS TO LIBEXEC
HELPERS ARE HARD-CODED INTO THE BINARIES.
$ ./autogen.sh $ ./configure && make $ sudo make install
INSTALLING AND PACKAGING GITWRAPPER
The gotd server has an optional companion tool called gitwrapper.
A gotd server can be used without gitwrapper in the following cases:
The Git client's user account has gotsh configured as its login shell.
The Git client's user account sees gotsh installed under the names git-receive-pack and git-upload-pack, and these appear in $PATH before the corresponding Git binaries if Git is also installed. Setting up the user's $PATH in this way can require the use of SetEnv in sshd_config.
The above cases can be too restrictive. For example, users who have regular shell access to the system may expect to be able to serve Git repositories from their home directories while also accessing repositories served by gotd.
Once gitwrapper has been installed correctly it provides an out-of-the box experience where both gotd and Git "just work". However, this will require coordination with the system's Git installation and/or distribution package because the names of two specific Git programs will be overlapping: git-upload-pack and git-receive-pack
If the gitwrapper tool will be used then it must replace git-receive-pack and git-upload-pack in /usr/bin. This is usually achieved by replacing the regular Git binaries in /usr/bin with symlinks to gitwrapper:
-rwxr-xr-x 1 root root 1019928 Aug 24 00:16 /usr/bin/gitwrapper lrwxrwxrwx 1 root root 10 Aug 20 12:40 /usr/bin/git-receive-pack -> gitwrapper lrwxrwxrwx 1 root root 10 Aug 20 12:40 /usr/bin/git-upload-pack -> gitwrapper
The Git binaries remain available in Git's libexec directory, which is set when Git gets compiled. On Debian it defaults to /usr/lib/git-core. This same path must be given to Got's configure script at build time to allow gitwrapper to find Git's binaries:
Once gitwrapper is found in /usr/bin under the names git-receive-pack and git-upload-pack, any Git repositories listed in /etc/gotd.conf will be automatically served by gotd, and any Git repositories not listed in /etc/gotd.conf will be automatically served by regular Git's git-upload-pack and git-receive-pack. The client's login shell or $PATH no longer matter, and a peaceful co-existence of gotd and Git is possible.
We recommend that distribution packagers take appropriate steps to package gitwrapper as a required dependency of gotd. It is also possible to install gitwrapper without installing gotd. As long as /etc/gotd.conf does not exist or no repositories are listed in /etc/gotd.conf there will be no visible change in run-time behaviour for Git users since gitwrapper will simply run the standard Git tools. In the OpenBSD ports tree both the regular git package and the gotd package are depending on gitwrapper, and the git package no longer installs the git-receive-pack and git-upload-pack programs in /usr/local/bin.
BRANCHES + SUBMITTING PATCHES
got-portable has two key branches:
mainwhich tracks got upstream untainted.
portablewhich provides the portable version of GoT based from code on
Patches for portable code fixes should be based from the
portable branch and
sent to the mailing list for review  or sent to me directly (see CONTACT).
Portable-specific patches should have a shortlog in the form of:
portable: AREA: description
AREA relates to the change in question (for example,
libexec, etc). In some cases, this can be omitted if it's a generic change.
This helps to delineate
-portable changes from upstream
The read-only Github repository also runs CI checks using Cirrus-CI on Linux and FreeBSD.
SYNCING UPSTREAM CHANGES WITH PORTABLE
-portable GoT repository uses the following workflow:
Github (gh) GoT (upstream) ^ ^ | | | | | | | | +--------> GoT-portable <------+
got-portable is a clone of the
-portable repository, locally on
disk. There are two remotes set up within that repository, via
upstream-- which points to the official GoT repository;
gh-- which points to the mirrored
-portablerepository so that CI can be run for cross-platform/test purposes 
origin-- our cloned copy from
-portable repository are two key branches (there may be other
topic branches which represent on-going work):
main-- this is the branch that tracks (without modification) those changes from
upstream. This branch is continually reset to
upstream/mainwhenever changes occur.
portable-- this is the default branch of the
-portablerepository which contains portable-specific changes to make
GoTcompile across different OSes.
-portable from upstream changes, the following actions happen:
- Changes from
upstreamare fetched. If there are no new changes, there's nothing else to do.
- Changes from
ghare fetch so that the result can be pushed out to
- The difference between the local copy of
origin/mainis used to represent the set of commits which have NOT yet been merged to
- A topic-branch called
syncupis created from the HEAD of the
portablebranch to hold the to-be-cherry-picked commits from step 3.
- These commits are then cherry-picked to the
- If there's any conflicts, they must be resolved.
- Once done, a sanity build is done in-situ to check there's nothing amiss.
- If that succeeds, the
syncupbranch is merged to
portableand pushed to
ghfor verification against CI.
- If that fails, fixes continue and pushed up to
- Once happy, both the
portablebranches can be merged to
These steps are encapsulated in a script within
RELEASING A NEW VERSION
-portable try and align as close to upstream GoT as much as
possible, even on the same day where that can happen. That being said,
sometimes a release of
-portable might happen outside of that cadence, where
-portable-specific issue needs addressing, for example.
Before creating a new release, check the version of GoT as found in
util/got-portable-ver.sh -- as
Here, the to be released version of
got-portable will be
Typically, this version is incremented directly after a release, such that
there's no need to change this value. The only exception would be if there
were an out-of-band release to
-portable. In such cases, that would take
Where the suffix of
2, etc., can be used to denote any sub-releases
GOT_RELEASE needs be changed to
yes so that the
GOT_PORTABLE_VER is asserted correctly.
Once the version is verified, the following should be run from the
branch -- and the repository should not have any outstanding modifications to
make clean ; ./autogen && ./configure && make distcheck
If this succeeds, the tarball is in the CWD, as:
This can then be copied to the
got-www repository and uploaded, along with
changing a couple of HTML pages therein to represent the new released version.
Additionally, the CHANGELOG file can be copied to the
got-www and committed.
Once all of that has been done, the repository should be tagged to indicate the release, hence:
git tag -a 0.75
This can then be pushed out to
After that point, the version of
util/got-portable-ver.sh should be changed to the next version, and
GOT_RELEASE should be setg back to
This port is incomplete in that only got(1) and tog(1) have been ported. gotweb has yet to be ported.
configure.ac should start defining AC_ENABLE arguments to allow for finer-grained control of where to search for includes/libraries, etc.
Thomas Adam firstname.lastname@example.org
thomas_adam (#gameoftrees on irc.libera.chat)