ns_conndrivercontext(3aolserv) [debian man page]

Ns_ConnDriver(3aolserver)				   AOLserver Library Procedures 				 Ns_ConnDriver(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_ConnDriverContext, Ns_ConnDriverName - Routines to access communication driver data

SYNOPSIS

       #include "ns.h"

       void *
       Ns_ConnDriverContext(conn)

       char *
       Ns_ConnDriverName(conn)

ARGUMENTS

       Ns_Conn	 conn	(in)	  Pointer to open connection.
_________________________________________________________________

DESCRIPTION

       These functions provide access to the underyling communications driver data for an open connection.

       char *Ns_ConnDriverName(conn)
	      Returns  the string name of the communication driver, e.g., "nssock".  This is the name passed in the Ns_DriverInitData structure in
	      a call to Ns_DriverInit, not the module name for the particular instance of the loaded driver.

       void *Ns_ConnDriverContent(conn)
	      Returns a pointer to the connection-specific driver context for the given connection.  This value is that of the arg element of  the
	      underlying  Ns_Sock  structure allocated by the server and used by communication drivers to manage private state.  If the connection
	      is closed, the value returned is always NULL.

SEE ALSO

       Ns_DriverInit(3)

KEYWORDS

       connection, context

AOLserver								4.0						 Ns_ConnDriver(3aolserver)

Ns_ConnReturn(3aolserver)				   AOLserver Library Procedures 				 Ns_ConnReturn(3aolserver)

__________________________________________________________________________________________________________________________________________________

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 spe-
       cific 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

AOLserver								4.0						 Ns_ConnReturn(3aolserver)