SIP SIMPLE Client SDK

== = xcap_pres_rules == =

To use this script you must to have a valid [wiki:configuration_file configuration file].

=== == Description === ==

{{{
adigeo@ag-imac3:~/work/pypjua/scripts$./xcap_pres_rules.py -h
Usage: xcap_pres_rules.py [options]

This example script will use the specified SIP account to manage presence
rules via XCAP. The program will quit when CTRL+D is pressed.

Options:
-h, --help show this help message and exit
-a NAME, --account-name=NAME
The account name from which to read account settings.
Corresponds to section Account_NAME in the
configuration file. If not supplied, the section
Account will be read.
--sip-address=SIP_ADDRESS
SIP address of the user in the form user@domain
-p PASSWORD, --password=PASSWORD
Password to use to authenticate the local account.
This overrides the setting from the config file.
-n DISPLAY_NAME, --display-name=DISPLAY_NAME
Display name to use for the local account. This
overrides the setting from the config file.
-x XCAP_ROOT, --xcap-root=XCAP_ROOT
The XCAP root to use to access the pres-rules document
for authorizing subscriptions to presence.
}}}

=== == Example === ==

{{{
ag-oxygen:~ xcapag-oxygen:~ adigeo$ xcap_pres_rules
Accounts available: 'alice', 'ew', 'gert', 'mrg', 'tf', 'umts', 'unet', default
Using default account: 31208005169@ag-projects.com
Retrieving current presence rules from https://xcap.sipthor.net/xcap-root/
Allowed watchers:
2233350608@sip2sip.info
31208005163@ag-projects.com
31208005166@ag-projects.com
31208005167@ag-projects.com
adi@umts.ro
alice@example.com
317105169@eurovoice.ro
bob@example.com
Blocked watchers:
test1@merge.net.nl
Polite-blocked watchers:
Press (a) to allow, (d) to deny, (p) to politely block a new watcher or (r) to remove a watcher from the rules.
(s) will show the presence rules xml.
a
watcher> abc@example.com
Watcher sip:abc@example.com is now authorized
}}}