This script is available in sipclients package that must be installed separately from SIP SIMPLe client SDK package.
Watchers are defined as entities that request (i.e., subscribe to)
information about a resource, using the SIP event framework, RFC 3265. There
is fairly complex state associated with these subscriptions. This state
includes the identity of the subscriber, the state of the subscription, and
so on. The union of the state for all subscriptions to a particular resource
is called the watcher information for that resource. This state is dynamic,
changing as subscribers come and go. As a result, it is possible, and
indeed useful, to subscribe to the watcher information for a particular
resource. An important application of this is the ability for a user to find
out the set of subscribers to their presentity. This would allow the user to
provide an authorization decision for the subscription.
This script implements SUBSCRIBE for the watcher info event package and
manipulation of the pres-rules document that holds the presence policy of
the subscribing user.
adigeo@ag-imac3:~$sip-subscribe-winfo -h Usage: sip-subscribe-winfo [options] [firstname.lastname@example.org] This script displays the current presence rules, SUBSCRIBEs to the presence.winfo event of itself and prompts the user to update the presence rules document when a new watcher is in 'pending'/'waiting' state. The program will un-SUBSCRIBE and quit when CTRL+D is pressed. Options: -h, --help show this help message and exit -a ACCOUNT_NAME, --account-name=ACCOUNT_NAME The name of the account to use. -s, --trace-sip Dump the raw contents of incoming and outgoing SIP messages (disabled by default). -j, --trace-pjsip Print PJSIP logging output (disabled by default).
adigeo@ag-imac3:~/work/pypjua$sip-subscribe-winfo Accounts available: 'alice', 'bob', 'ew', 'mrg', 'pbx', 'tf', 'umts', 'unet', default Using default account: email@example.com Resolved DNS SRV record "_sip._udp.ag-projects.com" --> proxy.sipthor.net:5060 Resolved DNS A record "proxy.sipthor.net" --> 220.127.116.11, 18.104.22.168, 22.214.171.124 Retrieving current presence rules from https://xcap.sipthor.net/xcap-root/ Allowed list: sip:firstname.lastname@example.org sip:email@example.com sip:firstname.lastname@example.org sip:email@example.com sip:firstname.lastname@example.org sip:email@example.com sip:firstname.lastname@example.org sip:email@example.com Blocked list: Polite-blocked list: Subscribing to "firstname.lastname@example.org" for the presence.winfo event, at 126.96.36.199:5060 Received NOTIFY: ---- Active watchers: Terminated watchers: Pending watchers: sip:email@example.com Waiting watchers: ---- pending watcher sip:firstname.lastname@example.org wants to subscribe to your presence information. Press (a) to allow, (d) to deny, (p) to polite block: Watcher sip:email@example.com is now allowed