SIP SIMPLE Client SDK

== sip_message ==
[[TOC(SipTesting*, sip_*, depth=2)]]
To use this script you must to have a valid [wiki:SipSettingsAPI configuration].

=== Description ===

Source code: [source:scripts/sip_message.py scripts/sip_message.py]

{{{
Usage: sip_message [options] [target-user@target-domain.com]

This will either sit idle waiting for an incoming MESSAGE request, or send a
MESSAGE request to the specified SIP target. In outgoing mode the program will
read the contents of the messages to be sent from standard input, Ctrl+D
signalling EOF as usual. In listen mode the program will quit when Ctrl+D is
pressed.

Options:
-h, --help show this help message and exit
-a NAME, --account=NAME
The account name to use for any outgoing traffic. If
not supplied, the default account will be used.
-c [FILE], --config_file=[FILE]
The path to a configuration file to use. This
overrides the default location of the configuration
file.
-s [stdout|file|all|none], --trace-sip=[stdout|file|all|none]
Dump the raw contents of incoming and outgoing SIP
messages. The argument specifies where the messages
are to be dumped.
-j [stdout|file|all|none], --trace-pjsip=[stdout|file|all|none]
Print PJSIP logging output. The argument specifies
where the messages are to be dumped.
-m MESSAGE, --message=MESSAGE
Contents of the message to send. This disables reading
the message from standard input.

}}}

=== Example for receiving a message ===

{{{
adigeo@ag-imac3:~$sip_message
Accounts available: 'alice', 'ew', 'mrg', 'pbx', 'tf', 'umts', 'unet', default
Using default account: 31208005169@ag-projects.com
Registering ""Adrian G." <sip:31208005169@ag-projects.com>" at 81.23.228.150:5060
REGISTER was successful
Contact: <sip:4f855cb09b@192.168.1.6:51408> (expires in 300 seconds)
Other registered contacts:
<sip:31208005169@192.168.1.122:5062;line=634g6j67> (expires in 480 seconds)
<sip:5dac4295e9@192.168.1.6:51375> (expires in 95 seconds)
<sip:31208005169@192.168.1.123:5060> (expires in 77 seconds)
<sip:31208005169@192.168.1.1;uniq=5B2860C44383A3D6705629A7E1FB8> (expires in 1563 seconds)
<sip:31208005169@80.101.96.20:61578> (expires in 3069 seconds)
Press Ctrl+D to stop the program.
Received MESSAGE from ""Adi UMTS" <sip:adi@umts.ro>", Content-Type: text/plain
dsgsgddsgs
Received MESSAGE from ""Adi UMTS" <sip:adi@umts.ro>", Content-Type: text/plain
Testing short text messages in page mode!
}}}

=== Example for sending a message ===

{{{
adigeo@ag-imac3:~$sip_message -a umts ag@ag-projects.com
Accounts available: 'alice', 'ew', 'mrg', 'pbx', 'tf', 'umts', 'unet', default
Using account 'umts': adi@umts.ro
Press Ctrl+D on an empty line to end input and send the MESSAGE request.
dsgsgddsgs
Sending MESSAGE from ""Adi UMTS" <sip:adi@umts.ro>" to "<sip:ag@ag-projects.com>" using proxy 81.23.228.150:5060
MESSAGE was accepted by remote party.
adigeo@ag-imac3:~$sip_message -a umts ag@ag-projects.com
Accounts available: 'alice', 'ew', 'mrg', 'pbx', 'tf', 'umts', 'unet', default
Using account 'umts': adi@umts.ro
Press Ctrl+D on an empty line to end input and send the MESSAGE request.
Testing short text messages in page mode!
Sending MESSAGE from ""Adi UMTS" <sip:adi@umts.ro>" to "<sip:ag@ag-projects.com>" using proxy 81.23.228.150:5060
MESSAGE was accepted by remote party.
}}}