Return to redirect.8 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / thttpd / cgi-src

Annotation of embedaddon/thttpd/cgi-src/redirect.8, revision 1.1.1.1

1.1       misho       1: .TH redirect 8 "23 September 1995"
                      2: .SH NAME
                      3: redirect - simple redirection CGI program
                      4: .SH SYNOPSIS
                      5: .B redirect
                      6: .SH DESCRIPTION
                      7: .PP
                      8: Three steps to set up a redirection:
                      9: .PP
                     10: 1. Make sure your web server is set up to allow CGI programs.
                     11: .PP
                     12: 2. Make a symbolic link from the file or directory you want to redirect,
                     13: pointing at this program in the CGI bin directory.
                     14: .PP
                     15: 3. Add an entry to the file ".redirects" in the directory where your
                     16: http server runs CGI programs.  For most servers, this is the
                     17: directory where the given CGI program lives.  The format of the
                     18: file is a bunch of lines with a filename, whitespace, and the new
                     19: URL.  For example:
                     20: .nf
                     21:   /test/oldfile.html    http://www.acme.com/test/newfile.html
                     22: .fi
                     23: The easiest way to figure out precisely what filename to put into .redirects
                     24: is to set up the symlink and then click on it.
                     25: You'll get back a "404 Not Found" page which includes the filename
                     26: as received by the redirect program, and that's what you want to use.
                     27: .PP
                     28: You can also add a wildcard specification to redirect whole groups of files.
                     29: For example:
                     30: .nf
                     31:   /wildtest/*          http://www.acme.com/test-
                     32: .fi
                     33: will cause an access to the /wildtest/somefile.html to be redirected to
                     34: http://www.acme.com/test-somefile.html. (Note that the asterisk need not
                     35: be preceded by a slash.)
                     36: .PP
                     37: Note: this is designed for thttpd (http://www.acme.com/software/thttpd/)
                     38: and using it with other web servers may require some hacking.  A possible
                     39: gotcha is with the symbolic link from the old file pointing at this
                     40: script - servers other than thttpd may not allow that link to be run
                     41: as a CGI program, because they don't check the link to see that it
                     42: points into the allowed CGI directory.
                     43: .SH "SEE ALSO"
                     44: thttpd(8)
                     45: .SH "BUGS / DEFICIENCIES"
                     46: .PP
                     47: It would be really cool to have this program look for
                     48: the .redirects file in the same directory as the file being redirected,
                     49: instead of in the binaries directory.  Unfortunately, this appears
                     50: to be impossible with the information CGI gives, plus the non-standardized
                     51: but widespread practice of running CGI programs in the directory where
                     52: the binary lives.  Perhaps CGI 1.2 will address this.
                     53: .PP
                     54: The wildcard mechanism is very primitive.
                     55: In particular, any characters that follow the asterisk are blithely
                     56: ignored.
                     57: .SH AUTHOR
                     58: Copyright © 1995 by Jef Poskanzer <jef@mail.acme.com>.
                     59: All rights reserved.
                     60: .\" Redistribution and use in source and binary forms, with or without
                     61: .\" modification, are permitted provided that the following conditions
                     62: .\" are met:
                     63: .\" 1. Redistributions of source code must retain the above copyright
                     64: .\"    notice, this list of conditions and the following disclaimer.
                     65: .\" 2. Redistributions in binary form must reproduce the above copyright
                     66: .\"    notice, this list of conditions and the following disclaimer in the
                     67: .\"    documentation and/or other materials provided with the distribution.
                     68: .\" 
                     69: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
                     70: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     71: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     72: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
                     73: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     74: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     75: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     76: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     77: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     78: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     79: .\" SUCH DAMAGE.