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.

To use the command line tools  you need a SIP account, read below for how to obtain one.

> Beware that some scripts might not be fully operational. See [wiki:SipProjectStatus project status page] for more information.

== 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 server || http://opensips.org||

|| OpenXCAP|| Policy server || http://openxcap.org||

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

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

== Settings ==

Setup your SIP accounts using:

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

== Register ==

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

== Interactive sessions ==

 * [wiki:sip_audio_session sip_audio_session] - Setup SIP session for audio using RTP media (VoIP session only)

 * [wiki:sip_session sip_session] - Setup SIP session for audio and instant messaging using RTP and MSRP media

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

 * [wiki:sip_trace_msrp_rtp] - Sample SIP trace for and MSRP session

== File transfer ==

>  These scripts are prototypes and will be re-written to use the new middleware API. They require the old [wiki:SipConfigOld configuration file].

 * [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 ==

You can use these scripts to publish notes, privacy, moods and device availability to a presence agent and to manage the access lists for those who want to access your published information.

 * [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 ==

XCAP is used to store policy documents for the published presence information and to store buddy-lists.

 * [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 ==

RLS allows to subscribe to a whole buddy-list previously uploaded to an XCAP server. This reduces the amount of traffic necessary to subscribe to a large number of buddies.

 * [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 ==

>  This scripts is a prototype and will be re-written to use the new middleware API. It required the old [wiki:SipConfigOld configuration file].

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