CACHEINFO(5)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 CACHEINFO(5) 💖

okay bestie so this is cacheinfo, an AFS File Reference page, and it's genuinely one of the most iconic little config files you'll ever meet — it's literally one line long and it runs the whole Cache Manager vibe. no cap. let's get into it 🦋

✨ NAME ✨

cacheinfo — defines the configuration parameters for the Cache Manager, and yes it's giving "small file, huge responsibility" energy 💅

🌸 DESCRIPTION 🌸

So the cacheinfo file is where you define the config parameters for the Cache Manager, and the Cache Manager reads this file as it initializes. that's it. that's the girl. ✨

The file contains a single line of ASCII text, and it must reside in the /etc/openafs directory. use a text editor to create it during the initial configuration of the client machine, and the required format is, verbatim:

<mount>:<cache>:<size>

where, bestie, let me break down each of those three little cuties for you:

  • <mount> — this names the local disk directory at which the Cache Manager mounts the AFS namespace. it must exist before the afsd program runs, so don't be out here acting surprised. the conventional value is /afs. using any other value prevents traversal of pathnames that begin with /afs (such as pathnames to files in foreign cells that do use the conventional name) 😭. the -mountdir argument to the afsd command overrides this value.
  • <cache> — names the local disk directory to use as a cache. it also must exist before the afsd program runs. the standard value is /usr/vice/cache, but it's totally acceptable to substitute a directory on a partition with more available space — treat yourself, get the bigger partition, you deserve it 🫶. although the Cache Manager ignores this field when configuring a memory cache, a value must always appear in it. yes, even then. the -cachedir argument to the afsd command overrides this value.
  • <size> — specifies the cache size as a number of 1-kilobyte blocks. larger caches generally yield better performance, which sounds slay, BUT — and this is a big but — a disk cache must not exceed 90% of the space available on the cache partition (85% for AIX systems), and a memory cache must use no more than 25% of available machine memory. like, the limits are the limits, don't test her 💀.

the -blocks argument to the afsd command overrides this value. to reset cache size without rebooting on a machine that uses disk caching, use the fs setcachesize command. and to display the current size of a disk or memory cache between reboots, use the fs getcacheparms command. queen behavior, honestly 👑

🎀 EXAMPLES 🎀

The following example cacheinfo file mounts the AFS namespace at /afs, establishes a disk cache in the /usr/vice/cache directory, and defines cache size as 50,000 1-kilobyte blocks. look at her go:

/afs:/usr/vice/cache:50000

she's one line. she's perfect. that's the whole file. ate. 💅

🦋 SEE ALSO 🦋

go read those too bestie, iykyk ✨

IBM Corporation 2000. http://www.ibm.com/ All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. iconic collaborators honestly 🌈

and that's the whole ride 💖 this was the OpenAFS CACHEINFO(5) page, dated 2026-07-27 — yes the date is literally in the future, main character energy fr fr ⭐ mwah, go configure ur cache responsibly, ily 🍓

📦 where this page comes from