Module: sip-router Branch: master Commit: fe6508d6d56a7f739c7fc0ae2220e509abb337e1 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=fe6508d… Author: Olle E. Johansson &lt;oej(a)edvina.net&gt; Committer: Olle E. Johansson &lt;oej(a)edvina.net&gt; Date: Sat Dec 1 10:49:11 2012 +0100 sdpops: Typo fix, minor edits --- modules/sdpops/README | 55 ++++++++++++++++++----------------- modules/sdpops/doc/sdpops_admin.xml | 25 ++++++++------- 2 files changed, 41 insertions(+), 39 deletions(-) diff --git a/modules/sdpops/README b/modules/sdpops/README index 7556c42..88f8c86 100644 --- a/modules/sdpops/README +++ b/modules/sdpops/README @@ -86,9 +86,9 @@ Chapter 1. Admin Guide payloads of SIP messages. Examples of functions this module offers: remove codecs from SDP, check - the media stream types, return attributes of SDP document. For the full - list of the features provided by this module and the implementation - state, read the list of exported functions. + the media stream types and return attributes of SDP document. For the + full list of the features provided by this module and the + implementation state, please read the list of exported functions. 2. Dependencies @@ -125,11 +125,11 @@ Chapter 1. Admin Guide 4.11. sdp_get(avpvar) 4.12. sdp_content() -4.1. sdp_remove_codecs_by_id(list) +4.1. sdp_remove_codecs_by_id(list) Remove the codecs provided in the parameter 'list' from all media - streams found in SDP payload. The parameter 'list' must be one or a - comma separated list of numeric codec IDs. The parameter can be a + streams found in SDP payload. The parameter 'list' must be one item or + a comma separated list of numeric codec IDs. The parameter can be a static string or a variable holding the list of numeric codec IDs. This function can be used from ANY_ROUTE. @@ -142,11 +142,11 @@ sdp_remove_codecs_by_id("0"); sdp_remove_codecs_by_id("0,8,3"); ... -4.2. sdp_remove_codecs_by_name(list) +4.2. sdp_remove_codecs_by_name(list) Remove the codecs provided in the parameter 'list' from all media - streams found in SDP payload. The parameter 'list' must be one or a - comma separated list of codec names. The parameter can be a static + streams found in SDP payload. The parameter 'list' must be one item or + a comma separated list of codec names. The parameter can be a static string or a variable holding the list of codec names. This function can be used from ANY_ROUTE. @@ -159,15 +159,16 @@ sdp_remove_codecs_by_name("PCMU"); sdp_remove_codecs_by_name("PCMU,PCMA,GSM"); ... -4.3. sdp_remove_line_by_prefix(string) +4.3. sdp_remove_line_by_prefix(string) - Remove all SDP attribute lines beginning with 'string'. + Remove all SDP attribute lines beginning with 'string' in all media + streams. This function can be used from ANY_ROUTE. Example 1.3. sdp_remove_line_by_prefix usage ... -if ($si == "1080::8:800:200C:417A" +if ($si == "2001:DB8::8:800:200C:417A" and ( has_body("application/sdp") or has_body("multipart/mixed"))) { xlog("L_INFO", "Cleaning ugly SDP from $si\n"); @@ -177,11 +178,11 @@ if ($si == "1080::8:800:200C:417A" ... -4.4. sdp_keep_codecs_by_id(list [, mtype]) +4.4. sdp_keep_codecs_by_id(list [, mtype]) Keep only the codecs provided in the parameter 'list' from all media - streams found in SDP payload. The parameter 'list' must be one or a - comma separated list of numeric codec IDs. The parameter can be a + streams found in SDP payload. The parameter 'list' must be one item or + a comma separated list of numeric codec IDs. The parameter can be a static string or a variable holding the list of numeric codec IDs. Optional parameter mtype can be provided to apply the operations only @@ -197,7 +198,7 @@ sdp_keep_codecs_by_id("0"); sdp_keep_codecs_by_id("0,8,3", "audio"); ... -4.5. sdp_keep_codecs_by_name(list [, mtype]) +4.5. sdp_keep_codecs_by_name(list [, mtype]) Keep only the codecs provided in the parameter 'list' from all media streams found in SDP payload. The parameter 'list' must be one or a @@ -217,7 +218,7 @@ sdp_keep_codecs_by_name("PCMU"); sdp_keep_codecs_by_name("PCMU,PCMA,GSM"); ... -4.6. sdp_with_media(type) +4.6. sdp_with_media(type) Return true of the SDP has 'media=type ...' line. Useful to check the content of the RTP sessions, such as 'audio' or 'video'. The parameter @@ -234,7 +235,7 @@ if(sdp_with_media("video")) } ... -4.7. sdp_remove_media(type) +4.7. sdp_remove_media(type) Remove the streams that match on 'm=type ...' line. The parameter can be static string or variable holding the media type. @@ -247,7 +248,7 @@ if(sdp_with_media("video")) sdp_remove_media("video"); ... -4.8. sdp_with_codecs_by_id(list) +4.8. sdp_with_codecs_by_id(list) Returns true if any of the codecs provided in the parameter 'list' from all media streams is found in SDP payload. The parameter 'list' must be @@ -264,24 +265,24 @@ if(sdp_with_codecs_by_id("0")) { ... } if(sdp_with_codecs_by_id("0,8,3")) { ... } ... -4.9. sdp_with_codecs_by_name(list) +4.9. sdp_with_codecs_by_name(list) Returns true if any of the codecs provided in the parameter 'list' from all media streams is found in SDP payload. The parameter 'list' must be - one or a comma separated list of codec names. The parameter can be a - static string or a variable holding the list of codec names. + one item or a comma separated list of codec names. The parameter can be + a static string or a variable holding the list of codec names. This function can be used from ANY_ROUTE. Example 1.9. sdp_with_codecs_by_name usage ... # test for PCMU -if(sdp_with_codecs_by_id("PCMU")) { ... } +if(sdp_with_codecs_by_name("PCMU")) { ... } # test for PCMU, PCMA or GSM -if(sdp_with_codecs_by_id("PCMU,PCMA,GSM")) { ... } +if(sdp_with_codecs_by_name("PCMU,PCMA,GSM")) { ... } ... -4.10. sdp_print(level) +4.10. sdp_print(level) Print the SDP internal structure to log 'level'. The parameter can be static integer or variable holding the integer value of the log level. @@ -294,7 +295,7 @@ if(sdp_with_codecs_by_id("PCMU,PCMA,GSM")) { ... } sdp_print("1"); ... -4.11. sdp_get(avpvar) +4.11. sdp_get(avpvar) Store the SDP part of message body in an AVP. Return 1 if SDP is found, -1 on error and -2 if there is no SDP part in the message body. @@ -306,7 +307,7 @@ sdp_print("1"); sdp_get("$avp(sdp)"); ... -4.12. sdp_content() +4.12. sdp_content() Return true if the SIP message has SDP body or a SDP part in body. diff --git a/modules/sdpops/doc/sdpops_admin.xml b/modules/sdpops/doc/sdpops_admin.xml index b816c89..831669e 100644 --- a/modules/sdpops/doc/sdpops_admin.xml +++ b/modules/sdpops/doc/sdpops_admin.xml @@ -16,14 +16,14 @@ <section> <title>Overview</title> <para> - This module provides functions for checking and managing the SDP - payloads of SIP messages. + This module provides functions for checking and managing the + <acronym>SDP</acronym> payloads of SIP messages. </para> <para> Examples of functions this module offers: remove codecs from SDP, - check the media stream types, return attributes of SDP document. + check the media stream types and return attributes of SDP document. For the full list of the features provided by this module and - the implementation state, read the list of exported functions. + the implementation state, please read the list of exported functions. </para> </section> @@ -73,7 +73,7 @@ <para> Remove the codecs provided in the parameter 'list' from all media streams found in SDP payload. The parameter 'list' must - be one or a comma separated list of numeric codec IDs. The + be one item or a comma separated list of numeric codec IDs. The parameter can be a static string or a variable holding the list of numeric codec IDs. </para> @@ -99,7 +99,7 @@ sdp_remove_codecs_by_id("0,8,3"); <para> Remove the codecs provided in the parameter 'list' from all media streams found in SDP payload. The parameter 'list' must - be one or a comma separated list of codec names. The + be one item or a comma separated list of codec names. The parameter can be a static string or a variable holding the list of codec names. </para> @@ -123,7 +123,8 @@ sdp_remove_codecs_by_name("PCMU,PCMA,GSM"); <function moreinfo="none">sdp_remove_line_by_prefix(string)</function> </title> <para> - Remove all SDP attribute lines beginning with 'string'. + Remove all SDP attribute lines beginning with 'string' + in all media streams. </para> <para> This function can be used from ANY_ROUTE. @@ -132,7 +133,7 @@ sdp_remove_codecs_by_name("PCMU,PCMA,GSM"); <title><function>sdp_remove_line_by_prefix</function> usage</title> <programlisting format="linespecific"> ... -if ($si == "1080::8:800:200C:417A" +if ($si == "2001:DB8::8:800:200C:417A" and ( has_body("application/sdp") or has_body("multipart/mixed"))) { xlog("L_INFO", "Cleaning ugly SDP from $si\n"); @@ -151,7 +152,7 @@ if ($si == "1080::8:800:200C:417A" <para> Keep only the codecs provided in the parameter 'list' from all media streams found in SDP payload. The parameter 'list' must - be one or a comma separated list of numeric codec IDs. The + be one item or a comma separated list of numeric codec IDs. The parameter can be a static string or a variable holding the list of numeric codec IDs. </para> @@ -283,7 +284,7 @@ if(sdp_with_codecs_by_id("0,8,3")) { ... } <para> Returns true if any of the codecs provided in the parameter 'list' from all media streams is found in SDP payload. The parameter - 'list' must be one or a comma separated list of codec names. + 'list' must be one item or a comma separated list of codec names. The parameter can be a static string or a variable holding the list of codec names. </para> @@ -295,9 +296,9 @@ if(sdp_with_codecs_by_id("0,8,3")) { ... } <programlisting format="linespecific"> ... # test for PCMU -if(sdp_with_codecs_by_id("PCMU")) { ... } +if(sdp_with_codecs_by_name("PCMU")) { ... } # test for PCMU, PCMA or GSM -if(sdp_with_codecs_by_id("PCMU,PCMA,GSM")) { ... } +if(sdp_with_codecs_by_name("PCMU,PCMA,GSM")) { ... } ... </programlisting> </example>