Difference between revisions of "SendHeader"

From Wiki
Jump to: navigation, search
m
Line 41: Line 41:
 
<pre>set #sendHeader N/A
 
<pre>set #sendHeader N/A
 
set #sendHeader invalid content</pre>}}
 
set #sendHeader invalid content</pre>}}
 +
  
 
{{note|
 
{{note|
Line 47: Line 48:
 
*The value of #sendHeader is converted to lowercase when added to the HTTP header.
 
*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.}}
 
*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.}}
 +
  
 
==== Example ====
 
==== Example ====

Revision as of 04:58, 29 August 2005

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.

For example:

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

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:

; 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

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


Note:
  • Two consecutive '$' will break the header structure and are likely to cause inpredictable results!
  • 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.


Example


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

See also

Main Page Documentation