1P0RN-PROXY(1)                    p0rn-comfort                    P0RN-PROXY(1)
2
3
4

NAME

6       p0rn-proxy - HTTP proxy for comfortably browsing p0rn
7

SYNOPSIS

9       p0rn-proxy
10
11       [ --addr addr ] [ --configfile configfile ] [ --help ] [ --port port ]
12       [ --proxy proxy ] [ --version ]
13
14       p0rn-proxy [ -a addr ] [ -c configfile ] [ -h ] [ -p port ]
15       [ -P proxy ] [ -V ]
16

OVERVIEW

18       p0rn-proxy is a small and simple proxy written in Perl.  It adds some
19       links to the top of each HTML page that allow you to mark a page as
20       thumbnail site in order to blacklist it, as a site containing pictures
21       or as a picture site worth downloading.  It also allows you to access
22       and administrate the proxy link database.
23

DESCRIPTION

25       Just start p0rn-proxy.  This will by default create a proxy running on
26       http://localhost:8080 (it will fail if something else is already run‐
27       ning on this port).  Then point your browser to the proxy.  Browse some
28       website and see all those extra links at the top of each page.  Now
29       browse some p0rn and start blacklisting those annoying thumbnail sites
30       without real content.  After marking pages for download, run p0rn-down‐
31       load(1) to actually get them.
32
33       Switches
34
35       --addr addr ⎪ -a addr
36            This is the IP address that p0rn-proxy will bind to.  This address
37            (together with the correct port) must be configured in your
38            browser to make use of the proxy.
39
40            Be careful: Everybody who can reach the port on this address can
41            use your proxy.  You should bind to an address only reachable from
42            your local net or use a packet filter to 'guard' p0rn-proxy from
43            the outside.
44
45            The address '0.0.0.0' will bind p0rn-proxy to all of your network
46            devices.
47
48            Default is to bind to address '127.0.0.1' as this address can only
49            be accessed from your local computer and is not accessible from
50            the network.  Please take care when binding to another address.
51
52       --configfile configfile ⎪ -c configfile
53            The options from the given configuration file will be read.  These
54            options can be overridden by other command line arguments.
55
56            Default is not to read a configuration file.
57
58       --help -h
59            This prints a short help text and exits.
60
61       --port port ⎪ -p port
62            This is the port on which the proxy listens to your incoming
63            requests.  This port (together with the correct address) must be
64            configured in your browser to make use of the proxy.
65
66            Default setting is port 8080.
67
68       --proxy proxy ⎪ -P proxy
69            If this variable contains a value, the given proxy is used by
70            p0rn-proxy.  This allows you to chain multiple proxies together.
71
72            Example: If you need a proxy to access the Internet then point
73            your browser to the p0rn-proxy and in turn point p0rn-proxy to
74            your original proxy.
75
76            Set this to 'none' to use no proxy at all.
77
78            Default is to use the environment variable ${http_proxy}.
79
80       --version -V
81            This prints the current version of p0rn-proxy and exits.
82
83       Configuration file format
84
85       Configuration is also possible via configuration files.  Every command
86       line switch is possible in a configuration file.  Empty lines and lines
87       starting with # are ignored.
88
89       Instead of --port 3128 you would put this line in the configuration
90       file
91
92        port = 3128
93
94       and so on and so forth.
95

FILES

97       All data is stored in a database.  By default, it is located in
98       ./p0rn.db (yes, that's the directory from which you're starting
99       p0rn-proxy).  Is you want to change this, set the environment variable
100       P0RNDBLOCATION (the second letter is a zero) to another path and file‐
101       name.
102

SEE ALSO

104       p0rn-download(1), p0rn-dbdump(1), p0rn-dbrestore(1)
105

MODULES NEEDED

107        use AppConfig;
108        use DBM:Deep;
109        use HTTP::Daemon;
110        use LWP::UserAgent;
111
112       These modules can be obtained from <http://www.cpan.org>.
113

BUGS

115       In the default configuration, p0rn-proxy supports NO ACCESS CONTROL!
116       Everyone with access to the proxy port on your system will be able to
117       use the proxy.  Please bind p0rn-proxy to a port that is either only
118       available from your local network or protected by a packet filter.
119
120       Please report bugs by mail to <p0rn-bugs@cgarbs.de>.
121

AUTHOR

123       p0rn-proxy was written by Christian Garbs <mitch@cgarbs.de>.
124

AVAILABILITY

126       Look for updates at <http://www.cgarbs.de/p0rn-comfort.en.html>.
127
129       p0rn-proxy is licensed under the GNU GPL.
130
131
132
1330.0.4                             2004-11-20                     P0RN-PROXY(1)
Impressum