Gecko [ bayviewconstructionltd.com ]

Name	Size	Permission	Date
a2disconf	15.89 KB	-rwxr-xr-x	2019-06-16 09:49
a2dismod	15.89 KB	-rwxr-xr-x	2019-06-16 09:49
a2dissite	15.89 KB	-rwxr-xr-x	2019-06-16 09:49
a2enconf	15.89 KB	-rwxr-xr-x	2019-06-16 09:49
a2enmod	15.89 KB	-rwxr-xr-x	2019-06-16 09:49
a2ensite	15.89 KB	-rwxr-xr-x	2019-06-16 09:49
a2query	9.64 KB	-rwxr-xr-x	2019-10-13 15:43
accessdb	10.23 KB	-rwxr-xr-x	2016-12-13 13:10
add-shell	860 B	-rwxr-xr-x	2017-04-02 17:10
addgnupghome	3.01 KB	-rwxr-xr-x	2019-02-07 20:57
addgroup	33.7 KB	-rwxr-xr-x	2016-06-26 22:55
adduser	33.7 KB	-rwxr-xr-x	2016-06-26 22:55
apache2	651.13 KB	-rwxr-xr-x	2019-10-13 15:43
apache2ctl	7.05 KB	-rwxr-xr-x	2019-10-13 15:39
apachectl	7.05 KB	-rwxr-xr-x	2019-10-13 15:39
applygnupgdefaults	2.17 KB	-rwxr-xr-x	2019-02-07 20:57
arpd	46.84 KB	-rwxr-xr-x	2017-11-24 09:22
aspell-autobuildhash	13.22 KB	-rwxr-xr-x	2016-10-10 09:58
biosdecode	18.82 KB	-rwxr-xr-x	2016-09-01 02:59
check_forensic	952 B	-rwxr-xr-x	2011-04-26 15:10
chgpasswd	57.8 KB	-rwxr-xr-x	2017-05-17 11:59
chpasswd	49.9 KB	-rwxr-xr-x	2017-05-17 11:59
chroot	38.88 KB	-rwxr-xr-x	2017-02-22 12:23
cpgr	52 KB	-rwxr-xr-x	2017-05-17 11:59
cppw	52 KB	-rwxr-xr-x	2017-05-17 11:59
cron	47.48 KB	-rwxr-xr-x	2017-10-07 13:38
delgroup	15.43 KB	-rwxr-xr-x	2016-06-26 22:55
deluser	15.43 KB	-rwxr-xr-x	2016-06-26 22:55
dmidecode	102.49 KB	-rwxr-xr-x	2016-09-01 02:59
dpkg-preconfigure	3.52 KB	-rwxr-xr-x	2017-05-21 17:08
dpkg-reconfigure	4.23 KB	-rwxr-xr-x	2017-05-21 17:08
e2freefrag	10.07 KB	-rwxr-xr-x	2020-07-25 09:03
e4crypt	22.07 KB	-rwxr-xr-x	2020-07-25 09:03
e4defrag	25.99 KB	-rwxr-xr-x	2020-07-25 09:03
fdformat	30.66 KB	-rwxr-xr-x	2018-03-07 18:29
ferm	83.84 KB	-rwxr-xr-x	2016-03-30 12:16
filefrag	14.02 KB	-rwxr-xr-x	2020-07-25 09:03
genl	50.79 KB	-rwxr-xr-x	2017-11-24 09:22
groupadd	57.86 KB	-rwxr-xr-x	2017-05-17 11:59
groupdel	53.65 KB	-rwxr-xr-x	2017-05-17 11:59
groupmems	53.84 KB	-rwxr-xr-x	2017-05-17 11:59
groupmod	68.22 KB	-rwxr-xr-x	2017-05-17 11:59
grpck	53.77 KB	-rwxr-xr-x	2017-05-17 11:59
grpconv	49.65 KB	-rwxr-xr-x	2017-05-17 11:59
grpunconv	49.65 KB	-rwxr-xr-x	2017-05-17 11:59
grub-bios-setup	790.19 KB	-rwxr-xr-x	2019-06-12 11:20
grub-install	996.58 KB	-rwxr-xr-x	2019-06-12 11:20
grub-macbless	777.88 KB	-rwxr-xr-x	2019-06-12 11:20
grub-mkconfig	7.82 KB	-rwxr-xr-x	2019-06-12 11:20
grub-mkdevicemap	204.47 KB	-rwxr-xr-x	2019-06-12 11:20
grub-probe	790.19 KB	-rwxr-xr-x	2019-06-12 11:20
grub-reboot	4.01 KB	-rwxr-xr-x	2019-06-12 11:20
grub-set-default	3.48 KB	-rwxr-xr-x	2019-06-12 11:20
httxt2dbm	9.99 KB	-rwxr-xr-x	2019-10-13 15:43
iconvconfig	22.66 KB	-rwxr-xr-x	2019-02-06 21:17
import-ferm	16.81 KB	-rwxr-xr-x	2016-03-30 12:16
install-sgmlcatalog	4.44 KB	-rwxr-xr-x	2016-11-07 07:06
invoke-rc.d	17.69 KB	-rwxr-xr-x	2017-05-02 10:20
iotop	496 B	-rwxr-xr-x	2016-07-29 10:25
ip6tables-apply	6.85 KB	-rwxr-xr-x	2017-04-12 09:41
iptables-apply	6.85 KB	-rwxr-xr-x	2017-04-12 09:41
irqbalance	55.38 KB	-rwxr-xr-x	2017-03-10 18:56
ispell-autobuildhash	15.39 KB	-rwxr-xr-x	2016-10-10 09:58
laptop-detect	2.53 KB	-rwxr-xr-x	2016-12-27 03:11
ldattach	30.71 KB	-rwxr-xr-x	2018-03-07 18:29
locale-gen	1.5 KB	-rwxr-xr-x	2017-07-31 14:32
logrotate	75.27 KB	-rwxr-xr-x	2017-01-07 18:54
make-ssl-cert	3.78 KB	-rwxr-xr-x	2017-04-28 19:58
mkinitramfs	10.01 KB	-rwxr-xr-x	2017-04-26 01:00
mklost+found	9.99 KB	-rwxr-xr-x	2020-07-25 09:03
mysqld	17.05 MB	-rwxr-xr-x	2021-01-31 16:38
newusers	78.43 KB	-rwxr-xr-x	2017-05-17 11:59
nfnl_osf	13.99 KB	-rwxr-xr-x	2017-04-12 09:41
nologin	5.99 KB	-rwxr-xr-x	2017-05-17 11:59
ownership	10.13 KB	-rwxr-xr-x	2016-09-01 02:59
pam-auth-update	19.03 KB	-rwxr-xr-x	2017-05-27 15:44
pam_getenv	2.82 KB	-rwxr-xr-x	2017-05-27 15:44
pam_timestamp_check	10.37 KB	-rwxr-xr-x	2017-05-27 15:44
paperconfig	4.07 KB	-rwxr-xr-x	2016-11-11 11:28
phpdismod	7.11 KB	-rwxr-xr-x	2019-08-14 06:09
phpenmod	7.11 KB	-rwxr-xr-x	2019-08-14 06:09
phpquery	6.24 KB	-rwxr-xr-x	2019-08-14 06:09
pwck	49.84 KB	-rwxr-xr-x	2017-05-17 11:59
pwconv	45.74 KB	-rwxr-xr-x	2017-05-17 11:59
pwunconv	41.72 KB	-rwxr-xr-x	2017-05-17 11:59
readprofile	18.59 KB	-rwxr-xr-x	2018-03-07 18:29
remove-default-ispell	2.86 KB	-rwxr-xr-x	2016-10-10 09:58
remove-default-wordlist	2.86 KB	-rwxr-xr-x	2016-10-10 09:58
remove-shell	904 B	-rwxr-xr-x	2017-04-02 17:10
rmt	55.03 KB	-rwxr-xr-x	2016-10-30 06:35
rmt-tar	55.03 KB	-rwxr-xr-x	2016-10-30 06:35
rsyslogd	636.3 KB	-rwxr-xr-x	2017-01-18 22:14
rtcwake	42.81 KB	-rwxr-xr-x	2018-03-07 18:29
safe_finger	10.08 KB	-rwxr-xr-x	2016-12-25 23:08
select-default-ispell	3.23 KB	-rwxr-xr-x	2016-10-10 09:58
select-default-wordlist	3.21 KB	-rwxr-xr-x	2016-10-10 09:58
service	9.83 KB	-rwxr-xr-x	2017-05-02 10:20
setvesablank	10.36 KB	-rwxr-xr-x	2016-01-05 16:55
split-logfile	2.36 KB	-rwxr-xr-x	2019-10-13 15:43
sshd	772.48 KB	-rwxr-xr-x	2019-07-15 13:32
tarcat	936 B	-rwxr-xr-x	2016-10-30 06:35
tcpd	10 KB	-rwxr-xr-x	2016-12-25 23:08
tcpdchk	22.13 KB	-rwxr-xr-x	2016-12-25 23:08
tcpdmatch	18.04 KB	-rwxr-xr-x	2016-12-25 23:08
tcptraceroute	1.56 KB	-rwxr-xr-x	2016-08-29 15:45
tcptraceroute.db	1.56 KB	-rwxr-xr-x	2016-08-29 15:45
traceroute	67.16 KB	-rwxr-xr-x	2016-08-29 15:45
try-from	10 KB	-rwxr-xr-x	2016-12-25 23:08
tunelp	26.61 KB	-rwxr-xr-x	2018-03-07 18:29
tzconfig	106 B	-rwxr-xr-x	2019-10-11 07:23
update-ca-certificates	4.85 KB	-rwxr-xr-x	2020-06-05 16:52
update-catalog	9.15 KB	-rwxr-xr-x	2016-11-07 07:06
update-default-aspell	1 KB	-rwxr-xr-x	2016-10-10 09:58
update-default-ispell	9.68 KB	-rwxr-xr-x	2016-10-10 09:58
update-default-wordlist	7.5 KB	-rwxr-xr-x	2016-10-10 09:58
update-dictcommon-aspell	1 KB	-rwxr-xr-x	2016-10-10 09:58
update-dictcommon-hunspell	782 B	-rwxr-xr-x	2016-10-10 09:58
update-grub	64 B	-rwxr-xr-x	2019-06-12 11:20
update-grub2	64 B	-rwxr-xr-x	2019-06-12 11:20
update-gsfontmap	450 B	-rwxr-xr-x	2020-08-20 14:04
update-initramfs	8.02 KB	-rwxr-xr-x	2017-03-06 22:42
update-locale	2.99 KB	-rwxr-xr-x	2016-03-20 23:45
update-mime	8.84 KB	-rwxr-xr-x	2016-05-01 11:20
update-passwd	30.41 KB	-rwxr-xr-x	2017-01-16 15:52
update-pciids	2.84 KB	-rwxr-xr-x	2016-11-30 06:53
update-rc.d	15.69 KB	-rwxr-xr-x	2017-05-02 10:20
update-xmlcatalog	16.88 KB	-rwxr-xr-x	2016-11-07 14:53
upgrade-from-grub-legacy	1.49 KB	-rwxr-xr-x	2019-06-12 11:20
useradd	119.29 KB	-rwxr-xr-x	2017-05-17 11:59
userdel	82.49 KB	-rwxr-xr-x	2017-05-17 11:59
usermod	119.1 KB	-rwxr-xr-x	2017-05-17 11:59
validlocale	1.73 KB	-rwxr-xr-x	2016-03-20 23:45
vcstime	6.24 KB	-rwxr-xr-x	2016-01-05 16:55
vigr	60.22 KB	-rwxr-xr-x	2017-05-17 11:59
vipw	60.22 KB	-rwxr-xr-x	2017-05-17 11:59
visudo	200.34 KB	-rwxr-xr-x	2021-01-23 09:10
vpddecode	14.27 KB	-rwxr-xr-x	2016-09-01 02:59
zic	42.54 KB	-rwxr-xr-x	2019-02-06 21:17

Rename

#! /usr/bin/perl

# a2query - Apache2 helper to retrieve configuration informations
# Copyright (C) 2012 Arno Töll <debian@toell.net>
#
# This program is licensed at your choice under the terms of the GNU General
# Public License version 2+ or under the terms of the Apache Software License
# 2.0.
#
# For GPL-2+:
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
# USA.
#
# For ASF 2.0:
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

use feature "switch";
use strict;
use Getopt::Std;

=head1 NAME

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

=cut

our $APACHE2 = "apache2ctl";
our $API = "20120211";
our $MODULE_DIR = "/usr/lib/apache2/modules/";
our $SERVER_VERSION = "2.4.25";
our $MODULE_DIR = "/usr/lib/apache2/modules/";
our $STATE_DIR = "/var/lib/apache2";
our @STATES = ("maint", "admin");

our $MPM = "invalid";
our $CONFIG_DIR = "/etc/apache2";
our $QUIET = 0;

# time to introduce more _exit_ values
our $E_OK = '0';
our $E_FOUND = '0';
our $E_NOTFOUND = '1';
our $E_OFFBYADMIN = '32';
our $E_OFFBYMAINT = '33';
our @RETVALS = ( $E_OK, $E_FOUND, $E_OFFBYADMIN, $E_NOTFOUND, $E_OFFBYMAINT );

our @MODULES = ();
our @CONFS = ();
our @SITES =();
our @HELP = ();
our %verbose_state = ( 'admin' => 'site administrator', 'maint' => 'maintainer script', 'unknown' => 'unknown' );

=head1 SYNOPSIS

B<a2query>  [S<-m> [I<MODULE>]] [S<-s> [I<SITE>]] [S<-c> [I<CONF>]] [S<-a>] [S<-v>]
[S<-M>] [S<-d>] [S<-h>]

=head1 DESCRIPTION

B<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.

=head1 OPTIONS

=over 4

=item S<-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.

=item S<-c> [I<CONF>]

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

=item S<-h>

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

=item S<-m> [I<MODULE>]

Checks whether the module I<MODULE> is enabled, The argument is interpreted in
the same way, as for configuration files queried by the S<-c> switch.

=item S<-M>

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

=item S<-s> [I<SITE>]

Checks whether the module I<SITE> is enabled, The argument is interpreted in
the same way, as for configuration files queried by the S<-c> switch.

=item S<-v>

returns the currently installed Apache 2 HTTP server version

=item S<-q>

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

=back

=head1 EXIT CODES

B<a2query> returns with a zero (S<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 S<32> if a requested module, site or
configuration was not found and S<33> if a module, site or configuration was
disabled by a maintainer script. However, exit status S<1> is returned if the
module was not found at all

=head1 SEE ALSO

L<apache2ctl>(8), L<apache2>(8), L<perl>(1)

=head1 AUTHOR

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

=cut

sub output
{
	print @_ unless $QUIET;
}

sub warning
{
	print STDERR @_ unless $QUIET;
}

sub fail
{
	die('usage: fail($reason, $retval)') if @_ != 2;
	my $reason = shift;
	my $retval = shift;
	warning "$reason\n";
	exit $retval;
}

sub load_defaults
{
	my @out = `$APACHE2 -V 2>/dev/null`;
	return if $?;
	foreach my $line (@out)
	{
		if ($line =~ m/(Server version|Server MPM|Magic Number):\s+(.*?)$/)
		{
			my ($pattern, $value) = ($1, $2);
			if ($pattern =~ /version/)
			{
				$SERVER_VERSION = $value;
				$SERVER_VERSION =~ s/[^\d\.]//g;
			}
			elsif ($pattern =~ /MPM/)
			{
				$MPM = $value;
			}
			elsif ($pattern =~ /Magic/)
			{
				$API = $value;
				$API =~ s/\:\d+//;
			}
		}
	}

}

sub load_modules
{
	my $conf_dir = $CONFIG_DIR . "/mods-enabled";
	opendir(DIR, $conf_dir) || fail("$conf_dir: $!", 1);
	while ( readdir(DIR) )
	{
		my $file = $_;
		next if $file !~ m/\.load$/;
		$file =~ s/\.load//;
		if ($file =~ /mpm_(event|worker|prefork)/)
		{
			$MPM = $1 if $MPM eq 'invalid';
			if (grep { $_ =~ m/^mpm_(?:event|worker|prefork)/ } @MODULES)
			{
				fail("There is more than one MPM loaded. Do not proceed due to undefined results", 1);
			}
		}
		push @MODULES, $file;
	}
	closedir(DIR);
}

sub load_conf
{
	if ($#CONFS >= 0)
	{
		return;
	}
	my $conf_dir = $CONFIG_DIR . "/conf-enabled";
	opendir(DIR, $conf_dir) || fail("$conf_dir: $!", 1);
	while ( readdir(DIR) )
	{
		my $file = $_;
		next if $file !~ m/\.conf$/;
		$file =~ s/\.conf$//;
		push @CONFS, $file;
	}
	closedir(DIR);
}

sub load_sites
{
	if ($#SITES >= 0)
	{
		return;
	}
	my $conf_dir = $CONFIG_DIR . "/sites-enabled";
	opendir(DIR, $conf_dir) || fail("$conf_dir: $!", 1);
	while ( readdir(DIR) )
	{
		my $file = $_;
		next if $file !~ m/\.conf$/;
		$file =~ s/\.conf$//;
		push @SITES, $file;
	}
	closedir(DIR);
}

sub switch_history
{
	die('usage: switch_history([module|site|conf], [enabled|disabled], $name)') if @_ != 3;
	my $which = shift;
	my $what = shift;
	my $name = shift;

$name =~ s/\.conf$//;

foreach my $state (@STATES)
	{
		my $state_token = "$STATE_DIR/$which/$what" . "_by_$state/" . $name;
		if (-e $state_token)
		{
			return $state;
		}
	}
	return 0;
}

sub query_state
{
	my $type    = shift;
	my $pattern = shift;
	my $listref = shift;

$pattern =~ s/^mod//;
	$pattern =~ s/\.(conf|load)//;
	my @candidates;

if ($pattern)
	{
		@candidates = grep { $_ eq $pattern } @{ $listref };
	}
	else
	{
		@candidates = @{ $listref }
	}

my $matches = 0;
	foreach my $module (@candidates)
	{
		my $state = switch_history($type, "enabled", $module);
		if (!$state)
		{
			$state = "unknown";
		}
		output("$module (enabled by $verbose_state{$state})\n");
		$matches++;
	}
	if (!$matches)
	{
		my $reason = "No $type matches $pattern";
		my $retval = $E_NOTFOUND;
		my $state = switch_history($type, "disabled", $pattern);
		if ($state)
		{
			$reason .= " (disabled by $verbose_state{$state})";
			if ($state eq 'maint')
			{
				$retval = $E_OFFBYMAINT;
			}
			if ($state eq 'admin')
			{
				$retval = $E_OFFBYADMIN;
			}
		}
		fail($reason, $retval);
	}
}

load_defaults();
load_modules();

my %opts;
my $help = 1;
getopts('m:s:c:havMdq', \%opts);
#foreach my $key (keys %opts) { print("$key=$opts{$key}\n");}

push @HELP, ["q", "suppress any output. Useful for invocation from scripts"];
if (exists $opts{'q'})
{
	--$help;
	$QUIET=1;
}

push @HELP, ["m [MODULE]", "checks whether the module MODULE is enabled, lists all enabled modules if no argument was given"];
if (exists $opts{'m'})
{
	--$help;
	query_state('module', $opts{'m'}, \@MODULES);
}

push @HELP, ["s [SITE]", "checks whether the site SITE is enabled, lists all sites if no argument was given"];
if (exists $opts{'s'})
{
	--$help;
	load_sites();
	query_state('site', $opts{'s'}, \@SITES);
}

push @HELP, ["c [CONF]", "checks whether the configuration CONF is enabled, lists all configurations if no argument was given"];
if (exists $opts{'c'})
{
	--$help;
	load_conf();
	query_state('conf', $opts{'c'}, \@CONFS);
}

push @HELP, ["a", "returns the current Apache 2 module magic version"];
if (exists $opts{'a'})
{
	--$help;
	output("$API\n");
}

push @HELP, ["v", "returns the current Apache 2 version"];
if (exists $opts{'v'})
{
	--$help;
	output("$SERVER_VERSION\n");
}

push @HELP, ["M", "returns the enabled Apache 2 MPM"];
if (exists $opts{'M'})
{
	--$help;
	output("$MPM\n");
}

push @HELP, ["d", "returns the Apache 2 module directory"];
if (exists $opts{'d'})
{
	--$help;
	output("$MODULE_DIR\n");
}

push @HELP, ["h", "display this help"];
if (exists $opts{'h'} or $help == 1)
{
	my $usage = "$0 ";
	map { $usage .= "-$_->[0] " } @HELP;
	print("Usage: $usage\n");
	my $switch_name;
	my $description;
	format STDOUT =
@<<<<<<<<<<<<	^<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
"-$switch_name",        $description,
~~	        ^<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
			$description,
.
	foreach my $switch (@HELP)
	{
		($switch_name, $description) = ($switch->[0], $switch->[1]);
		write STDOUT;
	}
	exit $E_OK;
}

# vim: syntax=perl sw=8 sts=8 sr noet