Script Tools
[Apache Core]

マクロ定義
#define	APACHE_ARG_MAX   512
関数
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_brigade (request_rec *r, apr_bucket_brigade *bb, char *buffer)
int	ap_scan_script_header_err_strs (request_rec *r, char *buffer, 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)

---

関数

void ap_add_cgi_vars

(

request_rec *

r

)

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

引数:

r

the current request void ap_add_cgi_vars(request_rec *r)

void ap_add_common_vars

(

request_rec *

r

)

Add common CGI environment variables to the requests environment table

引数:

r

The current request void ap_add_common_vars(request_rec *r)

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

引数:

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

戻り値:

An array containing the same key-value pairs suitable for use with an exec call. char **ap_create_environment(apr_pool_t *p, apr_table_t *t)

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.

引数:

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

戻り値:

The length of the path info int ap_find_path_info(const char *uri, const char *path_info)

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

引数:

	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.

戻り値:

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise int ap_scan_script_header_err(request_rec *r, apr_file_t *f, char *buffer)

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

引数:

	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.

戻り値:

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise int ap_scan_script_header_err_brigade(request_rec *r, apr_bucket_brigade *bb, char *buffer)

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

引数:

	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

戻り値:

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise 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_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

引数:

	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.
	args	String arguments to parse consecutively for headers, a NULL argument terminates the list.

戻り値:

HTTP_OK on success, HTTP_INTERNAL_SERVER_ERROR otherwise int ap_scan_script_header_err_core(request_rec *r, char *buffer, int (*getsfunc)(char *, int, void *), void *getsfunc_data)

---