send_req(Url::string(), Headers::headerList(), Method::method(), Body::body(), Options::optionList()) -> response()
- optionList() = [option()] -
- option() = {max_sessions, integer()} | {response_format, response_format()} | {stream_chunk_size, integer()} | {max_pipeline_size, integer()} | {trace, boolean()} | {is_ssl, boolean()} | {ssl_options, [SSLOpt]} | {pool_name, atom()} | {proxy_host, string()} | {proxy_port, integer()} | {proxy_user, string()} | {proxy_password, string()} | {use_absolute_uri, boolean()} | {basic_auth, {username(), password()}} | {cookie, string()} | {content_length, integer()} | {content_type, string()} | {save_response_to_file, srtf()} | {stream_to, stream_to()} | {http_vsn, {MajorVsn, MinorVsn}} | {host_header, string()} | {inactivity_timeout, integer()} | {connect_timeout, integer()} | {socket_options, Sock_opts} | {transfer_encoding, {chunked, ChunkSize}} +
- option() = {max_sessions, integer()} | {response_format, response_format()} | {stream_chunk_size, integer()} | {max_pipeline_size, integer()} | {trace, boolean()} | {is_ssl, boolean()} | {ssl_options, [SSLOpt]} | {pool_name, atom()} | {proxy_host, string()} | {proxy_port, integer()} | {proxy_user, string()} | {proxy_password, string()} | {use_absolute_uri, boolean()} | {basic_auth, {username(), password()}} | {cookie, string()} | {content_length, integer()} | {content_type, string()} | {save_response_to_file, srtf()} | {stream_to, stream_to()} | {http_vsn, {MajorVsn, MinorVsn}} | {host_header, string()} | {inactivity_timeout, integer()} | {connect_timeout, integer()} | {socket_options, Sock_opts} | {transfer_encoding, {chunked, ChunkSize}} | {headers_as_is, boolean()} | {give_raw_headers, boolean()}
- stream_to() = process() | {process(), once}
- process() = pid() | atom()
- username() = string() @@ -220,14 +219,14 @@ send_req/4, send_req/5, send_req/6. For a description of SSL Options, look in the ssl manpage. If the HTTP Version to use is not specified, the default is 1.1.
- The
host_headeroption is useful in the case where ibrowse is connecting to a component such as stunnel which then sets up a secure connection to a webserver. In this case, the URL supplied to ibrowse must have the stunnel host/port details, but that won't make sense to the destination webserver. This option can then be used to specify what should go in theHostheader in - the request. --
+ the request.
- The
stream_tooption can be used to have the HTTP response streamed to a process as messages as data arrives on the socket. If the calling process wishes to control the rate at which @@ -272,11 +271,20 @@ send_req/4, send_req/5, send_req/6. request to complete will be 1000 milliseconds minus the time taken for connection setup.
- - The
socket_optionsoption can be used to set specific options on the socket. The{active, true | false | once}and{packet_type, Packet_type}will be filtered out by ibrowse.
+
+ - The
headers_as_isoption is to enable the caller + to send headers exactly as specified in the request without ibrowse + adding some of its own. Required for some picky servers apparently.
+
+ - The
give_raw_headersoption is to enable the + caller to get access to the raw status line and raw unparsed + headers. Not quite sure why someone would want this, but one of my + users asked for it, so here it is.
+
-
The host_header option is useful in the case where ibrowse is
+
-
+
send_req/6
@@ -340,15 +348,20 @@ send_req/4, send_req/5, send_req/6. spawn_worker_process/2 or spawn_link_worker_process/2 is not included. -spawn_link_worker_process/2
+spawn_link_worker_process/1
-
spawn_link_worker_process(Host, Port) -> any()
-Same as spawn_worker_process/2 except the the calling process +
spawn_link_worker_process(Url::string()) -> {ok, pid()}
+Same as spawn_worker_process/1 except the the calling process is linked to the worker process which is spawned.
-spawn_worker_process/2
+spawn_link_worker_process/2
-
+
+spawn_worker_process(Host::string(), Port::integer()) -> {ok, pid()}
+spawn_link_worker_process(Host::string(), Port::integer()) -> {ok, pid()}
+spawn_worker_process/1
+
+
spawn_worker_process(Url::string()) -> {ok, pid()}
Creates a HTTP client process to the specified Host:Port which is not part of the load balancing pool. This is useful in cases where some requests to a webserver might take a long time whereas @@ -362,6 +375,11 @@ send_req/4, send_req/5, send_req/6.
pipeline size on such connections. +spawn_worker_process/2
+
+
+
spawn_worker_process(Host::string(), Port::integer()) -> {ok, pid()}
+start/0
start() -> any()
@@ -423,6 +441,6 @@ send_req/4, send_req/5, send_req/6.-
Generated by EDoc, Sep 5 2009, 23:59:48.
+Generated by EDoc, May 17 2010, 23:21:42.