SIP SIMPLE Client SDK

== sip-subscribe-presence ==

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

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

=== Description ===

[[Image(http://www.openxcap.org/chrome/site/SIMPLE-Server.png, nolink)]]

{{{

adigeo@ag-imac3:~$sip-subscribe-presence -h

Usage: sip-subscribe-presence [options] [target-user@target-domain.com]

This script will SUBSCRIBE to the presence event published by the specified

SIP target. If a SIP target is not specified, it will subscribe to its own

address. It will then interprete PIDF bodies contained in NOTIFYs and display

their meaning. 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).

}}}

=== Example ===

{{{

adigeo@ag-imac3:~$sip-subscribe-presence -a umts ag@ag-projects.com

Accounts available: 'alice', 'ew', 'mrg', 'pbx', 'tf', 'umts', 'unet', default

Using account 'umts': adi@umts.ro

Resolved DNS SRV record "_sip._udp.umts.ro" --> proxy.sipthor.net:5060

Resolved DNS A record "proxy.sipthor.net" --> 81.23.228.150, 81.23.228.129, 85.17.186.7

Subscribing to "<sip:ag@ag-projects.com>" for the presence event, at 85.17.186.7:5060

Received NOTIFY:

----------------

Presence for 31208005169@ag-projects.com:

  Person id yipgulqr

    Timestamp: 2008-10-26 10:37:32

    Activities

      Note(en): I am working

    Mood: sad, contended, mean

    Time offset from UTC: 60 minutes 

  ---

  Service id apgjjwtz

    Timestamp: 2008-10-26 10:37:42

    Status: open

----------------

Received NOTIFY:

----------------

Presence for 31208005169@ag-projects.com:

  Person id ksgxtgwo

    Timestamp: 2008-10-26 10:41:04

    Mood: impressed, flirtatious, thirsty

    Time offset from UTC: 60 minutes 

  Person id yipgulqr

    Timestamp: 2008-10-26 10:37:32

    Activities

      Note(en): I am working

    Mood: sad, contended, mean

    Time offset from UTC: 60 minutes 

  ---

  Service id apgjjwtz

    Timestamp: 2008-10-26 10:37:42

    Status: open

  Service id hxpzsnfp

    Timestamp: 2008-10-26 10:41:00

    Status: open

----------------

Received NOTIFY:

----------------

Presence for 31208005169@ag-projects.com:

  Person id ksgxtgwo

    Timestamp: 2008-10-26 10:41:04

    Mood: impressed, flirtatious, thirsty

    Time offset from UTC: 60 minutes 

  Person id yipgulqr

    Timestamp: 2008-10-26 10:37:32

    Activities

      Note(en): I am working

    Mood: sad, contended, mean

    Time offset from UTC: 60 minutes 

  ---

  Service id apgjjwtz

    Timestamp: 2008-10-26 10:37:42

    Status: open

  Service id hxpzsnfp

    Timestamp: 2008-10-26 10:41:07

    Status: closed

----------------

}}}