debian man page for ns_setlocationproc

Ns_Location(3aolserver) 				   AOLserver Library Procedures 				   Ns_Location(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME
       Ns_SetConnLocationProc, Ns_SetLocationProc - Set the location procedure to use

SYNOPSIS
       #include "ns.h"

       void
       Ns_SetConnLocationProc(Ns_LocationProc *procPtr)

       void
       Ns_SetLocationProc(char *ignored, Ns_LocationProc *procPtr)
_________________________________________________________________

DESCRIPTION
       These  functions  set  the  procedure  to  run  when  a call to Ns_ConnLocation is made. The location is defined in the form METHOD://HOST-
       NAME:PORT, e.g. http://myhost.com:8443.

       Setting the location procedure with these functions will cause all calls to Ns_ConnLocation  to	use  the  location  procedure  you  define
       instead of using the location procedure callback in the communication module for the connection.

       There  may  be  cases  where you want to do this. For example, you could create a location procedure that reports on the values returned by
       communication module location procedure callbacks. At the end of that procedure, you could then return that value after logging the  infor-
       mation making your location procedure is effectively transparent to the server and other modules.

       Ns_SetConnLocationProc(procPtr)

	      Set the function to use when Ns_ConnLocation is called. This function is deprecated. Use Ns_SetLocationProc instead.

       Ns_SetLocationProc(ignored, procPtr)

	      Set the function to use when Ns_ConnLocation is called. The ignored argument is reserved for future use.

SEE ALSO
       nsd(1), info(n), Ns_ConnLocation(3)

KEYWORDS
AOLserver								4.0						   Ns_Location(3aolserver)