Browse Source

Updated generated README with doc changes for is_known_dlg() as well.

Alex Balashov 15 years ago
parent
commit
c676d5303f
1 changed files with 10 additions and 5 deletions
  1. 10 5
      modules_k/dialog/README

+ 10 - 5
modules_k/dialog/README

@@ -1113,11 +1113,16 @@ if(dlg_get("abcdef", "123", "456"))
 
 6.13.  is_known_dlg()
 
-   This function checks if the dialog module is aware of this dialog,
-   regardless of whether it is in any profiles. The dialog module tracks
-   all dialogs irrespectively of profile usage; as such, this function
-   will return affirmatively if the request corresponds to a dialog that
-   is currently active.
+   This function checks if the current SIP message being processed belongs
+   to any transaction within an active dialog that the dialog module is
+   currently tracking. This is a check for tracking of any kind, without
+   regard to profiles.
+
+   This function has numerous potential applications, among which is that
+   it can be used to strengthen security for loose-routing sequential
+   (in-dialog) requests or responses to them, as by providing a
+   preventative check against spoofing on the proxy level instead of
+   leaving the issue purely to the receiving UA.
 
    This function can be used from REQUEST_ROUTE, BRANCH_ROUTE, REPLY_ROUTE
    and FAILURE_ROUTE.