.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "PUBLIC-INBOX-FETCH 1" .TH PUBLIC-INBOX-FETCH 1 "1993-10-02" "public-inbox.git" "public-inbox user manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" public\-inbox\-fetch \- "git fetch" wrapper for v2 inbox mirrors .SH "SYNOPSIS" .IX Header "SYNOPSIS" public-inbox-fetch [\-\-exit\-code] \-C \s-1INBOX_DIR\s0 .SH "DESCRIPTION" .IX Header "DESCRIPTION" public-inbox-fetch updates git storage of public-inbox mirrors. With v2 inboxes, it allows detection of new epochs and avoids unnecessary traffic on old epochs. .PP public-inbox-fetch does not use nor require any configuration files of its own. .PP It does not run \fBpublic\-inbox\-index\fR\|(1), making it suitable for maintaining git-only backups. .PP For v2 inboxes, it will maintain \f(CW\*(C`$INBOX_DIR/manifest.js.gz\*(C'\fR file to speed up future invocations. It always safe to remove manifest.js.gz, it is merely an optimization and will be restored on the next invocation. .PP To prevent fetches on any v2 epoch, use \fBchmod\fR\|(1) to remove write permissions to the top-level of the epoch. For example, to disable fetches on epoch 4: .PP .Vb 1 \& chmod a\-w $INBOX_DIR/git/4.git .Ve .PP If you wish to re-enable fetches to the epoch: .PP .Vb 1 \& chmod u+w $INBOX_DIR/git/4.git .Ve .SH "OPTIONS" .IX Header "OPTIONS" .IP "\-q" 4 .IX Item "-q" .PD 0 .IP "\-\-quiet" 4 .IX Item "--quiet" .PD Quiets down progress messages, also passed to \fBgit\-fetch\fR\|(1). .IP "\-T \s-1REMOTE\s0" 4 .IX Item "-T REMOTE" .PD 0 .IP "\-\-try\-remote \s-1REMOTE\s0" 4 .IX Item "--try-remote REMOTE" .PD Try a given remote name instead of \f(CW\*(C`origin\*(C'\fR or \f(CW\*(C`_grokmirror\*(C'\fR. May be specified more than once. .Sp Default: \f(CW\*(C`origin\*(C'\fR, \f(CW\*(C`_grokmirror\*(C'\fR .IP "\-\-exit\-code" 4 .IX Item "--exit-code" Exit with \f(CW127\fR if no updates are done. This can be used in shell scripts to avoid invoking \fBpublic\-inbox\-index\fR\|(1) when there are no updates: .Sp .Vb 2 \& public\-inbox\-fetch \-q \-\-exit\-code && public\-inbox\-index \& test $? \-eq 0 || exit $? .Ve .IP "\-v" 4 .IX Item "-v" .PD 0 .IP "\-\-verbose" 4 .IX Item "--verbose" .PD Increases verbosity, also passed to \fBgit\-fetch\fR\|(1). .IP "\-\-torsocks=auto|no|yes" 4 .IX Item "--torsocks=auto|no|yes" .PD 0 .IP "\-\-no\-torsocks" 4 .IX Item "--no-torsocks" .PD Whether to wrap \fBgit\fR\|(1) and \fBcurl\fR\|(1) commands with \fBtorsocks\fR\|(1). .Sp Default: \f(CW\*(C`auto\*(C'\fR .SH "EXIT CODES" .IX Header "EXIT CODES" .IP "127" 4 .IX Item "127" no updates when \*(L"\-\-exit\-code\*(R" is used above .PP public-inbox-fetch will also exit with curl \*(L"\s-1EXIT CODES\*(R"\s0 in \fBcurl\fR\|(1) as documented in the \fBcurl\fR\|(1) manpage (e.g. \f(CW7\fR when curl cannot reach a host). Likewise, \fBgit\-fetch\fR\|(1) failures are also propagated to the user. .SH "CONTACT" .IX Header "CONTACT" Feedback welcome via plain-text mail to .PP The mail archives are hosted at and .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright all contributors .PP License: \s-1AGPL\-3.0+\s0 .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBpublic\-inbox\-index\fR\|(1), \fBcurl\fR\|(1)