forked from jech/polipo
-
Notifications
You must be signed in to change notification settings - Fork 2
/
polipo2.man
94 lines (94 loc) · 2.07 KB
/
polipo2.man
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.TH POLIPO 1
.SH NAME
polipo2 \- a caching web proxy
.SH SYNOPSIS
.B polipo
[
.B \-h
|
.B \-v
|
.B \-x
] [
.B \-c
.I config
] [
.IB var=val
]...
.SH DESCRIPTION
Polipo2 is a caching HTTP proxy. It listens to requests for web pages
from your browser and forwards them to web servers, and forwards the
servers' replies to your browser. In the process, it optimises and
cleans up the network traffic.
.PP
By default, Polipo2 listens on TCP port 8123. Please configure your
web browser to use the proxy on
.B localhost
port 8123.
.SH OPTIONS
.TP
.B \-h
Display help and exit.
.TP
.B \-v
Display the list of configuration variables and exit.
.TP
.B \-x
Purge the on-disk cache and exit.
.TP
.B \-c
Select an alternate configuration file.
.TP
.IB var = val
Change the value of a configuration variable.
.SH FILES
.TP
.B /etc/polipo2/config
The default location of Polipo2's configuration file.
.TP
.B /etc/polipo2/forbidden
The default location of the list of forbidden URLs.
.TP
.B /var/cache/polipo2/
The default location of the on-disk cache.
.TP
.B /usr/share/polipo2/www/
The default root of the local web space.
.SH SIGNALS
.TP
.B SIGUSR1
write out all in-memory objects to disk and reload the forbidden URLs file.
.TP
.B SIGUSR2
write out all in-memory objects to disk, discard all in-memory
objects, and reload the forbidden URLs file.
.TP
.B SIGTERM, SIGINT, SIGHUP
write out all in-memory objects to disk and quit.
.SH SECURITY
The internal web server will follow symbolic links that point outside
the local document tree. You should run Polipo2 in a chroot jail if that
is a problem.
.PP
There is no reason to run Polipo2 as root.
.SH FULL DOCUMENTATION
The full manual for Polipo2 is maintained in a texinfo file, and is
normally available through a web server internal to Polipo2. Please
make sure that Polipo2 is running, and point your favourite web browser
at
.IP
http://localhost:8123/
.PP
Alternatively, you may type
.IP
$ info polipo
.PP
at a shell prompt, or
.IP
C-h i m polipo2 RET
.PP
in
.BR Emacs .
.SH AUTHOR
Polipo was written by Juliusz Chroboczek.
Polipo2 is maintained by Silas S. Brown.