122 lines
3.4 KiB
Groff
122 lines
3.4 KiB
Groff
|
.\" -*- nroff -*-
|
||
|
|
.\"
|
||
|
|
.\" tinyproxy.1
|
||
|
|
.\"
|
||
|
|
.\" Copyright (c) 1999, Robert James Kaes, Steven Young.
|
||
|
|
.\"
|
||
|
|
.\" This program is distributed under the terms of the GNU General Public
|
||
|
|
.\" License. See COPYING for additional information.
|
||
|
|
.\"
|
||
|
|
.TH tinyproxy 1 "December 23, 1999" "tinyproxy" "tinyproxy Manual"
|
||
|
|
.SH NAME
|
||
|
|
tinyproxy \- a small HTTP proxy server
|
||
|
|
.SH SYNOPSIS
|
||
|
|
tinyproxy [options]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B tinyproxy
|
||
|
|
is an HTTP proxy server designed to consume a minimum of system resources.
|
||
|
|
It listens on a given TCP port and handles HTTP proxy requests.
|
||
|
|
.SH OPTIONS
|
||
|
|
.TP 5
|
||
|
|
.B \-v
|
||
|
|
Display version information and exit.
|
||
|
|
.TP 5
|
||
|
|
.B \-h
|
||
|
|
Display a short help screen of command line arguments and exit.
|
||
|
|
.TP 5
|
||
|
|
.B \-d
|
||
|
|
Don't daemonize; stay in the foreground.
|
||
|
|
.TP 5
|
||
|
|
.B "\-n ip_address"
|
||
|
|
Allow access from only those hosts in the subnet.
|
||
|
|
.I ip_address
|
||
|
|
should be of a form xxx.xxx.xxx. like 192.168.0.
|
||
|
|
.TP 5
|
||
|
|
.BI "\-i ip_address"
|
||
|
|
Only listen to the specific address. Useful for systems with more than one
|
||
|
|
network connection.
|
||
|
|
.I ip_address
|
||
|
|
needs to be in the dotted-decimal form (e.g. 192.168.0.1)
|
||
|
|
.TP 5
|
||
|
|
.BI "\-p port"
|
||
|
|
Listen to
|
||
|
|
.I port
|
||
|
|
instead of the default as defined in config.h.
|
||
|
|
.TP 5
|
||
|
|
.BI "\-l logfile"
|
||
|
|
Log to the file
|
||
|
|
.I logfile
|
||
|
|
instead of the default as defined in config.h.
|
||
|
|
.TP 5
|
||
|
|
.BI \-r
|
||
|
|
Restrict the log file to only logging error conditions. The hosts connecting
|
||
|
|
and the locations being accessed are not logged.
|
||
|
|
.TP 5
|
||
|
|
.B \-S
|
||
|
|
Log to the syslog daemon
|
||
|
|
.TP 5
|
||
|
|
.BI "\-a headername"
|
||
|
|
Allow the header
|
||
|
|
.I headername
|
||
|
|
through to the server (anon mode only). It is highly recommended that you
|
||
|
|
specify -a Host: and -a Authorization:, otherwise HTTP/1.1 virtual domains
|
||
|
|
and basic authentication will fail. If anon mode is compiled into the
|
||
|
|
program, but you do not provide a
|
||
|
|
.I headername
|
||
|
|
tinyproxy will run as if anon mode was not compiled in.
|
||
|
|
.TP 5
|
||
|
|
.BI "\-w loadaverage"
|
||
|
|
Stop handling requests when the load is
|
||
|
|
.I loadaverage
|
||
|
|
or higher. Specifying a
|
||
|
|
.I loadaverage
|
||
|
|
of 0.00 will disable this feature.
|
||
|
|
(disabled by default)
|
||
|
|
.TP 5
|
||
|
|
.BI "\-u username"
|
||
|
|
Begin running as
|
||
|
|
.I username
|
||
|
|
after the port has been bound and the logfile has been opened. Only
|
||
|
|
works if tinyproxy is being run as root. "" to disable.
|
||
|
|
.SH SIGNALS
|
||
|
|
In addition to these command line options, there are also several signals
|
||
|
|
that can be sent to tinyproxy while it is running to generate debugging
|
||
|
|
information and to force certain events.
|
||
|
|
.TP 5
|
||
|
|
.B SIGUSR1
|
||
|
|
Dump a summary of all current connections to the logfile.
|
||
|
|
.TP 5
|
||
|
|
.B SIGHUP
|
||
|
|
Force
|
||
|
|
.B tinyproxy
|
||
|
|
to do a garbage collection on the current connections linked list. This
|
||
|
|
is usually done automatically after a certain number of connections have
|
||
|
|
been handled.
|
||
|
|
.SH FILES
|
||
|
|
.SM /var/log/tinyproxy.log
|
||
|
|
.SH AUTHORS
|
||
|
|
Steven Young (sdyoung@well.com)
|
||
|
|
.PP
|
||
|
|
Robert James Kaes (rjkaes@flarenet.com)
|
||
|
|
.SH BUGS
|
||
|
|
For some reason, when sent SIGTERM,
|
||
|
|
.B tinyproxy
|
||
|
|
occasionally waits for the
|
||
|
|
next incoming connection before exiting. We believe this bug has
|
||
|
|
been corrected, but please e-mail the authors if you see this
|
||
|
|
behaviour occurring.
|
||
|
|
.SH COPYRIGHT
|
||
|
|
.B tinyproxy
|
||
|
|
is distributed under the GNU Public License (GPL). For more information
|
||
|
|
on the GPL, please see the file COPYING which should have been included in
|
||
|
|
the archive with tinyproxy. Failing that, http://www.fsf.org/ will
|
||
|
|
doubtless have a copy up for you to peruse. Please don't use this
|
||
|
|
software if you don't agree to the terms specified therein.
|
||
|
|
.SH AVAILABILITY
|
||
|
|
The latest version of
|
||
|
|
.B tinyproxy
|
||
|
|
can be acquired from:
|
||
|
|
.PP
|
||
|
|
http://www.flarenet.com/tinyproxy/
|
||
|
|
http://tinyproxy.attacca.com/
|