url — specifies URL address for retrieval
<url [ method="{ GET | POST | HEAD }" ] [ payload="STRING" ] [ payloadparam="STRING" ] [ payloadparamcount="INTEGER" ] [ payloadtemplate="STRING" ] [ responsename="STRING" ] [ responsetemplate="STRING" ] [ responsescript="STRING" ] [ requesttemplate="STRING" ] [ requestparamcount="INTEGER" ] [ predelay="INTEGER" ] [ predelayprecision="INTEGER" ] [ postdelay="INTEGER" ] [ postdelayprecision="INTEGER" ] [ user="STRING" ] [ password="STRING" ] [ Content-Type="STRING" ]> [ STRING</url> ]
name | type | description | default value |
---|---|---|---|
method | STRING | This attribute specifies HTTP method used in request. Valid values include: GET, POST, HEAD. | GET |
payload | STRING | This attribute specifies POST request body. Contents of this attribute are sent raw as POST request body, so they need to be properly encoded. | (empty) |
payloadparam | STRING | No information available at this time | (empty) |
payloadparamcount | INTEGER | No information available at this time | 0 |
payloadtemplate | STRING | This attribute holds POST request body, that will be searched for variables. Every variable found will be expanded to it's value. | (empty) |
responsename | STRING | This attribute sets the name of variable, that will be created upon successful match of responsetemplate. | (empty) |
responsetemplate | STRING | This attribute holds regular expression that will be matched against response. If successful, resulting string will be placed in newly created variable, whose name is determined by responsename attribute. | (empty) |
responsescript | STRING | This attribute holds path to executable script, that will be used in response postprocessing. Such script schould read standard input, which will contain server response (both HTTP headers and response body). Script exit value of 0 means success, while any other value means error. | (empty) |
requesttemplate | STRING | This attribute holds the URL address, that will be searched for variables. Every variable found will be expanded to it's value. Presence of this attribute makes url an empty element, becasue content of this attribute is used as request URL. | (empty) |
requestparamcount | INTEGER | No information available at this time | 0 |
predelay | INTEGER | No information available at this time | 0 |
predelayprecision | INTEGER | No information available at this time | 0 |
postdelay | INTEGER | No information available at this time | 0 |
postdelayprecision | INTEGER | No information available at this time | 0 |
user | STRING | This attribute holds username for auth (401 header). | (empty) |
password | STRING | This attribute holds password for auth (401 header). | (empty) |
Content-Type | STRING | This attribute (when present) overrides default Content-Type header which is 'application/x-www-form-urlencoded'. | (empty) |
This element is the basic data unit of flood. It contains detailed description of url address scheduled for retrieval. You can specify how to perform request (method, optional payload) and how to postprocess response.
When using responsescript attribute, please keep in mind, that the execution time of script might distort overall results. In addition, please add following element to your profile:
<recv_resp>generic_fullresp_recv_resp</recv_resp>
This wil cause flood to fetch whole response every time. Without such element flood could sometimes retrieve only first chunk of data, which just isn't enough for valid postprocessing.