]> sjero.net Git - linphone/blob - coreapi/linphonecore.c
Add linphone_core_get_camera_sensor_rotation().
[linphone] / coreapi / linphonecore.c
1 /*
2 linphone
3 Copyright (C) 2000  Simon MORLAT (simon.morlat@linphone.org)
4
5 This program is free software; you can redistribute it and/or
6 modify it under the terms of the GNU General Public License
7 as published by the Free Software Foundation; either version 2
8 of the License, or (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
18 */
19
20 #define _GNU_SOURCE
21
22 #include "linphonecore.h"
23 #include "sipsetup.h"
24 #include "lpconfig.h"
25 #include "private.h"
26
27 #include <math.h>
28 #include <ortp/telephonyevents.h>
29 #include <ortp/zrtp.h>
30 #include "mediastreamer2/mediastream.h"
31 #include "mediastreamer2/mseventqueue.h"
32 #include "mediastreamer2/msvolume.h"
33 #include "mediastreamer2/msequalizer.h"
34 #include "mediastreamer2/dtmfgen.h"
35
36 #ifdef INET6
37 #ifndef WIN32
38 #include <netdb.h>
39 #endif
40 #endif
41
42 #ifdef HAVE_CONFIG_H
43 #include "config.h"
44 #include "liblinphone_gitversion.h"
45 #else
46 #ifndef LIBLINPHONE_GIT_VERSION
47 #define LIBLINPHONE_GIT_VERSION "unknown"
48 #endif
49 #endif
50
51
52 /*#define UNSTANDART_GSM_11K 1*/
53
54 #define ROOT_CA_FILE PACKAGE_DATA_DIR "/linphone/rootca.pem"
55
56 static const char *liblinphone_version=
57 #ifdef LIBLINPHONE_GIT_VERSION
58         LIBLINPHONE_GIT_VERSION
59 #else
60         LIBLINPHONE_VERSION
61 #endif
62 ;
63 static void set_network_reachable(LinphoneCore* lc,bool_t isReachable, time_t curtime);
64 static void linphone_core_run_hooks(LinphoneCore *lc);
65 static void linphone_core_free_hooks(LinphoneCore *lc);
66
67 #include "enum.h"
68
69 const char *linphone_core_get_nat_address_resolved(LinphoneCore *lc);
70 static void toggle_video_preview(LinphoneCore *lc, bool_t val);
71
72 /* relative path where is stored local ring*/
73 #define LOCAL_RING "rings/oldphone.wav"
74 /* same for remote ring (ringback)*/
75 #define REMOTE_RING "ringback.wav"
76 #define HOLD_MUSIC "rings/toy-mono.wav"
77
78
79 extern SalCallbacks linphone_sal_callbacks;
80
81 void lc_callback_obj_init(LCCallbackObj *obj,LinphoneCoreCbFunc func,void* ud)
82 {
83   obj->_func=func;
84   obj->_user_data=ud;
85 }
86
87 int lc_callback_obj_invoke(LCCallbackObj *obj, LinphoneCore *lc){
88         if (obj->_func!=NULL) obj->_func(lc,obj->_user_data);
89         return 0;
90 }
91
92
93 /*prevent a gcc bug with %c*/
94 static size_t my_strftime(char *s, size_t max, const char  *fmt,  const struct tm *tm){
95         return strftime(s, max, fmt, tm);
96 }
97
98 static void set_call_log_date(LinphoneCallLog *cl, time_t start_time){
99         struct tm loctime;
100 #ifdef WIN32
101 #if !defined(_WIN32_WCE)
102         loctime=*localtime(&start_time);
103         /*FIXME*/
104 #endif /*_WIN32_WCE*/
105 #else
106         localtime_r(&start_time,&loctime);
107 #endif
108         my_strftime(cl->start_date,sizeof(cl->start_date),"%c",&loctime);
109 }
110
111 LinphoneCallLog * linphone_call_log_new(LinphoneCall *call, LinphoneAddress *from, LinphoneAddress *to){
112         LinphoneCallLog *cl=ms_new0(LinphoneCallLog,1);
113         cl->dir=call->dir;
114         cl->start_date_time=call->start_time;
115         set_call_log_date(cl,cl->start_date_time);
116         cl->from=from;
117         cl->to=to;
118         cl->status=LinphoneCallAborted; /*default status*/
119         cl->quality=-1;
120         return cl;
121 }
122
123 void call_logs_write_to_config_file(LinphoneCore *lc){
124         MSList *elem;
125         char logsection[32];
126         int i;
127         char *tmp;
128         LpConfig *cfg=lc->config;
129
130         if (linphone_core_get_global_state (lc)==LinphoneGlobalStartup) return;
131
132         for(i=0,elem=lc->call_logs;elem!=NULL;elem=elem->next,++i){
133                 LinphoneCallLog *cl=(LinphoneCallLog*)elem->data;
134                 snprintf(logsection,sizeof(logsection),"call_log_%i",i);
135                 lp_config_clean_section(cfg,logsection);
136                 lp_config_set_int(cfg,logsection,"dir",cl->dir);
137                 lp_config_set_int(cfg,logsection,"status",cl->status);
138                 tmp=linphone_address_as_string(cl->from);
139                 lp_config_set_string(cfg,logsection,"from",tmp);
140                 ms_free(tmp);
141                 tmp=linphone_address_as_string(cl->to);
142                 lp_config_set_string(cfg,logsection,"to",tmp);
143                 ms_free(tmp);
144                 if (cl->start_date_time)
145                         lp_config_set_int64(cfg,logsection,"start_date_time",(int64_t)cl->start_date_time);
146                 else lp_config_set_string(cfg,logsection,"start_date",cl->start_date);
147                 lp_config_set_int(cfg,logsection,"duration",cl->duration);
148                 if (cl->refkey) lp_config_set_string(cfg,logsection,"refkey",cl->refkey);
149                 lp_config_set_float(cfg,logsection,"quality",cl->quality);
150                 lp_config_set_int(cfg,logsection,"video_enabled", cl->video_enabled);
151                 lp_config_set_string(cfg,logsection,"call_id",cl->call_id);
152         }
153         for(;i<lc->max_call_logs;++i){
154                 snprintf(logsection,sizeof(logsection),"call_log_%i",i);
155                 lp_config_clean_section(cfg,logsection);
156         }
157 }
158
159 static time_t string_to_time(const char *date){
160 #ifndef WIN32
161         struct tm tmtime={0};
162         strptime(date,"%c",&tmtime);
163         return mktime(&tmtime);
164 #else
165         return 0;
166 #endif
167 }
168
169 static void call_logs_read_from_config_file(LinphoneCore *lc){
170         char logsection[32];
171         int i;
172         const char *tmp;
173         uint64_t sec;
174         LpConfig *cfg=lc->config;
175         for(i=0;;++i){
176                 snprintf(logsection,sizeof(logsection),"call_log_%i",i);
177                 if (lp_config_has_section(cfg,logsection)){
178                         LinphoneCallLog *cl=ms_new0(LinphoneCallLog,1);
179                         cl->dir=lp_config_get_int(cfg,logsection,"dir",0);
180                         cl->status=lp_config_get_int(cfg,logsection,"status",0);
181                         tmp=lp_config_get_string(cfg,logsection,"from",NULL);
182                         if (tmp) cl->from=linphone_address_new(tmp);
183                         tmp=lp_config_get_string(cfg,logsection,"to",NULL);
184                         if (tmp) cl->to=linphone_address_new(tmp);
185                         sec=lp_config_get_int64(cfg,logsection,"start_date_time",0);
186                         if (sec) {
187                                 /*new call log format with date expressed in seconds */
188                                 cl->start_date_time=(time_t)sec;
189                                 set_call_log_date(cl,cl->start_date_time);
190                         }else{
191                                 tmp=lp_config_get_string(cfg,logsection,"start_date",NULL);
192                                 if (tmp) {
193                                         strncpy(cl->start_date,tmp,sizeof(cl->start_date));
194                                         cl->start_date_time=string_to_time(cl->start_date);
195                                 }
196                         }
197                         cl->duration=lp_config_get_int(cfg,logsection,"duration",0);
198                         tmp=lp_config_get_string(cfg,logsection,"refkey",NULL);
199                         if (tmp) cl->refkey=ms_strdup(tmp);
200                         cl->quality=lp_config_get_float(cfg,logsection,"quality",-1);
201                         cl->video_enabled=lp_config_get_int(cfg,logsection,"video_enabled",0);
202                         tmp=lp_config_get_string(cfg,logsection,"call_id",NULL);
203                         if (tmp) cl->call_id=ms_strdup(tmp);
204                         lc->call_logs=ms_list_append(lc->call_logs,cl);
205                 }else break;
206         }
207 }
208
209
210
211 /**
212  * @addtogroup call_logs
213  * @{
214 **/
215
216 /**
217  * Returns a human readable string describing the call.
218  *
219  * @note: the returned char* must be freed by the application (use ms_free()).
220 **/
221 char * linphone_call_log_to_str(LinphoneCallLog *cl){
222         char *status;
223         char *tmp;
224         char *from=linphone_address_as_string (cl->from);
225         char *to=linphone_address_as_string (cl->to);
226         switch(cl->status){
227                 case LinphoneCallAborted:
228                         status=_("aborted");
229                         break;
230                 case LinphoneCallSuccess:
231                         status=_("completed");
232                         break;
233                 case LinphoneCallMissed:
234                         status=_("missed");
235                         break;
236                 default:
237                         status="unknown";
238         }
239         tmp=ortp_strdup_printf(_("%s at %s\nFrom: %s\nTo: %s\nStatus: %s\nDuration: %i mn %i sec\n"),
240                         (cl->dir==LinphoneCallIncoming) ? _("Incoming call") : _("Outgoing call"),
241                         cl->start_date,
242                         from,
243                         to,
244                         status,
245                         cl->duration/60,
246                         cl->duration%60);
247         ms_free(from);
248         ms_free(to);
249         return tmp;
250 }
251
252 /**
253  * Returns RTP statistics computed locally regarding the call.
254  *
255 **/
256 const rtp_stats_t *linphone_call_log_get_local_stats(const LinphoneCallLog *cl){
257         return &cl->local_stats;
258 }
259
260 /**
261  * Returns RTP statistics computed by remote end and sent back via RTCP.
262  *
263  * @note Not implemented yet.
264 **/
265 const rtp_stats_t *linphone_call_log_get_remote_stats(const LinphoneCallLog *cl){
266         return &cl->remote_stats;
267 }
268
269 const char *linphone_call_log_get_call_id(const LinphoneCallLog *cl){
270         return cl->call_id;
271 }
272
273 /**
274  * Assign a user pointer to the call log.
275 **/
276 void linphone_call_log_set_user_pointer(LinphoneCallLog *cl, void *up){
277         cl->user_pointer=up;
278 }
279
280 /**
281  * Returns the user pointer associated with the call log.
282 **/
283 void *linphone_call_log_get_user_pointer(const LinphoneCallLog *cl){
284         return cl->user_pointer;
285 }
286
287
288
289 /**
290  * Associate a persistent reference key to the call log.
291  *
292  * The reference key can be for example an id to an external database.
293  * It is stored in the config file, thus can survive to process exits/restarts.
294  *
295 **/
296 void linphone_call_log_set_ref_key(LinphoneCallLog *cl, const char *refkey){
297         if (cl->refkey!=NULL){
298                 ms_free(cl->refkey);
299                 cl->refkey=NULL;
300         }
301         if (refkey) cl->refkey=ms_strdup(refkey);
302 }
303
304 /**
305  * Get the persistent reference key associated to the call log.
306  *
307  * The reference key can be for example an id to an external database.
308  * It is stored in the config file, thus can survive to process exits/restarts.
309  *
310 **/
311 const char *linphone_call_log_get_ref_key(const LinphoneCallLog *cl){
312         return cl->refkey;
313 }
314
315 /**
316  * Returns origin (ie from) address of the call.
317 **/
318 LinphoneAddress *linphone_call_log_get_from(LinphoneCallLog *cl){
319         return cl->from;
320 }
321
322 /**
323  * Returns destination address (ie to) of the call.
324 **/
325 LinphoneAddress *linphone_call_log_get_to(LinphoneCallLog *cl){
326         return cl->to;
327 }
328
329 /**
330  * Returns remote address (that is from or to depending on call direction).
331 **/
332 LinphoneAddress *linphone_call_log_get_remote_address(LinphoneCallLog *cl){
333         return (cl->dir == LinphoneCallIncoming) ? cl->from : cl->to;
334 }
335
336 /**
337  * Returns the direction of the call.
338 **/
339 LinphoneCallDir linphone_call_log_get_dir(LinphoneCallLog *cl){
340         return cl->dir;
341 }
342
343 /**
344  * Returns the status of the call.
345 **/
346 LinphoneCallStatus linphone_call_log_get_status(LinphoneCallLog *cl){
347         return cl->status;
348 }
349
350 /**
351  * Returns the start date of the call, expressed as a POSIX time_t.
352 **/
353 time_t linphone_call_log_get_start_date(LinphoneCallLog *cl){
354         return cl->start_date_time;
355 }
356
357 /**
358  * Returns duration of the call.
359 **/
360 int linphone_call_log_get_duration(LinphoneCallLog *cl){
361         return cl->duration;
362 }
363
364 /**
365  * Returns overall quality indication of the call.
366 **/
367 float linphone_call_log_get_quality(LinphoneCallLog *cl){
368         return cl->quality;
369 }
370 /**
371  * return true if video was enabled at the end of the call
372  */
373 LinphoneCallStatus linphone_call_log_video_enabled(LinphoneCallLog *cl) {
374         return cl->video_enabled;
375 }
376 /** @} */
377
378 void linphone_call_log_destroy(LinphoneCallLog *cl){
379         if (cl->from!=NULL) linphone_address_destroy(cl->from);
380         if (cl->to!=NULL) linphone_address_destroy(cl->to);
381         if (cl->refkey!=NULL) ms_free(cl->refkey);
382         if (cl->call_id) ms_free(cl->call_id);
383         ms_free(cl);
384 }
385
386 /**
387  * Returns TRUE if the LinphoneCall asked to autoanswer
388  *
389 **/
390 bool_t linphone_call_asked_to_autoanswer(LinphoneCall *call){
391         //return TRUE if the unique(for the moment) incoming call asked to be autoanswered
392         if(call)
393                 return sal_call_autoanswer_asked(call->op);
394         else
395                 return FALSE;
396 }
397
398 int linphone_core_get_current_call_duration(const LinphoneCore *lc){
399         LinphoneCall *call=linphone_core_get_current_call((LinphoneCore *)lc);
400         if (call)  return linphone_call_get_duration(call);
401         return -1;
402 }
403
404 const LinphoneAddress *linphone_core_get_current_call_remote_address(struct _LinphoneCore *lc){
405         LinphoneCall *call=linphone_core_get_current_call(lc);
406         if (call==NULL) return NULL;
407         return linphone_call_get_remote_address(call);
408 }
409
410 void linphone_core_set_log_handler(OrtpLogFunc logfunc) {
411         ortp_set_log_handler(logfunc);
412 }
413
414 void linphone_core_set_log_file(FILE *file) {
415         if (file == NULL) file = stdout;
416         ortp_set_log_file(file);
417 }
418
419 void linphone_core_set_log_level(OrtpLogLevel loglevel) {
420         ortp_set_log_level_mask(loglevel);
421 }
422
423 /**
424  * Enable logs in supplied FILE*.
425  *
426  * @ingroup misc
427  * @deprecated Use #linphone_core_set_log_file and #linphone_core_set_log_level instead.
428  *
429  * @param file a C FILE* where to fprintf logs. If null stdout is used.
430  *
431 **/
432 void linphone_core_enable_logs(FILE *file){
433         if (file==NULL) file=stdout;
434         ortp_set_log_file(file);
435         ortp_set_log_level_mask(ORTP_MESSAGE|ORTP_WARNING|ORTP_ERROR|ORTP_FATAL);
436 }
437
438 /**
439  * Enable logs through the user's supplied log callback.
440  *
441  * @ingroup misc
442  * @deprecated Use #linphone_core_set_log_handler and #linphone_core_set_log_level instead.
443  *
444  * @param logfunc The address of a OrtpLogFunc callback whose protoype is
445  *                typedef void (*OrtpLogFunc)(OrtpLogLevel lev, const char *fmt, va_list args);
446  *
447 **/
448 void linphone_core_enable_logs_with_cb(OrtpLogFunc logfunc){
449         ortp_set_log_level_mask(ORTP_MESSAGE|ORTP_WARNING|ORTP_ERROR|ORTP_FATAL);
450         ortp_set_log_handler(logfunc);
451 }
452
453 /**
454  * Entirely disable logging.
455  *
456  * @ingroup misc
457  * @deprecated Use #linphone_core_set_log_level instead.
458 **/
459 void linphone_core_disable_logs(){
460         ortp_set_log_level_mask(ORTP_ERROR|ORTP_FATAL);
461 }
462
463
464 static void net_config_read (LinphoneCore *lc)
465 {
466         int tmp;
467         const char *tmpstr;
468         LpConfig *config=lc->config;
469
470         lc->net_conf.nat_address_ip = NULL;
471         tmp=lp_config_get_int(config,"net","download_bw",0);
472         linphone_core_set_download_bandwidth(lc,tmp);
473         tmp=lp_config_get_int(config,"net","upload_bw",0);
474         linphone_core_set_upload_bandwidth(lc,tmp);
475         linphone_core_set_stun_server(lc,lp_config_get_string(config,"net","stun_server",NULL));
476         tmpstr=lp_config_get_string(lc->config,"net","nat_address",NULL);
477         if (tmpstr!=NULL && (strlen(tmpstr)<1)) tmpstr=NULL;
478         linphone_core_set_nat_address(lc,tmpstr);
479         tmp=lp_config_get_int(lc->config,"net","firewall_policy",0);
480         linphone_core_set_firewall_policy(lc,tmp);
481         tmp=lp_config_get_int(lc->config,"net","nat_sdp_only",0);
482         lc->net_conf.nat_sdp_only=tmp;
483         tmp=lp_config_get_int(lc->config,"net","mtu",1300);
484         linphone_core_set_mtu(lc,tmp);
485         tmp=lp_config_get_int(lc->config,"net","download_ptime",0);
486         linphone_core_set_download_ptime(lc,tmp);
487
488 }
489
490 static void build_sound_devices_table(LinphoneCore *lc){
491         const char **devices;
492         const char **old;
493         int ndev;
494         int i;
495         const MSList *elem=ms_snd_card_manager_get_list(ms_snd_card_manager_get());
496         ndev=ms_list_size(elem);
497         devices=ms_malloc((ndev+1)*sizeof(const char *));
498         for (i=0;elem!=NULL;elem=elem->next,i++){
499                 devices[i]=ms_snd_card_get_string_id((MSSndCard *)elem->data);
500         }
501         devices[ndev]=NULL;
502         old=lc->sound_conf.cards;
503         lc->sound_conf.cards=devices;
504         if (old!=NULL) ms_free(old);
505 }
506
507 static void sound_config_read(LinphoneCore *lc)
508 {
509         int tmp;
510         const char *tmpbuf;
511         const char *devid;
512 #ifdef __linux
513         /*alsadev let the user use custom alsa device within linphone*/
514         devid=lp_config_get_string(lc->config,"sound","alsadev",NULL);
515         if (devid){
516                 MSSndCard *card=ms_alsa_card_new_custom(devid,devid);
517                 ms_snd_card_manager_add_card(ms_snd_card_manager_get(),card);
518         }
519         tmp=lp_config_get_int(lc->config,"sound","alsa_forced_rate",-1);
520         if (tmp>0) ms_alsa_card_set_forced_sample_rate(tmp);
521 #endif
522         /* retrieve all sound devices */
523         build_sound_devices_table(lc);
524
525         devid=lp_config_get_string(lc->config,"sound","playback_dev_id",NULL);
526         linphone_core_set_playback_device(lc,devid);
527
528         devid=lp_config_get_string(lc->config,"sound","ringer_dev_id",NULL);
529         linphone_core_set_ringer_device(lc,devid);
530
531         devid=lp_config_get_string(lc->config,"sound","capture_dev_id",NULL);
532         linphone_core_set_capture_device(lc,devid);
533
534 /*
535         tmp=lp_config_get_int(lc->config,"sound","play_lev",80);
536         linphone_core_set_play_level(lc,tmp);
537         tmp=lp_config_get_int(lc->config,"sound","ring_lev",80);
538         linphone_core_set_ring_level(lc,tmp);
539         tmp=lp_config_get_int(lc->config,"sound","rec_lev",80);
540         linphone_core_set_rec_level(lc,tmp);
541         tmpbuf=lp_config_get_string(lc->config,"sound","source","m");
542         linphone_core_set_sound_source(lc,tmpbuf[0]);
543 */
544
545         tmpbuf=PACKAGE_SOUND_DIR "/" LOCAL_RING;
546         tmpbuf=lp_config_get_string(lc->config,"sound","local_ring",tmpbuf);
547         if (ortp_file_exist(tmpbuf)==-1) {
548                 ms_warning("%s does not exist",tmpbuf);
549                 tmpbuf=PACKAGE_SOUND_DIR "/" LOCAL_RING;
550         }
551         if (strstr(tmpbuf,".wav")==NULL){
552                 /* it currently uses old sound files, so replace them */
553                 tmpbuf=PACKAGE_SOUND_DIR "/" LOCAL_RING;
554         }
555         linphone_core_set_ring(lc,tmpbuf);
556
557         tmpbuf=PACKAGE_SOUND_DIR "/" REMOTE_RING;
558         tmpbuf=lp_config_get_string(lc->config,"sound","remote_ring",tmpbuf);
559         if (ortp_file_exist(tmpbuf)==-1){
560                 tmpbuf=PACKAGE_SOUND_DIR "/" REMOTE_RING;
561         }
562         if (strstr(tmpbuf,".wav")==NULL){
563                 /* it currently uses old sound files, so replace them */
564                 tmpbuf=PACKAGE_SOUND_DIR "/" REMOTE_RING;
565         }
566         linphone_core_set_ringback(lc,tmpbuf);
567
568         linphone_core_set_play_file(lc,lp_config_get_string(lc->config,"sound","hold_music",PACKAGE_SOUND_DIR "/" HOLD_MUSIC));
569         check_sound_device(lc);
570         lc->sound_conf.latency=0;
571 #ifndef __ios 
572         tmp=TRUE;
573 #else
574         tmp=FALSE; /* on iOS we have builtin echo cancellation.*/
575 #endif
576         tmp=lp_config_get_int(lc->config,"sound","echocancellation",tmp);
577         linphone_core_enable_echo_cancellation(lc,tmp);
578         linphone_core_enable_echo_limiter(lc,
579                 lp_config_get_int(lc->config,"sound","echolimiter",0));
580         linphone_core_enable_agc(lc,
581                 lp_config_get_int(lc->config,"sound","agc",0));
582
583         linphone_core_set_playback_gain_db (lc,lp_config_get_float(lc->config,"sound","playback_gain_db",0));
584         linphone_core_set_mic_gain_db (lc,lp_config_get_float(lc->config,"sound","mic_gain_db",0));
585
586         linphone_core_set_remote_ringback_tone (lc,lp_config_get_string(lc->config,"sound","ringback_tone",NULL));
587
588         /*just parse requested stream feature once at start to print out eventual errors*/
589         linphone_core_get_audio_features(lc);
590 }
591
592 static void sip_config_read(LinphoneCore *lc)
593 {
594         char *contact;
595         const char *tmpstr;
596         LCSipTransports tr;
597         int i,tmp;
598         int ipv6;
599         int random_port;
600
601         if (lp_config_get_int(lc->config,"sip","use_session_timers",0)==1){
602                 sal_use_session_timers(lc->sal,200);
603         }
604
605         sal_use_rport(lc->sal,lp_config_get_int(lc->config,"sip","use_rport",1));
606         sal_use_101(lc->sal,lp_config_get_int(lc->config,"sip","use_101",1));
607         sal_reuse_authorization(lc->sal, lp_config_get_int(lc->config,"sip","reuse_authorization",0));
608         sal_expire_old_registration_contacts(lc->sal,lp_config_get_int(lc->config,"sip","expire_old_registration_contacts",0));
609
610         ipv6=lp_config_get_int(lc->config,"sip","use_ipv6",-1);
611         if (ipv6==-1){
612                 ipv6=0;
613         }
614         linphone_core_enable_ipv6(lc,ipv6);
615         memset(&tr,0,sizeof(tr));
616         
617         tr.udp_port=lp_config_get_int(lc->config,"sip","sip_port",0);
618         tr.tcp_port=lp_config_get_int(lc->config,"sip","sip_tcp_port",0);
619         tr.tls_port=lp_config_get_int(lc->config,"sip","sip_tls_port",0);
620         
621         if (lp_config_get_int(lc->config,"sip","sip_random_port",0)==1)
622                 random_port=(0xDFFF&random())+1024;
623         else random_port=0;
624         
625         if (tr.udp_port==0 && tr.tcp_port==0 && tr.tls_port==0){
626                 tr.udp_port=5060;
627         }       
628         
629         if (tr.udp_port>0 && random_port){
630                 tr.udp_port=random_port;
631                 tr.tls_port=tr.tcp_port=0; /*make sure only one transport is active at a time*/
632         }else if (tr.tcp_port>0 && random_port){
633                 tr.tcp_port=random_port;
634                 tr.tls_port=tr.udp_port=0; /*make sure only one transport is active at a time*/
635         }else if (tr.tls_port>0 && random_port){
636                 tr.tls_port=random_port;
637                 tr.udp_port=tr.tcp_port=0; /*make sure only one transport is active at a time*/
638         } 
639
640 #ifdef __linux
641         sal_set_root_ca(lc->sal, lp_config_get_string(lc->config,"sip","root_ca", "/etc/ssl/certs"));
642 #else
643         sal_set_root_ca(lc->sal, lp_config_get_string(lc->config,"sip","root_ca", ROOT_CA_FILE));
644 #endif
645         linphone_core_verify_server_certificates(lc,lp_config_get_int(lc->config,"sip","verify_server_certs",TRUE));
646         linphone_core_verify_server_cn(lc,lp_config_get_int(lc->config,"sip","verify_server_cn",TRUE));
647         /*setting the dscp must be done before starting the transports, otherwise it is not taken into effect*/
648         sal_set_dscp(lc->sal,linphone_core_get_sip_dscp(lc));
649         /*start listening on ports*/
650         linphone_core_set_sip_transports(lc,&tr);
651
652         tmpstr=lp_config_get_string(lc->config,"sip","contact",NULL);
653         if (tmpstr==NULL || linphone_core_set_primary_contact(lc,tmpstr)==-1) {
654                 const char *hostname=NULL;
655                 const char *username=NULL;
656 #ifdef HAVE_GETENV
657                 hostname=getenv("HOST");
658                 username=getenv("USER");
659                 if (hostname==NULL) hostname=getenv("HOSTNAME");
660 #endif /*HAVE_GETENV*/
661                 if (hostname==NULL)
662                         hostname="unknown-host";
663                 if (username==NULL){
664                         username="toto";
665                 }
666                 contact=ortp_strdup_printf("sip:%s@%s",username,hostname);
667                 linphone_core_set_primary_contact(lc,contact);
668                 ms_free(contact);
669         }
670
671         tmp=lp_config_get_int(lc->config,"sip","guess_hostname",1);
672         linphone_core_set_guess_hostname(lc,tmp);
673
674
675         tmp=lp_config_get_int(lc->config,"sip","inc_timeout",30);
676         linphone_core_set_inc_timeout(lc,tmp);
677
678         tmp=lp_config_get_int(lc->config,"sip","in_call_timeout",0);
679         linphone_core_set_in_call_timeout(lc,tmp);
680         
681         tmp=lp_config_get_int(lc->config,"sip","delayed_timeout",4);
682         linphone_core_set_delayed_timeout(lc,tmp);
683
684         /* get proxies config */
685         for(i=0;; i++){
686                 LinphoneProxyConfig *cfg=linphone_proxy_config_new_from_config_file(lc->config,i);
687                 if (cfg!=NULL){
688                         linphone_core_add_proxy_config(lc,cfg);
689                 }else{
690                         break;
691                 }
692         }
693         /* get the default proxy */
694         tmp=lp_config_get_int(lc->config,"sip","default_proxy",-1);
695         linphone_core_set_default_proxy_index(lc,tmp);
696
697         /* read authentication information */
698         for(i=0;; i++){
699                 LinphoneAuthInfo *ai=linphone_auth_info_new_from_config_file(lc->config,i);
700                 if (ai!=NULL){
701                         linphone_core_add_auth_info(lc,ai);
702                         linphone_auth_info_destroy(ai);
703                 }else{
704                         break;
705                 }
706         }
707         /*this is to filter out unsupported encryption schemes*/
708         linphone_core_set_media_encryption(lc,linphone_core_get_media_encryption(lc));
709
710         /*for tuning or test*/
711         lc->sip_conf.sdp_200_ack=lp_config_get_int(lc->config,"sip","sdp_200_ack",0);
712         lc->sip_conf.register_only_when_network_is_up=
713                 lp_config_get_int(lc->config,"sip","register_only_when_network_is_up",1);
714         lc->sip_conf.register_only_when_upnp_is_ok=
715                 lp_config_get_int(lc->config,"sip","register_only_when_upnp_is_ok",1);
716         lc->sip_conf.ping_with_options=lp_config_get_int(lc->config,"sip","ping_with_options",1);
717         lc->sip_conf.auto_net_state_mon=lp_config_get_int(lc->config,"sip","auto_net_state_mon",1);
718         lc->sip_conf.keepalive_period=lp_config_get_int(lc->config,"sip","keepalive_period",10000);
719         lc->sip_conf.tcp_tls_keepalive=lp_config_get_int(lc->config,"sip","tcp_tls_keepalive",0);
720         linphone_core_enable_keep_alive(lc, (lc->sip_conf.keepalive_period > 0));
721         sal_use_one_matching_codec_policy(lc->sal,lp_config_get_int(lc->config,"sip","only_one_codec",0));
722         sal_use_double_registrations(lc->sal,lp_config_get_int(lc->config,"sip","use_double_registrations",1));
723         sal_use_dates(lc->sal,lp_config_get_int(lc->config,"sip","put_date",0));
724 }
725
726 static void rtp_config_read(LinphoneCore *lc)
727 {
728         int min_port, max_port;
729         int jitt_comp;
730         int nortp_timeout;
731         bool_t rtp_no_xmit_on_audio_mute;
732         bool_t adaptive_jitt_comp_enabled;
733
734         if (lp_config_get_range(lc->config, "rtp", "audio_rtp_port", &min_port, &max_port, 7078, 7078) == TRUE) {
735                 if (min_port <= 0) min_port = 1;
736                 if (max_port > 65535) max_port = 65535;
737                 linphone_core_set_audio_port_range(lc, min_port, max_port);
738         } else {
739                 min_port = lp_config_get_int(lc->config, "rtp", "audio_rtp_port", 7078);
740                 linphone_core_set_audio_port(lc, min_port);
741         }
742
743         if (lp_config_get_range(lc->config, "rtp", "video_rtp_port", &min_port, &max_port, 9078, 9078) == TRUE) {
744                 if (min_port <= 0) min_port = 1;
745                 if (max_port > 65535) max_port = 65535;
746                 linphone_core_set_video_port_range(lc, min_port, max_port);
747         } else {
748                 min_port = lp_config_get_int(lc->config, "rtp", "video_rtp_port", 9078);
749                 linphone_core_set_video_port(lc, min_port);
750         }
751
752         jitt_comp=lp_config_get_int(lc->config,"rtp","audio_jitt_comp",60);
753         linphone_core_set_audio_jittcomp(lc,jitt_comp);
754         jitt_comp=lp_config_get_int(lc->config,"rtp","video_jitt_comp",60);
755         if (jitt_comp==0) jitt_comp=60;
756         linphone_core_set_video_jittcomp(lc,jitt_comp);
757         nortp_timeout=lp_config_get_int(lc->config,"rtp","nortp_timeout",30);
758         linphone_core_set_nortp_timeout(lc,nortp_timeout);
759         rtp_no_xmit_on_audio_mute=lp_config_get_int(lc->config,"rtp","rtp_no_xmit_on_audio_mute",FALSE);
760         linphone_core_set_rtp_no_xmit_on_audio_mute(lc,rtp_no_xmit_on_audio_mute);
761         adaptive_jitt_comp_enabled = lp_config_get_int(lc->config, "rtp", "audio_adaptive_jitt_comp_enabled", TRUE);
762         linphone_core_enable_audio_adaptive_jittcomp(lc, adaptive_jitt_comp_enabled);
763         adaptive_jitt_comp_enabled = lp_config_get_int(lc->config, "rtp", "video_adaptive_jitt_comp_enabled", TRUE);
764         linphone_core_enable_video_adaptive_jittcomp(lc, adaptive_jitt_comp_enabled);
765         lc->rtp_conf.disable_upnp = lp_config_get_int(lc->config, "rtp", "disable_upnp", FALSE);
766 }
767
768 static PayloadType * find_payload(RtpProfile *prof, const char *mime_type, int clock_rate, int channels, const char *recv_fmtp){
769         PayloadType *candidate=NULL;
770         int i;
771         PayloadType *it;
772         for(i=0;i<RTP_PROFILE_MAX_PAYLOADS;++i){
773                 it=rtp_profile_get_payload(prof,i);
774                 if (it!=NULL && strcasecmp(mime_type,it->mime_type)==0
775                         && (clock_rate==it->clock_rate || clock_rate<=0)
776                         && (channels==it->channels || channels<=0) ){
777                         if ( (recv_fmtp && it->recv_fmtp && strstr(recv_fmtp,it->recv_fmtp)!=NULL) ||
778                                 (recv_fmtp==NULL && it->recv_fmtp==NULL) ){
779                                 /*exact match*/
780                                 if (recv_fmtp) payload_type_set_recv_fmtp(it,recv_fmtp);
781                                 return it;
782                         }else {
783                                 if (candidate){
784                                         if (it->recv_fmtp==NULL) candidate=it;
785                                 }else candidate=it;
786                         }
787                 }
788         }
789         if (candidate && recv_fmtp){
790                 payload_type_set_recv_fmtp(candidate,recv_fmtp);
791         }
792         return candidate;
793 }
794
795 static bool_t get_codec(LinphoneCore *lc, const char* type, int index, PayloadType **ret){
796         char codeckey[50];
797         const char *mime,*fmtp;
798         int rate,channels,enabled;
799         PayloadType *pt;
800         LpConfig *config=lc->config;
801
802         *ret=NULL;
803         snprintf(codeckey,50,"%s_%i",type,index);
804         mime=lp_config_get_string(config,codeckey,"mime",NULL);
805         if (mime==NULL || strlen(mime)==0 ) return FALSE;
806
807         rate=lp_config_get_int(config,codeckey,"rate",8000);
808         fmtp=lp_config_get_string(config,codeckey,"recv_fmtp",NULL);
809         channels=lp_config_get_int(config,codeckey,"channels",0);
810         enabled=lp_config_get_int(config,codeckey,"enabled",1);
811         pt=find_payload(lc->default_profile,mime,rate,channels,fmtp);
812         if (pt && enabled ) pt->flags|=PAYLOAD_TYPE_ENABLED;
813         //ms_message("Found codec %s/%i",pt->mime_type,pt->clock_rate);
814         if (pt==NULL) ms_warning("Ignoring codec config %s/%i with fmtp=%s because unsupported",
815                         mime,rate,fmtp ? fmtp : "");
816         *ret=pt;
817         return TRUE;
818 }
819
820 #define RANK_END 10000
821
822 typedef struct codec_desc{
823         const char *name;
824         int rate;
825 }codec_desc_t;
826
827 static codec_desc_t codec_pref_order[]={
828         {"opus", 48000},
829         {"SILK", 16000},
830         {"speex", 16000},
831         {"speex", 8000},
832         {"pcmu",8000},
833         {"pcma",8000},
834         {"VP8",90000},
835         {"H264",90000},
836         {"MP4V-ES",90000},
837         {NULL,0}
838 };
839
840 static int find_codec_rank(const char *mime, int clock_rate){
841         int i;
842         for(i=0;codec_pref_order[i].name!=NULL;++i){
843                 if (strcasecmp(codec_pref_order[i].name,mime)==0 && clock_rate==codec_pref_order[i].rate)
844                         return i;
845         }
846         return RANK_END;
847 }
848
849 static int codec_compare(const PayloadType *a, const PayloadType *b){
850         int ra,rb;
851         ra=find_codec_rank(a->mime_type,a->clock_rate);
852         rb=find_codec_rank(b->mime_type,b->clock_rate);
853         if (ra>rb) return 1;
854         if (ra<rb) return -1;
855         return 0;
856 }
857
858 static MSList *add_missing_codecs(LinphoneCore *lc, SalStreamType mtype, MSList *l){
859         int i;
860         for(i=0;i<RTP_PROFILE_MAX_PAYLOADS;++i){
861                 PayloadType *pt=rtp_profile_get_payload(lc->default_profile,i);
862                 if (pt){
863                         if (mtype==SalVideo && pt->type!=PAYLOAD_VIDEO)
864                                 pt=NULL;
865                         else if (mtype==SalAudio && (pt->type!=PAYLOAD_AUDIO_PACKETIZED
866                             && pt->type!=PAYLOAD_AUDIO_CONTINUOUS)){
867                                 pt=NULL;
868                         }
869                         if (pt && ms_filter_codec_supported(pt->mime_type)){
870                                 if (ms_list_find(l,pt)==NULL){
871                                         /*unranked codecs are disabled by default*/
872                                         if (find_codec_rank(pt->mime_type, pt->clock_rate)!=RANK_END){
873                                                 payload_type_set_flag(pt,PAYLOAD_TYPE_ENABLED);
874                                         }
875                                         ms_message("Adding new codec %s/%i with fmtp %s",
876                                             pt->mime_type,pt->clock_rate,pt->recv_fmtp ? pt->recv_fmtp : "");
877                                         l=ms_list_insert_sorted(l,pt,(int (*)(const void *, const void *))codec_compare);
878                                 }
879                         }
880                 }
881         }
882         return l;
883 }
884
885 static MSList *codec_append_if_new(MSList *l, PayloadType *pt){
886         MSList *elem;
887         for (elem=l;elem!=NULL;elem=elem->next){
888                 PayloadType *ept=(PayloadType*)elem->data;
889                 if (pt==ept)
890                         return l;
891         }
892         l=ms_list_append(l,pt);
893         return l;
894 }
895
896 static void codecs_config_read(LinphoneCore *lc)
897 {
898         int i;
899         PayloadType *pt;
900         MSList *audio_codecs=NULL;
901         MSList *video_codecs=NULL;
902         for (i=0;get_codec(lc,"audio_codec",i,&pt);i++){
903                 if (pt){
904                         if (!ms_filter_codec_supported(pt->mime_type)){
905                                 ms_warning("Codec %s is not supported by mediastreamer2, removed.",pt->mime_type);
906                         }else audio_codecs=codec_append_if_new(audio_codecs,pt);
907                 }
908         }
909         audio_codecs=add_missing_codecs(lc,SalAudio,audio_codecs);
910         for (i=0;get_codec(lc,"video_codec",i,&pt);i++){
911                 if (pt){
912                         if (!ms_filter_codec_supported(pt->mime_type)){
913                                 ms_warning("Codec %s is not supported by mediastreamer2, removed.",pt->mime_type);
914                         }else video_codecs=codec_append_if_new(video_codecs,(void *)pt);
915                 }
916         }
917         video_codecs=add_missing_codecs(lc,SalVideo,video_codecs);
918         linphone_core_set_audio_codecs(lc,audio_codecs);
919         linphone_core_set_video_codecs(lc,video_codecs);
920         linphone_core_update_allocated_audio_bandwidth(lc);
921 }
922
923 static void build_video_devices_table(LinphoneCore *lc){
924         const MSList *elem;
925         int i;
926         int ndev;
927         const char **devices;
928         if (lc->video_conf.cams)
929                 ms_free(lc->video_conf.cams);
930         /* retrieve all video devices */
931         elem=ms_web_cam_manager_get_list(ms_web_cam_manager_get());
932         ndev=ms_list_size(elem);
933         devices=ms_malloc((ndev+1)*sizeof(const char *));
934         for (i=0;elem!=NULL;elem=elem->next,i++){
935                 devices[i]=ms_web_cam_get_string_id((MSWebCam *)elem->data);
936         }
937         devices[ndev]=NULL;
938         lc->video_conf.cams=devices;
939 }
940
941 static void video_config_read(LinphoneCore *lc){
942 #ifdef VIDEO_ENABLED
943         int capture, display, self_view;
944 #endif
945         const char *str;        
946 #ifdef VIDEO_ENABLED    
947         LinphoneVideoPolicy vpol;
948         memset(&vpol, 0, sizeof(LinphoneVideoPolicy));
949 #endif
950         build_video_devices_table(lc);
951
952         str=lp_config_get_string(lc->config,"video","device",NULL);
953         if (str && str[0]==0) str=NULL;
954         linphone_core_set_video_device(lc,str);
955
956         linphone_core_set_preferred_video_size_by_name(lc,
957                 lp_config_get_string(lc->config,"video","size","cif"));
958
959 #ifdef VIDEO_ENABLED
960         capture=lp_config_get_int(lc->config,"video","capture",1);
961         display=lp_config_get_int(lc->config,"video","display",1);
962         self_view=lp_config_get_int(lc->config,"video","self_view",1);
963         vpol.automatically_initiate=lp_config_get_int(lc->config,"video","automatically_initiate",1);
964         vpol.automatically_accept=lp_config_get_int(lc->config,"video","automatically_accept",1);
965         lc->video_conf.displaytype=lp_config_get_string(lc->config,"video","displaytype",NULL);
966         if(lc->video_conf.displaytype)
967                 ms_message("we are using a specific display:%s\n",lc->video_conf.displaytype);
968
969         linphone_core_enable_video(lc,capture,display);
970         linphone_core_enable_video_preview(lc,lp_config_get_int(lc->config,"video","show_local",0));
971         linphone_core_enable_self_view(lc,self_view);
972         linphone_core_set_video_policy(lc,&vpol);
973 #endif
974 }
975
976 static void ui_config_read(LinphoneCore *lc)
977 {
978         LinphoneFriend *lf;
979         int i;
980         for (i=0;(lf=linphone_friend_new_from_config_file(lc,i))!=NULL;i++){
981                 linphone_core_add_friend(lc,lf);
982         }
983         call_logs_read_from_config_file(lc);
984 }
985
986 /*
987 static void autoreplier_config_init(LinphoneCore *lc)
988 {
989         autoreplier_config_t *config=&lc->autoreplier_conf;
990         config->enabled=lp_config_get_int(lc->config,"autoreplier","enabled",0);
991         config->after_seconds=lp_config_get_int(lc->config,"autoreplier","after_seconds",6);
992         config->max_users=lp_config_get_int(lc->config,"autoreplier","max_users",1);
993         config->max_rec_time=lp_config_get_int(lc->config,"autoreplier","max_rec_time",60);
994         config->max_rec_msg=lp_config_get_int(lc->config,"autoreplier","max_rec_msg",10);
995         config->message=lp_config_get_string(lc->config,"autoreplier","message",NULL);
996 }
997 */
998
999 bool_t linphone_core_tunnel_available(void){
1000 #ifdef TUNNEL_ENABLED
1001         return TRUE;
1002 #else
1003         return FALSE;
1004 #endif
1005 }
1006
1007 /**
1008  * Enable adaptive rate control.
1009  * 
1010  * @ingroup media_parameters
1011  *
1012  * Adaptive rate control consists in using RTCP feedback provided information to dynamically
1013  * control the output bitrate of the audio and video encoders, so that we can adapt to the network conditions and
1014  * available bandwidth. Control of the audio encoder is done in case of audio-only call, and control of the video encoder is done for audio & video calls.
1015  * Adaptive rate control feature is enabled by default.
1016 **/
1017 void linphone_core_enable_adaptive_rate_control(LinphoneCore *lc, bool_t enabled){
1018         lp_config_set_int(lc->config,"net","adaptive_rate_control",(int)enabled);
1019 }
1020
1021 /**
1022  * Returns whether adaptive rate control is enabled.
1023  * 
1024  * @ingroup media_parameters
1025  *
1026  * See linphone_core_enable_adaptive_rate_control().
1027 **/
1028 bool_t linphone_core_adaptive_rate_control_enabled(const LinphoneCore *lc){
1029         return lp_config_get_int(lc->config,"net","adaptive_rate_control",TRUE);
1030 }
1031
1032 bool_t linphone_core_rtcp_enabled(const LinphoneCore *lc){
1033         return lp_config_get_int(lc->config,"rtp","rtcp_enabled",TRUE);
1034 }
1035
1036 /**
1037  * Sets maximum available download bandwidth
1038  *
1039  * @ingroup media_parameters
1040  *
1041  * This is IP bandwidth, in kbit/s.
1042  * This information is used signaled to other parties during
1043  * calls (within SDP messages) so that the remote end can have
1044  * sufficient knowledge to properly configure its audio & video
1045  * codec output bitrate to not overflow available bandwidth.
1046  *
1047  * @param lc the LinphoneCore object
1048  * @param bw the bandwidth in kbits/s, 0 for infinite
1049  */
1050 void linphone_core_set_download_bandwidth(LinphoneCore *lc, int bw){
1051         lc->net_conf.download_bw=bw;
1052         if (linphone_core_ready(lc)) lp_config_set_int(lc->config,"net","download_bw",bw);
1053 }
1054
1055 /**
1056  * Sets maximum available upload bandwidth
1057  *
1058  * @ingroup media_parameters
1059  *
1060  * This is IP bandwidth, in kbit/s.
1061  * This information is used by liblinphone together with remote
1062  * side available bandwidth signaled in SDP messages to properly
1063  * configure audio & video codec's output bitrate.
1064  *
1065  * @param lc the LinphoneCore object
1066  * @param bw the bandwidth in kbits/s, 0 for infinite
1067  */
1068 void linphone_core_set_upload_bandwidth(LinphoneCore *lc, int bw){
1069         lc->net_conf.upload_bw=bw;
1070         if (linphone_core_ready(lc)) lp_config_set_int(lc->config,"net","upload_bw",bw);
1071 }
1072
1073 /**
1074  * Retrieve the maximum available download bandwidth.
1075  *
1076  * @ingroup media_parameters
1077  *
1078  * This value was set by linphone_core_set_download_bandwidth().
1079  *
1080 **/
1081 int linphone_core_get_download_bandwidth(const LinphoneCore *lc){
1082         return lc->net_conf.download_bw;
1083 }
1084
1085 /**
1086  * Retrieve the maximum available upload bandwidth.
1087  *
1088  * @ingroup media_parameters
1089  *
1090  * This value was set by linphone_core_set_upload_bandwidth().
1091  *
1092 **/
1093 int linphone_core_get_upload_bandwidth(const LinphoneCore *lc){
1094         return lc->net_conf.upload_bw;
1095 }
1096 /**
1097  * Set audio packetization time linphone expects to receive from peer.
1098  * A value of zero means that ptime is not specified.
1099  * @ingroup media_parameters
1100  */
1101 void linphone_core_set_download_ptime(LinphoneCore *lc, int ptime) {
1102         lp_config_set_int(lc->config,"rtp","download_ptime",ptime);
1103 }
1104
1105 /**
1106  * Get audio packetization time linphone expects to receive from peer.
1107  * A value of zero means that ptime is not specified.
1108  * @ingroup media_parameters
1109  */
1110 int linphone_core_get_download_ptime(LinphoneCore *lc) {
1111         return lp_config_get_int(lc->config,"rtp","download_ptime",0);
1112 }
1113
1114 /**
1115  * Set audio packetization time linphone will send (in absence of requirement from peer)
1116  * A value of 0 stands for the current codec default packetization time.
1117  *
1118  * @ingroup media_parameters
1119 **/
1120 void linphone_core_set_upload_ptime(LinphoneCore *lc, int ptime){
1121         lp_config_set_int(lc->config,"rtp","upload_ptime",ptime);
1122 }
1123
1124 /**
1125  * Set audio packetization time linphone will send (in absence of requirement from peer)
1126  * A value of 0 stands for the current codec default packetization time.
1127  *
1128  * 
1129  * @ingroup media_parameters
1130 **/
1131 int linphone_core_get_upload_ptime(LinphoneCore *lc){
1132         return lp_config_get_int(lc->config,"rtp","upload_ptime",0);
1133 }
1134
1135
1136
1137 /**
1138  * Returns liblinphone's version as a string.
1139  *
1140  * @ingroup misc
1141  *
1142 **/
1143 const char * linphone_core_get_version(void){
1144         return liblinphone_version;
1145 }
1146
1147 static void linphone_core_assign_payload_type(LinphoneCore *lc, PayloadType *const_pt, int number, const char *recv_fmtp){
1148         PayloadType *pt;
1149         pt=payload_type_clone(const_pt);
1150         if (number==-1){
1151                 /*look for a free number */
1152                 MSList *elem;
1153                 int i;
1154                 for(i=lc->dyn_pt;i<RTP_PROFILE_MAX_PAYLOADS;++i){
1155                         bool_t already_assigned=FALSE;
1156                         for(elem=lc->payload_types;elem!=NULL;elem=elem->next){
1157                                 PayloadType *it=(PayloadType*)elem->data;
1158                                 if (payload_type_get_number(it)==i){
1159                                         already_assigned=TRUE;
1160                                         break;
1161                                 }
1162                         }
1163                         if (!already_assigned){
1164                                 number=i;
1165                                 lc->dyn_pt=i+1;
1166                                 break;
1167                         }
1168                 }
1169                 if (number==-1){
1170                         ms_fatal("FIXME: too many codecs, no more free numbers.");
1171                 }
1172         }
1173         ms_message("assigning %s/%i payload type number %i",pt->mime_type,pt->clock_rate,number);
1174         payload_type_set_number(pt,number);
1175         if (recv_fmtp!=NULL) payload_type_set_recv_fmtp(pt,recv_fmtp);
1176         rtp_profile_set_payload(lc->default_profile,number,pt);
1177         lc->payload_types=ms_list_append(lc->payload_types,pt);
1178 }
1179
1180 static void linphone_core_handle_static_payloads(LinphoneCore *lc){
1181         RtpProfile *prof=&av_profile;
1182         int i;
1183         for(i=0;i<RTP_PROFILE_MAX_PAYLOADS;++i){
1184                 PayloadType *pt=rtp_profile_get_payload(prof,i);
1185                 if (pt){
1186                         if (payload_type_get_number(pt)!=i){
1187                                 linphone_core_assign_payload_type(lc,pt,i,NULL);
1188                         }
1189                 }
1190         }
1191 }
1192
1193 static void linphone_core_free_payload_types(LinphoneCore *lc){
1194         rtp_profile_clear_all(lc->default_profile);
1195         rtp_profile_destroy(lc->default_profile);
1196         ms_list_for_each(lc->payload_types,(void (*)(void*))payload_type_destroy);
1197         ms_list_free(lc->payload_types);
1198         lc->payload_types=NULL;
1199 }
1200
1201 void linphone_core_set_state(LinphoneCore *lc, LinphoneGlobalState gstate, const char *message){
1202         lc->state=gstate;
1203         if (lc->vtable.global_state_changed){
1204                 lc->vtable.global_state_changed(lc,gstate,message);
1205         }
1206 }
1207 static void misc_config_read (LinphoneCore *lc) {
1208         LpConfig *config=lc->config;
1209         lc->max_call_logs=lp_config_get_int(config,"misc","history_max_size",15);
1210         lc->max_calls=lp_config_get_int(config,"misc","max_calls",NB_MAX_CALLS);
1211 }
1212
1213
1214
1215
1216 static void linphone_core_init (LinphoneCore * lc, const LinphoneCoreVTable *vtable, LpConfig *config, void * userdata)
1217 {
1218         ms_message("Initializing LinphoneCore %s", linphone_core_get_version());
1219         memset (lc, 0, sizeof (LinphoneCore));
1220         lc->config=config;
1221         lc->data=userdata;
1222         lc->ringstream_autorelease=TRUE;
1223
1224         memcpy(&lc->vtable,vtable,sizeof(LinphoneCoreVTable));
1225
1226         linphone_core_set_state(lc,LinphoneGlobalStartup,"Starting up");
1227         ortp_init();
1228         lc->dyn_pt=96;
1229         lc->default_profile=rtp_profile_new("default profile");
1230         linphone_core_assign_payload_type(lc,&payload_type_pcmu8000,0,NULL);
1231         linphone_core_assign_payload_type(lc,&payload_type_gsm,3,NULL);
1232         linphone_core_assign_payload_type(lc,&payload_type_pcma8000,8,NULL);
1233         linphone_core_assign_payload_type(lc,&payload_type_speex_nb,110,"vbr=on");
1234         linphone_core_assign_payload_type(lc,&payload_type_speex_wb,111,"vbr=on");
1235         linphone_core_assign_payload_type(lc,&payload_type_speex_uwb,112,"vbr=on");
1236         linphone_core_assign_payload_type(lc,&payload_type_telephone_event,101,"0-11");
1237         linphone_core_assign_payload_type(lc,&payload_type_g722,9,NULL);
1238
1239 #if defined(ANDROID) || defined (__IPHONE_OS_VERSION_MIN_REQUIRED)
1240         /*shorten the DNS lookup time and send more retransmissions on mobiles:
1241          - to workaround potential packet losses
1242          - to avoid hanging for 30 seconds when the network doesn't work despite the phone thinks it does.
1243          */
1244         _linphone_core_configure_resolver();
1245 #endif
1246
1247 #ifdef ENABLE_NONSTANDARD_GSM
1248         {
1249                 PayloadType *pt;
1250                 pt=payload_type_clone(&payload_type_gsm);
1251                 pt->clock_rate=11025;
1252                 linphone_core_assign_payload_type(lc,pt,-1,NULL);
1253                 pt->clock_rate=22050;
1254                 linphone_core_assign_payload_type(lc,pt,-1,NULL);
1255                 payload_type_destroy(pt);
1256         }
1257 #endif
1258
1259 #ifdef VIDEO_ENABLED
1260         linphone_core_assign_payload_type(lc,&payload_type_h263,34,NULL);
1261         linphone_core_assign_payload_type(lc,&payload_type_theora,97,NULL);
1262         linphone_core_assign_payload_type(lc,&payload_type_h263_1998,98,"CIF=1;QCIF=1");
1263         linphone_core_assign_payload_type(lc,&payload_type_mp4v,99,"profile-level-id=3");
1264         linphone_core_assign_payload_type(lc,&payload_type_h264,102,"profile-level-id=428014");
1265         linphone_core_assign_payload_type(lc,&payload_type_vp8,103,NULL);
1266         linphone_core_assign_payload_type(lc,&payload_type_x_snow,-1,NULL);
1267         /* due to limited space in SDP, we have to disable this h264 line which is normally no more necessary */
1268         /* linphone_core_assign_payload_type(&payload_type_h264,-1,"packetization-mode=1;profile-level-id=428014");*/
1269 #endif
1270
1271         /*add all payload type for which we don't care about the number */
1272         linphone_core_assign_payload_type(lc,&payload_type_ilbc,-1,"mode=30");
1273         linphone_core_assign_payload_type(lc,&payload_type_amr,-1,"octet-align=1");
1274         linphone_core_assign_payload_type(lc,&payload_type_amrwb,-1,"octet-align=1");
1275         linphone_core_assign_payload_type(lc,&payload_type_lpc1015,-1,NULL);
1276         linphone_core_assign_payload_type(lc,&payload_type_g726_16,-1,NULL);
1277         linphone_core_assign_payload_type(lc,&payload_type_g726_24,-1,NULL);
1278         linphone_core_assign_payload_type(lc,&payload_type_g726_32,-1,NULL);
1279         linphone_core_assign_payload_type(lc,&payload_type_g726_40,-1,NULL);
1280         linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_16,-1,NULL);
1281         linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_24,-1,NULL);
1282         linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_32,-1,NULL);
1283         linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_40,-1,NULL);
1284         linphone_core_assign_payload_type(lc,&payload_type_silk_nb,-1,NULL);
1285         linphone_core_assign_payload_type(lc,&payload_type_silk_mb,-1,NULL);
1286         linphone_core_assign_payload_type(lc,&payload_type_silk_wb,-1,NULL);
1287         linphone_core_assign_payload_type(lc,&payload_type_silk_swb,-1,NULL);
1288         linphone_core_assign_payload_type(lc,&payload_type_g729,18,"annexb=no");
1289         linphone_core_assign_payload_type(lc,&payload_type_aaceld_22k,-1,"config=F8EE2000; constantDuration=512;  indexDeltaLength=3; indexLength=3; mode=AAC-hbr; profile-level-id=76; sizeLength=13; streamType=5");
1290         linphone_core_assign_payload_type(lc,&payload_type_aaceld_44k,-1,"config=F8E82000; constantDuration=512;  indexDeltaLength=3; indexLength=3; mode=AAC-hbr; profile-level-id=76; sizeLength=13; streamType=5");
1291         linphone_core_assign_payload_type(lc,&payload_type_opus,-1,"useinbandfec=1; usedtx=1");
1292         linphone_core_handle_static_payloads(lc);
1293         
1294         ms_init();
1295         /* create a mediastreamer2 event queue and set it as global */
1296         /* This allows to run event's callback in linphone_core_iterate() */
1297         lc->msevq=ms_event_queue_new();
1298         ms_set_global_event_queue(lc->msevq);
1299
1300         lc->sal=sal_init();
1301         sal_set_user_pointer(lc->sal,lc);
1302         sal_set_callbacks(lc->sal,&linphone_sal_callbacks);
1303
1304         lc->network_last_check = 0;
1305         lc->network_last_status = FALSE;
1306
1307         sip_setup_register_all();
1308         sound_config_read(lc);
1309         net_config_read(lc);
1310         rtp_config_read(lc);
1311         codecs_config_read(lc);
1312         sip_config_read(lc); /* this will start eXosip*/
1313         video_config_read(lc);
1314         //autoreplier_config_init(&lc->autoreplier_conf);
1315         lc->presence_mode=LinphoneStatusOnline;
1316         misc_config_read(lc);
1317         ui_config_read(lc);
1318 #ifdef TUNNEL_ENABLED
1319         lc->tunnel=linphone_core_tunnel_new(lc);
1320         if (lc->tunnel) linphone_tunnel_configure(lc->tunnel);
1321 #endif
1322         if (lc->vtable.display_status)
1323                 lc->vtable.display_status(lc,_("Ready"));
1324         lc->auto_net_state_mon=lc->sip_conf.auto_net_state_mon;
1325         linphone_core_set_state(lc,LinphoneGlobalOn,"Ready");
1326 }
1327
1328 /**
1329  * Instanciates a LinphoneCore object.
1330  * @ingroup initializing
1331  *
1332  * The LinphoneCore object is the primary handle for doing all phone actions.
1333  * It should be unique within your application.
1334  * @param vtable a LinphoneCoreVTable structure holding your application callbacks
1335  * @param config_path a path to a config file. If it does not exists it will be created.
1336  *        The config file is used to store all settings, call logs, friends, proxies... so that all these settings
1337  *             become persistent over the life of the LinphoneCore object.
1338  *             It is allowed to set a NULL config file. In that case LinphoneCore will not store any settings.
1339  * @param factory_config_path a path to a read-only config file that can be used to
1340  *        to store hard-coded preference such as proxy settings or internal preferences.
1341  *        The settings in this factory file always override the one in the normal config file.
1342  *        It is OPTIONAL, use NULL if unneeded.
1343  * @param userdata an opaque user pointer that can be retrieved at any time (for example in
1344  *        callbacks) using linphone_core_get_user_data().
1345  * @see linphone_core_new_with_config
1346 **/
1347 LinphoneCore *linphone_core_new(const LinphoneCoreVTable *vtable,
1348                                                 const char *config_path, const char *factory_config_path, void * userdata)
1349 {
1350         LpConfig *config = lp_config_new_with_factory(config_path, factory_config_path);
1351         return linphone_core_new_with_config(vtable, config, userdata);
1352 }
1353
1354 LinphoneCore *linphone_core_new_with_config(const LinphoneCoreVTable *vtable, struct _LpConfig *config, void *userdata)
1355 {
1356         LinphoneCore *core = ms_new(LinphoneCore, 1);
1357         linphone_core_init(core, vtable, config, userdata);
1358         return core;
1359 }
1360
1361 /**
1362  * Returns the list of available audio codecs.
1363  *
1364  * This list is unmodifiable. The ->data field of the MSList points a PayloadType
1365  * structure holding the codec information.
1366  * It is possible to make copy of the list with ms_list_copy() in order to modify it
1367  * (such as the order of codecs).
1368  * @ingroup media_parameters
1369 **/
1370 const MSList *linphone_core_get_audio_codecs(const LinphoneCore *lc)
1371 {
1372         return lc->codecs_conf.audio_codecs;
1373 }
1374
1375 /**
1376  * Returns the list of available video codecs.
1377  *
1378  * This list is unmodifiable. The ->data field of the MSList points a PayloadType
1379  * structure holding the codec information.
1380  * It is possible to make copy of the list with ms_list_copy() in order to modify it
1381  * (such as the order of codecs).
1382  * @ingroup media_parameters
1383 **/
1384 const MSList *linphone_core_get_video_codecs(const LinphoneCore *lc)
1385 {
1386         return lc->codecs_conf.video_codecs;
1387 }
1388
1389 /**
1390  * Sets the local "from" identity.
1391  *
1392  * @ingroup proxies
1393  * This data is used in absence of any proxy configuration or when no
1394  * default proxy configuration is set. See LinphoneProxyConfig
1395 **/
1396 int linphone_core_set_primary_contact(LinphoneCore *lc, const char *contact)
1397 {
1398         LinphoneAddress *ctt;
1399
1400         if ((ctt=linphone_address_new(contact))==0) {
1401                 ms_error("Bad contact url: %s",contact);
1402                 return -1;
1403         }
1404         if (lc->sip_conf.contact!=NULL) ms_free(lc->sip_conf.contact);
1405         lc->sip_conf.contact=ms_strdup(contact);
1406         if (lc->sip_conf.guessed_contact!=NULL){
1407                 ms_free(lc->sip_conf.guessed_contact);
1408                 lc->sip_conf.guessed_contact=NULL;
1409         }
1410         linphone_address_destroy(ctt);
1411         return 0;
1412 }
1413
1414
1415 /*result must be an array of chars at least LINPHONE_IPADDR_SIZE */
1416 void linphone_core_get_local_ip(LinphoneCore *lc, const char *dest, char *result){
1417         const char *ip;
1418         if (linphone_core_get_firewall_policy(lc)==LinphonePolicyUseNatAddress
1419             && (ip=linphone_core_get_nat_address_resolved(lc))!=NULL){
1420                 strncpy(result,ip,LINPHONE_IPADDR_SIZE);
1421                 return;
1422         }
1423 #ifdef BUILD_UPNP
1424         else if (lc->upnp != NULL && linphone_core_get_firewall_policy(lc)==LinphonePolicyUseUpnp &&
1425                         linphone_upnp_context_get_state(lc->upnp) == LinphoneUpnpStateOk) {
1426                 ip = linphone_upnp_context_get_external_ipaddress(lc->upnp);
1427                 strncpy(result,ip,LINPHONE_IPADDR_SIZE);
1428                 return;
1429         }
1430 #endif //BUILD_UPNP
1431         if (linphone_core_get_local_ip_for(lc->sip_conf.ipv6_enabled ? AF_INET6 : AF_INET,dest,result)==0)
1432                 return;
1433         /*else fallback to SAL routine that will attempt to find the most realistic interface */
1434         sal_get_default_local_ip(lc->sal,lc->sip_conf.ipv6_enabled ? AF_INET6 : AF_INET,result,LINPHONE_IPADDR_SIZE);
1435 }
1436
1437 static void update_primary_contact(LinphoneCore *lc){
1438         char *guessed=NULL;
1439         char tmp[LINPHONE_IPADDR_SIZE];
1440
1441         LinphoneAddress *url;
1442         if (lc->sip_conf.guessed_contact!=NULL){
1443                 ms_free(lc->sip_conf.guessed_contact);
1444                 lc->sip_conf.guessed_contact=NULL;
1445         }
1446         url=linphone_address_new(lc->sip_conf.contact);
1447         if (!url){
1448                 ms_error("Could not parse identity contact !");
1449                 url=linphone_address_new("sip:unknown@unkwownhost");
1450         }
1451         linphone_core_get_local_ip(lc, NULL, tmp);
1452         if (strcmp(tmp,"127.0.0.1")==0 || strcmp(tmp,"::1")==0 ){
1453                 ms_warning("Local loopback network only !");
1454                 lc->sip_conf.loopback_only=TRUE;
1455         }else lc->sip_conf.loopback_only=FALSE;
1456         linphone_address_set_domain(url,tmp);
1457         linphone_address_set_port_int(url,linphone_core_get_sip_port (lc));
1458         guessed=linphone_address_as_string(url);
1459         lc->sip_conf.guessed_contact=guessed;
1460         linphone_address_destroy(url);
1461 }
1462
1463 /**
1464  * Returns the default identity when no proxy configuration is used.
1465  *
1466  * @ingroup proxies
1467 **/
1468 const char *linphone_core_get_primary_contact(LinphoneCore *lc){
1469         char *identity;
1470
1471         if (lc->sip_conf.guess_hostname){
1472                 if (lc->sip_conf.guessed_contact==NULL || lc->sip_conf.loopback_only){
1473                         update_primary_contact(lc);
1474                 }
1475                 identity=lc->sip_conf.guessed_contact;
1476         }else{
1477                 identity=lc->sip_conf.contact;
1478         }
1479         return identity;
1480 }
1481
1482 /**
1483  * Tells LinphoneCore to guess local hostname automatically in primary contact.
1484  *
1485  * @ingroup proxies
1486 **/
1487 void linphone_core_set_guess_hostname(LinphoneCore *lc, bool_t val){
1488         lc->sip_conf.guess_hostname=val;
1489 }
1490
1491 /**
1492  * Returns TRUE if hostname part of primary contact is guessed automatically.
1493  *
1494  * @ingroup proxies
1495 **/
1496 bool_t linphone_core_get_guess_hostname(LinphoneCore *lc){
1497         return lc->sip_conf.guess_hostname;
1498 }
1499
1500 /**
1501  * Same as linphone_core_get_primary_contact() but the result is a LinphoneAddress object
1502  * instead of const char*
1503  *
1504  * @ingroup proxies
1505 **/
1506 LinphoneAddress *linphone_core_get_primary_contact_parsed(LinphoneCore *lc){
1507         return linphone_address_new(linphone_core_get_primary_contact(lc));
1508 }
1509
1510 /**
1511  * Sets the list of audio codecs.
1512  *
1513  * @ingroup media_parameters
1514  * The list is taken by the LinphoneCore thus the application should not free it.
1515  * This list is made of struct PayloadType describing the codec parameters.
1516 **/
1517 int linphone_core_set_audio_codecs(LinphoneCore *lc, MSList *codecs)
1518 {
1519         if (lc->codecs_conf.audio_codecs!=NULL) ms_list_free(lc->codecs_conf.audio_codecs);
1520         lc->codecs_conf.audio_codecs=codecs;
1521         _linphone_core_codec_config_write(lc);
1522         return 0;
1523 }
1524
1525 /**
1526  * Sets the list of video codecs.
1527  *
1528  * @ingroup media_parameters
1529  * The list is taken by the LinphoneCore thus the application should not free it.
1530  * This list is made of struct PayloadType describing the codec parameters.
1531 **/
1532 int linphone_core_set_video_codecs(LinphoneCore *lc, MSList *codecs)
1533 {
1534         if (lc->codecs_conf.video_codecs!=NULL) ms_list_free(lc->codecs_conf.video_codecs);
1535         lc->codecs_conf.video_codecs=codecs;
1536         _linphone_core_codec_config_write(lc);
1537         return 0;
1538 }
1539
1540 const MSList * linphone_core_get_friend_list(const LinphoneCore *lc)
1541 {
1542         return lc->friends;
1543 }
1544
1545 void linphone_core_enable_audio_adaptive_jittcomp(LinphoneCore* lc, bool_t val)
1546 {
1547         lc->rtp_conf.audio_adaptive_jitt_comp_enabled = val;
1548 }
1549
1550 bool_t linphone_core_audio_adaptive_jittcomp_enabled(LinphoneCore* lc)
1551 {
1552         return lc->rtp_conf.audio_adaptive_jitt_comp_enabled;
1553 }
1554
1555 /**
1556  * Returns the nominal audio jitter buffer size in milliseconds.
1557  *
1558  * @ingroup media_parameters
1559 **/
1560 int linphone_core_get_audio_jittcomp(LinphoneCore *lc)
1561 {
1562         return lc->rtp_conf.audio_jitt_comp;
1563 }
1564
1565 void linphone_core_enable_video_adaptive_jittcomp(LinphoneCore* lc, bool_t val)
1566 {
1567         lc->rtp_conf.video_adaptive_jitt_comp_enabled = val;
1568 }
1569
1570 bool_t linphone_core_video_adaptive_jittcomp_enabled(LinphoneCore* lc)
1571 {
1572         return lc->rtp_conf.video_adaptive_jitt_comp_enabled;
1573 }
1574
1575 /**
1576  * Returns the nominal video jitter buffer size in milliseconds.
1577  *
1578  * @ingroup media_parameters
1579 **/
1580 int linphone_core_get_video_jittcomp(LinphoneCore *lc)
1581 {
1582         return lc->rtp_conf.video_jitt_comp;
1583 }
1584
1585 /**
1586  * Returns the UDP port used for audio streaming.
1587  *
1588  * @ingroup network_parameters
1589 **/
1590 int linphone_core_get_audio_port(const LinphoneCore *lc)
1591 {
1592         return lc->rtp_conf.audio_rtp_min_port;
1593 }
1594
1595 /**
1596  * Get the audio port range from which is randomly chosen the UDP port used for audio streaming.
1597  *
1598  * @ingroup network_parameters
1599  */
1600 void linphone_core_get_audio_port_range(const LinphoneCore *lc, int *min_port, int *max_port)
1601 {
1602         *min_port = lc->rtp_conf.audio_rtp_min_port;
1603         *max_port = lc->rtp_conf.audio_rtp_max_port;
1604 }
1605
1606 /**
1607  * Returns the UDP port used for video streaming.
1608  *
1609  * @ingroup network_parameters
1610 **/
1611 int linphone_core_get_video_port(const LinphoneCore *lc){
1612         return lc->rtp_conf.video_rtp_min_port;
1613 }
1614
1615 /**
1616  * Get the video port range from which is randomly chosen the UDP port used for video streaming.
1617  *
1618  * @ingroup network_parameters
1619  */
1620 void linphone_core_get_video_port_range(const LinphoneCore *lc, int *min_port, int *max_port)
1621 {
1622         *min_port = lc->rtp_conf.video_rtp_min_port;
1623         *max_port = lc->rtp_conf.video_rtp_max_port;
1624 }
1625
1626
1627 /**
1628  * Returns the value in seconds of the no-rtp timeout.
1629  *
1630  * @ingroup media_parameters
1631  * When no RTP or RTCP packets have been received for a while
1632  * LinphoneCore will consider the call is broken (remote end crashed or
1633  * disconnected from the network), and thus will terminate the call.
1634  * The no-rtp timeout is the duration above which the call is considered broken.
1635 **/
1636 int linphone_core_get_nortp_timeout(const LinphoneCore *lc){
1637         return lc->rtp_conf.nortp_timeout;
1638 }
1639
1640 bool_t linphone_core_get_rtp_no_xmit_on_audio_mute(const LinphoneCore *lc){
1641         return lc->rtp_conf.rtp_no_xmit_on_audio_mute;
1642 }
1643
1644 /**
1645  * Sets the nominal audio jitter buffer size in milliseconds.
1646  *
1647  * @ingroup media_parameters
1648 **/
1649 void linphone_core_set_audio_jittcomp(LinphoneCore *lc, int value)
1650 {
1651         lc->rtp_conf.audio_jitt_comp=value;
1652 }
1653
1654 /**
1655  * Sets the nominal video jitter buffer size in milliseconds.
1656  *
1657  * @ingroup media_parameters
1658 **/
1659 void linphone_core_set_video_jittcomp(LinphoneCore *lc, int value)
1660 {
1661         lc->rtp_conf.video_jitt_comp=value;
1662 }
1663
1664 void linphone_core_set_rtp_no_xmit_on_audio_mute(LinphoneCore *lc,bool_t rtp_no_xmit_on_audio_mute){
1665         lc->rtp_conf.rtp_no_xmit_on_audio_mute=rtp_no_xmit_on_audio_mute;
1666 }
1667
1668 /**
1669  * Sets the UDP port used for audio streaming.
1670  *
1671  * @ingroup network_parameters
1672 **/
1673 void linphone_core_set_audio_port(LinphoneCore *lc, int port)
1674 {
1675         lc->rtp_conf.audio_rtp_min_port=lc->rtp_conf.audio_rtp_max_port=port;
1676 }
1677
1678 /**
1679  * Sets the UDP port range from which to randomly select the port used for audio streaming.
1680  * @ingroup media_parameters
1681  */
1682 void linphone_core_set_audio_port_range(LinphoneCore *lc, int min_port, int max_port)
1683 {
1684         lc->rtp_conf.audio_rtp_min_port=min_port;
1685         lc->rtp_conf.audio_rtp_max_port=max_port;
1686 }
1687
1688 /**
1689  * Sets the UDP port used for video streaming.
1690  *
1691  * @ingroup network_parameters
1692 **/
1693 void linphone_core_set_video_port(LinphoneCore *lc, int port){
1694         lc->rtp_conf.video_rtp_min_port=lc->rtp_conf.video_rtp_max_port=port;
1695 }
1696
1697 /**
1698  * Sets the UDP port range from which to randomly select the port used for video streaming.
1699  * @ingroup media_parameters
1700  */
1701 void linphone_core_set_video_port_range(LinphoneCore *lc, int min_port, int max_port)
1702 {
1703         lc->rtp_conf.video_rtp_min_port=min_port;
1704         lc->rtp_conf.video_rtp_max_port=max_port;
1705 }
1706
1707 /**
1708  * Sets the no-rtp timeout value in seconds.
1709  *
1710  * @ingroup media_parameters
1711  * See linphone_core_get_nortp_timeout() for details.
1712 **/
1713 void linphone_core_set_nortp_timeout(LinphoneCore *lc, int nortp_timeout){
1714         lc->rtp_conf.nortp_timeout=nortp_timeout;
1715 }
1716
1717 /**
1718  * Indicates whether SIP INFO is used for sending digits.
1719  *
1720  * @ingroup media_parameters
1721 **/
1722 bool_t linphone_core_get_use_info_for_dtmf(LinphoneCore *lc)
1723 {
1724         return lp_config_get_int(lc->config, "sip", "use_info", 0);
1725 }
1726
1727 /**
1728  * Sets whether SIP INFO is to be used for sending digits.
1729  *
1730  * @ingroup media_parameters
1731 **/
1732 void linphone_core_set_use_info_for_dtmf(LinphoneCore *lc,bool_t use_info)
1733 {
1734         if (linphone_core_ready(lc)) {
1735                 lp_config_set_int(lc->config, "sip", "use_info", use_info);
1736         }
1737 }
1738
1739 /**
1740  * Indicates whether RFC2833 is used for sending digits.
1741  *
1742  * @ingroup media_parameters
1743 **/
1744 bool_t linphone_core_get_use_rfc2833_for_dtmf(LinphoneCore *lc)
1745 {
1746         return lp_config_get_int(lc->config, "sip", "use_rfc2833", 1);
1747 }
1748
1749 /**
1750  * Sets whether RFC2833 is to be used for sending digits.
1751  *
1752  * @ingroup media_parameters
1753 **/
1754 void linphone_core_set_use_rfc2833_for_dtmf(LinphoneCore *lc,bool_t use_rfc2833)
1755 {
1756         if (linphone_core_ready(lc)) {
1757                 lp_config_set_int(lc->config, "sip", "use_rfc2833", use_rfc2833);
1758         }
1759 }
1760
1761 /**
1762  * Returns the UDP port used by SIP.
1763  *
1764  * Deprecated: use linphone_core_get_sip_transports() instead.
1765  * @ingroup network_parameters
1766 **/
1767 int linphone_core_get_sip_port(LinphoneCore *lc)
1768 {
1769         LCSipTransports *tr=&lc->sip_conf.transports;
1770         return tr->udp_port>0 ? tr->udp_port : (tr->tcp_port > 0 ? tr->tcp_port : tr->tls_port);
1771 }
1772
1773 static char _ua_name[64]="Linphone";
1774 static char _ua_version[64]=LINPHONE_VERSION;
1775
1776 #ifdef HAVE_EXOSIP_GET_VERSION
1777 extern const char *eXosip_get_version();
1778 #endif
1779
1780 static void apply_user_agent(LinphoneCore *lc){
1781         char ua_string[256];
1782         snprintf(ua_string,sizeof(ua_string)-1,"%s/%s (eXosip2/%s)",_ua_name,_ua_version,
1783 #ifdef HAVE_EXOSIP_GET_VERSION
1784                  eXosip_get_version()
1785 #else
1786                  "unknown"
1787 #endif
1788         );
1789         if (lc->sal) sal_set_user_agent(lc->sal,ua_string);
1790 }
1791
1792 /**
1793  * Sets the user agent string used in SIP messages.
1794  *
1795  * @ingroup misc
1796 **/
1797 void linphone_core_set_user_agent(LinphoneCore *lc, const char *name, const char *ver){
1798         strncpy(_ua_name,name,sizeof(_ua_name)-1);
1799         strncpy(_ua_version,ver,sizeof(_ua_version));
1800         apply_user_agent(lc);
1801 }
1802
1803 const char *linphone_core_get_user_agent_name(void){
1804         return _ua_name;
1805 }
1806
1807 const char *linphone_core_get_user_agent_version(void){
1808         return _ua_version;
1809 }
1810
1811 static void transport_error(LinphoneCore *lc, const char* transport, int port){
1812         char *msg=ortp_strdup_printf("Could not start %s transport on port %i, maybe this port is already used.",transport,port);
1813         ms_warning("%s",msg);
1814         if (lc->vtable.display_warning)
1815                 lc->vtable.display_warning(lc,msg);
1816         ms_free(msg);
1817 }
1818
1819 static bool_t transports_unchanged(const LCSipTransports * tr1, const LCSipTransports * tr2){
1820         return
1821                 tr2->udp_port==tr1->udp_port &&
1822                 tr2->tcp_port==tr1->tcp_port &&
1823                 tr2->dtls_port==tr1->dtls_port &&
1824                 tr2->tls_port==tr1->tls_port;
1825 }
1826
1827 static int apply_transports(LinphoneCore *lc){
1828         Sal *sal=lc->sal;
1829         const char *anyaddr;
1830         LCSipTransports *tr=&lc->sip_conf.transports;
1831
1832         /*first of all invalidate all current registrations so that we can register again with new transports*/
1833         __linphone_core_invalidate_registers(lc);
1834         
1835         if (lc->sip_conf.ipv6_enabled)
1836                 anyaddr="::0";
1837         else
1838                 anyaddr="0.0.0.0";
1839
1840         sal_unlisten_ports(sal);
1841         if (tr->udp_port>0){
1842                 if (sal_listen_port (sal,anyaddr,tr->udp_port,SalTransportUDP,FALSE)!=0){
1843                         transport_error(lc,"udp",tr->udp_port);
1844                         return -1;
1845                 }
1846         }
1847         if (tr->tcp_port>0){
1848                 if (sal_listen_port (sal,anyaddr,tr->tcp_port,SalTransportTCP,FALSE)!=0){
1849                         transport_error(lc,"tcp",tr->tcp_port);
1850                 }
1851         }
1852         if (tr->tls_port>0){
1853                 if (sal_listen_port (sal,anyaddr,tr->tls_port,SalTransportTLS,TRUE)!=0){
1854                         transport_error(lc,"tls",tr->tls_port);
1855                 }
1856         }
1857         apply_user_agent(lc);
1858         return 0;
1859 }
1860
1861 /**
1862  * Sets the ports to be used for each of transport (UDP or TCP)
1863  *
1864  * A zero value port for a given transport means the transport
1865  * is not used.
1866  *
1867  * @ingroup network_parameters
1868 **/
1869 int linphone_core_set_sip_transports(LinphoneCore *lc, const LCSipTransports * tr){
1870
1871         if (transports_unchanged(tr,&lc->sip_conf.transports))
1872                 return 0;
1873         memcpy(&lc->sip_conf.transports,tr,sizeof(*tr));
1874
1875         if (linphone_core_ready(lc)){
1876                 lp_config_set_int(lc->config,"sip","sip_port",tr->udp_port);
1877                 lp_config_set_int(lc->config,"sip","sip_tcp_port",tr->tcp_port);
1878                 lp_config_set_int(lc->config,"sip","sip_tls_port",tr->tls_port);
1879         }
1880
1881         if (lc->sal==NULL) return 0;
1882         return apply_transports(lc);
1883 }
1884
1885 /**
1886  * Retrieves the ports used for each transport (udp, tcp).
1887  * A zero value port for a given transport means the transport
1888  * is not used.
1889  * @ingroup network_parameters
1890 **/
1891 int linphone_core_get_sip_transports(LinphoneCore *lc, LCSipTransports *tr){
1892         memcpy(tr,&lc->sip_conf.transports,sizeof(*tr));
1893         return 0;
1894 }
1895
1896 /**
1897  * Sets the UDP port to be used by SIP.
1898  *
1899  * Deprecated: use linphone_core_set_sip_transports() instead.
1900  * @ingroup network_parameters
1901 **/
1902 void linphone_core_set_sip_port(LinphoneCore *lc,int port)
1903 {
1904         LCSipTransports tr;
1905         memset(&tr,0,sizeof(tr));
1906         tr.udp_port=port;
1907         linphone_core_set_sip_transports (lc,&tr);
1908 }
1909
1910 /**
1911  * Returns TRUE if IPv6 is enabled.
1912  *
1913  * @ingroup network_parameters
1914  * See linphone_core_enable_ipv6() for more details on how IPv6 is supported in liblinphone.
1915 **/
1916 bool_t linphone_core_ipv6_enabled(LinphoneCore *lc){
1917         return lc->sip_conf.ipv6_enabled;
1918 }
1919
1920 /**
1921  * Turns IPv6 support on or off.
1922  *
1923  * @ingroup network_parameters
1924  *
1925  * @note IPv6 support is exclusive with IPv4 in liblinphone:
1926  * when IPv6 is turned on, IPv4 calls won't be possible anymore.
1927  * By default IPv6 support is off.
1928 **/
1929 void linphone_core_enable_ipv6(LinphoneCore *lc, bool_t val){
1930         if (lc->sip_conf.ipv6_enabled!=val){
1931                 lc->sip_conf.ipv6_enabled=val;
1932                 if (lc->sal){
1933                         /* we need to restart eXosip */
1934                         apply_transports(lc);
1935                 }
1936         }
1937 }
1938
1939
1940 static void monitor_network_state(LinphoneCore *lc, time_t curtime){
1941         char result[LINPHONE_IPADDR_SIZE];
1942         bool_t new_status=lc->network_last_status;
1943
1944         /* only do the network up checking every five seconds */
1945         if (lc->network_last_check==0 || (curtime-lc->network_last_check)>=5){
1946                 linphone_core_get_local_ip_for(lc->sip_conf.ipv6_enabled ? AF_INET6 : AF_INET,NULL,result);
1947                 if (strcmp(result,"::1")!=0 && strcmp(result,"127.0.0.1")!=0){
1948                         new_status=TRUE;
1949                 }else new_status=FALSE;
1950                 lc->network_last_check=curtime;
1951                 if (new_status!=lc->network_last_status) {
1952                         if (new_status){
1953                                 ms_message("New local ip address is %s",result);
1954                         }
1955                         set_network_reachable(lc,new_status, curtime);
1956                         lc->network_last_status=new_status;
1957                 }
1958         }
1959 }
1960
1961 static void proxy_update(LinphoneCore *lc){
1962         MSList *elem,*next;
1963         ms_list_for_each(lc->sip_conf.proxies,(void (*)(void*))&linphone_proxy_config_update);
1964         for(elem=lc->sip_conf.deleted_proxies;elem!=NULL;elem=next){
1965                 LinphoneProxyConfig* cfg = (LinphoneProxyConfig*)elem->data;
1966                 next=elem->next;
1967                 if (ms_time(NULL) - cfg->deletion_date > 5) {
1968                         lc->sip_conf.deleted_proxies =ms_list_remove_link(lc->sip_conf.deleted_proxies,elem);
1969                         ms_message("clearing proxy config for [%s]",linphone_proxy_config_get_addr(cfg));
1970                         linphone_proxy_config_destroy(cfg);
1971                 }
1972         }
1973 }
1974
1975 static void assign_buddy_info(LinphoneCore *lc, BuddyInfo *info){
1976         LinphoneFriend *lf=linphone_core_get_friend_by_address(lc,info->sip_uri);
1977         if (lf!=NULL){
1978                 lf->info=info;
1979                 ms_message("%s has a BuddyInfo assigned with image %p",info->sip_uri, info->image_data);
1980                 if (lc->vtable.buddy_info_updated)
1981                         lc->vtable.buddy_info_updated(lc,lf);
1982         }else{
1983                 ms_warning("Could not any friend with uri %s",info->sip_uri);
1984         }
1985 }
1986
1987 static void analyze_buddy_lookup_results(LinphoneCore *lc, LinphoneProxyConfig *cfg){
1988         MSList *elem;
1989         SipSetupContext *ctx=linphone_proxy_config_get_sip_setup_context(cfg);
1990         for (elem=lc->bl_reqs;elem!=NULL;elem=ms_list_next(elem)){
1991                 BuddyLookupRequest *req=(BuddyLookupRequest *)elem->data;
1992                 if (req->status==BuddyLookupDone || req->status==BuddyLookupFailure){
1993                         if (req->results!=NULL){
1994                                 BuddyInfo *i=(BuddyInfo*)req->results->data;
1995                                 ms_list_free(req->results);
1996                                 req->results=NULL;
1997                                 assign_buddy_info(lc,i);
1998                         }
1999                         sip_setup_context_buddy_lookup_free(ctx,req);
2000                         elem->data=NULL;
2001                 }
2002         }
2003         /*purge completed requests */
2004         while((elem=ms_list_find(lc->bl_reqs,NULL))!=NULL){
2005                 lc->bl_reqs=ms_list_remove_link(lc->bl_reqs,elem);
2006         }
2007 }
2008
2009 static void linphone_core_grab_buddy_infos(LinphoneCore *lc, LinphoneProxyConfig *cfg){
2010         const MSList *elem;
2011         SipSetupContext *ctx=linphone_proxy_config_get_sip_setup_context(cfg);
2012         for(elem=linphone_core_get_friend_list(lc);elem!=NULL;elem=elem->next){
2013                 LinphoneFriend *lf=(LinphoneFriend*)elem->data;
2014                 if (lf->info==NULL){
2015                         if (linphone_core_lookup_known_proxy(lc,lf->uri)==cfg){
2016                                 if (linphone_address_get_username(lf->uri)!=NULL){
2017                                         BuddyLookupRequest *req;
2018                                         char *tmp=linphone_address_as_string_uri_only(lf->uri);
2019                                         req=sip_setup_context_create_buddy_lookup_request(ctx);
2020                                         buddy_lookup_request_set_key(req,tmp);
2021                                         buddy_lookup_request_set_max_results(req,1);
2022                                         sip_setup_context_buddy_lookup_submit(ctx,req);
2023                                         lc->bl_reqs=ms_list_append(lc->bl_reqs,req);
2024                                         ms_free(tmp);
2025                                 }
2026                         }
2027                 }
2028         }
2029 }
2030
2031 static void linphone_core_do_plugin_tasks(LinphoneCore *lc){
2032         LinphoneProxyConfig *cfg=NULL;
2033         linphone_core_get_default_proxy(lc,&cfg);
2034         if (cfg){
2035                 if (lc->bl_refresh){
2036                         SipSetupContext *ctx=linphone_proxy_config_get_sip_setup_context(cfg);
2037                         if (ctx && (sip_setup_context_get_capabilities(ctx) & SIP_SETUP_CAP_BUDDY_LOOKUP)){
2038                                 linphone_core_grab_buddy_infos(lc,cfg);
2039                                 lc->bl_refresh=FALSE;
2040                         }
2041                 }
2042                 if (lc->bl_reqs) analyze_buddy_lookup_results(lc,cfg);
2043         }
2044 }
2045
2046 /**
2047  * Main loop function. It is crucial that your application call it periodically.
2048  *
2049  * @ingroup initializing
2050  * linphone_core_iterate() performs various backgrounds tasks:
2051  * - receiving of SIP messages
2052  * - handles timers and timeout
2053  * - performs registration to proxies
2054  * - authentication retries
2055  * The application MUST call this function periodically, in its main loop.
2056  * Be careful that this function must be called from the same thread as
2057  * other liblinphone methods. If it is not the case make sure all liblinphone calls are
2058  * serialized with a mutex.
2059 **/
2060 void linphone_core_iterate(LinphoneCore *lc){
2061         MSList *calls;
2062         LinphoneCall *call;
2063         time_t curtime=time(NULL);
2064         int elapsed;
2065         bool_t one_second_elapsed=FALSE;
2066
2067         if (curtime-lc->prevtime>=1){
2068                 lc->prevtime=curtime;
2069                 one_second_elapsed=TRUE;
2070         }
2071
2072         if (lc->ecc!=NULL){
2073                 LinphoneEcCalibratorStatus ecs=ec_calibrator_get_status(lc->ecc);
2074                 if (ecs!=LinphoneEcCalibratorInProgress){
2075                         if (lc->ecc->cb)
2076                                 lc->ecc->cb(lc,ecs,lc->ecc->delay,lc->ecc->cb_data);
2077                         if (ecs==LinphoneEcCalibratorDone){
2078                                 int len=lp_config_get_int(lc->config,"sound","ec_tail_len",0);
2079                                 int margin=len/2;
2080                                 
2081                                 lp_config_set_int(lc->config, "sound", "ec_delay",MAX(lc->ecc->delay-margin,0));
2082                         } else if (ecs == LinphoneEcCalibratorFailed) {
2083                                 lp_config_set_int(lc->config, "sound", "ec_delay", -1);/*use default value from soundcard*/
2084                         } else if (ecs == LinphoneEcCalibratorDoneNoEcho) {
2085                                 linphone_core_enable_echo_cancellation(lc, FALSE);
2086                         }
2087                         ec_calibrator_destroy(lc->ecc);
2088                         lc->ecc=NULL;
2089                 }
2090         }
2091
2092         if (lc->preview_finished){
2093                 lc->preview_finished=0;
2094                 ring_stop(lc->ringstream);
2095                 lc->ringstream=NULL;
2096                 lc_callback_obj_invoke(&lc->preview_finished_cb,lc);
2097         }
2098
2099         if (lc->ringstream && lc->ringstream_autorelease && lc->dmfs_playing_start_time!=0
2100             && (curtime-lc->dmfs_playing_start_time)>5){
2101                 ring_stop(lc->ringstream);
2102                 lc->ringstream=NULL;
2103                 lc->dmfs_playing_start_time=0;
2104         }
2105
2106         sal_iterate(lc->sal);
2107         if (lc->msevq) ms_event_queue_pump(lc->msevq);
2108         if (lc->auto_net_state_mon) monitor_network_state(lc,curtime);
2109
2110         proxy_update(lc);
2111
2112         //we have to iterate for each call
2113         calls= lc->calls;
2114         while(calls!= NULL){
2115                 call = (LinphoneCall *)calls->data;
2116                 elapsed = curtime-call->start_time;
2117                  /* get immediately a reference to next one in case the one
2118                  we are going to examine is destroy and removed during
2119                  linphone_core_start_invite() */
2120                 calls=calls->next;
2121                 linphone_call_background_tasks(call,one_second_elapsed);
2122                 if (call->state==LinphoneCallOutgoingInit && (elapsed>=lc->sip_conf.delayed_timeout)){
2123                         /*start the call even if the OPTIONS reply did not arrive*/
2124                         if (call->ice_session != NULL) {
2125                                 ms_warning("ICE candidates gathering from [%s] has not finished yet, proceed with the call without ICE anyway."
2126                                                 ,linphone_core_get_stun_server(lc));
2127                                 linphone_call_delete_ice_session(call);
2128                                 linphone_call_stop_media_streams_for_ice_gathering(call);
2129                         }
2130 #ifdef BUILD_UPNP
2131                         if (call->upnp_session != NULL) {
2132                                 ms_warning("uPnP mapping has not finished yet, proceeded with the call without uPnP anyway.");
2133                                 linphone_call_delete_upnp_session(call);
2134                         }
2135 #endif //BUILD_UPNP
2136                         linphone_core_start_invite(lc,call);
2137                 }
2138                 if (call->state==LinphoneCallIncomingReceived){
2139                         ms_message("incoming call ringing for %i seconds",elapsed);
2140                         if (elapsed>lc->sip_conf.inc_timeout){
2141                                 LinphoneReason decline_reason;
2142                                 ms_message("incoming call timeout (%i)",lc->sip_conf.inc_timeout);
2143                                 decline_reason=lc->current_call ? LinphoneReasonBusy : LinphoneReasonDeclined;
2144                                 call->log->status=LinphoneCallMissed;
2145                                 call->reason=LinphoneReasonNotAnswered;
2146                                 linphone_core_decline_call(lc,call,decline_reason);
2147                         }
2148                 }
2149                 if (lc->sip_conf.in_call_timeout > 0 && elapsed>lc->sip_conf.in_call_timeout) {
2150                         ms_message("in call timeout (%i)",lc->sip_conf.in_call_timeout);
2151                         linphone_core_terminate_call(lc,call);
2152                 }
2153         }
2154                 
2155         if (linphone_core_video_preview_enabled(lc)){
2156                 if (lc->previewstream==NULL && lc->calls==NULL)
2157                         toggle_video_preview(lc,TRUE);
2158 #ifdef VIDEO_ENABLED
2159                 if (lc->previewstream) video_stream_iterate(lc->previewstream);
2160 #endif
2161         }else{
2162                 if (lc->previewstream!=NULL)
2163                         toggle_video_preview(lc,FALSE);
2164         }
2165
2166         linphone_core_run_hooks(lc);
2167         linphone_core_do_plugin_tasks(lc);
2168
2169         if (lc->initial_subscribes_sent==FALSE && lc->netup_time!=0 &&
2170             (curtime-lc->netup_time)>3){
2171                 linphone_core_send_initial_subscribes(lc);
2172                 lc->initial_subscribes_sent=TRUE;
2173         }
2174
2175         if (one_second_elapsed) {
2176                 if (lp_config_needs_commit(lc->config)) {
2177                         lp_config_sync(lc->config);
2178                 }
2179         }
2180 }
2181
2182 /**
2183  * Interpret a call destination as supplied by the user, and returns a fully qualified
2184  * LinphoneAddress.
2185  * 
2186  * @ingroup call_control
2187  *
2188  * A sip address should look like DisplayName <sip:username@domain:port> .
2189  * Basically this function performs the following tasks
2190  * - if a phone number is entered, prepend country prefix of the default proxy
2191  *   configuration, eventually escape the '+' by 00.
2192  * - if no domain part is supplied, append the domain name of the default proxy
2193  * - if no sip: is present, prepend it
2194  *
2195  * The result is a syntaxically correct SIP address.
2196 **/
2197
2198 LinphoneAddress * linphone_core_interpret_url(LinphoneCore *lc, const char *url){
2199         enum_lookup_res_t *enumres=NULL;
2200         char *enum_domain=NULL;
2201         LinphoneProxyConfig *proxy=lc->default_proxy;;
2202         char *tmpurl;
2203         LinphoneAddress *uri;
2204
2205         if (is_enum(url,&enum_domain)){
2206                 if (lc->vtable.display_status!=NULL)
2207                         lc->vtable.display_status(lc,_("Looking for telephone number destination..."));
2208                 if (enum_lookup(enum_domain,&enumres)<0){
2209                         if (lc->vtable.display_status!=NULL)
2210                                 lc->vtable.display_status(lc,_("Could not resolve this number."));
2211                         ms_free(enum_domain);
2212                         return NULL;
2213                 }
2214                 ms_free(enum_domain);
2215                 tmpurl=enumres->sip_address[0];
2216                 uri=linphone_address_new(tmpurl);
2217                 enum_lookup_res_free(enumres);
2218                 return uri;
2219         }
2220         /* check if we have a "sip:" */
2221         if (strstr(url,"sip:")==NULL){
2222                 /* this doesn't look like a true sip uri */
2223                 if (strchr(url,'@')!=NULL){
2224                         /* seems like sip: is missing !*/
2225                         tmpurl=ms_strdup_printf("sip:%s",url);
2226                         uri=linphone_address_new(tmpurl);
2227                         ms_free(tmpurl);
2228                         if (uri){
2229                                 return uri;
2230                         }
2231                 }
2232
2233                 if (proxy!=NULL){
2234                         /* append the proxy domain suffix */
2235                         const char *identity=linphone_proxy_config_get_identity(proxy);
2236                         char normalized_username[128];
2237                         uri=linphone_address_new(identity);
2238                         if (uri==NULL){
2239                                 return NULL;
2240                         }
2241                         linphone_address_set_display_name(uri,NULL);
2242                         linphone_proxy_config_normalize_number(proxy,url,normalized_username,
2243                                                                 sizeof(normalized_username));
2244                         linphone_address_set_username(uri,normalized_username);
2245                         return uri;
2246                 }else return NULL;
2247         }
2248         uri=linphone_address_new(url);
2249         if (uri!=NULL){
2250                 return uri;
2251         }
2252         /* else we could not do anything with url given by user, so display an error */
2253         if (lc->vtable.display_warning!=NULL){
2254                 lc->vtable.display_warning(lc,_("Could not parse given sip address. A sip url usually looks like sip:user@domain"));
2255         }
2256         return NULL;
2257 }
2258
2259 /**
2260  * Returns the default identity SIP address.
2261  *
2262  * @ingroup proxies
2263  * This is an helper function:
2264  *
2265  * If no default proxy is set, this will return the primary contact (
2266  * see linphone_core_get_primary_contact() ). If a default proxy is set
2267  * it returns the registered identity on the proxy.
2268 **/
2269 const char * linphone_core_get_identity(LinphoneCore *lc){
2270         LinphoneProxyConfig *proxy=NULL;
2271         const char *from;
2272         linphone_core_get_default_proxy(lc,&proxy);
2273         if (proxy!=NULL) {
2274                 from=linphone_proxy_config_get_identity(proxy);
2275         }else from=linphone_core_get_primary_contact(lc);
2276         return from;
2277 }
2278
2279 const char * linphone_core_get_route(LinphoneCore *lc){
2280         LinphoneProxyConfig *proxy=NULL;
2281         const char *route=NULL;
2282         linphone_core_get_default_proxy(lc,&proxy);
2283         if (proxy!=NULL) {
2284                 route=linphone_proxy_config_get_route(proxy);
2285         }
2286         return route;
2287 }
2288
2289 void linphone_core_start_refered_call(LinphoneCore *lc, LinphoneCall *call){
2290         if (call->refer_pending){
2291                 LinphoneCallParams *cp=linphone_core_create_default_call_parameters(lc);
2292                 LinphoneCall *newcall;
2293                 cp->has_video &= !!lc->video_policy.automatically_initiate;
2294                 cp->referer=call;
2295                 ms_message("Starting new call to refered address %s",call->refer_to);
2296                 call->refer_pending=FALSE;
2297                 newcall=linphone_core_invite_with_params(lc,call->refer_to,cp);
2298                 linphone_call_params_destroy(cp);
2299                 if (newcall) linphone_core_notify_refer_state(lc,call,newcall);
2300         }
2301 }
2302
2303 void linphone_core_notify_refer_state(LinphoneCore *lc, LinphoneCall *referer, LinphoneCall *newcall){
2304         if (referer->op!=NULL){
2305                 sal_call_notify_refer_state(referer->op,newcall ? newcall->op : NULL);
2306         }
2307 }
2308
2309 LinphoneProxyConfig * linphone_core_lookup_known_proxy(LinphoneCore *lc, const LinphoneAddress *uri){
2310         const MSList *elem;
2311         LinphoneProxyConfig *found_cfg=NULL;
2312         LinphoneProxyConfig *default_cfg=lc->default_proxy;
2313
2314         /*always prefer the default proxy if it is matching the destination uri*/
2315         if (default_cfg){
2316                 const char *domain=linphone_proxy_config_get_domain(default_cfg);
2317                 if (strcmp(domain,linphone_address_get_domain(uri))==0)
2318                         return default_cfg;
2319         }
2320
2321         /*otherwise iterate through the other proxy config and return the first matching*/
2322         for (elem=linphone_core_get_proxy_config_list(lc);elem!=NULL;elem=elem->next){
2323                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
2324                 const char *domain=linphone_proxy_config_get_domain(cfg);
2325                 if (domain!=NULL && strcmp(domain,linphone_address_get_domain(uri))==0){
2326                         found_cfg=cfg;
2327                         break;
2328                 }
2329         }
2330         return found_cfg;
2331 }
2332
2333 const char *linphone_core_find_best_identity(LinphoneCore *lc, const LinphoneAddress *to, const char **route){
2334         LinphoneProxyConfig *cfg=linphone_core_lookup_known_proxy(lc,to);
2335         if (cfg==NULL)
2336                 linphone_core_get_default_proxy (lc,&cfg);
2337         if (cfg!=NULL){
2338                 if (route) *route=linphone_proxy_config_get_route(cfg);
2339                 return linphone_proxy_config_get_identity (cfg);
2340         }
2341         return linphone_core_get_primary_contact (lc);
2342 }
2343
2344 static char *get_fixed_contact(LinphoneCore *lc, LinphoneCall *call , LinphoneProxyConfig *dest_proxy){
2345         LinphoneAddress *ctt;
2346         const char *localip=call->localip;
2347
2348         /* first use user's supplied ip address if asked*/
2349         if (linphone_core_get_firewall_policy(lc)==LinphonePolicyUseNatAddress){
2350                 ctt=linphone_core_get_primary_contact_parsed(lc);
2351                 return ms_strdup_printf("sip:%s@%s",linphone_address_get_username(ctt),
2352                         linphone_core_get_nat_address_resolved(lc));
2353         }
2354
2355         /* if already choosed, don't change it */
2356         if (call->op && sal_op_get_contact(call->op)!=NULL){
2357                 return NULL;
2358         }
2359         /* if the ping OPTIONS request succeeded use the contact guessed from the
2360          received, rport*/
2361         if (call->ping_op){
2362                 const char *guessed=sal_op_get_contact(call->ping_op);
2363                 if (guessed){
2364                         ms_message("Contact has been fixed using OPTIONS to %s",guessed);
2365                         return ms_strdup(guessed);
2366                 }
2367         }
2368
2369         /*if using a proxy, use the contact address as guessed with the REGISTERs*/
2370         if (dest_proxy && dest_proxy->op){
2371                 const char *fixed_contact=sal_op_get_contact(dest_proxy->op);
2372                 if (fixed_contact) {
2373                         ms_message("Contact has been fixed using proxy to %s",fixed_contact);
2374                         return ms_strdup(fixed_contact);
2375                 }
2376         }
2377
2378         ctt=linphone_core_get_primary_contact_parsed(lc);
2379
2380         if (ctt!=NULL){
2381                 char *ret;
2382                 /*otherwise use supllied localip*/
2383                 linphone_address_set_domain(ctt,localip);
2384                 linphone_address_set_port_int(ctt,linphone_core_get_sip_port(lc));
2385                 ret=linphone_address_as_string_uri_only(ctt);
2386                 linphone_address_destroy(ctt);
2387                 ms_message("Contact has been fixed using local ip to %s",ret);
2388                 return ret;
2389         }
2390         return NULL;
2391 }
2392
2393 int linphone_core_proceed_with_invite_if_ready(LinphoneCore *lc, LinphoneCall *call, LinphoneProxyConfig *dest_proxy){
2394         bool_t ice_ready = FALSE;
2395         bool_t upnp_ready = FALSE;
2396         bool_t ping_ready = FALSE;
2397
2398         if (call->ice_session != NULL) {
2399                 if (ice_session_candidates_gathered(call->ice_session)) ice_ready = TRUE;
2400         } else {
2401                 ice_ready = TRUE;
2402         }
2403 #ifdef BUILD_UPNP
2404         if (call->upnp_session != NULL) {
2405                 if (linphone_upnp_session_get_state(call->upnp_session) == LinphoneUpnpStateOk) upnp_ready = TRUE;
2406         } else {
2407                 upnp_ready = TRUE;
2408         }
2409 #else
2410         upnp_ready=TRUE;
2411 #endif //BUILD_UPNP
2412         if (call->ping_op != NULL) {
2413                 if (call->ping_replied == TRUE) ping_ready = TRUE;
2414         } else {
2415                 ping_ready = TRUE;
2416         }
2417
2418         if ((ice_ready == TRUE) && (upnp_ready == TRUE) && (ping_ready == TRUE)) {
2419                 return linphone_core_start_invite(lc, call);
2420         }
2421         return 0;
2422 }
2423
2424 int linphone_core_start_invite(LinphoneCore *lc, LinphoneCall *call){
2425         int err;
2426         char *contact;
2427         char *real_url,*barmsg;
2428         char *from;
2429         LinphoneProxyConfig *dest_proxy=call->dest_proxy;
2430
2431         /*try to be best-effort in giving real local or routable contact address */
2432         contact=get_fixed_contact(lc,call,dest_proxy);
2433         if (contact){
2434                 sal_op_set_contact(call->op, contact);
2435                 ms_free(contact);
2436         }
2437         linphone_core_stop_dtmf_stream(lc);
2438         linphone_call_init_media_streams(call);
2439         if (lc->ringstream==NULL)
2440                 audio_stream_prepare_sound(call->audiostream,lc->sound_conf.play_sndcard,lc->sound_conf.capt_sndcard);
2441         linphone_call_make_local_media_description(lc,call);
2442         if (!lc->sip_conf.sdp_200_ack){
2443                 call->media_pending=TRUE;
2444                 sal_call_set_local_media_description(call->op,call->localdesc);
2445         }
2446         real_url=linphone_address_as_string(call->log->to);
2447         from=linphone_address_as_string(call->log->from);
2448         err=sal_call(call->op,from,real_url);
2449         call->log->call_id=ms_strdup(sal_op_get_call_id(call->op)); /*must be known at that time*/
2450
2451         if (lc->sip_conf.sdp_200_ack){
2452                 call->media_pending=TRUE;
2453                 sal_call_set_local_media_description(call->op,call->localdesc);
2454         }
2455         barmsg=ortp_strdup_printf("%s %s", _("Contacting"), real_url);
2456         if (lc->vtable.display_status!=NULL)
2457                 lc->vtable.display_status(lc,barmsg);
2458         ms_free(barmsg);
2459
2460         if (err<0){
2461                 if (lc->vtable.display_status!=NULL)
2462                         lc->vtable.display_status(lc,_("Could not call"));
2463                 linphone_call_stop_media_streams(call);
2464                 linphone_call_set_state(call,LinphoneCallError,"Call failed");
2465         }else {
2466                 linphone_call_set_state(call,LinphoneCallOutgoingProgress,"Outgoing call in progress");
2467         }
2468         ms_free(real_url);
2469         ms_free(from);
2470         return err;
2471 }
2472
2473 /**
2474  * Initiates an outgoing call
2475  *
2476  * @ingroup call_control
2477  * @param lc the LinphoneCore object
2478  * @param url the destination of the call (sip address, or phone number).
2479  *
2480  * The application doesn't own a reference to the returned LinphoneCall object.
2481  * Use linphone_call_ref() to safely keep the LinphoneCall pointer valid within your application.
2482  *
2483  * @return a LinphoneCall object or NULL in case of failure
2484 **/
2485 LinphoneCall * linphone_core_invite(LinphoneCore *lc, const char *url){
2486         LinphoneCall *call;
2487         LinphoneCallParams *p=linphone_core_create_default_call_parameters (lc);
2488         p->has_video &= !!lc->video_policy.automatically_initiate;
2489         call=linphone_core_invite_with_params(lc,url,p);
2490         linphone_call_params_destroy(p);
2491         return call;
2492 }
2493
2494
2495 /**
2496  * Initiates an outgoing call according to supplied call parameters
2497  *
2498  * @ingroup call_control
2499  * @param lc the LinphoneCore object
2500  * @param url the destination of the call (sip address, or phone number).
2501  * @param p call parameters
2502  *
2503  * The application doesn't own a reference to the returned LinphoneCall object.
2504  * Use linphone_call_ref() to safely keep the LinphoneCall pointer valid within your application.
2505  *
2506  * @return a LinphoneCall object or NULL in case of failure
2507 **/
2508 LinphoneCall * linphone_core_invite_with_params(LinphoneCore *lc, const char *url, const LinphoneCallParams *p){
2509         LinphoneAddress *addr=linphone_core_interpret_url(lc,url);
2510         if (addr){
2511                 LinphoneCall *call;
2512                 call=linphone_core_invite_address_with_params(lc,addr,p);
2513                 linphone_address_destroy(addr);
2514                 return call;
2515         }
2516         return NULL;
2517 }
2518
2519 /**
2520  * Initiates an outgoing call given a destination LinphoneAddress
2521  *
2522  * @ingroup call_control
2523  * @param lc the LinphoneCore object
2524  * @param addr the destination of the call (sip address).
2525  *
2526  * The LinphoneAddress can be constructed directly using linphone_address_new(), or
2527  * created by linphone_core_interpret_url().
2528  * The application doesn't own a reference to the returned LinphoneCall object.
2529  * Use linphone_call_ref() to safely keep the LinphoneCall pointer valid within your application.
2530  *
2531  * @return a LinphoneCall object or NULL in case of failure
2532 **/
2533 LinphoneCall * linphone_core_invite_address(LinphoneCore *lc, const LinphoneAddress *addr){
2534         LinphoneCall *call;
2535         LinphoneCallParams *p=linphone_core_create_default_call_parameters(lc);
2536         p->has_video &= !!lc->video_policy.automatically_initiate;
2537         call=linphone_core_invite_address_with_params (lc,addr,p);
2538         linphone_call_params_destroy(p);
2539         return call;
2540 }
2541
2542
2543 /**
2544  * Initiates an outgoing call given a destination LinphoneAddress
2545  *
2546  * @ingroup call_control
2547  * @param lc the LinphoneCore object
2548  * @param addr the destination of the call (sip address).
2549         @param params call parameters
2550  *
2551  * The LinphoneAddress can be constructed directly using linphone_address_new(), or
2552  * created by linphone_core_interpret_url().
2553  * The application doesn't own a reference to the returned LinphoneCall object.
2554  * Use linphone_call_ref() to safely keep the LinphoneCall pointer valid within your application.
2555  *
2556  * @return a LinphoneCall object or NULL in case of failure
2557 **/
2558 LinphoneCall * linphone_core_invite_address_with_params(LinphoneCore *lc, const LinphoneAddress *addr, const LinphoneCallParams *params)
2559 {
2560         const char *route=NULL;
2561         const char *from=NULL;
2562         LinphoneProxyConfig *proxy=NULL,*dest_proxy=NULL;
2563         LinphoneAddress *parsed_url2=NULL;
2564         char *real_url=NULL;
2565         LinphoneCall *call;
2566         bool_t defer = FALSE;
2567
2568         linphone_core_preempt_sound_resources(lc);
2569         
2570         if(!linphone_core_can_we_add_call(lc)){
2571                 if (lc->vtable.display_warning)
2572                         lc->vtable.display_warning(lc,_("Sorry, we have reached the maximum number of simultaneous calls"));
2573                 return NULL;
2574         }
2575         linphone_core_get_default_proxy(lc,&proxy);
2576         route=linphone_core_get_route(lc);
2577
2578         real_url=linphone_address_as_string(addr);
2579         dest_proxy=linphone_core_lookup_known_proxy(lc,addr);
2580
2581         if (proxy!=dest_proxy && dest_proxy!=NULL) {
2582                 ms_message("Overriding default proxy setting for this call:");
2583                 ms_message("The used identity will be %s",linphone_proxy_config_get_identity(dest_proxy));
2584         }
2585
2586         if (dest_proxy!=NULL)
2587                 from=linphone_proxy_config_get_identity(dest_proxy);
2588         else if (proxy!=NULL)
2589                 from=linphone_proxy_config_get_identity(proxy);
2590
2591         /* if no proxy or no identity defined for this proxy, default to primary contact*/
2592         if (from==NULL) from=linphone_core_get_primary_contact(lc);
2593
2594         parsed_url2=linphone_address_new(from);
2595
2596         call=linphone_call_new_outgoing(lc,parsed_url2,linphone_address_clone(addr),params);
2597         call->dest_proxy=dest_proxy;
2598         sal_op_set_route(call->op,route);
2599
2600         if(linphone_core_add_call(lc,call)!= 0)
2601         {
2602                 ms_warning("we had a problem in adding the call into the invite ... weird");
2603                 linphone_call_unref(call);
2604                 return NULL;
2605         }
2606         /* this call becomes now the current one*/
2607         lc->current_call=call;
2608         linphone_call_set_state (call,LinphoneCallOutgoingInit,"Starting outgoing call");
2609         if (linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseIce) {
2610                 /* Defer the start of the call after the ICE gathering process. */
2611                 linphone_call_init_media_streams(call);
2612                 linphone_call_start_media_streams_for_ice_gathering(call);
2613                 call->start_time=time(NULL);
2614                 if (linphone_core_gather_ice_candidates(lc,call)<0) {
2615                         /* Ice candidates gathering failed, proceed with the call anyway. */
2616                         linphone_call_delete_ice_session(call);
2617                         linphone_call_stop_media_streams_for_ice_gathering(call);
2618                 } else {
2619                         defer = TRUE;
2620                 }
2621         }
2622         else if (linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseUpnp) {
2623 #ifdef BUILD_UPNP
2624                 linphone_call_init_media_streams(call);
2625                 call->start_time=time(NULL);
2626                 if (linphone_core_update_upnp(lc,call)<0) {
2627                         /* uPnP port mappings failed, proceed with the call anyway. */
2628                         linphone_call_delete_upnp_session(call);
2629                 } else {
2630                         defer = TRUE;
2631                 }
2632 #endif //BUILD_UPNP
2633         }
2634
2635         if (call->dest_proxy==NULL && lc->sip_conf.ping_with_options==TRUE){
2636 #ifdef BUILD_UPNP
2637                 if (lc->upnp != NULL && linphone_core_get_firewall_policy(lc)==LinphonePolicyUseUpnp &&
2638                         linphone_upnp_context_get_state(lc->upnp) == LinphoneUpnpStateOk) {
2639 #else //BUILD_UPNP
2640                 {
2641 #endif //BUILD_UPNP
2642                         /*defer the start of the call after the OPTIONS ping*/
2643                         call->ping_replied=FALSE;
2644                         call->ping_op=sal_op_new(lc->sal);
2645                         sal_ping(call->ping_op,from,real_url);
2646                         sal_op_set_user_pointer(call->ping_op,call);
2647                         call->start_time=time(NULL);
2648                         defer = TRUE;
2649                 }
2650         }
2651         
2652         if (defer==FALSE) linphone_core_start_invite(lc,call);
2653
2654         if (real_url!=NULL) ms_free(real_url);
2655         return call;
2656 }
2657
2658 /**
2659  * Performs a simple call transfer to the specified destination.
2660  *
2661  * @ingroup call_control
2662  * The remote endpoint is expected to issue a new call to the specified destination.
2663  * The current call remains active and thus can be later paused or terminated.
2664 **/
2665 int linphone_core_transfer_call(LinphoneCore *lc, LinphoneCall *call, const char *url)
2666 {
2667         char *real_url=NULL;
2668         LinphoneAddress *real_parsed_url=linphone_core_interpret_url(lc,url);
2669
2670         if (!real_parsed_url){
2671                 /* bad url */
2672                 return -1;
2673         }
2674         if (call==NULL){
2675                 ms_warning("No established call to refer.");
2676                 return -1;
2677         }
2678         //lc->call=NULL; //Do not do that you will lose the call afterward . . .
2679         real_url=linphone_address_as_string (real_parsed_url);
2680         sal_call_refer(call->op,real_url);
2681         ms_free(real_url);
2682         linphone_address_destroy(real_parsed_url);
2683         linphone_call_set_transfer_state(call, LinphoneCallOutgoingInit);
2684         return 0;
2685 }
2686
2687 /**
2688  * Transfer a call to destination of another running call. This is used for "attended transfer" scenarios.
2689  * @param lc linphone core object
2690  * @param call a running call you want to transfer
2691  * @param dest a running call whose remote person will receive the transfer
2692  * 
2693  * @ingroup call_control
2694  *
2695  * The transfered call is supposed to be in paused state, so that it is able to accept the transfer immediately.
2696  * The destination call is a call previously established to introduce the transfered person.
2697  * This method will send a transfer request to the transfered person. The phone of the transfered is then
2698  * expected to automatically call to the destination of the transfer. The receiver of the transfer will then automatically
2699  * close the call with us (the 'dest' call).
2700 **/
2701 int linphone_core_transfer_call_to_another(LinphoneCore *lc, LinphoneCall *call, LinphoneCall *dest){
2702         int result = sal_call_refer_with_replaces (call->op,dest->op);
2703         linphone_call_set_transfer_state(call, LinphoneCallOutgoingInit);
2704         return result;
2705 }
2706
2707 bool_t linphone_core_inc_invite_pending(LinphoneCore*lc){
2708         LinphoneCall *call = linphone_core_get_current_call(lc);
2709         if(call != NULL)
2710         {
2711                 if(call->dir==LinphoneCallIncoming
2712                         && (call->state == LinphoneCallIncomingReceived || call->state ==  LinphoneCallIncomingEarlyMedia))
2713                         return TRUE;
2714         }
2715         return FALSE;
2716 }
2717
2718 bool_t linphone_core_incompatible_security(LinphoneCore *lc, SalMediaDescription *md){
2719         if (linphone_core_is_media_encryption_mandatory(lc) && linphone_core_get_media_encryption(lc)==LinphoneMediaEncryptionSRTP){
2720                 int i;
2721                 for(i=0;i<md->n_active_streams;i++){
2722                         SalStreamDescription *sd=&md->streams[i];
2723                         if (sd->proto!=SalProtoRtpSavp){
2724                                 return TRUE;
2725                         }
2726                 }
2727         }
2728         return FALSE;
2729 }
2730
2731 void linphone_core_notify_incoming_call(LinphoneCore *lc, LinphoneCall *call){
2732         char *barmesg;
2733         char *tmp;
2734         LinphoneAddress *from_parsed;
2735         SalMediaDescription *md;
2736         bool_t propose_early_media=lp_config_get_int(lc->config,"sip","incoming_calls_early_media",FALSE);
2737         const char *ringback_tone=linphone_core_get_remote_ringback_tone (lc);
2738
2739         linphone_call_make_local_media_description(lc,call);
2740         sal_call_set_local_media_description(call->op,call->localdesc);
2741         md=sal_call_get_final_media_description(call->op);
2742         if (md){
2743                 if (sal_media_description_empty(md) || linphone_core_incompatible_security(lc,md)){
2744                         sal_call_decline(call->op,SalReasonMedia,NULL);
2745                         linphone_call_unref(call);
2746                         return;
2747                 }
2748         }
2749
2750         from_parsed=linphone_address_new(sal_op_get_from(call->op));
2751         linphone_address_clean(from_parsed);
2752         tmp=linphone_address_as_string(from_parsed);
2753         linphone_address_destroy(from_parsed);
2754         barmesg=ortp_strdup_printf("%s %s%s",tmp,_("is contacting you"),
2755             (sal_call_autoanswer_asked(call->op)) ?_(" and asked autoanswer."):_("."));
2756         if (lc->vtable.show) lc->vtable.show(lc);
2757         if (lc->vtable.display_status)
2758             lc->vtable.display_status(lc,barmesg);
2759
2760         /* play the ring if this is the only call*/
2761         if (ms_list_size(lc->calls)==1){
2762                 lc->current_call=call;
2763                 if (lc->ringstream && lc->dmfs_playing_start_time!=0){
2764                         ring_stop(lc->ringstream);
2765                         lc->ringstream=NULL;
2766                         lc->dmfs_playing_start_time=0;
2767                 }
2768                 if (lc->sound_conf.ring_sndcard!=NULL){
2769                         if(lc->ringstream==NULL && lc->sound_conf.local_ring){
2770                                 MSSndCard *ringcard=lc->sound_conf.lsd_card ?lc->sound_conf.lsd_card : lc->sound_conf.ring_sndcard;
2771                                 ms_message("Starting local ring...");
2772                                 lc->ringstream=ring_start(lc->sound_conf.local_ring,2000,ringcard);
2773                         }
2774                         else
2775                         {
2776                                 ms_message("the local ring is already started");
2777                         }
2778                 }
2779         }else{
2780                 /* else play a tone within the context of the current call */
2781                 call->ringing_beep=TRUE;
2782                 linphone_core_play_named_tone(lc,LinphoneToneCallWaiting);
2783         }
2784
2785         linphone_call_set_state(call,LinphoneCallIncomingReceived,"Incoming call");
2786
2787         if (call->state==LinphoneCallIncomingReceived){
2788                 sal_call_notify_ringing(call->op,propose_early_media || ringback_tone!=NULL);
2789
2790                 if (propose_early_media || ringback_tone!=NULL){
2791                         linphone_call_set_state(call,LinphoneCallIncomingEarlyMedia,"Incoming call early media");
2792                         md=sal_call_get_final_media_description(call->op);
2793                         linphone_core_update_streams(lc,call,md);
2794                 }
2795                 if (sal_call_get_replaces(call->op)!=NULL && lp_config_get_int(lc->config,"sip","auto_answer_replacing_calls",1)){
2796                         linphone_core_accept_call(lc,call);
2797                 }
2798         }
2799         linphone_call_unref(call);
2800
2801         ms_free(barmesg);
2802         ms_free(tmp);
2803 }
2804
2805 int linphone_core_start_update_call(LinphoneCore *lc, LinphoneCall *call){
2806         const char *subject;
2807         call->camera_active=call->params.has_video;
2808         if (call->ice_session != NULL) {
2809                 linphone_core_update_local_media_description_from_ice(call->localdesc, call->ice_session);
2810         }
2811 #ifdef BUILD_UPNP
2812         if(call->upnp_session != NULL) {
2813                 linphone_core_update_local_media_description_from_upnp(call->localdesc, call->upnp_session);
2814         }
2815 #endif //BUILD_UPNP
2816         if (call->params.in_conference){
2817                 subject="Conference";
2818         }else{
2819                 subject="Media change";
2820         }
2821         if (lc->vtable.display_status)
2822                 lc->vtable.display_status(lc,_("Modifying call parameters..."));
2823         sal_call_set_local_media_description (call->op,call->localdesc);
2824         return sal_call_update(call->op,subject);
2825 }
2826
2827 /**
2828  * @ingroup call_control
2829  * Updates a running call according to supplied call parameters or parameters changed in the LinphoneCore.
2830  *
2831  * In this version this is limited to the following use cases:
2832  * - setting up/down the video stream according to the video parameter of the LinphoneCallParams (see linphone_call_params_enable_video() ).
2833  * - changing the size of the transmitted video after calling linphone_core_set_preferred_video_size()
2834  *
2835  * In case no changes are requested through the LinphoneCallParams argument, then this argument can be omitted and set to NULL.
2836  * @param lc the core
2837  * @param call the call to be updated
2838  * @param params the new call parameters to use. (may be NULL)
2839  * @return 0 if successful, -1 otherwise.
2840 **/
2841 int linphone_core_update_call(LinphoneCore *lc, LinphoneCall *call, const LinphoneCallParams *params){
2842         int err=0;
2843 #ifdef VIDEO_ENABLED
2844         bool_t has_video = FALSE;
2845 #endif
2846         if (params!=NULL){
2847                 linphone_call_set_state(call,LinphoneCallUpdating,"Updating call");
2848 #ifdef VIDEO_ENABLED
2849                 has_video = call->params.has_video;
2850
2851                 // Video removing
2852                 if((call->videostream != NULL) && !params->has_video) {
2853                         if (call->ice_session != NULL) {
2854                                 ice_session_remove_check_list(call->ice_session, call->videostream->ms.ice_check_list);
2855                                 call->videostream->ms.ice_check_list = NULL;
2856                         }
2857 #ifdef BUILD_UPNP
2858                         if(call->upnp_session != NULL) {
2859                                 if (linphone_core_update_upnp(lc, call)<0) {
2860                                         /* uPnP port mappings failed, proceed with the call anyway. */
2861                                         linphone_call_delete_upnp_session(call);
2862                                 }
2863                         }
2864 #endif //BUILD_UPNP
2865                 }
2866                 
2867                 _linphone_call_params_copy(&call->params,params);
2868                 linphone_call_make_local_media_description(lc, call);
2869
2870                 // Video adding
2871                 if (!has_video && call->params.has_video) {
2872                         if (call->ice_session != NULL) {
2873                                 /* Defer call update until the ICE candidates gathering process has finished. */
2874                                 ms_message("Defer call update to gather ICE candidates");
2875                                 linphone_call_init_video_stream(call);
2876                                 video_stream_prepare_video(call->videostream);
2877                                 if (linphone_core_gather_ice_candidates(lc,call)<0) {
2878                                         /* Ice candidates gathering failed, proceed with the call anyway. */
2879                                         linphone_call_delete_ice_session(call);
2880                                 } else {
2881                                         return err;
2882                                 }
2883                         }
2884 #ifdef BUILD_UPNP
2885                         if(call->upnp_session != NULL) {
2886                                 ms_message("Defer call update to add uPnP port mappings");
2887                                 linphone_call_init_video_stream(call);
2888                                 video_stream_prepare_video(call->videostream);
2889                                 if (linphone_core_update_upnp(lc, call)<0) {
2890                                         /* uPnP port mappings failed, proceed with the call anyway. */
2891                                         linphone_call_delete_upnp_session(call);
2892                                 } else {
2893                                         return err;
2894                                 }
2895                         }
2896 #endif //BUILD_UPNP
2897                 }
2898 #endif
2899                 err = linphone_core_start_update_call(lc, call);
2900         }else{
2901 #ifdef VIDEO_ENABLED
2902                 if (call->videostream!=NULL){
2903                         video_stream_set_sent_video_size(call->videostream,linphone_core_get_preferred_video_size(lc));
2904                         if (call->camera_active && call->videostream->cam!=lc->video_conf.device){
2905                                 video_stream_change_camera(call->videostream,lc->video_conf.device);
2906                         }else video_stream_update_video_params(call->videostream);
2907                 }
2908 #endif
2909         }
2910
2911         return err;
2912 }
2913
2914 /**
2915  * @ingroup call_control
2916  * When receiving a #LinphoneCallUpdatedByRemote state notification, prevent LinphoneCore from performing an automatic answer.
2917  * 
2918  * When receiving a #LinphoneCallUpdatedByRemote state notification (ie an incoming reINVITE), the default behaviour of
2919  * LinphoneCore is to automatically answer the reINIVTE with call parameters unchanged.
2920  * However when for example when the remote party updated the call to propose a video stream, it can be useful
2921  * to prompt the user before answering. This can be achieved by calling linphone_core_defer_call_update() during 
2922  * the call state notifiacation, to deactivate the automatic answer that would just confirm the audio but reject the video.
2923  * Then, when the user responds to dialog prompt, it becomes possible to call linphone_core_accept_call_update() to answer
2924  * the reINVITE, with eventually video enabled in the LinphoneCallParams argument.
2925  * 
2926  * @return 0 if successful, -1 if the linphone_core_defer_call_update() was done outside a #LinphoneCallUpdatedByRemote notification, which is illegal.
2927 **/
2928 int linphone_core_defer_call_update(LinphoneCore *lc, LinphoneCall *call){
2929         if (call->state==LinphoneCallUpdatedByRemote){
2930                 call->defer_update=TRUE;
2931                 return 0;
2932         }
2933         ms_error("linphone_core_defer_call_update() not done in state LinphoneCallUpdatedByRemote");
2934         return -1;
2935 }
2936
2937 int linphone_core_start_accept_call_update(LinphoneCore *lc, LinphoneCall *call){
2938         SalMediaDescription *md;
2939         if (call->ice_session != NULL) {
2940                 if (ice_session_nb_losing_pairs(call->ice_session) > 0) {
2941                         /* Defer the sending of the answer until there are no losing pairs left. */
2942                         return 0;
2943                 }
2944                 linphone_core_update_local_media_description_from_ice(call->localdesc, call->ice_session);
2945         }
2946 #ifdef BUILD_UPNP
2947         if(call->upnp_session != NULL) {
2948                 linphone_core_update_local_media_description_from_upnp(call->localdesc, call->upnp_session);
2949         }
2950 #endif //BUILD_UPNP
2951         linphone_call_update_remote_session_id_and_ver(call);
2952         sal_call_set_local_media_description(call->op,call->localdesc);
2953         sal_call_accept(call->op);
2954         md=sal_call_get_final_media_description(call->op);
2955         if (md && !sal_media_description_empty(md))
2956                 linphone_core_update_streams (lc,call,md);
2957         linphone_call_set_state(call,LinphoneCallStreamsRunning,"Connected (streams running)");
2958         return 0;
2959 }
2960
2961 /**
2962  * @ingroup call_control
2963  * Accept call modifications initiated by other end.
2964  * 
2965  * This call may be performed in response to a #LinphoneCallUpdatedByRemote state notification.
2966  * When such notification arrives, the application can decide to call linphone_core_defer_update_call() so that it can
2967  * have the time to prompt the user. linphone_call_get_remote_params() can be used to get information about the call parameters
2968  * requested by the other party, such as whether a video stream is requested.
2969  * 
2970  * When the user accepts or refuse the change, linphone_core_accept_call_update() can be done to answer to the other party.
2971  * If params is NULL, then the same call parameters established before the update request will continue to be used (no change).
2972  * If params is not NULL, then the update will be accepted according to the parameters passed.
2973  * Typical example is when a user accepts to start video, then params should indicate that video stream should be used 
2974  * (see linphone_call_params_enable_video()).
2975  * @param lc the linphone core object.
2976  * @param call the LinphoneCall object
2977  * @param params a LinphoneCallParams object describing the call parameters to accept.
2978  * @return 0 if sucessful, -1 otherwise (actually when this function call is performed outside ot #LinphoneCallUpdatedByRemote state).
2979 **/
2980 int linphone_core_accept_call_update(LinphoneCore *lc, LinphoneCall *call, const LinphoneCallParams *params){
2981         SalMediaDescription *remote_desc;
2982         bool_t keep_sdp_version;
2983 #ifdef VIDEO_ENABLED
2984         bool_t old_has_video = call->params.has_video;
2985 #endif
2986         if (call->state!=LinphoneCallUpdatedByRemote){
2987                 ms_error("linphone_core_accept_update(): invalid state %s to call this function.",
2988                          linphone_call_state_to_string(call->state));
2989                 return -1;
2990         }
2991         remote_desc = sal_call_get_remote_media_description(call->op);
2992         keep_sdp_version = lp_config_get_int(lc->config, "sip", "keep_sdp_version", 0);
2993         if (keep_sdp_version &&(remote_desc->session_id == call->remote_session_id) && (remote_desc->session_ver == call->remote_session_ver)) {
2994                 /* Remote has sent an INVITE with the same SDP as before, so send a 200 OK with the same SDP as before. */
2995                 ms_warning("SDP version has not changed, send same SDP as before.");
2996                 sal_call_accept(call->op);
2997                 linphone_call_set_state(call,LinphoneCallStreamsRunning,"Connected (streams running)");
2998                 return 0;
2999         }
3000         if (params==NULL){
3001                 call->params.has_video=lc->video_policy.automatically_accept || call->current_params.has_video;
3002         }else
3003                 call->params=*params;
3004
3005         if (call->params.has_video && !linphone_core_video_enabled(lc)){
3006                 ms_warning("linphone_core_accept_call_update(): requested video but video support is globally disabled. Refusing video.");
3007                 call->params.has_video=FALSE;
3008         }
3009         if (call->current_params.in_conference) {
3010                 ms_warning("Video isn't supported in conference");
3011                 call->params.has_video = FALSE;
3012         }
3013         call->params.has_video &= linphone_core_media_description_contains_video_stream(remote_desc);
3014         call->camera_active=call->params.has_video;
3015         linphone_call_make_local_media_description(lc,call);
3016         if (call->ice_session != NULL) {
3017                 linphone_core_update_ice_from_remote_media_description(call, remote_desc);
3018 #ifdef VIDEO_ENABLED
3019                 if ((call->ice_session != NULL) &&!ice_session_candidates_gathered(call->ice_session)) {
3020                         if ((call->params.has_video) && (call->params.has_video != old_has_video)) {
3021                                 linphone_call_init_video_stream(call);
3022                                 video_stream_prepare_video(call->videostream);
3023                                 if (linphone_core_gather_ice_candidates(lc,call)<0) {
3024                                         /* Ice candidates gathering failed, proceed with the call anyway. */
3025                                         linphone_call_delete_ice_session(call);
3026                                 } else return 0;
3027                         }
3028                 }
3029 #endif //VIDEO_ENABLED
3030         }
3031
3032 #ifdef BUILD_UPNP
3033         if(call->upnp_session != NULL) {
3034                 linphone_core_update_upnp_from_remote_media_description(call, sal_call_get_remote_media_description(call->op));
3035 #ifdef VIDEO_ENABLED
3036                 if ((call->params.has_video) && (call->params.has_video != old_has_video)) {
3037                         linphone_call_init_video_stream(call);
3038                         video_stream_prepare_video(call->videostream);
3039                         if (linphone_core_update_upnp(lc, call)<0) {
3040                                 /* uPnP update failed, proceed with the call anyway. */
3041                                 linphone_call_delete_upnp_session(call);
3042                         } else return 0;
3043                 }
3044 #endif //VIDEO_ENABLED
3045         }
3046 #endif //BUILD_UPNP
3047
3048         linphone_core_start_accept_call_update(lc, call);
3049         return 0;
3050 }
3051
3052 /**
3053  * Accept an incoming call.
3054  *
3055  * @ingroup call_control
3056  * Basically the application is notified of incoming calls within the
3057  * call_state_changed callback of the #LinphoneCoreVTable structure, where it will receive
3058  * a LinphoneCallIncoming event with the associated LinphoneCall object.
3059  * The application can later accept the call using this method.
3060  * @param lc the LinphoneCore object
3061  * @param call the LinphoneCall object representing the call to be answered.
3062  *
3063 **/
3064 int linphone_core_accept_call(LinphoneCore *lc, LinphoneCall *call){
3065         return linphone_core_accept_call_with_params(lc,call,NULL);
3066 }
3067
3068 /**
3069  * Accept an incoming call, with parameters.
3070  *
3071  * @ingroup call_control
3072  * Basically the application is notified of incoming calls within the
3073  * call_state_changed callback of the #LinphoneCoreVTable structure, where it will receive
3074  * a LinphoneCallIncoming event with the associated LinphoneCall object.
3075  * The application can later accept the call using
3076  * this method.
3077  * @param lc the LinphoneCore object
3078  * @param call the LinphoneCall object representing the call to be answered.
3079  * @param params the specific parameters for this call, for example whether video is accepted or not. Use NULL to use default parameters.
3080  *
3081 **/
3082 int linphone_core_accept_call_with_params(LinphoneCore *lc, LinphoneCall *call, const LinphoneCallParams *params)
3083 {
3084         LinphoneProxyConfig *cfg=NULL;
3085         const char *contact=NULL;
3086         SalOp *replaced;
3087         SalMediaDescription *new_md;
3088         bool_t was_ringing=FALSE;
3089
3090         if (call==NULL){
3091                 //if just one call is present answer the only one ...
3092                 if(linphone_core_get_calls_nb (lc) != 1)
3093                         return -1;
3094                 else
3095                         call = (LinphoneCall*)linphone_core_get_calls(lc)->data;
3096         }
3097
3098         if (call->state==LinphoneCallConnected){
3099                 /*call already accepted*/
3100                 return -1;
3101         }
3102
3103         /* check if this call is supposed to replace an already running one*/
3104         replaced=sal_call_get_replaces(call->op);
3105         if (replaced){
3106                 LinphoneCall *rc=(LinphoneCall*)sal_op_get_user_pointer (replaced);
3107                 if (rc){
3108                         ms_message("Call %p replaces call %p. This last one is going to be terminated automatically.",
3109                                    call,rc);
3110                         linphone_core_terminate_call(lc,rc);
3111                 }
3112         }
3113
3114         if (lc->current_call!=call){
3115                 linphone_core_preempt_sound_resources(lc);
3116         }
3117
3118         /*stop ringing */
3119         if (lc->ringstream!=NULL) {
3120                 ms_message("stop ringing");
3121                 ring_stop(lc->ringstream);
3122                 ms_message("ring stopped");
3123                 lc->ringstream=NULL;
3124                 was_ringing=TRUE;
3125         }
3126         if (call->ringing_beep){
3127                 linphone_core_stop_dtmf(lc);
3128                 call->ringing_beep=FALSE;
3129         }
3130
3131         linphone_core_get_default_proxy(lc,&cfg);
3132         call->dest_proxy=cfg;
3133         call->dest_proxy=linphone_core_lookup_known_proxy(lc,call->log->to);
3134
3135         if (cfg!=call->dest_proxy && call->dest_proxy!=NULL) {
3136                 ms_message("Overriding default proxy setting for this call:");
3137                 ms_message("The used identity will be %s",linphone_proxy_config_get_identity(call->dest_proxy));
3138         }
3139         /*try to be best-effort in giving real local or routable contact address*/
3140         contact=get_fixed_contact(lc,call,call->dest_proxy);
3141         if (contact)
3142                 sal_op_set_contact(call->op,contact);
3143
3144         if (params){
3145                 const SalMediaDescription *md = sal_call_get_remote_media_description(call->op);
3146                 _linphone_call_params_copy(&call->params,params);
3147                 // There might not be a md if the INVITE was lacking an SDP
3148                 // In this case we use the parameters as is.
3149                 if (md) call->params.has_video &= linphone_core_media_description_contains_video_stream(md);
3150                 call->camera_active=call->params.has_video;
3151                 linphone_call_make_local_media_description(lc,call);
3152                 sal_call_set_local_media_description(call->op,call->localdesc);
3153         }
3154         
3155         if (call->audiostream==NULL)
3156                 linphone_call_init_media_streams(call);
3157         if (!was_ringing && call->audiostream->ms.ticker==NULL){
3158                 audio_stream_prepare_sound(call->audiostream,lc->sound_conf.play_sndcard,lc->sound_conf.capt_sndcard);
3159         }
3160
3161         linphone_call_update_remote_session_id_and_ver(call);
3162         sal_call_accept(call->op);
3163         if (lc->vtable.display_status!=NULL)
3164                 lc->vtable.display_status(lc,_("Connected."));
3165         lc->current_call=call;
3166         linphone_call_set_state(call,LinphoneCallConnected,"Connected");
3167         new_md=sal_call_get_final_media_description(call->op);
3168         linphone_core_update_streams(lc, call, new_md);
3169         if (new_md){
3170                 linphone_call_set_state(call,LinphoneCallStreamsRunning,"Connected (streams running)");
3171         }else call->media_pending=TRUE;
3172
3173         ms_message("call answered.");
3174         return 0;
3175 }
3176
3177 int linphone_core_abort_call(LinphoneCore *lc, LinphoneCall *call, const char *error){
3178         sal_call_terminate(call->op);
3179
3180         /*stop ringing*/
3181         if (lc->ringstream!=NULL) {
3182                 ring_stop(lc->ringstream);
3183                 lc->ringstream=NULL;
3184         }
3185         linphone_call_stop_media_streams(call);
3186
3187 #ifdef BUILD_UPNP
3188         linphone_call_delete_upnp_session(call);
3189 #endif //BUILD_UPNP
3190
3191         if (lc->vtable.display_status!=NULL)
3192                 lc->vtable.display_status(lc,_("Call aborted") );
3193         linphone_call_set_state(call,LinphoneCallError,error);
3194         return 0;
3195 }
3196
3197 static void terminate_call(LinphoneCore *lc, LinphoneCall *call){
3198         if (call->state==LinphoneCallIncomingReceived){
3199                 if (call->reason!=LinphoneReasonNotAnswered)
3200                         call->reason=LinphoneReasonDeclined;
3201         }
3202         /*stop ringing*/
3203         if (lc->ringstream!=NULL) {
3204                 ring_stop(lc->ringstream);
3205                 lc->ringstream=NULL;
3206         }
3207
3208         linphone_call_stop_media_streams(call);
3209
3210 #ifdef BUILD_UPNP
3211         linphone_call_delete_upnp_session(call);
3212 #endif //BUILD_UPNP
3213
3214         if (lc->vtable.display_status!=NULL)
3215                 lc->vtable.display_status(lc,_("Call ended") );
3216         linphone_call_set_state(call,LinphoneCallEnd,"Call terminated");
3217 }
3218
3219 int linphone_core_redirect_call(LinphoneCore *lc, LinphoneCall *call, const char *redirect_uri){
3220         if (call->state==LinphoneCallIncomingReceived){
3221                 sal_call_decline(call->op,SalReasonRedirect,redirect_uri);
3222                 call->reason=LinphoneReasonDeclined;
3223                 terminate_call(lc,call);
3224         }else{
3225                 ms_error("Bad state for call redirection.");
3226                 return -1;
3227     }
3228         return 0;
3229 }
3230
3231
3232 /**
3233  * Terminates a call.
3234  *
3235  * @ingroup call_control
3236  * @param lc the LinphoneCore
3237  * @param the_call the LinphoneCall object representing the call to be terminated.
3238 **/
3239 int linphone_core_terminate_call(LinphoneCore *lc, LinphoneCall *the_call)
3240 {
3241         LinphoneCall *call;
3242         if (the_call == NULL){
3243                 call = linphone_core_get_current_call(lc);
3244                 if (ms_list_size(lc->calls)==1){
3245                         call=(LinphoneCall*)lc->calls->data;
3246                 }else{
3247                         ms_warning("No unique call to terminate !");
3248                         return -1;
3249                 }
3250         }
3251         else
3252         {
3253                 call = the_call;
3254         }
3255         sal_call_terminate(call->op);
3256         terminate_call(lc,call);
3257         return 0;
3258 }
3259
3260 /**
3261  * Decline a pending incoming call, with a reason.
3262  * 
3263  * @ingroup call_control
3264  * 
3265  * @param lc the linphone core
3266  * @param call the LinphoneCall, must be in the IncomingReceived state.
3267  * @param reason the reason for rejecting the call: LinphoneReasonDeclined or LinphoneReasonBusy
3268 **/
3269 int linphone_core_decline_call(LinphoneCore *lc, LinphoneCall * call, LinphoneReason reason){
3270         SalReason sal_reason=SalReasonUnknown;
3271         if (call->state!=LinphoneCallIncomingReceived && call->state!=LinphoneCallIncomingEarlyMedia){
3272                 ms_error("linphone_core_decline_call(): Cannot decline a call that is in state %s",linphone_call_state_to_string(call->state));
3273                 return -1;
3274         }
3275         switch(reason){
3276                 case LinphoneReasonDeclined:
3277                         sal_reason=SalReasonDeclined;
3278                 break;
3279                 case LinphoneReasonBusy:
3280                         sal_reason=SalReasonBusy;
3281                 break;
3282                 default:
3283                         ms_error("linphone_core_decline_call(): unsupported reason %s",linphone_reason_to_string(reason));
3284                         return -1;
3285                 break;
3286         }
3287         sal_call_decline(call->op,sal_reason,NULL);
3288         terminate_call(lc,call);
3289         return 0;
3290 }
3291
3292 /**
3293  * Terminates all the calls.
3294  *
3295  * @ingroup call_control
3296  * @param lc The LinphoneCore
3297 **/
3298 int linphone_core_terminate_all_calls(LinphoneCore *lc){
3299         MSList *calls=lc->calls;
3300         while(calls) {
3301                 LinphoneCall *c=(LinphoneCall*)calls->data;
3302                 calls=calls->next;
3303                 linphone_core_terminate_call(lc,c);
3304         }
3305         return 0;
3306 }
3307
3308 /**
3309  * Returns the current list of calls.
3310  *
3311  * Note that this list is read-only and might be changed by the core after a function call to linphone_core_iterate().
3312  * Similarly the LinphoneCall objects inside it might be destroyed without prior notice.
3313  * To hold references to LinphoneCall object into your program, you must use linphone_call_ref().
3314  *
3315  * @ingroup call_control
3316 **/
3317 const MSList *linphone_core_get_calls(LinphoneCore *lc)
3318 {
3319         return lc->calls;
3320 }
3321
3322 /**
3323  * Returns TRUE if there is a call running.
3324  *
3325  * @ingroup call_control
3326 **/
3327 bool_t linphone_core_in_call(const LinphoneCore *lc){
3328         return linphone_core_get_current_call((LinphoneCore *)lc)!=NULL || linphone_core_is_in_conference(lc);
3329 }
3330
3331 /**
3332  * Returns The _LinphoneCall struct of the current call if one is in call
3333  *
3334  * @ingroup call_control
3335 **/
3336 LinphoneCall *linphone_core_get_current_call(const LinphoneCore *lc){
3337         return lc->current_call;
3338 }
3339
3340 /**
3341  * Pauses the call. If a music file has been setup using linphone_core_set_play_file(),
3342  * this file will be played to the remote user.
3343  *
3344  * @ingroup call_control
3345 **/
3346 int linphone_core_pause_call(LinphoneCore *lc, LinphoneCall *call){
3347         int err=_linphone_core_pause_call(lc,call);
3348         if (err==0)  call->paused_by_app=TRUE;
3349         return err;
3350 }
3351
3352 /* Internal version that does not play tone indication*/
3353 int _linphone_core_pause_call(LinphoneCore *lc, LinphoneCall *call)
3354 {
3355         const char *subject=NULL;
3356
3357         if (call->state!=LinphoneCallStreamsRunning && call->state!=LinphoneCallPausedByRemote){
3358                 ms_warning("Cannot pause this call, it is not active.");
3359                 return -1;
3360         }
3361         linphone_call_make_local_media_description(lc,call);
3362         if (call->ice_session != NULL) {
3363                 linphone_core_update_local_media_description_from_ice(call->localdesc, call->ice_session);
3364         }
3365 #ifdef BUILD_UPNP
3366         if(call->upnp_session != NULL) {
3367                 linphone_core_update_local_media_description_from_upnp(call->localdesc, call->upnp_session);
3368         }
3369 #endif //BUILD_UPNP
3370         if (sal_media_description_has_dir(call->resultdesc,SalStreamSendRecv)){
3371                 sal_media_description_set_dir(call->localdesc,SalStreamSendOnly);
3372                 subject="Call on hold";
3373         }else if (sal_media_description_has_dir(call->resultdesc,SalStreamRecvOnly)){
3374                 sal_media_description_set_dir(call->localdesc,SalStreamSendOnly);
3375                 subject="Call on hold for me too";
3376         }else{
3377                 ms_error("No reason to pause this call, it is already paused or inactive.");
3378                 return -1;
3379         }
3380         sal_call_set_local_media_description(call->op,call->localdesc);
3381         if (sal_call_update(call->op,subject) != 0){
3382                 if (lc->vtable.display_warning)
3383                         lc->vtable.display_warning(lc,_("Could not pause the call"));
3384         }
3385         lc->current_call=NULL;
3386         linphone_call_set_state(call,LinphoneCallPausing,"Pausing call");
3387         if (lc->vtable.display_status)
3388                 lc->vtable.display_status(lc,_("Pausing the current call..."));
3389         if (call->audiostream || call->videostream)
3390                 linphone_call_stop_media_streams (call);
3391         call->paused_by_app=FALSE;
3392         return 0;
3393 }
3394
3395 /**
3396  * Pause all currently running calls.
3397  * @ingroup call_control
3398 **/
3399 int linphone_core_pause_all_calls(LinphoneCore *lc){
3400         const MSList *elem;
3401         for(elem=lc->calls;elem!=NULL;elem=elem->next){
3402                 LinphoneCall *call=(LinphoneCall *)elem->data;
3403                 LinphoneCallState cs=linphone_call_get_state(call);
3404                 if (cs==LinphoneCallStreamsRunning || cs==LinphoneCallPausedByRemote){
3405                         _linphone_core_pause_call(lc,call);
3406                 }
3407         }
3408         return 0;
3409 }
3410
3411 void linphone_core_preempt_sound_resources(LinphoneCore *lc){
3412         LinphoneCall *current_call;
3413         if (linphone_core_is_in_conference(lc)){
3414                 linphone_core_leave_conference(lc);
3415                 return;
3416         }
3417         current_call=linphone_core_get_current_call(lc);
3418         if(current_call != NULL){
3419                 ms_message("Pausing automatically the current call.");
3420                 _linphone_core_pause_call(lc,current_call);
3421         }
3422         if (lc->ringstream){
3423                 ring_stop(lc->ringstream);
3424                 lc->ringstream=NULL;
3425         }
3426 }
3427
3428 /**
3429  * Resumes the call.
3430  *
3431  * @ingroup call_control
3432 **/
3433 int linphone_core_resume_call(LinphoneCore *lc, LinphoneCall *the_call)
3434 {
3435         char temp[255]={0};
3436         LinphoneCall *call = the_call;
3437         const char *subject="Call resuming";
3438         
3439         if(call->state!=LinphoneCallPaused ){
3440                 ms_warning("we cannot resume a call that has not been established and paused before");
3441                 return -1;
3442         }
3443         if (call->params.in_conference==FALSE){
3444                 linphone_core_preempt_sound_resources(lc);
3445                 ms_message("Resuming call %p",call);
3446         }
3447
3448         /* Stop playing music immediately. If remote side is a conference it
3449          prevents the participants to hear it while the 200OK comes back.*/
3450         if (call->audiostream) audio_stream_play(call->audiostream, NULL);
3451
3452         linphone_call_make_local_media_description(lc,the_call);
3453         if (call->ice_session != NULL) {
3454                 linphone_core_update_local_media_description_from_ice(call->localdesc, call->ice_session);
3455         }
3456 #ifdef BUILD_UPNP
3457         if(call->upnp_session != NULL) {
3458                 linphone_core_update_local_media_description_from_upnp(call->localdesc, call->upnp_session);
3459         }
3460 #endif //BUILD_UPNP
3461         sal_call_set_local_media_description(call->op,call->localdesc);
3462         sal_media_description_set_dir(call->localdesc,SalStreamSendRecv);
3463         if (call->params.in_conference && !call->current_params.in_conference) subject="Conference";
3464         if(sal_call_update(call->op,subject) != 0){
3465                 return -1;
3466         }
3467         linphone_call_set_state (call,LinphoneCallResuming,"Resuming");
3468         snprintf(temp,sizeof(temp)-1,"Resuming the call with %s",linphone_call_get_remote_address_as_string(call));
3469         if (lc->vtable.display_status)
3470                 lc->vtable.display_status(lc,temp);
3471         return 0;
3472 }
3473
3474 static int remote_address_compare(LinphoneCall *call, const LinphoneAddress *raddr){
3475         const LinphoneAddress *addr=linphone_call_get_remote_address (call);
3476         return !linphone_address_weak_equal (addr,raddr);
3477 }
3478
3479 /**
3480  * Get the call with the remote_address specified
3481  * @param lc
3482  * @param remote_address
3483  * @return the LinphoneCall of the call if found
3484  * 
3485  * @ingroup call_control
3486  */
3487 LinphoneCall *linphone_core_get_call_by_remote_address(LinphoneCore *lc, const char *remote_address){
3488         LinphoneAddress *raddr=linphone_address_new(remote_address);
3489         MSList *elem=ms_list_find_custom(lc->calls,(int (*)(const void*,const void *))remote_address_compare,raddr);
3490         if (elem) return (LinphoneCall*) elem->data;
3491         return NULL;
3492 }
3493
3494 int linphone_core_send_publish(LinphoneCore *lc,
3495                                LinphoneOnlineStatus presence_mode)
3496 {
3497         const MSList *elem;
3498         for (elem=linphone_core_get_proxy_config_list(lc);elem!=NULL;elem=ms_list_next(elem)){
3499                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
3500                 if (cfg->publish) linphone_proxy_config_send_publish(cfg,presence_mode);
3501         }
3502         return 0;
3503 }
3504
3505 /**
3506  * Set the incoming call timeout in seconds.
3507  *
3508  * @ingroup call_control
3509  * If an incoming call isn't answered for this timeout period, it is
3510  * automatically declined.
3511 **/
3512 void linphone_core_set_inc_timeout(LinphoneCore *lc, int seconds){
3513         lc->sip_conf.inc_timeout=seconds;
3514         if (linphone_core_ready(lc)){
3515                 lp_config_set_int(lc->config,"sip","inc_timeout",seconds);
3516         }
3517 }
3518
3519 /**
3520  * Returns the incoming call timeout
3521  *
3522  * @ingroup call_control
3523  * See linphone_core_set_inc_timeout() for details.
3524 **/
3525 int linphone_core_get_inc_timeout(LinphoneCore *lc){
3526         return lc->sip_conf.inc_timeout;
3527 }
3528
3529 /**
3530  * Set the in call timeout in seconds.
3531  *
3532  * @ingroup call_control
3533  * After this timeout period, the call is automatically hangup.
3534 **/
3535 void linphone_core_set_in_call_timeout(LinphoneCore *lc, int seconds){
3536         lc->sip_conf.in_call_timeout=seconds;
3537 }
3538
3539 /**
3540  * Returns the in call timeout
3541  *
3542  * @ingroup call_control
3543  * See linphone_core_set_in_call_timeout() for details.
3544 **/
3545 int linphone_core_get_in_call_timeout(LinphoneCore *lc){
3546         return lc->sip_conf.in_call_timeout;
3547 }
3548
3549 /**
3550  * Returns the delayed timeout
3551  *
3552  * @ingroup call_control
3553  * See linphone_core_set_delayed_timeout() for details.
3554 **/
3555 int linphone_core_get_delayed_timeout(LinphoneCore *lc){
3556         return lc->sip_conf.delayed_timeout;
3557 }
3558
3559 /**
3560  * Set the in delayed timeout in seconds.
3561  *
3562  * @ingroup call_control
3563  * After this timeout period, a delayed call (internal call initialisation or resolution) is resumed.
3564 **/
3565 void linphone_core_set_delayed_timeout(LinphoneCore *lc, int seconds){
3566         lc->sip_conf.delayed_timeout=seconds;
3567 }
3568
3569 void linphone_core_set_presence_info(LinphoneCore *lc,int minutes_away,
3570                                                                                                         const char *contact,
3571                                                                                                         LinphoneOnlineStatus presence_mode)
3572 {
3573         if (minutes_away>0) lc->minutes_away=minutes_away;
3574
3575         if (lc->alt_contact!=NULL) {
3576                 ms_free(lc->alt_contact);
3577                 lc->alt_contact=NULL;
3578         }
3579         if (contact) lc->alt_contact=ms_strdup(contact);
3580         if (lc->presence_mode!=presence_mode){
3581                 linphone_core_notify_all_friends(lc,presence_mode);
3582                 /*
3583                    Improve the use of all LINPHONE_STATUS available.
3584                    !TODO Do not mix "presence status" with "answer status code"..
3585                    Use correct parameter to follow sip_if_match/sip_etag.
3586                  */
3587                 linphone_core_send_publish(lc,presence_mode);
3588         }
3589         lc->presence_mode=presence_mode;
3590 }
3591
3592 LinphoneOnlineStatus linphone_core_get_presence_info(const LinphoneCore *lc){
3593         return lc->presence_mode;
3594 }
3595
3596 /**
3597  * Get playback sound level in 0-100 scale.
3598  *
3599  * @ingroup media_parameters
3600 **/
3601 int linphone_core_get_play_level(LinphoneCore *lc)
3602 {
3603         return lc->sound_conf.play_lev;
3604 }
3605
3606 /**
3607  * Get ring sound level in 0-100 scale
3608  *
3609  * @ingroup media_parameters
3610 **/
3611 int linphone_core_get_ring_level(LinphoneCore *lc)
3612 {
3613         return lc->sound_conf.ring_lev;
3614 }
3615
3616 /**
3617  * Get sound capture level in 0-100 scale
3618  *
3619  * @ingroup media_parameters
3620 **/
3621 int linphone_core_get_rec_level(LinphoneCore *lc){
3622         return lc->sound_conf.rec_lev;
3623 }
3624
3625 /**
3626  * Set sound ring level in 0-100 scale
3627  *
3628  * @ingroup media_parameters
3629 **/
3630 void linphone_core_set_ring_level(LinphoneCore *lc, int level){
3631         MSSndCard *sndcard;
3632         lc->sound_conf.ring_lev=level;
3633         sndcard=lc->sound_conf.ring_sndcard;
3634         if (sndcard) ms_snd_card_set_level(sndcard,MS_SND_CARD_PLAYBACK,level);
3635 }
3636
3637 /**
3638  * Allow to control microphone level:  gain in db
3639  *
3640  * @ingroup media_parameters
3641 **/
3642 void linphone_core_set_mic_gain_db (LinphoneCore *lc, float gaindb){
3643         float gain=gaindb;
3644         LinphoneCall *call=linphone_core_get_current_call (lc);
3645         AudioStream *st;
3646
3647         lc->sound_conf.soft_mic_lev=gaindb;
3648
3649         if (linphone_core_ready(lc)){
3650                 lp_config_set_float(lc->config,"sound","mic_gain_db",lc->sound_conf.soft_mic_lev);
3651         }
3652
3653         if (call==NULL || (st=call->audiostream)==NULL){
3654                 ms_message("linphone_core_set_mic_gain_db(): no active call.");
3655                 return;
3656         }
3657         if (st->volrecv){
3658                 ms_filter_call_method(st->volsend,MS_VOLUME_SET_DB_GAIN,&gain);
3659         }else ms_warning("Could not apply gain: gain control wasn't activated.");
3660 }
3661
3662 /**
3663  * Get microphone gain in db.
3664  *
3665  * @ingroup media_parameters
3666 **/
3667 float linphone_core_get_mic_gain_db(LinphoneCore *lc) {
3668         return lc->sound_conf.soft_mic_lev;
3669 }
3670
3671 /**
3672  * Allow to control play level before entering sound card:  gain in db
3673  *
3674  * @ingroup media_parameters
3675 **/
3676 void linphone_core_set_playback_gain_db (LinphoneCore *lc, float gaindb){
3677         float gain=gaindb;
3678         LinphoneCall *call=linphone_core_get_current_call (lc);
3679         AudioStream *st;
3680
3681         lc->sound_conf.soft_play_lev=gaindb;
3682         if (linphone_core_ready(lc)){
3683                 lp_config_set_float(lc->config,"sound","playback_gain_db",lc->sound_conf.soft_play_lev);
3684         }
3685
3686         if (call==NULL || (st=call->audiostream)==NULL){
3687                 ms_message("linphone_core_set_playback_gain_db(): no active call.");
3688                 return;
3689         }
3690         if (st->volrecv){
3691                 ms_filter_call_method(st->volrecv,MS_VOLUME_SET_DB_GAIN,&gain);
3692         }else ms_warning("Could not apply gain: gain control wasn't activated.");
3693 }
3694
3695 /**
3696  * Get playback gain in db before entering  sound card.
3697  *
3698  * @ingroup media_parameters
3699 **/
3700 float linphone_core_get_playback_gain_db(LinphoneCore *lc) {
3701         return lc->sound_conf.soft_play_lev;
3702 }
3703
3704 /**
3705  * Set sound playback level in 0-100 scale
3706  *
3707  * @ingroup media_parameters
3708 **/
3709 void linphone_core_set_play_level(LinphoneCore *lc, int level){
3710         MSSndCard *sndcard;
3711         lc->sound_conf.play_lev=level;
3712         sndcard=lc->sound_conf.play_sndcard;
3713         if (sndcard) ms_snd_card_set_level(sndcard,MS_SND_CARD_PLAYBACK,level);
3714 }
3715
3716 /**
3717  * Set sound capture level in 0-100 scale
3718  *
3719  * @ingroup media_parameters
3720 **/
3721 void linphone_core_set_rec_level(LinphoneCore *lc, int level)
3722 {
3723         MSSndCard *sndcard;
3724         lc->sound_conf.rec_lev=level;
3725         sndcard=lc->sound_conf.capt_sndcard;
3726         if (sndcard) ms_snd_card_set_level(sndcard,MS_SND_CARD_CAPTURE,level);
3727 }
3728
3729 static MSSndCard *get_card_from_string_id(const char *devid, unsigned int cap){
3730         MSSndCard *sndcard=NULL;
3731         if (devid!=NULL){
3732                 sndcard=ms_snd_card_manager_get_card(ms_snd_card_manager_get(),devid);
3733                 if (sndcard!=NULL &&
3734                         (ms_snd_card_get_capabilities(sndcard) & cap)==0 ){
3735                         ms_warning("%s card does not have the %s capability, ignoring.",
3736                                 devid,
3737                                 cap==MS_SND_CARD_CAP_CAPTURE ? "capture" : "playback");
3738                         sndcard=NULL;
3739                 }
3740         }
3741         if (sndcard==NULL) {
3742                 /* get a card that has read+write capabilities */
3743                 sndcard=ms_snd_card_manager_get_default_card(ms_snd_card_manager_get());
3744                 /* otherwise refine to the first card having the right capability*/
3745                 if (sndcard==NULL){
3746                         const MSList *elem=ms_snd_card_manager_get_list(ms_snd_card_manager_get());
3747                         for(;elem!=NULL;elem=elem->next){
3748                                 sndcard=(MSSndCard*)elem->data;
3749                                 if (ms_snd_card_get_capabilities(sndcard) & cap) break;
3750                         }
3751                 }
3752                 if (sndcard==NULL){/*looks like a bug! take the first one !*/
3753                         const MSList *elem=ms_snd_card_manager_get_list(ms_snd_card_manager_get());
3754                         if (elem) sndcard=(MSSndCard*)elem->data;
3755         }
3756         }
3757         if (sndcard==NULL) ms_error("Could not find a suitable soundcard !");
3758         return sndcard;
3759 }
3760
3761 /**
3762  * Returns true if the specified sound device can capture sound.
3763  *
3764  * @ingroup media_parameters
3765  * @param lc The LinphoneCore object
3766  * @param devid the device name as returned by linphone_core_get_sound_devices()
3767 **/
3768 bool_t linphone_core_sound_device_can_capture(LinphoneCore *lc, const char *devid){
3769         MSSndCard *sndcard;
3770         sndcard=ms_snd_card_manager_get_card(ms_snd_card_manager_get(),devid);
3771         if (sndcard!=NULL && (ms_snd_card_get_capabilities(sndcard) & MS_SND_CARD_CAP_CAPTURE)) return TRUE;
3772         return FALSE;
3773 }
3774
3775 /**
3776  * Returns true if the specified sound device can play sound.
3777  *
3778  * @ingroup media_parameters
3779  * @param lc The LinphoneCore object
3780  * @param devid the device name as returned by linphone_core_get_sound_devices()
3781 **/
3782 bool_t linphone_core_sound_device_can_playback(LinphoneCore *lc, const char *devid){
3783         MSSndCard *sndcard;
3784         sndcard=ms_snd_card_manager_get_card(ms_snd_card_manager_get(),devid);
3785         if (sndcard!=NULL && (ms_snd_card_get_capabilities(sndcard) & MS_SND_CARD_CAP_PLAYBACK)) return TRUE;
3786         return FALSE;
3787 }
3788
3789 /**
3790  * Sets the sound device used for ringing.
3791  *
3792  * @ingroup media_parameters
3793  * @param lc The LinphoneCore object
3794  * @param devid the device name as returned by linphone_core_get_sound_devices()
3795 **/
3796 int linphone_core_set_ringer_device(LinphoneCore *lc, const char * devid){
3797         MSSndCard *card=get_card_from_string_id(devid,MS_SND_CARD_CAP_PLAYBACK);
3798         lc->sound_conf.ring_sndcard=card;
3799         if (card && linphone_core_ready(lc))
3800                 lp_config_set_string(lc->config,"sound","ringer_dev_id",ms_snd_card_get_string_id(card));
3801         return 0;
3802 }
3803
3804 /**
3805  * Sets the sound device used for playback.
3806  *
3807  * @ingroup media_parameters
3808  * @param lc The LinphoneCore object
3809  * @param devid the device name as returned by linphone_core_get_sound_devices()
3810 **/
3811 int linphone_core_set_playback_device(LinphoneCore *lc, const char * devid){
3812         MSSndCard *card=get_card_from_string_id(devid,MS_SND_CARD_CAP_PLAYBACK);
3813         lc->sound_conf.play_sndcard=card;
3814         if (card &&  linphone_core_ready(lc))
3815                 lp_config_set_string(lc->config,"sound","playback_dev_id",ms_snd_card_get_string_id(card));
3816         return 0;
3817 }
3818
3819 /**
3820  * Sets the sound device used for capture.
3821  *
3822  * @ingroup media_parameters
3823  * @param lc The LinphoneCore object
3824  * @param devid the device name as returned by linphone_core_get_sound_devices()
3825 **/
3826 int linphone_core_set_capture_device(LinphoneCore *lc, const char * devid){
3827         MSSndCard *card=get_card_from_string_id(devid,MS_SND_CARD_CAP_CAPTURE);
3828         lc->sound_conf.capt_sndcard=card;
3829         if (card &&  linphone_core_ready(lc))
3830                 lp_config_set_string(lc->config,"sound","capture_dev_id",ms_snd_card_get_string_id(card));
3831         return 0;
3832 }
3833
3834 /**
3835  * Returns the name of the currently assigned sound device for ringing.
3836  *
3837  * @ingroup media_parameters
3838  * @param lc The LinphoneCore object
3839 **/
3840 const char * linphone_core_get_ringer_device(LinphoneCore *lc)
3841 {
3842         if (lc->sound_conf.ring_sndcard) return ms_snd_card_get_string_id(lc->sound_conf.ring_sndcard);
3843         return NULL;
3844 }
3845
3846 /**
3847  * Returns the name of the currently assigned sound device for playback.
3848  *
3849  * @ingroup media_parameters
3850  * @param lc The LinphoneCore object
3851 **/
3852 const char * linphone_core_get_playback_device(LinphoneCore *lc)
3853 {
3854         return lc->sound_conf.play_sndcard ? ms_snd_card_get_string_id(lc->sound_conf.play_sndcard) : NULL;
3855 }
3856
3857 /**
3858  * Returns the name of the currently assigned sound device for capture.
3859  *
3860  * @ingroup media_parameters
3861  * @param lc The LinphoneCore object
3862 **/
3863 const char * linphone_core_get_capture_device(LinphoneCore *lc)
3864 {
3865         return lc->sound_conf.capt_sndcard ? ms_snd_card_get_string_id(lc->sound_conf.capt_sndcard) : NULL;
3866 }
3867
3868 /**
3869  * Returns an unmodifiable array of available sound devices.
3870  *
3871  * The array is NULL terminated.
3872  *
3873  * @ingroup media_parameters
3874  * @param lc The LinphoneCore object
3875 **/
3876 const char**  linphone_core_get_sound_devices(LinphoneCore *lc){
3877         return lc->sound_conf.cards;
3878 }
3879
3880 /**
3881  * Returns an unmodifiable array of available video capture devices.
3882  *
3883  * @ingroup media_parameters
3884  * The array is NULL terminated.
3885 **/
3886 const char**  linphone_core_get_video_devices(const LinphoneCore *lc){
3887         return lc->video_conf.cams;
3888 }
3889
3890 /**
3891  * Update detection of sound devices.
3892  * 
3893  * Use this function when the application is notified of USB plug events, so that
3894  * list of available hardwares for sound playback and capture is updated.
3895  **/
3896 void linphone_core_reload_sound_devices(LinphoneCore *lc){
3897         const char *ringer,*playback,*capture;
3898         ringer=linphone_core_get_ringer_device(lc);
3899         playback=linphone_core_get_playback_device(lc);
3900         capture=linphone_core_get_capture_device(lc);
3901         ms_snd_card_manager_reload(ms_snd_card_manager_get());
3902         build_sound_devices_table(lc);
3903         linphone_core_set_ringer_device(lc,ringer);
3904         linphone_core_set_playback_device(lc,playback);
3905         linphone_core_set_capture_device(lc,capture);
3906 }
3907
3908 /**
3909  * Update detection of camera devices.
3910  * 
3911  * Use this function when the application is notified of USB plug events, so that
3912  * list of available hardwares for video capture is updated.
3913  **/
3914 void linphone_core_reload_video_devices(LinphoneCore *lc){
3915         const char *devid;
3916         devid=linphone_core_get_video_device(lc);
3917         ms_web_cam_manager_reload(ms_web_cam_manager_get());
3918         build_video_devices_table(lc);
3919         linphone_core_set_video_device(lc,devid);
3920 }
3921
3922 char linphone_core_get_sound_source(LinphoneCore *lc)
3923 {
3924         return lc->sound_conf.source;
3925 }
3926
3927 void linphone_core_set_sound_source(LinphoneCore *lc, char source)
3928 {
3929         MSSndCard *sndcard=lc->sound_conf.capt_sndcard;
3930         lc->sound_conf.source=source;
3931         if (!sndcard) return;
3932         switch(source){
3933                 case 'm':
3934                         ms_snd_card_set_capture(sndcard,MS_SND_CARD_MIC);
3935                         break;
3936                 case 'l':
3937                         ms_snd_card_set_capture(sndcard,MS_SND_CARD_LINE);
3938                         break;
3939         }
3940
3941 }
3942
3943
3944 /**
3945  * Sets the path to a wav file used for ringing.
3946  *
3947  * @param path The file must be a wav 16bit linear. Local ring is disabled if null
3948  * @param lc The LinphoneCore object
3949  *
3950  * @ingroup media_parameters
3951 **/
3952 void linphone_core_set_ring(LinphoneCore *lc,const char *path){
3953         if (lc->sound_conf.local_ring!=0){
3954                 ms_free(lc->sound_conf.local_ring);
3955                 lc->sound_conf.local_ring=NULL;
3956         }
3957         if (path)
3958                 lc->sound_conf.local_ring=ms_strdup(path);
3959         if ( linphone_core_ready(lc) && lc->sound_conf.local_ring)
3960                 lp_config_set_string(lc->config,"sound","local_ring",lc->sound_conf.local_ring);
3961 }
3962
3963 /**
3964  * Returns the path to the wav file used for ringing.
3965  *
3966  * @param lc The LinphoneCore object
3967  * @ingroup media_parameters
3968 **/
3969 const char *linphone_core_get_ring(const LinphoneCore *lc){
3970         return lc->sound_conf.local_ring;
3971 }
3972
3973 /**
3974  * Sets the path to a file or folder containing trusted root CAs (PEM format)
3975  *
3976  * @param path
3977  * @param lc The LinphoneCore object
3978  *
3979  * @ingroup initializing
3980 **/
3981 void linphone_core_set_root_ca(LinphoneCore *lc,const char *path){
3982         sal_set_root_ca(lc->sal, path);
3983 }
3984
3985 /**
3986  * Gets the path to a file or folder containing the trusted root CAs (PEM format)
3987  *
3988  * @param lc The LinphoneCore object
3989  *
3990  * @ingroup initializing
3991 **/
3992 const char *linphone_core_get_root_ca(LinphoneCore *lc){
3993         return sal_get_root_ca(lc->sal);
3994 }
3995
3996 /**
3997  * Specify whether the tls server certificate must be verified when connecting to a SIP/TLS server.
3998  * 
3999  * @ingroup initializing
4000 **/
4001 void linphone_core_verify_server_certificates(LinphoneCore *lc, bool_t yesno){
4002         sal_verify_server_certificates(lc->sal,yesno);
4003 }
4004
4005 /**
4006  * Specify whether the tls server certificate common name must be verified when connecting to a SIP/TLS server.
4007  * @ingroup initializing
4008 **/
4009 void linphone_core_verify_server_cn(LinphoneCore *lc, bool_t yesno){
4010         sal_verify_server_cn(lc->sal,yesno);
4011 }
4012
4013 static void notify_end_of_ring(void *ud, MSFilter *f, unsigned int event, void *arg){
4014         LinphoneCore *lc=(LinphoneCore*)ud;
4015         lc->preview_finished=1;
4016 }
4017
4018 int linphone_core_preview_ring(LinphoneCore *lc, const char *ring,LinphoneCoreCbFunc func,void * userdata)
4019 {
4020         if (lc->ringstream!=0){
4021                 ms_warning("Cannot start ring now,there's already a ring being played");
4022                 return -1;
4023         }
4024         lc_callback_obj_init(&lc->preview_finished_cb,func,userdata);
4025         lc->preview_finished=0;
4026         if (lc->sound_conf.ring_sndcard!=NULL){
4027                 MSSndCard *ringcard=lc->sound_conf.lsd_card ? lc->sound_conf.lsd_card : lc->sound_conf.ring_sndcard;
4028                 lc->ringstream=ring_start_with_cb(ring,2000,ringcard,notify_end_of_ring,(void *)lc);
4029         }
4030         return 0;
4031 }
4032
4033 /**
4034  * Sets the path to a wav file used for ringing back.
4035  *
4036  * Ringback means the ring that is heard when it's ringing at the remote party.
4037  * The file must be a wav 16bit linear.
4038  *
4039  * @ingroup media_parameters
4040 **/
4041 void linphone_core_set_ringback(LinphoneCore *lc, const char *path){
4042         if (lc->sound_conf.remote_ring!=0){
4043                 ms_free(lc->sound_conf.remote_ring);
4044         }
4045         lc->sound_conf.remote_ring=ms_strdup(path);
4046 }
4047
4048 /**
4049  * Returns the path to the wav file used for ringing back.
4050  *
4051  * @ingroup media_parameters
4052 **/
4053 const char * linphone_core_get_ringback(const LinphoneCore *lc){
4054         return lc->sound_conf.remote_ring;
4055 }
4056
4057 /**
4058  * Enables or disable echo cancellation. Value is saved an used for subsequent calls
4059  *
4060  * @ingroup media_parameters
4061 **/
4062 void linphone_core_enable_echo_cancellation(LinphoneCore *lc, bool_t val){
4063         lc->sound_conf.ec=val;
4064         if ( linphone_core_ready(lc))
4065                 lp_config_set_int(lc->config,"sound","echocancellation",val);
4066 }
4067
4068
4069 /**
4070  * Returns TRUE if echo cancellation is enabled.
4071  *
4072  * @ingroup media_parameters
4073 **/
4074 bool_t linphone_core_echo_cancellation_enabled(LinphoneCore *lc){
4075         return lc->sound_conf.ec;
4076 }
4077
4078 void linphone_core_enable_echo_limiter(LinphoneCore *lc, bool_t val){
4079         lc->sound_conf.ea=val;
4080 }
4081
4082 bool_t linphone_core_echo_limiter_enabled(const LinphoneCore *lc){
4083         return lc->sound_conf.ea;
4084 }
4085
4086 /**
4087  * Mutes or unmutes the local microphone.
4088  *
4089  * @ingroup media_parameters
4090 **/
4091 void linphone_core_mute_mic(LinphoneCore *lc, bool_t val){
4092         LinphoneCall *call=linphone_core_get_current_call(lc);
4093         AudioStream *st=NULL;
4094         if (linphone_core_is_in_conference(lc)){
4095                 lc->conf_ctx.local_muted=val;
4096                 st=lc->conf_ctx.local_participant;
4097         }else if (call==NULL){
4098                 ms_warning("linphone_core_mute_mic(): No current call !");
4099                 return;
4100         }else{
4101                 st=call->audiostream;
4102                 call->audio_muted=val;
4103         }
4104         if (st!=NULL){
4105                 audio_stream_set_mic_gain(st,
4106                         (val==TRUE) ? 0 : pow(10,lc->sound_conf.soft_mic_lev/10));
4107                 if ( linphone_core_get_rtp_no_xmit_on_audio_mute(lc) ){
4108                         audio_stream_mute_rtp(st,val);
4109                 }
4110                 
4111         }
4112 }
4113 /**
4114  * Returns whether microphone is muted.
4115 **/
4116 bool_t linphone_core_is_mic_muted(LinphoneCore *lc) {
4117         LinphoneCall *call=linphone_core_get_current_call(lc);
4118         if (linphone_core_is_in_conference(lc)){
4119                 return lc->conf_ctx.local_muted;
4120         }else if (call==NULL){
4121                 ms_warning("linphone_core_is_mic_muted(): No current call !");
4122                 return FALSE;
4123         }
4124         return call->audio_muted;
4125 }
4126
4127 // returns rtp transmission status for an active stream
4128 // if audio is muted and config parameter rtp_no_xmit_on_audio_mute
4129 // was set on then rtp transmission is also muted
4130 bool_t linphone_core_is_rtp_muted(LinphoneCore *lc){
4131         LinphoneCall *call=linphone_core_get_current_call(lc);
4132         if (call==NULL){
4133                 ms_warning("linphone_core_is_mic_muted(): No current call !");
4134                 return FALSE;
4135         }
4136         if( linphone_core_get_rtp_no_xmit_on_audio_mute(lc)){
4137                 return call->audio_muted;
4138         }
4139         return FALSE;
4140 }
4141
4142 void linphone_core_enable_agc(LinphoneCore *lc, bool_t val){
4143         lc->sound_conf.agc=val;
4144 }
4145
4146 bool_t linphone_core_agc_enabled(const LinphoneCore *lc){
4147         return lc->sound_conf.agc;
4148 }
4149
4150 /**
4151  * Send the specified dtmf.
4152  *
4153  * @ingroup media_parameters
4154  * This function only works during calls. The dtmf is automatically played to the user.
4155  * @param lc The LinphoneCore object
4156  * @param dtmf The dtmf name specified as a char, such as '0', '#' etc...
4157  *
4158 **/
4159 void linphone_core_send_dtmf(LinphoneCore *lc, char dtmf)
4160 {
4161         LinphoneCall *call=linphone_core_get_current_call(lc);
4162         if (call==NULL){
4163                 ms_warning("linphone_core_send_dtmf(): no active call");
4164                 return;
4165         }
4166         /*By default we send DTMF RFC2833 if we do not have enabled SIP_INFO but we can also send RFC2833 and SIP_INFO*/
4167         if (linphone_core_get_use_rfc2833_for_dtmf(lc)!=0 || linphone_core_get_use_info_for_dtmf(lc)==0)
4168         {
4169                 /* In Band DTMF */
4170                 if (call->audiostream!=NULL){
4171                         audio_stream_send_dtmf(call->audiostream,dtmf);
4172                 }
4173                 else
4174                 {
4175                         ms_error("we cannot send RFC2833 dtmf when we are not in communication");
4176                 }
4177         }
4178         if (linphone_core_get_use_info_for_dtmf(lc)!=0){
4179                 /* Out of Band DTMF (use INFO method) */
4180                 sal_call_send_dtmf(call->op,dtmf);
4181         }
4182 }
4183
4184 void linphone_core_set_stun_server(LinphoneCore *lc, const char *server){
4185         if (lc->net_conf.stun_server!=NULL)
4186                 ms_free(lc->net_conf.stun_server);
4187         if (server)
4188                 lc->net_conf.stun_server=ms_strdup(server);
4189         else lc->net_conf.stun_server=NULL;
4190         if (linphone_core_ready(lc))
4191                 lp_config_set_string(lc->config,"net","stun_server",lc->net_conf.stun_server);
4192 }
4193
4194 const char * linphone_core_get_stun_server(const LinphoneCore *lc){
4195         return lc->net_conf.stun_server;
4196 }
4197
4198 bool_t linphone_core_upnp_available(){
4199 #ifdef BUILD_UPNP
4200         return TRUE;
4201 #else
4202         return FALSE;
4203 #endif //BUILD_UPNP
4204 }
4205
4206 LinphoneUpnpState linphone_core_get_upnp_state(const LinphoneCore *lc){
4207 #ifdef BUILD_UPNP
4208         return linphone_upnp_context_get_state(lc->upnp);
4209 #else
4210         return LinphoneUpnpStateNotAvailable;
4211 #endif //BUILD_UPNP
4212 }
4213
4214 const char * linphone_core_get_upnp_external_ipaddress(const LinphoneCore *lc){
4215 #ifdef BUILD_UPNP
4216         return linphone_upnp_context_get_external_ipaddress(lc->upnp);
4217 #else
4218         return NULL;
4219 #endif //BUILD_UPNP
4220 }
4221
4222
4223 const char * linphone_core_get_relay_addr(const LinphoneCore *lc){
4224         return lc->net_conf.relay;
4225 }
4226
4227 int linphone_core_set_relay_addr(LinphoneCore *lc, const char *addr){
4228         if (lc->net_conf.relay!=NULL){
4229                 ms_free(lc->net_conf.relay);
4230                 lc->net_conf.relay=NULL;
4231         }
4232         if (addr){
4233                 lc->net_conf.relay=ms_strdup(addr);
4234         }
4235         return 0;
4236 }
4237
4238 void linphone_core_set_nat_address(LinphoneCore *lc, const char *addr)
4239 {
4240         if (lc->net_conf.nat_address!=NULL){
4241                 ms_free(lc->net_conf.nat_address);
4242         }
4243         if (addr!=NULL) lc->net_conf.nat_address=ms_strdup(addr);
4244         else lc->net_conf.nat_address=NULL;
4245         if (lc->sip_conf.contact) update_primary_contact(lc);
4246 }
4247
4248 const char *linphone_core_get_nat_address(const LinphoneCore *lc) {
4249         return lc->net_conf.nat_address;
4250 }
4251
4252 const char *linphone_core_get_nat_address_resolved(LinphoneCore *lc)
4253 {
4254         struct sockaddr_storage ss;
4255         socklen_t ss_len;
4256         int error;
4257         char ipstring [INET6_ADDRSTRLEN];
4258
4259         if (lc->net_conf.nat_address==NULL) return NULL;
4260         
4261         if (parse_hostname_to_addr (lc->net_conf.nat_address, &ss, &ss_len)<0) {
4262                 return lc->net_conf.nat_address;
4263         }
4264
4265         error = getnameinfo((struct sockaddr *)&ss, ss_len,
4266                 ipstring, sizeof(ipstring), NULL, 0, NI_NUMERICHOST);
4267         if (error) {
4268                 return lc->net_conf.nat_address;
4269         }
4270
4271         if (lc->net_conf.nat_address_ip!=NULL){
4272                 ms_free(lc->net_conf.nat_address_ip);
4273         }
4274         lc->net_conf.nat_address_ip = ms_strdup (ipstring);
4275         return lc->net_conf.nat_address_ip;
4276 }
4277
4278 void linphone_core_set_firewall_policy(LinphoneCore *lc, LinphoneFirewallPolicy pol){
4279 #ifndef BUILD_UPNP
4280         if(pol == LinphonePolicyUseUpnp) {
4281                 ms_warning("UPNP is not available, reset firewall policy to no firewall");
4282                 pol = LinphonePolicyNoFirewall;
4283         }
4284 #endif //BUILD_UPNP
4285         lc->net_conf.firewall_policy=pol;
4286 #ifdef BUILD_UPNP
4287         if(pol == LinphonePolicyUseUpnp) {
4288                 if(lc->upnp == NULL) {
4289                         lc->upnp = linphone_upnp_context_new(lc);
4290                 }
4291         } else {
4292                 if(lc->upnp != NULL) {
4293                         linphone_upnp_context_destroy(lc->upnp);
4294                         lc->upnp = NULL;
4295                 }
4296         }
4297         linphone_core_enable_keep_alive(lc, (lc->sip_conf.keepalive_period > 0));
4298 #endif //BUILD_UPNP
4299         if (lc->sip_conf.contact) update_primary_contact(lc);
4300         if (linphone_core_ready(lc))
4301                 lp_config_set_int(lc->config,"net","firewall_policy",pol);
4302 }
4303
4304 LinphoneFirewallPolicy linphone_core_get_firewall_policy(const LinphoneCore *lc){
4305         return lc->net_conf.firewall_policy;
4306 }
4307
4308 /**
4309  * Get the list of call logs (past calls).
4310  *
4311  * @ingroup call_logs
4312 **/
4313 const MSList * linphone_core_get_call_logs(LinphoneCore *lc){
4314         return lc->call_logs;
4315 }
4316
4317 /**
4318  * Erase the call log.
4319  *
4320  * @ingroup call_logs
4321 **/
4322 void linphone_core_clear_call_logs(LinphoneCore *lc){
4323         lc->missed_calls=0;
4324         ms_list_for_each(lc->call_logs,(void (*)(void*))linphone_call_log_destroy);
4325         lc->call_logs=ms_list_free(lc->call_logs);
4326         call_logs_write_to_config_file(lc);
4327 }
4328
4329 /**
4330  * Returns number of missed calls.
4331  * Once checked, this counter can be reset with linphone_core_reset_missed_calls_count().
4332 **/
4333 int linphone_core_get_missed_calls_count(LinphoneCore *lc) {
4334         return lc->missed_calls;
4335 }
4336
4337 /**
4338  * Resets the counter of missed calls.
4339 **/
4340 void linphone_core_reset_missed_calls_count(LinphoneCore *lc) {
4341         lc->missed_calls=0;
4342 }
4343
4344 /**
4345  * Remove a specific call log from call history list.
4346  * This function destroys the call log object. It must not be accessed anymore by the application after calling this function.
4347  * @param lc the linphone core object
4348  * @param a LinphoneCallLog object.
4349 **/
4350 void linphone_core_remove_call_log(LinphoneCore *lc, LinphoneCallLog *cl){
4351         lc->call_logs = ms_list_remove(lc->call_logs, cl);
4352         call_logs_write_to_config_file(lc);
4353         linphone_call_log_destroy(cl);
4354 }
4355
4356 static void toggle_video_preview(LinphoneCore *lc, bool_t val){
4357 #ifdef VIDEO_ENABLED
4358         if (val){
4359                 if (lc->previewstream==NULL){
4360                         lc->previewstream=video_preview_new();
4361                         video_preview_set_size(lc->previewstream,lc->video_conf.vsize);
4362                         if (lc->video_conf.displaytype)
4363                                 video_preview_set_display_filter_name(lc->previewstream,lc->video_conf.displaytype);
4364                         if (lc->preview_window_id!=0)
4365                                 video_preview_set_native_window_id(lc->previewstream,lc->preview_window_id);
4366                         video_preview_start(lc->previewstream,lc->video_conf.device);
4367                 }
4368         }else{
4369                 if (lc->previewstream!=NULL){
4370                         video_preview_stop(lc->previewstream);
4371                         lc->previewstream=NULL;
4372                 }
4373         }
4374 #endif
4375 }
4376
4377 /**
4378  * Enables video globally.
4379  *
4380  * @ingroup media_parameters
4381  * This function does not have any effect during calls. It just indicates LinphoneCore to
4382  * initiate future calls with video or not. The two boolean parameters indicate in which
4383  * direction video is enabled. Setting both to false disables video entirely.
4384  *
4385  * @param lc The LinphoneCore object
4386  * @param vcap_enabled indicates whether video capture is enabled
4387  * @param display_enabled indicates whether video display should be shown
4388  *
4389 **/
4390 void linphone_core_enable_video(LinphoneCore *lc, bool_t vcap_enabled, bool_t display_enabled){
4391 #ifndef VIDEO_ENABLED
4392         if (vcap_enabled || display_enabled)
4393                 ms_warning("This version of linphone was built without video support.");
4394 #endif
4395         lc->video_conf.capture=vcap_enabled;
4396         lc->video_conf.display=display_enabled;
4397         if (linphone_core_ready(lc)){
4398                 lp_config_set_int(lc->config,"video","display",lc->video_conf.display);
4399                 lp_config_set_int(lc->config,"video","capture",lc->video_conf.capture);
4400         }
4401         /* need to re-apply network bandwidth settings*/
4402         linphone_core_set_download_bandwidth(lc,
4403                 linphone_core_get_download_bandwidth(lc));
4404         linphone_core_set_upload_bandwidth(lc,
4405                 linphone_core_get_upload_bandwidth(lc));
4406 }
4407
4408 bool_t linphone_core_video_supported(LinphoneCore *lc){
4409 #ifdef VIDEO_ENABLED
4410         return TRUE;
4411 #else
4412         return FALSE;
4413 #endif
4414 }
4415
4416 /**
4417  * Returns TRUE if video is enabled, FALSE otherwise.
4418  * @ingroup media_parameters
4419 **/
4420 bool_t linphone_core_video_enabled(LinphoneCore *lc){
4421         return (lc->video_conf.display || lc->video_conf.capture);
4422 }
4423
4424 /**
4425  * Sets the default policy for video.
4426  * This policy defines whether:
4427  * - video shall be initiated by default for outgoing calls
4428  * - video shall be accepter by default for incoming calls
4429  * @ingroup media_parameters
4430 **/
4431 void linphone_core_set_video_policy(LinphoneCore *lc, const LinphoneVideoPolicy *policy){
4432         lc->video_policy=*policy;
4433         if (linphone_core_ready(lc)){
4434                 lp_config_set_int(lc->config,"video","automatically_initiate",policy->automatically_initiate);
4435                 lp_config_set_int(lc->config,"video","automatically_accept",policy->automatically_accept);
4436         }
4437 }
4438
4439 /**
4440  * Get the default policy for video.
4441  * See linphone_core_set_video_policy() for more details.
4442  * @ingroup media_parameters
4443 **/
4444 const LinphoneVideoPolicy *linphone_core_get_video_policy(LinphoneCore *lc){
4445         return &lc->video_policy;
4446 }
4447
4448 /**
4449  * Controls video preview enablement.
4450  *
4451  * @ingroup media_parameters
4452  * Video preview refers to the action of displaying the local webcam image
4453  * to the user while not in call.
4454 **/
4455 void linphone_core_enable_video_preview(LinphoneCore *lc, bool_t val){
4456         lc->video_conf.show_local=val;
4457         if (linphone_core_ready(lc))
4458                 lp_config_set_int(lc->config,"video","show_local",val);
4459 }
4460
4461 /**
4462  * Returns TRUE if video previewing is enabled.
4463  * @ingroup media_parameters
4464 **/
4465 bool_t linphone_core_video_preview_enabled(const LinphoneCore *lc){
4466         return lc->video_conf.show_local;
4467 }
4468
4469 /**
4470  * Enables or disable self view during calls.
4471  *
4472  * @ingroup media_parameters
4473  * Self-view refers to having local webcam image inserted in corner
4474  * of the video window during calls.
4475  * This function works at any time, including during calls.
4476 **/
4477 void linphone_core_enable_self_view(LinphoneCore *lc, bool_t val){
4478 #ifdef VIDEO_ENABLED
4479         LinphoneCall *call=linphone_core_get_current_call (lc);
4480         lc->video_conf.selfview=val;
4481         if (call && call->videostream){
4482                 video_stream_enable_self_view(call->videostream,val);
4483         }
4484         if (linphone_core_ready(lc)){
4485                 lp_config_set_int(lc->config,"video","self_view",val);
4486         }
4487 #endif
4488 }
4489
4490 /**
4491  * Returns TRUE if self-view is enabled, FALSE otherwise.
4492  *
4493  * @ingroup media_parameters
4494  *
4495  * Refer to linphone_core_enable_self_view() for details.
4496 **/
4497 bool_t linphone_core_self_view_enabled(const LinphoneCore *lc){
4498         return lc->video_conf.selfview;
4499 }
4500
4501 /**
4502  * Sets the active video device.
4503  *
4504  * @ingroup media_parameters
4505  * @param lc The LinphoneCore object
4506  * @param id the name of the video device as returned by linphone_core_get_video_devices()
4507 **/
4508 int linphone_core_set_video_device(LinphoneCore *lc, const char *id){
4509         MSWebCam *olddev=lc->video_conf.device;
4510         const char *vd;
4511         if (id!=NULL){
4512                 lc->video_conf.device=ms_web_cam_manager_get_cam(ms_web_cam_manager_get(),id);
4513                 if (lc->video_conf.device==NULL){
4514                         ms_warning("Could not find video device %s",id);
4515                 }
4516         }
4517         if (lc->video_conf.device==NULL)
4518                 lc->video_conf.device=ms_web_cam_manager_get_default_cam(ms_web_cam_manager_get());
4519         if (olddev!=NULL && olddev!=lc->video_conf.device){
4520                 toggle_video_preview(lc,FALSE);/*restart the video local preview*/
4521         }
4522         if ( linphone_core_ready(lc) && lc->video_conf.device){
4523                 vd=ms_web_cam_get_string_id(lc->video_conf.device);
4524                 if (vd && strstr(vd,"Static picture")!=NULL){
4525                         vd=NULL;
4526                 }
4527                 lp_config_set_string(lc->config,"video","device",vd);
4528         }
4529         return 0;
4530 }
4531
4532 /**
4533  * Returns the name of the currently active video device.
4534  *
4535  * @param lc The LinphoneCore object
4536  * @ingroup media_parameters
4537 **/
4538 const char *linphone_core_get_video_device(const LinphoneCore *lc){
4539         if (lc->video_conf.device) return ms_web_cam_get_string_id(lc->video_conf.device);
4540         return NULL;
4541 }
4542
4543 #ifdef VIDEO_ENABLED
4544 static VideoStream * get_active_video_stream(LinphoneCore *lc){
4545         VideoStream *vs = NULL;
4546         LinphoneCall *call=linphone_core_get_current_call (lc);
4547         /* Select the video stream from the call in the first place */
4548         if (call && call->videostream) {
4549                 vs = call->videostream;
4550         }
4551         /* If not in call, select the video stream from the preview */
4552         if (vs == NULL && lc->previewstream) {
4553                 vs = lc->previewstream;
4554         }
4555         return vs;
4556 }
4557 #endif
4558
4559 int linphone_core_set_static_picture(LinphoneCore *lc, const char *path) {
4560 #ifdef VIDEO_ENABLED
4561         VideoStream *vs=get_active_video_stream(lc);
4562         /* If we have a video stream (either preview, either from call), we
4563                  have a source and it is using the static picture filter, then
4564                  force the filter to use that picture. */
4565         if (vs && vs->source) {
4566                 if (ms_filter_get_id(vs->source) == MS_STATIC_IMAGE_ID) {
4567                         ms_filter_call_method(vs->source, MS_STATIC_IMAGE_SET_IMAGE,
4568                                                                                                                 (void *)path);
4569                 }
4570         }
4571         /* Tell the static image filter to use that image from now on so
4572                  that the image will be used next time it has to be read */
4573         ms_static_image_set_default_image(path);
4574 #else
4575         ms_warning("Video support not compiled.");
4576 #endif
4577         return 0;
4578 }
4579
4580 const char *linphone_core_get_static_picture(LinphoneCore *lc) {
4581         const char *path=NULL;
4582 #ifdef VIDEO_ENABLED
4583         path=ms_static_image_get_default_image();       
4584 #else
4585         ms_warning("Video support not compiled.");
4586 #endif
4587         return path;
4588 }
4589
4590 int linphone_core_set_static_picture_fps(LinphoneCore *lc, float fps) {
4591 #ifdef VIDEO_ENABLED
4592         VideoStream *vs = NULL;
4593
4594         vs=get_active_video_stream(lc);
4595
4596         /* If we have a video stream (either preview, either from call), we
4597                  have a source and it is using the static picture filter, then
4598                  force the filter to use that picture. */
4599         if (vs && vs->source) {
4600                 if (ms_filter_get_id(vs->source) == MS_STATIC_IMAGE_ID) {
4601                         ms_filter_call_method(vs->source, MS_FILTER_SET_FPS,(void *)&fps);
4602                 }
4603         }
4604 #else
4605         ms_warning("Video support not compiled.");
4606 #endif
4607         return 0;
4608 }
4609
4610 float linphone_core_get_static_picture_fps(LinphoneCore *lc) {
4611 #ifdef VIDEO_ENABLED
4612         VideoStream *vs = NULL;
4613         vs=get_active_video_stream(lc);
4614         /* If we have a video stream (either preview, either from call), we
4615                  have a source and it is using the static picture filter, then
4616                  force the filter to use that picture. */
4617         if (vs && vs->source) {
4618                 if (ms_filter_get_id(vs->source) == MS_STATIC_IMAGE_ID) {
4619
4620                         float fps;
4621
4622                         ms_filter_call_method(vs->source, MS_FILTER_GET_FPS,(void *)&fps);
4623                         return fps;
4624                 }
4625         }
4626 #else
4627         ms_warning("Video support not compiled.");
4628 #endif
4629         return 0;
4630 }
4631
4632 /**
4633  * Returns the native window handle of the video window, casted as an unsigned long.
4634  *
4635  * @ingroup media_parameters
4636 **/
4637 unsigned long linphone_core_get_native_video_window_id(const LinphoneCore *lc){
4638 #ifdef VIDEO_ENABLED
4639         LinphoneCall *call=linphone_core_get_current_call (lc);
4640         if (call && call->videostream)
4641                 return video_stream_get_native_window_id(call->videostream);
4642         if (lc->previewstream)
4643                 return video_stream_get_native_window_id(lc->previewstream);
4644 #endif
4645         return lc->video_window_id;
4646 }
4647
4648 /**@ingroup media_parameters
4649  * Set the native video window id where the video is to be displayed.
4650  * If not set the core will create its own window.
4651 **/
4652 void linphone_core_set_native_video_window_id(LinphoneCore *lc, unsigned long id){
4653 #ifdef VIDEO_ENABLED
4654         LinphoneCall *call=linphone_core_get_current_call(lc);
4655         lc->video_window_id=id;
4656         if (call!=NULL && call->videostream){
4657                 video_stream_set_native_window_id(call->videostream,id);
4658         }
4659 #endif
4660 }
4661
4662 /**
4663  * Returns the native window handle of the video preview window, casted as an unsigned long.
4664  *
4665  * @ingroup media_parameters
4666 **/
4667 unsigned long linphone_core_get_native_preview_window_id(const LinphoneCore *lc){
4668 #ifdef VIDEO_ENABLED
4669         LinphoneCall *call=linphone_core_get_current_call (lc);
4670         if (call && call->videostream)
4671                 return video_stream_get_native_preview_window_id(call->videostream);
4672         if (lc->previewstream)
4673                 return video_preview_get_native_window_id(lc->previewstream);
4674 #endif
4675         return lc->preview_window_id;
4676 }
4677
4678 /**
4679  * @ingroup media_parameters
4680  * Set the native window id where the preview video (local camera) is to be displayed.
4681  * This has to be used in conjonction with linphone_core_use_preview_window().
4682  * If not set the core will create its own window.
4683 **/
4684 void linphone_core_set_native_preview_window_id(LinphoneCore *lc, unsigned long id){
4685 #ifdef VIDEO_ENABLED
4686         LinphoneCall *call=linphone_core_get_current_call(lc);
4687         lc->preview_window_id=id;
4688         if (call!=NULL && call->videostream){
4689                 video_stream_set_native_preview_window_id(call->videostream,id);
4690         }else if (lc->previewstream){
4691                 video_preview_set_native_window_id(lc->previewstream,id);
4692         }
4693 #endif
4694 }
4695
4696 /**
4697  * Can be used to disable video showing to free XV port
4698 **/
4699 void linphone_core_show_video(LinphoneCore *lc, bool_t show){
4700 #ifdef VIDEO_ENABLED
4701         LinphoneCall *call=linphone_core_get_current_call(lc);
4702         ms_error("linphone_core_show_video %d", show);
4703         if (call!=NULL && call->videostream){
4704                 video_stream_show_video(call->videostream,show);
4705         }
4706 #endif
4707 }
4708
4709 /**
4710  * Tells the core to use a separate window for local camera preview video, instead of
4711  * inserting local view within the remote video window.
4712  *
4713 **/
4714 void linphone_core_use_preview_window(LinphoneCore *lc, bool_t yesno){
4715         lc->use_preview_window=yesno;
4716 }
4717 /**
4718  * @ingroup media_parameters
4719  *returns current device orientation
4720  */
4721 int linphone_core_get_device_rotation(LinphoneCore *lc ) {
4722         return lc->device_rotation;
4723 }
4724 /**
4725  * @ingroup media_parameters
4726  * Tells the core the device current orientation. This can be used by capture filters
4727  * on mobile devices to select between portrait/landscape mode and to produce properly
4728  * oriented images. The exact meaning of the value in rotation if left to each device
4729  * specific implementations.
4730  *@param lc  object.
4731  *@param rotation . IOS supported values are 0 for UIInterfaceOrientationPortrait and 270 for UIInterfaceOrientationLandscapeRight.
4732  *
4733 **/
4734 void linphone_core_set_device_rotation(LinphoneCore *lc, int rotation) {
4735         ms_message("%s : rotation=%d\n", __FUNCTION__, rotation);
4736         lc->device_rotation = rotation;
4737 #ifdef VIDEO_ENABLED
4738         {
4739                 LinphoneCall *call=linphone_core_get_current_call(lc);
4740                 if (call!=NULL && call->videostream){
4741                         video_stream_set_device_rotation(call->videostream,rotation);
4742                 }
4743         }
4744 #endif
4745 }
4746
4747 int linphone_core_get_camera_sensor_rotation(LinphoneCore *lc) {
4748 #ifdef VIDEO_ENABLED
4749         LinphoneCall *call = linphone_core_get_current_call(lc);
4750         if ((call != NULL) && (call->videostream != NULL)) {
4751                 return video_stream_get_camera_sensor_rotation(call->videostream);
4752         }
4753 #endif
4754         return -1;
4755 }
4756
4757 static MSVideoSizeDef supported_resolutions[]={
4758 #ifdef ENABLE_HD
4759         {       {MS_VIDEO_SIZE_1080P_W,MS_VIDEO_SIZE_1080P_H}   ,       "1080p" },
4760         {       {MS_VIDEO_SIZE_720P_W,MS_VIDEO_SIZE_720P_H}     ,       "1080p" },
4761 #endif
4762         {       {MS_VIDEO_SIZE_SVGA_W,MS_VIDEO_SIZE_SVGA_H}     ,       "svga"  },
4763         {       {MS_VIDEO_SIZE_4CIF_W,MS_VIDEO_SIZE_4CIF_H}     ,       "4cif"  },
4764         {       {MS_VIDEO_SIZE_VGA_W,MS_VIDEO_SIZE_VGA_H}       ,       "vga"   },
4765         {       {MS_VIDEO_SIZE_IOS_MEDIUM_H,MS_VIDEO_SIZE_IOS_MEDIUM_W} ,       "ios-medium"    },
4766         {       {MS_VIDEO_SIZE_CIF_W,MS_VIDEO_SIZE_CIF_H}       ,       "cif"   },
4767         {       {MS_VIDEO_SIZE_QVGA_W,MS_VIDEO_SIZE_QVGA_H}     ,       "qvga"  },
4768         {       {MS_VIDEO_SIZE_QCIF_W,MS_VIDEO_SIZE_QCIF_H}     ,       "qcif"  },      
4769         {       {0,0}                   ,       NULL    }
4770 };
4771
4772 /**
4773  * Returns the zero terminated table of supported video resolutions.
4774  *
4775  * @ingroup media_parameters
4776 **/
4777 const MSVideoSizeDef *linphone_core_get_supported_video_sizes(LinphoneCore *lc){
4778         return supported_resolutions;
4779 }
4780
4781 static MSVideoSize video_size_get_by_name(const char *name){
4782         MSVideoSizeDef *pdef=supported_resolutions;
4783         MSVideoSize null_vsize={0,0};
4784         for(;pdef->name!=NULL;pdef++){
4785                 if (strcasecmp(name,pdef->name)==0){
4786                         return pdef->vsize;
4787                 }
4788         }
4789         ms_warning("Video resolution %s is not supported in linphone.",name);
4790         return null_vsize;
4791 }
4792
4793 static const char *video_size_get_name(MSVideoSize vsize){
4794         MSVideoSizeDef *pdef=supported_resolutions;
4795         for(;pdef->name!=NULL;pdef++){
4796                 if (pdef->vsize.width==vsize.width && pdef->vsize.height==vsize.height){
4797                         return pdef->name;
4798                 }
4799         }
4800         return NULL;
4801 }
4802
4803 static bool_t video_size_supported(MSVideoSize vsize){
4804         if (video_size_get_name(vsize)) return TRUE;
4805         ms_warning("Video resolution %ix%i is not supported in linphone.",vsize.width,vsize.height);
4806         return FALSE;
4807 }
4808
4809 /**
4810  * Sets the preferred video size.
4811  *
4812  * @ingroup media_parameters
4813  * This applies only to the stream that is captured and sent to the remote party,
4814  * since we accept all standard video size on the receive path.
4815 **/
4816 void linphone_core_set_preferred_video_size(LinphoneCore *lc, MSVideoSize vsize){
4817         if (video_size_supported(vsize)){
4818                 MSVideoSize oldvsize=lc->video_conf.vsize;
4819                 lc->video_conf.vsize=vsize;
4820                 if (!ms_video_size_equal(oldvsize,vsize) && lc->previewstream!=NULL){
4821                         toggle_video_preview(lc,FALSE);
4822                         toggle_video_preview(lc,TRUE);
4823                 }
4824                 if ( linphone_core_ready(lc))
4825                         lp_config_set_string(lc->config,"video","size",video_size_get_name(vsize));
4826         }
4827 }
4828
4829 /**
4830  * Sets the preferred video size by its name.
4831  *
4832  * @ingroup media_parameters
4833  * This is identical to linphone_core_set_preferred_video_size() except
4834  * that it takes the name of the video resolution as input.
4835  * Video resolution names are: qcif, svga, cif, vga, 4cif, svga ...
4836 **/
4837 void linphone_core_set_preferred_video_size_by_name(LinphoneCore *lc, const char *name){
4838         MSVideoSize vsize=video_size_get_by_name(name);
4839         MSVideoSize default_vsize={MS_VIDEO_SIZE_CIF_W,MS_VIDEO_SIZE_CIF_H};
4840         if (vsize.width!=0)     linphone_core_set_preferred_video_size(lc,vsize);
4841         else linphone_core_set_preferred_video_size(lc,default_vsize);
4842 }
4843
4844 /**
4845  * Returns the current preferred video size for sending.
4846  *
4847  * @ingroup media_parameters
4848 **/
4849 MSVideoSize linphone_core_get_preferred_video_size(LinphoneCore *lc){
4850         return lc->video_conf.vsize;
4851 }
4852
4853 /**
4854  * Ask the core to stream audio from and to files, instead of using the soundcard.
4855 **/
4856 void linphone_core_use_files(LinphoneCore *lc, bool_t yesno){
4857         lc->use_files=yesno;
4858 }
4859
4860 /**
4861  * Sets a wav file to be played when putting somebody on hold,
4862  * or when files are used instead of soundcards (see linphone_core_use_files()).
4863  *
4864  * The file must be a 16 bit linear wav file.
4865 **/
4866 void linphone_core_set_play_file(LinphoneCore *lc, const char *file){
4867         LinphoneCall *call=linphone_core_get_current_call(lc);
4868         if (lc->play_file!=NULL){
4869                 ms_free(lc->play_file);
4870                 lc->play_file=NULL;
4871         }
4872         if (file!=NULL) {
4873                 lc->play_file=ms_strdup(file);
4874                 if (call && call->audiostream && call->audiostream->ms.ticker)
4875                         audio_stream_play(call->audiostream,file);
4876         }
4877 }
4878
4879
4880 /**
4881  * Sets a wav file where incoming stream is to be recorded,
4882  * when files are used instead of soundcards (see linphone_core_use_files()).
4883  *
4884  * This feature is different from call recording (linphone_call_params_set_record_file())
4885  * The file will be a 16 bit linear wav file.
4886 **/
4887 void linphone_core_set_record_file(LinphoneCore *lc, const char *file){
4888         LinphoneCall *call=linphone_core_get_current_call(lc);
4889         if (lc->rec_file!=NULL){
4890                 ms_free(lc->rec_file);
4891                 lc->rec_file=NULL;
4892         }
4893         if (file!=NULL) {
4894                 lc->rec_file=ms_strdup(file);
4895                 if (call && call->audiostream)
4896                         audio_stream_record(call->audiostream,file);
4897         }
4898 }
4899
4900
4901 static MSFilter *get_dtmf_gen(LinphoneCore *lc){
4902         LinphoneCall *call=linphone_core_get_current_call (lc);
4903         AudioStream *stream=NULL;
4904         if (call){
4905                 stream=call->audiostream;
4906         }else if (linphone_core_is_in_conference(lc)){
4907                 stream=lc->conf_ctx.local_participant;
4908         }
4909         if (stream){
4910                 return stream->dtmfgen;
4911         }
4912         if (lc->ringstream==NULL){
4913                 float amp=lp_config_get_float(lc->config,"sound","dtmf_player_amp",0.1);
4914                 MSSndCard *ringcard=lc->sound_conf.lsd_card ?lc->sound_conf.lsd_card : lc->sound_conf.ring_sndcard;
4915                 if (ringcard == NULL)
4916                         return NULL;
4917
4918                 lc->ringstream=ring_start(NULL,0,ringcard);
4919                 ms_filter_call_method(lc->ringstream->gendtmf,MS_DTMF_GEN_SET_DEFAULT_AMPLITUDE,&amp);
4920                 lc->dmfs_playing_start_time=time(NULL);
4921         }else{
4922                 if (lc->dmfs_playing_start_time!=0)
4923                         lc->dmfs_playing_start_time=time(NULL);
4924         }
4925         return lc->ringstream->gendtmf;
4926 }
4927
4928 /**
4929  * @ingroup media_parameters
4930  * Plays a dtmf sound to the local user.
4931  * @param lc #LinphoneCore
4932  * @param dtmf DTMF to play ['0'..'16'] | '#' | '#'
4933  * @param duration_ms duration in ms, -1 means play until next further call to #linphone_core_stop_dtmf()
4934 **/
4935 void linphone_core_play_dtmf(LinphoneCore *lc, char dtmf, int duration_ms){
4936         MSFilter *f=get_dtmf_gen(lc);
4937         if (f==NULL){
4938                 ms_error("No dtmf generator at this time !");
4939                 return;
4940         }
4941
4942         if (duration_ms>0)
4943                 ms_filter_call_method(f, MS_DTMF_GEN_PLAY, &dtmf);
4944         else ms_filter_call_method(f, MS_DTMF_GEN_START, &dtmf);
4945 }
4946
4947 void linphone_core_play_named_tone(LinphoneCore *lc, LinphoneToneID toneid){
4948         if (linphone_core_tone_indications_enabled(lc)){
4949                 MSFilter *f=get_dtmf_gen(lc);
4950                 MSDtmfGenCustomTone def;
4951                 if (f==NULL){
4952                         ms_error("No dtmf generator at this time !");
4953                         return;
4954                 }
4955                 memset(&def,0,sizeof(def));
4956                 def.amplitude=1;
4957                 /*these are french tones, excepted the failed one, which is USA congestion tone (does not exist in France)*/
4958                 switch(toneid){
4959                         case LinphoneToneCallOnHold:
4960                         case LinphoneToneCallWaiting:
4961                                 def.duration=300;
4962                                 def.frequencies[0]=440;
4963                                 def.interval=2000;
4964                         break;
4965                         case LinphoneToneBusy:
4966                                 def.duration=500;
4967                                 def.frequencies[0]=440;
4968                                 def.interval=500;
4969                                 def.repeat_count=3;
4970                         break;
4971                         case LinphoneToneCallFailed:
4972                                 def.duration=250;
4973                                 def.frequencies[0]=480;
4974                                 def.frequencies[0]=620;
4975                                 def.interval=250;
4976                                 def.repeat_count=3;
4977                                 
4978                         break;
4979                         default:
4980                                 ms_warning("Unhandled tone id.");
4981                 }
4982                 if (def.duration>0)
4983                         ms_filter_call_method(f, MS_DTMF_GEN_PLAY_CUSTOM,&def);
4984         }
4985 }
4986
4987 /**
4988  * @ingroup media_parameters
4989  *
4990  * Stops playing a dtmf started by linphone_core_play_dtmf().
4991 **/
4992 void linphone_core_stop_dtmf(LinphoneCore *lc){
4993         MSFilter *f=get_dtmf_gen(lc);
4994         if (f!=NULL)
4995                 ms_filter_call_method_noarg (f, MS_DTMF_GEN_STOP);
4996 }
4997
4998
4999
5000 /**
5001  * Retrieves the user pointer that was given to linphone_core_new()
5002  *
5003  * @ingroup initializing
5004 **/
5005 void *linphone_core_get_user_data(LinphoneCore *lc){
5006         return lc->data;
5007 }
5008
5009
5010 /**
5011  * Associate a user pointer to the linphone core.
5012  *
5013  * @ingroup initializing
5014 **/
5015 void linphone_core_set_user_data(LinphoneCore *lc, void *userdata){
5016         lc->data=userdata;
5017 }
5018
5019 int linphone_core_get_mtu(const LinphoneCore *lc){
5020         return lc->net_conf.mtu;
5021 }
5022
5023 /**
5024  * Sets the maximum transmission unit size in bytes.
5025  * This information is useful for sending RTP packets.
5026  * Default value is 1500.
5027  * 
5028  * @ingroup media_parameters
5029 **/
5030 void linphone_core_set_mtu(LinphoneCore *lc, int mtu){
5031         lc->net_conf.mtu=mtu;
5032         if (mtu>0){
5033                 if (mtu<500){
5034                         ms_error("MTU too small !");
5035                         mtu=500;
5036                 }
5037                 ms_set_mtu(mtu);
5038                 ms_message("MTU is supposed to be %i, rtp payload max size will be %i",mtu, ms_get_payload_max_size());
5039         }else ms_set_mtu(0);//use mediastreamer2 default value
5040 }
5041
5042 void linphone_core_set_waiting_callback(LinphoneCore *lc, LinphoneWaitingCallback cb, void *user_context){
5043         lc->wait_cb=cb;
5044         lc->wait_ctx=user_context;
5045 }
5046
5047 void linphone_core_start_waiting(LinphoneCore *lc, const char *purpose){
5048         if (lc->wait_cb){
5049                 lc->wait_ctx=lc->wait_cb(lc,lc->wait_ctx,LinphoneWaitingStart,purpose,0);
5050         }
5051 }
5052
5053 void linphone_core_update_progress(LinphoneCore *lc, const char *purpose, float progress){
5054         if (lc->wait_cb){
5055                 lc->wait_ctx=lc->wait_cb(lc,lc->wait_ctx,LinphoneWaitingProgress,purpose,progress);
5056         }else{
5057 #ifdef WIN32
5058                 Sleep(50000);
5059 #else
5060                 usleep(50000);
5061 #endif
5062         }
5063 }
5064
5065 void linphone_core_stop_waiting(LinphoneCore *lc){
5066         if (lc->wait_cb){
5067                 lc->wait_ctx=lc->wait_cb(lc,lc->wait_ctx,LinphoneWaitingFinished,NULL,0);
5068         }
5069 }
5070
5071 void linphone_core_set_rtp_transport_factories(LinphoneCore* lc, LinphoneRtpTransportFactories *factories){
5072         lc->rtptf=factories;
5073 }
5074
5075 /**
5076  * Retrieve RTP statistics regarding current call.
5077  * @param local RTP statistics computed locally.
5078  * @param remote RTP statistics computed by far end (obtained via RTCP feedback).
5079  *
5080  * @note Remote RTP statistics is not implemented yet.
5081  *
5082  * @returns 0 or -1 if no call is running.
5083 **/
5084
5085 int linphone_core_get_current_call_stats(LinphoneCore *lc, rtp_stats_t *local, rtp_stats_t *remote){
5086         LinphoneCall *call=linphone_core_get_current_call (lc);
5087         if (call!=NULL){
5088                 if (call->audiostream!=NULL){
5089                         memset(remote,0,sizeof(*remote));
5090                         audio_stream_get_local_rtp_stats (call->audiostream,local);
5091                         return 0;
5092                 }
5093         }
5094         return -1;
5095 }
5096
5097 void net_config_uninit(LinphoneCore *lc)
5098 {
5099         net_config_t *config=&lc->net_conf;
5100
5101         if (config->stun_server!=NULL){
5102                 ms_free(lc->net_conf.stun_server);
5103         }
5104         if (config->nat_address!=NULL){
5105                 lp_config_set_string(lc->config,"net","nat_address",config->nat_address);
5106                 ms_free(lc->net_conf.nat_address);
5107         }
5108         if (lc->net_conf.nat_address_ip !=NULL){
5109                 ms_free(lc->net_conf.nat_address_ip);
5110         }
5111         lp_config_set_int(lc->config,"net","mtu",config->mtu);
5112 }
5113
5114
5115 void sip_config_uninit(LinphoneCore *lc)
5116 {
5117         MSList *elem;
5118         int i;
5119         sip_config_t *config=&lc->sip_conf;
5120         
5121         lp_config_set_int(lc->config,"sip","guess_hostname",config->guess_hostname);
5122         lp_config_set_string(lc->config,"sip","contact",config->contact);
5123         lp_config_set_int(lc->config,"sip","inc_timeout",config->inc_timeout);
5124         lp_config_set_int(lc->config,"sip","in_call_timeout",config->in_call_timeout);
5125         lp_config_set_int(lc->config,"sip","delayed_timeout",config->delayed_timeout);
5126         lp_config_set_int(lc->config,"sip","use_ipv6",config->ipv6_enabled);
5127         lp_config_set_int(lc->config,"sip","register_only_when_network_is_up",config->register_only_when_network_is_up);
5128         lp_config_set_int(lc->config,"sip","register_only_when_upnp_is_ok",config->register_only_when_upnp_is_ok);
5129
5130         
5131
5132         for(elem=config->proxies,i=0;elem!=NULL;elem=ms_list_next(elem),i++){
5133                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)(elem->data);
5134                 linphone_proxy_config_edit(cfg);        /* to unregister */
5135         }
5136
5137         for (i=0;i<20;i++){
5138                 sal_iterate(lc->sal);
5139 #ifndef WIN32
5140                 usleep(100000);
5141 #else
5142                 Sleep(100);
5143 #endif
5144         }
5145
5146         ms_list_for_each(config->proxies,(void (*)(void*)) linphone_proxy_config_destroy);
5147         ms_list_free(config->proxies);
5148         config->proxies=NULL;
5149
5150         linphone_proxy_config_write_to_config_file(lc->config,NULL,i);  /*mark the end */
5151
5152         ms_list_for_each(lc->auth_info,(void (*)(void*))linphone_auth_info_destroy);
5153         ms_list_free(lc->auth_info);
5154         lc->auth_info=NULL;
5155
5156         sal_uninit(lc->sal);
5157         lc->sal=NULL;
5158
5159         if (lc->sip_conf.guessed_contact)
5160                 ms_free(lc->sip_conf.guessed_contact);
5161         if (config->contact)
5162                 ms_free(config->contact);
5163
5164 }
5165
5166 void rtp_config_uninit(LinphoneCore *lc)
5167 {
5168         rtp_config_t *config=&lc->rtp_conf;
5169         if (config->audio_rtp_min_port == config->audio_rtp_max_port) {
5170                 lp_config_set_int(lc->config, "rtp", "audio_rtp_port", config->audio_rtp_min_port);
5171         } else {
5172                 lp_config_set_range(lc->config, "rtp", "audio_rtp_port", config->audio_rtp_min_port, config->audio_rtp_max_port);
5173         }
5174         if (config->video_rtp_min_port == config->video_rtp_max_port) {
5175                 lp_config_set_int(lc->config, "rtp", "video_rtp_port", config->video_rtp_min_port);
5176         } else {
5177                 lp_config_set_range(lc->config, "rtp", "video_rtp_port", config->video_rtp_min_port, config->video_rtp_max_port);
5178         }
5179         lp_config_set_int(lc->config,"rtp","audio_jitt_comp",config->audio_jitt_comp);
5180         lp_config_set_int(lc->config,"rtp","video_jitt_comp",config->video_jitt_comp);
5181         lp_config_set_int(lc->config,"rtp","nortp_timeout",config->nortp_timeout);
5182         lp_config_set_int(lc->config,"rtp","audio_adaptive_jitt_comp_enabled",config->audio_adaptive_jitt_comp_enabled);
5183         lp_config_set_int(lc->config,"rtp","video_adaptive_jitt_comp_enabled",config->video_adaptive_jitt_comp_enabled);
5184 }
5185
5186 static void sound_config_uninit(LinphoneCore *lc)
5187 {
5188         sound_config_t *config=&lc->sound_conf;
5189         ms_free(config->cards);
5190
5191         lp_config_set_string(lc->config,"sound","remote_ring",config->remote_ring);
5192         lp_config_set_float(lc->config,"sound","playback_gain_db",config->soft_play_lev);
5193         lp_config_set_float(lc->config,"sound","mic_gain_db",config->soft_mic_lev);
5194
5195         if (config->local_ring) ms_free(config->local_ring);
5196         if (config->remote_ring) ms_free(config->remote_ring);
5197         ms_snd_card_manager_destroy();
5198 }
5199
5200 static void video_config_uninit(LinphoneCore *lc)
5201 {
5202         lp_config_set_string(lc->config,"video","size",video_size_get_name(linphone_core_get_preferred_video_size(lc)));
5203         lp_config_set_int(lc->config,"video","display",lc->video_conf.display);
5204         lp_config_set_int(lc->config,"video","capture",lc->video_conf.capture);
5205         if (lc->video_conf.cams)
5206                 ms_free(lc->video_conf.cams);
5207 }
5208
5209 void _linphone_core_codec_config_write(LinphoneCore *lc){
5210         if (linphone_core_ready(lc)){
5211                 PayloadType *pt;
5212                 codecs_config_t *config=&lc->codecs_conf;
5213                 MSList *node;
5214                 char key[50];
5215                 int index;
5216                 index=0;
5217                 for(node=config->audio_codecs;node!=NULL;node=ms_list_next(node)){
5218                         pt=(PayloadType*)(node->data);
5219                         sprintf(key,"audio_codec_%i",index);
5220                         lp_config_set_string(lc->config,key,"mime",pt->mime_type);
5221                         lp_config_set_int(lc->config,key,"rate",pt->clock_rate);
5222                         lp_config_set_int(lc->config,key,"channels",pt->channels);
5223                         lp_config_set_int(lc->config,key,"enabled",linphone_core_payload_type_enabled(lc,pt));
5224                         index++;
5225                 }
5226                 sprintf(key,"audio_codec_%i",index);
5227                 lp_config_clean_section (lc->config,key);
5228
5229                 index=0;
5230                 for(node=config->video_codecs;node!=NULL;node=ms_list_next(node)){
5231                         pt=(PayloadType*)(node->data);
5232                         sprintf(key,"video_codec_%i",index);
5233                         lp_config_set_string(lc->config,key,"mime",pt->mime_type);
5234                         lp_config_set_int(lc->config,key,"rate",pt->clock_rate);
5235                         lp_config_set_int(lc->config,key,"enabled",linphone_core_payload_type_enabled(lc,pt));
5236                         lp_config_set_string(lc->config,key,"recv_fmtp",pt->recv_fmtp);
5237                         index++;
5238                 }
5239                 sprintf(key,"video_codec_%i",index);
5240                 lp_config_clean_section (lc->config,key);
5241         }
5242 }
5243
5244 static void codecs_config_uninit(LinphoneCore *lc)
5245 {
5246         _linphone_core_codec_config_write(lc);
5247         ms_list_free(lc->codecs_conf.audio_codecs);
5248         ms_list_free(lc->codecs_conf.video_codecs);
5249 }
5250
5251 void ui_config_uninit(LinphoneCore* lc)
5252 {
5253         if (lc->friends){
5254                 ms_list_for_each(lc->friends,(void (*)(void *))linphone_friend_destroy);
5255                 ms_list_free(lc->friends);
5256                 lc->friends=NULL;
5257         }
5258 }
5259
5260 /**
5261  * Returns the LpConfig object used to manage the storage (config) file.
5262  *
5263  * @ingroup misc
5264  * The application can use the LpConfig object to insert its own private
5265  * sections and pairs of key=value in the configuration file.
5266  *
5267 **/
5268 LpConfig *linphone_core_get_config(LinphoneCore *lc){
5269         return lc->config;
5270 }
5271
5272 static void linphone_core_uninit(LinphoneCore *lc)
5273 {
5274         linphone_core_free_hooks(lc);
5275         while(lc->calls)
5276         {
5277                 LinphoneCall *the_call = lc->calls->data;
5278                 linphone_core_terminate_call(lc,the_call);
5279                 linphone_core_iterate(lc);
5280 #ifdef WIN32
5281                 Sleep(50000);
5282 #else
5283                 usleep(50000);
5284 #endif
5285         }
5286 #ifdef BUILD_UPNP
5287         if(lc->upnp != NULL) {
5288                 linphone_upnp_context_destroy(lc->upnp);
5289                 lc->upnp = NULL;
5290         }
5291 #endif //BUILD_UPNP
5292
5293         if (lc->friends)
5294                 ms_list_for_each(lc->friends,(void (*)(void *))linphone_friend_close_subscriptions);
5295         linphone_core_set_state(lc,LinphoneGlobalShutdown,"Shutting down");
5296 #ifdef VIDEO_ENABLED
5297         if (lc->previewstream!=NULL){
5298                 video_preview_stop(lc->previewstream);
5299                 lc->previewstream=NULL;
5300         }
5301 #endif
5302         ms_event_queue_destroy(lc->msevq);
5303         lc->msevq=NULL;
5304         /* save all config */
5305         net_config_uninit(lc);
5306         rtp_config_uninit(lc);
5307         if (lc->ringstream) ring_stop(lc->ringstream);
5308         sound_config_uninit(lc);
5309         video_config_uninit(lc);
5310         codecs_config_uninit(lc);
5311         ui_config_uninit(lc);
5312         sip_config_uninit(lc);
5313         if (lp_config_needs_commit(lc->config)) lp_config_sync(lc->config);
5314         lp_config_destroy(lc->config);
5315         lc->config = NULL; /* Mark the config as NULL to block further calls */
5316         sip_setup_unregister_all();
5317
5318         ms_list_for_each(lc->call_logs,(void (*)(void*))linphone_call_log_destroy);
5319         lc->call_logs=ms_list_free(lc->call_logs);
5320         
5321         ms_list_for_each(lc->last_recv_msg_ids,ms_free);
5322         lc->last_recv_msg_ids=ms_list_free(lc->last_recv_msg_ids);
5323         
5324         // Free struct variable
5325         if(lc->zrtp_secrets_cache != NULL) {
5326                 ms_free(lc->zrtp_secrets_cache);
5327         }
5328         if(lc->play_file!=NULL){
5329                 ms_free(lc->play_file);
5330         }
5331         if(lc->rec_file!=NULL){
5332                 ms_free(lc->rec_file);
5333         }
5334
5335         linphone_core_free_payload_types(lc);
5336         
5337         linphone_core_message_storage_close(lc);
5338         ortp_exit();
5339         linphone_core_set_state(lc,LinphoneGlobalOff,"Off");
5340 #ifdef TUNNEL_ENABLED
5341         if (lc->tunnel) linphone_tunnel_destroy(lc->tunnel);
5342 #endif
5343 }
5344
5345 static void set_network_reachable(LinphoneCore* lc,bool_t isReachable, time_t curtime){
5346         ms_message("Network state is now [%s]",isReachable?"UP":"DOWN");
5347         // second get the list of available proxies
5348         const MSList *elem=linphone_core_get_proxy_config_list(lc);
5349         for(;elem!=NULL;elem=elem->next){
5350                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
5351                 if (linphone_proxy_config_register_enabled(cfg) ) {
5352                         if (!isReachable) {
5353                                 linphone_proxy_config_set_state(cfg, LinphoneRegistrationNone,"Registration impossible (network down)");
5354                         }else{
5355                                 cfg->commit=TRUE;
5356                         }
5357                 }
5358         }
5359         lc->netup_time=curtime;
5360         lc->network_reachable=isReachable;
5361         
5362         if(!isReachable) {
5363                 sal_reset_transports(lc->sal);
5364         }
5365 #ifdef BUILD_UPNP
5366         if(lc->upnp == NULL) {
5367                 if(isReachable && lc->net_conf.firewall_policy == LinphonePolicyUseUpnp) {
5368                         lc->upnp = linphone_upnp_context_new(lc);       
5369                 }
5370         } else {
5371                 if(!isReachable && lc->net_conf.firewall_policy == LinphonePolicyUseUpnp) {
5372                         linphone_upnp_context_destroy(lc->upnp);
5373                         lc->upnp = NULL;
5374                 }
5375         }
5376 #endif  
5377 }
5378
5379 void linphone_core_refresh_registers(LinphoneCore* lc) {
5380         const MSList *elem;
5381         if (!lc->network_reachable) {
5382                 ms_warning("Refresh register operation not available (network unreachable)");
5383                 return;
5384         }
5385         elem=linphone_core_get_proxy_config_list(lc);
5386         for(;elem!=NULL;elem=elem->next){
5387                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
5388                 if (linphone_proxy_config_register_enabled(cfg) && linphone_proxy_config_get_expires(cfg)>0) {
5389                         linphone_proxy_config_refresh_register(cfg);
5390                 }
5391         }
5392 }
5393
5394 void __linphone_core_invalidate_registers(LinphoneCore* lc){
5395         const MSList *elem=linphone_core_get_proxy_config_list(lc);
5396         for(;elem!=NULL;elem=elem->next){
5397                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
5398                 if (linphone_proxy_config_register_enabled(cfg)) {
5399                         linphone_proxy_config_edit(cfg);
5400                         linphone_proxy_config_done(cfg);
5401                 }
5402         }
5403 }
5404
5405 void linphone_core_set_network_reachable(LinphoneCore* lc,bool_t isReachable) {
5406         //first disable automatic mode
5407         if (lc->auto_net_state_mon) {
5408                 ms_message("Disabling automatic network state monitoring");
5409                 lc->auto_net_state_mon=FALSE;
5410         }
5411         set_network_reachable(lc,isReachable, ms_time(NULL));
5412 }
5413
5414 bool_t linphone_core_is_network_reachable(LinphoneCore* lc) {
5415         return lc->network_reachable;
5416 }
5417 ortp_socket_t linphone_core_get_sip_socket(LinphoneCore *lc){
5418         return sal_get_socket(lc->sal);
5419 }
5420 /**
5421  * Destroys a LinphoneCore
5422  *
5423  * @ingroup initializing
5424 **/
5425 void linphone_core_destroy(LinphoneCore *lc){
5426         linphone_core_uninit(lc);
5427         ms_free(lc);
5428 }
5429 /**
5430  * Get the number of Call
5431  *
5432  * @ingroup call_control
5433 **/
5434 int linphone_core_get_calls_nb(const LinphoneCore *lc){
5435         return  ms_list_size(lc->calls);;
5436 }
5437
5438 /**
5439  * Check if we do not have exceed the number of simultaneous call
5440  *
5441  * @ingroup call_control
5442 **/
5443 bool_t linphone_core_can_we_add_call(LinphoneCore *lc)
5444 {
5445         if(linphone_core_get_calls_nb(lc) < lc->max_calls)
5446                 return TRUE;
5447         ms_message("Maximum amount of simultaneous calls reached !");
5448         return FALSE;
5449 }
5450
5451
5452 int linphone_core_add_call( LinphoneCore *lc, LinphoneCall *call)
5453 {
5454         if(linphone_core_can_we_add_call(lc))
5455         {
5456                 lc->calls = ms_list_append(lc->calls,call);
5457                 return 0;
5458         }
5459         return -1;
5460 }
5461
5462 int linphone_core_del_call( LinphoneCore *lc, LinphoneCall *call)
5463 {
5464         MSList *it;
5465         MSList *the_calls = lc->calls;
5466
5467         it=ms_list_find(the_calls,call);
5468         if (it)
5469         {
5470                 the_calls = ms_list_remove_link(the_calls,it);
5471         }
5472         else
5473         {
5474                 ms_warning("could not find the call into the list\n");
5475                 return -1;
5476         }
5477         lc->calls = the_calls;
5478         return 0;
5479 }
5480
5481 /**
5482  * Specifiies a ring back tone to be played to far end during incoming calls.
5483 **/
5484 void linphone_core_set_remote_ringback_tone(LinphoneCore *lc, const char *file){
5485         if (lc->sound_conf.ringback_tone){
5486                 ms_free(lc->sound_conf.ringback_tone);
5487                 lc->sound_conf.ringback_tone=NULL;
5488         }
5489         if (file)
5490                 lc->sound_conf.ringback_tone=ms_strdup(file);
5491 }
5492
5493 /**
5494  * Returns the ring back tone played to far end during incoming calls.
5495 **/
5496 const char *linphone_core_get_remote_ringback_tone(const LinphoneCore *lc){
5497         return lc->sound_conf.ringback_tone;
5498 }
5499
5500 static PayloadType* find_payload_type_from_list(const char* type, int rate, int channels, const MSList* from) {
5501         const MSList *elem;
5502         for(elem=from;elem!=NULL;elem=elem->next){
5503                 PayloadType *pt=(PayloadType*)elem->data;
5504                 if ((strcasecmp((char*)type, payload_type_get_mime(pt)) == 0)
5505                         && (rate == LINPHONE_FIND_PAYLOAD_IGNORE_RATE || rate==pt->clock_rate)
5506                         && (channels == LINPHONE_FIND_PAYLOAD_IGNORE_CHANNELS || channels==pt->channels)) {
5507                         return pt;
5508                 }
5509         }
5510         return NULL;
5511 }
5512
5513
5514 PayloadType* linphone_core_find_payload_type(LinphoneCore* lc, const char* type, int rate, int channels) {
5515         PayloadType* result = find_payload_type_from_list(type, rate, channels, linphone_core_get_audio_codecs(lc));
5516         if (result)  {
5517                 return result;
5518         } else {
5519                 result = find_payload_type_from_list(type, rate, 0, linphone_core_get_video_codecs(lc));
5520                 if (result) {
5521                         return result;
5522                 }
5523         }
5524         /*not found*/
5525         return NULL;
5526 }
5527
5528 const char *linphone_global_state_to_string(LinphoneGlobalState gs){
5529         switch(gs){
5530                 case LinphoneGlobalOff:
5531                         return "LinphoneGlobalOff";
5532                 break;
5533                 case LinphoneGlobalOn:
5534                         return "LinphoneGlobalOn";
5535                 break;
5536                 case LinphoneGlobalStartup:
5537                         return "LinphoneGlobalStartup";
5538                 break;
5539                 case LinphoneGlobalShutdown:
5540                         return "LinphoneGlobalShutdown";
5541                 break;
5542         }
5543         return NULL;
5544 }
5545
5546 LinphoneGlobalState linphone_core_get_global_state(const LinphoneCore *lc){
5547         return lc->state;
5548 }
5549
5550 LinphoneCallParams *linphone_core_create_default_call_parameters(LinphoneCore *lc){
5551         LinphoneCallParams *p=ms_new0(LinphoneCallParams,1);
5552         linphone_core_init_default_params(lc, p);
5553         return p;
5554 }
5555
5556 const char *linphone_reason_to_string(LinphoneReason err){
5557         switch(err){
5558                 case LinphoneReasonNone:
5559                         return "No error";
5560                 case LinphoneReasonNoResponse:
5561                         return "No response";
5562                 case LinphoneReasonBadCredentials:
5563                         return "Bad credentials";
5564                 case LinphoneReasonDeclined:
5565                         return "Call declined";
5566                 case LinphoneReasonNotFound:
5567                         return "User not found";
5568                 case LinphoneReasonNotAnswered:
5569                         return "Not answered";
5570                 case LinphoneReasonBusy:
5571                         return "Busy";
5572         }
5573         return "unknown error";
5574 }
5575
5576 const char *linphone_error_to_string(LinphoneReason err){
5577         return linphone_reason_to_string(err);
5578 }
5579 /**
5580  * Enables signaling keep alive
5581  */
5582 void linphone_core_enable_keep_alive(LinphoneCore* lc,bool_t enable) {
5583 #ifdef BUILD_UPNP
5584         if (linphone_core_get_firewall_policy(lc)==LinphonePolicyUseUpnp) {
5585                 enable = FALSE;
5586         }
5587 #endif //BUILD_UPNP
5588         if (enable > 0) {
5589                 sal_use_tcp_tls_keepalive(lc->sal,lc->sip_conf.tcp_tls_keepalive);
5590                 sal_set_keepalive_period(lc->sal,lc->sip_conf.keepalive_period);
5591         } else {
5592                 sal_set_keepalive_period(lc->sal,0);
5593         }
5594 }
5595 /**
5596  * Is signaling keep alive enabled
5597  */
5598 bool_t linphone_core_keep_alive_enabled(LinphoneCore* lc) {
5599         return sal_get_keepalive_period(lc->sal) > 0;
5600 }
5601
5602 void linphone_core_start_dtmf_stream(LinphoneCore* lc) {
5603         get_dtmf_gen(lc); /*make sure ring stream is started*/
5604         lc->ringstream_autorelease=FALSE; /*disable autorelease mode*/
5605 }
5606
5607 void linphone_core_stop_dtmf_stream(LinphoneCore* lc) {
5608         if (lc->ringstream && lc->dmfs_playing_start_time!=0) {
5609                 ring_stop(lc->ringstream);
5610                 lc->ringstream=NULL;
5611         }
5612 }
5613
5614 int linphone_core_get_max_calls(LinphoneCore *lc) {
5615         return lc->max_calls;
5616 }
5617 void linphone_core_set_max_calls(LinphoneCore *lc, int max) {
5618         lc->max_calls=max;
5619 }
5620
5621 typedef struct Hook{
5622         LinphoneCoreIterateHook fun;
5623         void *data;
5624 }Hook;
5625
5626 static Hook *hook_new(LinphoneCoreIterateHook hook, void *hook_data){
5627         Hook *h=ms_new(Hook,1);
5628         h->fun=hook;
5629         h->data=hook_data;
5630         return h;
5631 }
5632
5633 static void hook_invoke(Hook *h){
5634         h->fun(h->data);
5635 }
5636
5637 void linphone_core_add_iterate_hook(LinphoneCore *lc, LinphoneCoreIterateHook hook, void *hook_data){
5638         lc->hooks=ms_list_append(lc->hooks,hook_new(hook,hook_data));
5639 }
5640
5641 static void linphone_core_run_hooks(LinphoneCore *lc){
5642         ms_list_for_each(lc->hooks,(void (*)(void*))hook_invoke);
5643 }
5644
5645 static void linphone_core_free_hooks(LinphoneCore *lc){
5646         ms_list_for_each(lc->hooks,(void (*)(void*))ms_free);
5647         ms_list_free(lc->hooks);
5648         lc->hooks=NULL;
5649 }
5650
5651 void linphone_core_remove_iterate_hook(LinphoneCore *lc, LinphoneCoreIterateHook hook, void *hook_data){
5652         MSList *elem;
5653         for(elem=lc->hooks;elem!=NULL;elem=elem->next){
5654                 Hook *h=(Hook*)elem->data;
5655                 if (h->fun==hook && h->data==hook_data){
5656                         lc->hooks = ms_list_remove_link(lc->hooks,elem);
5657                         ms_free(h);
5658                         return;
5659                 }
5660         }
5661         ms_error("linphone_core_remove_iterate_hook(): No such hook found.");
5662 }
5663
5664 void linphone_core_set_zrtp_secrets_file(LinphoneCore *lc, const char* file){
5665         if (lc->zrtp_secrets_cache != NULL) {
5666                 ms_free(lc->zrtp_secrets_cache);
5667         }
5668         lc->zrtp_secrets_cache=file ? ms_strdup(file) : NULL;
5669 }
5670
5671 const char *linphone_core_get_zrtp_secrets_file(LinphoneCore *lc){
5672         return lc->zrtp_secrets_cache;
5673 }
5674
5675 const LinphoneCall* linphone_core_find_call_from_uri(LinphoneCore *lc, const char *uri) {
5676         if (uri == NULL) return NULL;
5677         MSList *calls=lc->calls;
5678         while(calls) {
5679                 const LinphoneCall *c=(LinphoneCall*)calls->data;
5680                 calls=calls->next;
5681                 const LinphoneAddress *address = linphone_call_get_remote_address(c);
5682                 char *current_uri=linphone_address_as_string_uri_only(address);
5683                 if (strcmp(uri,current_uri)==0) {
5684                         ms_free(current_uri);
5685                         return c;
5686                 } else {
5687                         ms_free(current_uri);
5688                 }
5689         }
5690         return NULL;
5691 }
5692
5693
5694 /**
5695  * Check if a call will need the sound resources.
5696  *
5697  * @ingroup call_control
5698  * @param lc The LinphoneCore
5699 **/
5700 bool_t linphone_core_sound_resources_locked(LinphoneCore *lc){
5701         MSList *calls=lc->calls;
5702         while(calls) {
5703                 LinphoneCall *c=(LinphoneCall*)calls->data;
5704                 calls=calls->next;
5705                 switch (c->state) {
5706                         case LinphoneCallOutgoingInit:
5707                         case LinphoneCallOutgoingProgress:
5708                         case LinphoneCallOutgoingRinging:
5709                         case LinphoneCallOutgoingEarlyMedia:
5710                         case LinphoneCallConnected:
5711                         case LinphoneCallRefered:
5712                         case LinphoneCallIncomingEarlyMedia:
5713                         case LinphoneCallUpdating:
5714                                 return TRUE;
5715                         default:
5716                                 break;
5717                 }
5718         }
5719         return FALSE;
5720 }
5721
5722 void linphone_core_set_srtp_enabled(LinphoneCore *lc, bool_t enabled) {
5723         lp_config_set_int(lc->config,"sip","srtp",(int)enabled);
5724 }
5725
5726 /**
5727  * Returns whether a media encryption scheme is supported by the LinphoneCore engine
5728 **/
5729 bool_t linphone_core_media_encryption_supported(const LinphoneCore *lc, LinphoneMediaEncryption menc){
5730         switch(menc){
5731                 case LinphoneMediaEncryptionSRTP:
5732                         return ortp_srtp_supported();
5733                 case LinphoneMediaEncryptionZRTP:
5734                         return ortp_zrtp_available();
5735                 case LinphoneMediaEncryptionNone:
5736                         return TRUE;
5737         }
5738         return FALSE;
5739 }
5740
5741 int linphone_core_set_media_encryption(LinphoneCore *lc, enum LinphoneMediaEncryption menc) {
5742         const char *type="none";
5743         int ret=0;
5744         if (menc == LinphoneMediaEncryptionSRTP){
5745                 if (!ortp_srtp_supported()){
5746                         ms_warning("SRTP not supported by library.");
5747                         type="none";
5748                         ret=-1;
5749                 }else type="srtp";
5750         }else if (menc == LinphoneMediaEncryptionZRTP){
5751                 if (!ortp_zrtp_available()){
5752                         ms_warning("ZRTP not supported by library.");
5753                         type="none";
5754                         ret=-1;
5755                 }else type="zrtp";
5756         }
5757         lp_config_set_string(lc->config,"sip","media_encryption",type);
5758         return ret;
5759 }
5760
5761 LinphoneMediaEncryption linphone_core_get_media_encryption(LinphoneCore *lc) {
5762         const char* menc = lp_config_get_string(lc->config, "sip", "media_encryption", NULL);
5763         
5764         if (menc == NULL)
5765                 return LinphoneMediaEncryptionNone;
5766         else if (strcmp(menc, "srtp")==0)
5767                 return LinphoneMediaEncryptionSRTP;
5768         else if (strcmp(menc, "zrtp")==0)
5769                 return LinphoneMediaEncryptionZRTP;
5770         else
5771                 return LinphoneMediaEncryptionNone;
5772 }
5773
5774 bool_t linphone_core_is_media_encryption_mandatory(LinphoneCore *lc) {
5775         return (bool_t)lp_config_get_int(lc->config, "sip", "media_encryption_mandatory", 0);
5776 }
5777
5778 void linphone_core_set_media_encryption_mandatory(LinphoneCore *lc, bool_t m) {
5779         lp_config_set_int(lc->config, "sip", "media_encryption_mandatory", (int)m);
5780 }
5781
5782 void linphone_core_init_default_params(LinphoneCore*lc, LinphoneCallParams *params) {
5783         params->has_video=linphone_core_video_enabled(lc) && lc->video_policy.automatically_initiate;
5784         params->media_encryption=linphone_core_get_media_encryption(lc);
5785         params->in_conference=FALSE;
5786 }
5787
5788 void linphone_core_set_device_identifier(LinphoneCore *lc,const char* device_id) {
5789         if (lc->device_id) ms_free(lc->device_id);
5790         lc->device_id=ms_strdup(device_id);
5791 }
5792 const char*  linphone_core_get_device_identifier(const LinphoneCore *lc) {
5793         return lc->device_id;
5794 }
5795
5796 /**
5797  * Set the DSCP field for SIP signaling channel.
5798  * 
5799  * @ingroup network_parameters
5800  * * The DSCP defines the quality of service in IP packets.
5801  * 
5802 **/
5803 void linphone_core_set_sip_dscp(LinphoneCore *lc, int dscp){
5804         sal_set_dscp(lc->sal,dscp);
5805         if (linphone_core_ready(lc)){
5806                 lp_config_set_int_hex(lc->config,"sip","dscp",dscp);
5807                 apply_transports(lc);
5808         }
5809 }
5810
5811 /**
5812  * Get the DSCP field for SIP signaling channel.
5813  * 
5814  * @ingroup network_parameters
5815  * * The DSCP defines the quality of service in IP packets.
5816  * 
5817 **/
5818 int linphone_core_get_sip_dscp(const LinphoneCore *lc){
5819         return lp_config_get_int(lc->config,"sip","dscp",0x1a);
5820 }
5821
5822 /**
5823  * Set the DSCP field for outgoing audio streams.
5824  *
5825  * @ingroup network_parameters
5826  * The DSCP defines the quality of service in IP packets.
5827  * 
5828 **/
5829 void linphone_core_set_audio_dscp(LinphoneCore *lc, int dscp){
5830         if (linphone_core_ready(lc))
5831                 lp_config_set_int_hex(lc->config,"rtp","audio_dscp",dscp);
5832 }
5833
5834 /**
5835  * Get the DSCP field for outgoing audio streams.
5836  *
5837  * @ingroup network_parameters
5838  * The DSCP defines the quality of service in IP packets.
5839  * 
5840 **/
5841 int linphone_core_get_audio_dscp(const LinphoneCore *lc){
5842         return lp_config_get_int(lc->config,"rtp","audio_dscp",0x2e);
5843 }
5844
5845 /**
5846  * Set the DSCP field for outgoing video streams.
5847  *
5848  * @ingroup network_parameters
5849  * The DSCP defines the quality of service in IP packets.
5850  * 
5851 **/
5852 void linphone_core_set_video_dscp(LinphoneCore *lc, int dscp){
5853         if (linphone_core_ready(lc))
5854                 lp_config_set_int_hex(lc->config,"rtp","video_dscp",dscp);
5855         
5856 }
5857
5858 /**
5859  * Get the DSCP field for outgoing video streams.
5860  *
5861  * @ingroup network_parameters
5862  * The DSCP defines the quality of service in IP packets.
5863  * 
5864 **/
5865 int linphone_core_get_video_dscp(const LinphoneCore *lc){
5866         return lp_config_get_int(lc->config,"rtp","video_dscp",0x2e);
5867 }
5868
5869
5870 /**
5871  * Sets the database filename where chat messages will be stored.
5872  * If the file does not exist, it will be created.
5873  * @ingroup initializing
5874  * @param lc the linphone core
5875  * @param path filesystem path
5876 **/
5877 void linphone_core_set_chat_database_path(LinphoneCore *lc, const char *path){
5878         if (lc->chat_db_file){
5879                 ms_free(lc->chat_db_file);
5880                 lc->chat_db_file=NULL;
5881         }
5882         if (path) {
5883                 lc->chat_db_file=ms_strdup(path);
5884                 linphone_core_message_storage_init(lc);
5885         }
5886 }
5887
5888