modules: readme files regenerated - acc ... [skip ci]

src/modules/acc/README

@@ -106,23 +106,24 @@ Sven Knoblich
               6.27. db_extra (string)
               6.28. db_insert_mode (integer)
               6.29. cdr_enable (integer)
-              6.30. cdr_expired_dlg_enable (integer)
-              6.31. cdr_start_on_confirmed (integer)
-              6.32. cdr_facility (integer)
-              6.33. cdr_extra (string)
-              6.34. cdr_extra_nullable (integer)
-              6.35. cdr_start_id (string)
-              6.36. cdr_end_id (string)
-              6.37. cdr_duration_id (string)
-              6.38. cdr_log_enable (int)
-              6.39. cdrs_table (str)
-              6.40. time_mode (int)
-              6.41. time_attr (str)
-              6.42. time_exten (str)
-              6.43. time_format (str)
-              6.44. reason_from_hf (int)
-              6.45. clone_msg (int)
-              6.46. cdr_on_failed (int)
+              6.30. cdr_skip (string)
+              6.31. cdr_expired_dlg_enable (integer)
+              6.32. cdr_start_on_confirmed (integer)
+              6.33. cdr_facility (integer)
+              6.34. cdr_extra (string)
+              6.35. cdr_extra_nullable (integer)
+              6.36. cdr_start_id (string)
+              6.37. cdr_end_id (string)
+              6.38. cdr_duration_id (string)
+              6.39. cdr_log_enable (int)
+              6.40. cdrs_table (str)
+              6.41. time_mode (int)
+              6.42. time_attr (str)
+              6.43. time_exten (str)
+              6.44. time_format (str)
+              6.45. reason_from_hf (int)
+              6.46. clone_msg (int)
+              6.47. cdr_on_failed (int)
 
         7. Functions
 
@@ -164,27 +165,28 @@ Sven Knoblich
    1.27. db_extra example
    1.28. db_insert_mode example
    1.29. cdr_enable example
-   1.30. cdr_expired_dlg_enable example
-   1.31. cdr_start_on_confirmed example
-   1.32. cdr_facility example
-   1.33. cdr_extra example
-   1.34. cdr_extra_nullable example
-   1.35. cdr_start_id example
-   1.36. cdr_end_id example
-   1.37. cdr_duration_id example
-   1.38. cdr_log_enable example
-   1.39. cdrs_table example
-   1.40. time_mode example
-   1.41. time_attr example
-   1.42. time_exten example
-   1.43. time_format example
-   1.44. reason_from_hf
-   1.45. clone_msg
-   1.46. cdr_on_failed
-   1.47. acc_log_request usage
-   1.48. acc_db_request usage
+   1.30. cdr_skip example
+   1.31. cdr_expired_dlg_enable example
+   1.32. cdr_start_on_confirmed example
+   1.33. cdr_facility example
+   1.34. cdr_extra example
+   1.35. cdr_extra_nullable example
+   1.36. cdr_start_id example
+   1.37. cdr_end_id example
+   1.38. cdr_duration_id example
+   1.39. cdr_log_enable example
+   1.40. cdrs_table example
+   1.41. time_mode example
+   1.42. time_attr example
+   1.43. time_exten example
+   1.44. time_format example
+   1.45. reason_from_hf
+   1.46. clone_msg
+   1.47. cdr_on_failed
+   1.48. acc_log_request usage
    1.49. acc_db_request usage
-   1.50. acc_diam_request usage
+   1.50. acc_db_request usage
+   1.51. acc_diam_request usage
 
 Chapter 1. Admin Guide
 
@@ -258,23 +260,24 @@ Chapter 1. Admin Guide
         6.27. db_extra (string)
         6.28. db_insert_mode (integer)
         6.29. cdr_enable (integer)
-        6.30. cdr_expired_dlg_enable (integer)
-        6.31. cdr_start_on_confirmed (integer)
-        6.32. cdr_facility (integer)
-        6.33. cdr_extra (string)
-        6.34. cdr_extra_nullable (integer)
-        6.35. cdr_start_id (string)
-        6.36. cdr_end_id (string)
-        6.37. cdr_duration_id (string)
-        6.38. cdr_log_enable (int)
-        6.39. cdrs_table (str)
-        6.40. time_mode (int)
-        6.41. time_attr (str)
-        6.42. time_exten (str)
-        6.43. time_format (str)
-        6.44. reason_from_hf (int)
-        6.45. clone_msg (int)
-        6.46. cdr_on_failed (int)
+        6.30. cdr_skip (string)
+        6.31. cdr_expired_dlg_enable (integer)
+        6.32. cdr_start_on_confirmed (integer)
+        6.33. cdr_facility (integer)
+        6.34. cdr_extra (string)
+        6.35. cdr_extra_nullable (integer)
+        6.36. cdr_start_id (string)
+        6.37. cdr_end_id (string)
+        6.38. cdr_duration_id (string)
+        6.39. cdr_log_enable (int)
+        6.40. cdrs_table (str)
+        6.41. time_mode (int)
+        6.42. time_attr (str)
+        6.43. time_exten (str)
+        6.44. time_format (str)
+        6.45. reason_from_hf (int)
+        6.46. clone_msg (int)
+        6.47. cdr_on_failed (int)
 
    7. Functions
 
@@ -336,7 +339,7 @@ Chapter 1. Admin Guide
        status (including media status and PSTN status in case of the
        gateway). However, CDR-base logging has the option to log existing
        information from expired dialogs (the dlg_vars in cdr_extra) Please
-       see cdr_expired_dlg_enable parameter - Section 6.30,
+       see cdr_expired_dlg_enable parameter - Section 6.31,
        “cdr_expired_dlg_enable (integer)”.
 
    The SQL backend support is compiled in the module.
@@ -523,7 +526,7 @@ Note
    Sometimes, dialogs expire because the UA has a problem and a final
    message is never transmitted. You can toggle on/off the generation of
    CDR-based logging in such cases with only the dlg_vars showing by using
-   the cdr_expired_dlg_enable parameter - Section 6.30,
+   the cdr_expired_dlg_enable parameter - Section 6.31,
    “cdr_expired_dlg_enable (integer)”. Default behavior is not logging.
 
 4.2. CDR Extra
@@ -538,7 +541,7 @@ Note
      * cdr_extra = cdr_extra_definition (';'cdr_extra_definition)*
      * cdr_extra_definition = cdr_log_name '=' pseudo_variable
 
-   See also Section 6.33, “cdr_extra (string)”.
+   See also Section 6.34, “cdr_extra (string)”.
 
    The list with all pseudo-variables in Kamailio can be found at:
    https://www.kamailio.org/wiki/.
@@ -652,23 +655,24 @@ $dlg_var(callee) = $avp(callee); #callee='C'
    6.27. db_extra (string)
    6.28. db_insert_mode (integer)
    6.29. cdr_enable (integer)
-   6.30. cdr_expired_dlg_enable (integer)
-   6.31. cdr_start_on_confirmed (integer)
-   6.32. cdr_facility (integer)
-   6.33. cdr_extra (string)
-   6.34. cdr_extra_nullable (integer)
-   6.35. cdr_start_id (string)
-   6.36. cdr_end_id (string)
-   6.37. cdr_duration_id (string)
-   6.38. cdr_log_enable (int)
-   6.39. cdrs_table (str)
-   6.40. time_mode (int)
-   6.41. time_attr (str)
-   6.42. time_exten (str)
-   6.43. time_format (str)
-   6.44. reason_from_hf (int)
-   6.45. clone_msg (int)
-   6.46. cdr_on_failed (int)
+   6.30. cdr_skip (string)
+   6.31. cdr_expired_dlg_enable (integer)
+   6.32. cdr_start_on_confirmed (integer)
+   6.33. cdr_facility (integer)
+   6.34. cdr_extra (string)
+   6.35. cdr_extra_nullable (integer)
+   6.36. cdr_start_id (string)
+   6.37. cdr_end_id (string)
+   6.38. cdr_duration_id (string)
+   6.39. cdr_log_enable (int)
+   6.40. cdrs_table (str)
+   6.41. time_mode (int)
+   6.42. time_attr (str)
+   6.43. time_exten (str)
+   6.44. time_format (str)
+   6.45. reason_from_hf (int)
+   6.46. clone_msg (int)
+   6.47. cdr_on_failed (int)
 
 6.1. early_media (integer)
 
@@ -1059,18 +1063,29 @@ modparam("acc", "db_insert_mode", 1)
 modparam("acc", "cdr_enable", 1)
 ...
 
-6.30. cdr_expired_dlg_enable (integer)
+6.30. cdr_skip (string)
+
+   Skip cdr generation for dialogs with this dlg_var set.
+
+   Default value is NULL.
+
+   Example 1.30. cdr_skip example
+...
+modparam("acc", "cdr_skip", "nocdr")
+...
+
+6.31. cdr_expired_dlg_enable (integer)
 
    Should CDR-based logging be enabled in case of expired dialogs?
 
    0 - off (default). 1 - on.
 
-   Example 1.30. cdr_expired_dlg_enable example
+   Example 1.31. cdr_expired_dlg_enable example
 ...
 modparam("acc", "cdr_expired_dlg_enable", 1)
 ...
 
-6.31. cdr_start_on_confirmed (integer)
+6.32. cdr_start_on_confirmed (integer)
 
    Should the start time be taken from the time when the dialog is
    created, or when the dialog is confirmed?
@@ -1078,36 +1093,36 @@ modparam("acc", "cdr_expired_dlg_enable", 1)
    0 - use time of dialog creation (default). 1 - use time of dialog
    confirmation.
 
-   Example 1.31. cdr_start_on_confirmed example
+   Example 1.32. cdr_start_on_confirmed example
 ...
 modparam("acc", "cdr_start_on_confirmed", 1)
 ...
 
-6.32. cdr_facility (integer)
+6.33. cdr_facility (integer)
 
    Log facility to which CDR messages are issued to syslog. This allows to
    easily seperate CDR-specific logging from the other log messages.
 
    Default value is LOG_DAEMON.
 
-   Example 1.32. cdr_facility example
+   Example 1.33. cdr_facility example
 ...
 modparam("acc", "cdr_facility", "LOG_DAEMON")
 ...
 
-6.33. cdr_extra (string)
+6.34. cdr_extra (string)
 
    Set of pseudo-variables defining custom CDR fields. See Section 4.2,
    “CDR Extra” for more details.
 
    Default value is NULL.
 
-   Example 1.33. cdr_extra example
+   Example 1.34. cdr_extra example
 ...
 modparam("acc", "cdr_extra", "c1=$dlg_var(caller);c2=$dlg_var(callee)"
 ...
 
-6.34. cdr_extra_nullable (integer)
+6.35. cdr_extra_nullable (integer)
 
    Should custom CDR fields be saved as NULL?
 
@@ -1118,67 +1133,67 @@ modparam("acc", "cdr_extra", "c1=$dlg_var(caller);c2=$dlg_var(callee)"
 
    Default value is 0.
 
-   Example 1.34. cdr_extra_nullable example
+   Example 1.35. cdr_extra_nullable example
 ...
 modparam("acc", "cdr_extra_nullable", 1)
 ...
 
-6.35. cdr_start_id (string)
+6.36. cdr_start_id (string)
 
    Modifying the id which is used to store the start time.
 
    Default value is 'start_time'
 
-   Example 1.35. cdr_start_id example
+   Example 1.36. cdr_start_id example
 ...
 modparam("acc", "cdr_start_id", "start")
 ...
 
-6.36. cdr_end_id (string)
+6.37. cdr_end_id (string)
 
    Modifying the id which is used to store the end time.
 
    Default value is 'end_time'
 
-   Example 1.36. cdr_end_id example
+   Example 1.37. cdr_end_id example
 ...
 modparam("acc", "cdr_end_id", "end")
 ...
 
-6.37. cdr_duration_id (string)
+6.38. cdr_duration_id (string)
 
    Modify the id which is used to store the duration.
 
    Default value is 'duration'
 
-   Example 1.37. cdr_duration_id example
+   Example 1.38. cdr_duration_id example
 ...
 modparam("acc", "cdr_duration_id", "d")
 ...
 
-6.38. cdr_log_enable (int)
+6.39. cdr_log_enable (int)
 
    Control if CDR-based accounting should be written to syslog.
 
    0 - off. 1 - on (default).
 
-   Example 1.38. cdr_log_enable example
+   Example 1.39. cdr_log_enable example
 ...
 modparam("acc", "cdr_log_enable", 0)
 ...
 
-6.39. cdrs_table (str)
+6.40. cdrs_table (str)
 
    Name of db table to store dialog-based CDRs.
 
    Default value is "" (no db storage for dialog-based CDRs).
 
-   Example 1.39. cdrs_table example
+   Example 1.40. cdrs_table example
 ...
 modparam("acc", "cdrs_table", "acc_cdrs")
 ...
 
-6.40. time_mode (int)
+6.41. time_mode (int)
 
    Store additional value related to the time of event.
 
@@ -1192,12 +1207,12 @@ modparam("acc", "cdrs_table", "acc_cdrs")
      * 4 - save formatted time according to time_format parameter, using
        the output of gmtime(). Used for cdr entries too.
 
-   Example 1.40. time_mode example
+   Example 1.41. time_mode example
 ...
 modparam("acc", "time_mode", 1)
 ...
 
-6.41. time_attr (str)
+6.42. time_attr (str)
 
    Name of the syslog attribute or database column where to store
    additional value related to the time of event.
@@ -1213,35 +1228,35 @@ modparam("acc", "time_mode", 1)
    value is already unix timestamp, but in db accounting time value is
    datetime and requires a function to get the timestamp.
 
-   Example 1.41. time_attr example
+   Example 1.42. time_attr example
 ...
 modparam("acc", "time_attr", "seconds")
 ...
 
-6.42. time_exten (str)
+6.43. time_exten (str)
 
    Name of the syslog attribute or database column where to store extended
    value related to the time of event.
 
    It is used now only for time_mode=1 and database column has to be int:
 
-   Example 1.42. time_exten example
+   Example 1.43. time_exten example
 ...
 modparam("acc", "time_exten", "microsecs")
 ...
 
-6.43. time_format (str)
+6.44. time_format (str)
 
    Specify the format to print the time for time_mode 3 or 4.
 
    Default value is %Y-%m-%d %H:%M:%S".
 
-   Example 1.43. time_format example
+   Example 1.44. time_format example
 ...
 modparam("acc", "time_format", "%Y/%m/%d %H:%M:%S")
 ...
 
-6.44. reason_from_hf (int)
+6.45. reason_from_hf (int)
 
    Tells where to take sip_reason from. If value is 0, sip_reason is taken
    from status line. Otherwise, sip_reason is taken from Reason header
@@ -1249,12 +1264,12 @@ modparam("acc", "time_format", "%Y/%m/%d %H:%M:%S")
 
    Default value is 0.
 
-   Example 1.44. reason_from_hf
+   Example 1.45. reason_from_hf
 ...
 modparam("acc", "reason_from_hf", 1)
 ...
 
-6.45. clone_msg (int)
+6.46. clone_msg (int)
 
    If set to 1, request structure from transaction is cloned temporarily
    in the callback to get acc attributes. It is required if you account
@@ -1265,12 +1280,12 @@ modparam("acc", "reason_from_hf", 1)
 
    Default value is 1.
 
-   Example 1.45. clone_msg
+   Example 1.46. clone_msg
 ...
 modparam("acc", "clone_msg", 0)
 ...
 
-6.46. cdr_on_failed (int)
+6.47. cdr_on_failed (int)
 
    If set to 1, the module stores the CDR for a failed dialog (calls not
    answered). If set to 0, those records are not stored, only those for
@@ -1278,7 +1293,7 @@ modparam("acc", "clone_msg", 0)
 
    Default value is 1.
 
-   Example 1.46. cdr_on_failed
+   Example 1.47. cdr_on_failed
 ...
 modparam("acc", "cdr_on_failed", 0)
 ...
@@ -1303,7 +1318,7 @@ modparam("acc", "cdr_on_failed", 0)
 
    This function can be used from ANY_ROUTE.
 
-   Example 1.47. acc_log_request usage
+   Example 1.48. acc_log_request usage
 ...
 acc_log_request("Some comment");
 $var(code) = 404;
@@ -1325,7 +1340,7 @@ acc_log_request("$var(code) Error: $avp(reason)");
 
    This function can be used from ANY_ROUTE.
 
-   Example 1.48. acc_db_request usage
+   Example 1.49. acc_db_request usage
 ...
 acc_db_request("Some comment", "SomeTable");
 acc_db_request("Some comment", "acc_$time(year)_$time(mon)");
@@ -1349,7 +1364,7 @@ acc_db_request("$var(code) Error: $avp(reason)", "SomeTable");
 
    This function can be used from ANY_ROUTE.
 
-   Example 1.49. acc_db_request usage
+   Example 1.50. acc_db_request usage
 ...
 acc_request("100 Received", "acc");
 acc_request("100 Received", "acc_$time(year)_$time(mon)");
@@ -1367,7 +1382,7 @@ acc_db_request("$var(code) $avp(reason)", "acc");
 
    This function can be used from ANY_ROUTE.
 
-   Example 1.50. acc_diam_request usage
+   Example 1.51. acc_diam_request usage
 ...
 acc_diam_request("Some comment");
 acc_diam_request("$var(code) Error: $avp(reason)");