# Parameters

## `xavi_name` (string)

Name of the XAVI where the collected headers are stored.

Default value is headers.

### Set `xavi_name` parameter

    ...
    modparam("pv_headers", "xavi_name", "headers")
    ...

Result: $xavi(headers[0]=>From) $xavi(headers[0]=>To) $xavi(headers[0]=>Call-ID)

## `header_value_size` (int)

Defines an internal maximum &sip; header value size. Header values longer than this setting will be stripped down when collected or applied.

Default value is 1024.

### Set `header_value_size` parameter

    ...
    modparam("pv_headers", "header_value_size", 512)
    ...

## `header_collect_flag` (int)

Used to mark that headers are collected for the &sip; message, leading to subsequent headers collection on this message to be declined with an error. Should be used only in branches and replies.

Default value is 27.

### Set `header_collect_flag` parameter

    ...
    modparam("pv_headers", "header_collect_flag", 17)
    ...

## `header_apply_flag` (int)

Used to mark that headers are applied for the &sip; message, leading to subsequent headers applies on this message to be declined with an error. Should be used only in branches and replies.

Default value is 28.

### Set `header_apply_flag` parameter

    ...
    modparam("pv_headers", "header_apply_flag", 18)
    ...

## `skip_headers` (string)

A comma separated headers list that must be excluded from processing (they are skipped when pvh_apply_headers() changes the &sip; message headers).

If the parameter is set to an empty string then all the &sip; message headers are processed.

Default value is Record-Route,Via,Route,Content-Length,Max-Forwards,CSeq.

### Set `skip_headers` parameter

    ...
    modparam("pv_headers", "skip_headers", "Record-Route,Via,Route")
    ...

## `split_headers` (string)

A comma separated headers list that must be split into multi headers if their value is a comma separated list.

If the parameter is set to an empty string then no headers are split.

Default value is .

### Set `split_headers` parameter

    ...
    modparam("pv_headers", "split_headers", "Diversion")
    ...

Result: Received Diversion header: Diversion: <user1@test.local>,<user2@test.local>,<user3@test.local> After split: Diversion: <user1@test.local> Diversion: <user2@test.local> Diversion: <user3@test.local>

Becomes handy if used together with pvh_modify_header() or pvh_remove_header() to change or remove value 2 for instance.

## `auto_msg` (int)

Defines whether the headers are automatically collected for incoming messages, as well as automatically applied for forwarded messages.

It is enabled by default and requires the 'tm' module to be loaded, otherwise the mode is disabled and manual invocation of pvh_collect_headers()/pvh_apply_headers() is required.

Default value is 1 (enabled).

### Set `auto_msg` parameter

    ...
    modparam("pv_headers", "auto_msg", 1)
    ...