This documentation relates to last stable version of Cipango.
visit the last unstable documentation home.

sipsak

Sipsak is a simple multi-platform tool that allows to perform various tests on SIP servers or user agents. Sipsak installation is described here.

Sending OPTIONS

The more simple use of sipsak is to send an OPTIONS message to a SIP URI. To achieve that, enter: 

sipsak -s sip:server

You may then check the return code of the sipsak process to find out if an answer has been received. The return codes are as follows:

  • 0 means that a 200 response has been received
  • 1 means an answer has been received but with a different status code than 2xx 
  • 2 if a local error occured (non resolvable name for instance)
  • 3 for remote errors (socket errors, no answer)

You may display additional information using the verbose parameter (-v). There are 3 different levels of verbosity: -v, -vv, -vvv from least to most verbose. The maximum of three v's prints out the content of all packets received and sent.

To display the full SIP answer, use:

sipsak -v -s sip:server

Registering users

To register a user, you should use the -U (usrloc) parameter. The given SIP URI shall then indicates to user to be registered. For instance:

sipsak -U -s sip:alice@server