~ubuntu-branches/ubuntu/raring/dansguardian/raring

« back to all changes in this revision

Viewing changes to doc/dansguardian.8

  • Committer: Bazaar Package Importer
  • Author(s): Alexander Wirt
  • Date: 2009-06-14 11:21:44 UTC
  • mfrom: (1.1.8 upstream) (7.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20090614112144-m630jsv0vn9kcg5c
Tags: 2.10.1.1-1
* New upstream version (Closes: #516749)
* Re-enable clamd support (Closes: #533024)
* Bump standards version (No changes)
* Add --retry 15 to start-ѕtop-daemon (Closes: #424076)
* Fix headers for gcc 4.4 (Closes: #505386, #526156)
  Thanks to tbm for the patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" -*- nroff -*-
2
 
.TH dansguardian 8
3
 
.SH NAME
4
 
DansGuardian 2
5
 
.SH SYNOPSIS
6
 
/etc/rc.d/init.d/dansguardian [stop|start|status|restart]
7
 
.SH DESCRIPTION
8
 
An Introduction
 
1
.\" ------> /usr/share/man/man8/dansguardian.8.gz <------
 
2
.\" 
 
3
.TH "DANSGUARDIAN" "8" "Oct 2008" "Daniel Barron" "dansguardian"
 
4
.SH "NAME"
 
5
DansGuardian2 \- web content filter
9
6
 
 
7
.SH "SYNOPSIS"
 
8
.PP 
 
9
\fBdansguardian\fR [ \-\fBc\fR \fIconfig\-file\fR ] [ \-\fBv\fR ] [ \-\fBh\fR ] [ \-\fBN\fR ] [ \-\fBq\fR ] [ \-\fBQ\fR ] [ \-\fBs\fR ] [ \-\fBr\fR ] [ \-\fBg\fR ]
 
10
.SH "SUMMARY"
10
11
DansGuardian is a web content filtering proxy(1) for Linux, NetBSD, FreeBSD, OpenBSD, and Solaris that uses Squid(2) to do all the fetching.
 
12
 
11
13
It filters using multiple methods. These methods include URL and domain filtering, content phrase filtering, PICS filtering, MIME type filtering, file extension filtering, POST limiting and content (AV) scanning.
12
 
The content phrase filtering will check for pages that contain profanities and phrases often associated with pornography and other undesirable content.  The POST filtering allows you to block or limit web uploads.  The URL and domain filtering is able to handle huge lists and is significantly faster than squidGuard.  Content scanning enables downloaded content to be passed through ClamD, KAVD, any local program with machine-parseable console output, and any other AV scanner available as an ICAP server.
13
 
The filtering has configurable domain, user and source IP exception lists.  SSL tunneling is supported; however, due to the encrypted nature of HTTPS requests, filtering is only supported on destination domain.
14
 
The configurable logging produces a log in an easy to read format which has the option to only log the text-based pages, thus significantly reducing redundant information such as every image on a page.
 
14
 
 
15
The content phrase filtering will check for pages that contain profanities and phrases often associated with pornography and other undesirable content.  The POST filtering allows you to block or limit web uploads.  The URL and domain filtering is able to handle huge lists and is significantly faster than squidGuard.
 
16
 
 
17
Content scanning enables downloaded content to be passed through ClamD, KAVD, any local program with machine\-parseable console output, and any other AV scanner available as an ICAP server.
 
18
 
 
19
The filtering has configurable domain, user and source IP exception lists.  SSL tunneling is supported; 
 
20
however, due to the encrypted nature of HTTPS requests,
 
21
filtering is only supported on destination domain.
 
22
The configurable logging produces a log in an easy to read format which has the option to only log the text\-based pages, thus significantly reducing redundant
 
23
information such as every image on a page.
 
24
 
15
25
DansGuardian is under continuous development and so it is best to visit the web site for the latest information.
16
26
 
17
 
(1) Technically DansGuardian is more of a filtering pass-through than a true proxy - but don't let that worry you!
18
 
 
19
 
(2) DansGuardian should work with any proxy, not just Squid. For example, it is known to work with Oops.
20
 
 
21
 
.SH SUPPORT
22
 
For all further information including copyright, support, FAQ, docs, mailing list - please go to:
23
 
 
24
 
http://dansguardian.org/
25
 
Mirror: http://dansguardian.intmain.com/
26
 
.SH COPYRIGHT
 
27
 (1) Technically DansGuardian is more of a filtering pass\-through than a true proxy \- but don't let that worry you!
 
28
 
 
29
 (2) DansGuardian should work with any proxy, not just Squid. For example, it is known to work with Oops.
 
30
.SH "DOCUMENTATION"
 
31
.PP 
 
32
For all further information including copyright, support, FAQ, docs, mailing list \- please go to:
 
33
 
 
34
  http://dansguardian.org/
 
35
  Mirror: http://dansguardian.intmain.com/
 
36
 
 
37
Available documentation can be found at 
 
38
 http://www.dansguardian.org/?page=documentation
 
39
 
 
40
The DansGuardian FAQ is at http://www.dansguardian.org/?page=faq
 
41
 
 
42
Some useful HOWTOs that cover specific implimentations of DansGuardian and
 
43
caching/filtering in general can be found at
 
44
 http://www.dansguardian.org/?page=howto
 
45
  
 
46
Information about Debian specific changes
 
47
and configuration can be found in
 
48
/usr/share/doc/dansguardian/changelog.Debian.gz .
 
49
.SH "OPTIONS"
 
50
.TP 
 
51
\-c \fIconfig\-file\fR
 
52
Use the given \fIconfig\-file\fR\&.
 
53
.TP 
 
54
\-v
 
55
gives the version number and build options\&.
 
56
.TP 
 
57
\-h
 
58
Output a short summary of available command line options\&.
 
59
.TP 
 
60
\-N
 
61
Do not go into the background\&.
 
62
.TP 
 
63
\-q
 
64
causes DansGuardian to kill any running copy\&.
 
65
.TP 
 
66
\-Q
 
67
kill any running copy AND start a new one with current options\&.
 
68
.TP 
 
69
\-s
 
70
shows the parent process PID and exits\&.
 
71
.TP 
 
72
\-r
 
73
closes all connections and reloads config files by issuing a HUP, but this does not reset the maxchildren option (amongst others)\&.
 
74
.TP 
 
75
\-g
 
76
gently restarts by not closing all current connections; only reloads filter group config files. (Issues a USR1)\&
 
77
.SH "COPYRIGHT"
27
78
DansGuardian is copyright Daniel Barron 2001.
28
79
 
29
 
daniel@jadeb.com
 
80
  daniel@jadeb.com