3 public-inbox-fetch - "git fetch" wrapper for v2 inbox mirrors
7 public-inbox-fetch [--exit-code] -C INBOX_DIR
11 public-inbox-fetch updates git storage of public-inbox mirrors.
12 With v2 inboxes, it allows detection of new epochs and avoids
13 unnecessary traffic on old epochs.
15 public-inbox-fetch does not use nor require any configuration
18 It does not run L<public-inbox-index(1)>, making it suitable
19 for maintaining git-only backups.
21 For v2 inboxes, it will maintain C<$INBOX_DIR/manifest.js.gz>
22 file to speed up future invocations.
32 Quiets down progress messages, also passed to L<git-fetch(1)>.
36 Exit with C<127> if no updates are done. This can be used in
37 shell scripts to avoid invoking L<public-inbox-index(1)> when
40 public-inbox-fetch -q --exit-code && public-inbox-index
41 test $? -eq 0 || exit $?
47 Increases verbosity, also passed to L<git-fetch(1)>.
49 =item --torsocks=auto|no|yes
53 Whether to wrap L<git(1)> and L<curl(1)> commands with torsocks.
65 no updates when L</--exit-code> is used above
69 public-inbox-fetch will also exit with curl L<curl(1)/EXIT CODES>
70 as documented in the L<curl(1)> manpage (e.g. C<7> when curl cannot
71 reach a host). Likewise, L<git-fetch(1)> failures are also
72 propagated to the user.
76 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
78 The mail archives are hosted at L<https://public-inbox.org/meta/> and
79 L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
83 Copyright all contributors L<mailto:meta@public-inbox.org>
85 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
89 L<public-inbox-index(1)>, L<curl(1)>