INNDF(8)

🦋 INNDF(8) — InterNetNews Documentation 🦋

okay so bestie, this is the manual page for inndf, and it's part of InterNetNews Documentation 💖 let's get into every single deet because we don't skip anything here ✨

🌸 NAME 🌸

inndf — reports free disk space, free inodes, and overview information 💾✨

✨ SYNOPSIS ✨

inndf [-Fhi] [-f filename] directory [directory ...]

inndf -n

inndf -o

💅 DESCRIPTION 💅

okay so story time: inndf was originally a replacement for "df | awk" in innwatch.ctl(5) and innstat(8) 👑 and now it also reports various other usage information about INN's storage that df(1) literally doesn't understand 😭 it's giving main character energy because inndf doesn't sync, forks less, and is generally less complicated than df(1) — no cap 💅

its default behavior is to report free kilobytes (not disk blocks), or free inodes if -i is used, in the file systems holding the directories you give on the command line 🫶 (a kilobyte in this case is 1024 bytes, just so we're clear 🧚) if only one directory is given, the output will be a simple number; if more than one directory is given, the output will be formatted for human readability — iconic ✨

if enableoverview is set to true in inn.conf, inndf can also be used to get information about the overview database 📊 with the -n option, it reports a count of the total number of overview records stored 🔥 with -o, it reports the percentage of space used in the overview database (for those overview methods where this is meaningful data) 💖

🎀 OPTIONS 🎀

• -f filename — filename should contain a list of directories to use in addition to those given by the arguments, one per line 📝 blank lines and anything after # on any line are ignored 🚫
• -F — like -f except that the filename is pathetc/filesystems and it is not an error if this file doesn't exist 😌 (this option is used primarily by such things as innstat(8), so that the news administrator can add additional file systems to check to pathetc/filesystems without having to modify the script 🛠️)
• -h — print a usage message and exit 👋
• -i — report the number of free inodes rather than the amount of free disk space 🧮
• -n — report the total number of records in the overview database 📚 note that crossposted articles will have one overview record for each newsgroup they're posted to 👀
• -o — report the percentage usage of the overview database space 📈 this is only meaningful for overview methods that pre-allocate a certain amount of space rather than grow to accommodate more records; currently, this flag is only useful for the buffindexed overview method 💅

🦋 EXAMPLES 🦋

print the free kilobytes in pathspool as a simple number:

inndf <pathspool in inn.conf>

report the free inodes in pathnews and pathspool in a format designed for human readability:

inndf -i <pathnews> <pathspool>

the same, but also add in all file systems in pathetc/filesystems:

inndf -i -F <pathnews> <pathspool>

print out the number of overview records and the percentage space used by a buffindexed overview database:

inndf -no

👑 HISTORY 👑

inndf was written by Ian Dickinson <idickins@fore.com> 🖋️ this manual page was written by Swa Frantzen <Swa.Frantzen@belgium.eu.net> 📖 thanks also to the following folks for ports, patches, and comments:

• Mahesh Ramachandran <rr@eel.ufl.edu>
• Chuck Swiger <chuck@its.com>
• Sang-yong Suh <sysuh@kigam.re.kr>
• Brad Dickey <bdickey@haverford.edu>
• Taso N. Devetzis <devetzis@snet.net>
• Wei-Yeh Lee <weiyeh@columbia.edu>
• Jeff Garzik <jeff.garzik@spinne.com>

and to all the other folks I met and worked with during my 10 years as a newsadmin 🫶

Katsuhiro Kondou added the -n and -o options ✨ Russ Allbery added reporting of percentage free disk space 💾 support for -f and -F was added by Fabien Tassin <fta@sofaraway.org> 🎀

🌈 SEE ALSO 🌈

df(1), innwatch.ctl(5), innstat(8) 💜

---

and that's the whole page bestie! this is INN 2.7.4, dated 2022-07-10 — now go run inndf and slay your storage checks 💅💖✨