A2QUERY.IN(1)                               User Contributed Perl Documentation                              A2QUERY.IN(1)

NAME
       a2query - retrieve runtime configuration from a local Apache 2 HTTP server

SYNOPSIS
       a2query  [-m [MODULE]] [-s [SITE]] [-c [CONF]] [-a] [-v] [-M] [-d] [-h]

DESCRIPTION
       a2query is a program designed to retrieve configuration values from a locally available Apache 2 HTTP web server.
       It was designed to be as robust as possible by returning feasible values even if the Apache 2 syntax validator
       fails.

       This program is primarily meant to be used from maintainer scripts.

OPTIONS
       -a  Returns the Apache 2 "Module Magic Version" (API version) number, the server was compiled with. The returned
           version does not contain any minor versions which are known to be compatible with the major version returned.

       -c [CONF]
           Checks whether the configuration CONF is enabled. If no argument was given, all enabled configuration files are
           being returned. CONF is compared by string comparison by ignoring a leading "mod_" prefix and possibly a
           '.conf' or '.load' suffix.

       -h  Displays a brief summary how the program can be called and exits.

       -m [MODULE]
           Checks whether the module MODULE is enabled, The argument is interpreted in the same way, as for configuration
           files queried by the -c switch.

       -M  Returns the currently enabled Apache 2 MPM (Multi Processing Module).

       -s [SITE]
           Checks whether the module SITE is enabled, The argument is interpreted in the same way, as for configuration
           files queried by the -c switch.

       -v  returns the currently installed Apache 2 HTTP server version

       -q  suppress any output. This is useful to invoke a2query from another script. This is useful if only the return
           code is of interest.

EXIT CODES
       a2query returns with a zero (0) exit status if the requested operation was effectuated successfully and with a non-
       zero status otherwise. In case of an error it leaves with error code 32 if a requested module, site or
       configuration was not found and 33 if a module, site or configuration was disabled by a maintainer script. However,
       exit status 1 is returned if the module was not found at all

SEE ALSO
       apache2ctl(8), apache2(8), perl(1)

AUTHOR
       This manual and a2query was written by Arno Toell <debian@toell.net>.

perl v5.28.1                                            2021-12-21                                           A2QUERY.IN(1)

Usage: /usr/sbin/a2query -q -m [MODULE] -s [SITE] -c [CONF] -a -v -M -d -h 
-q              suppress any output. Useful for invocation from scripts
-m [MODULE]     checks whether the module MODULE is enabled, lists all enabled
                modules if no argument was given
-s [SITE]       checks whether the site SITE is enabled, lists all sites if no
                argument was given
-c [CONF]       checks whether the configuration CONF is enabled, lists all
                configurations if no argument was given
-a              returns the current Apache 2 module magic version
-v              returns the current Apache 2 version
-M              returns the enabled Apache 2 MPM
-d              returns the Apache 2 module directory
-h              display this help