1 <?xml version=
"1.0" encoding=
"utf-8" standalone=
"no"?>
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
5 <!ENTITY % aptent SYSTEM
"apt.ent">
14 <refentrytitle>apt-config
</refentrytitle>
15 <manvolnum>8</manvolnum>
18 <!-- Man page title -->
20 <refname>apt-config
</refname>
21 <refpurpose>APT Configuration Query program
</refpurpose>
27 <command>apt-config
</command>
28 <arg><option>-hv
</option></arg>
29 <arg><option>-o=
<replaceable>config string
</replaceable></option></arg>
30 <arg><option>-c=
<replaceable>file
</replaceable></option></arg>
38 <refsect1><title>Description
</title>
39 <para><command>apt-config
</command> is an internal program used by various
40 portions of the APT suite to provide consistent configurability. It accesses
41 the main configuration file
<filename>/etc/apt/apt.conf
</filename> in a
42 manner that is easy to use by scripted applications.
</para>
44 <para>Unless the
<option>-h
</option>, or
<option>--help
</option> option is
45 given one of the commands below must be present.
49 <varlistentry><term>shell
</term>
51 shell is used to access the configuration information from a shell
52 script. It is given pairs of arguments, the first being a shell
53 variable and the second the configuration value to query. As output
54 it lists a series of shell assignments commands for each present value.
55 In a shell script it should be used like:
58 <informalexample><programlisting>
60 RES=`apt-config shell OPTS MyApp::options`
62 </programlisting></informalexample>
64 <para>This will set the shell environment variable $OPTS to the value of
65 MyApp::options with a default of
<option>-f
</option>.
</para>
68 <para>The configuration item may be postfixed with a /[fdbi]. f returns
69 file names, d returns directories, b returns true or false and i returns
70 an integer. Each of the returns is normalized and verified
75 <varlistentry><term>dump
</term>
77 Just show the contents of the configuration space.
</para>
84 <refsect1><title>options
</title>
94 <refsect1><title>See Also
</title>
100 <refsect1><title>Diagnostics
</title>
101 <para><command>apt-config
</command> returns zero on normal operation, decimal
100 on error.