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)