noble (1) grok-pull.1.gz

Provided by: grokmirror_2.0.11-2_all bug

NAME
       GROK-PULL - Clone or update local git repositories


SYNOPSIS
          grok-pull -c /path/to/grokmirror.conf


DESCRIPTION
       Grok-pull  is  the main tool for replicating repository updates from the grokmirror primary server to the
       mirrors.

       Grok-pull has two modes of operation -- onetime and continous (daemonized). In one-time  operation  mode,
       it  downloads  the  latest manifest and applies any outstanding updates. If there are new repositories or
       changes in the existing repositories, grok-pull will perform the necessary git commands to clone or fetch
       the required data from the master. Once all updates are applied, it will write its own manifest and exit.
       In this mode, grok-pull can be run manually or from cron.

       In continuous operation mode (when run with -o), grok-pull will continue running after all  updates  have
       been applied and will periodically re-download the manifest from the server to check for new updates. For
       this to work, you must set pull.refresh in grokmirror.conf to the amount of seconds you would like it  to
       wait between refreshes.

       If  pull.socket  is  specified,  grok-pull  will  also  listen on a socket for any push updates (relative
       repository path as present in the manifest file, terminated with newlines). This can be used  for  pubsub
       subscriptions (see contrib).


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

          -n, --no-mtime-check
                 Run without checking manifest mtime.

          -o, --continuous
                 Run continuously (no effect if refresh is not set)

          -c CONFIG, --config=CONFIG
                 Location of the configuration file

          -p, --purge
                 Remove any git trees that are no longer in manifest.

          --force-purge
                 Force purge operation despite significant repo deletions


EXAMPLES
       Use  grokmirror.conf  and  modify  it  to  reflect  your needs. The example configuration file is heavily
       commented. To invoke, run:

          grok-pull -v -c /path/to/grokmirror.conf


SEE ALSO
       • grok-manifest(1)

       • grok-fsck(1)

       • git(1)


SUPPORT
       Please email tools@linux.kernel.org.


AUTHOR
       mricon@kernel.org

       License: GPLv3+


       The Linux Foundation and contributors