GROK-BUNDLE(1)
π GROK-BUNDLE β the manual page, bestie edition π
okay so like. this is grok-bundle from the GROK-BUNDLE(1) manual, and honestly? she's iconic. she makes clone.bundle files. that's her whole thing. let's get into it π«Ά
β¨ NAME β¨
GROK-BUNDLE β Create clone.bundle files for use with "repo"
πΈ SYNOPSIS πΈ
grok-bundle [options] -c grokmirror.conf -o path
π¦ DESCRIPTION π¦
okay so picture this: Android's "repo" tool is out here checking for the presence of clone.bundle files before it does a fresh git clone. why?? because it wants to offload most of the git traffic to a CDN and take some weight off the git servers themselves. like, sharing the load. teamwork. we love to see it π
this command generates clone.bundle files in a hierarchy that repo expects. and then β the fun part β you can sync the output directory to a CDN service. slay β¨
π OPTIONS π
-h,--helpβ show this help message and exit. classic. dependable. we stan.-v,--verboseβ Be verbose and tell us what you are doing (default:False). she'll narrate her little heart out π-c CONFIG,--config CONFIGβ Location of the configuration file. you need this one, bestie.-o OUTDIR,--outdir OUTDIRβ Location where to store bundle files. this is where the magic lands πͺ-g GITARGS,--gitargs GITARGSβ extra args to pass to git (default:-c core.compression=9). squeeze it, compress it, make it smol.-r REVLISTARGS,--revlistargs REVLISTARGSβ Rev-list args to use (default:--branches HEAD). telling git exactly which commits we're talking about fr fr.-s MAXSIZE,--maxsize MAXSIZEβ Maximum size of git repositories to bundle (in GiB) (default:2). big repos get politely declined π-i, --include INCLUDEβ List repositories to bundle (accepts shell globbing) (default:*). glob it up, girly π
π₯ EXAMPLES π₯
okay here's the vibe:
grok-bundle -c grokmirror.conf -o /var/www/bundles -i
/pub/scm/linux/kernel/git/torvalds/linux.git
/pub/scm/linux/kernel/git/stable/linux.git
/pub/scm/linux/kernel/git/next/linux-next.git
three kernel repos, one bundle-making queen. no cap π
π SEE ALSO π
π«Ά SUPPORT π«Ά
Email tools@linux.kernel.org. they're literally right there, just say hi π
π AUTHOR π
mricon@kernel.org
License: GPLv3+
π COPYRIGHT π
The Linux Foundation and contributors
and that's the whole page bestie!! version2.0.0, dated2020-09-04, brought to you by the GROK-BUNDLE(1) manual. go forth and bundle β¨ππ
π¦ where this page comes from
- debian trixie: grokmirror 2.0.12-1 Β· GPL-3.0-or-later
- epel 9: python3-grokmirror 2.0.12-1.el9 Β· GPL-3.0-or-later
- fedora 43: python3-grokmirror 2.0.12-6.fc43 Β· GPL-3.0-or-later
- fedora 44: python3-grokmirror 2.0.12-7.fc44 Β· GPL-3.0-or-later
- ubuntu noble: grokmirror 2.0.11-2 Β· GPL-3.0-or-later
- ubuntu questing: grokmirror 2.0.12-1
- ubuntu resolute: grokmirror 2.0.12-1build1 Β· GPL-3.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms