]> sjero.net Git - linphone/blob - coreapi/linphonecore.c
Add fmtp parameters to opus payload to enable FEC and DTX
[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 static MSVideoSizeDef supported_resolutions[]={
4748 #ifdef ENABLE_HD
4749         {       {MS_VIDEO_SIZE_1080P_W,MS_VIDEO_SIZE_1080P_H}   ,       "1080p" },
4750         {       {MS_VIDEO_SIZE_720P_W,MS_VIDEO_SIZE_720P_H}     ,       "1080p" },
4751 #endif
4752         {       {MS_VIDEO_SIZE_SVGA_W,MS_VIDEO_SIZE_SVGA_H}     ,       "svga"  },
4753         {       {MS_VIDEO_SIZE_4CIF_W,MS_VIDEO_SIZE_4CIF_H}     ,       "4cif"  },
4754         {       {MS_VIDEO_SIZE_VGA_W,MS_VIDEO_SIZE_VGA_H}       ,       "vga"   },
4755         {       {MS_VIDEO_SIZE_IOS_MEDIUM_H,MS_VIDEO_SIZE_IOS_MEDIUM_W} ,       "ios-medium"    },
4756         {       {MS_VIDEO_SIZE_CIF_W,MS_VIDEO_SIZE_CIF_H}       ,       "cif"   },
4757         {       {MS_VIDEO_SIZE_QVGA_W,MS_VIDEO_SIZE_QVGA_H}     ,       "qvga"  },
4758         {       {MS_VIDEO_SIZE_QCIF_W,MS_VIDEO_SIZE_QCIF_H}     ,       "qcif"  },      
4759         {       {0,0}                   ,       NULL    }
4760 };
4761
4762 /**
4763  * Returns the zero terminated table of supported video resolutions.
4764  *
4765  * @ingroup media_parameters
4766 **/
4767 const MSVideoSizeDef *linphone_core_get_supported_video_sizes(LinphoneCore *lc){
4768         return supported_resolutions;
4769 }
4770
4771 static MSVideoSize video_size_get_by_name(const char *name){
4772         MSVideoSizeDef *pdef=supported_resolutions;
4773         MSVideoSize null_vsize={0,0};
4774         for(;pdef->name!=NULL;pdef++){
4775                 if (strcasecmp(name,pdef->name)==0){
4776                         return pdef->vsize;
4777                 }
4778         }
4779         ms_warning("Video resolution %s is not supported in linphone.",name);
4780         return null_vsize;
4781 }
4782
4783 static const char *video_size_get_name(MSVideoSize vsize){
4784         MSVideoSizeDef *pdef=supported_resolutions;
4785         for(;pdef->name!=NULL;pdef++){
4786                 if (pdef->vsize.width==vsize.width && pdef->vsize.height==vsize.height){
4787                         return pdef->name;
4788                 }
4789         }
4790         return NULL;
4791 }
4792
4793 static bool_t video_size_supported(MSVideoSize vsize){
4794         if (video_size_get_name(vsize)) return TRUE;
4795         ms_warning("Video resolution %ix%i is not supported in linphone.",vsize.width,vsize.height);
4796         return FALSE;
4797 }
4798
4799 /**
4800  * Sets the preferred video size.
4801  *
4802  * @ingroup media_parameters
4803  * This applies only to the stream that is captured and sent to the remote party,
4804  * since we accept all standard video size on the receive path.
4805 **/
4806 void linphone_core_set_preferred_video_size(LinphoneCore *lc, MSVideoSize vsize){
4807         if (video_size_supported(vsize)){
4808                 MSVideoSize oldvsize=lc->video_conf.vsize;
4809                 lc->video_conf.vsize=vsize;
4810                 if (!ms_video_size_equal(oldvsize,vsize) && lc->previewstream!=NULL){
4811                         toggle_video_preview(lc,FALSE);
4812                         toggle_video_preview(lc,TRUE);
4813                 }
4814                 if ( linphone_core_ready(lc))
4815                         lp_config_set_string(lc->config,"video","size",video_size_get_name(vsize));
4816         }
4817 }
4818
4819 /**
4820  * Sets the preferred video size by its name.
4821  *
4822  * @ingroup media_parameters
4823  * This is identical to linphone_core_set_preferred_video_size() except
4824  * that it takes the name of the video resolution as input.
4825  * Video resolution names are: qcif, svga, cif, vga, 4cif, svga ...
4826 **/
4827 void linphone_core_set_preferred_video_size_by_name(LinphoneCore *lc, const char *name){
4828         MSVideoSize vsize=video_size_get_by_name(name);
4829         MSVideoSize default_vsize={MS_VIDEO_SIZE_CIF_W,MS_VIDEO_SIZE_CIF_H};
4830         if (vsize.width!=0)     linphone_core_set_preferred_video_size(lc,vsize);
4831         else linphone_core_set_preferred_video_size(lc,default_vsize);
4832 }
4833
4834 /**
4835  * Returns the current preferred video size for sending.
4836  *
4837  * @ingroup media_parameters
4838 **/
4839 MSVideoSize linphone_core_get_preferred_video_size(LinphoneCore *lc){
4840         return lc->video_conf.vsize;
4841 }
4842
4843 /**
4844  * Ask the core to stream audio from and to files, instead of using the soundcard.
4845 **/
4846 void linphone_core_use_files(LinphoneCore *lc, bool_t yesno){
4847         lc->use_files=yesno;
4848 }
4849
4850 /**
4851  * Sets a wav file to be played when putting somebody on hold,
4852  * or when files are used instead of soundcards (see linphone_core_use_files()).
4853  *
4854  * The file must be a 16 bit linear wav file.
4855 **/
4856 void linphone_core_set_play_file(LinphoneCore *lc, const char *file){
4857         LinphoneCall *call=linphone_core_get_current_call(lc);
4858         if (lc->play_file!=NULL){
4859                 ms_free(lc->play_file);
4860                 lc->play_file=NULL;
4861         }
4862         if (file!=NULL) {
4863                 lc->play_file=ms_strdup(file);
4864                 if (call && call->audiostream && call->audiostream->ms.ticker)
4865                         audio_stream_play(call->audiostream,file);
4866         }
4867 }
4868
4869
4870 /**
4871  * Sets a wav file where incoming stream is to be recorded,
4872  * when files are used instead of soundcards (see linphone_core_use_files()).
4873  *
4874  * This feature is different from call recording (linphone_call_params_set_record_file())
4875  * The file will be a 16 bit linear wav file.
4876 **/
4877 void linphone_core_set_record_file(LinphoneCore *lc, const char *file){
4878         LinphoneCall *call=linphone_core_get_current_call(lc);
4879         if (lc->rec_file!=NULL){
4880                 ms_free(lc->rec_file);
4881                 lc->rec_file=NULL;
4882         }
4883         if (file!=NULL) {
4884                 lc->rec_file=ms_strdup(file);
4885                 if (call && call->audiostream)
4886                         audio_stream_record(call->audiostream,file);
4887         }
4888 }
4889
4890
4891 static MSFilter *get_dtmf_gen(LinphoneCore *lc){
4892         LinphoneCall *call=linphone_core_get_current_call (lc);
4893         AudioStream *stream=NULL;
4894         if (call){
4895                 stream=call->audiostream;
4896         }else if (linphone_core_is_in_conference(lc)){
4897                 stream=lc->conf_ctx.local_participant;
4898         }
4899         if (stream){
4900                 return stream->dtmfgen;
4901         }
4902         if (lc->ringstream==NULL){
4903                 float amp=lp_config_get_float(lc->config,"sound","dtmf_player_amp",0.1);
4904                 MSSndCard *ringcard=lc->sound_conf.lsd_card ?lc->sound_conf.lsd_card : lc->sound_conf.ring_sndcard;
4905                 if (ringcard == NULL)
4906                         return NULL;
4907
4908                 lc->ringstream=ring_start(NULL,0,ringcard);
4909                 ms_filter_call_method(lc->ringstream->gendtmf,MS_DTMF_GEN_SET_DEFAULT_AMPLITUDE,&amp);
4910                 lc->dmfs_playing_start_time=time(NULL);
4911         }else{
4912                 if (lc->dmfs_playing_start_time!=0)
4913                         lc->dmfs_playing_start_time=time(NULL);
4914         }
4915         return lc->ringstream->gendtmf;
4916 }
4917
4918 /**
4919  * @ingroup media_parameters
4920  * Plays a dtmf sound to the local user.
4921  * @param lc #LinphoneCore
4922  * @param dtmf DTMF to play ['0'..'16'] | '#' | '#'
4923  * @param duration_ms duration in ms, -1 means play until next further call to #linphone_core_stop_dtmf()
4924 **/
4925 void linphone_core_play_dtmf(LinphoneCore *lc, char dtmf, int duration_ms){
4926         MSFilter *f=get_dtmf_gen(lc);
4927         if (f==NULL){
4928                 ms_error("No dtmf generator at this time !");
4929                 return;
4930         }
4931
4932         if (duration_ms>0)
4933                 ms_filter_call_method(f, MS_DTMF_GEN_PLAY, &dtmf);
4934         else ms_filter_call_method(f, MS_DTMF_GEN_START, &dtmf);
4935 }
4936
4937 void linphone_core_play_named_tone(LinphoneCore *lc, LinphoneToneID toneid){
4938         if (linphone_core_tone_indications_enabled(lc)){
4939                 MSFilter *f=get_dtmf_gen(lc);
4940                 MSDtmfGenCustomTone def;
4941                 if (f==NULL){
4942                         ms_error("No dtmf generator at this time !");
4943                         return;
4944                 }
4945                 memset(&def,0,sizeof(def));
4946                 def.amplitude=1;
4947                 /*these are french tones, excepted the failed one, which is USA congestion tone (does not exist in France)*/
4948                 switch(toneid){
4949                         case LinphoneToneCallOnHold:
4950                         case LinphoneToneCallWaiting:
4951                                 def.duration=300;
4952                                 def.frequencies[0]=440;
4953                                 def.interval=2000;
4954                         break;
4955                         case LinphoneToneBusy:
4956                                 def.duration=500;
4957                                 def.frequencies[0]=440;
4958                                 def.interval=500;
4959                                 def.repeat_count=3;
4960                         break;
4961                         case LinphoneToneCallFailed:
4962                                 def.duration=250;
4963                                 def.frequencies[0]=480;
4964                                 def.frequencies[0]=620;
4965                                 def.interval=250;
4966                                 def.repeat_count=3;
4967                                 
4968                         break;
4969                         default:
4970                                 ms_warning("Unhandled tone id.");
4971                 }
4972                 if (def.duration>0)
4973                         ms_filter_call_method(f, MS_DTMF_GEN_PLAY_CUSTOM,&def);
4974         }
4975 }
4976
4977 /**
4978  * @ingroup media_parameters
4979  *
4980  * Stops playing a dtmf started by linphone_core_play_dtmf().
4981 **/
4982 void linphone_core_stop_dtmf(LinphoneCore *lc){
4983         MSFilter *f=get_dtmf_gen(lc);
4984         if (f!=NULL)
4985                 ms_filter_call_method_noarg (f, MS_DTMF_GEN_STOP);
4986 }
4987
4988
4989
4990 /**
4991  * Retrieves the user pointer that was given to linphone_core_new()
4992  *
4993  * @ingroup initializing
4994 **/
4995 void *linphone_core_get_user_data(LinphoneCore *lc){
4996         return lc->data;
4997 }
4998
4999
5000 /**
5001  * Associate a user pointer to the linphone core.
5002  *
5003  * @ingroup initializing
5004 **/
5005 void linphone_core_set_user_data(LinphoneCore *lc, void *userdata){
5006         lc->data=userdata;
5007 }
5008
5009 int linphone_core_get_mtu(const LinphoneCore *lc){
5010         return lc->net_conf.mtu;
5011 }
5012
5013 /**
5014  * Sets the maximum transmission unit size in bytes.
5015  * This information is useful for sending RTP packets.
5016  * Default value is 1500.
5017  * 
5018  * @ingroup media_parameters
5019 **/
5020 void linphone_core_set_mtu(LinphoneCore *lc, int mtu){
5021         lc->net_conf.mtu=mtu;
5022         if (mtu>0){
5023                 if (mtu<500){
5024                         ms_error("MTU too small !");
5025                         mtu=500;
5026                 }
5027                 ms_set_mtu(mtu);
5028                 ms_message("MTU is supposed to be %i, rtp payload max size will be %i",mtu, ms_get_payload_max_size());
5029         }else ms_set_mtu(0);//use mediastreamer2 default value
5030 }
5031
5032 void linphone_core_set_waiting_callback(LinphoneCore *lc, LinphoneWaitingCallback cb, void *user_context){
5033         lc->wait_cb=cb;
5034         lc->wait_ctx=user_context;
5035 }
5036
5037 void linphone_core_start_waiting(LinphoneCore *lc, const char *purpose){
5038         if (lc->wait_cb){
5039                 lc->wait_ctx=lc->wait_cb(lc,lc->wait_ctx,LinphoneWaitingStart,purpose,0);
5040         }
5041 }
5042
5043 void linphone_core_update_progress(LinphoneCore *lc, const char *purpose, float progress){
5044         if (lc->wait_cb){
5045                 lc->wait_ctx=lc->wait_cb(lc,lc->wait_ctx,LinphoneWaitingProgress,purpose,progress);
5046         }else{
5047 #ifdef WIN32
5048                 Sleep(50000);
5049 #else
5050                 usleep(50000);
5051 #endif
5052         }
5053 }
5054
5055 void linphone_core_stop_waiting(LinphoneCore *lc){
5056         if (lc->wait_cb){
5057                 lc->wait_ctx=lc->wait_cb(lc,lc->wait_ctx,LinphoneWaitingFinished,NULL,0);
5058         }
5059 }
5060
5061 void linphone_core_set_rtp_transport_factories(LinphoneCore* lc, LinphoneRtpTransportFactories *factories){
5062         lc->rtptf=factories;
5063 }
5064
5065 /**
5066  * Retrieve RTP statistics regarding current call.
5067  * @param local RTP statistics computed locally.
5068  * @param remote RTP statistics computed by far end (obtained via RTCP feedback).
5069  *
5070  * @note Remote RTP statistics is not implemented yet.
5071  *
5072  * @returns 0 or -1 if no call is running.
5073 **/
5074
5075 int linphone_core_get_current_call_stats(LinphoneCore *lc, rtp_stats_t *local, rtp_stats_t *remote){
5076         LinphoneCall *call=linphone_core_get_current_call (lc);
5077         if (call!=NULL){
5078                 if (call->audiostream!=NULL){
5079                         memset(remote,0,sizeof(*remote));
5080                         audio_stream_get_local_rtp_stats (call->audiostream,local);
5081                         return 0;
5082                 }
5083         }
5084         return -1;
5085 }
5086
5087 void net_config_uninit(LinphoneCore *lc)
5088 {
5089         net_config_t *config=&lc->net_conf;
5090
5091         if (config->stun_server!=NULL){
5092                 ms_free(lc->net_conf.stun_server);
5093         }
5094         if (config->nat_address!=NULL){
5095                 lp_config_set_string(lc->config,"net","nat_address",config->nat_address);
5096                 ms_free(lc->net_conf.nat_address);
5097         }
5098         if (lc->net_conf.nat_address_ip !=NULL){
5099                 ms_free(lc->net_conf.nat_address_ip);
5100         }
5101         lp_config_set_int(lc->config,"net","mtu",config->mtu);
5102 }
5103
5104
5105 void sip_config_uninit(LinphoneCore *lc)
5106 {
5107         MSList *elem;
5108         int i;
5109         sip_config_t *config=&lc->sip_conf;
5110         
5111         lp_config_set_int(lc->config,"sip","guess_hostname",config->guess_hostname);
5112         lp_config_set_string(lc->config,"sip","contact",config->contact);
5113         lp_config_set_int(lc->config,"sip","inc_timeout",config->inc_timeout);
5114         lp_config_set_int(lc->config,"sip","in_call_timeout",config->in_call_timeout);
5115         lp_config_set_int(lc->config,"sip","delayed_timeout",config->delayed_timeout);
5116         lp_config_set_int(lc->config,"sip","use_ipv6",config->ipv6_enabled);
5117         lp_config_set_int(lc->config,"sip","register_only_when_network_is_up",config->register_only_when_network_is_up);
5118         lp_config_set_int(lc->config,"sip","register_only_when_upnp_is_ok",config->register_only_when_upnp_is_ok);
5119
5120         
5121
5122         for(elem=config->proxies,i=0;elem!=NULL;elem=ms_list_next(elem),i++){
5123                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)(elem->data);
5124                 linphone_proxy_config_edit(cfg);        /* to unregister */
5125         }
5126
5127         for (i=0;i<20;i++){
5128                 sal_iterate(lc->sal);
5129 #ifndef WIN32
5130                 usleep(100000);
5131 #else
5132                 Sleep(100);
5133 #endif
5134         }
5135
5136         ms_list_for_each(config->proxies,(void (*)(void*)) linphone_proxy_config_destroy);
5137         ms_list_free(config->proxies);
5138         config->proxies=NULL;
5139
5140         linphone_proxy_config_write_to_config_file(lc->config,NULL,i);  /*mark the end */
5141
5142         ms_list_for_each(lc->auth_info,(void (*)(void*))linphone_auth_info_destroy);
5143         ms_list_free(lc->auth_info);
5144         lc->auth_info=NULL;
5145
5146         sal_uninit(lc->sal);
5147         lc->sal=NULL;
5148
5149         if (lc->sip_conf.guessed_contact)
5150                 ms_free(lc->sip_conf.guessed_contact);
5151         if (config->contact)
5152                 ms_free(config->contact);
5153
5154 }
5155
5156 void rtp_config_uninit(LinphoneCore *lc)
5157 {
5158         rtp_config_t *config=&lc->rtp_conf;
5159         if (config->audio_rtp_min_port == config->audio_rtp_max_port) {
5160                 lp_config_set_int(lc->config, "rtp", "audio_rtp_port", config->audio_rtp_min_port);
5161         } else {
5162                 lp_config_set_range(lc->config, "rtp", "audio_rtp_port", config->audio_rtp_min_port, config->audio_rtp_max_port);
5163         }
5164         if (config->video_rtp_min_port == config->video_rtp_max_port) {
5165                 lp_config_set_int(lc->config, "rtp", "video_rtp_port", config->video_rtp_min_port);
5166         } else {
5167                 lp_config_set_range(lc->config, "rtp", "video_rtp_port", config->video_rtp_min_port, config->video_rtp_max_port);
5168         }
5169         lp_config_set_int(lc->config,"rtp","audio_jitt_comp",config->audio_jitt_comp);
5170         lp_config_set_int(lc->config,"rtp","video_jitt_comp",config->video_jitt_comp);
5171         lp_config_set_int(lc->config,"rtp","nortp_timeout",config->nortp_timeout);
5172         lp_config_set_int(lc->config,"rtp","audio_adaptive_jitt_comp_enabled",config->audio_adaptive_jitt_comp_enabled);
5173         lp_config_set_int(lc->config,"rtp","video_adaptive_jitt_comp_enabled",config->video_adaptive_jitt_comp_enabled);
5174 }
5175
5176 static void sound_config_uninit(LinphoneCore *lc)
5177 {
5178         sound_config_t *config=&lc->sound_conf;
5179         ms_free(config->cards);
5180
5181         lp_config_set_string(lc->config,"sound","remote_ring",config->remote_ring);
5182         lp_config_set_float(lc->config,"sound","playback_gain_db",config->soft_play_lev);
5183         lp_config_set_float(lc->config,"sound","mic_gain_db",config->soft_mic_lev);
5184
5185         if (config->local_ring) ms_free(config->local_ring);
5186         if (config->remote_ring) ms_free(config->remote_ring);
5187         ms_snd_card_manager_destroy();
5188 }
5189
5190 static void video_config_uninit(LinphoneCore *lc)
5191 {
5192         lp_config_set_string(lc->config,"video","size",video_size_get_name(linphone_core_get_preferred_video_size(lc)));
5193         lp_config_set_int(lc->config,"video","display",lc->video_conf.display);
5194         lp_config_set_int(lc->config,"video","capture",lc->video_conf.capture);
5195         if (lc->video_conf.cams)
5196                 ms_free(lc->video_conf.cams);
5197 }
5198
5199 void _linphone_core_codec_config_write(LinphoneCore *lc){
5200         if (linphone_core_ready(lc)){
5201                 PayloadType *pt;
5202                 codecs_config_t *config=&lc->codecs_conf;
5203                 MSList *node;
5204                 char key[50];
5205                 int index;
5206                 index=0;
5207                 for(node=config->audio_codecs;node!=NULL;node=ms_list_next(node)){
5208                         pt=(PayloadType*)(node->data);
5209                         sprintf(key,"audio_codec_%i",index);
5210                         lp_config_set_string(lc->config,key,"mime",pt->mime_type);
5211                         lp_config_set_int(lc->config,key,"rate",pt->clock_rate);
5212                         lp_config_set_int(lc->config,key,"channels",pt->channels);
5213                         lp_config_set_int(lc->config,key,"enabled",linphone_core_payload_type_enabled(lc,pt));
5214                         index++;
5215                 }
5216                 sprintf(key,"audio_codec_%i",index);
5217                 lp_config_clean_section (lc->config,key);
5218
5219                 index=0;
5220                 for(node=config->video_codecs;node!=NULL;node=ms_list_next(node)){
5221                         pt=(PayloadType*)(node->data);
5222                         sprintf(key,"video_codec_%i",index);
5223                         lp_config_set_string(lc->config,key,"mime",pt->mime_type);
5224                         lp_config_set_int(lc->config,key,"rate",pt->clock_rate);
5225                         lp_config_set_int(lc->config,key,"enabled",linphone_core_payload_type_enabled(lc,pt));
5226                         lp_config_set_string(lc->config,key,"recv_fmtp",pt->recv_fmtp);
5227                         index++;
5228                 }
5229                 sprintf(key,"video_codec_%i",index);
5230                 lp_config_clean_section (lc->config,key);
5231         }
5232 }
5233
5234 static void codecs_config_uninit(LinphoneCore *lc)
5235 {
5236         _linphone_core_codec_config_write(lc);
5237         ms_list_free(lc->codecs_conf.audio_codecs);
5238         ms_list_free(lc->codecs_conf.video_codecs);
5239 }
5240
5241 void ui_config_uninit(LinphoneCore* lc)
5242 {
5243         if (lc->friends){
5244                 ms_list_for_each(lc->friends,(void (*)(void *))linphone_friend_destroy);
5245                 ms_list_free(lc->friends);
5246                 lc->friends=NULL;
5247         }
5248 }
5249
5250 /**
5251  * Returns the LpConfig object used to manage the storage (config) file.
5252  *
5253  * @ingroup misc
5254  * The application can use the LpConfig object to insert its own private
5255  * sections and pairs of key=value in the configuration file.
5256  *
5257 **/
5258 LpConfig *linphone_core_get_config(LinphoneCore *lc){
5259         return lc->config;
5260 }
5261
5262 static void linphone_core_uninit(LinphoneCore *lc)
5263 {
5264         linphone_core_free_hooks(lc);
5265         while(lc->calls)
5266         {
5267                 LinphoneCall *the_call = lc->calls->data;
5268                 linphone_core_terminate_call(lc,the_call);
5269                 linphone_core_iterate(lc);
5270 #ifdef WIN32
5271                 Sleep(50000);
5272 #else
5273                 usleep(50000);
5274 #endif
5275         }
5276 #ifdef BUILD_UPNP
5277         if(lc->upnp != NULL) {
5278                 linphone_upnp_context_destroy(lc->upnp);
5279                 lc->upnp = NULL;
5280         }
5281 #endif //BUILD_UPNP
5282
5283         if (lc->friends)
5284                 ms_list_for_each(lc->friends,(void (*)(void *))linphone_friend_close_subscriptions);
5285         linphone_core_set_state(lc,LinphoneGlobalShutdown,"Shutting down");
5286 #ifdef VIDEO_ENABLED
5287         if (lc->previewstream!=NULL){
5288                 video_preview_stop(lc->previewstream);
5289                 lc->previewstream=NULL;
5290         }
5291 #endif
5292         ms_event_queue_destroy(lc->msevq);
5293         lc->msevq=NULL;
5294         /* save all config */
5295         net_config_uninit(lc);
5296         rtp_config_uninit(lc);
5297         if (lc->ringstream) ring_stop(lc->ringstream);
5298         sound_config_uninit(lc);
5299         video_config_uninit(lc);
5300         codecs_config_uninit(lc);
5301         ui_config_uninit(lc);
5302         sip_config_uninit(lc);
5303         if (lp_config_needs_commit(lc->config)) lp_config_sync(lc->config);
5304         lp_config_destroy(lc->config);
5305         lc->config = NULL; /* Mark the config as NULL to block further calls */
5306         sip_setup_unregister_all();
5307
5308         ms_list_for_each(lc->call_logs,(void (*)(void*))linphone_call_log_destroy);
5309         lc->call_logs=ms_list_free(lc->call_logs);
5310         
5311         ms_list_for_each(lc->last_recv_msg_ids,ms_free);
5312         lc->last_recv_msg_ids=ms_list_free(lc->last_recv_msg_ids);
5313         
5314         // Free struct variable
5315         if(lc->zrtp_secrets_cache != NULL) {
5316                 ms_free(lc->zrtp_secrets_cache);
5317         }
5318         if(lc->play_file!=NULL){
5319                 ms_free(lc->play_file);
5320         }
5321         if(lc->rec_file!=NULL){
5322                 ms_free(lc->rec_file);
5323         }
5324
5325         linphone_core_free_payload_types(lc);
5326         
5327         linphone_core_message_storage_close(lc);
5328         ortp_exit();
5329         linphone_core_set_state(lc,LinphoneGlobalOff,"Off");
5330 #ifdef TUNNEL_ENABLED
5331         if (lc->tunnel) linphone_tunnel_destroy(lc->tunnel);
5332 #endif
5333 }
5334
5335 static void set_network_reachable(LinphoneCore* lc,bool_t isReachable, time_t curtime){
5336         ms_message("Network state is now [%s]",isReachable?"UP":"DOWN");
5337         // second get the list of available proxies
5338         const MSList *elem=linphone_core_get_proxy_config_list(lc);
5339         for(;elem!=NULL;elem=elem->next){
5340                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
5341                 if (linphone_proxy_config_register_enabled(cfg) ) {
5342                         if (!isReachable) {
5343                                 linphone_proxy_config_set_state(cfg, LinphoneRegistrationNone,"Registration impossible (network down)");
5344                         }else{
5345                                 cfg->commit=TRUE;
5346                         }
5347                 }
5348         }
5349         lc->netup_time=curtime;
5350         lc->network_reachable=isReachable;
5351         
5352         if(!isReachable) {
5353                 sal_reset_transports(lc->sal);
5354         }
5355 #ifdef BUILD_UPNP
5356         if(lc->upnp == NULL) {
5357                 if(isReachable && lc->net_conf.firewall_policy == LinphonePolicyUseUpnp) {
5358                         lc->upnp = linphone_upnp_context_new(lc);       
5359                 }
5360         } else {
5361                 if(!isReachable && lc->net_conf.firewall_policy == LinphonePolicyUseUpnp) {
5362                         linphone_upnp_context_destroy(lc->upnp);
5363                         lc->upnp = NULL;
5364                 }
5365         }
5366 #endif  
5367 }
5368
5369 void linphone_core_refresh_registers(LinphoneCore* lc) {
5370         const MSList *elem;
5371         if (!lc->network_reachable) {
5372                 ms_warning("Refresh register operation not available (network unreachable)");
5373                 return;
5374         }
5375         elem=linphone_core_get_proxy_config_list(lc);
5376         for(;elem!=NULL;elem=elem->next){
5377                 LinphoneProxyConfig *cfg=(LinphoneProxyConfig*)elem->data;
5378                 if (linphone_proxy_config_register_enabled(cfg) && linphone_proxy_config_get_expires(cfg)>0) {
5379                         linphone_proxy_config_refresh_register(cfg);
5380                 }
5381         }
5382 }
5383
5384 void __linphone_core_invalidate_registers(LinphoneCore* lc){
5385         const MSList *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)) {
5389                         linphone_proxy_config_edit(cfg);
5390                         linphone_proxy_config_done(cfg);
5391                 }
5392         }
5393 }
5394
5395 void linphone_core_set_network_reachable(LinphoneCore* lc,bool_t isReachable) {
5396         //first disable automatic mode
5397         if (lc->auto_net_state_mon) {
5398                 ms_message("Disabling automatic network state monitoring");
5399                 lc->auto_net_state_mon=FALSE;
5400         }
5401         set_network_reachable(lc,isReachable, ms_time(NULL));
5402 }
5403
5404 bool_t linphone_core_is_network_reachable(LinphoneCore* lc) {
5405         return lc->network_reachable;
5406 }
5407 ortp_socket_t linphone_core_get_sip_socket(LinphoneCore *lc){
5408         return sal_get_socket(lc->sal);
5409 }
5410 /**
5411  * Destroys a LinphoneCore
5412  *
5413  * @ingroup initializing
5414 **/
5415 void linphone_core_destroy(LinphoneCore *lc){
5416         linphone_core_uninit(lc);
5417         ms_free(lc);
5418 }
5419 /**
5420  * Get the number of Call
5421  *
5422  * @ingroup call_control
5423 **/
5424 int linphone_core_get_calls_nb(const LinphoneCore *lc){
5425         return  ms_list_size(lc->calls);;
5426 }
5427
5428 /**
5429  * Check if we do not have exceed the number of simultaneous call
5430  *
5431  * @ingroup call_control
5432 **/
5433 bool_t linphone_core_can_we_add_call(LinphoneCore *lc)
5434 {
5435         if(linphone_core_get_calls_nb(lc) < lc->max_calls)
5436                 return TRUE;
5437         ms_message("Maximum amount of simultaneous calls reached !");
5438         return FALSE;
5439 }
5440
5441
5442 int linphone_core_add_call( LinphoneCore *lc, LinphoneCall *call)
5443 {
5444         if(linphone_core_can_we_add_call(lc))
5445         {
5446                 lc->calls = ms_list_append(lc->calls,call);
5447                 return 0;
5448         }
5449         return -1;
5450 }
5451
5452 int linphone_core_del_call( LinphoneCore *lc, LinphoneCall *call)
5453 {
5454         MSList *it;
5455         MSList *the_calls = lc->calls;
5456
5457         it=ms_list_find(the_calls,call);
5458         if (it)
5459         {
5460                 the_calls = ms_list_remove_link(the_calls,it);
5461         }
5462         else
5463         {
5464                 ms_warning("could not find the call into the list\n");
5465                 return -1;
5466         }
5467         lc->calls = the_calls;
5468         return 0;
5469 }
5470
5471 /**
5472  * Specifiies a ring back tone to be played to far end during incoming calls.
5473 **/
5474 void linphone_core_set_remote_ringback_tone(LinphoneCore *lc, const char *file){
5475         if (lc->sound_conf.ringback_tone){
5476                 ms_free(lc->sound_conf.ringback_tone);
5477                 lc->sound_conf.ringback_tone=NULL;
5478         }
5479         if (file)
5480                 lc->sound_conf.ringback_tone=ms_strdup(file);
5481 }
5482
5483 /**
5484  * Returns the ring back tone played to far end during incoming calls.
5485 **/
5486 const char *linphone_core_get_remote_ringback_tone(const LinphoneCore *lc){
5487         return lc->sound_conf.ringback_tone;
5488 }
5489
5490 static PayloadType* find_payload_type_from_list(const char* type, int rate, int channels, const MSList* from) {
5491         const MSList *elem;
5492         for(elem=from;elem!=NULL;elem=elem->next){
5493                 PayloadType *pt=(PayloadType*)elem->data;
5494                 if ((strcasecmp((char*)type, payload_type_get_mime(pt)) == 0)
5495                         && (rate == LINPHONE_FIND_PAYLOAD_IGNORE_RATE || rate==pt->clock_rate)
5496                         && (channels == LINPHONE_FIND_PAYLOAD_IGNORE_CHANNELS || channels==pt->channels)) {
5497                         return pt;
5498                 }
5499         }
5500         return NULL;
5501 }
5502
5503
5504 PayloadType* linphone_core_find_payload_type(LinphoneCore* lc, const char* type, int rate, int channels) {
5505         PayloadType* result = find_payload_type_from_list(type, rate, channels, linphone_core_get_audio_codecs(lc));
5506         if (result)  {
5507                 return result;
5508         } else {
5509                 result = find_payload_type_from_list(type, rate, 0, linphone_core_get_video_codecs(lc));
5510                 if (result) {
5511                         return result;
5512                 }
5513         }
5514         /*not found*/
5515         return NULL;
5516 }
5517
5518 const char *linphone_global_state_to_string(LinphoneGlobalState gs){
5519         switch(gs){
5520                 case LinphoneGlobalOff:
5521                         return "LinphoneGlobalOff";
5522                 break;
5523                 case LinphoneGlobalOn:
5524                         return "LinphoneGlobalOn";
5525                 break;
5526                 case LinphoneGlobalStartup:
5527                         return "LinphoneGlobalStartup";
5528                 break;
5529                 case LinphoneGlobalShutdown:
5530                         return "LinphoneGlobalShutdown";
5531                 break;
5532         }
5533         return NULL;
5534 }
5535
5536 LinphoneGlobalState linphone_core_get_global_state(const LinphoneCore *lc){
5537         return lc->state;
5538 }
5539
5540 LinphoneCallParams *linphone_core_create_default_call_parameters(LinphoneCore *lc){
5541         LinphoneCallParams *p=ms_new0(LinphoneCallParams,1);
5542         linphone_core_init_default_params(lc, p);
5543         return p;
5544 }
5545
5546 const char *linphone_reason_to_string(LinphoneReason err){
5547         switch(err){
5548                 case LinphoneReasonNone:
5549                         return "No error";
5550                 case LinphoneReasonNoResponse:
5551                         return "No response";
5552                 case LinphoneReasonBadCredentials:
5553                         return "Bad credentials";
5554                 case LinphoneReasonDeclined:
5555                         return "Call declined";
5556                 case LinphoneReasonNotFound:
5557                         return "User not found";
5558                 case LinphoneReasonNotAnswered:
5559                         return "Not answered";
5560                 case LinphoneReasonBusy:
5561                         return "Busy";
5562         }
5563         return "unknown error";
5564 }
5565
5566 const char *linphone_error_to_string(LinphoneReason err){
5567         return linphone_reason_to_string(err);
5568 }
5569 /**
5570  * Enables signaling keep alive
5571  */
5572 void linphone_core_enable_keep_alive(LinphoneCore* lc,bool_t enable) {
5573 #ifdef BUILD_UPNP
5574         if (linphone_core_get_firewall_policy(lc)==LinphonePolicyUseUpnp) {
5575                 enable = FALSE;
5576         }
5577 #endif //BUILD_UPNP
5578         if (enable > 0) {
5579                 sal_use_tcp_tls_keepalive(lc->sal,lc->sip_conf.tcp_tls_keepalive);
5580                 sal_set_keepalive_period(lc->sal,lc->sip_conf.keepalive_period);
5581         } else {
5582                 sal_set_keepalive_period(lc->sal,0);
5583         }
5584 }
5585 /**
5586  * Is signaling keep alive enabled
5587  */
5588 bool_t linphone_core_keep_alive_enabled(LinphoneCore* lc) {
5589         return sal_get_keepalive_period(lc->sal) > 0;
5590 }
5591
5592 void linphone_core_start_dtmf_stream(LinphoneCore* lc) {
5593         get_dtmf_gen(lc); /*make sure ring stream is started*/
5594         lc->ringstream_autorelease=FALSE; /*disable autorelease mode*/
5595 }
5596
5597 void linphone_core_stop_dtmf_stream(LinphoneCore* lc) {
5598         if (lc->ringstream && lc->dmfs_playing_start_time!=0) {
5599                 ring_stop(lc->ringstream);
5600                 lc->ringstream=NULL;
5601         }
5602 }
5603
5604 int linphone_core_get_max_calls(LinphoneCore *lc) {
5605         return lc->max_calls;
5606 }
5607 void linphone_core_set_max_calls(LinphoneCore *lc, int max) {
5608         lc->max_calls=max;
5609 }
5610
5611 typedef struct Hook{
5612         LinphoneCoreIterateHook fun;
5613         void *data;
5614 }Hook;
5615
5616 static Hook *hook_new(LinphoneCoreIterateHook hook, void *hook_data){
5617         Hook *h=ms_new(Hook,1);
5618         h->fun=hook;
5619         h->data=hook_data;
5620         return h;
5621 }
5622
5623 static void hook_invoke(Hook *h){
5624         h->fun(h->data);
5625 }
5626
5627 void linphone_core_add_iterate_hook(LinphoneCore *lc, LinphoneCoreIterateHook hook, void *hook_data){
5628         lc->hooks=ms_list_append(lc->hooks,hook_new(hook,hook_data));
5629 }
5630
5631 static void linphone_core_run_hooks(LinphoneCore *lc){
5632         ms_list_for_each(lc->hooks,(void (*)(void*))hook_invoke);
5633 }
5634
5635 static void linphone_core_free_hooks(LinphoneCore *lc){
5636         ms_list_for_each(lc->hooks,(void (*)(void*))ms_free);
5637         ms_list_free(lc->hooks);
5638         lc->hooks=NULL;
5639 }
5640
5641 void linphone_core_remove_iterate_hook(LinphoneCore *lc, LinphoneCoreIterateHook hook, void *hook_data){
5642         MSList *elem;
5643         for(elem=lc->hooks;elem!=NULL;elem=elem->next){
5644                 Hook *h=(Hook*)elem->data;
5645                 if (h->fun==hook && h->data==hook_data){
5646                         lc->hooks = ms_list_remove_link(lc->hooks,elem);
5647                         ms_free(h);
5648                         return;
5649                 }
5650         }
5651         ms_error("linphone_core_remove_iterate_hook(): No such hook found.");
5652 }
5653
5654 void linphone_core_set_zrtp_secrets_file(LinphoneCore *lc, const char* file){
5655         if (lc->zrtp_secrets_cache != NULL) {
5656                 ms_free(lc->zrtp_secrets_cache);
5657         }
5658         lc->zrtp_secrets_cache=file ? ms_strdup(file) : NULL;
5659 }
5660
5661 const char *linphone_core_get_zrtp_secrets_file(LinphoneCore *lc){
5662         return lc->zrtp_secrets_cache;
5663 }
5664
5665 const LinphoneCall* linphone_core_find_call_from_uri(LinphoneCore *lc, const char *uri) {
5666         if (uri == NULL) return NULL;
5667         MSList *calls=lc->calls;
5668         while(calls) {
5669                 const LinphoneCall *c=(LinphoneCall*)calls->data;
5670                 calls=calls->next;
5671                 const LinphoneAddress *address = linphone_call_get_remote_address(c);
5672                 char *current_uri=linphone_address_as_string_uri_only(address);
5673                 if (strcmp(uri,current_uri)==0) {
5674                         ms_free(current_uri);
5675                         return c;
5676                 } else {
5677                         ms_free(current_uri);
5678                 }
5679         }
5680         return NULL;
5681 }
5682
5683
5684 /**
5685  * Check if a call will need the sound resources.
5686  *
5687  * @ingroup call_control
5688  * @param lc The LinphoneCore
5689 **/
5690 bool_t linphone_core_sound_resources_locked(LinphoneCore *lc){
5691         MSList *calls=lc->calls;
5692         while(calls) {
5693                 LinphoneCall *c=(LinphoneCall*)calls->data;
5694                 calls=calls->next;
5695                 switch (c->state) {
5696                         case LinphoneCallOutgoingInit:
5697                         case LinphoneCallOutgoingProgress:
5698                         case LinphoneCallOutgoingRinging:
5699                         case LinphoneCallOutgoingEarlyMedia:
5700                         case LinphoneCallConnected:
5701                         case LinphoneCallRefered:
5702                         case LinphoneCallIncomingEarlyMedia:
5703                         case LinphoneCallUpdating:
5704                                 return TRUE;
5705                         default:
5706                                 break;
5707                 }
5708         }
5709         return FALSE;
5710 }
5711
5712 void linphone_core_set_srtp_enabled(LinphoneCore *lc, bool_t enabled) {
5713         lp_config_set_int(lc->config,"sip","srtp",(int)enabled);
5714 }
5715
5716 /**
5717  * Returns whether a media encryption scheme is supported by the LinphoneCore engine
5718 **/
5719 bool_t linphone_core_media_encryption_supported(const LinphoneCore *lc, LinphoneMediaEncryption menc){
5720         switch(menc){
5721                 case LinphoneMediaEncryptionSRTP:
5722                         return ortp_srtp_supported();
5723                 case LinphoneMediaEncryptionZRTP:
5724                         return ortp_zrtp_available();
5725                 case LinphoneMediaEncryptionNone:
5726                         return TRUE;
5727         }
5728         return FALSE;
5729 }
5730
5731 int linphone_core_set_media_encryption(LinphoneCore *lc, enum LinphoneMediaEncryption menc) {
5732         const char *type="none";
5733         int ret=0;
5734         if (menc == LinphoneMediaEncryptionSRTP){
5735                 if (!ortp_srtp_supported()){
5736                         ms_warning("SRTP not supported by library.");
5737                         type="none";
5738                         ret=-1;
5739                 }else type="srtp";
5740         }else if (menc == LinphoneMediaEncryptionZRTP){
5741                 if (!ortp_zrtp_available()){
5742                         ms_warning("ZRTP not supported by library.");
5743                         type="none";
5744                         ret=-1;
5745                 }else type="zrtp";
5746         }
5747         lp_config_set_string(lc->config,"sip","media_encryption",type);
5748         return ret;
5749 }
5750
5751 LinphoneMediaEncryption linphone_core_get_media_encryption(LinphoneCore *lc) {
5752         const char* menc = lp_config_get_string(lc->config, "sip", "media_encryption", NULL);
5753         
5754         if (menc == NULL)
5755                 return LinphoneMediaEncryptionNone;
5756         else if (strcmp(menc, "srtp")==0)
5757                 return LinphoneMediaEncryptionSRTP;
5758         else if (strcmp(menc, "zrtp")==0)
5759                 return LinphoneMediaEncryptionZRTP;
5760         else
5761                 return LinphoneMediaEncryptionNone;
5762 }
5763
5764 bool_t linphone_core_is_media_encryption_mandatory(LinphoneCore *lc) {
5765         return (bool_t)lp_config_get_int(lc->config, "sip", "media_encryption_mandatory", 0);
5766 }
5767
5768 void linphone_core_set_media_encryption_mandatory(LinphoneCore *lc, bool_t m) {
5769         lp_config_set_int(lc->config, "sip", "media_encryption_mandatory", (int)m);
5770 }
5771
5772 void linphone_core_init_default_params(LinphoneCore*lc, LinphoneCallParams *params) {
5773         params->has_video=linphone_core_video_enabled(lc) && lc->video_policy.automatically_initiate;
5774         params->media_encryption=linphone_core_get_media_encryption(lc);
5775         params->in_conference=FALSE;
5776 }
5777
5778 void linphone_core_set_device_identifier(LinphoneCore *lc,const char* device_id) {
5779         if (lc->device_id) ms_free(lc->device_id);
5780         lc->device_id=ms_strdup(device_id);
5781 }
5782 const char*  linphone_core_get_device_identifier(const LinphoneCore *lc) {
5783         return lc->device_id;
5784 }
5785
5786 /**
5787  * Set the DSCP field for SIP signaling channel.
5788  * 
5789  * @ingroup network_parameters
5790  * * The DSCP defines the quality of service in IP packets.
5791  * 
5792 **/
5793 void linphone_core_set_sip_dscp(LinphoneCore *lc, int dscp){
5794         sal_set_dscp(lc->sal,dscp);
5795         if (linphone_core_ready(lc)){
5796                 lp_config_set_int_hex(lc->config,"sip","dscp",dscp);
5797                 apply_transports(lc);
5798         }
5799 }
5800
5801 /**
5802  * Get the DSCP field for SIP signaling channel.
5803  * 
5804  * @ingroup network_parameters
5805  * * The DSCP defines the quality of service in IP packets.
5806  * 
5807 **/
5808 int linphone_core_get_sip_dscp(const LinphoneCore *lc){
5809         return lp_config_get_int(lc->config,"sip","dscp",0x1a);
5810 }
5811
5812 /**
5813  * Set the DSCP field for outgoing audio streams.
5814  *
5815  * @ingroup network_parameters
5816  * The DSCP defines the quality of service in IP packets.
5817  * 
5818 **/
5819 void linphone_core_set_audio_dscp(LinphoneCore *lc, int dscp){
5820         if (linphone_core_ready(lc))
5821                 lp_config_set_int_hex(lc->config,"rtp","audio_dscp",dscp);
5822 }
5823
5824 /**
5825  * Get the DSCP field for outgoing audio streams.
5826  *
5827  * @ingroup network_parameters
5828  * The DSCP defines the quality of service in IP packets.
5829  * 
5830 **/
5831 int linphone_core_get_audio_dscp(const LinphoneCore *lc){
5832         return lp_config_get_int(lc->config,"rtp","audio_dscp",0x2e);
5833 }
5834
5835 /**
5836  * Set the DSCP field for outgoing video streams.
5837  *
5838  * @ingroup network_parameters
5839  * The DSCP defines the quality of service in IP packets.
5840  * 
5841 **/
5842 void linphone_core_set_video_dscp(LinphoneCore *lc, int dscp){
5843         if (linphone_core_ready(lc))
5844                 lp_config_set_int_hex(lc->config,"rtp","video_dscp",dscp);
5845         
5846 }
5847
5848 /**
5849  * Get the DSCP field for outgoing video streams.
5850  *
5851  * @ingroup network_parameters
5852  * The DSCP defines the quality of service in IP packets.
5853  * 
5854 **/
5855 int linphone_core_get_video_dscp(const LinphoneCore *lc){
5856         return lp_config_get_int(lc->config,"rtp","video_dscp",0x2e);
5857 }
5858
5859
5860 /**
5861  * Sets the database filename where chat messages will be stored.
5862  * If the file does not exist, it will be created.
5863  * @ingroup initializing
5864  * @param lc the linphone core
5865  * @param path filesystem path
5866 **/
5867 void linphone_core_set_chat_database_path(LinphoneCore *lc, const char *path){
5868         if (lc->chat_db_file){
5869                 ms_free(lc->chat_db_file);
5870                 lc->chat_db_file=NULL;
5871         }
5872         if (path) {
5873                 lc->chat_db_file=ms_strdup(path);
5874                 linphone_core_message_storage_init(lc);
5875         }
5876 }
5877
5878