GROK-BUNDLE(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-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+


The Linux Foundation and contributors


and that's the whole page bestie!! version 2.0.0, dated 2020-09-04, brought to you by the GROK-BUNDLE(1) manual. go forth and bundle βœ¨πŸ’–πŸŽ€