Forward

Last modified by Buildbot on 2026/02/14 01:03

 Documentation based on repostory git version commit 2.6.0-alpha-217-g8bfd3883 

Module Forward

Executes basic routing tasks on SIP requests and pass them to the transport layer. It MUST always be enabled.
----

Configuration options:

NameDescriptionDefault ValueDefault UnitType
enabled

Indicate whether the module is activated.

 true Boolean
filter

A request/response enters module if the boolean filter evaluates to true. Ex: from.uri.domain contains 'sip.linphone.org', from.uri.domain in 'a.org b.org c.org', (to.uri.domain in 'a.org b.org c.org') && (user-agent == 'Linphone v2'). You can consult the full filter documentation here: https://wiki.linphone.org/xwiki/wiki/public/view/Flexisip/Configuration/Filter%20syntax/

  BooleanExpr
routes-config-path

Path to a file describing a set of 'Route' headers to be prepended before forwarding an out-of-dialog request. Headers are prepended only if the related conditions are met by the request.The conditions are described using Flexisip's filter syntax, as described on
https://wiki.linphone.org/xwiki/wiki/public/view/Flexisip/Configuration/Filter%20syntax/
The configuration file comprises lines using the following syntax:
<sip route>   <condition expressed as a filter expression>
Comments are allowed with '#'.
Conditions can spread over multiples lines provided that the continuation line starts with either spaces or tabs.
The special condition '*' matches every request.
The conditions are matched in the order they appear in the configuration file. The first fulfilled condition determines the route that is prepended. If the request does not match any condition, no route is prepended.
The file may be empty, or no path may be specified, in which case no route is preprended either. Here is a an example of a valid routes configuration file:
<sip:example.org;transport=tls>     request.uri.domain == 'example.org'
<sip:10.0.0.2:5070;transport=tcp>   request.uri.params contains 'user=phone'

Beware: that is not just a SIP URI, but a route. As a result, when the URI has parameters, brackets must enclose the URI, otherwise the parameters will be parsed as route parameters.

  String
add-path

Add a path header of this proxy

 true Boolean
default-transport

For SIP URIs, in absence of transport parameter, assume the given transport is to be used. Possible values are udp, tcp or tls.

 udp String
params-to-remove

List of URL and contact params to remove

 pn-tok pn-type app-id pn-msg-str pn-call-str pn-call-snd pn-msg-snd pn-timeout pn-silent pn-provider pn-prid pn-param StringList