XCAP RLS services

Version 12 (Adrian Georgescu, 04/19/2012 03:32 pm)

1 1
2 11 Adrian Georgescu
h2. xcap-rls-services
3 10 Adrian Georgescu
4 1
5 1
6 1
7 11 Adrian Georgescu
> This script is available in _sipclients_ package that must be installed separately from SIP SIMPLe client SDK package.
8 11 Adrian Georgescu
9 11 Adrian Georgescu
10 11 Adrian Georgescu
h3. Description
11 11 Adrian Georgescu
12 11 Adrian Georgescu
13 11 Adrian Georgescu
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" script. 
14 11 Adrian Georgescu
15 11 Adrian Georgescu
<pre>
16 10 Adrian Georgescu
adigeo@ag-imac3:~$xcap-rls-services -h
17 10 Adrian Georgescu
Usage: xcap-rls-services [options] [service URI]
18 2 Adrian Georgescu
19 2 Adrian Georgescu
This example script will use the specified SIP account to manage rls services
20 2 Adrian Georgescu
via XCAP. The program will quit when CTRL+D is pressed. You can specify the
21 2 Adrian Georgescu
service URI as an argument (if domain name is not specified, the user's domain
22 2 Adrian Georgescu
name will be used). If it is not specified, it defaults to username-
23 2 Adrian Georgescu
buddies@domain.
24 8 Adrian Georgescu
25 1
Options:
26 1
  -h, --help            show this help message and exit
27 1
  -a ACCOUNT_NAME, --account-name=ACCOUNT_NAME
28 1
                        The name of the account to use.
29 8 Adrian Georgescu
  -s, --show-xml        Show the presence rules XML whenever it is changed and
30 8 Adrian Georgescu
                        at start-up.
31 2 Adrian Georgescu
32 11 Adrian Georgescu
</pre>
33 1
34 11 Adrian Georgescu
35 11 Adrian Georgescu
h3. Example
36 11 Adrian Georgescu
37 11 Adrian Georgescu
<pre>
38 4 Adrian Georgescu
adigeo@ag-imac3:~$xcap-rls-services   
39 4 Adrian Georgescu
Retrieving current RLS services from https://xcap.sipthor.net/xcap-root/
40 4 Adrian Georgescu
Managing service URI sip:31208005169-buddies@ag-projects.com
41 4 Adrian Georgescu
42 4 Adrian Georgescu
Buddies:
43 8 Adrian Georgescu
	adi@umts.ro
44 4 Adrian Georgescu
	alice@ag-projects.com
45 4 Adrian Georgescu
Press (a) to add or (r) to remove a buddy. (s) will show the RLS services xml. (d) will delete the currently selected service.
46 4 Adrian Georgescu
RLS services document:
47 4 Adrian Georgescu
<?xml version='1.0' encoding='UTF-8'?>
48 4 Adrian Georgescu
<rls-services xmlns:rl="urn:ietf:params:xml:ns:resource-lists" xmlns="urn:ietf:params:xml:ns:rls-services">
49 4 Adrian Georgescu
  <service uri="sip:31208005169-buddies@ag-projects.com">
50 4 Adrian Georgescu
    <list>
51 8 Adrian Georgescu
      <rl:entry uri="sip:adi@umts.ro"/>
52 4 Adrian Georgescu
      <rl:entry uri="sip:alice@ag-projects.com"/>
53 4 Adrian Georgescu
    </list>
54 4 Adrian Georgescu
    <packages>
55 4 Adrian Georgescu
      <package>presence</package>
56 4 Adrian Georgescu
    </packages>
57 1
  </service>
58 4 Adrian Georgescu
</rls-services>
59 4 Adrian Georgescu
60 4 Adrian Georgescu
61 4 Adrian Georgescu
Buddies:
62 8 Adrian Georgescu
	adi@umts.ro
63 4 Adrian Georgescu
	alice@ag-projects.com
64 8 Adrian Georgescu
Press (a) to add or (r) to remove a buddy. (s) will show the RLS services xml. (d) will delete the currently selected service.
65 4 Adrian Georgescu
66 4 Adrian Georgescu
67 11 Adrian Georgescu
</pre>