Name

targit-clone — a helper program for accessing TarGit repositories on sites like Umbrellix.net

This manual page describes the invokation of targit-clone

Invokation

targit-clone url [target-dir]

Description

targit-clone is a helper program for accessing "TarGit" repositories, which are bare Git repositories rolled into a tarball, compressed with zstandard (support for other compression algorithms, by command-line option, forthcoming), and served through a httpd, preferably over https.

Options

None yet. It is planned that we will have an option to verify hashes (like sha256, etc).

Process

targit-clone
checks that target-dir (or a default) does not exist. If it does, it aborts. Then, targit-clone downloads url, then extracts it to a variant of target-dir (in default of which, it generates one from the current directory and the filename of url) which has been permuted to a temporary name. Upon apparently-successful extraction, it then creates another variant of target-dir, and executes `git clone` from the first variant to the second. Upon apparent success of that operation, targit-clone moves the second temporary target directory to the target-dir and exits.

See also

curl(1)

is preferred over the following due to its licence.

wget(1)

is preferred over the following due to its behavior when using fully qualified domains.

fetch(1)

is accepted because it comes by default with FreeBSD and HardenedBSD

zstd(1)

used to decompress TarGit repositories

tar(1)

used to unwrap TarGit repositories

git-clone(1)

used to check out TarGit repositories