SIP SIMPLE Client SDK

h2. == xcap-rls-services

==

[[TOC(SipTesting*, sip_*, xcap*,depth=2)]]

> This script is available in _sipclients_ ''sipclients'' package that must be installed separately from SIP SIMPLe client SDK package.

h3.

=== Description

===

This script adds and removed buddies in the RLS services XCAP document. Can be used to prepare the buddy list prior to execute source:"scripts/sip_subscribe_rls.py" [source:scripts/sip_subscribe_rls.py scripts/sip_subscribe_rls.py] script.

<pre>
{{{
adigeo@ag-imac3:~$xcap-rls-services -h
Usage: xcap-rls-services [options] [service URI]

This example script will use the specified SIP account to manage rls services
via XCAP. The program will quit when CTRL+D is pressed. You can specify the
service URI as an argument (if domain name is not specified, the user's domain
name will be used). If it is not specified, it defaults to username-
buddies@domain.

Options:
-h, --help show this help message and exit
-a ACCOUNT_NAME, --account-name=ACCOUNT_NAME
The name of the account to use.
-s, --show-xml Show the presence rules XML whenever it is changed and
at start-up.

</pre>

h3. }}}

=== Example

<pre>
===
{{{
adigeo@ag-imac3:~$xcap-rls-services
Retrieving current RLS services from https://xcap.sipthor.net/xcap-root/
Managing service URI sip:31208005169-buddies@ag-projects.com

Buddies:
adi@umts.ro
alice@ag-projects.com
Press (a) to add or (r) to remove a buddy. (s) will show the RLS services xml. (d) will delete the currently selected service.
RLS services document:
<?xml version='1.0' encoding='UTF-8'?>
<rls-services xmlns:rl="urn:ietf:params:xml:ns:resource-lists" xmlns="urn:ietf:params:xml:ns:rls-services">
<service uri="sip:31208005169-buddies@ag-projects.com">
<list>
<rl:entry uri="sip:adi@umts.ro"/>
<rl:entry uri="sip:alice@ag-projects.com"/>
</list>
<packages>
<package>presence</package>
</packages>
</service>
</rls-services>

Buddies:
adi@umts.ro
alice@ag-projects.com
Press (a) to add or (r) to remove a buddy. (s) will show the RLS services xml. (d) will delete the currently selected service.

</pre> }}}