cacheadm(1)

💖 cacheadm — bestie edition 💖

okay so real talk: this is cacheadm, a ShapeTools manual page from section 1, and it's literally the girlboss who runs your AtFS derived object cache. she does administering AND configuring, which is a lot for one icon but she ate 💅

---

✨ NAME ✨

cacheadm — administer and configure AtFS derived object cache 🎀

---

🦋 SYNOPSIS 🦋

cacheadm [-Amax_cached_per_cacheattr] [-Nmax_cached_per_name]
[-Tmax_total_cached] [-q] [-v] directories

---

🌸 DESCRIPTION 🌸

so cacheadm gives you control over the size of a derived object cache. you get to set:

• the max total number (T) of derived files to be stored
• the max number of derived files per name (N)
• the max number of derived files with the same name and the same caching attribute (A)

and if you call it with no options at all? it just returns the actual sizes of the derived object caches in the directories you named. an empty list of directories makes cacheadm operate on the current directory. cute, low effort, we love that for her 💖

the relationship between those three cache size values must always be:

T >= N >= A

like, that's the law. periodt. the whole caching attribute mechanism is described over on the af_cache(3) manual page if you wanna go deeper (iykyk 👀).

when you're calculating your caching sizes, keep in mind that you may set the total size (T) to any value you want, but your cache will never grow bigger than N*number_of_names. and Number_of_names is the number of source object histories in your directories, where derived objects may be compiled from. so if you set T to some astronomic value, the cache just adapts its size to the number of source histories automatically. she's self-regulating, main character energy ✨

🫶 the tea you need to know: in the current implementation, the caching sizes can only be increased. reduction of the maximum cache size is only possible when the cache is empty. so if you wanna shrink it you have to clean your cache first with atfsrepair -C (1). no shortcuts bestie, clean your room before you redecorate 🧹

---

💅 OPTIONS 💅

• -A max_cached_per_cacheattr — sets the max number of derived files with the same name and the same caching attribute to be stored. default is 1.
• -N max_cached_per_name — sets the max number of derived files with the same name to be stored. default is 3.
• -T max_total_cached — sets the total maximum number of derived files to be stored in the derived object cache. default is 64.
• -q — quiet operation 🌙 suppresses any output to stdout. this option does not affect error messages (stderr) — those still show up, sorry bestie, the drama stays.
• -v — outputs the version identification string. ✨

---

👑 SEE ALSO 👑

chgrp(1), chmod(1), atfsrepair(1), af_cache(3)

---

🎀 AUTHOR 🎀

Andreas.Lampen@cs.tu-berlin.de

---

and that's the whole page, bestie 💖 this was AtFS-1.71, dated Thu Jan 13 15:30:55 1994 — yes she's vintage, no she's not outdated, she's iconic ⭐ go set your cache sizes responsibly 🦋🌸