File: INSTALL

package info (click to toggle)
polipo 1.1.1-5~bpo70%2B1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy-backports
  • size: 1,204 kB
  • sloc: ansic: 20,882; python: 238; sh: 234; makefile: 139
file content (72 lines) | stat: -rw-r--r-- 2,029 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
Polipo installation instructions
================================

1. Building and running polipo
------------------------------

    $ make all
    $ su -c 'make install'
    $ man polipo
    $ polipo &

If you want Polipo to put itself into the background, you may replace
the last line with:

    $ polipo daemonise=true logFile="/var/log/polipo.log"

On SVR4 systems (Solaris, HP/UX), you will need to use one of the
following (whichever works):

    $ make PLATFORM_DEFINES=-DSVR4 all
    $ make PLATFORM_DEFINES=-DSVR4 LDLIBS='-lsocket -lnsl -lresolv' all

You can also use Polipo without installing:

    $ make
    $ nroff -man polipo.man | more
    $ ./polipo &

For information about building on Windows, please see the file README.Windows.

2. Configuring your user-agent
------------------------------

Once polipo is running, configure your user-agent (web browser) to use
the proxy on `http://localhost:8123/'.  Depending on the user-agent,
this is done either by setting the environment variable http_proxy,
e.g.

    $ http_proxy=http://localhost:8123; export http_proxy

or by using the browser's ``preferences'' menu.

3. Configuring polipo
---------------------

If you want to use an on-disk cache, you will need to create its root
directory:

    $ mkdir /var/cache/polipo/

You should then arrange for cron to run the following on a regular
basis:

    killall -USR1 polipo
    sleep 1
    polipo -x
    killall -USR2 polipo

If you want to use a configuration file, you should put it in one of
the locations `/etc/polipo/config' or `~/.polipo'; you can also use
the `-c' flag to put it in a non-standard location.  See the file
`config.sample' for an example.

You might also want to create a forbidden URLs file, which you should
put either in one of `/etc/polipo/forbidden' or `~/.polipo-forbidden';
you can set the variable `forbiddenFile' in your config file if you
want to put it in a non-standard location.  See `forbidden.sample' for
an example.


Juliusz Chroboczek
<jch@pps.univ-paris-diderot.fr>