bionic (3) Ns_ConnRedirect.3aolserver.gz

NAME

       Ns_ConnRedirect - Internally redirect a request to a new local url

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConnRedirect(conn, url)

ARGUMENTS

       Ns_Conn   conn   (in)      Pointer to open connection.

       char      *url   (in)      Pointer to string of local url.
_________________________________________________________________

DESCRIPTION

       This  routine  can  be  used  to internally redirect to a new, local url on the server.  The url paramter
       specifies a path relative to the server, i.e.,  without  the  leading  "http://host:port"  portion.   The
       server  will  reset  the  Ns_Request  structure  in  the  open  connection pointed to by conn and restart
       connection handling, including  authorization  checks.   The  result  is  a  standard  AOLserver  request
       procedure  result  code,  either from an underlying call to Ns_ConnRunRequest or the result of one of the
       authorization response routines such as Ns_ConnReturnForbidden.  Filter callbacks, if any,  are  not  run
       again with the updated connection.

       The  Ns_ConnRedirect  routine  is  used  internally  in the server to support the basic file serving code
       (i.e.,  "fastpath")  to  redirect  to  specific  files  when  a  directory   is   opened   and   by   the
       Ns_RegisterRedirect routine to map standard reponse routines to user-provided local url's.

EXAMPLE

       The  following  example  demonstrates  redirecting  to  an  ADP help page within a custom C-level request
       callback whenever a ?help=topic query argument is present:

                int
                MyRequest(void *arg, Ns_Conn *conn)
                {
                   Ns_Set *query = Ns_ConnGetQuery(conn);

                   /* Redirect to help.adp for /myrequest?help=topic calls. */
                   if (Ns_SetGet(query, "help")) != NULL) {
                     return Ns_ConnReturnRedirect(conn, "/help.adp");
                   }
                   ...  handle non-help requests ...
                }

SEE ALSO

       Ns_RegisterRedirct(3), Ns_ConnRunRequest(3), Ns_AuthorizeRequest(3)

KEYWORDS

       connection, redirect