diff --git a/Changes b/Changes index 5302bc0..06e0cdc 100755 --- a/Changes +++ b/Changes @@ -1,5 +1,8 @@ Revision history for Perl module Net::DNS::Dynamic::Adfilter +0.067 Mon Jun 11 10:22:02 EDT 2012 + - fix addressing/sharing of dns server + 0.066 Sun May 27 08:32:24 EDT 2012 - parse adblock plus subscription links, add whitelist capability, add data::dumper method diff --git a/README b/README new file mode 100644 index 0000000..ad27aac --- /dev/null +++ b/README @@ -0,0 +1,14 @@ +Net::DNS::Dynamic::Adfilter - A DNS ad filter + +This is a DNS server intended for use as an ad filter for a local area network. +Its function is to load lists of ad domains and nullify DNS queries for those +domains to the loopback address. + +The module loads externally maintained lists of ad hosts intended for use by +Adblock Plus, a popular ad filtering extension for the Firefox browser. A +locally maintained blacklist/whitelist can also be loaded. + +Once running, local network dns queries can be addressed to the host's ip. This +ip is echoed to stdout. + +See sample script: scripts/adfilter.pl diff --git a/dist.ini b/dist.ini index 65ada06..10df19f 100644 --- a/dist.ini +++ b/dist.ini @@ -1,18 +1,18 @@ name = Net-DNS-Dynamic-Adfilter -version = 0.066 +version = 0.067 author = David Watson license = Perl_5 copyright_holder = David Watson [GatherDir] [MetaJSON] +[MetaYAML] [MakeMaker] [Manifest] [PruneCruft] [PruneFiles] match = dist.ini [License] -[Readme] [PkgVersion] [PodVersion] [AutoPrereqs] diff --git a/lib/Net/DNS/Dynamic/adfilter.pm b/lib/Net/DNS/Dynamic/adfilter.pm index f039e11..8a1d5ed 100644 --- a/lib/Net/DNS/Dynamic/adfilter.pm +++ b/lib/Net/DNS/Dynamic/adfilter.pm @@ -200,8 +200,8 @@ Adblock Plus, a popular ad filtering extension for the Firefox browser. Use of the lists focuses only on third-party listings, since these generally define dedicated ad/tracking hosts. -A local addendum of hosts can also be specified. In this case, host listings -must conform to a one host per line format. +A locally maintained blacklist/whitelist can also be loaded. In this case, host +listings must conform to a one host per line format. Once running, local network dns queries can be addressed to the host's ip. This ip is echoed to stdout. @@ -242,9 +242,9 @@ a path string that defines where the module will write a local copy of the list; a refresh value that determines what age (in days) the local copy may be before it is refreshed. -There are dozens of adblock plus filters scattered throughout the internet. You can -load them all if you like, though doing so may defeat your purpose. One or two, such -as those listed above, should suffice. +There are dozens of adblock plus filters scattered throughout the internet. +You can load as many as you like, though one or two lists such as those listed +above should suffice. A collection of lists is available at http://adblockplus.org/en/subscriptions. The module will accept standard or abp:subscribe? urls. You can cut and paste @@ -260,8 +260,8 @@ encoded subscription links directly. ); The blacklist hashref contains only a path string that defines where the module will -access an addendum of ad hosts to nullify. As mentioned above, a single column is the only -acceptable format: +access a local list of ad hosts to nullify. As mentioned above, a single column is the +only acceptable format: # ad nauseam googlesyndication.com