mkatfs(1)

🌸 mkatfs(1) — ShapeTools edition, bestie 💅

okay so real quick, the manual name is mkatfs(1) and it's from ShapeTools, and we're about to have a whole moment about it. buckle up 🎀

---

✨ NAME ✨

mkatfs — create and configure AtFS object repository and derived object cache

like. that's the whole vibe. it makes repos, it links repos, it configures repos. iconic behavior only 👑

---

🦋 SYNOPSIS 🦋

mkatfs [-cAmax_cached_per_cacheattr] [-cNmax_cached_per_name]
[-cTmax_total_cached] [-cQ] [-ggroup] [-h] [-lpath] [-mmode] [-v]
pathnames

---

💖 DESCRIPTION 💖

so mkatfs is literally the girl who does four jobs at once and does them all flawlessly. she can:

• create an AtFS object repository
• link an existing repository
• configure a repository
• set the size attributes of a derived object cache

and she does all of that for every directory that shows up in the pathnames list. no skipping, no favorites. if the list is empty? she just does her thing in the current directory. lowkey considerate of her ngl 🫶

creating an AtFS object repository means she makes a directory named AtFS with several files and subdirectories inside it. it's giving new apartment, fully furnished ✨

---

🔗 the -l link arc

the -l option makes mkatfs link an existing AtFS repository to the current directory (or to the directories in the pathnames list). -l expects a pathname as its argument — that pathname points to a directory containing an AtFS repository, or to a link to an AtFS repository. and yes bestie, links may be chained. we love a chain 💜

when she's linking a repository, mkatfs either creates a symbolic link or — if symbolic links are not available on your system — a file containing the name of the target directory. and AtFS will interpret that file like a symbolic link. periodt.

---

🛠️ the configuring arc

configuring an AtFS repository means the group and the protection may be changed. those operations perform a chgrp(1) and a chmod(1) operation on the AtFS directory and all its subdirectories. every single one. she's thorough like that 😤

---

🗄️ the cache size arc (the math is real)

the -cT, -cN, and -cA options set the size of the derived object cache in the created AtFS object repository. you can set:

• the maximum total number (cT) of derived files to be stored
• the maximum number of derived files per name (cN)
• the maximum number of derived files with the same name and the same caching attribute (cA)

and the relationship of the three values must always be cT >= cN >= cA. no cap, this is not negotiable, the universe will simply not allow otherwise 💀

for more info on that topic, go check the cacheadm(1) manual page, she's the source fr fr.

the -cQ option queries the actual settings for the derived object cache size. it's the "wait what are my settings rn" button 🙈

---

💅 OPTIONS 💅

• -cA max_cached_per_cacheattr — set the maximum number of derived files with the same name and the same caching attribute to be stored. default is 1.
• -cN max_cached_per_name — set the maximum number of derived files with the same name to be stored. default is 3.
• -cT max_total_cached — set the total maximum number of derived files to be stored in the derived object cache. default is 64.
• -g group — set the group id of the generated directory to group (see chgrp(1)).
• -h — display help message. she's helpful AND pretty 🌸
• -l path — create an AtFS directory entry by setting a symbolic link to an existing AtFS object repository, rather than creating a new (empty) one. on System V machines, a file containing the target directory name will be generated instead. the AtFS functions will interpret this as a surrogate for a symbolic link.
• -m mode — set the mode of all generated directories to mode (see chmod(1)).
• -v — output version identification string. the classic "who am i" moment 👑

---

👀 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 one came from AtFS-1.71, dated Mon Aug 8 13:28:26 1994 — yes she's an elder but she's still slaying, fr fr 💖✨🌈 go forth and make your repositories, ily 🎀