INNCONFVAL(1)

💅 INNCONFVAL 💅

ok so bestie, welcome to innconfval — she lives in InterNetNews Documentation and honestly she's the one you text when you need to know what your config actually says. 🎀

---

✨ NAME ✨

innconfval — literally the girl who gets configuration parameters out of your configuration files 🫶

---

🌸 SYNOPSIS 🌸

innconfval [-pstv] [-f file] [-F filetype] [-i innconffile] [parameter ...]

innconfval -C [-i innconffile]

---

🦋 DESCRIPTION 🦋

okay so normally innconfval prints the values of whatever parameters you named on the command line, and she pulls them from inn.conf. no cap. 💖

by default she just prints the parameter values — but if you pass -p, -s, or -t, she switches it up and prints the parameter and its value as a variable assignment in Perl, Bourne shell, or Tcl respectively. iconic behaviour honestly.

and if you don't specifically request any parameters at all, innconfval prints out all the parameter values. (ngl, that isn't particularly useful unless one of -p, -s, or -t was specified. 😭)

every single parameter comes from inn.conf — except version, which is always the version string of INN. she doesn't take that from anywhere else, periodt. 👑

want to read from a different config file entirely? use the -f and -F options to specify another configuration file to print parameter values from. slay.

and if you give her the -C option, innconfval instead checks inn.conf and reports any problems she finds to standard error. vibe check mode. 🔥

---

💅 OPTIONS 💅

• -C — check inn.conf instead of printing out parameter values, and exit with status "0" if no problems are found and with status "1" otherwise. very binary of her.
• -f file — use file as the source configuration file for the type mentioned in the -F option. if it's not set, the default configuration file is used (that is to say, the file in pathetc named like the type provided with -F). file must be a valid configuration file of that type and will be parsed the same as that type would be. ✨
• -F filetype — filetype must either be "inn.conf" (the default) or "inn-secrets.conf". it defines the type of configuration file to parse. 🗂️

for instance, run innconfval -F inn-secrets.conf canlockuser to retrieve the canlockuser value from inn-secrets.conf. iykyk.

the default path to the configuration file of the requested type will be used, unless -f is given (or a specific source configuration file for inn.conf is set with -i and defines another pathetc location). 🫡

• -i innconffile — use innconffile as the source configuration file for inn.conf rather than inn.conf in pathetc. innconffile must be a valid inn.conf file and will be parsed the same as inn.conf would be. 💖
• -p — print out parameters as Perl assignment statements. the variable name will be the same as the configuration parameter, and string values will be enclosed in single quotes with appropriate escaping. boolean values will be mapped to the strings "true" or "false". list values will be mapped to an array of strings. NULL values are printed out with the "undef" value. 🐪

here's an example, because she's generous:

$enableoverview = 'true';
@extraoverviewadvertised = ( 'Newsgroups', 'Injection-Info' );
@extraoverviewhidden = undef;
$organization = 'Let\'s try nasty "quotes"';
$maxforks = 10;

and if innconfval is called via the Perl INN::Config module, all these variables are properly exported. no notes. 💯

• -s — print out parameters as Bourne shell assignment statements. the variable name will be the configuration parameter name in all capitals, and all variables will be exported, if not NULL. string values will be enclosed in single quotes with appropriate escaping, and boolean values will be mapped to "true" or "false". list values will be mapped to a space-separated string representing an array of strings (as Bourne shell does not recognize arrays, contrary to several other shells, an array cannot be returned for interoperability reasons). she's doing her best, okay 😭

example time:

ENABLEOVERVIEW=true; export ENABLEOVERVIEW;
EXTRAOVERVIEWADVERTISED='"Newsgroups" "Injection-Info"';
    export EXTRAOVERVIEWADVERTISED;
ORGANIZATION='Let'\''s try nasty "quotes"'; export ORGANIZATION;
MAXFORKS=10; export MAXFORKS;

• -t — print out parameters as Tcl assignment statements. the variable name will be the same as the configuration parameter name but with "inn_" prepended, and string variables will be escaped appropriately. boolean values will be mapped to the strings "true" or "false". list values will be mapped to an array of strings. NULL values are not printed out. 🧚

look at her go:

set inn_enableoverview "true"
set inn_extraoverviewadvertised { "Newsgroups" "Injection-Info" }
set inn_organization "Let's try nasty \"quotes\""
set inn_maxforks 10

• -v — print INN's version and exit. this is equivalent to innconfval version. short and sweet ⭐

---

🌈 HISTORY 🌈

written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. a legend, fr fr. 👑

---

💜 SEE ALSO 💜

inn.conf(5), inn-secrets.conf(5), INN::Config(3pm). go read them, bestie, they're right there 🫶

---

and that's the whole page, mwah 💋 — this is INN 2.7.4, dated 2022-07-10, signed off with love from your girl INNCONFVAL(1) 🎀✨