From owner-dev-commits-ports-all@freebsd.org Fri May 7 09:53:29 2021 Return-Path: Delivered-To: dev-commits-ports-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2D81C5FD9FA; Fri, 7 May 2021 09:53:29 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Fc5P469s8z3tYv; Fri, 7 May 2021 09:53:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id AA9CA1151; Fri, 7 May 2021 09:53:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1479rSBo084554; Fri, 7 May 2021 09:53:28 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1479rSgM084553; Fri, 7 May 2021 09:53:28 GMT (envelope-from git) Date: Fri, 7 May 2021 09:53:28 GMT Message-Id: <202105070953.1479rSgM084553@gitrepo.freebsd.org> To: ports-committers@FreeBSD.org, dev-commits-ports-all@FreeBSD.org, dev-commits-ports-main@FreeBSD.org From: Po-Chuan Hsieh Subject: git: f4447578de42 - main - www/tinyproxy: Use pre-built manpages from release tarball MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: sunpoet X-Git-Repository: ports X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f4447578de42db80fb5ed804c36c617452294877 Auto-Submitted: auto-generated X-BeenThere: dev-commits-ports-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the ports repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 May 2021 09:53:29 -0000 The branch main has been updated by sunpoet: URL: https://cgit.FreeBSD.org/ports/commit/?id=f4447578de42db80fb5ed804c36c617452294877 commit f4447578de42db80fb5ed804c36c617452294877 Author: Po-Chuan Hsieh AuthorDate: 2021-05-07 09:20:09 +0000 Commit: Po-Chuan Hsieh CommitDate: 2021-05-07 09:38:59 +0000 www/tinyproxy: Use pre-built manpages from release tarball - Bump PORTREVISION for package change --- www/tinyproxy/Makefile | 11 +- www/tinyproxy/files/patch-configure | 114 ------- www/tinyproxy/files/tinyproxy.8 | 165 ---------- www/tinyproxy/files/tinyproxy.conf.5 | 563 ----------------------------------- 4 files changed, 6 insertions(+), 847 deletions(-) diff --git a/www/tinyproxy/Makefile b/www/tinyproxy/Makefile index 46c7430a9fcc..9c73671950ba 100644 --- a/www/tinyproxy/Makefile +++ b/www/tinyproxy/Makefile @@ -2,9 +2,9 @@ PORTNAME= tinyproxy PORTVERSION= 1.11.0 -MASTER_SITES= https://github.com/tinyproxy/tinyproxy/releases/download/${PORTVERSION}/ PORTEPOCH= 1 CATEGORIES= www +MASTER_SITES= https://github.com/tinyproxy/tinyproxy/releases/download/${PORTVERSION}/ MAINTAINER= sunpoet@FreeBSD.org COMMENT= Small, efficient HTTP proxy server @@ -15,6 +15,7 @@ LICENSE_FILE= ${WRKSRC}/COPYING USES= gmake tar:xz CONFIGURE_ARGS= --bindir=${PREFIX}/sbin \ + --disable-manpage_support \ --program-transform-name="" GNU_CONFIGURE= yes USE_RC_SUBR= tinyproxy @@ -30,14 +31,14 @@ XHEADER_CONFIGURE_ENABLE= xtinyproxy post-patch: @${REINPLACE_CMD} -e 's|tinyproxy/tinyproxy|tinyproxy|g; s|/etc/tinyproxy|${PREFIX}&|' \ - ${WRKSRC}/docs/man5/tinyproxy.conf.txt.in \ - ${WRKSRC}/docs/man8/tinyproxy.txt.in \ + ${WRKSRC}/docs/man5/tinyproxy.conf.5 \ + ${WRKSRC}/docs/man8/tinyproxy.8 \ ${WRKSRC}/etc/tinyproxy.conf.in @${REINPLACE_CMD} -e '/\/usr\/share\/tinyproxy/d; s|^#\(LogFile \)|\1|; s|^#\(PidFile \)|\1|' ${WRKSRC}/etc/tinyproxy.conf.in post-install: ${MV} ${STAGEDIR}${PREFIX}/etc/tinyproxy.conf ${STAGEDIR}${PREFIX}/etc/tinyproxy.conf.sample - ${INSTALL_MAN} ${FILESDIR}/tinyproxy.conf.5 ${STAGEDIR}${PREFIX}/share/man/man5/ - ${INSTALL_MAN} ${FILESDIR}/tinyproxy.8 ${STAGEDIR}${PREFIX}/share/man/man8/ + ${INSTALL_MAN} ${WRKSRC}/docs/man5/tinyproxy.conf.5 ${STAGEDIR}${PREFIX}/share/man/man5/ + ${INSTALL_MAN} ${WRKSRC}/docs/man8/tinyproxy.8 ${STAGEDIR}${PREFIX}/share/man/man8/ .include diff --git a/www/tinyproxy/files/patch-configure b/www/tinyproxy/files/patch-configure deleted file mode 100644 index cc2a38c9d245..000000000000 --- a/www/tinyproxy/files/patch-configure +++ /dev/null @@ -1,114 +0,0 @@ ---- configure.orig 2021-04-16 12:31:44 UTC -+++ configure -@@ -627,9 +627,6 @@ LTLIBOBJS - HAVE_GPERF_FALSE - HAVE_GPERF_TRUE - GPERF --HAVE_POD2MAN_FALSE --HAVE_POD2MAN_TRUE --POD2MAN - ADDITIONAL_OBJECTS - LIBOBJS - HAVE_MANPAGE_INTEREST_FALSE -@@ -5974,67 +5971,6 @@ rm -f core conftest.err conftest.$ac_objext \ - - - --if test x"$manpage_support_enabled" = x"yes"; then --# Extract the first word of "pod2man", so it can be a program name with args. --set dummy pod2man; ac_word=$2 --{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 --$as_echo_n "checking for $ac_word... " >&6; } --if ${ac_cv_path_POD2MAN+:} false; then : -- $as_echo_n "(cached) " >&6 --else -- case $POD2MAN in -- [\\/]* | ?:[\\/]*) -- ac_cv_path_POD2MAN="$POD2MAN" # Let the user override the test with a path. -- ;; -- *) -- as_save_IFS=$IFS; IFS=$PATH_SEPARATOR --for as_dir in $PATH --do -- IFS=$as_save_IFS -- test -z "$as_dir" && as_dir=. -- for ac_exec_ext in '' $ac_executable_extensions; do -- if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then -- ac_cv_path_POD2MAN="$as_dir/$ac_word$ac_exec_ext" -- $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 -- break 2 -- fi --done -- done --IFS=$as_save_IFS -- -- test -z "$ac_cv_path_POD2MAN" && ac_cv_path_POD2MAN="no" -- ;; --esac --fi --POD2MAN=$ac_cv_path_POD2MAN --if test -n "$POD2MAN"; then -- { $as_echo "$as_me:${as_lineno-$LINENO}: result: $POD2MAN" >&5 --$as_echo "$POD2MAN" >&6; } --else -- { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 --$as_echo "no" >&6; } --fi -- -- -- --if test "x$POD2MAN" = "xno" && \ -- ! test -e docs/man5/tinyproxy.conf.5 -a -e docs/man8/tinyproxy.8 ; then --as_fn_error $? " -- manpage generation requested, but neither pod2man -- nor pre-generated manpages found. -- Use --disable-manpage-support if you want to compile anyway." "$LINENO" 5 --fi --fi #manpage_support_enabled -- -- if test "x$POD2MAN" != "x" -a "x$POD2MAN" != "xno"; then -- HAVE_POD2MAN_TRUE= -- HAVE_POD2MAN_FALSE='#' --else -- HAVE_POD2MAN_TRUE='#' -- HAVE_POD2MAN_FALSE= --fi -- -- - # Extract the first word of "gperf", so it can be a program name with args. - set dummy gperf; ac_word=$2 - { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 -@@ -6249,10 +6185,6 @@ if test -z "${am__fastdepCC_TRUE}" && test -z "${am__f - as_fn_error $? "conditional \"am__fastdepCC\" was never defined. - Usually this means the macro was only invoked conditionally." "$LINENO" 5 - fi --if test -z "${HAVE_POD2MAN_TRUE}" && test -z "${HAVE_POD2MAN_FALSE}"; then -- as_fn_error $? "conditional \"HAVE_POD2MAN\" was never defined. --Usually this means the macro was only invoked conditionally." "$LINENO" 5 --fi - if test -z "${HAVE_GPERF_TRUE}" && test -z "${HAVE_GPERF_FALSE}"; then - as_fn_error $? "conditional \"HAVE_GPERF\" was never defined. - Usually this means the macro was only invoked conditionally." "$LINENO" 5 -@@ -7594,22 +7526,4 @@ fi - if test -n "$ac_unrecognized_opts" && test "$enable_option_checking" != no; then - { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: unrecognized options: $ac_unrecognized_opts" >&5 - $as_echo "$as_me: WARNING: unrecognized options: $ac_unrecognized_opts" >&2;} --fi -- -- --# the manpages are shipped in the release tarball and we don't want them to --# get regenerated if pod2man is not available. the intermediate files from --# AC_CONFIG_FILES are created with config.status, which is created at configure --# runtime, so we need to touch them after config.status terminated to prevent --# make from rebuild them. -- --if test "x$POD2MAN" = "xno" ; then -- touch docs/man5/tinyproxy.conf.txt -- touch docs/man8/tinyproxy.txt -- if test -e docs/man5/tinyproxy.conf.5 ; then -- touch docs/man5/tinyproxy.conf.5 -- fi -- if test -e docs/man8/tinyproxy.8 ; then -- touch docs/man8/tinyproxy.8 -- fi - fi diff --git a/www/tinyproxy/files/tinyproxy.8 b/www/tinyproxy/files/tinyproxy.8 deleted file mode 100644 index 5ea772a2d635..000000000000 --- a/www/tinyproxy/files/tinyproxy.8 +++ /dev/null @@ -1,165 +0,0 @@ -'\" t -.\" Title: tinyproxy -.\" Author: [see the "AUTHOR" section] -.\" Generator: DocBook XSL Stylesheets v1.79.1 -.\" Date: 01/06/2019 -.\" Manual: Tinyproxy manual -.\" Source: Version 1.10.0 -.\" Language: English -.\" -.TH "TINYPROXY" "8" "01/06/2019" "Version 1\&.10\&.0" "Tinyproxy manual" -.\" ----------------------------------------------------------------- -.\" * Define some portability stuff -.\" ----------------------------------------------------------------- -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" http://bugs.debian.org/507673 -.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -tinyproxy \- A light\-weight HTTP proxy daemon -.SH "SYNOPSIS" -.sp -\fBtinyproxy\fR [\-vldch] -.SH "DESCRIPTION" -.sp -\fBtinyproxy\fR is a light\-weight HTTP proxy daemon designed to consume a minimum amount of system resources\&. It listens on a given TCP port and handles HTTP proxy requests\&. Designed from the ground up to be fast and yet small, it is an ideal solution for use cases such as embedded deployments where a full featured HTTP proxy is required, but the system resources for a larger proxy are unavailable\&. -.SH "OPTIONS" -.sp -\fBtinyproxy\fR accepts the following options: -.PP -\fB\-c \fR -.RS 4 -Use an alternate configuration file\&. -.RE -.PP -\fB\-d\fR -.RS 4 -Don\(cqt daemonize and stay in the foreground\&. Useful for debugging purposes\&. -.RE -.PP -\fB\-h\fR -.RS 4 -Display a short help screen of command line arguments and exit\&. -.RE -.PP -\fB\-v\fR -.RS 4 -Display version information and exit\&. -.RE -.SH "SIGNALS" -.sp -In addition to command\-line options, there are also several signals that can be sent to \fBtinyproxy\fR while it is running to generate debugging information and to force certain events\&. -.PP -\fBSIGHUP\fR -.RS 4 -Force 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\&. -.RE -.SH "TEMPLATE FILES" -.sp -There are two occasions when Tinyproxy delivers HTML pages to the client on it\(cqs own right: -.sp -.RS 4 -.ie n \{\ -\h'-04' 1.\h'+01'\c -.\} -.el \{\ -.sp -1 -.IP " 1." 4.2 -.\} -When an error occurred, a corresponding error page is returned\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04' 2.\h'+01'\c -.\} -.el \{\ -.sp -1 -.IP " 2." 4.2 -.\} -When a request for the stathost is made, a page summarizing the connection statistics is returned\&. (See STATHOST below\&.) -.RE -.sp -The layout of both error pages and the statistics page can be controlled via configurable HTML template files that are plain HTML files that additionally understand a few template variables\&. -.SH "TEMPLATE VARIABLES" -.sp -There are several standard HTML variables that are available in every template file: -.PP -\fBrequest\fR -.RS 4 -The full HTTP request line\&. -.RE -.PP -\fBcause\fR -.RS 4 -The abbreviated cause of the error condition\&. -.RE -.PP -\fBclientip\fR -.RS 4 -The IP address of the client making the request\&. -.RE -.PP -\fBclienthost\fR -.RS 4 -The hostname of the client making the request\&. -.RE -.PP -\fBversion\fR -.RS 4 -The version of Tinyproxy\&. -.RE -.PP -\fBpackage\fR -.RS 4 -The package name\&. Presently, resolves to -\fItinyproxy\fR\&. -.RE -.PP -\fBdate\fR -.RS 4 -The current date/time in HTTP format\&. -.RE -.sp -In addition, almost all templates support: -.PP -\fBdetail\fR -.RS 4 -A detailed, plain English explanation of the error and possible causes\&. -.RE -.sp -When Tinyproxy finds a variable name enclosed in braces, e\&.g\&. "{request}", then this is replaced by the value of the corresponding variable before delivery of the page\&. -.SH "STATHOST" -.sp -Tinyproxy returns a HTML page with connection statistics when it receives a HTTP request for a certain host \(em the stathost\&. The stathost name defaults to tinyproxy\&.stats and can be changed at runtime to any name or IP address with the configuration variable StatHost\&. -.sp -The stat file template can be changed at runtime through the configuration variable StatFile\&. -.SH "FILES" -.sp -/usr/local/etc/tinyproxy\&.conf, /var/run/tinyproxy\&.pid, /var/log/tinyproxy\&.log -.SH "BUGS" -.sp -To report bugs in Tinyproxy, please visit \&. -.SH "SEE ALSO" -.sp -tinyproxy\&.conf(5) -.SH "AUTHOR" -.sp -This manpage was written by the Tinyproxy project team\&. -.SH "COPYRIGHT" -.sp -Copyright (c) 1998\-2018 the Tinyproxy authors\&. -.sp -This program is distributed under the terms of the GNU General Public License version 2 or above\&. See the COPYING file for additional information\&. diff --git a/www/tinyproxy/files/tinyproxy.conf.5 b/www/tinyproxy/files/tinyproxy.conf.5 deleted file mode 100644 index 5548827c5da9..000000000000 --- a/www/tinyproxy/files/tinyproxy.conf.5 +++ /dev/null @@ -1,563 +0,0 @@ -'\" t -.\" Title: tinyproxy.conf -.\" Author: [see the "AUTHOR" section] -.\" Generator: DocBook XSL Stylesheets v1.79.1 -.\" Date: 01/06/2019 -.\" Manual: Tinyproxy manual -.\" Source: Version 1.10.0 -.\" Language: English -.\" -.TH "TINYPROXY\&.CONF" "5" "01/06/2019" "Version 1\&.10\&.0" "Tinyproxy manual" -.\" ----------------------------------------------------------------- -.\" * Define some portability stuff -.\" ----------------------------------------------------------------- -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" http://bugs.debian.org/507673 -.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -tinyproxy.conf \- Tinyproxy HTTP proxy daemon configuration file -.SH "SYNOPSIS" -.sp -\fBtinyproxy\&.conf\fR -.SH "DESCRIPTION" -.sp -tinyproxy(8) reads its configuration file, typically stored in /usr/local/etc/tinyproxy\&.conf (or passed to Tinyproxy with \-c on the command line)\&. This manpage describes the syntax and contents of the configuration file\&. -.sp -The Tinyproxy configuration file contains key\-value pairs, one per line\&. Lines starting with # and empty lines are comments and are ignored\&. Keywords are case\-insensitive, whereas values are case\-sensitive\&. Values may be enclosed in double\-quotes (") if they contain spaces\&. -.sp -The possible keywords and their descriptions are as follows: -.PP -\fBUser\fR -.RS 4 -The user which the Tinyproxy process should run as, after the initial port\-binding has been done as the -root -user\&. Either the user name or the UID may be specified\&. -.RE -.PP -\fBGroup\fR -.RS 4 -The group which the Tinyproxy process should run as, after the initial port\-binding has been done as the -root -user\&. Either the group name or the GID may be specified\&. -.RE -.PP -\fBPort\fR -.RS 4 -The port which the Tinyproxy service will listen on\&. If the port is less than 1024, you will need to start the Tinyproxy process as the -root -user\&. -.RE -.PP -\fBListen\fR -.RS 4 -By default, Tinyproxy listens for connections on all available interfaces (i\&.e\&. it listens on the wildcard address -0\&.0\&.0\&.0)\&. With this configuration parameter, Tinyproxy can be told to listen only on one specific address\&. -.RE -.PP -\fBBind\fR -.RS 4 -This allows you to specify which address Tinyproxy will bind to for outgoing connections to web servers or upstream proxies\&. -.RE -.PP -\fBBindSame\fR -.RS 4 -If this boolean parameter is set to -yes, then Tinyproxy will bind the outgoing connection to the IP address of the incoming connection that triggered the outgoing request\&. -.RE -.PP -\fBTimeout\fR -.RS 4 -The maximum number of seconds of inactivity a connection is allowed to have before it is closed by Tinyproxy\&. -.RE -.PP -\fBErrorFile\fR -.RS 4 -This parameter controls which HTML file Tinyproxy returns when a given HTTP error occurs\&. It takes two arguments, the error number and the location of the HTML error file\&. -.RE -.PP -\fBDefaultErrorFile\fR -.RS 4 -This parameter controls the HTML template file returned when an error occurs for which no specific error file has been set\&. -.RE -.PP -\fBStatHost\fR -.RS 4 -This configures the host name or IP address that is treated as the -stat host: Whenever a request for this host is received, Tinyproxy will return an internal statistics page instead of forwarding the request to that host\&. The template for this page can be configured with the -StatFile -configuration option\&. The default value of -StatHost -is -tinyproxy\&.stats\&. -.RE -.PP -\fBStatFile\fR -.RS 4 -This configures the HTML file that Tinyproxy sends when a request for the stathost is received\&. If this parameter is not set, Tinyproxy returns a hard\-coded basic statistics page\&. See the STATHOST section in the -tinyproxy(8) -manual page for details\&. - -Note that the StatFile and the error files configured with ErrorFile and DefaultErrorFile are template files that can contain a few template variables that Tinyproxy expands prior to delivery\&. Examples are "{cause}" for an abbreviated error description and "{detail}" for a detailed error message\&. The -tinyproxy(8) -manual page contains a description of all template variables\&. -.RE -.PP -\fBLogFile\fR -.RS 4 -This controls the location of the file to which Tinyproxy writes its debug output\&. Alternatively, Tinyproxy can log to syslog \(em see the Syslog option\&. -.RE -.PP -\fBSyslog\fR -.RS 4 -When set to -On, this option tells Tinyproxy to write its debug messages to syslog instead of to a log file configured with -LogFile\&. These two options are mutually exclusive\&. -.RE -.PP -\fBLogLevel\fR -.RS 4 -Sets the log level\&. Messages from the set level and above are logged\&. For example, if the LogLevel was set to Warning, then all log messages from Warning to Critical would be output, but Notice and below would be suppressed\&. Allowed values are: -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Critical (least verbose) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Error -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Warning -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Notice -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Connect (log connections without Info\(cqs noise) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -Info (most verbose) -.RE -.RE -.PP -\fBPidFile\fR -.RS 4 -This option controls the location of the file where the main Tinyproxy process stores its process ID for signaling purposes\&. -.RE -.PP -\fBXTinyproxy\fR -.RS 4 -Setting this option to -Yes -tells Tinyproxy to add a header -X\-Tinyproxy -containing the client\(cqs IP address to the request\&. -.RE -.PP -\fBUpstream\fR -.RS 4 -This option allows you to set up a set of rules for deciding whether an upstream proxy server is to be used, based on the host or domain of the site being accessed\&. The rules are stored in the order encountered in the configuration file and the LAST matching rule wins\&. The following forms for specifying upstream rules exist: -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIupstream type host:port\fR -turns proxy upstream support on generally\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIupstream type user:pass@host:port\fR -does the same, but uses the supplied credentials for authentication\&. -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIupstream type host:port "site_spec"\fR -turns on the upstream proxy for the sites matching -site_spec\&. -.sp -.if n \{\ -.RS 4 -.\} -.nf -`type` can be one of `http`, `socks4`, `socks5`, `none`\&. -.fi -.if n \{\ -.RE -.\} -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIupstream none "site_spec"\fR -turns off upstream support for sites matching -site_spec\&. -.sp -.if n \{\ -.RS 4 -.\} -.nf -The site can be specified in various forms as a hostname, domain -name or as an IP range: -.fi -.if n \{\ -.RE -.\} -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIname\fR -matches host exactly -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fI\&.name\fR -matches any host in domain "name" -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fI\&.\fR -matches any host with no domain (in -\fIempty\fR -domain) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIIP/bits\fR -matches network/mask -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fIIP/mask\fR -matches network/mask -.RE -.RE -.PP -\fBMaxClients\fR -.RS 4 -Tinyproxy creates one child process for each connected client\&. This options specifies the absolute highest number processes that will be created\&. With other words, only MaxClients clients can be connected to Tinyproxy simultaneously\&. -.RE -.PP -\fBMinSpareServers\fR, \fBMaxSpareServers\fR -.RS 4 -Tinyproxy always keeps a certain number of idle child processes so that it can handle new incoming client requests quickly\&. -MinSpareServer -and -MaxSpareServers -control the lower and upper limits for the number of spare processes\&. I\&.e\&. when the number of spare servers drops below -MinSpareServers -then Tinyproxy will start forking new spare processes in the background and when the number of spare processes exceeds -MaxSpareServers -then Tinyproxy will kill off extra processes\&. -.RE -.PP -\fBStartServers\fR -.RS 4 -The number of servers to start initially\&. This should usually be set to a value between MinSpareServers and MaxSpareServers\&. -.RE -.PP -\fBMaxRequestsPerChild\fR -.RS 4 -This limits the number of connections that a child process will handle before it is killed\&. The default value is -0 -which disables this feature\&. This option is meant as an emergency measure in the case of problems with memory leakage\&. In that case, setting -MaxRequestsPerChild -to a value of e\&.g\&. 1000, or 10000 can be useful\&. -.RE -.PP -\fBAllow\fR, \fBDeny\fR -.RS 4 -The -Allow -and -Deny -options provide a means to customize which clients are allowed to access Tinyproxy\&. -Allow -and -Deny -lines can be specified multiple times to build the access control list for Tinyproxy\&. The order in the config file is important\&. If there are no -Allow -or -Deny -lines, then all clients are allowed\&. Otherwise, the default action is to deny access\&. The argument to -Allow -or -Deny -can be a single IP address of a client host, like -127\&.0\&.0\&.1, an IP address range, like -192\&.168\&.0\&.1/24 -or a string that will be matched against the end of the client host name, i\&.e, this can be a full host name like -host\&.example\&.com -or a domain name like -\&.example\&.com -or even a top level domain name like -\&.com\&. -.RE -.PP -\fBAddHeader\fR -.RS 4 -Configure one or more HTTP request headers to be added to outgoing HTTP requests that Tinyproxy makes\&. Note that this option will not work for HTTPS traffic, as Tinyproxy has no control over what headers are exchanged\&. -.RE -.sp -.if n \{\ -.RS 4 -.\} -.nf -AddHeader "X\-My\-Header" "Powered by Tinyproxy" -.fi -.if n \{\ -.RE -.\} -.PP -\fBViaProxyName\fR -.RS 4 -RFC 2616 requires proxies to add a -Via -header to the HTTP requests, but using the real host name can be a security concern\&. If the -ViaProxyname -option is present, then its string value will be used as the host name in the Via header\&. Otherwise, the server\(cqs host name will be used\&. -.RE -.PP -\fBDisableViaHeader\fR -.RS 4 -When this is set to yes, Tinyproxy does NOT add the -Via -header to the requests\&. This virtually puts Tinyproxy into stealth mode\&. Note that RFC 2616 requires proxies to set the -Via -header, so by enabling this option, you break compliance\&. Don\(cqt disable the -Via -header unless you know what you are doing\&... -.RE -.PP -\fBFilter\fR -.RS 4 -Tinyproxy supports filtering of web sites based on URLs or domains\&. This option specifies the location of the file containing the filter rules, one rule per line\&. -.RE -.PP -\fBFilterURLs\fR -.RS 4 -If this boolean option is set to -Yes -or -On, filtering is performed for URLs rather than for domains\&. The default is to filter based on domains\&. -.RE -.PP -\fBFilterExtended\fR -.RS 4 -If this boolean option is set to -Yes, then extended POSIX regular expressions are used for matching the filter rules\&. The default is to use basic POSIX regular expressions\&. -.RE -.PP -\fBFilterCaseSensitive\fR -.RS 4 -If this boolean option is set to -Yes, then the filter rules are matched in a case sensitive manner\&. The default is to match case\-insensitively\&. -.RE -.PP -\fBFilterDefaultDeny\fR -.RS 4 -The default filtering policy is to allow everything that is not matched by a filtering rule\&. Setting -FilterDefaultDeny -to -Yes -changes the policy do deny everything but the domains or URLs matched by the filtering rules\&. -.RE -.PP -\fBAnonymous\fR -.RS 4 -If an -Anonymous -keyword is present, then anonymous proxying is enabled\&. The headers listed with -Anonymous -are allowed through, while all others are denied\&. If no Anonymous keyword is present, then all headers are allowed through\&. You must include quotes around the headers\&. - -Most sites require cookies to be enabled for them to work correctly, so you will need to allow cookies through if you access those sites\&. - -Example: -.RE -.sp -.if n \{\ -.RS 4 -.\} -.nf -Anonymous "Host" -Anonymous "Authorization" -Anonymous "Cookie" -.fi -.if n \{\ -.RE -.\} -.PP -\fBConnectPort\fR -.RS 4 -This option can be used to specify the ports allowed for the CONNECT method\&. If no -ConnectPort -line is found, then all ports are allowed\&. To disable CONNECT altogether, include a single ConnectPort line with a value of -0\&. -.RE -.PP -\fBReversePath\fR -.RS 4 -Configure one or more ReversePath directives to enable reverse proxy support\&. With reverse proxying it\(cqs possible to make a number of sites appear as if they were part of a single site\&. - -If you uncomment the following two directives and run Tinyproxy on your own computer at port 8888, you can access example\&.com, using -http://localhost:8888/example/\&. -.RE -.sp -.if n \{\ -.RS 4 -.\} -.nf -ReversePath "/example/" "http://www\&.example\&.com/" -.fi -.if n \{\ -.RE -.\} -.PP -\fBReverseOnly\fR -.RS 4 -When using Tinyproxy as a reverse proxy, it is STRONGLY recommended that the normal proxy is turned off by setting this boolean option to -Yes\&. -.RE -.PP -\fBReverseMagic\fR -.RS 4 -Setting this option to -Yes, makes Tinyproxy use a cookie to track reverse proxy mappings\&. If you need to reverse proxy sites which have absolute links you must use this option\&. -.RE -.PP -\fBReverseBaseURL\fR -.RS 4 -The URL that is used to access this reverse proxy\&. The URL is used to rewrite HTTP redirects so that they won\(cqt escape the proxy\&. If you have a chain of reverse proxies, you\(cqll need to put the outermost URL here (the address which the end user types into his/her browser)\&. If this option is not set then no rewriting of redirects occurs\&. -.RE -.SH "BUGS" -.sp -To report bugs in Tinyproxy, please visit \&. -.SH "SEE ALSO" -.sp -tinyproxy(8) -.SH "AUTHOR" -.sp -This manpage was written by the Tinyproxy project team\&. -.SH "COPYRIGHT" -.sp -Copyright (c) 1998\-2018 the Tinyproxy authors\&. -.sp -This program is distributed under the terms of the GNU General Public License version 2 or above\&. See the COPYING file for additional information\&.