GROK-PULL(1)

📦
version 2.0.12 · 2 versions
  • 2.0.12 · debian trixie, epel 9, fedora 43, fedora 44, ubuntu noble, ubuntu questing, ubuntu resolute (latest)
  • 2.0.12 · ubuntu stonking
, in debian trixie, epel 9, fedora 43, fedora 44, ubuntu noble, ubuntu questing, ubuntu resolute

✨ GROK-PULL ✨

okay bestie, welcome to grok-pull(1) — the manual page for the tool that clones or updates your local git repositories 💖

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

So like, grok-pull is the main character tool for replicating repository updates from the grokmirror primary server over to the mirrors. That's its whole job. It ate and left no crumbs 🫶

Grok-pull has two modes of operation — onetime and continuous (daemonized). Let's break it down fr fr.

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 run 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. Lowkey perfect for your little scheduled tasks 👑

In continuous operation mode (when run with -o), grok-pull will keep running after all updates have been applied, and will periodically re-download the manifest from the server to check for new updates. The way it just... stays alive. Iconic. 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. No pull.refresh, no continuous mode. Periodt.

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). She multi-tasks 💅

✨ OPTIONS ✨

  • --version — show program's version number and exit. cute lil flex, then she's gone 💨
  • -h, --help — show this help message and exit. the classic "help me help you" moment 🙈
  • -v, --verbose — Be verbose and tell us what you are doing. she will literally narrate everything and honestly? we're obsessed 🎀
  • -n, --no-mtime-check — Run without checking manifest mtime. skipping the vibe check on timestamps, bold of you but go off ⭐
  • -o, --continuous — Run continuously (no effect if refresh is not set). she'll keep going forever, but only if pull.refresh is actually set — otherwise it's giving nothing, no cap 💀
  • -c CONFIG, --config=CONFIG — Location of the configuration file. tell her where the config lives, she can't read minds bestie 🧚
  • -p, --purge — Remove any git trees that are no longer in manifest. bye bye to the repos that didn't make the cut 🌈
  • --force-purge — Force purge operation despite significant repo deletions. the "I know this looks scary and I'm doing it anyway" button 🔥
⚠️ heads up bestie: --force-purge is the one where you're overriding a safety check about significant repo deletions. It's literally in the name. Be sure. 🙏

💜 EXAMPLES 💜

Use grokmirror.conf and modify it to reflect your needs. The example configuration file is heavily commented (she left notes for you, bestie 🥺). To invoke, run:

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

Look at that. Verbose AND pointed at a config. The moment. Slay. ✨

🌟 SEE ALSO 🌟

🫶 SUPPORT 🫶

Please email tools@linux.kernel.org. They're nice, they wanna hear from you, fr fr 💌

👑 AUTHOR 👑

mricon@kernel.org

License: GPLv3+

The Linux Foundation and contributors

okay and that's the whole page bestie!! you just read version 2.0.0, dated 2020-08-14 — shoutout to the GROK-PULL(1) manual page, she's been holding it down since way back 💖 go clone something, you got this 🎀🦋

📦 where this page comes from