SIP SIMPLE Client SDK

== sip-message ==

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

=== Description ===

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

{{{

Usage: sip-message [options] [user@domain]

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, --trace-sip       Dump the raw contents of incoming and outgoing SIP

                        messages.

  -j, --trace-pjsip     Print PJSIP logging output.

  -n, --trace-notifications

                        Print all notifications (disabled by default).

  -b, --batch           Run the program in batch mode: reading control input

                        from the console is disabled. This is particularly

                        useful when running this script in a non-interactive

                        environment.

  -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.

}}}