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/grokmirror.conf
10

DESCRIPTION

12       Grok-pull  is the main tool for replicating repository updates from the
13       grokmirror primary server to the mirrors.
14
15       Grok-pull has two modes of operation -- onetime and  continous  (daemo‐
16       nized).  In  one-time  operation mode, it downloads the latest manifest
17       and applies any outstanding updates. If there are new  repositories  or
18       changes in the existing repositories, grok-pull will perform the neces‐
19       sary git commands to clone or fetch the required data from the  master.
20       Once  all updates are applied, it will write its own manifest and exit.
21       In this mode, grok-pull can be run manually or from cron.
22
23       In continuous operation mode (when run with -o),  grok-pull  will  con‐
24       tinue running after all updates have been applied and will periodically
25       re-download the manifest from the server to check for new updates.  For
26       this  to  work,  you  must  set  pull.refresh in grokmirror.conf to the
27       amount of seconds you would like it to wait between refreshes.
28
29       If pull.socket is specified, grok-pull will also listen on a socket for
30       any  push  updates (relative repository path as present in the manifest
31       file, terminated with newlines). This can be used for pubsub  subscrip‐
32       tions (see contrib).
33

OPTIONS

35          --version
36                 show program's version number and exit
37
38          -h, --help
39                 show this help message and exit
40
41          -v, --verbose
42                 Be verbose and tell us what you are doing
43
44          -n, --no-mtime-check
45                 Run without checking manifest mtime.
46
47          -o, --continuous
48                 Run continuously (no effect if refresh is not set)
49
50          -c CONFIG, --config=CONFIG
51                 Location of the configuration file
52
53          -p, --purge
54                 Remove any git trees that are no longer in manifest.
55
56          --force-purge
57                 Force purge operation despite significant repo deletions
58

EXAMPLES

60       Use  grokmirror.conf  and  modify it to reflect your needs. The example
61       configuration file is heavily commented. To invoke, run:
62
63          grok-pull -v -c /path/to/grokmirror.conf
64

SEE ALSO

66grok-manifest(1)
67
68grok-fsck(1)
69
70git(1)
71

SUPPORT

73       Please email tools@linux.kernel.org.
74

AUTHOR

76       mricon@kernel.org
77
78       License: GPLv3+
79
81       The Linux Foundation and contributors
82
83
84
85
862.0.0                             2020-08-14                      GROK-PULL(1)
Impressum