| .\" Man page generated from reStructuredText. |
| . |
| .TH GROK-DUMB-PULL 1 "2018-04-18" "1.1.0" "" |
| .SH NAME |
| GROK-DUMB-PULL \- Update git repositories not managed by grokmirror |
| . |
| .nr rst2man-indent-level 0 |
| . |
| .de1 rstReportMargin |
| \\$1 \\n[an-margin] |
| level \\n[rst2man-indent-level] |
| level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| - |
| \\n[rst2man-indent0] |
| \\n[rst2man-indent1] |
| \\n[rst2man-indent2] |
| .. |
| .de1 INDENT |
| .\" .rstReportMargin pre: |
| . RS \\$1 |
| . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
| . nr rst2man-indent-level +1 |
| .\" .rstReportMargin post: |
| .. |
| .de UNINDENT |
| . RE |
| .\" indent \\n[an-margin] |
| .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| .nr rst2man-indent-level -1 |
| .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| .in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
| .. |
| .SH SYNOPSIS |
| .INDENT 0.0 |
| .INDENT 3.5 |
| grok\-dumb\-pull [options] /path/to/repos |
| .UNINDENT |
| .UNINDENT |
| .SH DESCRIPTION |
| .sp |
| This is a satellite utility that updates repositories not exported via |
| grokmirror manifest. You will need to manually clone these repositories |
| using "git clone \-\-mirror" and then define a cronjob to update them as |
| frequently as you require. Grok\-dumb\-pull will bluntly execute "git |
| remote update" in each of them. |
| .SH OPTIONS |
| .INDENT 0.0 |
| .INDENT 3.5 |
| .INDENT 0.0 |
| .TP |
| .B \-\-version |
| show program\(aqs version number and exit |
| .TP |
| .B \-h\fP,\fB \-\-help |
| show this help message and exit |
| .TP |
| .B \-v\fP,\fB \-\-verbose |
| Be verbose and tell us what you are doing |
| .TP |
| .B \-s\fP,\fB \-\-svn |
| The remotes for these repositories are Subversion |
| .TP |
| .BI \-r \ REMOTES\fP,\fB \ \-\-remote\-names\fB= REMOTES |
| Only fetch remotes matching this name (accepts globbing, |
| can be passed multiple times) |
| .TP |
| .BI \-u \ POSTHOOK\fP,\fB \ \-\-post\-update\-hook\fB= POSTHOOK |
| Run this hook after each repository is updated. Passes |
| full path to the repository as the sole argument. |
| .TP |
| .BI \-l \ LOGFILE\fP,\fB \ \-\-logfile\fB= LOGFILE |
| Put debug logs into this file |
| .UNINDENT |
| .UNINDENT |
| .UNINDENT |
| .SH EXAMPLES |
| .sp |
| The following will update all bare git repositories found in |
| /path/to/repos hourly, and /path/to/special/repo.git daily, fetching |
| only the "github" remote: |
| .INDENT 0.0 |
| .INDENT 3.5 |
| .sp |
| .nf |
| .ft C |
| MAILTO=root |
| # Update all repositories found in /path/to/repos hourly |
| 0 * * * * mirror /usr/bin/grok\-dumb\-pull /path/to/repos |
| # Update /path/to/special/repo.git daily, fetching "github" remote |
| 0 0 * * * mirror /usr/bin/grok\-dumb\-pull \-r github /path/to/special/repo.git |
| .ft P |
| .fi |
| .UNINDENT |
| .UNINDENT |
| .sp |
| Make sure the user "mirror" (or whichever user you specified) is able to |
| write to the repos specified. |
| .SH SEE ALSO |
| .INDENT 0.0 |
| .IP \(bu 2 |
| grok\-pull(1) |
| .IP \(bu 2 |
| grok\-manifest(1) |
| .IP \(bu 2 |
| grok\-fsck(1) |
| .IP \(bu 2 |
| git(1) |
| .UNINDENT |
| .SH SUPPORT |
| .sp |
| Please open an issue on Github: |
| .INDENT 0.0 |
| .INDENT 3.5 |
| \fI\%https://github.com/mricon/grokmirror/issues\fP |
| .UNINDENT |
| .UNINDENT |
| .SH AUTHOR |
| mricon@kernel.org |
| |
| License: GPLv3+ |
| .SH COPYRIGHT |
| The Linux Foundation and contributors |
| .\" Generated by docutils manpage writer. |
| . |