user/dev discussion of public-inbox itself
 help / color / mirror / 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 https://80x24.org/public-inbox.git

user/dev discussion of public-inbox itself

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://public-inbox.org/meta
	git clone --mirror http://czquwvybam4bgbro.onion/meta
	git clone --mirror http://hjrcffqmbrq6wope.onion/meta
	git clone --mirror http://ou63pmih66umazou.onion/meta

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 meta meta/ https://public-inbox.org/meta \
		meta@public-inbox.org
	public-inbox-index meta

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.mail.public-inbox.meta
	nntp://ou63pmih66umazou.onion/inbox.comp.mail.public-inbox.meta
	nntp://czquwvybam4bgbro.onion/inbox.comp.mail.public-inbox.meta
	nntp://hjrcffqmbrq6wope.onion/inbox.comp.mail.public-inbox.meta
	nntp://news.gmane.io/gmane.mail.public-inbox.general
 note: .onion URLs require Tor: https://www.torproject.org/

code repositories for the project(s) associated with this inbox:

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

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git