<!-- Kamailio Pull Request Template -->
<!--
IMPORTANT:
- for detailed contributing guidelines, read:
https://github.com/kamailio/kamailio/blob/master/.github/CONTRIBUTING.md
- pull requests must be done to master branch, unless they are backports
of fixes from master branch to a stable branch
- backports to stable branches must be done with 'git cherry-pick -x ...'
- code is contributed under BSD for core and main components (tm, sl, auth, tls)
- code is contributed GPLv2 or a compatible license for the other components
- GPL code is contributed with OpenSSL licensing exception
-->
#### Pre-Submission Checklist
<!-- Go over all points below, and after creating the PR, tick all the checkboxes that apply -->
<!-- All points should be verified, otherwise, read the CONTRIBUTING guidelines from above-->
<!-- If you're unsure about any of these, don't hesitate to ask on sr-dev mailing list -->
- [ ] Commit message has the format required by CONTRIBUTING guide
- [ ] Commits are split per component (core, individual modules, libs, utils, ...)
- [ ] Each component has a single commit (if not, squash them into one commit)
- [ ] No commits to README files for modules (changes must be done to docbook files
in `doc/` subfolder, the README file is autogenerated)
#### Type Of Change
- [x] Small bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds new functionality)
- [ ] Breaking change (fix or feature that would change existing functionality)
#### Checklist:
<!-- Go over all points below, and after creating the PR, tick the checkboxes that apply -->
- [x] PR should be backported to stable branches
- [x] Tested changes locally
- [ ] Related to issue #XXXX (replace XXXX with an open issue number)
#### Description
<!-- Describe your changes in detail -->
* fix wrong event route name in docs
* `event_mode` is int parameter
You can view, comment on, or merge this pull request online at:
https://github.com/kamailio/kamailio/pull/2115
-- Commit Summary --
* topos: fix event_mode parameter type
-- File Changes --
M src/modules/topos/doc/topos_admin.xml (2)
M src/modules/topos/topos_mod.c (6)
-- Patch Links --
https://github.com/kamailio/kamailio/pull/2115.patchhttps://github.com/kamailio/kamailio/pull/2115.diff
--
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/kamailio/kamailio/pull/2115
Module: kamailio
Branch: master
Commit: e42fcc9395ee82d3d9d3df0da3728dd652a1d5c2
URL: https://github.com/kamailio/kamailio/commit/e42fcc9395ee82d3d9d3df0da3728dd…
Author: Henning Westerholt <hw(a)skalatan.de>
Committer: Henning Westerholt <hw(a)skalatan.de>
Date: 2019-10-31T12:30:46+01:00
topos: fix documentation for msg-sending event_route (GH #2115)
---
Modified: src/modules/topos/doc/topos_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/e42fcc9395ee82d3d9d3df0da3728dd…
Patch: https://github.com/kamailio/kamailio/commit/e42fcc9395ee82d3d9d3df0da3728dd…
---
diff --git a/src/modules/topos/doc/topos_admin.xml b/src/modules/topos/doc/topos_admin.xml
index 681c5bb9a1..8b3e2a0515 100644
--- a/src/modules/topos/doc/topos_admin.xml
+++ b/src/modules/topos/doc/topos_admin.xml
@@ -341,7 +341,7 @@ event_route[topos:msg-outgoing] {
<title>event_route[topos:msg-sending]</title>
<para>
It is executed before doing topology stripping processing for a SIP
- message to be sent out, being executed after event_route[topos:sending].
+ message to be sent out, being executed after event_route[topos:msg-outgoing].
</para>
<para>
Inside the event route the variables $sndto(ip), $sndto(port) and
Module: kamailio
Branch: master
Commit: 71d72bfec8fad009957c1ef1e53356ba60e48669
URL: https://github.com/kamailio/kamailio/commit/71d72bfec8fad009957c1ef1e53356b…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2019-10-30T13:46:11+01:00
modules: readme files regenerated - dialog ... [skip ci]
---
Modified: src/modules/dialog/README
---
Diff: https://github.com/kamailio/kamailio/commit/71d72bfec8fad009957c1ef1e53356b…
Patch: https://github.com/kamailio/kamailio/commit/71d72bfec8fad009957c1ef1e53356b…
---
diff --git a/src/modules/dialog/README b/src/modules/dialog/README
index 5dff647ef7..3b9d71b959 100644
--- a/src/modules/dialog/README
+++ b/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 abcdrssfrs122444(a)192.168.1.1
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