« Previous - Version 28/33 (diff) - Next » - Current version
Adrian Georgescu, 08/19/2009 02:07 pm


<acronym title="SipTesting*, sip_*, depth=2">TOC</acronym>

=== Description ===

SIP protocol offers a discovery capability. If a user wants to initiate a session
with another user, he must discover the current host(s) at which the
destination user is reachable. To do this, SIP network elements consult an
abstract service known as a location service, which provides address
bindings for a particular domain. Registration entails sending a REGISTER
request to a special type of UAS known as a registrar. A registrar acts as
the front end to the location service for a domain, reading and writing
mappings based on the contents of REGISTER requests. This location service
is then typically consulted by a proxy server that is responsible for
routing requests for that domain.

This script implements REGISTER method, which registers the contact (ip, port and transport) for a given address of record (SIP address).


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

adigeo@ag-imac3:~$sip_register -h
Usage: sip_register [options]

This script will register a SIP account to a SIP registrar and refresh it
while the program is running. When Ctrl+D is pressed it will unregister.

-h, --help show this help message and exit
-a NAME, --account=NAME
The name of the account to use. 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
-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).
-n, --trace-notifications
Print all notifications (disabled by default).
Max number of REGISTERs sent (default 1, set to 0 for
-b, --batch Run the program in batch mode: reading input from the
console is disabled. This is particularly useful when
running this script in a non-interactive environment.


=== Example ===

Using account
Registration succeeded at;transport=udp.
Contact: sip::58481 (expires in 600 seconds).
Other registered contacts:
sip::5060 (expires in 262 seconds)
sip::5062;line=634g6j67 (expires in 360 seconds)
sip:;uniq=5B2860C44383A3D6705629A7E1FB8 (expires in 734 seconds)
Registration ended: 200 OK.