filter.c File Reference

#include "nsd.h"

Data Structures
struct	Filter
struct	Trace
Functions
void *	Ns_RegisterFilter (char *server, char *method, char *url, Ns_FilterProc *proc, int when, void *arg)
int	NsRunFilters (Ns_Conn *conn, int why)
void *	Ns_RegisterServerTrace (char *server, Ns_TraceProc *proc, void *arg)
void *	Ns_RegisterConnCleanup (char *server, Ns_TraceProc *proc, void *arg)
void *	Ns_RegisterCleanup (Ns_TraceProc *proc, void *arg)
void	NsRunTraces (Ns_Conn *conn)
void	NsRunCleanups (Ns_Conn *conn)

---

Function Documentation

void* Ns_RegisterCleanup	(	Ns_TraceProc *	proc,
		void *	arg
	)

void* Ns_RegisterConnCleanup	(	char *	server,
		Ns_TraceProc *	proc,
		void *	arg
	)

---------------------------------------------------------------------- Ns_RegisterCleanup, Ns_RegisterConnCleanup --

Register a connection cleanup trace procedure. Traces registered with this procedure are always called in LIFO order at the end of connection no matter the result code from the connection's request procedure (i.e., the procs are called even if the client drops connection).

Results: Pointer to trace.

Side effects: Proc will be called in LIFO order at end of all connections.

----------------------------------------------------------------------

void* Ns_RegisterFilter	(	char *	server,
		char *	method,
		char *	url,
		Ns_FilterProc *	proc,
		int	when,
		void *	arg
	)

---------------------------------------------------------------------- Ns_RegisterFilter --

Register a filter function to handle a method/URL combination.

Results: Returns a pointer to an opaque object that contains the filter information.

Side effects: None.

----------------------------------------------------------------------

void* Ns_RegisterServerTrace	(	char *	server,
		Ns_TraceProc *	proc,
		void *	arg
	)

---------------------------------------------------------------------- Ns_RegisterServerTrace --

Register a connection trace procedure. Traces registered with this procedure are only called in FIFO order if the connection request procedure successfully responds to the clients request.

Results: Pointer to trace.

Side effects: Proc will be called in FIFO order at end of successfull connections.

----------------------------------------------------------------------

void NsRunCleanups

(

Ns_Conn *

conn

)

int NsRunFilters	(	Ns_Conn *	conn,
		int	why
	)

---------------------------------------------------------------------- NsRunFilters --

Execute each registered filter function in the Filter list.

Results: Returns the status returned from the registered filter function.

Side effects: None.

----------------------------------------------------------------------

void NsRunTraces

(

Ns_Conn *

conn

)

---------------------------------------------------------------------- RunTraces, NsRunTraces, NsRunCleanups --

Execute each registered trace.

Results: None.

Side effects: Depends on registered traces, if any.

----------------------------------------------------------------------

---