user/dev discussion of public-inbox itself
 help / color / mirror / code / Atom feed
813fbe7ff46286e84aae7f56986520d1eee7fcdb blob 1754 bytes (raw)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
 
=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)>
debug log:

solving 813fbe7f ...
found 813fbe7f in public-inbox.git.git

Code repositories for project(s) associated with this inbox:

	https://80x24.org/public-inbox.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).