353b7f39b298e01a8c77d90e350966ec1be46198
[asterisk/asterisk.git] / channels / sig_pri.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2009, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief PRI signaling module
22  *
23  * \author Matthew Fredrickson <creslin@digium.com>
24  */
25
26 /*** MODULEINFO
27         <support_level>core</support_level>
28  ***/
29
30 #include "asterisk.h"
31
32 #ifdef HAVE_PRI
33
34 #include <errno.h>
35 #include <ctype.h>
36 #include <signal.h>
37
38 #include "asterisk/utils.h"
39 #include "asterisk/options.h"
40 #include "asterisk/pbx.h"
41 #include "asterisk/app.h"
42 #include "asterisk/file.h"
43 #include "asterisk/callerid.h"
44 #include "asterisk/say.h"
45 #include "asterisk/manager.h"
46 #include "asterisk/astdb.h"
47 #include "asterisk/causes.h"
48 #include "asterisk/musiconhold.h"
49 #include "asterisk/cli.h"
50 #include "asterisk/transcap.h"
51 #include "asterisk/features.h"
52 #include "asterisk/aoc.h"
53
54 #include "sig_pri.h"
55 #ifndef PRI_EVENT_FACILITY
56 #error "Upgrade your libpri"
57 #endif
58
59 /*** DOCUMENTATION
60  ***/
61
62
63 /* define this to send PRI user-user information elements */
64 #undef SUPPORT_USERUSER
65
66 /*!
67  * Define to make always pick a channel if allowed.  Useful for
68  * testing channel shifting.
69  */
70 //#define ALWAYS_PICK_CHANNEL   1
71
72 /*!
73  * Define to force a RESTART on a channel that returns a cause
74  * code of PRI_CAUSE_REQUESTED_CHAN_UNAVAIL(44).  If the cause
75  * is because of a stuck channel on the peer and the channel is
76  * always the next channel we pick for an outgoing call then
77  * this can help.
78  */
79 #define FORCE_RESTART_UNAVAIL_CHANS             1
80
81 #if defined(HAVE_PRI_CCSS)
82 struct sig_pri_cc_agent_prv {
83         /*! Asterisk span D channel control structure. */
84         struct sig_pri_span *pri;
85         /*! CC id value to use with libpri. -1 if invalid. */
86         long cc_id;
87         /*! TRUE if CC has been requested and we are waiting for the response. */
88         unsigned char cc_request_response_pending;
89 };
90
91 struct sig_pri_cc_monitor_instance {
92         /*! \brief Asterisk span D channel control structure. */
93         struct sig_pri_span *pri;
94         /*! CC id value to use with libpri. (-1 if already canceled). */
95         long cc_id;
96         /*! CC core id value. */
97         int core_id;
98         /*! Device name(Channel name less sequence number) */
99         char name[1];
100 };
101
102 /*! Upper level agent/monitor type name. */
103 static const char *sig_pri_cc_type_name;
104 /*! Container of sig_pri monitor instances. */
105 static struct ao2_container *sig_pri_cc_monitors;
106 #endif  /* defined(HAVE_PRI_CCSS) */
107
108 static int pri_matchdigittimeout = 3000;
109
110 static int pri_gendigittimeout = 8000;
111
112 #define DCHAN_NOTINALARM  (1 << 0)
113 #define DCHAN_UP          (1 << 1)
114
115 /* Defines to help decode the encoded event channel id. */
116 #define PRI_CHANNEL(p)  ((p) & 0xff)
117 #define PRI_SPAN(p)             (((p) >> 8) & 0xff)
118 #define PRI_EXPLICIT    (1 << 16)
119 #define PRI_CIS_CALL    (1 << 17)       /* Call is using the D channel only. */
120 #define PRI_HELD_CALL   (1 << 18)
121
122
123 #define DCHAN_AVAILABLE (DCHAN_NOTINALARM | DCHAN_UP)
124
125 static int pri_active_dchan_index(struct sig_pri_span *pri);
126
127 static const char *sig_pri_call_level2str(enum sig_pri_call_level level)
128 {
129         switch (level) {
130         case SIG_PRI_CALL_LEVEL_IDLE:
131                 return "Idle";
132         case SIG_PRI_CALL_LEVEL_SETUP:
133                 return "Setup";
134         case SIG_PRI_CALL_LEVEL_OVERLAP:
135                 return "Overlap";
136         case SIG_PRI_CALL_LEVEL_PROCEEDING:
137                 return "Proceeding";
138         case SIG_PRI_CALL_LEVEL_ALERTING:
139                 return "Alerting";
140         case SIG_PRI_CALL_LEVEL_DEFER_DIAL:
141                 return "DeferDial";
142         case SIG_PRI_CALL_LEVEL_CONNECT:
143                 return "Connect";
144         }
145         return "Unknown";
146 }
147
148 static inline void pri_rel(struct sig_pri_span *pri)
149 {
150         ast_mutex_unlock(&pri->lock);
151 }
152
153 static unsigned int PVT_TO_CHANNEL(struct sig_pri_chan *p)
154 {
155         int res = (((p)->prioffset) | ((p)->logicalspan << 8) | (p->mastertrunkgroup ? PRI_EXPLICIT : 0));
156         ast_debug(5, "prioffset: %d mastertrunkgroup: %d logicalspan: %d result: %d\n",
157                 p->prioffset, p->mastertrunkgroup, p->logicalspan, res);
158
159         return res;
160 }
161
162 static void sig_pri_handle_dchan_exception(struct sig_pri_span *pri, int index)
163 {
164         if (sig_pri_callbacks.handle_dchan_exception) {
165                 sig_pri_callbacks.handle_dchan_exception(pri, index);
166         }
167 }
168
169 static void sig_pri_set_dialing(struct sig_pri_chan *p, int is_dialing)
170 {
171         if (sig_pri_callbacks.set_dialing) {
172                 sig_pri_callbacks.set_dialing(p->chan_pvt, is_dialing);
173         }
174 }
175
176 static void sig_pri_set_digital(struct sig_pri_chan *p, int is_digital)
177 {
178         p->digital = is_digital;
179         if (sig_pri_callbacks.set_digital) {
180                 sig_pri_callbacks.set_digital(p->chan_pvt, is_digital);
181         }
182 }
183
184 static void sig_pri_set_outgoing(struct sig_pri_chan *p, int is_outgoing)
185 {
186         p->outgoing = is_outgoing;
187         if (sig_pri_callbacks.set_outgoing) {
188                 sig_pri_callbacks.set_outgoing(p->chan_pvt, is_outgoing);
189         }
190 }
191
192 void sig_pri_set_alarm(struct sig_pri_chan *p, int in_alarm)
193 {
194         if (sig_pri_is_alarm_ignored(p->pri)) {
195                 /* Always set not in alarm */
196                 in_alarm = 0;
197         }
198
199         /*
200          * Clear the channel restart state when the channel alarm
201          * changes to prevent the state from getting stuck when the link
202          * goes down.
203          */
204         p->resetting = SIG_PRI_RESET_IDLE;
205
206         p->inalarm = in_alarm;
207         if (sig_pri_callbacks.set_alarm) {
208                 sig_pri_callbacks.set_alarm(p->chan_pvt, in_alarm);
209         }
210 }
211
212 static const char *sig_pri_get_orig_dialstring(struct sig_pri_chan *p)
213 {
214         if (sig_pri_callbacks.get_orig_dialstring) {
215                 return sig_pri_callbacks.get_orig_dialstring(p->chan_pvt);
216         }
217         ast_log(LOG_ERROR, "get_orig_dialstring callback not defined\n");
218         return "";
219 }
220
221 #if defined(HAVE_PRI_CCSS)
222 static void sig_pri_make_cc_dialstring(struct sig_pri_chan *p, char *buf, size_t buf_size)
223 {
224         if (sig_pri_callbacks.make_cc_dialstring) {
225                 sig_pri_callbacks.make_cc_dialstring(p->chan_pvt, buf, buf_size);
226         } else {
227                 ast_log(LOG_ERROR, "make_cc_dialstring callback not defined\n");
228                 buf[0] = '\0';
229         }
230 }
231 #endif  /* defined(HAVE_PRI_CCSS) */
232
233 static void sig_pri_dial_digits(struct sig_pri_chan *p, const char *dial_string)
234 {
235         if (sig_pri_callbacks.dial_digits) {
236                 sig_pri_callbacks.dial_digits(p->chan_pvt, dial_string);
237         }
238 }
239
240 /*!
241  * \internal
242  * \brief Reevaluate the PRI span device state.
243  * \since 1.8
244  *
245  * \param pri PRI span control structure.
246  *
247  * \return Nothing
248  *
249  * \note Assumes the pri->lock is already obtained.
250  */
251 static void sig_pri_span_devstate_changed(struct sig_pri_span *pri)
252 {
253         if (sig_pri_callbacks.update_span_devstate) {
254                 sig_pri_callbacks.update_span_devstate(pri);
255         }
256 }
257
258 /*!
259  * \internal
260  * \brief Set the caller id information in the parent module.
261  * \since 1.8
262  *
263  * \param p sig_pri channel structure.
264  *
265  * \return Nothing
266  */
267 static void sig_pri_set_caller_id(struct sig_pri_chan *p)
268 {
269         struct ast_party_caller caller;
270
271         if (sig_pri_callbacks.set_callerid) {
272                 ast_party_caller_init(&caller);
273
274                 caller.id.name.str = p->cid_name;
275                 caller.id.name.presentation = p->callingpres;
276                 caller.id.name.valid = 1;
277
278                 caller.id.number.str = p->cid_num;
279                 caller.id.number.plan = p->cid_ton;
280                 caller.id.number.presentation = p->callingpres;
281                 caller.id.number.valid = 1;
282
283                 if (!ast_strlen_zero(p->cid_subaddr)) {
284                         caller.id.subaddress.valid = 1;
285                         //caller.id.subaddress.type = 0;/* nsap */
286                         //caller.id.subaddress.odd_even_indicator = 0;
287                         caller.id.subaddress.str = p->cid_subaddr;
288                 }
289                 caller.id.tag = p->user_tag;
290
291                 caller.ani.number.str = p->cid_ani;
292                 //caller.ani.number.plan = p->xxx;
293                 //caller.ani.number.presentation = p->xxx;
294                 caller.ani.number.valid = 1;
295
296                 caller.ani2 = p->cid_ani2;
297                 sig_pri_callbacks.set_callerid(p->chan_pvt, &caller);
298         }
299 }
300
301 /*!
302  * \internal
303  * \brief Set the Dialed Number Identifier.
304  * \since 1.8
305  *
306  * \param p sig_pri channel structure.
307  * \param dnid Dialed Number Identifier string.
308  *
309  * \return Nothing
310  */
311 static void sig_pri_set_dnid(struct sig_pri_chan *p, const char *dnid)
312 {
313         if (sig_pri_callbacks.set_dnid) {
314                 sig_pri_callbacks.set_dnid(p->chan_pvt, dnid);
315         }
316 }
317
318 /*!
319  * \internal
320  * \brief Set the Redirecting Directory Number Information Service (RDNIS).
321  * \since 1.8
322  *
323  * \param p sig_pri channel structure.
324  * \param rdnis Redirecting Directory Number Information Service (RDNIS) string.
325  *
326  * \return Nothing
327  */
328 static void sig_pri_set_rdnis(struct sig_pri_chan *p, const char *rdnis)
329 {
330         if (sig_pri_callbacks.set_rdnis) {
331                 sig_pri_callbacks.set_rdnis(p->chan_pvt, rdnis);
332         }
333 }
334
335 static void sig_pri_unlock_private(struct sig_pri_chan *p)
336 {
337         if (sig_pri_callbacks.unlock_private) {
338                 sig_pri_callbacks.unlock_private(p->chan_pvt);
339         }
340 }
341
342 static void sig_pri_lock_private(struct sig_pri_chan *p)
343 {
344         if (sig_pri_callbacks.lock_private) {
345                 sig_pri_callbacks.lock_private(p->chan_pvt);
346         }
347 }
348
349 static void sig_pri_deadlock_avoidance_private(struct sig_pri_chan *p)
350 {
351         if (sig_pri_callbacks.deadlock_avoidance_private) {
352                 sig_pri_callbacks.deadlock_avoidance_private(p->chan_pvt);
353         } else {
354                 /* Fallback to the old way if callback not present. */
355                 sig_pri_unlock_private(p);
356                 sched_yield();
357                 sig_pri_lock_private(p);
358         }
359 }
360
361 static void pri_grab(struct sig_pri_chan *p, struct sig_pri_span *pri)
362 {
363         /* Grab the lock first */
364         while (ast_mutex_trylock(&pri->lock)) {
365                 /* Avoid deadlock */
366                 sig_pri_deadlock_avoidance_private(p);
367         }
368         /* Then break the poll */
369         if (pri->master != AST_PTHREADT_NULL) {
370                 pthread_kill(pri->master, SIGURG);
371         }
372 }
373
374 /*!
375  * \internal
376  * \brief Convert PRI redirecting reason to asterisk version.
377  * \since 1.8
378  *
379  * \param pri_reason PRI redirecting reason.
380  *
381  * \return Equivalent asterisk redirecting reason value.
382  */
383 static enum AST_REDIRECTING_REASON pri_to_ast_reason(int pri_reason)
384 {
385         enum AST_REDIRECTING_REASON ast_reason;
386
387         switch (pri_reason) {
388         case PRI_REDIR_FORWARD_ON_BUSY:
389                 ast_reason = AST_REDIRECTING_REASON_USER_BUSY;
390                 break;
391         case PRI_REDIR_FORWARD_ON_NO_REPLY:
392                 ast_reason = AST_REDIRECTING_REASON_NO_ANSWER;
393                 break;
394         case PRI_REDIR_DEFLECTION:
395                 ast_reason = AST_REDIRECTING_REASON_DEFLECTION;
396                 break;
397         case PRI_REDIR_UNCONDITIONAL:
398                 ast_reason = AST_REDIRECTING_REASON_UNCONDITIONAL;
399                 break;
400         case PRI_REDIR_UNKNOWN:
401         default:
402                 ast_reason = AST_REDIRECTING_REASON_UNKNOWN;
403                 break;
404         }
405
406         return ast_reason;
407 }
408
409 /*!
410  * \internal
411  * \brief Convert asterisk redirecting reason to PRI version.
412  * \since 1.8
413  *
414  * \param ast_reason Asterisk redirecting reason.
415  *
416  * \return Equivalent PRI redirecting reason value.
417  */
418 static int ast_to_pri_reason(enum AST_REDIRECTING_REASON ast_reason)
419 {
420         int pri_reason;
421
422         switch (ast_reason) {
423         case AST_REDIRECTING_REASON_USER_BUSY:
424                 pri_reason = PRI_REDIR_FORWARD_ON_BUSY;
425                 break;
426         case AST_REDIRECTING_REASON_NO_ANSWER:
427                 pri_reason = PRI_REDIR_FORWARD_ON_NO_REPLY;
428                 break;
429         case AST_REDIRECTING_REASON_UNCONDITIONAL:
430                 pri_reason = PRI_REDIR_UNCONDITIONAL;
431                 break;
432         case AST_REDIRECTING_REASON_DEFLECTION:
433                 pri_reason = PRI_REDIR_DEFLECTION;
434                 break;
435         case AST_REDIRECTING_REASON_UNKNOWN:
436         default:
437                 pri_reason = PRI_REDIR_UNKNOWN;
438                 break;
439         }
440
441         return pri_reason;
442 }
443
444 /*!
445  * \internal
446  * \brief Convert PRI number presentation to asterisk version.
447  * \since 1.8
448  *
449  * \param pri_presentation PRI number presentation.
450  *
451  * \return Equivalent asterisk number presentation value.
452  */
453 static int pri_to_ast_presentation(int pri_presentation)
454 {
455         int ast_presentation;
456
457         switch (pri_presentation) {
458         case PRI_PRES_ALLOWED | PRI_PRES_USER_NUMBER_UNSCREENED:
459                 ast_presentation = AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_UNSCREENED;
460                 break;
461         case PRI_PRES_ALLOWED | PRI_PRES_USER_NUMBER_PASSED_SCREEN:
462                 ast_presentation = AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_PASSED_SCREEN;
463                 break;
464         case PRI_PRES_ALLOWED | PRI_PRES_USER_NUMBER_FAILED_SCREEN:
465                 ast_presentation = AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_FAILED_SCREEN;
466                 break;
467         case PRI_PRES_ALLOWED | PRI_PRES_NETWORK_NUMBER:
468                 ast_presentation = AST_PRES_ALLOWED | AST_PRES_NETWORK_NUMBER;
469                 break;
470
471         case PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_UNSCREENED:
472                 ast_presentation = AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_UNSCREENED;
473                 break;
474         case PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_PASSED_SCREEN:
475                 ast_presentation = AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_PASSED_SCREEN;
476                 break;
477         case PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_FAILED_SCREEN:
478                 ast_presentation = AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_FAILED_SCREEN;
479                 break;
480         case PRI_PRES_RESTRICTED | PRI_PRES_NETWORK_NUMBER:
481                 ast_presentation = AST_PRES_RESTRICTED | AST_PRES_NETWORK_NUMBER;
482                 break;
483
484         case PRI_PRES_UNAVAILABLE | PRI_PRES_USER_NUMBER_UNSCREENED:
485         case PRI_PRES_UNAVAILABLE | PRI_PRES_USER_NUMBER_PASSED_SCREEN:
486         case PRI_PRES_UNAVAILABLE | PRI_PRES_USER_NUMBER_FAILED_SCREEN:
487         case PRI_PRES_UNAVAILABLE | PRI_PRES_NETWORK_NUMBER:
488                 ast_presentation = AST_PRES_NUMBER_NOT_AVAILABLE;
489                 break;
490
491         default:
492                 ast_presentation = AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_UNSCREENED;
493                 break;
494         }
495
496         return ast_presentation;
497 }
498
499 /*!
500  * \internal
501  * \brief Convert asterisk number presentation to PRI version.
502  * \since 1.8
503  *
504  * \param ast_presentation Asterisk number presentation.
505  *
506  * \return Equivalent PRI number presentation value.
507  */
508 static int ast_to_pri_presentation(int ast_presentation)
509 {
510         int pri_presentation;
511
512         switch (ast_presentation) {
513         case AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_UNSCREENED:
514                 pri_presentation = PRI_PRES_ALLOWED | PRI_PRES_USER_NUMBER_UNSCREENED;
515                 break;
516         case AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_PASSED_SCREEN:
517                 pri_presentation = PRI_PRES_ALLOWED | PRI_PRES_USER_NUMBER_PASSED_SCREEN;
518                 break;
519         case AST_PRES_ALLOWED | AST_PRES_USER_NUMBER_FAILED_SCREEN:
520                 pri_presentation = PRI_PRES_ALLOWED | PRI_PRES_USER_NUMBER_FAILED_SCREEN;
521                 break;
522         case AST_PRES_ALLOWED | AST_PRES_NETWORK_NUMBER:
523                 pri_presentation = PRI_PRES_ALLOWED | PRI_PRES_NETWORK_NUMBER;
524                 break;
525
526         case AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_UNSCREENED:
527                 pri_presentation = PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_UNSCREENED;
528                 break;
529         case AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_PASSED_SCREEN:
530                 pri_presentation = PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_PASSED_SCREEN;
531                 break;
532         case AST_PRES_RESTRICTED | AST_PRES_USER_NUMBER_FAILED_SCREEN:
533                 pri_presentation = PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_FAILED_SCREEN;
534                 break;
535         case AST_PRES_RESTRICTED | AST_PRES_NETWORK_NUMBER:
536                 pri_presentation = PRI_PRES_RESTRICTED | PRI_PRES_NETWORK_NUMBER;
537                 break;
538
539         case AST_PRES_UNAVAILABLE | AST_PRES_USER_NUMBER_UNSCREENED:
540         case AST_PRES_UNAVAILABLE | AST_PRES_USER_NUMBER_PASSED_SCREEN:
541         case AST_PRES_UNAVAILABLE | AST_PRES_USER_NUMBER_FAILED_SCREEN:
542         case AST_PRES_UNAVAILABLE | AST_PRES_NETWORK_NUMBER:
543                 pri_presentation = PRES_NUMBER_NOT_AVAILABLE;
544                 break;
545
546         default:
547                 pri_presentation = PRI_PRES_RESTRICTED | PRI_PRES_USER_NUMBER_UNSCREENED;
548                 break;
549         }
550
551         return pri_presentation;
552 }
553
554 /*!
555  * \internal
556  * \brief Convert PRI name char_set to asterisk version.
557  * \since 1.8
558  *
559  * \param pri_char_set PRI name char_set.
560  *
561  * \return Equivalent asterisk name char_set value.
562  */
563 static enum AST_PARTY_CHAR_SET pri_to_ast_char_set(int pri_char_set)
564 {
565         enum AST_PARTY_CHAR_SET ast_char_set;
566
567         switch (pri_char_set) {
568         default:
569         case PRI_CHAR_SET_UNKNOWN:
570                 ast_char_set = AST_PARTY_CHAR_SET_UNKNOWN;
571                 break;
572         case PRI_CHAR_SET_ISO8859_1:
573                 ast_char_set = AST_PARTY_CHAR_SET_ISO8859_1;
574                 break;
575         case PRI_CHAR_SET_WITHDRAWN:
576                 ast_char_set = AST_PARTY_CHAR_SET_WITHDRAWN;
577                 break;
578         case PRI_CHAR_SET_ISO8859_2:
579                 ast_char_set = AST_PARTY_CHAR_SET_ISO8859_2;
580                 break;
581         case PRI_CHAR_SET_ISO8859_3:
582                 ast_char_set = AST_PARTY_CHAR_SET_ISO8859_3;
583                 break;
584         case PRI_CHAR_SET_ISO8859_4:
585                 ast_char_set = AST_PARTY_CHAR_SET_ISO8859_4;
586                 break;
587         case PRI_CHAR_SET_ISO8859_5:
588                 ast_char_set = AST_PARTY_CHAR_SET_ISO8859_5;
589                 break;
590         case PRI_CHAR_SET_ISO8859_7:
591                 ast_char_set = AST_PARTY_CHAR_SET_ISO8859_7;
592                 break;
593         case PRI_CHAR_SET_ISO10646_BMPSTRING:
594                 ast_char_set = AST_PARTY_CHAR_SET_ISO10646_BMPSTRING;
595                 break;
596         case PRI_CHAR_SET_ISO10646_UTF_8STRING:
597                 ast_char_set = AST_PARTY_CHAR_SET_ISO10646_UTF_8STRING;
598                 break;
599         }
600
601         return ast_char_set;
602 }
603
604 /*!
605  * \internal
606  * \brief Convert asterisk name char_set to PRI version.
607  * \since 1.8
608  *
609  * \param ast_char_set Asterisk name char_set.
610  *
611  * \return Equivalent PRI name char_set value.
612  */
613 static int ast_to_pri_char_set(enum AST_PARTY_CHAR_SET ast_char_set)
614 {
615         int pri_char_set;
616
617         switch (ast_char_set) {
618         default:
619         case AST_PARTY_CHAR_SET_UNKNOWN:
620                 pri_char_set = PRI_CHAR_SET_UNKNOWN;
621                 break;
622         case AST_PARTY_CHAR_SET_ISO8859_1:
623                 pri_char_set = PRI_CHAR_SET_ISO8859_1;
624                 break;
625         case AST_PARTY_CHAR_SET_WITHDRAWN:
626                 pri_char_set = PRI_CHAR_SET_WITHDRAWN;
627                 break;
628         case AST_PARTY_CHAR_SET_ISO8859_2:
629                 pri_char_set = PRI_CHAR_SET_ISO8859_2;
630                 break;
631         case AST_PARTY_CHAR_SET_ISO8859_3:
632                 pri_char_set = PRI_CHAR_SET_ISO8859_3;
633                 break;
634         case AST_PARTY_CHAR_SET_ISO8859_4:
635                 pri_char_set = PRI_CHAR_SET_ISO8859_4;
636                 break;
637         case AST_PARTY_CHAR_SET_ISO8859_5:
638                 pri_char_set = PRI_CHAR_SET_ISO8859_5;
639                 break;
640         case AST_PARTY_CHAR_SET_ISO8859_7:
641                 pri_char_set = PRI_CHAR_SET_ISO8859_7;
642                 break;
643         case AST_PARTY_CHAR_SET_ISO10646_BMPSTRING:
644                 pri_char_set = PRI_CHAR_SET_ISO10646_BMPSTRING;
645                 break;
646         case AST_PARTY_CHAR_SET_ISO10646_UTF_8STRING:
647                 pri_char_set = PRI_CHAR_SET_ISO10646_UTF_8STRING;
648                 break;
649         }
650
651         return pri_char_set;
652 }
653
654 #if defined(HAVE_PRI_SUBADDR)
655 /*!
656  * \internal
657  * \brief Fill in the asterisk party subaddress from the given PRI party subaddress.
658  * \since 1.8
659  *
660  * \param ast_subaddress Asterisk party subaddress structure.
661  * \param pri_subaddress PRI party subaddress structure.
662  *
663  * \return Nothing
664  *
665  */
666 static void sig_pri_set_subaddress(struct ast_party_subaddress *ast_subaddress, const struct pri_party_subaddress *pri_subaddress)
667 {
668         char *cnum, *ptr;
669         int x, len;
670
671         if (ast_subaddress->str) {
672                 ast_free(ast_subaddress->str);
673         }
674         if (pri_subaddress->length <= 0) {
675                 ast_party_subaddress_init(ast_subaddress);
676                 return;
677         }
678
679         if (!pri_subaddress->type) {
680                 /* NSAP */
681                 ast_subaddress->str = ast_strdup((char *) pri_subaddress->data);
682         } else {
683                 /* User Specified */
684                 if (!(cnum = ast_malloc(2 * pri_subaddress->length + 1))) {
685                         ast_party_subaddress_init(ast_subaddress);
686                         return;
687                 }
688
689                 ptr = cnum;
690                 len = pri_subaddress->length - 1; /* -1 account for zero based indexing */
691                 for (x = 0; x < len; ++x) {
692                         ptr += sprintf(ptr, "%02x", pri_subaddress->data[x]);
693                 }
694
695                 if (pri_subaddress->odd_even_indicator) {
696                         /* ODD */
697                         sprintf(ptr, "%01x", (pri_subaddress->data[len]) >> 4);
698                 } else {
699                         /* EVEN */
700                         sprintf(ptr, "%02x", pri_subaddress->data[len]);
701                 }
702                 ast_subaddress->str = cnum;
703         }
704         ast_subaddress->type = pri_subaddress->type;
705         ast_subaddress->odd_even_indicator = pri_subaddress->odd_even_indicator;
706         ast_subaddress->valid = 1;
707 }
708 #endif  /* defined(HAVE_PRI_SUBADDR) */
709
710 #if defined(HAVE_PRI_SUBADDR)
711 static unsigned char ast_pri_pack_hex_char(char c)
712 {
713         unsigned char res;
714
715         if (c < '0') {
716                 res = 0;
717         } else if (c < ('9' + 1)) {
718                 res = c - '0';
719         } else if (c < 'A') {
720                 res = 0;
721         } else if (c < ('F' + 1)) {
722                 res = c - 'A' + 10;
723         } else if (c < 'a') {
724                 res = 0;
725         } else if (c < ('f' + 1)) {
726                 res = c - 'a' + 10;
727         } else {
728                 res = 0;
729         }
730         return res;
731 }
732 #endif  /* defined(HAVE_PRI_SUBADDR) */
733
734 #if defined(HAVE_PRI_SUBADDR)
735 /*!
736  * \internal
737  * \brief Convert a null terminated hexadecimal string to a packed hex byte array.
738  * \details left justified, with 0 padding if odd length.
739  * \since 1.8
740  *
741  * \param dst pointer to packed byte array.
742  * \param src pointer to null terminated hexadecimal string.
743  * \param maxlen destination array size.
744  *
745  * \return Length of byte array
746  *
747  * \note The dst is not an ASCIIz string.
748  * \note The src is an ASCIIz hex string.
749  */
750 static int ast_pri_pack_hex_string(unsigned char *dst, char *src, int maxlen)
751 {
752         int res = 0;
753         int len = strlen(src);
754
755         if (len > (2 * maxlen)) {
756                 len = 2 * maxlen;
757         }
758
759         res = len / 2 + len % 2;
760
761         while (len > 1) {
762                 *dst = ast_pri_pack_hex_char(*src) << 4;
763                 src++;
764                 *dst |= ast_pri_pack_hex_char(*src);
765                 dst++, src++;
766                 len -= 2;
767         }
768         if (len) { /* 1 left */
769                 *dst = ast_pri_pack_hex_char(*src) << 4;
770         }
771         return res;
772 }
773 #endif  /* defined(HAVE_PRI_SUBADDR) */
774
775 #if defined(HAVE_PRI_SUBADDR)
776 /*!
777  * \internal
778  * \brief Fill in the PRI party subaddress from the given asterisk party subaddress.
779  * \since 1.8
780  *
781  * \param pri_subaddress PRI party subaddress structure.
782  * \param ast_subaddress Asterisk party subaddress structure.
783  *
784  * \return Nothing
785  *
786  * \note Assumes that pri_subaddress has been previously memset to zero.
787  */
788 static void sig_pri_party_subaddress_from_ast(struct pri_party_subaddress *pri_subaddress, const struct ast_party_subaddress *ast_subaddress)
789 {
790         if (ast_subaddress->valid && !ast_strlen_zero(ast_subaddress->str)) {
791                 pri_subaddress->type = ast_subaddress->type;
792                 if (!ast_subaddress->type) {
793                         /* 0 = NSAP */
794                         ast_copy_string((char *) pri_subaddress->data, ast_subaddress->str,
795                                 sizeof(pri_subaddress->data));
796                         pri_subaddress->length = strlen((char *) pri_subaddress->data);
797                         pri_subaddress->odd_even_indicator = 0;
798                         pri_subaddress->valid = 1;
799                 } else {
800                         /* 2 = User Specified */
801                         /*
802                          * Copy HexString to packed HexData,
803                          * if odd length then right pad trailing byte with 0
804                          */
805                         int length = ast_pri_pack_hex_string(pri_subaddress->data,
806                                 ast_subaddress->str, sizeof(pri_subaddress->data));
807
808                         pri_subaddress->length = length; /* packed data length */
809
810                         length = strlen(ast_subaddress->str);
811                         if (length > 2 * sizeof(pri_subaddress->data)) {
812                                 pri_subaddress->odd_even_indicator = 0;
813                         } else {
814                                 pri_subaddress->odd_even_indicator = (length & 1);
815                         }
816                         pri_subaddress->valid = 1;
817                 }
818         }
819 }
820 #endif  /* defined(HAVE_PRI_SUBADDR) */
821
822 /*!
823  * \internal
824  * \brief Fill in the PRI party name from the given asterisk party name.
825  * \since 1.8
826  *
827  * \param pri_name PRI party name structure.
828  * \param ast_name Asterisk party name structure.
829  *
830  * \return Nothing
831  *
832  * \note Assumes that pri_name has been previously memset to zero.
833  */
834 static void sig_pri_party_name_from_ast(struct pri_party_name *pri_name, const struct ast_party_name *ast_name)
835 {
836         if (!ast_name->valid) {
837                 return;
838         }
839         pri_name->valid = 1;
840         pri_name->presentation = ast_to_pri_presentation(ast_name->presentation);
841         pri_name->char_set = ast_to_pri_char_set(ast_name->char_set);
842         if (!ast_strlen_zero(ast_name->str)) {
843                 ast_copy_string(pri_name->str, ast_name->str, sizeof(pri_name->str));
844         }
845 }
846
847 /*!
848  * \internal
849  * \brief Fill in the PRI party number from the given asterisk party number.
850  * \since 1.8
851  *
852  * \param pri_number PRI party number structure.
853  * \param ast_number Asterisk party number structure.
854  *
855  * \return Nothing
856  *
857  * \note Assumes that pri_number has been previously memset to zero.
858  */
859 static void sig_pri_party_number_from_ast(struct pri_party_number *pri_number, const struct ast_party_number *ast_number)
860 {
861         if (!ast_number->valid) {
862                 return;
863         }
864         pri_number->valid = 1;
865         pri_number->presentation = ast_to_pri_presentation(ast_number->presentation);
866         pri_number->plan = ast_number->plan;
867         if (!ast_strlen_zero(ast_number->str)) {
868                 ast_copy_string(pri_number->str, ast_number->str, sizeof(pri_number->str));
869         }
870 }
871
872 /*!
873  * \internal
874  * \brief Fill in the PRI party id from the given asterisk party id.
875  * \since 1.8
876  *
877  * \param pri_id PRI party id structure.
878  * \param ast_id Asterisk party id structure.
879  *
880  * \return Nothing
881  *
882  * \note Assumes that pri_id has been previously memset to zero.
883  */
884 static void sig_pri_party_id_from_ast(struct pri_party_id *pri_id, const struct ast_party_id *ast_id)
885 {
886         sig_pri_party_name_from_ast(&pri_id->name, &ast_id->name);
887         sig_pri_party_number_from_ast(&pri_id->number, &ast_id->number);
888 #if defined(HAVE_PRI_SUBADDR)
889         sig_pri_party_subaddress_from_ast(&pri_id->subaddress, &ast_id->subaddress);
890 #endif  /* defined(HAVE_PRI_SUBADDR) */
891 }
892
893 /*!
894  * \internal
895  * \brief Update the PRI redirecting information for the current call.
896  * \since 1.8
897  *
898  * \param pvt sig_pri private channel structure.
899  * \param ast Asterisk channel
900  *
901  * \return Nothing
902  *
903  * \note Assumes that the PRI lock is already obtained.
904  */
905 static void sig_pri_redirecting_update(struct sig_pri_chan *pvt, struct ast_channel *ast)
906 {
907         struct pri_party_redirecting pri_redirecting;
908         const struct ast_party_redirecting *ast_redirecting;
909         struct ast_party_id redirecting_from = ast_channel_redirecting_effective_from(ast);
910         struct ast_party_id redirecting_to = ast_channel_redirecting_effective_to(ast);
911         struct ast_party_id redirecting_orig = ast_channel_redirecting_effective_orig(ast);
912
913         memset(&pri_redirecting, 0, sizeof(pri_redirecting));
914         ast_redirecting = ast_channel_redirecting(ast);
915         sig_pri_party_id_from_ast(&pri_redirecting.from, &redirecting_from);
916         sig_pri_party_id_from_ast(&pri_redirecting.to, &redirecting_to);
917         sig_pri_party_id_from_ast(&pri_redirecting.orig_called, &redirecting_orig);
918         pri_redirecting.count = ast_redirecting->count;
919         pri_redirecting.orig_reason = ast_to_pri_reason(ast_redirecting->orig_reason.code);
920         pri_redirecting.reason = ast_to_pri_reason(ast_redirecting->reason.code);
921
922         pri_redirecting_update(pvt->pri->pri, pvt->call, &pri_redirecting);
923 }
924
925 /*!
926  * \internal
927  * \brief Reset DTMF detector.
928  * \since 1.8
929  *
930  * \param p sig_pri channel structure.
931  *
932  * \return Nothing
933  */
934 static void sig_pri_dsp_reset_and_flush_digits(struct sig_pri_chan *p)
935 {
936         if (sig_pri_callbacks.dsp_reset_and_flush_digits) {
937                 sig_pri_callbacks.dsp_reset_and_flush_digits(p->chan_pvt);
938         }
939 }
940
941 static int sig_pri_set_echocanceller(struct sig_pri_chan *p, int enable)
942 {
943         if (sig_pri_callbacks.set_echocanceller) {
944                 return sig_pri_callbacks.set_echocanceller(p->chan_pvt, enable);
945         } else {
946                 return -1;
947         }
948 }
949
950 static void sig_pri_fixup_chans(struct sig_pri_chan *old_chan, struct sig_pri_chan *new_chan)
951 {
952         if (sig_pri_callbacks.fixup_chans) {
953                 sig_pri_callbacks.fixup_chans(old_chan->chan_pvt, new_chan->chan_pvt);
954         }
955 }
956
957 static int sig_pri_play_tone(struct sig_pri_chan *p, enum sig_pri_tone tone)
958 {
959         if (sig_pri_callbacks.play_tone) {
960                 return sig_pri_callbacks.play_tone(p->chan_pvt, tone);
961         } else {
962                 return -1;
963         }
964 }
965
966 static struct ast_channel *sig_pri_new_ast_channel(struct sig_pri_chan *p, int state, int ulaw, int transfercapability, char *exten, const struct ast_channel *requestor)
967 {
968         struct ast_channel *c;
969
970         if (sig_pri_callbacks.new_ast_channel) {
971                 c = sig_pri_callbacks.new_ast_channel(p->chan_pvt, state, ulaw, exten, requestor);
972         } else {
973                 return NULL;
974         }
975         if (!c) {
976                 return NULL;
977         }
978
979         if (!p->owner)
980                 p->owner = c;
981         p->isidlecall = 0;
982         p->alreadyhungup = 0;
983         ast_channel_transfercapability_set(c, transfercapability);
984         pbx_builtin_setvar_helper(c, "TRANSFERCAPABILITY",
985                 ast_transfercapability2str(transfercapability));
986         if (transfercapability & AST_TRANS_CAP_DIGITAL) {
987                 sig_pri_set_digital(p, 1);
988         }
989         if (p->pri) {
990                 ast_mutex_lock(&p->pri->lock);
991                 sig_pri_span_devstate_changed(p->pri);
992                 ast_mutex_unlock(&p->pri->lock);
993         }
994
995         return c;
996 }
997
998 /*!
999  * \internal
1000  * \brief Open the PRI channel media path.
1001  * \since 1.8
1002  *
1003  * \param p Channel private control structure.
1004  *
1005  * \return Nothing
1006  */
1007 static void sig_pri_open_media(struct sig_pri_chan *p)
1008 {
1009         if (p->no_b_channel) {
1010                 return;
1011         }
1012
1013         if (sig_pri_callbacks.open_media) {
1014                 sig_pri_callbacks.open_media(p->chan_pvt);
1015         }
1016 }
1017
1018 /*!
1019  * \internal
1020  * \brief Post an AMI B channel association event.
1021  * \since 1.8
1022  *
1023  * \param p Channel private control structure.
1024  *
1025  * \note Assumes the private and owner are locked.
1026  *
1027  * \return Nothing
1028  */
1029 static void sig_pri_ami_channel_event(struct sig_pri_chan *p)
1030 {
1031         if (sig_pri_callbacks.ami_channel_event) {
1032                 sig_pri_callbacks.ami_channel_event(p->chan_pvt, p->owner);
1033         }
1034 }
1035
1036 struct ast_channel *sig_pri_request(struct sig_pri_chan *p, enum sig_pri_law law, const struct ast_channel *requestor, int transfercapability)
1037 {
1038         struct ast_channel *ast;
1039
1040         ast_debug(1, "%s %d\n", __FUNCTION__, p->channel);
1041
1042         sig_pri_set_outgoing(p, 1);
1043         ast = sig_pri_new_ast_channel(p, AST_STATE_RESERVED, law, transfercapability, p->exten, requestor);
1044         if (!ast) {
1045                 sig_pri_set_outgoing(p, 0);
1046         }
1047         return ast;
1048 }
1049
1050 int pri_is_up(struct sig_pri_span *pri)
1051 {
1052         int x;
1053         for (x = 0; x < SIG_PRI_NUM_DCHANS; x++) {
1054                 if (pri->dchanavail[x] == DCHAN_AVAILABLE)
1055                         return 1;
1056         }
1057         return 0;
1058 }
1059
1060 static const char *pri_order(int level)
1061 {
1062         switch (level) {
1063         case 0:
1064                 return "Primary";
1065         case 1:
1066                 return "Secondary";
1067         case 2:
1068                 return "Tertiary";
1069         case 3:
1070                 return "Quaternary";
1071         default:
1072                 return "<Unknown>";
1073         }
1074 }
1075
1076 /* Returns index of the active dchan */
1077 static int pri_active_dchan_index(struct sig_pri_span *pri)
1078 {
1079         int x;
1080
1081         for (x = 0; x < SIG_PRI_NUM_DCHANS; x++) {
1082                 if ((pri->dchans[x] == pri->pri))
1083                         return x;
1084         }
1085
1086         ast_log(LOG_WARNING, "No active dchan found!\n");
1087         return -1;
1088 }
1089
1090 static void pri_find_dchan(struct sig_pri_span *pri)
1091 {
1092         struct pri *old;
1093         int oldslot = -1;
1094         int newslot = -1;
1095         int idx;
1096
1097         old = pri->pri;
1098         for (idx = 0; idx < SIG_PRI_NUM_DCHANS; ++idx) {
1099                 if (!pri->dchans[idx]) {
1100                         /* No more D channels defined on the span. */
1101                         break;
1102                 }
1103                 if (pri->dchans[idx] == old) {
1104                         oldslot = idx;
1105                 }
1106                 if (newslot < 0 && pri->dchanavail[idx] == DCHAN_AVAILABLE) {
1107                         newslot = idx;
1108                 }
1109         }
1110         /* At this point, idx is a count of how many D-channels are defined on the span. */
1111
1112         if (1 < idx) {
1113                 /* We have several D-channels defined on the span.  (NFAS PRI setup) */
1114                 if (newslot < 0) {
1115                         /* No D-channels available.  Default to the primary D-channel. */
1116                         newslot = 0;
1117
1118                         if (!pri->no_d_channels) {
1119                                 pri->no_d_channels = 1;
1120                                 if (old && oldslot != newslot) {
1121                                         ast_log(LOG_WARNING,
1122                                                 "Span %d: No D-channels up!  Switching selected D-channel from %s to %s.\n",
1123                                                 pri->span, pri_order(oldslot), pri_order(newslot));
1124                                 } else {
1125                                         ast_log(LOG_WARNING, "Span %d: No D-channels up!\n", pri->span);
1126                                 }
1127                         }
1128                 } else {
1129                         pri->no_d_channels = 0;
1130                 }
1131                 if (old && oldslot != newslot) {
1132                         ast_log(LOG_NOTICE,
1133                                 "Switching selected D-channel from %s (fd %d) to %s (fd %d)!\n",
1134                                 pri_order(oldslot), pri->fds[oldslot],
1135                                 pri_order(newslot), pri->fds[newslot]);
1136                 }
1137         } else {
1138                 if (newslot < 0) {
1139                         /* The only D-channel is not up. */
1140                         newslot = 0;
1141
1142                         if (!pri->no_d_channels) {
1143                                 pri->no_d_channels = 1;
1144
1145                                 /*
1146                                  * This is annoying to see on non-persistent layer 2
1147                                  * connections.  Let's not complain in that case.
1148                                  */
1149                                 if (pri->sig != SIG_BRI_PTMP) {
1150                                         ast_log(LOG_WARNING, "Span %d: D-channel is down!\n", pri->span);
1151                                 }
1152                         }
1153                 } else {
1154                         pri->no_d_channels = 0;
1155                 }
1156         }
1157         pri->pri = pri->dchans[newslot];
1158 }
1159
1160 /*!
1161  * \internal
1162  * \brief Determine if a private channel structure is in use.
1163  * \since 1.8
1164  *
1165  * \param pvt Channel to determine if in use.
1166  *
1167  * \return TRUE if the channel is in use.
1168  */
1169 static int sig_pri_is_chan_in_use(struct sig_pri_chan *pvt)
1170 {
1171         return pvt->owner || pvt->call || pvt->allocated || pvt->inalarm
1172                 || pvt->resetting != SIG_PRI_RESET_IDLE;
1173 }
1174
1175 /*!
1176  * \brief Determine if a private channel structure is available.
1177  * \since 1.8
1178  *
1179  * \param pvt Channel to determine if available.
1180  *
1181  * \return TRUE if the channel is available.
1182  */
1183 int sig_pri_is_chan_available(struct sig_pri_chan *pvt)
1184 {
1185         return !sig_pri_is_chan_in_use(pvt)
1186 #if defined(HAVE_PRI_SERVICE_MESSAGES)
1187                 /* And not out-of-service */
1188                 && !pvt->service_status
1189 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
1190                 ;
1191 }
1192
1193 /*!
1194  * \internal
1195  * \brief Obtain the sig_pri owner channel lock if the owner exists.
1196  * \since 1.8
1197  *
1198  * \param pri PRI span control structure.
1199  * \param chanpos Channel position in the span.
1200  *
1201  * \note Assumes the pri->lock is already obtained.
1202  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.
1203  *
1204  * \return Nothing
1205  */
1206 static void sig_pri_lock_owner(struct sig_pri_span *pri, int chanpos)
1207 {
1208         for (;;) {
1209                 if (!pri->pvts[chanpos]->owner) {
1210                         /* There is no owner lock to get. */
1211                         break;
1212                 }
1213                 if (!ast_channel_trylock(pri->pvts[chanpos]->owner)) {
1214                         /* We got the lock */
1215                         break;
1216                 }
1217
1218                 /* Avoid deadlock */
1219                 sig_pri_unlock_private(pri->pvts[chanpos]);
1220                 DEADLOCK_AVOIDANCE(&pri->lock);
1221                 sig_pri_lock_private(pri->pvts[chanpos]);
1222         }
1223 }
1224
1225 /*!
1226  * \internal
1227  * \brief Queue the given frame onto the owner channel.
1228  * \since 1.8
1229  *
1230  * \param pri PRI span control structure.
1231  * \param chanpos Channel position in the span.
1232  * \param frame Frame to queue onto the owner channel.
1233  *
1234  * \note Assumes the pri->lock is already obtained.
1235  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.
1236  *
1237  * \return Nothing
1238  */
1239 static void pri_queue_frame(struct sig_pri_span *pri, int chanpos, struct ast_frame *frame)
1240 {
1241         sig_pri_lock_owner(pri, chanpos);
1242         if (pri->pvts[chanpos]->owner) {
1243                 ast_queue_frame(pri->pvts[chanpos]->owner, frame);
1244                 ast_channel_unlock(pri->pvts[chanpos]->owner);
1245         }
1246 }
1247
1248 /*!
1249  * \internal
1250  * \brief Queue a control frame of the specified subclass onto the owner channel.
1251  * \since 1.8
1252  *
1253  * \param pri PRI span control structure.
1254  * \param chanpos Channel position in the span.
1255  * \param subclass Control frame subclass to queue onto the owner channel.
1256  *
1257  * \note Assumes the pri->lock is already obtained.
1258  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.
1259  *
1260  * \return Nothing
1261  */
1262 static void pri_queue_control(struct sig_pri_span *pri, int chanpos, int subclass)
1263 {
1264         struct ast_frame f = {AST_FRAME_CONTROL, };
1265         struct sig_pri_chan *p = pri->pvts[chanpos];
1266
1267         if (sig_pri_callbacks.queue_control) {
1268                 sig_pri_callbacks.queue_control(p->chan_pvt, subclass);
1269         }
1270
1271         f.subclass.integer = subclass;
1272         pri_queue_frame(pri, chanpos, &f);
1273 }
1274
1275 /*!
1276  * \internal
1277  * \brief Queue a PVT_CAUSE_CODE frame onto the owner channel.
1278  * \since 11
1279  *
1280  * \param pri PRI span control structure.
1281  * \param chanpos Channel position in the span.
1282  * \param cause String describing the cause to be placed into the frame.
1283  *
1284  * \note Assumes the pri->lock is already obtained.
1285  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.
1286  *
1287  * \return Nothing
1288  */
1289 static void pri_queue_pvt_cause_data(struct sig_pri_span *pri, int chanpos, const char *cause, int ast_cause)
1290 {
1291         struct ast_channel *chan;
1292         struct ast_control_pvt_cause_code *cause_code;
1293
1294         sig_pri_lock_owner(pri, chanpos);
1295         chan = pri->pvts[chanpos]->owner;
1296         if (chan) {
1297                 int datalen = sizeof(*cause_code) + strlen(cause);
1298                 cause_code = ast_alloca(datalen);
1299                 cause_code->ast_cause = ast_cause;
1300                 ast_copy_string(cause_code->chan_name, ast_channel_name(chan), AST_CHANNEL_NAME);
1301                 ast_copy_string(cause_code->code, cause, datalen + 1 - sizeof(*cause_code));
1302                 ast_queue_control_data(chan, AST_CONTROL_PVT_CAUSE_CODE, cause_code, datalen);
1303                 ast_channel_hangupcause_hash_set(chan, cause_code, datalen);
1304                 ast_channel_unlock(chan);
1305         }
1306 }
1307
1308 /*!
1309  * \internal
1310  * \brief Find the channel associated with the libpri call.
1311  * \since 10.0
1312  *
1313  * \param pri PRI span control structure.
1314  * \param call LibPRI opaque call pointer to find.
1315  *
1316  * \note Assumes the pri->lock is already obtained.
1317  *
1318  * \retval array-index into private pointer array on success.
1319  * \retval -1 on error.
1320  */
1321 static int pri_find_principle_by_call(struct sig_pri_span *pri, q931_call *call)
1322 {
1323         int idx;
1324
1325         if (!call) {
1326                 /* Cannot find a call without a call. */
1327                 return -1;
1328         }
1329         for (idx = 0; idx < pri->numchans; ++idx) {
1330                 if (pri->pvts[idx] && pri->pvts[idx]->call == call) {
1331                         /* Found the principle */
1332                         return idx;
1333                 }
1334         }
1335         return -1;
1336 }
1337
1338 /*!
1339  * \internal
1340  * \brief Kill the call.
1341  * \since 10.0
1342  *
1343  * \param pri PRI span control structure.
1344  * \param call LibPRI opaque call pointer to find.
1345  * \param cause Reason call was killed.
1346  *
1347  * \note Assumes the pvt->pri->lock is already obtained.
1348  *
1349  * \return Nothing
1350  */
1351 static void sig_pri_kill_call(struct sig_pri_span *pri, q931_call *call, int cause)
1352 {
1353         int chanpos;
1354
1355         chanpos = pri_find_principle_by_call(pri, call);
1356         if (chanpos < 0) {
1357                 pri_hangup(pri->pri, call, cause);
1358                 return;
1359         }
1360         sig_pri_lock_private(pri->pvts[chanpos]);
1361         if (!pri->pvts[chanpos]->owner) {
1362                 pri_hangup(pri->pri, call, cause);
1363                 pri->pvts[chanpos]->call = NULL;
1364                 sig_pri_unlock_private(pri->pvts[chanpos]);
1365                 sig_pri_span_devstate_changed(pri);
1366                 return;
1367         }
1368         ast_channel_hangupcause_set(pri->pvts[chanpos]->owner, cause);
1369         pri_queue_control(pri, chanpos, AST_CONTROL_HANGUP);
1370         sig_pri_unlock_private(pri->pvts[chanpos]);
1371 }
1372
1373 /*!
1374  * \internal
1375  * \brief Find the private structure for the libpri call.
1376  *
1377  * \param pri PRI span control structure.
1378  * \param channel LibPRI encoded channel ID.
1379  * \param call LibPRI opaque call pointer.
1380  *
1381  * \note Assumes the pri->lock is already obtained.
1382  *
1383  * \retval array-index into private pointer array on success.
1384  * \retval -1 on error.
1385  */
1386 static int pri_find_principle(struct sig_pri_span *pri, int channel, q931_call *call)
1387 {
1388         int x;
1389         int span;
1390         int principle;
1391         int prioffset;
1392
1393         if (channel < 0) {
1394                 /* Channel is not picked yet. */
1395                 return -1;
1396         }
1397
1398         prioffset = PRI_CHANNEL(channel);
1399         if (!prioffset || (channel & PRI_HELD_CALL)) {
1400                 /* Find the call waiting call or held call. */
1401                 return pri_find_principle_by_call(pri, call);
1402         }
1403
1404         span = PRI_SPAN(channel);
1405         if (!(channel & PRI_EXPLICIT)) {
1406                 int index;
1407
1408                 index = pri_active_dchan_index(pri);
1409                 if (index == -1) {
1410                         return -1;
1411                 }
1412                 span = pri->dchan_logical_span[index];
1413         }
1414
1415         principle = -1;
1416         for (x = 0; x < pri->numchans; x++) {
1417                 if (pri->pvts[x]
1418                         && pri->pvts[x]->prioffset == prioffset
1419                         && pri->pvts[x]->logicalspan == span
1420                         && !pri->pvts[x]->no_b_channel) {
1421                         principle = x;
1422                         break;
1423                 }
1424         }
1425
1426         return principle;
1427 }
1428
1429 /*!
1430  * \internal
1431  * \brief Fixup the private structure associated with the libpri call.
1432  *
1433  * \param pri PRI span control structure.
1434  * \param principle Array-index into private array to move call to if not already there.
1435  * \param call LibPRI opaque call pointer to find if need to move call.
1436  *
1437  * \note Assumes the pri->lock is already obtained.
1438  *
1439  * \retval principle on success.
1440  * \retval -1 on error.
1441  */
1442 static int pri_fixup_principle(struct sig_pri_span *pri, int principle, q931_call *call)
1443 {
1444         int x;
1445
1446         if (principle < 0 || pri->numchans <= principle) {
1447                 /* Out of rannge */
1448                 return -1;
1449         }
1450         if (!call) {
1451                 /* No call */
1452                 return principle;
1453         }
1454         if (pri->pvts[principle] && pri->pvts[principle]->call == call) {
1455                 /* Call is already on the specified principle. */
1456                 return principle;
1457         }
1458
1459         /* Find the old principle location. */
1460         for (x = 0; x < pri->numchans; x++) {
1461                 struct sig_pri_chan *new_chan;
1462                 struct sig_pri_chan *old_chan;
1463
1464                 if (!pri->pvts[x] || pri->pvts[x]->call != call) {
1465                         continue;
1466                 }
1467
1468                 /* Found our call */
1469                 new_chan = pri->pvts[principle];
1470                 old_chan = pri->pvts[x];
1471
1472                 /* Get locks to safely move to the new private structure. */
1473                 sig_pri_lock_private(old_chan);
1474                 sig_pri_lock_owner(pri, x);
1475                 sig_pri_lock_private(new_chan);
1476
1477                 ast_verb(3, "Moving call (%s) from channel %d to %d.\n",
1478                         old_chan->owner ? ast_channel_name(old_chan->owner) : "",
1479                         old_chan->channel, new_chan->channel);
1480                 if (!sig_pri_is_chan_available(new_chan)) {
1481                         ast_log(LOG_WARNING,
1482                                 "Can't move call (%s) from channel %d to %d.  It is already in use.\n",
1483                                 old_chan->owner ? ast_channel_name(old_chan->owner) : "",
1484                                 old_chan->channel, new_chan->channel);
1485                         sig_pri_unlock_private(new_chan);
1486                         if (old_chan->owner) {
1487                                 ast_channel_unlock(old_chan->owner);
1488                         }
1489                         sig_pri_unlock_private(old_chan);
1490                         return -1;
1491                 }
1492
1493                 sig_pri_fixup_chans(old_chan, new_chan);
1494
1495                 /* Fix it all up now */
1496                 new_chan->owner = old_chan->owner;
1497                 old_chan->owner = NULL;
1498
1499                 new_chan->call = old_chan->call;
1500                 old_chan->call = NULL;
1501
1502                 /* Transfer flags from the old channel. */
1503 #if defined(HAVE_PRI_AOC_EVENTS)
1504                 new_chan->aoc_s_request_invoke_id_valid = old_chan->aoc_s_request_invoke_id_valid;
1505                 new_chan->waiting_for_aoce = old_chan->waiting_for_aoce;
1506                 new_chan->holding_aoce = old_chan->holding_aoce;
1507 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
1508                 new_chan->alreadyhungup = old_chan->alreadyhungup;
1509                 new_chan->isidlecall = old_chan->isidlecall;
1510                 new_chan->progress = old_chan->progress;
1511                 new_chan->allocated = old_chan->allocated;
1512                 new_chan->outgoing = old_chan->outgoing;
1513                 new_chan->digital = old_chan->digital;
1514 #if defined(HAVE_PRI_CALL_WAITING)
1515                 new_chan->is_call_waiting = old_chan->is_call_waiting;
1516 #endif  /* defined(HAVE_PRI_CALL_WAITING) */
1517
1518 #if defined(HAVE_PRI_AOC_EVENTS)
1519                 old_chan->aoc_s_request_invoke_id_valid = 0;
1520                 old_chan->waiting_for_aoce = 0;
1521                 old_chan->holding_aoce = 0;
1522 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
1523                 old_chan->alreadyhungup = 0;
1524                 old_chan->isidlecall = 0;
1525                 old_chan->progress = 0;
1526                 old_chan->allocated = 0;
1527                 old_chan->outgoing = 0;
1528                 old_chan->digital = 0;
1529 #if defined(HAVE_PRI_CALL_WAITING)
1530                 old_chan->is_call_waiting = 0;
1531 #endif  /* defined(HAVE_PRI_CALL_WAITING) */
1532
1533                 /* More stuff to transfer to the new channel. */
1534                 new_chan->call_level = old_chan->call_level;
1535                 old_chan->call_level = SIG_PRI_CALL_LEVEL_IDLE;
1536 #if defined(HAVE_PRI_REVERSE_CHARGE)
1537                 new_chan->reverse_charging_indication = old_chan->reverse_charging_indication;
1538 #endif  /* defined(HAVE_PRI_REVERSE_CHARGE) */
1539 #if defined(HAVE_PRI_SETUP_KEYPAD)
1540                 strcpy(new_chan->keypad_digits, old_chan->keypad_digits);
1541 #endif  /* defined(HAVE_PRI_SETUP_KEYPAD) */
1542                 strcpy(new_chan->deferred_digits, old_chan->deferred_digits);
1543                 strcpy(new_chan->moh_suggested, old_chan->moh_suggested);
1544                 new_chan->moh_state = old_chan->moh_state;
1545                 old_chan->moh_state = SIG_PRI_MOH_STATE_IDLE;
1546
1547 #if defined(HAVE_PRI_AOC_EVENTS)
1548                 new_chan->aoc_s_request_invoke_id = old_chan->aoc_s_request_invoke_id;
1549                 new_chan->aoc_e = old_chan->aoc_e;
1550 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
1551                 strcpy(new_chan->user_tag, old_chan->user_tag);
1552
1553                 if (new_chan->no_b_channel) {
1554                         /* Copy the real channel configuration to the no B channel interface. */
1555                         new_chan->hidecallerid = old_chan->hidecallerid;
1556                         new_chan->hidecalleridname = old_chan->hidecalleridname;
1557                         new_chan->immediate = old_chan->immediate;
1558                         new_chan->priexclusive = old_chan->priexclusive;
1559                         new_chan->priindication_oob = old_chan->priindication_oob;
1560                         new_chan->use_callerid = old_chan->use_callerid;
1561                         new_chan->use_callingpres = old_chan->use_callingpres;
1562                         new_chan->stripmsd = old_chan->stripmsd;
1563                         strcpy(new_chan->context, old_chan->context);
1564                         strcpy(new_chan->mohinterpret, old_chan->mohinterpret);
1565
1566                         /* Become a member of the old channel span/trunk-group. */
1567                         new_chan->logicalspan = old_chan->logicalspan;
1568                         new_chan->mastertrunkgroup = old_chan->mastertrunkgroup;
1569                 } else if (old_chan->no_b_channel) {
1570                         /*
1571                          * We are transitioning from a held/call-waiting channel to a
1572                          * real channel so we need to make sure that the media path is
1573                          * open.  (Needed especially if the channel is natively
1574                          * bridged.)
1575                          */
1576                         sig_pri_open_media(new_chan);
1577                 }
1578
1579                 if (new_chan->owner) {
1580                         sig_pri_ami_channel_event(new_chan);
1581                 }
1582
1583                 sig_pri_unlock_private(old_chan);
1584                 if (new_chan->owner) {
1585                         ast_channel_unlock(new_chan->owner);
1586                 }
1587                 sig_pri_unlock_private(new_chan);
1588
1589                 return principle;
1590         }
1591         ast_verb(3, "Call specified, but not found.\n");
1592         return -1;
1593 }
1594
1595 /*!
1596  * \internal
1597  * \brief Find and fixup the private structure associated with the libpri call.
1598  *
1599  * \param pri PRI span control structure.
1600  * \param channel LibPRI encoded channel ID.
1601  * \param call LibPRI opaque call pointer.
1602  *
1603  * \details
1604  * This is a combination of pri_find_principle() and pri_fixup_principle()
1605  * to reduce code redundancy and to make handling several PRI_EVENT_xxx's
1606  * consistent for the current architecture.
1607  *
1608  * \note Assumes the pri->lock is already obtained.
1609  *
1610  * \retval array-index into private pointer array on success.
1611  * \retval -1 on error.
1612  */
1613 static int pri_find_fixup_principle(struct sig_pri_span *pri, int channel, q931_call *call)
1614 {
1615         int chanpos;
1616
1617         chanpos = pri_find_principle(pri, channel, call);
1618         if (chanpos < 0) {
1619                 ast_log(LOG_WARNING, "Span %d: PRI requested channel %d/%d is unconfigured.\n",
1620                         pri->span, PRI_SPAN(channel), PRI_CHANNEL(channel));
1621                 sig_pri_kill_call(pri, call, PRI_CAUSE_IDENTIFIED_CHANNEL_NOTEXIST);
1622                 return -1;
1623         }
1624         chanpos = pri_fixup_principle(pri, chanpos, call);
1625         if (chanpos < 0) {
1626                 ast_log(LOG_WARNING, "Span %d: PRI requested channel %d/%d is not available.\n",
1627                         pri->span, PRI_SPAN(channel), PRI_CHANNEL(channel));
1628                 /*
1629                  * Using Q.931 section 5.2.3.1 b) as the reason for picking
1630                  * PRI_CAUSE_CHANNEL_UNACCEPTABLE.  Receiving a
1631                  * PRI_CAUSE_REQUESTED_CHAN_UNAVAIL would cause us to restart
1632                  * that channel (which is not specified by Q.931) and kill some
1633                  * other call which would be bad.
1634                  */
1635                 sig_pri_kill_call(pri, call, PRI_CAUSE_CHANNEL_UNACCEPTABLE);
1636                 return -1;
1637         }
1638         return chanpos;
1639 }
1640
1641 static char * redirectingreason2str(int redirectingreason)
1642 {
1643         switch (redirectingreason) {
1644         case 0:
1645                 return "UNKNOWN";
1646         case 1:
1647                 return "BUSY";
1648         case 2:
1649                 return "NO_REPLY";
1650         case 0xF:
1651                 return "UNCONDITIONAL";
1652         default:
1653                 return "NOREDIRECT";
1654         }
1655 }
1656
1657 static char *dialplan2str(int dialplan)
1658 {
1659         if (dialplan == -1) {
1660                 return("Dynamically set dialplan in ISDN");
1661         }
1662         return (pri_plan2str(dialplan));
1663 }
1664
1665 /*!
1666  * \internal
1667  * \brief Apply numbering plan prefix to the given number.
1668  *
1669  * \param buf Buffer to put number into.
1670  * \param size Size of given buffer.
1671  * \param pri PRI span control structure.
1672  * \param number Number to apply numbering plan.
1673  * \param plan Numbering plan to apply.
1674  *
1675  * \return Nothing
1676  */
1677 static void apply_plan_to_number(char *buf, size_t size, const struct sig_pri_span *pri, const char *number, int plan)
1678 {
1679         switch (plan) {
1680         case PRI_INTERNATIONAL_ISDN:            /* Q.931 dialplan == 0x11 international dialplan => prepend international prefix digits */
1681                 snprintf(buf, size, "%s%s", pri->internationalprefix, number);
1682                 break;
1683         case PRI_NATIONAL_ISDN:                 /* Q.931 dialplan == 0x21 national dialplan => prepend national prefix digits */
1684                 snprintf(buf, size, "%s%s", pri->nationalprefix, number);
1685                 break;
1686         case PRI_LOCAL_ISDN:                    /* Q.931 dialplan == 0x41 local dialplan => prepend local prefix digits */
1687                 snprintf(buf, size, "%s%s", pri->localprefix, number);
1688                 break;
1689         case PRI_PRIVATE:                       /* Q.931 dialplan == 0x49 private dialplan => prepend private prefix digits */
1690                 snprintf(buf, size, "%s%s", pri->privateprefix, number);
1691                 break;
1692         case PRI_UNKNOWN:                       /* Q.931 dialplan == 0x00 unknown dialplan => prepend unknown prefix digits */
1693                 snprintf(buf, size, "%s%s", pri->unknownprefix, number);
1694                 break;
1695         default:                                /* other Q.931 dialplan => don't twiddle with callingnum */
1696                 snprintf(buf, size, "%s", number);
1697                 break;
1698         }
1699 }
1700
1701 /*!
1702  * \internal
1703  * \brief Apply numbering plan prefix to the given number if the number exists.
1704  *
1705  * \param buf Buffer to put number into.
1706  * \param size Size of given buffer.
1707  * \param pri PRI span control structure.
1708  * \param number Number to apply numbering plan.
1709  * \param plan Numbering plan to apply.
1710  *
1711  * \return Nothing
1712  */
1713 static void apply_plan_to_existing_number(char *buf, size_t size, const struct sig_pri_span *pri, const char *number, int plan)
1714 {
1715         /* Make sure a number exists so the prefix isn't placed on an empty string. */
1716         if (ast_strlen_zero(number)) {
1717                 if (size) {
1718                         *buf = '\0';
1719                 }
1720                 return;
1721         }
1722         apply_plan_to_number(buf, size, pri, number, plan);
1723 }
1724
1725 /*!
1726  * \internal
1727  * \brief Restart the next channel we think is idle on the span.
1728  *
1729  * \param pri PRI span control structure.
1730  *
1731  * \note Assumes the pri->lock is already obtained.
1732  *
1733  * \return Nothing
1734  */
1735 static void pri_check_restart(struct sig_pri_span *pri)
1736 {
1737 #if defined(HAVE_PRI_SERVICE_MESSAGES)
1738         unsigned why;
1739 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
1740
1741         for (++pri->resetpos; pri->resetpos < pri->numchans; ++pri->resetpos) {
1742                 if (!pri->pvts[pri->resetpos]
1743                         || pri->pvts[pri->resetpos]->no_b_channel
1744                         || sig_pri_is_chan_in_use(pri->pvts[pri->resetpos])) {
1745                         continue;
1746                 }
1747 #if defined(HAVE_PRI_SERVICE_MESSAGES)
1748                 why = pri->pvts[pri->resetpos]->service_status;
1749                 if (why) {
1750                         ast_log(LOG_NOTICE,
1751                                 "Span %d: channel %d out-of-service (reason: %s), not sending RESTART\n",
1752                                 pri->span, pri->pvts[pri->resetpos]->channel,
1753                                 (why & SRVST_FAREND) ? (why & SRVST_NEAREND) ? "both ends" : "far end" : "near end");
1754                         continue;
1755                 }
1756 #endif  /* defined(HAVE_PRI_SERVICE_MESSAGES) */
1757                 break;
1758         }
1759         if (pri->resetpos < pri->numchans) {
1760                 /* Mark the channel as resetting and restart it */
1761                 pri->pvts[pri->resetpos]->resetting = SIG_PRI_RESET_ACTIVE;
1762                 pri_reset(pri->pri, PVT_TO_CHANNEL(pri->pvts[pri->resetpos]));
1763         } else {
1764                 pri->resetting = 0;
1765                 time(&pri->lastreset);
1766                 sig_pri_span_devstate_changed(pri);
1767         }
1768 }
1769
1770 #if defined(HAVE_PRI_CALL_WAITING)
1771 /*!
1772  * \internal
1773  * \brief Init the private channel configuration using the span controller.
1774  * \since 1.8
1775  *
1776  * \param pvt Channel to init the configuration.
1777  * \param pri PRI span control structure.
1778  *
1779  * \note Assumes the pri->lock is already obtained.
1780  *
1781  * \return Nothing
1782  */
1783 static void sig_pri_init_config(struct sig_pri_chan *pvt, struct sig_pri_span *pri)
1784 {
1785         pvt->stripmsd = pri->ch_cfg.stripmsd;
1786         pvt->hidecallerid = pri->ch_cfg.hidecallerid;
1787         pvt->hidecalleridname = pri->ch_cfg.hidecalleridname;
1788         pvt->immediate = pri->ch_cfg.immediate;
1789         pvt->priexclusive = pri->ch_cfg.priexclusive;
1790         pvt->priindication_oob = pri->ch_cfg.priindication_oob;
1791         pvt->use_callerid = pri->ch_cfg.use_callerid;
1792         pvt->use_callingpres = pri->ch_cfg.use_callingpres;
1793         ast_copy_string(pvt->context, pri->ch_cfg.context, sizeof(pvt->context));
1794         ast_copy_string(pvt->mohinterpret, pri->ch_cfg.mohinterpret, sizeof(pvt->mohinterpret));
1795
1796         if (sig_pri_callbacks.init_config) {
1797                 sig_pri_callbacks.init_config(pvt->chan_pvt, pri);
1798         }
1799 }
1800 #endif  /* defined(HAVE_PRI_CALL_WAITING) */
1801
1802 /*!
1803  * \internal
1804  * \brief Find an empty B-channel interface to use.
1805  *
1806  * \param pri PRI span control structure.
1807  * \param backwards TRUE if the search starts from higher channels.
1808  *
1809  * \note Assumes the pri->lock is already obtained.
1810  *
1811  * \retval array-index into private pointer array on success.
1812  * \retval -1 on error.
1813  */
1814 static int pri_find_empty_chan(struct sig_pri_span *pri, int backwards)
1815 {
1816         int x;
1817         if (backwards)
1818                 x = pri->numchans;
1819         else
1820                 x = 0;
1821         for (;;) {
1822                 if (backwards && (x < 0))
1823                         break;
1824                 if (!backwards && (x >= pri->numchans))
1825                         break;
1826                 if (pri->pvts[x]
1827                         && !pri->pvts[x]->no_b_channel
1828                         && sig_pri_is_chan_available(pri->pvts[x])) {
1829                         ast_debug(1, "Found empty available channel %d/%d\n",
1830                                 pri->pvts[x]->logicalspan, pri->pvts[x]->prioffset);
1831                         return x;
1832                 }
1833                 if (backwards)
1834                         x--;
1835                 else
1836                         x++;
1837         }
1838         return -1;
1839 }
1840
1841 #if defined(HAVE_PRI_CALL_HOLD)
1842 /*!
1843  * \internal
1844  * \brief Find or create an empty no-B-channel interface to use.
1845  * \since 1.8
1846  *
1847  * \param pri PRI span control structure.
1848  *
1849  * \note Assumes the pri->lock is already obtained.
1850  *
1851  * \retval array-index into private pointer array on success.
1852  * \retval -1 on error.
1853  */
1854 static int pri_find_empty_nobch(struct sig_pri_span *pri)
1855 {
1856         int idx;
1857
1858         for (idx = 0; idx < pri->numchans; ++idx) {
1859                 if (pri->pvts[idx]
1860                         && pri->pvts[idx]->no_b_channel
1861                         && sig_pri_is_chan_available(pri->pvts[idx])) {
1862                         ast_debug(1, "Found empty available no B channel interface\n");
1863                         return idx;
1864                 }
1865         }
1866
1867         /* Need to create a new interface. */
1868         if (sig_pri_callbacks.new_nobch_intf) {
1869                 idx = sig_pri_callbacks.new_nobch_intf(pri);
1870         } else {
1871                 idx = -1;
1872         }
1873         return idx;
1874 }
1875 #endif  /* defined(HAVE_PRI_CALL_HOLD) */
1876
1877 static void *do_idle_thread(void *v_pvt)
1878 {
1879         struct sig_pri_chan *pvt = v_pvt;
1880         struct ast_channel *chan = pvt->owner;
1881         struct ast_frame *f;
1882         char ex[80];
1883         /* Wait up to 30 seconds for an answer */
1884         int timeout_ms = 30000;
1885         int ms;
1886         struct timeval start;
1887         struct ast_callid *callid;
1888
1889         if ((callid = ast_channel_callid(chan))) {
1890                 ast_callid_threadassoc_add(callid);
1891                 callid = ast_callid_unref(callid);
1892         }
1893
1894         ast_verb(3, "Initiating idle call on channel %s\n", ast_channel_name(chan));
1895         snprintf(ex, sizeof(ex), "%d/%s", pvt->channel, pvt->pri->idledial);
1896         if (ast_call(chan, ex, 0)) {
1897                 ast_log(LOG_WARNING, "Idle dial failed on '%s' to '%s'\n", ast_channel_name(chan), ex);
1898                 ast_hangup(chan);
1899                 return NULL;
1900         }
1901         start = ast_tvnow();
1902         while ((ms = ast_remaining_ms(start, timeout_ms))) {
1903                 if (ast_waitfor(chan, ms) <= 0) {
1904                         break;
1905                 }
1906
1907                 f = ast_read(chan);
1908                 if (!f) {
1909                         /* Got hangup */
1910                         break;
1911                 }
1912                 if (f->frametype == AST_FRAME_CONTROL) {
1913                         switch (f->subclass.integer) {
1914                         case AST_CONTROL_ANSWER:
1915                                 /* Launch the PBX */
1916                                 ast_channel_exten_set(chan, pvt->pri->idleext);
1917                                 ast_channel_context_set(chan, pvt->pri->idlecontext);
1918                                 ast_channel_priority_set(chan, 1);
1919                                 ast_verb(4, "Idle channel '%s' answered, sending to %s@%s\n", ast_channel_name(chan), ast_channel_exten(chan), ast_channel_context(chan));
1920                                 ast_pbx_run(chan);
1921                                 /* It's already hungup, return immediately */
1922                                 return NULL;
1923                         case AST_CONTROL_BUSY:
1924                                 ast_verb(4, "Idle channel '%s' busy, waiting...\n", ast_channel_name(chan));
1925                                 break;
1926                         case AST_CONTROL_CONGESTION:
1927                                 ast_verb(4, "Idle channel '%s' congested, waiting...\n", ast_channel_name(chan));
1928                                 break;
1929                         };
1930                 }
1931                 ast_frfree(f);
1932         }
1933         /* Hangup the channel since nothing happend */
1934         ast_hangup(chan);
1935         return NULL;
1936 }
1937
1938 static void *pri_ss_thread(void *data)
1939 {
1940         struct sig_pri_chan *p = data;
1941         struct ast_channel *chan = p->owner;
1942         char exten[AST_MAX_EXTENSION];
1943         int res;
1944         int len;
1945         int timeout;
1946         struct ast_callid *callid;
1947
1948         if (!chan) {
1949                 /* We lost the owner before we could get started. */
1950                 return NULL;
1951         }
1952
1953         if ((callid = ast_channel_callid(chan))) {
1954                 ast_callid_threadassoc_add(callid);
1955                 ast_callid_unref(callid);
1956         }
1957
1958         /*
1959          * In the bizarre case where the channel has become a zombie before we
1960          * even get started here, abort safely.
1961          */
1962         if (!ast_channel_tech_pvt(chan)) {
1963                 ast_log(LOG_WARNING, "Channel became a zombie before simple switch could be started (%s)\n", ast_channel_name(chan));
1964                 ast_hangup(chan);
1965                 return NULL;
1966         }
1967
1968         ast_verb(3, "Starting simple switch on '%s'\n", ast_channel_name(chan));
1969
1970         sig_pri_dsp_reset_and_flush_digits(p);
1971
1972         /* Now loop looking for an extension */
1973         ast_copy_string(exten, p->exten, sizeof(exten));
1974         len = strlen(exten);
1975         res = 0;
1976         while ((len < AST_MAX_EXTENSION-1) && ast_matchmore_extension(chan, ast_channel_context(chan), exten, 1, p->cid_num)) {
1977                 if (len && !ast_ignore_pattern(ast_channel_context(chan), exten))
1978                         sig_pri_play_tone(p, -1);
1979                 else
1980                         sig_pri_play_tone(p, SIG_PRI_TONE_DIALTONE);
1981                 if (ast_exists_extension(chan, ast_channel_context(chan), exten, 1, p->cid_num))
1982                         timeout = pri_matchdigittimeout;
1983                 else
1984                         timeout = pri_gendigittimeout;
1985                 res = ast_waitfordigit(chan, timeout);
1986                 if (res < 0) {
1987                         ast_debug(1, "waitfordigit returned < 0...\n");
1988                         ast_hangup(chan);
1989                         return NULL;
1990                 } else if (res) {
1991                         exten[len++] = res;
1992                         exten[len] = '\0';
1993                 } else
1994                         break;
1995         }
1996         /* if no extension was received ('unspecified') on overlap call, use the 's' extension */
1997         if (ast_strlen_zero(exten)) {
1998                 ast_verb(3, "Going to extension s|1 because of empty extension received on overlap call\n");
1999                 exten[0] = 's';
2000                 exten[1] = '\0';
2001         } else {
2002                 ast_free(ast_channel_dialed(chan)->number.str);
2003                 ast_channel_dialed(chan)->number.str = ast_strdup(exten);
2004
2005                 if (p->pri->append_msn_to_user_tag && p->pri->nodetype != PRI_NETWORK) {
2006                         /*
2007                          * Update the user tag for party id's from this device for this call
2008                          * now that we have a complete MSN from the network.
2009                          */
2010                         snprintf(p->user_tag, sizeof(p->user_tag), "%s_%s", p->pri->initial_user_tag,
2011                                 exten);
2012                         ast_free(ast_channel_caller(chan)->id.tag);
2013                         ast_channel_caller(chan)->id.tag = ast_strdup(p->user_tag);
2014                 }
2015         }
2016         sig_pri_play_tone(p, -1);
2017         if (ast_exists_extension(chan, ast_channel_context(chan), exten, 1, p->cid_num)) {
2018                 /* Start the real PBX */
2019                 ast_channel_exten_set(chan, exten);
2020                 sig_pri_dsp_reset_and_flush_digits(p);
2021 #if defined(ISSUE_16789)
2022                 /*
2023                  * Conditionaled out this code to effectively revert the Mantis
2024                  * issue 16789 change.  It breaks overlap dialing through
2025                  * Asterisk.  There is not enough information available at this
2026                  * point to know if dialing is complete.  The
2027                  * ast_exists_extension(), ast_matchmore_extension(), and
2028                  * ast_canmatch_extension() calls are not adequate to detect a
2029                  * dial through extension pattern of "_9!".
2030                  *
2031                  * Workaround is to use the dialplan Proceeding() application
2032                  * early on non-dial through extensions.
2033                  */
2034                 if ((p->pri->overlapdial & DAHDI_OVERLAPDIAL_INCOMING)
2035                         && !ast_matchmore_extension(chan, ast_channel_context(chan), exten, 1, p->cid_num)) {
2036                         sig_pri_lock_private(p);
2037                         if (p->pri->pri) {
2038                                 pri_grab(p, p->pri);
2039                                 if (p->call_level < SIG_PRI_CALL_LEVEL_PROCEEDING) {
2040                                         p->call_level = SIG_PRI_CALL_LEVEL_PROCEEDING;
2041                                 }
2042                                 pri_proceeding(p->pri->pri, p->call, PVT_TO_CHANNEL(p), 0);
2043                                 pri_rel(p->pri);
2044                         }
2045                         sig_pri_unlock_private(p);
2046                 }
2047 #endif  /* defined(ISSUE_16789) */
2048
2049                 sig_pri_set_echocanceller(p, 1);
2050                 ast_setstate(chan, AST_STATE_RING);
2051                 res = ast_pbx_run(chan);
2052                 if (res) {
2053                         ast_log(LOG_WARNING, "PBX exited non-zero!\n");
2054                 }
2055         } else {
2056                 ast_debug(1, "No such possible extension '%s' in context '%s'\n", exten, ast_channel_context(chan));
2057                 ast_channel_hangupcause_set(chan, AST_CAUSE_UNALLOCATED);
2058                 ast_hangup(chan);
2059                 p->exten[0] = '\0';
2060                 /* Since we send release complete here, we won't get one */
2061                 p->call = NULL;
2062                 ast_mutex_lock(&p->pri->lock);
2063                 sig_pri_span_devstate_changed(p->pri);
2064                 ast_mutex_unlock(&p->pri->lock);
2065         }
2066         return NULL;
2067 }
2068
2069 void pri_event_alarm(struct sig_pri_span *pri, int index, int before_start_pri)
2070 {
2071         pri->dchanavail[index] &= ~(DCHAN_NOTINALARM | DCHAN_UP);
2072         if (!before_start_pri) {
2073                 pri_find_dchan(pri);
2074         }
2075 }
2076
2077 void pri_event_noalarm(struct sig_pri_span *pri, int index, int before_start_pri)
2078 {
2079         pri->dchanavail[index] |= DCHAN_NOTINALARM;
2080         if (!before_start_pri)
2081                 pri_restart(pri->dchans[index]);
2082 }
2083
2084 /*!
2085  * \internal
2086  * \brief Convert libpri party name into asterisk party name.
2087  * \since 1.8
2088  *
2089  * \param ast_name Asterisk party name structure to fill.  Must already be set initialized.
2090  * \param pri_name libpri party name structure containing source information.
2091  *
2092  * \note The filled in ast_name structure needs to be destroyed by
2093  * ast_party_name_free() when it is no longer needed.
2094  *
2095  * \return Nothing
2096  */
2097 static void sig_pri_party_name_convert(struct ast_party_name *ast_name, const struct pri_party_name *pri_name)
2098 {
2099         ast_name->str = ast_strdup(pri_name->str);
2100         ast_name->char_set = pri_to_ast_char_set(pri_name->char_set);
2101         ast_name->presentation = pri_to_ast_presentation(pri_name->presentation);
2102         ast_name->valid = 1;
2103 }
2104
2105 /*!
2106  * \internal
2107  * \brief Convert libpri party number into asterisk party number.
2108  * \since 1.8
2109  *
2110  * \param ast_number Asterisk party number structure to fill.  Must already be set initialized.
2111  * \param pri_number libpri party number structure containing source information.
2112  * \param pri PRI span control structure.
2113  *
2114  * \note The filled in ast_number structure needs to be destroyed by
2115  * ast_party_number_free() when it is no longer needed.
2116  *
2117  * \return Nothing
2118  */
2119 static void sig_pri_party_number_convert(struct ast_party_number *ast_number, const struct pri_party_number *pri_number, struct sig_pri_span *pri)
2120 {
2121         char number[AST_MAX_EXTENSION];
2122
2123         apply_plan_to_existing_number(number, sizeof(number), pri, pri_number->str,
2124                 pri_number->plan);
2125         ast_number->str = ast_strdup(number);
2126         ast_number->plan = pri_number->plan;
2127         ast_number->presentation = pri_to_ast_presentation(pri_number->presentation);
2128         ast_number->valid = 1;
2129 }
2130
2131 /*!
2132  * \internal
2133  * \brief Convert libpri party id into asterisk party id.
2134  * \since 1.8
2135  *
2136  * \param ast_id Asterisk party id structure to fill.  Must already be set initialized.
2137  * \param pri_id libpri party id structure containing source information.
2138  * \param pri PRI span control structure.
2139  *
2140  * \note The filled in ast_id structure needs to be destroyed by
2141  * ast_party_id_free() when it is no longer needed.
2142  *
2143  * \return Nothing
2144  */
2145 static void sig_pri_party_id_convert(struct ast_party_id *ast_id, const struct pri_party_id *pri_id, struct sig_pri_span *pri)
2146 {
2147         if (pri_id->name.valid) {
2148                 sig_pri_party_name_convert(&ast_id->name, &pri_id->name);
2149         }
2150         if (pri_id->number.valid) {
2151                 sig_pri_party_number_convert(&ast_id->number, &pri_id->number, pri);
2152         }
2153 #if defined(HAVE_PRI_SUBADDR)
2154         if (pri_id->subaddress.valid) {
2155                 sig_pri_set_subaddress(&ast_id->subaddress, &pri_id->subaddress);
2156         }
2157 #endif  /* defined(HAVE_PRI_SUBADDR) */
2158 }
2159
2160 /*!
2161  * \internal
2162  * \brief Convert libpri redirecting information into asterisk redirecting information.
2163  * \since 1.8
2164  *
2165  * \param ast_redirecting Asterisk redirecting structure to fill.
2166  * \param pri_redirecting libpri redirecting structure containing source information.
2167  * \param ast_guide Asterisk redirecting structure to use as an initialization guide.
2168  * \param pri PRI span control structure.
2169  *
2170  * \note The filled in ast_redirecting structure needs to be destroyed by
2171  * ast_party_redirecting_free() when it is no longer needed.
2172  *
2173  * \return Nothing
2174  */
2175 static void sig_pri_redirecting_convert(struct ast_party_redirecting *ast_redirecting,
2176         const struct pri_party_redirecting *pri_redirecting,
2177         const struct ast_party_redirecting *ast_guide,
2178         struct sig_pri_span *pri)
2179 {
2180         ast_party_redirecting_set_init(ast_redirecting, ast_guide);
2181
2182         sig_pri_party_id_convert(&ast_redirecting->orig, &pri_redirecting->orig_called, pri);
2183         sig_pri_party_id_convert(&ast_redirecting->from, &pri_redirecting->from, pri);
2184         sig_pri_party_id_convert(&ast_redirecting->to, &pri_redirecting->to, pri);
2185         ast_redirecting->count = pri_redirecting->count;
2186         ast_redirecting->reason.code = pri_to_ast_reason(pri_redirecting->reason);
2187         ast_redirecting->orig_reason.code = pri_to_ast_reason(pri_redirecting->orig_reason);
2188 }
2189
2190 /*!
2191  * \internal
2192  * \brief Determine if the given extension matches one of the MSNs in the pattern list.
2193  * \since 1.8
2194  *
2195  * \param msn_patterns Comma separated list of MSN patterns to match.
2196  * \param exten Extension to match in the MSN list.
2197  *
2198  * \retval 1 if matches.
2199  * \retval 0 if no match.
2200  */
2201 static int sig_pri_msn_match(const char *msn_patterns, const char *exten)
2202 {
2203         char *pattern;
2204         char *msn_list;
2205         char *list_tail;
2206
2207         msn_list = ast_strdupa(msn_patterns);
2208
2209         list_tail = NULL;
2210         pattern = strtok_r(msn_list, ",", &list_tail);
2211         while (pattern) {
2212                 pattern = ast_strip(pattern);
2213                 if (!ast_strlen_zero(pattern) && ast_extension_match(pattern, exten)) {
2214                         /* Extension matched the pattern. */
2215                         return 1;
2216                 }
2217                 pattern = strtok_r(NULL, ",", &list_tail);
2218         }
2219         /* Did not match any pattern in the list. */
2220         return 0;
2221 }
2222
2223 #if defined(HAVE_PRI_MCID)
2224 /*!
2225  * \internal
2226  * \brief Append the given party id to the event string.
2227  * \since 1.8
2228  *
2229  * \param msg Event message string being built.
2230  * \param prefix Prefix to add to the party id lines.
2231  * \param party Party information to encode.
2232  *
2233  * \return Nothing
2234  */
2235 static void sig_pri_event_party_id(struct ast_str **msg, const char *prefix, struct ast_party_id *party)
2236 {
2237         int pres;
2238
2239         /* Combined party presentation */
2240         pres = ast_party_id_presentation(party);
2241         ast_str_append(msg, 0, "%sPres: %d (%s)\r\n", prefix, pres,
2242                 ast_describe_caller_presentation(pres));
2243
2244         /* Party number */
2245         ast_str_append(msg, 0, "%sNumValid: %d\r\n", prefix,
2246                 (unsigned) party->number.valid);
2247         ast_str_append(msg, 0, "%sNum: %s\r\n", prefix,
2248                 S_COR(party->number.valid, party->number.str, ""));
2249         ast_str_append(msg, 0, "%ston: %d\r\n", prefix, party->number.plan);
2250         if (party->number.valid) {
2251                 ast_str_append(msg, 0, "%sNumPlan: %d\r\n", prefix, party->number.plan);
2252                 ast_str_append(msg, 0, "%sNumPres: %d (%s)\r\n", prefix,
2253                         party->number.presentation,
2254                         ast_describe_caller_presentation(party->number.presentation));
2255         }
2256
2257         /* Party name */
2258         ast_str_append(msg, 0, "%sNameValid: %d\r\n", prefix,
2259                 (unsigned) party->name.valid);
2260         ast_str_append(msg, 0, "%sName: %s\r\n", prefix,
2261                 S_COR(party->name.valid, party->name.str, ""));
2262         if (party->name.valid) {
2263                 ast_str_append(msg, 0, "%sNameCharSet: %s\r\n", prefix,
2264                         ast_party_name_charset_describe(party->name.char_set));
2265                 ast_str_append(msg, 0, "%sNamePres: %d (%s)\r\n", prefix,
2266                         party->name.presentation,
2267                         ast_describe_caller_presentation(party->name.presentation));
2268         }
2269
2270 #if defined(HAVE_PRI_SUBADDR)
2271         /* Party subaddress */
2272         if (party->subaddress.valid) {
2273                 static const char subaddress[] = "Subaddr";
2274
2275                 ast_str_append(msg, 0, "%s%s: %s\r\n", prefix, subaddress,
2276                         S_OR(party->subaddress.str, ""));
2277                 ast_str_append(msg, 0, "%s%sType: %d\r\n", prefix, subaddress,
2278                         party->subaddress.type);
2279                 ast_str_append(msg, 0, "%s%sOdd: %d\r\n", prefix, subaddress,
2280                         party->subaddress.odd_even_indicator);
2281         }
2282 #endif  /* defined(HAVE_PRI_SUBADDR) */
2283 }
2284 #endif  /* defined(HAVE_PRI_MCID) */
2285
2286 #if defined(HAVE_PRI_MCID)
2287 /*!
2288  * \internal
2289  * \brief Handle the MCID event.
2290  * \since 1.8
2291  *
2292  * \param pri PRI span control structure.
2293  * \param mcid MCID event parameters.
2294  * \param owner Asterisk channel associated with the call.
2295  * NULL if Asterisk no longer has the ast_channel struct.
2296  *
2297  * \note Assumes the pri->lock is already obtained.
2298  * \note Assumes the owner channel lock is already obtained if still present.
2299  *
2300  * \return Nothing
2301  */
2302 static void sig_pri_mcid_event(struct sig_pri_span *pri, const struct pri_subcmd_mcid_req *mcid, struct ast_channel *owner)
2303 {
2304         struct ast_channel *chans[1];
2305         struct ast_str *msg;
2306         struct ast_party_id party;
2307
2308         msg = ast_str_create(4096);
2309         if (!msg) {
2310                 return;
2311         }
2312
2313         if (owner) {
2314                 /*
2315                  * The owner channel is present.
2316                  * Pass the event to the peer as well.
2317                  */
2318                 ast_queue_control(owner, AST_CONTROL_MCID);
2319
2320                 ast_str_append(&msg, 0, "Channel: %s\r\n", ast_channel_name(owner));
2321                 ast_str_append(&msg, 0, "UniqueID: %s\r\n", ast_channel_uniqueid(owner));
2322
2323                 sig_pri_event_party_id(&msg, "CallerID", &ast_channel_connected(owner)->id);
2324         } else {
2325                 /*
2326                  * Since we no longer have an owner channel,
2327                  * we have to use the caller information supplied by libpri.
2328                  */
2329                 ast_party_id_init(&party);
2330                 sig_pri_party_id_convert(&party, &mcid->originator, pri);
2331                 sig_pri_event_party_id(&msg, "CallerID", &party);
2332                 ast_party_id_free(&party);
2333         }
2334
2335         /* Always use libpri's called party information. */
2336         ast_party_id_init(&party);
2337         sig_pri_party_id_convert(&party, &mcid->answerer, pri);
2338         sig_pri_event_party_id(&msg, "ConnectedID", &party);
2339         ast_party_id_free(&party);
2340
2341         chans[0] = owner;
2342         ast_manager_event_multichan(EVENT_FLAG_CALL, "MCID", owner ? 1 : 0, chans, "%s",
2343                 ast_str_buffer(msg));
2344         ast_free(msg);
2345 }
2346 #endif  /* defined(HAVE_PRI_MCID) */
2347
2348 #if defined(HAVE_PRI_TRANSFER)
2349 struct xfer_rsp_data {
2350         struct sig_pri_span *pri;
2351         /*! Call to send transfer success/fail response over. */
2352         q931_call *call;
2353         /*! Invocation ID to use when sending a reply to the transfer request. */
2354         int invoke_id;
2355 };
2356 #endif  /* defined(HAVE_PRI_TRANSFER) */
2357
2358 #if defined(HAVE_PRI_TRANSFER)
2359 /*!
2360  * \internal
2361  * \brief Send the transfer success/fail response message.
2362  * \since 1.8
2363  *
2364  * \param data Callback user data pointer
2365  * \param is_successful TRUE if the transfer was successful.
2366  *
2367  * \return Nothing
2368  */
2369 static void sig_pri_transfer_rsp(void *data, int is_successful)
2370 {
2371         struct xfer_rsp_data *rsp = data;
2372
2373         pri_transfer_rsp(rsp->pri->pri, rsp->call, rsp->invoke_id, is_successful);
2374 }
2375 #endif  /* defined(HAVE_PRI_TRANSFER) */
2376
2377 #if defined(HAVE_PRI_CALL_HOLD) || defined(HAVE_PRI_TRANSFER)
2378 /*!
2379  * \brief Protocol callback to indicate if transfer will happen.
2380  * \since 1.8
2381  *
2382  * \param data Callback user data pointer
2383  * \param is_successful TRUE if the transfer will happen.
2384  *
2385  * \return Nothing
2386  */
2387 typedef void (*xfer_rsp_callback)(void *data, int is_successful);
2388 #endif  /* defined(HAVE_PRI_CALL_HOLD) || defined(HAVE_PRI_TRANSFER) */
2389
2390 #if defined(HAVE_PRI_CALL_HOLD) || defined(HAVE_PRI_TRANSFER)
2391 /*!
2392  * \internal
2393  * \brief Attempt to transfer the two calls to each other.
2394  * \since 1.8
2395  *
2396  * \param pri PRI span control structure.
2397  * \param call_1_pri First call involved in the transfer. (transferee; usually on hold)
2398  * \param call_1_held TRUE if call_1_pri is on hold.
2399  * \param call_2_pri Second call involved in the transfer. (target; usually active/ringing)
2400  * \param call_2_held TRUE if call_2_pri is on hold.
2401  * \param rsp_callback Protocol callback to indicate if transfer will happen. NULL if not used.
2402  * \param data Callback user data pointer
2403  *
2404  * \note Assumes the pri->lock is already obtained.
2405  *
2406  * \retval 0 on success.
2407  * \retval -1 on error.
2408  */
2409 static int sig_pri_attempt_transfer(struct sig_pri_span *pri, q931_call *call_1_pri, int call_1_held, q931_call *call_2_pri, int call_2_held, xfer_rsp_callback rsp_callback, void *data)
2410 {
2411         struct attempt_xfer_call {
2412                 q931_call *pri;
2413                 struct ast_channel *ast;
2414                 int held;
2415                 int chanpos;
2416         };
2417         int retval;
2418         struct ast_channel *transferee;
2419         struct attempt_xfer_call *call_1;
2420         struct attempt_xfer_call *call_2;
2421         struct attempt_xfer_call *swap_call;
2422         struct attempt_xfer_call c1;
2423         struct attempt_xfer_call c2;
2424
2425         c1.pri = call_1_pri;
2426         c1.held = call_1_held;
2427         call_1 = &c1;
2428
2429         c2.pri = call_2_pri;
2430         c2.held = call_2_held;
2431         call_2 = &c2;
2432
2433         call_1->chanpos = pri_find_principle_by_call(pri, call_1->pri);
2434         call_2->chanpos = pri_find_principle_by_call(pri, call_2->pri);
2435         if (call_1->chanpos < 0 || call_2->chanpos < 0) {
2436                 /* Calls not found in span control. */
2437                 if (rsp_callback) {
2438                         /* Transfer failed. */
2439                         rsp_callback(data, 0);
2440                 }
2441                 return -1;
2442         }
2443
2444         /* Attempt to make transferee and target consistent. */
2445         if (!call_1->held && call_2->held) {
2446                 /*
2447                  * Swap call_1 and call_2 to make call_1 the transferee(held call)
2448                  * and call_2 the target(active call).
2449                  */
2450                 swap_call = call_1;
2451                 call_1 = call_2;
2452                 call_2 = swap_call;
2453         }
2454
2455         /* Deadlock avoidance is attempted. */
2456         sig_pri_lock_private(pri->pvts[call_1->chanpos]);
2457         sig_pri_lock_owner(pri, call_1->chanpos);
2458         sig_pri_lock_private(pri->pvts[call_2->chanpos]);
2459         sig_pri_lock_owner(pri, call_2->chanpos);
2460
2461         call_1->ast = pri->pvts[call_1->chanpos]->owner;
2462         call_2->ast = pri->pvts[call_2->chanpos]->owner;
2463         if (!call_1->ast || !call_2->ast) {
2464                 /* At least one owner is not present. */
2465                 if (call_1->ast) {
2466                         ast_channel_unlock(call_1->ast);
2467                 }
2468                 if (call_2->ast) {
2469                         ast_channel_unlock(call_2->ast);
2470                 }
2471                 sig_pri_unlock_private(pri->pvts[call_1->chanpos]);
2472                 sig_pri_unlock_private(pri->pvts[call_2->chanpos]);
2473                 if (rsp_callback) {
2474                         /* Transfer failed. */
2475                         rsp_callback(data, 0);
2476                 }
2477                 return -1;
2478         }
2479
2480         for (;;) {
2481                 transferee = ast_bridged_channel(call_1->ast);
2482                 if (transferee) {
2483                         break;
2484                 }
2485
2486                 /* Try masquerading the other way. */
2487                 swap_call = call_1;
2488                 call_1 = call_2;
2489                 call_2 = swap_call;
2490
2491                 transferee = ast_bridged_channel(call_1->ast);
2492                 if (transferee) {
2493                         break;
2494                 }
2495
2496                 /* Could not transfer.  Neither call is bridged. */
2497                 ast_channel_unlock(call_1->ast);
2498                 ast_channel_unlock(call_2->ast);
2499                 sig_pri_unlock_private(pri->pvts[call_1->chanpos]);
2500                 sig_pri_unlock_private(pri->pvts[call_2->chanpos]);
2501
2502                 if (rsp_callback) {
2503                         /* Transfer failed. */
2504                         rsp_callback(data, 0);
2505                 }
2506                 return -1;
2507         }
2508
2509         ast_verb(3, "TRANSFERRING %s to %s\n", ast_channel_name(call_1->ast), ast_channel_name(call_2->ast));
2510
2511         /*
2512          * Setup transfer masquerade.
2513          *
2514          * Note:  There is an extremely nasty deadlock avoidance issue
2515          * with ast_channel_transfer_masquerade().  Deadlock may be possible if
2516          * the channels involved are proxies (chan_agent channels) and
2517          * it is called with locks.  Unfortunately, there is no simple
2518          * or even merely difficult way to guarantee deadlock avoidance
2519          * and still be able to send an ECT success response without the
2520          * possibility of the bridged channel hanging up on us.
2521          */
2522         ast_mutex_unlock(&pri->lock);
2523         retval = ast_channel_transfer_masquerade(
2524                 call_2->ast,
2525                 ast_channel_connected(call_2->ast),
2526                 call_2->held,
2527                 transferee,
2528                 ast_channel_connected(call_1->ast),
2529                 call_1->held);
2530
2531         /* Reacquire the pri->lock to hold off completion of the transfer masquerade. */
2532         ast_mutex_lock(&pri->lock);
2533
2534         ast_channel_unlock(call_1->ast);
2535         ast_channel_unlock(call_2->ast);
2536         sig_pri_unlock_private(pri->pvts[call_1->chanpos]);
2537         sig_pri_unlock_private(pri->pvts[call_2->chanpos]);
2538
2539         if (rsp_callback) {
2540                 /*
2541                  * Report transfer status.
2542                  *
2543                  * Must do the callback before the masquerade completes to ensure
2544                  * that the protocol message goes out before the call leg is
2545                  * disconnected.
2546                  */
2547                 rsp_callback(data, retval ? 0 : 1);
2548         }
2549         return retval;
2550 }
2551 #endif  /* defined(HAVE_PRI_CALL_HOLD) || defined(HAVE_PRI_TRANSFER) */
2552
2553 #if defined(HAVE_PRI_CCSS)
2554 /*!
2555  * \internal
2556  * \brief Compare the CC agent private data by libpri cc_id.
2557  * \since 1.8
2558  *
2559  * \param obj pointer to the (user-defined part) of an object.
2560  * \param arg callback argument from ao2_callback()
2561  * \param flags flags from ao2_callback()
2562  *
2563  * \return values are a combination of enum _cb_results.
2564  */
2565 static int sig_pri_cc_agent_cmp_cc_id(void *obj, void *arg, int flags)
2566 {
2567         struct ast_cc_agent *agent_1 = obj;
2568         struct sig_pri_cc_agent_prv *agent_prv_1 = agent_1->private_data;
2569         struct sig_pri_cc_agent_prv *agent_prv_2 = arg;
2570
2571         return (agent_prv_1 && agent_prv_1->pri == agent_prv_2->pri
2572                 && agent_prv_1->cc_id == agent_prv_2->cc_id) ? CMP_MATCH | CMP_STOP : 0;
2573 }
2574 #endif  /* defined(HAVE_PRI_CCSS) */
2575
2576 #if defined(HAVE_PRI_CCSS)
2577 /*!
2578  * \internal
2579  * \brief Find the CC agent by libpri cc_id.
2580  * \since 1.8
2581  *
2582  * \param pri PRI span control structure.
2583  * \param cc_id CC record ID to find.
2584  *
2585  * \note
2586  * Since agents are refcounted, and this function returns
2587  * a reference to the agent, it is imperative that you decrement
2588  * the refcount of the agent once you have finished using it.
2589  *
2590  * \retval agent on success.
2591  * \retval NULL not found.
2592  */
2593 static struct ast_cc_agent *sig_pri_find_cc_agent_by_cc_id(struct sig_pri_span *pri, long cc_id)
2594 {
2595         struct sig_pri_cc_agent_prv finder = {
2596                 .pri = pri,
2597                 .cc_id = cc_id,
2598         };
2599
2600         return ast_cc_agent_callback(0, sig_pri_cc_agent_cmp_cc_id, &finder,
2601                 sig_pri_cc_type_name);
2602 }
2603 #endif  /* defined(HAVE_PRI_CCSS) */
2604
2605 #if defined(HAVE_PRI_CCSS)
2606 /*!
2607  * \internal
2608  * \brief Compare the CC monitor instance by libpri cc_id.
2609  * \since 1.8
2610  *
2611  * \param obj pointer to the (user-defined part) of an object.
2612  * \param arg callback argument from ao2_callback()
2613  * \param flags flags from ao2_callback()
2614  *
2615  * \return values are a combination of enum _cb_results.
2616  */
2617 static int sig_pri_cc_monitor_cmp_cc_id(void *obj, void *arg, int flags)
2618 {
2619         struct sig_pri_cc_monitor_instance *monitor_1 = obj;
2620         struct sig_pri_cc_monitor_instance *monitor_2 = arg;
2621
2622         return (monitor_1->pri == monitor_2->pri
2623                 && monitor_1->cc_id == monitor_2->cc_id) ? CMP_MATCH | CMP_STOP : 0;
2624 }
2625 #endif  /* defined(HAVE_PRI_CCSS) */
2626
2627 #if defined(HAVE_PRI_CCSS)
2628 /*!
2629  * \internal
2630  * \brief Find the CC monitor instance by libpri cc_id.
2631  * \since 1.8
2632  *
2633  * \param pri PRI span control structure.
2634  * \param cc_id CC record ID to find.
2635  *
2636  * \note
2637  * Since monitor_instances are refcounted, and this function returns
2638  * a reference to the instance, it is imperative that you decrement
2639  * the refcount of the instance once you have finished using it.
2640  *
2641  * \retval monitor_instance on success.
2642  * \retval NULL not found.
2643  */
2644 static struct sig_pri_cc_monitor_instance *sig_pri_find_cc_monitor_by_cc_id(struct sig_pri_span *pri, long cc_id)
2645 {
2646         struct sig_pri_cc_monitor_instance finder = {
2647                 .pri = pri,
2648                 .cc_id = cc_id,
2649         };
2650
2651         return ao2_callback(sig_pri_cc_monitors, 0, sig_pri_cc_monitor_cmp_cc_id, &finder);
2652 }
2653 #endif  /* defined(HAVE_PRI_CCSS) */
2654
2655 #if defined(HAVE_PRI_CCSS)
2656 /*!
2657  * \internal
2658  * \brief Destroy the given monitor instance.
2659  * \since 1.8
2660  *
2661  * \param data Monitor instance to destroy.
2662  *
2663  * \return Nothing
2664  */
2665 static void sig_pri_cc_monitor_instance_destroy(void *data)
2666 {
2667         struct sig_pri_cc_monitor_instance *monitor_instance = data;
2668
2669         if (monitor_instance->cc_id != -1) {
2670                 ast_mutex_lock(&monitor_instance->pri->lock);
2671                 pri_cc_cancel(monitor_instance->pri->pri, monitor_instance->cc_id);
2672                 ast_mutex_unlock(&monitor_instance->pri->lock);
2673         }
2674         sig_pri_callbacks.module_unref();
2675 }
2676 #endif  /* defined(HAVE_PRI_CCSS) */
2677
2678 #if defined(HAVE_PRI_CCSS)
2679 /*!
2680  * \internal
2681  * \brief Construct a new monitor instance.
2682  * \since 1.8
2683  *
2684  * \param core_id CC core ID.
2685  * \param pri PRI span control structure.
2686  * \param cc_id CC record ID.
2687  * \param device_name Name of device (Asterisk channel name less sequence number).
2688  *
2689  * \note
2690  * Since monitor_instances are refcounted, and this function returns
2691  * a reference to the instance, it is imperative that you decrement
2692  * the refcount of the instance once you have finished using it.
2693  *
2694  * \retval monitor_instance on success.
2695  * \retval NULL on error.
2696  */
2697 static struct sig_pri_cc_monitor_instance *sig_pri_cc_monitor_instance_init(int core_id, struct sig_pri_span *pri, long cc_id, const char *device_name)
2698 {
2699         struct sig_pri_cc_monitor_instance *monitor_instance;
2700
2701         if (!sig_pri_callbacks.module_ref || !sig_pri_callbacks.module_unref) {
2702                 return NULL;
2703         }
2704
2705         monitor_instance = ao2_alloc(sizeof(*monitor_instance) + strlen(device_name),
2706                 sig_pri_cc_monitor_instance_destroy);
2707         if (!monitor_instance) {
2708                 return NULL;
2709         }
2710
2711         monitor_instance->cc_id = cc_id;
2712         monitor_instance->pri = pri;
2713         monitor_instance->core_id = core_id;
2714         strcpy(monitor_instance->name, device_name);
2715
2716         sig_pri_callbacks.module_ref();
2717
2718         ao2_link(sig_pri_cc_monitors, monitor_instance);
2719         return monitor_instance;
2720 }
2721 #endif  /* defined(HAVE_PRI_CCSS) */
2722
2723 #if defined(HAVE_PRI_CCSS)
2724 /*!
2725  * \internal
2726  * \brief Announce to the CC core that protocol CC monitor is available for this call.
2727  * \since 1.8
2728  *
2729  * \param pri PRI span control structure.
2730  * \param chanpos Channel position in the span.
2731  * \param cc_id CC record ID.
2732  * \param service CCBS/CCNR indication.
2733  *
2734  * \note Assumes the pri->lock is already obtained.
2735  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.
2736  * \note Assumes the sig_pri_lock_owner(pri, chanpos) is already obtained.
2737  *
2738  * \retval 0 on success.
2739  * \retval -1 on error.
2740  */
2741 static int sig_pri_cc_available(struct sig_pri_span *pri, int chanpos, long cc_id, enum ast_cc_service_type service)
2742 {
2743         struct sig_pri_chan *pvt;
2744         struct ast_cc_config_params *cc_params;
2745         struct sig_pri_cc_monitor_instance *monitor;
2746         enum ast_cc_monitor_policies monitor_policy;
2747         int core_id;
2748         int res;
2749         char device_name[AST_CHANNEL_NAME];
2750         char dialstring[AST_CHANNEL_NAME];
2751
2752         pvt = pri->pvts[chanpos];
2753
2754         core_id = ast_cc_get_current_core_id(pvt->owner);
2755         if (core_id == -1) {
2756                 return -1;
2757         }
2758
2759         cc_params = ast_channel_get_cc_config_params(pvt->owner);
2760         if (!cc_params) {
2761                 return -1;
2762         }
2763
2764         res = -1;
2765         monitor_policy = ast_get_cc_monitor_policy(cc_params);
2766         switch (monitor_policy) {
2767         case AST_CC_MONITOR_NEVER:
2768                 /* CCSS is not enabled. */
2769                 break;
2770         case AST_CC_MONITOR_NATIVE:
2771         case AST_CC_MONITOR_ALWAYS:
2772                 /*
2773                  * If it is AST_CC_MONITOR_ALWAYS and native fails we will attempt the fallback
2774                  * later in the call to sig_pri_cc_generic_check().
2775                  */
2776                 ast_channel_get_device_name(pvt->owner, device_name, sizeof(device_name));
2777                 sig_pri_make_cc_dialstring(pvt, dialstring, sizeof(dialstring));
2778                 monitor = sig_pri_cc_monitor_instance_init(core_id, pri, cc_id, device_name);
2779                 if (!monitor) {
2780                         break;
2781                 }
2782                 res = ast_queue_cc_frame(pvt->owner, sig_pri_cc_type_name, dialstring, service,
2783                         monitor);
2784                 if (res) {
2785                         monitor->cc_id = -1;
2786                         ao2_unlink(sig_pri_cc_monitors, monitor);
2787                         ao2_ref(monitor, -1);
2788                 }
2789                 break;
2790         case AST_CC_MONITOR_GENERIC:
2791                 ast_queue_cc_frame(pvt->owner, AST_CC_GENERIC_MONITOR_TYPE,
2792                         sig_pri_get_orig_dialstring(pvt), service, NULL);
2793                 /* Say it failed to force caller to cancel native CC. */
2794                 break;
2795         }
2796         return res;
2797 }
2798 #endif  /* defined(HAVE_PRI_CCSS) */
2799
2800 /*!
2801  * \internal
2802  * \brief Check if generic CC monitor is needed and request it.
2803  * \since 1.8
2804  *
2805  * \param pri PRI span control structure.
2806  * \param chanpos Channel position in the span.
2807  * \param service CCBS/CCNR indication.
2808  *
2809  * \note Assumes the pri->lock is already obtained.
2810  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.
2811  *
2812  * \return Nothing
2813  */
2814 static void sig_pri_cc_generic_check(struct sig_pri_span *pri, int chanpos, enum ast_cc_service_type service)
2815 {
2816         struct ast_channel *owner;
2817         struct ast_cc_config_params *cc_params;
2818 #if defined(HAVE_PRI_CCSS)
2819         struct ast_cc_monitor *monitor;
2820         char device_name[AST_CHANNEL_NAME];
2821 #endif  /* defined(HAVE_PRI_CCSS) */
2822         enum ast_cc_monitor_policies monitor_policy;
2823         int core_id;
2824
2825         if (!pri->pvts[chanpos]->outgoing) {
2826                 /* This is not an outgoing call so it cannot be CC monitor. */
2827                 return;
2828         }
2829
2830         sig_pri_lock_owner(pri, chanpos);
2831         owner = pri->pvts[chanpos]->owner;
2832         if (!owner) {
2833                 return;
2834         }
2835         core_id = ast_cc_get_current_core_id(owner);
2836         if (core_id == -1) {
2837                 /* No CC core setup */
2838                 goto done;
2839         }
2840
2841         cc_params = ast_channel_get_cc_config_params(owner);
2842         if (!cc_params) {
2843                 /* Could not get CC config parameters. */
2844                 goto done;
2845         }
2846
2847 #if defined(HAVE_PRI_CCSS)
2848         ast_channel_get_device_name(owner, device_name, sizeof(device_name));
2849         monitor = ast_cc_get_monitor_by_recall_core_id(core_id, device_name);
2850         if (monitor) {
2851                 /* CC monitor is already present so no need for generic CC. */
2852                 ao2_ref(monitor, -1);
2853                 goto done;
2854         }
2855 #endif  /* defined(HAVE_PRI_CCSS) */
2856
2857         monitor_policy = ast_get_cc_monitor_policy(cc_params);
2858         switch (monitor_policy) {
2859         case AST_CC_MONITOR_NEVER:
2860                 /* CCSS is not enabled. */
2861                 break;
2862         case AST_CC_MONITOR_NATIVE:
2863                 if (pri->sig == SIG_BRI_PTMP && pri->nodetype == PRI_NETWORK) {
2864                         /* Request generic CC monitor. */
2865                         ast_queue_cc_frame(owner, AST_CC_GENERIC_MONITOR_TYPE,
2866                                 sig_pri_get_orig_dialstring(pri->pvts[chanpos]), service, NULL);
2867                 }
2868                 break;
2869         case AST_CC_MONITOR_ALWAYS:
2870                 if (pri->sig == SIG_BRI_PTMP && pri->nodetype != PRI_NETWORK) {
2871                         /*
2872                          * Cannot monitor PTMP TE side since this is not defined.
2873                          * We are playing the roll of a phone in this case and
2874                          * a phone cannot monitor a party over the network without
2875                          * protocol help.
2876                          */
2877                         break;
2878                 }
2879                 /*
2880                  * We are either falling back or this is a PTMP NT span.
2881                  * Request generic CC monitor.
2882                  */
2883                 ast_queue_cc_frame(owner, AST_CC_GENERIC_MONITOR_TYPE,
2884                         sig_pri_get_orig_dialstring(pri->pvts[chanpos]), service, NULL);
2885                 break;
2886         case AST_CC_MONITOR_GENERIC:
2887                 if (pri->sig == SIG_BRI_PTMP && pri->nodetype == PRI_NETWORK) {
2888                         /* Request generic CC monitor. */
2889                         ast_queue_cc_frame(owner, AST_CC_GENERIC_MONITOR_TYPE,
2890                                 sig_pri_get_orig_dialstring(pri->pvts[chanpos]), service, NULL);
2891                 }
2892                 break;
2893         }
2894
2895 done:
2896         ast_channel_unlock(owner);
2897 }
2898
2899 #if defined(HAVE_PRI_CCSS)
2900 /*!
2901  * \internal
2902  * \brief The CC link canceled the CC instance.
2903  * \since 1.8
2904  *
2905  * \param pri PRI span control structure.
2906  * \param cc_id CC record ID.
2907  * \param is_agent TRUE if the cc_id is for an agent.
2908  *
2909  * \return Nothing
2910  */
2911 static void sig_pri_cc_link_canceled(struct sig_pri_span *pri, long cc_id, int is_agent)
2912 {
2913         if (is_agent) {
2914                 struct ast_cc_agent *agent;
2915
2916                 agent = sig_pri_find_cc_agent_by_cc_id(pri, cc_id);
2917                 if (!agent) {
2918                         return;
2919                 }
2920                 ast_cc_failed(agent->core_id, "%s agent got canceled by link",
2921                         sig_pri_cc_type_name);
2922                 ao2_ref(agent, -1);
2923         } else {
2924                 struct sig_pri_cc_monitor_instance *monitor;
2925
2926                 monitor = sig_pri_find_cc_monitor_by_cc_id(pri, cc_id);
2927                 if (!monitor) {
2928                         return;
2929                 }
2930                 monitor->cc_id = -1;
2931                 ast_cc_monitor_failed(monitor->core_id, monitor->name,
2932                         "%s monitor got canceled by link", sig_pri_cc_type_name);
2933                 ao2_ref(monitor, -1);
2934         }
2935 }
2936 #endif  /* defined(HAVE_PRI_CCSS) */
2937
2938 #if defined(HAVE_PRI_AOC_EVENTS)
2939 /*!
2940  * \internal
2941  * \brief Convert ast_aoc_charged_item to PRI_AOC_CHARGED_ITEM .
2942  * \since 1.8
2943  *
2944  * \param value Value to convert to string.
2945  *
2946  * \return PRI_AOC_CHARGED_ITEM
2947  */
2948 static enum PRI_AOC_CHARGED_ITEM sig_pri_aoc_charged_item_to_pri(enum PRI_AOC_CHARGED_ITEM value)
2949 {
2950         switch (value) {
2951         case AST_AOC_CHARGED_ITEM_NA:
2952                 return PRI_AOC_CHARGED_ITEM_NOT_AVAILABLE;
2953         case AST_AOC_CHARGED_ITEM_SPECIAL_ARRANGEMENT:
2954                 return PRI_AOC_CHARGED_ITEM_SPECIAL_ARRANGEMENT;
2955         case AST_AOC_CHARGED_ITEM_BASIC_COMMUNICATION:
2956                 return PRI_AOC_CHARGED_ITEM_BASIC_COMMUNICATION;
2957         case AST_AOC_CHARGED_ITEM_CALL_ATTEMPT:
2958                 return PRI_AOC_CHARGED_ITEM_CALL_ATTEMPT;
2959         case AST_AOC_CHARGED_ITEM_CALL_SETUP:
2960                 return PRI_AOC_CHARGED_ITEM_CALL_SETUP;
2961         case AST_AOC_CHARGED_ITEM_USER_USER_INFO:
2962                 return PRI_AOC_CHARGED_ITEM_USER_USER_INFO;
2963         case AST_AOC_CHARGED_ITEM_SUPPLEMENTARY_SERVICE:
2964                 return PRI_AOC_CHARGED_ITEM_SUPPLEMENTARY_SERVICE;
2965         }
2966         return PRI_AOC_CHARGED_ITEM_NOT_AVAILABLE;
2967 }
2968 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
2969
2970 #if defined(HAVE_PRI_AOC_EVENTS)
2971 /*!
2972  * \internal
2973  * \brief Convert PRI_AOC_CHARGED_ITEM to ast_aoc_charged_item.
2974  * \since 1.8
2975  *
2976  * \param value Value to convert to string.
2977  *
2978  * \return ast_aoc_charged_item
2979  */
2980 static enum ast_aoc_s_charged_item sig_pri_aoc_charged_item_to_ast(enum PRI_AOC_CHARGED_ITEM value)
2981 {
2982         switch (value) {
2983         case PRI_AOC_CHARGED_ITEM_NOT_AVAILABLE:
2984                 return AST_AOC_CHARGED_ITEM_NA;
2985         case PRI_AOC_CHARGED_ITEM_SPECIAL_ARRANGEMENT:
2986                 return AST_AOC_CHARGED_ITEM_SPECIAL_ARRANGEMENT;
2987         case PRI_AOC_CHARGED_ITEM_BASIC_COMMUNICATION:
2988                 return AST_AOC_CHARGED_ITEM_BASIC_COMMUNICATION;
2989         case PRI_AOC_CHARGED_ITEM_CALL_ATTEMPT:
2990                 return AST_AOC_CHARGED_ITEM_CALL_ATTEMPT;
2991         case PRI_AOC_CHARGED_ITEM_CALL_SETUP:
2992                 return AST_AOC_CHARGED_ITEM_CALL_SETUP;
2993         case PRI_AOC_CHARGED_ITEM_USER_USER_INFO:
2994                 return AST_AOC_CHARGED_ITEM_USER_USER_INFO;
2995         case PRI_AOC_CHARGED_ITEM_SUPPLEMENTARY_SERVICE:
2996                 return AST_AOC_CHARGED_ITEM_SUPPLEMENTARY_SERVICE;
2997         }
2998         return AST_AOC_CHARGED_ITEM_NA;
2999 }
3000 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3001
3002 #if defined(HAVE_PRI_AOC_EVENTS)
3003 /*!
3004  * \internal
3005  * \brief Convert AST_AOC_MULTIPLER to PRI_AOC_MULTIPLIER.
3006  * \since 1.8
3007  *
3008  * \return pri enum equivalent.
3009  */
3010 static int sig_pri_aoc_multiplier_from_ast(enum ast_aoc_currency_multiplier mult)
3011 {
3012         switch (mult) {
3013         case AST_AOC_MULT_ONETHOUSANDTH:
3014                 return PRI_AOC_MULTIPLIER_THOUSANDTH;
3015         case AST_AOC_MULT_ONEHUNDREDTH:
3016                 return PRI_AOC_MULTIPLIER_HUNDREDTH;
3017         case AST_AOC_MULT_ONETENTH:
3018                 return PRI_AOC_MULTIPLIER_TENTH;
3019         case AST_AOC_MULT_ONE:
3020                 return PRI_AOC_MULTIPLIER_ONE;
3021         case AST_AOC_MULT_TEN:
3022                 return PRI_AOC_MULTIPLIER_TEN;
3023         case AST_AOC_MULT_HUNDRED:
3024                 return PRI_AOC_MULTIPLIER_HUNDRED;
3025         case AST_AOC_MULT_THOUSAND:
3026                 return PRI_AOC_MULTIPLIER_THOUSAND;
3027         default:
3028                 return PRI_AOC_MULTIPLIER_ONE;
3029         }
3030 }
3031 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3032
3033 #if defined(HAVE_PRI_AOC_EVENTS)
3034 /*!
3035  * \internal
3036  * \brief Convert PRI_AOC_MULTIPLIER to AST_AOC_MULTIPLIER
3037  * \since 1.8
3038  *
3039  * \return ast enum equivalent.
3040  */
3041 static int sig_pri_aoc_multiplier_from_pri(const int mult)
3042 {
3043         switch (mult) {
3044         case PRI_AOC_MULTIPLIER_THOUSANDTH:
3045                 return AST_AOC_MULT_ONETHOUSANDTH;
3046         case PRI_AOC_MULTIPLIER_HUNDREDTH:
3047                 return AST_AOC_MULT_ONEHUNDREDTH;
3048         case PRI_AOC_MULTIPLIER_TENTH:
3049                 return AST_AOC_MULT_ONETENTH;
3050         case PRI_AOC_MULTIPLIER_ONE:
3051                 return AST_AOC_MULT_ONE;
3052         case PRI_AOC_MULTIPLIER_TEN:
3053                 return AST_AOC_MULT_TEN;
3054         case PRI_AOC_MULTIPLIER_HUNDRED:
3055                 return AST_AOC_MULT_HUNDRED;
3056         case PRI_AOC_MULTIPLIER_THOUSAND:
3057                 return AST_AOC_MULT_THOUSAND;
3058         default:
3059                 return AST_AOC_MULT_ONE;
3060         }
3061 }
3062 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3063
3064 #if defined(HAVE_PRI_AOC_EVENTS)
3065 /*!
3066  * \internal
3067  * \brief Convert ast_aoc_time_scale representation to PRI_AOC_TIME_SCALE
3068  * \since 1.8
3069  *
3070  * \param value Value to convert to ast representation
3071  *
3072  * \return PRI_AOC_TIME_SCALE
3073  */
3074 static enum PRI_AOC_TIME_SCALE sig_pri_aoc_scale_to_pri(enum ast_aoc_time_scale value)
3075 {
3076         switch (value) {
3077         default:
3078         case AST_AOC_TIME_SCALE_HUNDREDTH_SECOND:
3079                 return PRI_AOC_TIME_SCALE_HUNDREDTH_SECOND;
3080         case AST_AOC_TIME_SCALE_TENTH_SECOND:
3081                 return PRI_AOC_TIME_SCALE_TENTH_SECOND;
3082         case AST_AOC_TIME_SCALE_SECOND:
3083                 return PRI_AOC_TIME_SCALE_SECOND;
3084         case AST_AOC_TIME_SCALE_TEN_SECOND:
3085                 return PRI_AOC_TIME_SCALE_TEN_SECOND;
3086         case AST_AOC_TIME_SCALE_MINUTE:
3087                 return PRI_AOC_TIME_SCALE_MINUTE;
3088         case AST_AOC_TIME_SCALE_HOUR:
3089                 return PRI_AOC_TIME_SCALE_HOUR;
3090         case AST_AOC_TIME_SCALE_DAY:
3091                 return PRI_AOC_TIME_SCALE_DAY;
3092         }
3093 }
3094 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3095
3096 #if defined(HAVE_PRI_AOC_EVENTS)
3097 /*!
3098  * \internal
3099  * \brief Convert PRI_AOC_TIME_SCALE to ast aoc representation
3100  * \since 1.8
3101  *
3102  * \param value Value to convert to ast representation
3103  *
3104  * \return ast aoc time scale
3105  */
3106 static enum ast_aoc_time_scale sig_pri_aoc_scale_to_ast(enum PRI_AOC_TIME_SCALE value)
3107 {
3108         switch (value) {
3109         default:
3110         case PRI_AOC_TIME_SCALE_HUNDREDTH_SECOND:
3111                 return AST_AOC_TIME_SCALE_HUNDREDTH_SECOND;
3112         case PRI_AOC_TIME_SCALE_TENTH_SECOND:
3113                 return AST_AOC_TIME_SCALE_TENTH_SECOND;
3114         case PRI_AOC_TIME_SCALE_SECOND:
3115                 return AST_AOC_TIME_SCALE_SECOND;
3116         case PRI_AOC_TIME_SCALE_TEN_SECOND:
3117                 return AST_AOC_TIME_SCALE_TEN_SECOND;
3118         case PRI_AOC_TIME_SCALE_MINUTE:
3119                 return AST_AOC_TIME_SCALE_MINUTE;
3120         case PRI_AOC_TIME_SCALE_HOUR:
3121                 return AST_AOC_TIME_SCALE_HOUR;
3122         case PRI_AOC_TIME_SCALE_DAY:
3123                 return AST_AOC_TIME_SCALE_DAY;
3124         }
3125         return AST_AOC_TIME_SCALE_HUNDREDTH_SECOND;
3126 }
3127 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3128
3129 #if defined(HAVE_PRI_AOC_EVENTS)
3130 /*!
3131  * \internal
3132  * \brief Handle AOC-S control frame
3133  * \since 1.8
3134  *
3135  * \param aoc_s AOC-S event parameters.
3136  * \param owner Asterisk channel associated with the call.
3137  * \param passthrough indicating if this message should be queued on the ast channel
3138  *
3139  * \note Assumes the pri->lock is already obtained.
3140  * \note Assumes the sig_pri private is locked
3141  * \note Assumes the owner channel lock is already obtained.
3142  *
3143  * \return Nothing
3144  */
3145 static void sig_pri_aoc_s_from_pri(const struct pri_subcmd_aoc_s *aoc_s, struct ast_channel *owner, int passthrough)
3146 {
3147         struct ast_aoc_decoded *decoded = NULL;
3148         struct ast_aoc_encoded *encoded = NULL;
3149         size_t encoded_size = 0;
3150         int idx;
3151
3152         if (!owner || !aoc_s) {
3153                 return;
3154         }
3155
3156         if (!(decoded = ast_aoc_create(AST_AOC_S, 0, 0))) {
3157                 return;
3158         }
3159
3160         for (idx = 0; idx < aoc_s->num_items; ++idx) {
3161                 enum ast_aoc_s_charged_item charged_item;
3162
3163                 charged_item = sig_pri_aoc_charged_item_to_ast(aoc_s->item[idx].chargeable);
3164                 if (charged_item == AST_AOC_CHARGED_ITEM_NA) {
3165                         /* Delete the unknown charged item from the list. */
3166                         continue;
3167                 }
3168                 switch (aoc_s->item[idx].rate_type) {
3169                 case PRI_AOC_RATE_TYPE_DURATION:
3170                         ast_aoc_s_add_rate_duration(decoded,
3171                                 charged_item,
3172                                 aoc_s->item[idx].rate.duration.amount.cost,
3173                                 sig_pri_aoc_multiplier_from_pri(aoc_s->item[idx].rate.duration.amount.multiplier),
3174                                 aoc_s->item[idx].rate.duration.currency,
3175                                 aoc_s->item[idx].rate.duration.time.length,
3176                                 sig_pri_aoc_scale_to_ast(aoc_s->item[idx].rate.duration.time.scale),
3177                                 aoc_s->item[idx].rate.duration.granularity.length,
3178                                 sig_pri_aoc_scale_to_ast(aoc_s->item[idx].rate.duration.granularity.scale),
3179                                 aoc_s->item[idx].rate.duration.charging_type);
3180                         break;
3181                 case PRI_AOC_RATE_TYPE_FLAT:
3182                         ast_aoc_s_add_rate_flat(decoded,
3183                                 charged_item,
3184                                 aoc_s->item[idx].rate.flat.amount.cost,
3185                                 sig_pri_aoc_multiplier_from_pri(aoc_s->item[idx].rate.flat.amount.multiplier),
3186                                 aoc_s->item[idx].rate.flat.currency);
3187                         break;
3188                 case PRI_AOC_RATE_TYPE_VOLUME:
3189                         ast_aoc_s_add_rate_volume(decoded,
3190                                 charged_item,
3191                                 aoc_s->item[idx].rate.volume.unit,
3192                                 aoc_s->item[idx].rate.volume.amount.cost,
3193                                 sig_pri_aoc_multiplier_from_pri(aoc_s->item[idx].rate.volume.amount.multiplier),
3194                                 aoc_s->item[idx].rate.volume.currency);
3195                         break;
3196                 case PRI_AOC_RATE_TYPE_SPECIAL_CODE:
3197                         ast_aoc_s_add_rate_special_charge_code(decoded,
3198                                 charged_item,
3199                                 aoc_s->item[idx].rate.special);
3200                         break;
3201                 case PRI_AOC_RATE_TYPE_FREE:
3202                         ast_aoc_s_add_rate_free(decoded, charged_item, 0);
3203                         break;
3204                 case PRI_AOC_RATE_TYPE_FREE_FROM_BEGINNING:
3205                         ast_aoc_s_add_rate_free(decoded, charged_item, 1);
3206                         break;
3207                 default:
3208                         ast_aoc_s_add_rate_na(decoded, charged_item);
3209                         break;
3210                 }
3211         }
3212
3213         if (passthrough && (encoded = ast_aoc_encode(decoded, &encoded_size, owner))) {
3214                 ast_queue_control_data(owner, AST_CONTROL_AOC, encoded, encoded_size);
3215         }
3216
3217         ast_aoc_manager_event(decoded, owner);
3218
3219         ast_aoc_destroy_decoded(decoded);
3220         ast_aoc_destroy_encoded(encoded);
3221 }
3222 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3223
3224 #if defined(HAVE_PRI_AOC_EVENTS)
3225 /*!
3226  * \internal
3227  * \brief Generate AOC Request Response
3228  * \since 1.8
3229  *
3230  * \param aoc_request
3231  *
3232  * \note Assumes the pri->lock is already obtained.
3233  * \note Assumes the sig_pri private is locked
3234  * \note Assumes the owner channel lock is already obtained.
3235  *
3236  * \return Nothing
3237  */
3238 static void sig_pri_aoc_request_from_pri(const struct pri_subcmd_aoc_request *aoc_request, struct sig_pri_chan *pvt, q931_call *call)
3239 {
3240         int request;
3241
3242         if (!aoc_request) {
3243                 return;
3244         }
3245
3246         request = aoc_request->charging_request;
3247
3248         if (request & PRI_AOC_REQUEST_S) {
3249                 if (pvt->pri->aoc_passthrough_flag & SIG_PRI_AOC_GRANT_S) {
3250                         /* An AOC-S response must come from the other side, so save off this invoke_id
3251                          * and see if an AOC-S message comes in before the call is answered. */
3252                         pvt->aoc_s_request_invoke_id = aoc_request->invoke_id;
3253                         pvt->aoc_s_request_invoke_id_valid = 1;
3254
3255                 } else {
3256                         pri_aoc_s_request_response_send(pvt->pri->pri,
3257                                 call,
3258                                 aoc_request->invoke_id,
3259                                 NULL);
3260                 }
3261         }
3262
3263         if (request & PRI_AOC_REQUEST_D) {
3264                 if (pvt->pri->aoc_passthrough_flag & SIG_PRI_AOC_GRANT_D) {
3265                         pri_aoc_de_request_response_send(pvt->pri->pri,
3266                                 call,
3267                                 PRI_AOC_REQ_RSP_CHARGING_INFO_FOLLOWS,
3268                                 aoc_request->invoke_id);
3269                 } else {
3270                         pri_aoc_de_request_response_send(pvt->pri->pri,
3271                                 call,
3272                                 PRI_AOC_REQ_RSP_ERROR_NOT_AVAILABLE,
3273                                 aoc_request->invoke_id);
3274                 }
3275         }
3276
3277         if (request & PRI_AOC_REQUEST_E) {
3278                 if (pvt->pri->aoc_passthrough_flag & SIG_PRI_AOC_GRANT_E) {
3279                         pri_aoc_de_request_response_send(pvt->pri->pri,
3280                                 call,
3281                                 PRI_AOC_REQ_RSP_CHARGING_INFO_FOLLOWS,
3282                                 aoc_request->invoke_id);
3283                 } else {
3284                         pri_aoc_de_request_response_send(pvt->pri->pri,
3285                                 call,
3286                                 PRI_AOC_REQ_RSP_ERROR_NOT_AVAILABLE,
3287                                 aoc_request->invoke_id);
3288                 }
3289         }
3290 }
3291 #endif  /* defined(HAVE_PRI_AOC_EVENTS) */
3292
3293 #if defined(HAVE_PRI_AOC_EVENTS)
3294 /*!
3295  * \internal
3296  * \brief Generate AOC-D AST_CONTROL_AOC frame
3297  * \since 1.8
3298  *
3299  * \param aoc_e AOC-D event parameters.
3300  * \param owner Asterisk channel associated with the call.
3301  * \param passthrough indicating if this message should be queued on the ast channel
3302  *
3303  * \note Assumes the pri->lock is already obtained.
3304  * \note Assumes the sig_pri private is locked
3305  * \note Assumes the owner channel lock is already obtained.
3306  *
3307  * \return Nothing
3308  */
3309 static void sig_pri_aoc_d_from_pri(const struct pri_subcmd_aoc_d *aoc_d, struct ast_channel *owner, int passthrough)
3310 {
3311         struct ast_aoc_decoded *decoded = NULL;
3312         struct ast_aoc_encoded *encoded = NULL;
3313         size_t encoded_size = 0;
3314         enum ast_aoc_charge_type type;
3315
3316         if (!owner || !aoc_d) {
3317                 return;
3318         }
3319
3320         switch (aoc_d->charge) {
3321         case PRI_AOC_DE_CHARGE_CURRENCY:
3322                 type = AST_AOC_CHARGE_CURRENCY;
3323                 break;
3324         case PRI_AOC_DE_CHARGE_UNITS:
3325                 type = AST_AOC_CHARGE_UNIT;
3326                 break;
3327         case PRI_AOC_DE_CHARGE_FREE:
3328                 type = AST_AOC_CHARGE_FREE;
3329                 break;
3330         default:
3331                 type = AST_AOC_CHARGE_NA;
3332                 break;
3333         }
3334
3335         if (!(decoded = ast_aoc_create(AST_AOC_D, type, 0))) {
3336                 return;
3337         }
3338
3339         switch (aoc_d->billing_accumulation) {
3340         default:
3341                 ast_debug(1, "AOC-D billing accumulation has unknown value: %d\n",
3342                         aoc_d->billing_accumulation);
3343                 /* Fall through */
3344         case 0:/* subTotal */
3345                 ast_aoc_set_total_type(decoded, AST_AOC_SUBTOTAL);
3346                 break;
3347         case 1:/* total */
3348                 ast_aoc_set_total_type(decoded, AST_AOC_TOTAL);
3349                 break;
3350         }
3351
3352         switch (aoc_d->billing_id) {
3353         case PRI_AOC_D_BILLING_ID_NORMAL:
3354                 ast_aoc_set_billing_id(decoded, AST_AOC_BILLING_NORMAL);
3355                 break;
3356         case PRI_AOC_D_BILLING_ID_REVERSE:
3357                 ast_aoc_set_billing_id(decoded, AST_AOC_BILLING_REVERSE_CHARGE);
3358                 break;
3359         case PRI_AOC_D_BILLING_ID_CREDIT_CARD:
3360                 ast_aoc_set_billing_id(decoded, AST_AOC_BILLING_CREDIT_CARD);
3361                 break;
3362         case PRI_AOC_D_BILLING_ID_NOT_AVAILABLE:
3363         default:
3364                 ast_aoc_set_billing_id(decoded, AST_AOC_BILLING_NA);
3365                 break;
3366         }
3367
3368         switch (aoc_d->charge) {
3369         case PRI_AOC_DE_CHARGE_CURRENCY:
3370                 ast_aoc_set_currency_info(decoded,
3371                         aoc_d->recorded.money.amount.cost,
3372                         sig_pri_aoc_multiplier_from_pri(aoc_d->recorded.money.amount.multiplier),
3373                         aoc_d->recorded.money.currency);
3374                 break;
3375         case PRI_AOC_DE_CHARGE_UNITS:
3376                 {
3377                         int i;
3378