diff options
author | Eric Wong <e@80x24.org> | 2020-09-19 09:37:14 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2020-09-19 21:39:47 +0000 |
commit | d78f50649a5545d66a61b5465ca7f5ce4be398ea (patch) | |
tree | 7a0dc7bde92e89bd57dca861624fac8cae7c1be6 /Documentation | |
parent | 881a5493a8c970c10c051cc55d10d2968e71e691 (diff) | |
download | public-inbox-d78f50649a5545d66a61b5465ca7f5ce4be398ea.tar.gz |
It seems easiest to have a singleton Gcf2Client client object per daemon worker for all inboxes to use. This reduces overall FD usage from pipes. The `public-inbox-gcf2' command + manpage are gone and a `$^X' one-liner is used, instead. This saves inodes for internal commands and hopefully makes it easier to avoid mismatched PERL5LIB include paths (as noticed during development :x). We'll also make the existing cat-file process management infrastructure more resilient to BOFHs on process killing sprees (or in case our libgit2-based code fails on us). (Rare) PublicInbox::WWW PSGI users NOT using public-inbox-httpd won't automatically benefit from this change, and extra configuration will be required (to be documented later).
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/public-inbox-gcf2.pod | 63 |
1 files changed, 0 insertions, 63 deletions
diff --git a/Documentation/public-inbox-gcf2.pod b/Documentation/public-inbox-gcf2.pod deleted file mode 100644 index 813fbe7f..00000000 --- a/Documentation/public-inbox-gcf2.pod +++ /dev/null @@ -1,63 +0,0 @@ -=head1 NAME - -public-inbox-gcf2 - internal libgit2-based blob retriever - -=head1 SYNOPSIS - - This is an internal command used by public-inbox. - It may change unrecognizably or cease to exist at some point - -=head1 DESCRIPTION - -public-inbox-gcf2 is an optional internal process used by -public-inbox daemons for read-only access to underlying git -repositories. - -Users are NOT expected to run public-inbox-gcf2 on their own. -It replaces multiple C<git cat-file --batch> processes by treating -any git repos it knows about as alternates. - -None of its behaviors are stable and it is ALL subject to change -at any time. - -Any lines written to its standard input prefixed with a C</> -are interpreted as a git directory. That git directory -will be suffixed with "/objects" and treated as an alternate. -It writes nothing to stdout in this case. - -Otherwise it behaves like C<git cat-file --batch>, but only accepts -unabbreviated hexadecimal object IDs in its standard input. -Its output format is identical to C<git cat-file --batch>. It -only works for L<public-inbox-v2-format(5)> inboxes and v1 -inboxes indexed by L<public-inbox-index(1)>. - -=head1 OPTIONS - -=head1 ENVIRONMENT - -=over 8 - -=item PERL_INLINE_DIRECTORY - -This must be set unless C<~/.cache/public-inbox/inline-c> -exists. C<public-inbox-gcf2> uses L<Inline::C> and libgit2 -and compiles a small shim on its first run. - -=back - -=head1 CONTACT - -Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org> - -The mail archives are hosted at L<https://public-inbox.org/meta/> -and L<http://hjrcffqmbrq6wope.onion/meta/> - -=head1 COPYRIGHT - -Copyright 2020 all contributors L<mailto:meta@public-inbox.org> - -License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt> - -=head1 SEE ALSO - -L<git-cat-file(1)> |