APT-CONFIG(G)                                       APT-CONFIG(G)



NAME
       apt-config - APT Configuration Query program

SYNOPSIS
       apt-config  [ -hv ]  [ -o=config string ]  [ -c=file ]   [
       shell ]  [ dump ]

DESCRIPTION
       apt-config is an internal program used by various portions
       of the APT suite to provide consistent configurability. It
       accesses the main configuarion file /etc/apt/apt.conf in a
       manner that is easy to use by scripted applications.

       Unless  the  -h, or --help option is given one of the com-
       mands below must be present.

       shell  shell is used to access the configuration  informa-
              tion  from  a  shell  script.  It is given pairs of
              arguments, the first being a shell variable and the
              second  the configuration value to query. As output
              it lists a series of shell assignments commands for
              each present value.  In a shell script it should be
              used like:


              OPTS="-f"
              RES=`apt-config shell OPTS MyApp::Options`
              eval $RES


              This will set the shell environment variable  $OPTS
              to  the  value  of MyApp::Options with a default of
              -f.

              The configuration item  may  be  postfixed  with  a
              /[fdbi].  f  returns file names, d returns directo-
              ries, b returns true or  false  and  i  returns  an
              integer. Each of the returns is normalized and ver-
              ified internally.

       dump   Just show the contents of the configuration  space.

OPTIONS
       All  command  line options may be set using the configura-
       tion file, the  descriptions  indicate  the  configuration
       option  to  set.  For boolean options you can override the
       config file by using something like -f-,--no-f,  -f=no  or
       several other variations.

       -h

       --help Show a short usage summary.

       -v

       --version
              Show the program verison.

       -c

       --config-file
              Configuration File; Specify a configuration file to
              use.  The program will read the default  configura-
              tion  file  and  then  this configuration file. See
              apt.conf(f) for syntax information.

       -o

       --option
              Set  a  Configuration  Option;  This  will  set  an
              arbitary  configuration  option.  The  syntax is -o
              Foo::Bar=bar.

SEE ALSO
       apt.conf(f)

DIAGNOSTICS
       apt-config returns zero on normal operation,  decimal  100
       on error.

BUGS
       See the APT bug page <URL:http://bugs.debian.org/apt>.  If
       you  wish  to  report   a   bug   in   APT,   please   see
       /usr/share/doc/debian/bug-reporting.txt or the bug(g) com-
       mand.

AUTHOR
       APT was written by the APT team <apt@packages.debian.org>.



                          12 March 2001             APT-CONFIG(G)