Provided by: dbab_1.3.2-1_all bug

NAME

       dbab - dnsmasq based ad blocking

SYNOPSIS

       # start dbab-svr server
       /etc/init.d/dbab start

       # stop dbab-svr server
       /etc/init.d/dbab stop

       # get/update ad blocking list
       /usr/sbin/dbab-get-list

       # add your own to the ad blocking list
       /usr/sbin/dbab-add-list

DESCRIPTION

       dbab  provides  a total solution for SOHO service environment, smoothly
       integrates DHCP, DNS, local caching and Ad blocking  into  harmony.  Ad
       blocking is done by DNSmasq + Pixelserv, i.e., done at the DNS level --
       all requests to ad-sites are blocked right there at DNS. No  more  user
       space extensive pattern matching necessary at all. Work for your mobile
       devices as well. You don´t need to  install  anything  to  your  mobile
       devices to enjoy the ad-free and speed-up browsing.

ALTERNATIVES

       People  may also use browsers´ adblock-plus extension to block ads, but
       fewer think over how it  works  internally.  Here  is  an  overview  of
       Adblock  Plus  from  a  thousand  mile high [1] -- whenever the browser
       needs to load something, the extension  kicks  in  and  do  a  thorough
       pattern  matching  of all known ad urls using regular expressions, then
       hectically replace all found ad urls with something else. This is  done
       on  every  page, every load, and every component of the web page, using
       JavaScript. Thus it is by nature  slow  and  CPU  intensive,  at  least
       inefficient.  There  are other alternatives to this, e.g., privoxy, but
       the concepts are the same.

       [1] http://adblockplus.org/en/faq_internal

ADVANTAGES

       Comparing to other ad-blocking efforts, dbab will be super light.  Only
       a  few  operations  are  enough  to  determine  and  stop  the  ads. No
       heavy-lifting (using CPU intensive  URL  pattern  matching)  necessary.
       Thus it will be lighting fast as well.

       The advantages of using dbab are:

       ·   Work  at  the  DNS  level.  Leave the web pages intact, without any
           pattern  matching,  string  substitution,  and/or   html   elements
           replacing.

       ·   Work  for  your  mobile devices as well. Were you previously in the
           dilemma of choosing ads free  or  slow  response  for  your  mobile
           devices  (iphone,  ipad,  etc)?  Now  you  don´t. You don´t need to
           install any thing to your mobile devices  for  them  to  enjoy  the
           ad-free  browsing  experience.  Moreover, their browsing speed will
           increase dramatically on revisited pages/images.

       ·   Serve instantly. All ads will be replaced by a 1x1 pixel gif  image
           served locally by the dbab-svr server.

       ·   Maintenance  free.  You don´t need to maintain the list of ad sites
           yourself. The  block  list  can  be  downloaded  from  pgl.yoyo.org
           periodically.  If you don´t like some of the entries there, you can
           add-to or remove-from that list easily.

DBAB-SVR

       The dbab-svr is a super minimal web server  /  pixelserv,  it  has  one
       purpose  of serving a 1x1 pixel transparent gif file. It can optionally
       provide the automatic WPAD service as well if so configured. By default
       it listens on localhost.

DBAB-GET-LIST

       The   dbab-get-list   is   used  to  get  dnsmasq  blocking  list  from
       pgl.yoyo.org  to  be  used  by  DNSmasq.  The  result  is   stored   as
       /etc/dnsmasq.d/dbab.adblock.conf.

       You  can run it once, or put it in a cron job so as to update the block
       list periodically. E.g., to update on a weekly basis:

           ln -s /usr/sbin/dbab-get-list /etc/cron.weekly/

DBAB-ADD-LIST

       You can use dbab-add-list to add your own entries to  dnsmasq  blocking
       list,  if  the  list  from  pgl.yoyo.org is not sufficient for you. The
       result is stored as /etc/dnsmasq.d/dbab.trashsites.conf.

DBAB-CHK-LIST

       The dbab-chk-list can help you to check if your  own  list  is  already
       covered by pgl.yoyo.org.

DHCP-ADD-WPAD

       he  dhcp-add-wpad  will take the content in /etc/dbab/dbab.proxy as the
       host name of the squid caching server, as well as taking the content in
       /etc/dbab/dbab.addr  as  the IP address of dhcp server, then enable the
       automatic WPAD service within the system, with the help of the DNS  and
       DHCP server.

FILES

       /etc/dbab/dbab.addr:
              The IP address that dbab-svr listens on. Defaults to localhost.

       /etc/dbab/dbab.list-:
              The  entries you want to filter out from the pgl.yoyo.org lists.
              List sites you still wish to visit there.

       /etc/dbab/dbab.list+:
              The entries you want to add to  blocking  list  on  top  of  the
              pgl.yoyo.org list, used by dbab-add-list.

       /etc/dbab/dbab.proxy:
              The name or IP address of your squid caching server. Defaults to
              localhost.

       /usr/share/doc/dbab/dbab.md:
              The more detailed introduction and installation guild.

AUTHOR(S)

       Copyright: 2013~2015 Tong SUN,  suntong001  from  users.sourceforge.net
       License: BSD-3-Clause

       The pixelserv was originally downloaded from
       http://proxytunnel.sourceforge.net/files/pixelserv.pl.txt
       Wrote by Piet Wintjens, with BSD (no advertising clause) license.

                                 December 2015                         DBAB(8)