FREIGHT-CACHE(1)

📦 version 0.3.13, in epel 9, fedora 43, fedora 44

💖 FREIGHT-CACHE(1) 💖

okay bestie, welcome to freight-cache, part of the Freight family of manual pages. she's the one who actually builds your repos. no cap, she's iconic.

✨ NAME ✨

freight-cache — (re)builds package repositories 🔥

🌸 SYNOPSIS 🌸

freight cache [-k] [-g email] [-p passphrase file] [-c conf] [-v] [-h]
[manager/distro][...]

💅 DESCRIPTION 💅

so basically, freight-cache takes every manager/distro you hand it and turns it into a whole package repository (ngl, only Debian archives are supported rn). the manager tells it what kind of repo you want — and again, apt is literally the only supported value, she's exclusive like that 💅. the distro is just an arbitrary string that should match a release of the target operating system, like "lenny" or "lucid" 🍓. and if you give her nothing at all? she converts all the manager/distro pairs she can find in $VARLIB. main character energy fr fr.

packages get read from the Freight library ($VARLIB in the configuration, peep freight(5) for that) and then organized into a working repository in the Freight cache ($VARCACHE in the configuration). the way she just… reorganizes everything 😭✨

serving those repositories? that's left as an exercise for the reader, bestie 🙈. the Freight cache is the only directory that needs to be exposed, so just make a virtual host with $VARCACHE as its document root and everything will be fine. easy. slay. 💖

⭐ from version 0.0.8 onwards, distros in an APT repository no longer share the contents of pool/. so after you upgrade to this version and run freight-cache for all your distros, it is safe and recommended to run rm -rf $VARCACHE/pool/main to reset link counts to the proper value. do it, it's giving responsible sysadmin 🫶

🎀 OPTIONS 🎀

  • -k, --keep — keep unreferenced versions of packages. this is different from keeping multiple versions of a package in the repository, which is supported without any special options. two whole different vibes, don't conflate them 💜
  • -g email, --gpg=email — use an alternate GPG key. she can be given multiple times, so stack them like charms on a bracelet ✨
  • -p passphrase file, --passphrase-file=passphrase file — use an alternate file containing the GPG key passphrase. and this file should obviously be protected and only readable by the user running Freight. lock it down bestie 🔒 no one else needs to see that.
  • -a digest algorithm, --digest-algo=digest algorithm — the message digest algorithm that GPG should use to sign the repository, e.g. SHA512. cryptographic glamour 💅
  • -c conf, --conf=conf — use an alternate configuration file.
  • -v, --verbose — verbose mode. she's talking now and you're gonna hear every word 🗣️
  • -h, --help — show a help message.

🦋 FILES 🦋

  • /etc/freight.conf, ~/.freight.conf, etc/freight.conf, .freight.conf — the default configuration files. check freight(5) for the deets.
  • $VARCACHE/pubkey.gpg — the exported public key used for signing each release. 👑

🌈 ENVIRONMENT VARIABLES 🌈

  • FREIGHT_CONF — the pathname of an alternate configuration file. see freight(5).

🎶 THEME SONG 🎶

The New Pornographers — "All the Old Showstoppers" 🎧 genuinely obsessed, put it on

👑 AUTHOR 👑

Richard Crowley r@rcrowley.org

💖 SEE ALSO 💖

part of freight(1). she's one of the girls 🫶

freight-add(1) adds packages to the intermediate "Freight library" that is used by freight-cache to build the actual repositories. so like, freight-add stocks the shelves and freight-cache does the whole reveal 💫

and that's the whole page bestie!! this one's from March 2016, part of the Freight manual — go forth and build those repositories, you're literally gonna eat 💅✨🌸

📦 where this page comes from