User Tools

Site Tools


cookbooks:devel:pseudovariables

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
cookbooks:devel:pseudovariables [2017/09/27 10:40]
miconda [$pr - Protocol of received message]
cookbooks:devel:pseudovariables [2018/07/20 18:03]
miconda [$hdr(name) - Headers]
Line 1: Line 1:
 {{ :cookbooks:devel:pseudovariables.png?200|}} {{ :cookbooks:devel:pseudovariables.png?200|}}
-====== Kamailio SIP Server v5.1.x (devel): Pseudo-Variables ======+====== Kamailio SIP Server v5.2.x (devel): Pseudo-Variables ======
  
 ===== Introduction ===== ===== Introduction =====
Line 176: Line 176:
 ==== $csb - CSeq Header Body ==== ==== $csb - CSeq Header Body ====
  
-**$cs** - reference to the CSeq header body (number method).+**$csb** - reference to the CSeq header body (number method).
 ==== $ct - Contact header ==== ==== $ct - Contact header ====
  
Line 340: Line 340:
 **$pr** or **$proto** - protocol of received message (udp, tcp, tls, sctp, ws, wss) **$pr** or **$proto** - protocol of received message (udp, tcp, tls, sctp, ws, wss)
  
-==== $prid ====+==== $prid - protocol id ====
  
 **$prid** - internal protocol id **$prid** - internal protocol id
Line 490: Line 490:
 **$Rut** - local socket where the SIP messages was received in URI format, always with transport parameter. **$Rut** - local socket where the SIP messages was received in URI format, always with transport parameter.
  
 +==== $sas - Source address in socket format ====
 +
 +**$sas** - get source address in socket format (proto:address:port).
 ==== $sbranch(attr) - Static Branch ==== ==== $sbranch(attr) - Static Branch ====
  
Line 519: Line 522:
 **$si** - reference to IP source address of the message - see also $siz **$si** - reference to IP source address of the message - see also $siz
  
 +==== $sid - Server ID ====
 +
 +**$sid** - the value for server id (server_id parameter)
 ==== $siz - Source IP address ==== ==== $siz - Source IP address ====
  
Line 748: Line 754:
 **$(hdr(name)[N])** - represents the body of the N-th header identified by 'name'. **$(hdr(name)[N])** - represents the body of the N-th header identified by 'name'.
  
-If [N] is omitted then the body of the first header is printed. The first header is got when N=0, for the second N=1, a.s.o. In case of a comma-separated multi-body headers, it returns all the bodies, comma-separated. To print the last header of that type, use -1, or other negative values to count from the end. No white spaces are allowed inside the specifier (before }, before or after {, [, ] symbols). When N='*', all headers of that type are printed.+If [N] is omitted then the body of the first header is printed. The body of first header is returned when N=0, for the second N=1, a.s.o. In case of a comma-separated multi-body headers, it returns all the bodies, comma-separated. To print the last header of that type, use -1, or other negative values to count from the end. No white spaces are allowed inside the specifier (before }, before or after {, [, ] symbols). When N='*', all headers of that type are printed
 + 
 +If name is *, then any header name is matched, e.g., $hdr(*) is body of first header, $(hdr(*)[-1]) is body of last header.
  
 The module should identify compact header names. It is recommended to use dedicated specifiers for headers (e.g., $ua for user agent header), if they are available -- they are faster. The module should identify compact header names. It is recommended to use dedicated specifiers for headers (e.g., $ua for user agent header), if they are available -- they are faster.
Line 1981: Line 1989:
   * 0x000 - HEP attribute 0x000   * 0x000 - HEP attribute 0x000
   * 0x999 - HEP attribute 0x999   * 0x999 - HEP attribute 0x999
 +
 +===== $phn(rid=>key) - Phonenum Variables =====
 +
 +$phn(rid=>key) - rid is an identifier for this query result; it is designated by the second parameter of phonenum_match(). The key can be one of the following:
 +
 +  * number - phone number that is matched
 +  * valid - 1 if the matched number has a valid result; 0 otherwise
 +  * normalized - normalized phone number
 +  * cctel - country code for phone number
 +  * ltype - local network type
 +  * ndesc - phone number description
 +  * error - error string if phone number matching fails.
 +
 +<code c>
 +if(phonenum_match("1-484-555-8888", "src")) {
 +    if($phn(src=>valid)==1) {
 +        xlog("number normalized to: $phn(src=>normalized)\n");
 +    } else {
 +        xlog("number normalization error: $phn(src=>error)\n");
 +    }
 +}
 +</code>
  
 ===== $C(xy) - Foreground and background colors ===== ===== $C(xy) - Foreground and background colors =====
cookbooks/devel/pseudovariables.txt · Last modified: 2022/04/11 15:24 by henningw