SIP SIMPLE Client SDK

= Testing guide =

[[TOC(WikiStart, Sip*, depth=2)]]

Included with the library, a set of command line tools are available for setting up audio, instant messaging (IM), file transfer and desktop sharing sessions, publication and subscription to presence and other type of SIP events.

The requirements for using the command line tools are:

 1. A valid configuration. See [wiki:SipSettingsAPI Configuration] page for more information.  

 1. A SIP account, read below for how to obtain one.

== SIP account ==

The simplest way to start is to register a free SIP account at http://sip2sip.info. Fill in the form below, the account information will be e-mailed to you:

{{{

#!html

        <form method=POST action='https://secure.dns-hosting.info/register_sip_account.phtml'>

        <table border=0 width=550>

        <tr>

        <td valign=top>

        First name

        </td>

        <td colspan=2 valign=top>

        <input type=text name=firstName value=''>

        </td>

        </tr>

        <tr>

        <td valign=top>

        Last name

        </td>

        <td colspan=2 valign=top>

        <input type=text name=lastName value=''>

        </td>

        </tr>

        <tr>	

        <td valign=top>

        E-mail

        </td>

        <td colspan=2 valign=top>

        <input type=text name=email value=''>

        </td>

        </tr>

        <tr>

        <td valign=top>

        Timezone

        </td>

        <td colspan=2 valign=top>

        <select name=timezone><option><option >Africa/Abidjan<option >Africa/Accra<option >Africa/Addis_Ababa<option >Africa/Algiers<option >Africa/Asmera<option >Africa/Bamako<option >Africa/Bangui<option >Africa/Banjul<option >Africa/Bissau<option >Africa/Blantyre<option >Africa/Brazzaville<option >Africa/Bujumbura<option >Africa/Cairo<option >Africa/Casablanca<option >Africa/Ceuta<option >Africa/Conakry<option >Africa/Dakar<option >Africa/Dar_es_Salaam<option >Africa/Djibouti<option >Africa/Douala<option >Africa/El_Aaiun<option >Africa/Freetown<option >Africa/Gaborone<option >Africa/Harare<option >Africa/Johannesburg<option >Africa/Kampala<option >Africa/Khartoum<option >Africa/Kigali<option >Africa/Kinshasa<option >Africa/Lagos<option >Africa/Libreville<option >Africa/Lome<option >Africa/Luanda<option >Africa/Lubumbashi<option >Africa/Lusaka<option >Africa/Malabo<option >Africa/Maputo<option >Africa/Maseru<option >Africa/Mbabane<option >Africa/Mogadishu<option >Africa/Monrovia<option >Africa/Nairobi<option >Africa/Ndjamena<option >Africa/Niamey<option >Africa/Nouakchott<option >Africa/Ouagadougou<option >Africa/Porto-Novo<option >Africa/Sao_Tome<option >Africa/Timbuktu<option >Africa/Tripoli<option >Africa/Tunis<option >Africa/Windhoek<option >America/Adak<option >America/Anchorage<option >America/Anguilla<option >America/Antigua<option >America/Araguaina<option >America/Aruba<option >America/Asuncion<option >America/Atka<option >America/Barbados<option >America/Belem<option >America/Belize<option >America/Boa_Vista<option >America/Bogota<option >America/Boise<option >America/Buenos_Aires<option >America/Cambridge_Bay<option >America/Cancun<option >America/Caracas<option >America/Catamarca<option >America/Cayenne<option >America/Cayman<option >America/Chicago<option >America/Chihuahua<option >America/Cordoba<option >America/Costa_Rica<option >America/Cuiaba<option >America/Curacao<option >America/Danmarkshavn<option >America/Dawson<option >America/Dawson_Creek<option >America/Denver<option >America/Detroit<option >America/Dominica<option >America/Edmonton<option >America/Eirunepe<option >America/El_Salvador<option >America/Ensenada<option >America/Fort_Wayne<option >America/Fortaleza<option >America/Glace_Bay<option >America/Godthab<option >America/Goose_Bay<option >America/Grand_Turk<option >America/Grenada<option >America/Guadeloupe<option >America/Guatemala<option >America/Guayaquil<option >America/Guyana<option >America/Halifax<option >America/Havana<option >America/Hermosillo<option >America/Indiana<option >America/Indianapolis<option >America/Inuvik<option >America/Iqaluit<option >America/Jamaica<option >America/Jujuy<option >America/Juneau<option >America/Kentucky<option >America/Knox_IN<option >America/La_Paz<option >America/Lima<option >America/Los_Angeles<option >America/Louisville<option >America/Maceio<option >America/Managua<option >America/Manaus<option >America/Martinique<option >America/Mazatlan<option >America/Mendoza<option >America/Menominee<option >America/Merida<option >America/Mexico_City<option >America/Miquelon<option >America/Monterrey<option >America/Montevideo<option >America/Montreal<option >America/Montserrat<option >America/Nassau<option >America/New_York<option >America/Nipigon<option >America/Nome<option >America/Noronha<option >America/North_Dakota<option >America/Panama<option >America/Pangnirtung<option >America/Paramaribo<option >America/Phoenix<option >America/Port-au-Prince<option >America/Port_of_Spain<option >America/Porto_Acre<option >America/Porto_Velho<option >America/Puerto_Rico<option >America/Rainy_River<option >America/Rankin_Inlet<option >America/Recife<option >America/Regina<option >America/Rio_Branco<option >America/Rosario<option >America/Santiago<option >America/Santo_Domingo<option >America/Sao_Paulo<option >America/Scoresbysund<option >America/Shiprock<option >America/St_Johns<option >America/St_Kitts<option >America/St_Lucia<option >America/St_Thomas<option >America/St_Vincent<option >America/Swift_Current<option >America/Tegucigalpa<option >America/Thule<option >America/Thunder_Bay<option >America/Tijuana<option >America/Tortola<option >America/Vancouver<option >America/Virgin<option >America/Whitehorse<option >America/Winnipeg<option >America/Yakutat<option >America/Yellowknife<option >Antarctica/Casey<option >Antarctica/Davis<option >Antarctica/DumontDUrville<option >Antarctica/Mawson<option >Antarctica/McMurdo<option >Antarctica/Palmer<option >Antarctica/South_Pole<option >Antarctica/Syowa<option >Antarctica/Vostok<option >Arctic/Longyearbyen<option >Asia/Aden<option >Asia/Almaty<option >Asia/Amman<option >Asia/Anadyr<option >Asia/Aqtau<option >Asia/Aqtobe<option >Asia/Ashgabat<option >Asia/Ashkhabad<option >Asia/Baghdad<option >Asia/Bahrain<option >Asia/Baku<option >Asia/Bangkok<option >Asia/Beirut<option >Asia/Bishkek<option >Asia/Brunei<option >Asia/Calcutta<option >Asia/Choibalsan<option >Asia/Chongqing<option >Asia/Chungking<option >Asia/Colombo<option >Asia/Dacca<option >Asia/Damascus<option >Asia/Dhaka<option >Asia/Dili<option >Asia/Dubai<option >Asia/Dushanbe<option >Asia/Gaza<option >Asia/Harbin<option >Asia/Hong_Kong<option >Asia/Hovd<option >Asia/Irkutsk<option >Asia/Istanbul<option >Asia/Jakarta<option >Asia/Jayapura<option >Asia/Jerusalem<option >Asia/Kabul<option >Asia/Kamchatka<option >Asia/Karachi<option >Asia/Kashgar<option >Asia/Katmandu<option >Asia/Krasnoyarsk<option >Asia/Kuala_Lumpur<option >Asia/Kuching<option >Asia/Kuwait<option >Asia/Macao<option >Asia/Macau<option >Asia/Magadan<option >Asia/Manila<option >Asia/Muscat<option >Asia/Nicosia<option >Asia/Novosibirsk<option >Asia/Omsk<option >Asia/Oral<option >Asia/Phnom_Penh<option >Asia/Pontianak<option >Asia/Pyongyang<option >Asia/Qatar<option >Asia/Qyzylorda<option >Asia/Rangoon<option >Asia/Riyadh<option >Asia/Riyadh87<option >Asia/Riyadh88<option >Asia/Riyadh89<option >Asia/Saigon<option >Asia/Sakhalin<option >Asia/Samarkand<option >Asia/Seoul<option >Asia/Shanghai<option >Asia/Singapore<option >Asia/Taipei<option >Asia/Tashkent<option >Asia/Tbilisi<option >Asia/Tehran<option >Asia/Tel_Aviv<option >Asia/Thimbu<option >Asia/Thimphu<option >Asia/Tokyo<option >Asia/Ujung_Pandang<option >Asia/Ulaanbaatar<option >Asia/Ulan_Bator<option >Asia/Urumqi<option >Asia/Vientiane<option >Asia/Vladivostok<option >Asia/Yakutsk<option >Asia/Yekaterinburg<option >Asia/Yerevan<option >Atlantic/Azores<option >Atlantic/Bermuda<option >Atlantic/Canary<option >Atlantic/Cape_Verde<option >Atlantic/Faeroe<option >Atlantic/Jan_Mayen<option >Atlantic/Madeira<option >Atlantic/Reykjavik<option >Atlantic/South_Georgia<option >Atlantic/St_Helena<option >Atlantic/Stanley<option >Australia/ACT<option >Australia/Adelaide<option >Australia/Brisbane<option >Australia/Broken_Hill<option >Australia/Canberra<option >Australia/Darwin<option >Australia/Hobart<option >Australia/LHI<option >Australia/Lindeman<option >Australia/Lord_Howe<option >Australia/Melbourne<option >Australia/NSW<option >Australia/North<option >Australia/Perth<option >Australia/Queensland<option >Australia/South<option >Australia/Sydney<option >Australia/Tasmania<option >Australia/Victoria<option >Australia/West<option >Australia/Yancowinna<option >Brazil/Acre<option >Brazil/DeNoronha<option >Brazil/East<option >Brazil/West<option >Canada/Atlantic<option >Canada/Central<option >Canada/East-Saskatchewan<option >Canada/Eastern<option >Canada/Mountain<option >Canada/Newfoundland<option >Canada/Pacific<option >Canada/Saskatchewan<option >Canada/Yukon<option >Chile/Continental<option >Chile/EasterIsland<option selected>Europe/Amsterdam<option >Europe/Andorra<option >Europe/Athens<option >Europe/Belfast<option >Europe/Belgrade<option >Europe/Berlin<option >Europe/Bratislava<option >Europe/Brussels<option >Europe/Bucharest<option >Europe/Budapest<option >Europe/Chisinau<option >Europe/Copenhagen<option >Europe/Dublin<option >Europe/Gibraltar<option >Europe/Helsinki<option >Europe/Istanbul<option >Europe/Kaliningrad<option >Europe/Kiev<option >Europe/Lisbon<option >Europe/Ljubljana<option >Europe/London<option >Europe/Luxembourg<option >Europe/Madrid<option >Europe/Malta<option >Europe/Minsk<option >Europe/Monaco<option >Europe/Moscow<option >Europe/Nicosia<option >Europe/Oslo<option >Europe/Paris<option >Europe/Prague<option >Europe/Riga<option >Europe/Rome<option >Europe/Samara<option >Europe/San_Marino<option >Europe/Sarajevo<option >Europe/Simferopol<option >Europe/Skopje<option >Europe/Sofia<option >Europe/Stockholm<option >Europe/Tallinn<option >Europe/Tirane<option >Europe/Tiraspol<option >Europe/Uzhgorod<option >Europe/Vaduz<option >Europe/Vatican<option >Europe/Vienna<option >Europe/Vilnius<option >Europe/Warsaw<option >Europe/Zagreb<option >Europe/Zaporozhye<option >Europe/Zurich<option >Indian/Antananarivo<option >Indian/Chagos<option >Indian/Christmas<option >Indian/Cocos<option >Indian/Comoro<option >Indian/Kerguelen<option >Indian/Mahe<option >Indian/Maldives<option >Indian/Mauritius<option >Indian/Mayotte<option >Indian/Reunion<option >Mexico/BajaNorte<option >Mexico/BajaSur<option >Mexico/General<option >Mideast/Riyadh87<option >Mideast/Riyadh88<option >Mideast/Riyadh89<option >Pacific/Apia<option >Pacific/Auckland<option >Pacific/Chatham<option >Pacific/Easter<option >Pacific/Efate<option >Pacific/Enderbury<option >Pacific/Fakaofo<option >Pacific/Fiji<option >Pacific/Funafuti<option >Pacific/Galapagos<option >Pacific/Gambier<option >Pacific/Guadalcanal<option >Pacific/Guam<option >Pacific/Honolulu<option >Pacific/Johnston<option >Pacific/Kiritimati<option >Pacific/Kosrae<option >Pacific/Kwajalein<option >Pacific/Majuro<option >Pacific/Marquesas<option >Pacific/Midway<option >Pacific/Nauru<option >Pacific/Niue<option >Pacific/Norfolk<option >Pacific/Noumea<option >Pacific/Pago_Pago<option >Pacific/Palau<option >Pacific/Pitcairn<option >Pacific/Ponape<option >Pacific/Port_Moresby<option >Pacific/Rarotonga<option >Pacific/Saipan<option >Pacific/Samoa<option >Pacific/Tahiti<option >Pacific/Tarawa<option >Pacific/Tongatapu<option >Pacific/Truk<option >Pacific/Wake<option >Pacific/Wallis<option >Pacific/Yap<option >US/Alaska<option >US/Aleutian<option >US/Arizona<option >US/Central<option >US/East-Indiana<option >US/Eastern<option >US/Hawaii<option >US/Indiana-Starke<option >US/Michigan<option >US/Mountain<option >US/Pacific<option >US/Samoa</select>

        </td>

        </tr>

        <tr>

        <td align=left valign=top colspan=3>

        <input type=submit name=action value='Submit'>

        </td><td align=right valign=bottom><input type=hidden name=action value='add'>

        </td>

        </tr>

		</table>

        </form>

}}}

If you plan to offer a SIP service, you can setup your own SIP infrastructure using the following elements:

|| OpenSIPS || SIP Proxy/Registrar/Presence|| http://opensips.org||

|| MediaProxy || RTP media relay || http://mediaproxy-ng.org||

|| OpenXCAP|| Presence policy server || http://openxcap.org||

|| MSRP Relay|| IM media relay|| http://msrprelay.org||

||SIP chatserver|| Multi-party chat server || http://chatserver.ag-projects.com|| 

Available command line tools:

== Settings ==

 * [wiki:sip_settings sip_settings] - Manage account and global settings used by the command line tools

 * [wiki:sip_migrate_settings sip_migrate_settings] - Migrate settings from a version older than 5.0

== Register ==

 * [wiki:sip_register sip_register] - REGISTER a SIP end-point with a SIP Registrar

== Audio sessions ==

 * [wiki:sip_audio_session sip_audio_session] - Setup audio sessions (Voice over IP)

 * [wiki:sip_message sip_message] - Send/receive text in page mode using SIP MESSAGE method

== Instant messaging ==

 * [wiki:sip_im_session sip_im_session] - Setup IM sessions using MSRP protocol

 * [wiki:sip_message sip_message] - Send/receive text in paging mode using SIP MESSAGE method

== File transfer ==

 * [wiki:sip_im_session sip_im_session] - Receive files using MSRP protocol

 * [wiki:sip_send_file sip_send_file] - Send files using MSRP protocol

== Presence ==

 * [wiki:sip_publish_presence sip_publish_presence] - PUBLISH presence to a Presence Agent

 * [wiki:sip_subscribe_presence sip_subscribe_presence]  - SUBSCRIBE to presence information

 * [wiki:sip_subscribe_winfo sip_subscribe_winfo] - SUBSCRIBE to the watcher list on the Presence Agent

== XCAP policy ==

 * [wiki:xcapclient xcapclient] - PUT/GET/DELETE full or partial documents on an XCAP server

 * [wiki:xcap_pres_rules xcap_pres_rules] - Manage the content of the pres-rules XCAP document

== RLS services ==

 * [wiki:sip_subscribe_rls sip_subscribe_rls] - SUBSCRIBE to lists managed by a Resource List Server

 * [wiki:xcap_rls_services] - Manage the content of a RLS services XCAP document

== Desktop sharing ==

 * [wiki:sip_desktop_sharing sip_desktop_sharing] - Share desktop using VNC protocol