/usr/share/perl5/Dpkg/Conf.pm is in libdpkg-perl 1.18.4ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 | # Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org>
#
# 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, see <https://www.gnu.org/licenses/>.
package Dpkg::Conf;
use strict;
use warnings;
our $VERSION = '1.01';
use Dpkg::Gettext;
use Dpkg::ErrorHandling;
use parent qw(Dpkg::Interface::Storable);
use overload
'@{}' => sub { return [ $_[0]->get_options() ] },
fallback => 1;
=encoding utf8
=head1 NAME
Dpkg::Conf - parse dpkg configuration files
=head1 DESCRIPTION
The Dpkg::Conf object can be used to read options from a configuration
file. It can exports an array that can then be parsed exactly like @ARGV.
=head1 METHODS
=over 4
=item $conf = Dpkg::Conf->new(%opts)
Create a new Dpkg::Conf object. Some options can be set through %opts:
if allow_short evaluates to true (it defaults to false), then short
options are allowed in the configuration file, they should be prepended
with a single hyphen.
=cut
sub new {
my ($this, %opts) = @_;
my $class = ref($this) || $this;
my $self = {
options => [],
allow_short => 0,
};
foreach my $opt (keys %opts) {
$self->{$opt} = $opts{$opt};
}
bless $self, $class;
return $self;
}
=item @$conf
=item @options = $conf->get_options()
Returns the list of options that can be parsed like @ARGV.
=cut
sub get_options {
my $self = shift;
return @{$self->{options}};
}
=item $conf->load($file)
Read options from a file. Return the number of options parsed.
=item $conf->parse($fh)
Parse options from a file handle. Return the number of options parsed.
=cut
sub parse {
my ($self, $fh, $desc) = @_;
my $count = 0;
local $_;
while (<$fh>) {
chomp;
s/^\s+//; # Strip leading spaces
s/\s+$//; # Strip trailing spaces
s/\s+=\s+/=/; # Remove spaces around the first =
s/\s+/=/ unless m/=/; # First spaces becomes = if no =
# Skip empty lines and comments
next if /^#/ or length == 0;
if (/^-[^-]/ and not $self->{allow_short}) {
warning(g_('short option not allowed in %s, line %d'), $desc, $.);
next;
}
if (/^([^=]+)(?:=(.*))?$/) {
my ($name, $value) = ($1, $2);
$name = "--$name" unless $name =~ /^-/;
if (defined $value) {
$value =~ s/^"(.*)"$/$1/ or $value =~ s/^'(.*)'$/$1/;
push @{$self->{options}}, "$name=$value";
} else {
push @{$self->{options}}, $name;
}
$count++;
} else {
warning(g_('invalid syntax for option in %s, line %d'), $desc, $.);
}
}
return $count;
}
=item $conf->filter(remove => $rmfunc)
=item $conf->filter(keep => $keepfunc)
Filter the list of options, either removing or keeping all those that
return true when &$rmfunc($option) or &keepfunc($option) is called.
=cut
sub filter {
my ($self, %opts) = @_;
my $remove = $opts{remove} // sub { 0 };
my $keep = $opts{keep} // sub { 1 };
@{$self->{options}} = grep { not &$remove($_) and &$keep($_) }
@{$self->{options}};
}
=item $string = $conf->output($fh)
Write the options in the given filehandle (if defined) and return a string
representation of the content (that would be) written.
=item "$conf"
Return a string representation of the content.
=item $conf->save($file)
Save the options in a file.
=cut
sub output {
my ($self, $fh) = @_;
my $ret = '';
foreach my $opt ($self->get_options()) {
$opt =~ s/^--//;
if ($opt =~ s/^([^=]+)=/$1 = "/) {
$opt .= '"';
}
$opt .= "\n";
print { $fh } $opt if defined $fh;
$ret .= $opt;
}
return $ret;
}
=back
=head1 CHANGES
=head2 Version 1.01 (dpkg 1.15.8)
New method: $conf->filter()
=head2 Version 1.00 (dpkg 1.15.6)
Mark the module as public.
=head1 AUTHOR
Raphaël Hertzog <hertzog@debian.org>.
=cut
1;
|