Module: sip-router Branch: master Commit: 37fea3e2fe4958ebc080df7c0808bba835748354 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=37fea3e2...

Author: Daniel-Constantin Mierla miconda@gmail.com Committer: Daniel-Constantin Mierla miconda@gmail.com Date: Fri Aug 29 23:18:27 2014 +0200

ims_usrloc_pcscf: fixed invalid quotation tokens and removed empty functions section

---

modules/ims_usrloc_pcscf/README | 185 ++++++++++++++------ .../doc/ims_usrloc_pcscf_admin.xml | 14 +-- 2 files changed, 137 insertions(+), 62 deletions(-)

diff --git a/modules/ims_usrloc_pcscf/README b/modules/ims_usrloc_pcscf/README index 389a7a4..f4b9c5c 100644 --- a/modules/ims_usrloc_pcscf/README +++ b/modules/ims_usrloc_pcscf/README @@ -10,7 +10,7 @@ Richard Good

Smile Communications

- Copyright © 2012 Smile Communications + Copyright � 2012 Smile Communications __________________________________________________________________

Table of Contents @@ -27,20 +27,20 @@ Richard Good

3.1. hash_size (int) 3.2. timer_interval (int) + 3.3. db_url (int) + 3.4. db_mode (int) + 3.5. hashing_type (int) + 3.6. lookup_check_received (int)

- 4. Functions + 4. RPC Commands

- 4.1. + 4.1. ulpcscf.status

- 5. RPC Commands + 5. Statistics

- 5.1. ulpcscf.status - - 6. Statistics - - 6.1. registered contacts - 6.2. impus - 6.3. expired contacts + 5.1. registered contacts + 5.2. impus + 5.3. expired contacts

2. Frequently Asked Questions

@@ -48,6 +48,10 @@ Richard Good

1.1. Set hash_size parameter 1.2. Set timer_interval parameter + 1.3. Set db_url parameter + 1.4. Set db_mode parameter + 1.5. Set hashing_type parameter + 1.6. Set lookup_check_received parameter

Chapter 1. Admin Guide

@@ -63,20 +67,20 @@ Chapter 1. Admin Guide

3.1. hash_size (int) 3.2. timer_interval (int) + 3.3. db_url (int) + 3.4. db_mode (int) + 3.5. hashing_type (int) + 3.6. lookup_check_received (int)

- 4. Functions - - 4.1. + 4. RPC Commands

- 5. RPC Commands + 4.1. ulpcscf.status

- 5.1. ulpcscf.status + 5. Statistics

- 6. Statistics - - 6.1. registered contacts - 6.2. impus - 6.3. expired contacts + 5.1. registered contacts + 5.2. impus + 5.3. expired contacts

1. Overview

@@ -114,6 +118,10 @@ Chapter 1. Admin Guide

3.1. hash_size (int) 3.2. timer_interval (int) + 3.3. db_url (int) + 3.4. db_mode (int) + 3.5. hashing_type (int) + 3.6. lookup_check_received (int)

3.1. hash_size (int)

@@ -140,39 +148,114 @@ modparam("ims_usrloc_pcscf", "hash_size", 10) modparam("ims_usrloc_pcscf", "timer_interval", 30) ...

-4. Functions +3.3. db_url (int) + + Database URL + + Default value is "mysql://kamailio:kamailiorw@localhost/kamailio". + + Example 1.3. Set db_url parameter +... +modparam("ims_usrloc_pcscf", "db_url", + "dbdriver://username:password@dbhost/dbname") +... + +3.4. db_mode (int) + + This is the database mode to be used for the PCSCF usrloc data + persistent storage. Currently this module supports the Write-Through + scheme only. + * 0 - This disables DB mode. Only memory will be used for usrloc and + data will not survive a restart. + * 1 - Write-Through Scheme. All changes to usrloc are immediately + refelcted in the database. This is slow but very reliable. This + mode will ensure that no registration data is lost as a result of a + restart or crash. + + Default value is 0. + + Example 1.4. Set db_mode parameter +... +modparam("ims_usrloc_pcscf", "db_mode", 1) +... + +3.5. hashing_type (int) + + This is used to specify how contacts are stored in the internal memory + hashing structures. This is an important parameter, not only for + efficiency, but also for functionality. IMS can get rather confusing + when it comes to contacts, SIP URIs and Implicitly registered SIP URIs + (IMPUs). Originally the hash for storage of contacts was performed over + the full contact URI viz (27821234567@10.0.0.10:12345;user=phone). This + scheme is useful (from a performance perspective) in circumstances + where you have many SIP URIs being registered from the same host/port. + However, this causes problems in IMS environments where an implicit + registration set of IMPU's is implicitly registered on behalf of a UA + when it registers. This is because the implicit contact being used in + subsequent requests could use a different SIP URI, for example + john.doe@10.0.0.10:12345. In this case the P-CSCF would not be able to + retrieve the initial contact as the hash over the different contact + would in most cases be different. It was therefore proposed to hash the + contact by IP:PORT only, effectively identifying a "device" - assuming + a 1-1 relationship between an IP:PORT pair. In our example, we would + get to the same hash slot using the second SIP URI as we got using the + initial registered SIP URI. Within this slot we can now search for the + appropriate contact (remember there are still collision possibilities) + and then traverse through the linked list if iumplcit IMPUs to find the + contact currently being used. Of course if it is not found, then you + can deny the request. + * 0 - This uses the original hash over AOR method. By default we are + backwards compatible... + * 1 - Use the newer hash over IP:PORT. + + Default value is 0. + + Example 1.5. Set hashing_type parameter +... +modparam("ims_usrloc_pcscf", "hashing_type", 1) +... + +3.6. lookup_check_received (int) + + If set to 1 (default), the Host in the contact will be checked against + the Host, from which the request was received. + * 0 - Upon lookup, do not check the host against received. + * 1 - Compare the host in the contact against the received info.

- 4.1. + Default value is 1.

- There are no exported functions that could be used in scripts. + Example 1.6. Set lookup_check_received parameter +... +modparam("ims_usrloc_pcscf", "lookup_check_received", 0) +...

-5. RPC Commands +4. RPC Commands

- 5.1. ulpcscf.status + 4.1. ulpcscf.status

exported RPC commands.

-5.1. ulpcscf.status +4.1. ulpcscf.status

Status of pcscf_usrloc, AORs, max slots, etc.

-6. Statistics +5. Statistics

- 6.1. registered contacts - 6.2. impus - 6.3. expired contacts + 5.1. registered contacts + 5.2. impus + 5.3. expired contacts

Exported statistics are listed in the next sections.

-6.1. registered contacts +5.1. registered contacts

Number of AOR contacts in registered state - cannot be reset.

-6.2. impus +5.2. impus

Number of IMPUs - cannot be reset.

-6.3. expired contacts +5.3. expired contacts

Number of expired contacts - can be reset.

@@ -184,31 +267,31 @@ Chapter 2. Frequently Asked Questions

2.1.

- Where can I find more about Kamailio? + Where can I find more about Kamailio?

- Take a look at http://www.kamailio.org/. + Take a look at http://www.kamailio.org/.

2.2.

- Where can I post a question about this module? + Where can I post a question about this module?

- First at all check if your question was already answered on one of our - mailing lists: - * User Mailing List - - http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users - * Developer Mailing List - - http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev + First at all check if your question was already answered on one of our + mailing lists: + * User Mailing List - + http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users + * Developer Mailing List - + http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev

- E-mails regarding any stable Kamailio release should be sent to - sr-users@lists.sip-router.org and e-mails regarding development - versions should be sent to sr-dev@lists.sip-router.org. + E-mails regarding any stable Kamailio release should be sent to + sr-users@lists.sip-router.org and e-mails regarding development + versions should be sent to sr-dev@lists.sip-router.org.

- If you want to keep the mail private, send it to - sr-users@lists.sip-router.org. + If you want to keep the mail private, send it to + sr-users@lists.sip-router.org.

2.3.

- How can I report a bug? + How can I report a bug?

- Please follow the guidelines provided at: - http://sip-router.org/tracker. + Please follow the guidelines provided at: + http://sip-router.org/tracker. diff --git a/modules/ims_usrloc_pcscf/doc/ims_usrloc_pcscf_admin.xml b/modules/ims_usrloc_pcscf/doc/ims_usrloc_pcscf_admin.xml index 2bdb7c1..e2707ee 100644 --- a/modules/ims_usrloc_pcscf/doc/ims_usrloc_pcscf_admin.xml +++ b/modules/ims_usrloc_pcscf/doc/ims_usrloc_pcscf_admin.xml @@ -110,13 +110,14 @@ modparam("ims_usrloc_pcscf", "timer_interval", 30) <para>Database URL</para>

<para><emphasis>Default value is - &ldquo;mysql://kamailio:kamailiorw@localhost/kamailio&rdquor;.</emphasis></para> + "mysql://kamailio:kamailiorw@localhost/kamailio".</emphasis></para>

<example> <title>Set db_url parameter</title>

<programlisting format="linespecific">... -modparam("ims_usrloc_pcscf", "db_url", "dbdriver://username:password@dbhost/dbname") +modparam("ims_usrloc_pcscf", "db_url", + "dbdriver://username:password@dbhost/dbname") ... </programlisting> </example> @@ -234,15 +235,6 @@ modparam("ims_usrloc_pcscf", "lookup_check_received", 0) </section>

<section> - <title>Functions</title> - - <section> - <para>There are no exported functions that could be used in - scripts.</para> - </section> - </section> - - <section> <title>RPC Commands</title>

<para>exported RPC commands.</para>