1GROK-PULL(1)                                                      GROK-PULL(1)
2
3
4

NAME

6       GROK-PULL - Clone or update local git repositories
7

SYNOPSIS

9          grok-pull -c /path/to/repos.conf
10

DESCRIPTION

12       This utility runs from a cronjob and downloads the latest manifest from
13       the grokmirror master. If there are new repositories or changes in  the
14       existing  repositories,  grok-pull  will perform the necessary git com‐
15       mands to clone or fetch the required data from the master.
16
17       At the end of its run, grok-pull will generate its own  manifest  file,
18       which can then be used for further mirroring.
19

OPTIONS

21          --version
22                 show program's version number and exit
23
24          -h, --help
25                 show this help message and exit
26
27          -v, --verbose
28                 Be verbose and tell us what you are doing
29
30          -n, --no-mtime-check
31                 Run without checking manifest mtime.
32
33          -f, --force
34                 Force full git update regardless of last-modified times. Also
35                 useful when repos.conf has changed.
36
37          -p, --purge
38                 Remove any git trees that are no longer in manifest.
39
40          -y, --pretty
41                 Pretty-print the  generated  manifest  (sort  repos  and  add
42                 indentation).  This  is  much  slower, so should be used with
43                 caution on large collections.
44
45          -r, --no-reuse-existing-repos
46                 If any existing repositories are found on disk,  do  NOT  set
47                 new remote origin and reuse, just skip them entirely
48
49          -m, --verify-mirror
50                 Do  not  perform any updates, just verify that mirror matches
51                 upstream manifest.
52
53          -s SUBPATH, --verify-subpath=SUBPATH
54                 Only verify a subpath (accepts shell globbing)
55
56          -c CONFIG, --config=CONFIG
57                 Location of repos.conf
58

EXAMPLES

60       Locate repos.conf and modify it to reflect your needs. The default con‐
61       figuration file is heavily commented.
62
63       Add  a  cronjob  to run as frequently as you like. For example, add the
64       following to /etc/cron.d/grokmirror.cron:
65
66          # Run grok-pull every minute as user "mirror"
67          * * * * * mirror /usr/bin/grok-pull -p -c /etc/grokmirror/repos.conf
68
69       Make sure the user "mirror" (or whichever user you specified)  is  able
70       to  write  to  the  toplevel,  log  and  lock  locations  specified  in
71       repos.conf.
72

SEE ALSO

74       · grok-manifest(1)
75
76       · grok-fsck(1)
77
78       · git(1)
79

SUPPORT

81       Please open an issue on Github:
82          https://github.com/mricon/grokmirror/issues
83

AUTHOR

85       mricon@kernel.org
86
87       License: GPLv3+
88

90       The Linux Foundation and contributors
91
92
93
94
951.1.0                             2018-04-18                      GROK-PULL(1)
Impressum