Script Tools

Macros
#define	APACHE_ARG_MAX   512
#define	AP_TRUST_CGILIKE_CL_ENVVAR   "ap_trust_cgilike_cl"

Functions
char **	ap_create_environment (apr_pool_t *p, apr_table_t *t)
int	ap_find_path_info (const char *uri, const char *path_info)
void	ap_add_cgi_vars (request_rec *r)
void	ap_add_common_vars (request_rec *r)
int	ap_scan_script_header_err (request_rec *r, apr_file_t *f, char *buffer)
int	ap_scan_script_header_err_ex (request_rec *r, apr_file_t *f, char *buffer, int module_index)
int	ap_scan_script_header_err_brigade (request_rec *r, apr_bucket_brigade *bb, char *buffer)
int	ap_scan_script_header_err_brigade_ex (request_rec *r, apr_bucket_brigade *bb, char *buffer, int module_index)
int	ap_scan_script_header_err_strs (request_rec *r, char *buffer, const char **termch, int *termarg,...)
int	ap_scan_script_header_err_strs_ex (request_rec *r, char *buffer, int module_index, const char **termch, int *termarg,...)
int	ap_scan_script_header_err_core (request_rec *r, char *buffer, int(*getsfunc)(char *, int, void *), void *getsfunc_data)
int	ap_scan_script_header_err_core_ex (request_rec *r, char *buffer, int(*getsfunc)(char *, int, void *), void *getsfunc_data, int module_index)
void	ap_args_to_table (request_rec *r, apr_table_t **table)

Detailed Description

Macro Definition Documentation

AP_TRUST_CGILIKE_CL_ENVVAR

#define AP_TRUST_CGILIKE_CL_ENVVAR   "ap_trust_cgilike_cl"

Definition at line 228 of file util_script.h.

APACHE_ARG_MAX

#define APACHE_ARG_MAX   512

Definition at line 40 of file util_script.h.

Function Documentation

ap_add_cgi_vars()

void ap_add_cgi_vars

(

request_rec *

r

)

Add CGI environment variables required by HTTP/1.1 to the request's environment table

Parameters

r	the current request

Definition at line 381 of file util_script.c.

ap_add_common_vars()

void ap_add_common_vars

(

request_rec *

r

)

Add common CGI environment variables to the requests environment table

Parameters

r	The current request

Definition at line 154 of file util_script.c.

ap_args_to_table()

void ap_args_to_table	(	request_rec *	r,
		apr_table_t **	table
	)

Parse query args for the request and store in a new table allocated from the request pool. For args with no value, "1" will be used instead. If no query args were specified, the table will be empty.

Parameters

r	The current request
table	A new table on output.

Definition at line 941 of file util_script.c.

ap_create_environment()

char ** ap_create_environment	(	apr_pool_t *	p,
		apr_table_t *	t
	)

Create an environment variable out of an Apache table of key-value pairs

Parameters

p	pool to allocate out of
t	Apache table of key-value pairs

Returns

An array containing the same key-value pairs suitable for use with an exec call.

Definition at line 112 of file util_script.c.

ap_find_path_info()

int ap_find_path_info	(	const char *	uri,
		const char *	path_info
	)

This "cute" little function comes about because the path info on filenames and URLs aren't always the same. So we take the two, and find as much of the two that match as possible.

Parameters

uri	The uri we are currently parsing
path_info	The current path info

Returns

The length of the path info

Definition at line 332 of file util_script.c.

ap_scan_script_header_err()

int ap_scan_script_header_err	(	request_rec *	r,
		apr_file_t *	f,
		char *	buffer
	)

Read headers output from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
f	The file to read from
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 751 of file util_script.c.

ap_scan_script_header_err_brigade()

int ap_scan_script_header_err_brigade	(	request_rec *	r,
		apr_bucket_brigade *	bb,
		char *	buffer
	)

Read headers output from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
bb	The brigade from which to read
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 812 of file util_script.c.

ap_scan_script_header_err_brigade_ex()

int ap_scan_script_header_err_brigade_ex	(	request_rec *	r,
		apr_bucket_brigade *	bb,
		char *	buffer,
		int	module_index
	)

Read headers output from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
bb	The brigade from which to read
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.
module_index	The module index to be used for logging

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 820 of file util_script.c.

ap_scan_script_header_err_core()

int ap_scan_script_header_err_core	(	request_rec *	r,
		char *	buffer,
		int(*)(char *, int, void *)	getsfunc,
		void *	getsfunc_data
	)

Read headers output from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.
getsfunc	Function to read the headers from. This function should act like gets()
getsfunc_data	The place to read from

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 737 of file util_script.c.

ap_scan_script_header_err_core_ex()

int ap_scan_script_header_err_core_ex	(	request_rec *	r,
		char *	buffer,
		int(*)(char *, int, void *)	getsfunc,
		void *	getsfunc_data,
		int	module_index
	)

Read headers output from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.
getsfunc	Function to read the headers from. This function should act like gets()
getsfunc_data	The place to read from
module_index	The module index to be used for logging

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

< Module has handled this stage.

RFC 2616: HTTP

< Module has handled this stage.

Definition at line 462 of file util_script.c.

ap_scan_script_header_err_ex()

int ap_scan_script_header_err_ex	(	request_rec *	r,
		apr_file_t *	f,
		char *	buffer,
		int	module_index
	)

Read headers output from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
f	The file to read from
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.
module_index	The module index to be used for logging

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 758 of file util_script.c.

ap_scan_script_header_err_strs()

int ap_scan_script_header_err_strs	(	request_rec *	r,
		char *	buffer,
		const char **	termch,
		int *	termarg,
			...
	)

Read headers strings from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.
termch	Pointer to the last character parsed.
termarg	Pointer to an int to capture the last argument parsed.

The varargs are string arguments to parse consecutively for headers, with a NULL argument to terminate the list.

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 892 of file util_script.c.

ap_scan_script_header_err_strs_ex()

int ap_scan_script_header_err_strs_ex	(	request_rec *	r,
		char *	buffer,
		int	module_index,
		const char **	termch,
		int *	termarg,
			...
	)

Read headers strings from a script, ensuring that the output is valid. If the output is valid, then the headers are added to the headers out of the current request

Parameters

r	The current request
buffer	Empty when calling the function. On output, if there was an error, the string that cause the error is stored here.
module_index	The module index to be used for logging
termch	Pointer to the last character parsed.
termarg	Pointer to an int to capture the last argument parsed.

The varargs are string arguments to parse consecutively for headers, with a NULL argument to terminate the list.

Returns

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise

Definition at line 870 of file util_script.c.