url_lfs_rewrite - rewriter based on local file existence
url_lfs_rewrite [--debug] --local-dir=/var/www/ [options]
User Contributed Perl Documentation URL_LFS_REWRITE(8)
NAME
url_lfs_rewrite - a URL-rewriter based on local file existence
SYNOPSIS
url_lfs_rewrite [--debug] --local-dir=/var/www/ [options]
DESCRIPTION
Direct all request to files who are in a local directory to a local web
server hosting this directory.
This program uses Squid concurrency support.
OPTIONS
--debug Write debug info to stderr.
--local-dir Directory path under which the scripts searches for files.
--to-scheme Scheme to use for the redirected URL.
Default: http
--to-host Domain name to use for the redirected URL.
Default: localhost
--to-path URL path to add as prefix for the redirected URL path.
If set it must end with a '/'.
Default: use the original URL path.
KNOWN ISSUES
* The --local-dir parameter must end with a '/'. Otherwise no
file paths will be found.
* URL with no filename in the path can match directories on the local
filesystem and be wrongly redirected to the local web server.
* Any scheme name accepted by the Perl URL library can be used
as the --to-scheme parameter. However only schemes supported by
Squid will work.
* URL containing query-string are not handled well and will not
be rewritten even if the base script or file exists on the local
system.
CONFIGURATION
url_rewrite_program /path/to/url_lfs_rewrite --local-dir=\var\www\localhost
url_rewrite_children 20 startup=1 idle=1 concurrency=25
url_rewrite_access deny CONNECT
url_rewrite_access deny to_localhost
This helper can redirect to any web server but only does so if there is
a file matching the URL path segment in the local filesystem. Normal
configuration requires a web server running on localhost serving up
files from a local disk (eg. \var\www\localhost). Configuration of that
web server is not covered here.
AUTHOR
This program and documentation was written by Amos Jeffries
<squid3@treenet.co.nz>
Based on prior work in rredir.pl by Peter Eisenhauer
<pe@pipetronix.de>. First Version: 26. May 1997
COPYRIGHT
* Copyright (C) 1996-2021 The Squid Software Foundation and contributors
*
* Squid software is distributed under GPLv2+ license and includes
* contributions from numerous individuals and organizations.
* Please see the COPYING and CONTRIBUTORS files for details.
REPORTING BUGS
Bug reports need to be made in English. See
http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what
you need to include with your bug report.
Report bugs or bug fixes using http://bugs.squid-cache.org/
Report serious security bugs to Squid Bugs
<squid-bugs@lists.squid-cache.org>
Report ideas for new improvements to the Squid Developers mailing list
<squid-dev@lists.squid-cache.org>
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | web/proxy/squid |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
squid (8), GPL (7),
The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
The Squid Configuration Manual http://www.squid-cache.org/Doc/config/
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from http://www.squid-
cache.org/Versions/v4/squid-4.15.tar.xz.
Further information about this software can be found on the open source
community website at http://www.squid-cache.org/.
perl v5.32.0 2022-06-28 URL_LFS_REWRITE(8)