Gecko [ www.habutechnology.com ]

Name	Size	Permission
a2disconf	15.86 KB	-rwxr-xr-x
a2dismod	15.86 KB	-rwxr-xr-x
a2dissite	15.86 KB	-rwxr-xr-x
a2enconf	15.86 KB	-rwxr-xr-x
a2enmod	15.86 KB	-rwxr-xr-x
a2ensite	15.86 KB	-rwxr-xr-x
a2query	9.6 KB	-rwxr-xr-x
add-shell	1.03 KB	-rwxr-xr-x
addgroup	47.25 KB	-rwxr-xr-x
adduser	47.25 KB	-rwxr-xr-x
agetty	67.49 KB	-rwxr-xr-x
apache2	712.5 KB	-rwxr-xr-x
apache2ctl	7.19 KB	-rwxr-xr-x
apachectl	7.19 KB	-rwxr-xr-x
badblocks	34.25 KB	-rwxr-xr-x
blkdiscard	34.31 KB	-rwxr-xr-x
blkid	122.34 KB	-rwxr-xr-x
blkzone	78.31 KB	-rwxr-xr-x
blockdev	78.31 KB	-rwxr-xr-x
chcpu	46.3 KB	-rwxr-xr-x
check_forensic	952 B	-rwxr-xr-x
chgpasswd	66.29 KB	-rwxr-xr-x
chmem	66.31 KB	-rwxr-xr-x
chpasswd	62.36 KB	-rwxr-xr-x
chroot	46.98 KB	-rwxr-xr-x
cpgr	60.43 KB	-rwxr-xr-x
cppw	60.43 KB	-rwxr-xr-x
ctrlaltdel	38.3 KB	-rwxr-xr-x
debugfs	233.83 KB	-rwxr-xr-x
delgroup	16.33 KB	-rwxr-xr-x
deluser	16.33 KB	-rwxr-xr-x
dpkg-fsys-usrunmess	16.99 KB	-rwxr-xr-x
dpkg-preconfigure	3.83 KB	-rwxr-xr-x
dpkg-reconfigure	4.38 KB	-rwxr-xr-x
dumpe2fs	30.31 KB	-rwxr-xr-x
e2freefrag	14.3 KB	-rwxr-xr-x
e2fsck	348.27 KB	-rwxr-xr-x
e2image	54.45 KB	-rwxr-xr-x
e2label	114.52 KB	-rwxr-xr-x
e2mmpstatus	30.31 KB	-rwxr-xr-x
e2scrub	7.12 KB	-rwxr-xr-x
e2scrub_all	5.27 KB	-rwxr-xr-x
e2undo	22.3 KB	-rwxr-xr-x
e4crypt	26.3 KB	-rwxr-xr-x
e4defrag	30.23 KB	-rwxr-xr-x
faillock	14.24 KB	-rwxr-xr-x
filefrag	18.26 KB	-rwxr-xr-x
findfs	14.3 KB	-rwxr-xr-x
fsck	54.36 KB	-rwxr-xr-x
fsck.cramfs	42.37 KB	-rwxr-xr-x
fsck.ext2	348.27 KB	-rwxr-xr-x
fsck.ext3	348.27 KB	-rwxr-xr-x
fsck.ext4	348.27 KB	-rwxr-xr-x
fsck.minix	122.34 KB	-rwxr-xr-x
fsfreeze	14.3 KB	-rwxr-xr-x
fstab-decode	14.23 KB	-rwxr-xr-x
fstrim	74.31 KB	-rwxr-xr-x
getty	67.49 KB	-rwxr-xr-x
groupadd	99.04 KB	-rwxr-xr-x
groupdel	90.85 KB	-rwxr-xr-x
groupmems	66.33 KB	-rwxr-xr-x
groupmod	99.01 KB	-rwxr-xr-x
grpck	66.3 KB	-rwxr-xr-x
grpconv	58.14 KB	-rwxr-xr-x
grpunconv	58.14 KB	-rwxr-xr-x
httxt2dbm	14.23 KB	-rwxr-xr-x
hwclock	86.44 KB	-rwxr-xr-x
iconvconfig	30.84 KB	-rwxr-xr-x
installkernel	2.6 KB	-rwxr-xr-x
invoke-rc.d	16.13 KB	-rwxr-xr-x
isosize	30.31 KB	-rwxr-xr-x
killall5	26.31 KB	-rwxr-xr-x
ldattach	34.31 KB	-rwxr-xr-x
ldconfig	959.84 KB	-rwxr-xr-x
logsave	14.09 KB	-rwxr-xr-x
losetup	114.42 KB	-rwxr-xr-x
mke2fs	138.58 KB	-rwxr-xr-x
mkfs	14.3 KB	-rwxr-xr-x
mkfs.bfs	34.31 KB	-rwxr-xr-x
mkfs.cramfs	42.24 KB	-rwxr-xr-x
mkfs.ext2	138.58 KB	-rwxr-xr-x
mkfs.ext3	138.58 KB	-rwxr-xr-x
mkfs.ext4	138.58 KB	-rwxr-xr-x
mkfs.minix	110.32 KB	-rwxr-xr-x
mkhomedir_helper	22.27 KB	-rwxr-xr-x
mklost+found	14.23 KB	-rwxr-xr-x
mkswap	114.31 KB	-rwxr-xr-x
newusers	102.92 KB	-rwxr-xr-x
nologin	14.23 KB	-rwxr-xr-x
pam-auth-update	20.79 KB	-rwxr-xr-x
pam_getenv	2.82 KB	-rwxr-xr-x
pam_namespace_helper	467 B	-rwxr-xr-x
pam_timestamp_check	14.24 KB	-rwxr-xr-x
pivot_root	14.3 KB	-rwxr-xr-x
policy-rc.d	255 B	-rwxr-xr-x
pwck	58.26 KB	-rwxr-xr-x
pwconv	54.13 KB	-rwxr-xr-x
pwhistory_helper	18.24 KB	-rwxr-xr-x
pwunconv	54.17 KB	-rwxr-xr-x
readprofile	34.34 KB	-rwxr-xr-x
remove-shell	1.08 KB	-rwxr-xr-x
resize2fs	62.3 KB	-rwxr-xr-x
rmt	59.02 KB	-rwxr-xr-x
rmt-tar	59.02 KB	-rwxr-xr-x
rtcwake	46.31 KB	-rwxr-xr-x
runuser	70.31 KB	-rwxr-xr-x
service	8.89 KB	-rwxr-xr-x
shadowconfig	2.22 KB	-rwxr-xr-x
split-logfile	2.36 KB	-rwxr-xr-x
start-stop-daemon	43.42 KB	-rwxr-xr-x
sulogin	54.31 KB	-rwxr-xr-x
swaplabel	18.3 KB	-rwxr-xr-x
swapoff	22.3 KB	-rwxr-xr-x
swapon	50.3 KB	-rwxr-xr-x
switch_root	18.3 KB	-rwxr-xr-x
sysctl	30.31 KB	-rwxr-xr-x
tarcat	936 B	-rwxr-xr-x
tune2fs	114.52 KB	-rwxr-xr-x
unix_chkpwd	38.24 KB	-rwxr-sr-x
unix_update	38.24 KB	-rwxr-xr-x
update-ca-certificates	5.29 KB	-rwxr-xr-x
update-passwd	38.49 KB	-rwxr-xr-x
update-rc.d	17.33 KB	-rwxr-xr-x
update-shells	3.89 KB	-rwxr-xr-x
useradd	155.8 KB	-rwxr-xr-x
userdel	110.95 KB	-rwxr-xr-x
usermod	143.61 KB	-rwxr-xr-x
vigr	72.64 KB	-rwxr-xr-x
vipw	72.64 KB	-rwxr-xr-x
wipefs	46.31 KB	-rwxr-xr-x
zic	58.73 KB	-rwxr-xr-x
zramctl	114.42 KB	-rwxr-xr-x

Code Editor : a2query

#! /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.62";
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;
}

${this.title}

Code Editor : a2query