SendHeader

From Wiki
Revision as of 14:09, 9 August 2005 by Kedrick Valorite (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

#sendHeader

Result System Variables

Description

The system variable #sendHeader is a variable that lets you add additional header lines to the post request sent by the send command. Each line must be finished with a $ to mark the end.

set #sendheader content-type: , #spc , blabla$line2: , #spc , blabla2$<pre>

If #sendheader doesn't contain any $ signs at all then no additional lines will be added to the header. Setting #sendheader to $$$ will obviously mess up the outgoing packet so that is not recommended.

First let's look at EUO default format for http requests:

<pre>; test1
send debugHTTPPost localhost /euo/action.php?getVar=getValue postVar=postValue
halt

Outgoing HTTP request:

POST /euo/action.php?getvar=getvalue HTTP/1.0 Host: localhost Content-Length: 17 postVar=postValue

Supposing you want your HTTP request to be identifiied as issued by EasyUO by adding the directive "User-Agent: EasyUO #cliVer" to the HTTP header:

; test2
set #sendHeader User-Agent: , #spc , EasyUO , #spc , #cliVer , $
send debugHTTPPost localhost /euo/action.php?getVar=getValue postVar=postValue
halt

Outgoing HTTP request:

POST /euo/action.php?getvar=getvalue HTTP/1.0 Host: localhost Content-Length: 17 user-agent: easyuo 4.0.0e postVar=postValue

A few things are worth mentioning here:

  • you cannot SET a value containing spaces to #sendHeader without 'escaping' them using the #spc constant.
  • the value of #sendHeader is converted to lowercase when added to the HTTP header.
  • it must be terminated by a single end-of-line symbol '$'. Without this symbol, #sendHeader value will be ignored and not added to the HTTP header.


Warning: Two consecutive '$' will break the header structure and are likely to cause inpredictable results!


If you need to specify more than one http directive, you may use the following syntax:

set #sendHeader User-Agent: , #spc , EasyUO , #spc , #cliVer , $ ,
+ Content-type: , #spc , application/x-www-form-urlencoded$

or

set #sendHeader User-Agent: , #spc , EasyUO , #spc , #cliVer , $
set #sendHeader #sendHeader , Content-type: , #spc , application/x-www-form-urlencoded$

In order to reset #sendHeader, try any of these:

set #sendHeader N/A
set #sendHeader invalid content

Example


set #sendHeader Content-type: , #spc , application/x-www-form-urlencoded$

See Also

send

Main_Page Documentation Result System Variables