1DANSGUARDIAN(8)                  dansguardian                  DANSGUARDIAN(8)
2
3
4

NAME

6       DansGuardian2 - web content filter
7
8

SYNOPSIS

10       dansguardian [ -c config-file ] [ -v ] [ -h ] [ -N ] [ -q ] [ -Q ] [ -s
11       ] [ -r ] [ -g ]
12

SUMMARY

14       DansGuardian is a web content filtering  proxy(1)  for  Linux,  NetBSD,
15       FreeBSD,  OpenBSD,  and Solaris that uses Squid(2) to do all the fetch‐
16       ing.
17
18       It filters using multiple methods. These methods include URL and domain
19       filtering,  content phrase filtering, PICS filtering, MIME type filter‐
20       ing, file extension filtering, POST limiting and content (AV) scanning.
21
22       The content phrase filtering will check for pages that contain profani‐
23       ties  and  phrases often associated with pornography and other undesir‐
24       able content.  The POST filtering allows you  to  block  or  limit  web
25       uploads.  The URL and domain filtering is able to handle huge lists and
26       is significantly faster than squidGuard.
27
28       Content scanning enables downloaded content to be passed through ClamD,
29       KAVD,  any local program with machine-parseable console output, and any
30       other AV scanner available as an ICAP server.
31
32       The filtering has configurable domain, user  and  source  IP  exception
33       lists.   SSL  tunneling  is  supported;  however,  due to the encrypted
34       nature of HTTPS requests, filtering is only  supported  on  destination
35       domain.   The  configurable  logging  produces a log in an easy to read
36       format which has the option to only log the text-based pages, thus sig‐
37       nificantly  reducing  redundant  information  such  as every image on a
38       page.
39
40       DansGuardian is under continuous development and so it is best to visit
41       the web site for the latest information.
42
43        (1)  Technically DansGuardian is more of a filtering pass-through than
44       a true proxy - but don't let that worry you!
45
46        (2) DansGuardian should work with any proxy, not just Squid. For exam‐
47       ple, it is known to work with Oops.
48

DOCUMENTATION

50       For  all  further  information including copyright, support, FAQ, docs,
51       mailing list - please go to:
52
53         http://dansguardian.org/
54         Mirror: http://dansguardian.intmain.com/
55
56       Available documentation can be found at
57        http://www.dansguardian.org/?page=documentation
58
59       The DansGuardian FAQ is at http://www.dansguardian.org/?page=faq
60
61       Some useful HOWTOs that cover specific implimentations of  DansGuardian
62       and caching/filtering in general can be found at
63        http://www.dansguardian.org/?page=howto
64
65       Information  about  Debian  specific  changes  and configuration can be
66       found in /usr/share/doc/dansguardian/changelog.Debian.gz .
67

OPTIONS

69       -c config-file
70              Use the given config-file.
71
72       -v     gives the version number and build options.
73
74       -h     Output a short summary of available command line options.
75
76       -N     Do not go into the background.
77
78       -q     causes DansGuardian to kill any running copy.
79
80       -Q     kill any running copy AND start a new one with current options.
81
82       -s     shows the parent process PID and exits.
83
84       -r     closes all connections and reloads config  files  by  issuing  a
85              HUP,  but  this  does  not reset the maxchildren option (amongst
86              others).
87
88       -g     gently restarts by not closing  all  current  connections;  only
89              reloads filter group config files. (Issues a USR1)
90

92       DansGuardian is copyright Daniel Barron 2001.
93
94         daniel@jadeb.com
95
96
97
98Daniel Barron                      Oct 2008                    DANSGUARDIAN(8)
Impressum