瀏覽代碼

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

Kamailio Dev 5 年之前
父節點
當前提交
71d72bfec8
共有 1 個文件被更改,包括 18 次插入15 次删除
  1. 18 15
      src/modules/dialog/README

+ 18 - 15
src/modules/dialog/README

@@ -154,7 +154,7 @@ Julien Klingenmeyer
               9.6. dlg.dlg_list_ctx
               9.7. dlg.terminate_dlg
               9.8. dlg.end_dlg
-              9.9. dlg.kill_active_dlg
+              9.9. dlg.set_state
               9.10. dlg.profile_get_size
               9.11. dlg.profile_list
               9.12. dlg.bridge_dlg
@@ -390,7 +390,7 @@ Chapter 1. Admin Guide
         9.6. dlg.dlg_list_ctx
         9.7. dlg.terminate_dlg
         9.8. dlg.end_dlg
-        9.9. dlg.kill_active_dlg
+        9.9. dlg.set_state
         9.10. dlg.profile_get_size
         9.11. dlg.profile_list
         9.12. dlg.bridge_dlg
@@ -1912,7 +1912,7 @@ if(has_totag()) {
    9.6. dlg.dlg_list_ctx
    9.7. dlg.terminate_dlg
    9.8. dlg.end_dlg
-   9.9. dlg.kill_active_dlg
+   9.9. dlg.set_state
    9.10. dlg.profile_get_size
    9.11. dlg.profile_list
    9.12. dlg.bridge_dlg
@@ -2053,10 +2053,10 @@ kamcmd dlg.list_ctx [email protected]
 kamcmd dlg.end_dlg 342 56
 ...
 
-9.9. dlg.kill_active_dlg
+9.9. dlg.set_state
 
-   Kills a given active dialog matching the dialog on Call-ID, From-Tag
-   and To-Tag.
+   Set state for the dialog matching the dialog on Call-ID, From-Tag and
+   To-Tag.
 
    Name: dlg.kill_active_dlg
 
@@ -2064,18 +2064,21 @@ kamcmd dlg.end_dlg 342 56
      * callid - Call-ID of active dialog to kill
      * from_tag - From-Tag of active dialog to kill
      * to_tag - To-tag of active dialog to kill
-
-   This command only handles active dialogs (state 4), error is returned
-   otherwise. Please be careful with it, it callously wipes out the given
-   dialog: dialog ending functions will not be called, such as accounting
-   end-of-call events, dialog-end events, module-generated BYE requests,
-   etc. After executing the command, dialog remains in memory until
-   execution of the recurring function in charge of removing old dialogs
-   (a "dialog in delete state is too old" will then be logged).
+     * state - The value for new state
+
+   At this moment, the command targets the need to change from active
+   dialogs (state 4) to terminated state (5), although it allows setting
+   other state value. Be careful using with it, it can cause side effects
+   and the terminated dialog is wiped out silently. Dialog ending
+   functions are not executed, such as accounting end-of-call events,
+   dialog-end events, module-generated BYE requests, etc. After executing
+   the command, dialog remains in memory until execution of the recurring
+   function in charge of removing old dialogs (a "dialog in delete state
+   is too old" will then be logged).
 
    RPC Command Format:
 ...
-kamcmd dlg.kill_active_dlg callid12345 fromtag123 totag123
+kamcmd dlg.set_state callid12345 fromtag123 totag123 5
 ...
 
 9.10. dlg.profile_get_size