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