1INNCONFVAL(1) InterNetNews Documentation INNCONFVAL(1)
2
6 innconfval - Get configuration parameters from inn.conf
7
9 innconfval [-pstv] [-i file] [parameter ...]
10 innconfval -C [-i file]
12
14 innconfval normally prints the values of the parameters specified on
15 the command line. By default, it just prints the parameter values, but
16 if -p, -s, or -t are given, it instead prints the parameter and value
17 in the form of a variable assignment in Perl, Bourne shell, or Tcl
18 respectively. If no parameters are specifically requested, innconfval
19 prints out all parameter values (this isn't particularly useful unless
20 one of -p, -s, or -t were specified).
21 All parameters are taken from inn.conf except for version, which is
23 always the version string of INN.
24 If given the -C option, innconfval instead checks inn.conf, reporting
26 any problems found to standard error. innconfval will exit with status
27 0 if no problems are found and with status 1 otherwise.
28
30 -C Check inn.conf rather than printing out the values of parameters.
31 -i file
33 Use file as the source configuration file rather than inn.conf.
34 file must be a valid inn.conf file and will be parsed the same as
35 inn.conf would be.
36 -p Print out parameters as Perl assignment statements. The variable
38 name will be the same as the inn.conf parameter, and string values
39 will be enclosed in single quotes with appropriate escaping.
40 Boolean values will be mapped to the strings "true" or "false".
41 List values will be mapped to an array of strings. NULL values are
42 not printed out and will therefore be "undef" in Perl.
43 Here is an example:
45 $enableoverview = 'true';
47 @extraoverviewadvertised = ( 'Newsgroups', 'Injection-Info' );
48 $organization = 'Let\'s try nasty "quotes"';
49 $maxforks = 10;
50 If innconfval is called via the Perl "INN::Config" module, all
52 these variables are properly exported.
53 -s Print out parameters as Bourne shell assignment statements. The
55 variable name will be the inn.conf parameter name in all capitals,
56 and all variables will be exported, if not NULL. String values
57 will be enclosed in single quotes with appropriate escaping, and
58 boolean values will be mapped to "true" or "false". List values
59 will be mapped to a space-separated string representing an array of
60 strings (as Bourne shell does not recognize arrays, contrary to
61 several other shells, an array cannot be returned for
62 interoperability reasons).
63 Here is an example:
65 ENABLEOVERVIEW=true; export ENABLEOVERVIEW;
67 EXTRAOVERVIEWADVERTISED='"Newsgroups" "Injection-Info"'; export EXTRAOVERVIEWADVERTISED;
68 ORGANIZATION='Let'\''s try nasty "quotes"'; export ORGANIZATION;
69 MAXFORKS=10; export MAXFORKS;
70 -t Print out parameters as Tcl assignment statements. The variable
72 name will be the same as the inn.conf parameter name but with
73 "inn_" prepended, and string variables will be escaped
74 appropriately. Boolean values will be mapped to the strings "true"
75 or "false". List values will be mapped to an array of strings.
76 NULL values are not printed out.
77 Here is an example:
79 set inn_enableoverview "true"
81 set inn_extraoverviewadvertised { "Newsgroups" "Injection-Info" }
82 set inn_organization "Let's try nasty \"quotes\""
83 set inn_maxforks 10
84 -v Print INN's version. This is equivalent to "innconfval version".
86
88 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.
89 $Id: innconfval.pod 8919 2010-01-22 23:29:28Z iulius $
91
93 inn.conf(5), INN::Config(3pm).
94INN 2.5.2 2010-08-11 INNCONFVAL(1)