File: grok-dumb-pull.1.rst

package info (click to toggle)
grokmirror 2.0.12-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 516 kB
  • sloc: python: 3,711; sh: 70; makefile: 8
file content (66 lines) | stat: -rw-r--r-- 2,167 bytes parent folder | download
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
64
65
66
GROK-DUMB-PULL
==============
-------------------------------------------------
Update git repositories not managed by grokmirror
-------------------------------------------------

:Author:    mricon@kernel.org
:Date:      2020-08-14
:Copyright: The Linux Foundation and contributors
:License:   GPLv3+
:Version:   2.0.0
:Manual section: 1

SYNOPSIS
--------
    grok-dumb-pull [options] /path/to/repos

DESCRIPTION
-----------
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.


OPTIONS
-------
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -v, --verbose         Be verbose and tell us what you are doing
  -s, --svn             The remotes for these repositories are Subversion
  -r REMOTES, --remote-names=REMOTES
                        Only fetch remotes matching this name (accepts globbing,
                        can be passed multiple times)
  -u POSTHOOK, --post-update-hook=POSTHOOK
                        Run this hook after each repository is updated. Passes
                        full path to the repository as the sole argument.
  -l LOGFILE, --logfile=LOGFILE
                        Put debug logs into this file

EXAMPLES
--------
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::

    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

Make sure the user "mirror" (or whichever user you specified) is able to
write to the repos specified.

SEE ALSO
--------
* grok-pull(1)
* grok-manifest(1)
* grok-fsck(1)
* git(1)

SUPPORT
-------
Email tools@linux.kernel.org.