main/udptl.c

   1 /*
   2  * Asterisk -- A telephony toolkit for Linux.
   3  *
   4  * UDPTL support for T.38
   5  *
   6  * Copyright (C) 2005, Steve Underwood, partly based on RTP code which is
   7  * Copyright (C) 1999-2009, Digium, Inc.
   8  *
   9  * Steve Underwood <steveu@coppice.org>
  10  * Kevin P. Fleming <kpfleming@digium.com>
  11  *
  12  * See http://www.asterisk.org for more information about
  13  * the Asterisk project. Please do not directly contact
  14  * any of the maintainers of this project for assistance;
  15  * the project provides a web site, mailing lists and IRC
  16  * channels for your use.
  17  *
  18  * This program is free software, distributed under the terms of
  19  * the GNU General Public License Version 2. See the LICENSE file
  20  * at the top of the source tree.
  21  *
  22  * A license has been granted to Digium (via disclaimer) for the use of
  23  * this code.
  24  */
  25
  26 /*!
  27  * \file
  28  *
  29  * \brief UDPTL support for T.38 faxing
  30  *
  31  *
  32  * \author Mark Spencer <markster@digium.com>
  33  * \author Steve Underwood <steveu@coppice.org>
  34  * \author Kevin P. Fleming <kpfleming@digium.com>
  35  *
  36  * \page T38fax_udptl T.38 support :: UDPTL
  37  *
  38  * Asterisk supports T.38 fax passthrough, origination and termination. It does
  39  * not support gateway operation. The only channel driver that supports T.38 at
  40  * this time is chan_sip.
  41  *
  42  * UDPTL is handled very much like RTP. It can be reinvited to go directly between
  43  * the endpoints, without involving Asterisk in the media stream.
  44  *
  45  * \b References:
  46  * - chan_sip.c
  47  * - udptl.c
  48  * - app_fax.c
  49  */
  50
  51
  52 #include "asterisk.h"
  53
  54 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
  55
  56 #include <sys/time.h>
  57 #include <signal.h>
  58 #include <fcntl.h>
  59
  60 #include "asterisk/udptl.h"
  61 #include "asterisk/frame.h"
  62 #include "asterisk/channel.h"
  63 #include "asterisk/acl.h"
  64 #include "asterisk/config.h"
  65 #include "asterisk/lock.h"
  66 #include "asterisk/utils.h"
  67 #include "asterisk/netsock.h"
  68 #include "asterisk/cli.h"
  69 #include "asterisk/unaligned.h"
  70
  71 #define UDPTL_MTU               1200
  72
  73 #if !defined(FALSE)
  74 #define FALSE 0
  75 #endif
  76 #if !defined(TRUE)
  77 #define TRUE (!FALSE)
  78 #endif
  79
  80 #define LOG_TAG(u) S_OR(u->tag, "no tag")
  81
  82 static int udptlstart = 4500;
  83 static int udptlend = 4599;
  84 static int udptldebug;                      /*!< Are we debugging? */
  85 static struct ast_sockaddr udptldebugaddr;   /*!< Debug packets to/from this host */
  86 #ifdef SO_NO_CHECK
  87 static int nochecksums;
  88 #endif
  89 static int udptlfecentries;
  90 static int udptlfecspan;
  91 static int use_even_ports;
  92
  93 #define LOCAL_FAX_MAX_DATAGRAM      1400
  94 #define DEFAULT_FAX_MAX_DATAGRAM    400
  95 #define FAX_MAX_DATAGRAM_LIMIT      1400
  96 #define MAX_FEC_ENTRIES             5
  97 #define MAX_FEC_SPAN                5
  98
  99 #define UDPTL_BUF_MASK              15
 100
 101 typedef struct {
 102         int buf_len;
 103         uint8_t buf[LOCAL_FAX_MAX_DATAGRAM];
 104 } udptl_fec_tx_buffer_t;
 105
 106 typedef struct {
 107         int buf_len;
 108         uint8_t buf[LOCAL_FAX_MAX_DATAGRAM];
 109         unsigned int fec_len[MAX_FEC_ENTRIES];
 110         uint8_t fec[MAX_FEC_ENTRIES][LOCAL_FAX_MAX_DATAGRAM];
 111         unsigned int fec_span;
 112         unsigned int fec_entries;
 113 } udptl_fec_rx_buffer_t;
 114
 115 /*! \brief Structure for an UDPTL session */
 116 struct ast_udptl {
 117         int fd;
 118         char resp;
 119         struct ast_frame f[16];
 120         unsigned char rawdata[8192 + AST_FRIENDLY_OFFSET];
 121         unsigned int lasteventseqn;
 122         int nat;
 123         int flags;
 124         struct ast_sockaddr us;
 125         struct ast_sockaddr them;
 126         int *ioid;
 127         struct ast_sched_context *sched;
 128         struct io_context *io;
 129         void *data;
 130         char *tag;
 131         ast_udptl_callback callback;
 132
 133         /*! This option indicates the error correction scheme used in transmitted UDPTL
 134          * packets and expected in received UDPTL packets.
 135          */
 136         enum ast_t38_ec_modes error_correction_scheme;
 137
 138         /*! This option indicates the number of error correction entries transmitted in
 139          * UDPTL packets and expected in received UDPTL packets.
 140          */
 141         unsigned int error_correction_entries;
 142
 143         /*! This option indicates the span of the error correction entries in transmitted
 144          * UDPTL packets (FEC only).
 145          */
 146         unsigned int error_correction_span;
 147
 148         /*! The maximum size UDPTL packet that can be accepted by
 149          * the remote device.
 150          */
 151         int far_max_datagram;
 152
 153         /*! The maximum size UDPTL packet that we are prepared to
 154          * accept, or -1 if it hasn't been calculated since the last
 155          * changes were applied to the UDPTL structure.
 156          */
 157         int local_max_datagram;
 158
 159         /*! The maximum IFP that can be submitted for sending
 160          * to the remote device. Calculated from far_max_datagram,
 161          * error_correction_scheme and error_correction_entries,
 162          * or -1 if it hasn't been calculated since the last
 163          * changes were applied to the UDPTL structure.
 164          */
 165         int far_max_ifp;
 166
 167         /*! The maximum IFP that the local endpoint is prepared
 168          * to accept. Along with error_correction_scheme and
 169          * error_correction_entries, used to calculate local_max_datagram.
 170          */
 171         int local_max_ifp;
 172
 173         int verbose;
 174
 175         unsigned int tx_seq_no;
 176         unsigned int rx_seq_no;
 177         unsigned int rx_expected_seq_no;
 178
 179         udptl_fec_tx_buffer_t tx[UDPTL_BUF_MASK + 1];
 180         udptl_fec_rx_buffer_t rx[UDPTL_BUF_MASK + 1];
 181 };
 182
 183 static AST_RWLIST_HEAD_STATIC(protos, ast_udptl_protocol);
 184
 185 static inline int udptl_debug_test_addr(const struct ast_sockaddr *addr)
 186 {
 187         if (udptldebug == 0)
 188                 return 0;
 189
 190         if (ast_sockaddr_isnull(&udptldebugaddr)) {
 191                 return 1;
 192         }
 193
 194         if (ast_sockaddr_port(&udptldebugaddr)) {
 195                 return !ast_sockaddr_cmp(&udptldebugaddr, addr);
 196         } else {
 197                 return !ast_sockaddr_cmp_addr(&udptldebugaddr, addr);
 198         }
 199 }
 200
 201 static int decode_length(uint8_t *buf, unsigned int limit, unsigned int *len, unsigned int *pvalue)
 202 {
 203         if (*len >= limit)
 204                 return -1;
 205         if ((buf[*len] & 0x80) == 0) {
 206                 *pvalue = buf[*len];
 207                 (*len)++;
 208                 return 0;
 209         }
 210         if ((buf[*len] & 0x40) == 0) {
 211                 if (*len == limit - 1)
 212                         return -1;
 213                 *pvalue = (buf[*len] & 0x3F) << 8;
 214                 (*len)++;
 215                 *pvalue |= buf[*len];
 216                 (*len)++;
 217                 return 0;
 218         }
 219         *pvalue = (buf[*len] & 0x3F) << 14;
 220         (*len)++;
 221         /* Indicate we have a fragment */
 222         return 1;
 223 }
 224 /*- End of function --------------------------------------------------------*/
 225
 226 static int decode_open_type(uint8_t *buf, unsigned int limit, unsigned int *len, const uint8_t **p_object, unsigned int *p_num_octets)
 227 {
 228         unsigned int octet_cnt;
 229         unsigned int octet_idx;
 230         unsigned int i;
 231         int length; /* a negative length indicates the limit has been reached in decode_length. */
 232         const uint8_t **pbuf;
 233
 234         for (octet_idx = 0, *p_num_octets = 0; ; octet_idx += octet_cnt) {
 235                 octet_cnt = 0;
 236                 if ((length = decode_length(buf, limit, len, &octet_cnt)) < 0)
 237                         return -1;
 238                 if (octet_cnt > 0) {
 239                         *p_num_octets += octet_cnt;
 240
 241                         pbuf = &p_object[octet_idx];
 242                         i = 0;
 243                         /* Make sure the buffer contains at least the number of bits requested */
 244                         if ((*len + octet_cnt) > limit)
 245                                 return -1;
 246
 247                         *pbuf = &buf[*len];
 248                         *len += octet_cnt;
 249                 }
 250                 if (length == 0)
 251                         break;
 252         }
 253         return 0;
 254 }
 255 /*- End of function --------------------------------------------------------*/
 256
 257 static unsigned int encode_length(uint8_t *buf, unsigned int *len, unsigned int value)
 258 {
 259         unsigned int multiplier;
 260
 261         if (value < 0x80) {
 262                 /* 1 octet */
 263                 buf[*len] = value;
 264                 (*len)++;
 265                 return value;
 266         }
 267         if (value < 0x4000) {
 268                 /* 2 octets */
 269                 /* Set the first bit of the first octet */
 270                 buf[*len] = ((0x8000 | value) >> 8) & 0xFF;
 271                 (*len)++;
 272                 buf[*len] = value & 0xFF;
 273                 (*len)++;
 274                 return value;
 275         }
 276         /* Fragmentation */
 277         multiplier = (value < 0x10000) ? (value >> 14) : 4;
 278         /* Set the first 2 bits of the octet */
 279         buf[*len] = 0xC0 | multiplier;
 280         (*len)++;
 281         return multiplier << 14;
 282 }
 283 /*- End of function --------------------------------------------------------*/
 284
 285 static int encode_open_type(const struct ast_udptl *udptl, uint8_t *buf, unsigned int buflen,
 286                             unsigned int *len, const uint8_t *data, unsigned int num_octets)
 287 {
 288         unsigned int enclen;
 289         unsigned int octet_idx;
 290         uint8_t zero_byte;
 291
 292         /* If open type is of zero length, add a single zero byte (10.1) */
 293         if (num_octets == 0) {
 294                 zero_byte = 0;
 295                 data = &zero_byte;
 296                 num_octets = 1;
 297         }
 298         /* Encode the open type */
 299         for (octet_idx = 0; ; num_octets -= enclen, octet_idx += enclen) {
 300                 if ((enclen = encode_length(buf, len, num_octets)) < 0)
 301                         return -1;
 302                 if (enclen + *len > buflen) {
 303                         ast_log(LOG_ERROR, "(%s): Buffer overflow detected (%d + %d > %d)\n",
 304                                 LOG_TAG(udptl), enclen, *len, buflen);
 305                         return -1;
 306                 }
 307                 if (enclen > 0) {
 308                         memcpy(&buf[*len], &data[octet_idx], enclen);
 309                         *len += enclen;
 310                 }
 311                 if (enclen >= num_octets)
 312                         break;
 313         }
 314
 315         return 0;
 316 }
 317 /*- End of function --------------------------------------------------------*/
 318
 319 static int udptl_rx_packet(struct ast_udptl *s, uint8_t *buf, unsigned int len)
 320 {
 321         int stat1;
 322         int stat2;
 323         int i;
 324         int j;
 325         int k;
 326         int l;
 327         int m;
 328         int x;
 329         int limit;
 330         int which;
 331         unsigned int ptr;
 332         unsigned int count;
 333         int total_count;
 334         int seq_no;
 335         const uint8_t *ifp;
 336         const uint8_t *data;
 337         unsigned int ifp_len;
 338         int repaired[16];
 339         const uint8_t *bufs[16];
 340         unsigned int lengths[16];
 341         int span;
 342         int entries;
 343         int ifp_no;
 344
 345         ptr = 0;
 346         ifp_no = 0;
 347         memset(&s->f[0], 0, sizeof(s->f[0]));
 348
 349         /* Decode seq_number */
 350         if (ptr + 2 > len)
 351                 return -1;
 352         seq_no = (buf[0] << 8) | buf[1];
 353         ptr += 2;
 354
 355         /* Break out the primary packet */
 356         if ((stat1 = decode_open_type(buf, len, &ptr, &ifp, &ifp_len)) != 0)
 357                 return -1;
 358         /* Decode error_recovery */
 359         if (ptr + 1 > len)
 360                 return -1;
 361         if ((buf[ptr++] & 0x80) == 0) {
 362                 /* Secondary packet mode for error recovery */
 363                 if (seq_no > s->rx_seq_no) {
 364                         /* We received a later packet than we expected, so we need to check if we can fill in the gap from the
 365                            secondary packets. */
 366                         total_count = 0;
 367                         do {
 368                                 if ((stat2 = decode_length(buf, len, &ptr, &count)) < 0)
 369                                         return -1;
 370                                 for (i = 0; i < count; i++) {
 371                                         if ((stat1 = decode_open_type(buf, len, &ptr, &bufs[total_count + i], &lengths[total_count + i])) != 0)
 372                                                 return -1;
 373                                 }
 374                                 total_count += count;
 375                         }
 376                         while (stat2 > 0);
 377                         /* Step through in reverse order, so we go oldest to newest */
 378                         for (i = total_count; i > 0; i--) {
 379                                 if (seq_no - i >= s->rx_seq_no) {
 380                                         /* This one wasn't seen before */
 381                                         /* Decode the secondary IFP packet */
 382                                         //fprintf(stderr, "Secondary %d, len %d\n", seq_no - i, lengths[i - 1]);
 383                                         s->f[ifp_no].frametype = AST_FRAME_MODEM;
 384                                         s->f[ifp_no].subclass.codec = AST_MODEM_T38;
 385
 386                                         s->f[ifp_no].mallocd = 0;
 387                                         s->f[ifp_no].seqno = seq_no - i;
 388                                         s->f[ifp_no].datalen = lengths[i - 1];
 389                                         s->f[ifp_no].data.ptr = (uint8_t *) bufs[i - 1];
 390                                         s->f[ifp_no].offset = 0;
 391                                         s->f[ifp_no].src = "UDPTL";
 392                                         if (ifp_no > 0)
 393                                                 AST_LIST_NEXT(&s->f[ifp_no - 1], frame_list) = &s->f[ifp_no];
 394                                         AST_LIST_NEXT(&s->f[ifp_no], frame_list) = NULL;
 395                                         ifp_no++;
 396                                 }
 397                         }
 398                 }
 399         }
 400         else
 401         {
 402                 /* FEC mode for error recovery */
 403                 /* Our buffers cannot tolerate overlength IFP packets in FEC mode */
 404                 if (ifp_len > LOCAL_FAX_MAX_DATAGRAM)
 405                         return -1;
 406                 /* Update any missed slots in the buffer */
 407                 for ( ; seq_no > s->rx_seq_no; s->rx_seq_no++) {
 408                         x = s->rx_seq_no & UDPTL_BUF_MASK;
 409                         s->rx[x].buf_len = -1;
 410                         s->rx[x].fec_len[0] = 0;
 411                         s->rx[x].fec_span = 0;
 412                         s->rx[x].fec_entries = 0;
 413                 }
 414
 415                 x = seq_no & UDPTL_BUF_MASK;
 416
 417                 memset(repaired, 0, sizeof(repaired));
 418
 419                 /* Save the new IFP packet */
 420                 memcpy(s->rx[x].buf, ifp, ifp_len);
 421                 s->rx[x].buf_len = ifp_len;
 422                 repaired[x] = TRUE;
 423
 424                 /* Decode the FEC packets */
 425                 /* The span is defined as an unconstrained integer, but will never be more
 426                    than a small value. */
 427                 if (ptr + 2 > len)
 428                         return -1;
 429                 if (buf[ptr++] != 1)
 430                         return -1;
 431                 span = buf[ptr++];
 432                 s->rx[x].fec_span = span;
 433
 434                 /* The number of entries is defined as a length, but will only ever be a small
 435                    value. Treat it as such. */
 436                 if (ptr + 1 > len)
 437                         return -1;
 438                 entries = buf[ptr++];
 439                 s->rx[x].fec_entries = entries;
 440
 441                 /* Decode the elements */
 442                 for (i = 0; i < entries; i++) {
 443                         if ((stat1 = decode_open_type(buf, len, &ptr, &data, &s->rx[x].fec_len[i])) != 0)
 444                                 return -1;
 445                         if (s->rx[x].fec_len[i] > LOCAL_FAX_MAX_DATAGRAM)
 446                                 return -1;
 447
 448                         /* Save the new FEC data */
 449                         memcpy(s->rx[x].fec[i], data, s->rx[x].fec_len[i]);
 450 #if 0
 451                         fprintf(stderr, "FEC: ");
 452                         for (j = 0; j < s->rx[x].fec_len[i]; j++)
 453                                 fprintf(stderr, "%02X ", data[j]);
 454                         fprintf(stderr, "\n");
 455 #endif
 456                 }
 457
 458                 /* See if we can reconstruct anything which is missing */
 459                 /* TODO: this does not comprehensively hunt back and repair everything that is possible */
 460                 for (l = x; l != ((x - (16 - span*entries)) & UDPTL_BUF_MASK); l = (l - 1) & UDPTL_BUF_MASK) {
 461                         if (s->rx[l].fec_len[0] <= 0)
 462                                 continue;
 463                         for (m = 0; m < s->rx[l].fec_entries; m++) {
 464                                 limit = (l + m) & UDPTL_BUF_MASK;
 465                                 for (which = -1, k = (limit - s->rx[l].fec_span * s->rx[l].fec_entries) & UDPTL_BUF_MASK; k != limit; k = (k + s->rx[l].fec_entries) & UDPTL_BUF_MASK) {
 466                                         if (s->rx[k].buf_len <= 0)
 467                                                 which = (which == -1) ? k : -2;
 468                                 }
 469                                 if (which >= 0) {
 470                                         /* Repairable */
 471                                         for (j = 0; j < s->rx[l].fec_len[m]; j++) {
 472                                                 s->rx[which].buf[j] = s->rx[l].fec[m][j];
 473                                                 for (k = (limit - s->rx[l].fec_span * s->rx[l].fec_entries) & UDPTL_BUF_MASK; k != limit; k = (k + s->rx[l].fec_entries) & UDPTL_BUF_MASK)
 474                                                         s->rx[which].buf[j] ^= (s->rx[k].buf_len > j) ? s->rx[k].buf[j] : 0;
 475                                         }
 476                                         s->rx[which].buf_len = s->rx[l].fec_len[m];
 477                                         repaired[which] = TRUE;
 478                                 }
 479                         }
 480                 }
 481                 /* Now play any new packets forwards in time */
 482                 for (l = (x + 1) & UDPTL_BUF_MASK, j = seq_no - UDPTL_BUF_MASK; l != x; l = (l + 1) & UDPTL_BUF_MASK, j++) {
 483                         if (repaired[l]) {
 484                                 //fprintf(stderr, "Fixed packet %d, len %d\n", j, l);
 485                                 s->f[ifp_no].frametype = AST_FRAME_MODEM;
 486                                 s->f[ifp_no].subclass.codec = AST_MODEM_T38;
 487
 488                                 s->f[ifp_no].mallocd = 0;
 489                                 s->f[ifp_no].seqno = j;
 490                                 s->f[ifp_no].datalen = s->rx[l].buf_len;
 491                                 s->f[ifp_no].data.ptr = s->rx[l].buf;
 492                                 s->f[ifp_no].offset = 0;
 493                                 s->f[ifp_no].src = "UDPTL";
 494                                 if (ifp_no > 0)
 495                                         AST_LIST_NEXT(&s->f[ifp_no - 1], frame_list) = &s->f[ifp_no];
 496                                 AST_LIST_NEXT(&s->f[ifp_no], frame_list) = NULL;
 497                                 ifp_no++;
 498                         }
 499                 }
 500         }
 501
 502         /* If packets are received out of sequence, we may have already processed this packet from the error
 503            recovery information in a packet already received. */
 504         if (seq_no >= s->rx_seq_no) {
 505                 /* Decode the primary IFP packet */
 506                 s->f[ifp_no].frametype = AST_FRAME_MODEM;
 507                 s->f[ifp_no].subclass.codec = AST_MODEM_T38;
 508
 509                 s->f[ifp_no].mallocd = 0;
 510                 s->f[ifp_no].seqno = seq_no;
 511                 s->f[ifp_no].datalen = ifp_len;
 512                 s->f[ifp_no].data.ptr = (uint8_t *) ifp;
 513                 s->f[ifp_no].offset = 0;
 514                 s->f[ifp_no].src = "UDPTL";
 515                 if (ifp_no > 0)
 516                         AST_LIST_NEXT(&s->f[ifp_no - 1], frame_list) = &s->f[ifp_no];
 517                 AST_LIST_NEXT(&s->f[ifp_no], frame_list) = NULL;
 518
 519                 ifp_no++;
 520         }
 521
 522         s->rx_seq_no = seq_no + 1;
 523         return ifp_no;
 524 }
 525 /*- End of function --------------------------------------------------------*/
 526
 527 static int udptl_build_packet(struct ast_udptl *s, uint8_t *buf, unsigned int buflen, uint8_t *ifp, unsigned int ifp_len)
 528 {
 529         uint8_t fec[LOCAL_FAX_MAX_DATAGRAM * 2];
 530         int i;
 531         int j;
 532         int seq;
 533         int entry;
 534         int entries;
 535         int span;
 536         int m;
 537         unsigned int len;
 538         int limit;
 539         int high_tide;
 540
 541         seq = s->tx_seq_no & 0xFFFF;
 542
 543         /* Map the sequence number to an entry in the circular buffer */
 544         entry = seq & UDPTL_BUF_MASK;
 545
 546         /* We save the message in a circular buffer, for generating FEC or
 547            redundancy sets later on. */
 548         s->tx[entry].buf_len = ifp_len;
 549         memcpy(s->tx[entry].buf, ifp, ifp_len);
 550
 551         /* Build the UDPTLPacket */
 552
 553         len = 0;
 554         /* Encode the sequence number */
 555         buf[len++] = (seq >> 8) & 0xFF;
 556         buf[len++] = seq & 0xFF;
 557
 558         /* Encode the primary IFP packet */
 559         if (encode_open_type(s, buf, buflen, &len, ifp, ifp_len) < 0)
 560                 return -1;
 561
 562         /* Encode the appropriate type of error recovery information */
 563         switch (s->error_correction_scheme)
 564         {
 565         case UDPTL_ERROR_CORRECTION_NONE:
 566                 /* Encode the error recovery type */
 567                 buf[len++] = 0x00;
 568                 /* The number of entries will always be zero, so it is pointless allowing
 569                    for the fragmented case here. */
 570                 if (encode_length(buf, &len, 0) < 0)
 571                         return -1;
 572                 break;
 573         case UDPTL_ERROR_CORRECTION_REDUNDANCY:
 574                 /* Encode the error recovery type */
 575                 buf[len++] = 0x00;
 576                 if (s->tx_seq_no > s->error_correction_entries)
 577                         entries = s->error_correction_entries;
 578                 else
 579                         entries = s->tx_seq_no;
 580                 /* The number of entries will always be small, so it is pointless allowing
 581                    for the fragmented case here. */
 582                 if (encode_length(buf, &len, entries) < 0)
 583                         return -1;
 584                 /* Encode the elements */
 585                 for (i = 0; i < entries; i++) {
 586                         j = (entry - i - 1) & UDPTL_BUF_MASK;
 587                         if (encode_open_type(s, buf, buflen, &len, s->tx[j].buf, s->tx[j].buf_len) < 0) {
 588                                 ast_debug(1, "(%s): Encoding failed at i=%d, j=%d\n",
 589                                           LOG_TAG(s), i, j);
 590                                 return -1;
 591                         }
 592                 }
 593                 break;
 594         case UDPTL_ERROR_CORRECTION_FEC:
 595                 span = s->error_correction_span;
 596                 entries = s->error_correction_entries;
 597                 if (seq < s->error_correction_span*s->error_correction_entries) {
 598                         /* In the initial stages, wind up the FEC smoothly */
 599                         entries = seq/s->error_correction_span;
 600                         if (seq < s->error_correction_span)
 601                                 span = 0;
 602                 }
 603                 /* Encode the error recovery type */
 604                 buf[len++] = 0x80;
 605                 /* Span is defined as an inconstrained integer, which it dumb. It will only
 606                    ever be a small value. Treat it as such. */
 607                 buf[len++] = 1;
 608                 buf[len++] = span;
 609                 /* The number of entries is defined as a length, but will only ever be a small
 610                    value. Treat it as such. */
 611                 buf[len++] = entries;
 612                 for (m = 0; m < entries; m++) {
 613                         /* Make an XOR'ed entry the maximum length */
 614                         limit = (entry + m) & UDPTL_BUF_MASK;
 615                         high_tide = 0;
 616                         for (i = (limit - span*entries) & UDPTL_BUF_MASK; i != limit; i = (i + entries) & UDPTL_BUF_MASK) {
 617                                 if (high_tide < s->tx[i].buf_len) {
 618                                         for (j = 0; j < high_tide; j++)
 619                                                 fec[j] ^= s->tx[i].buf[j];
 620                                         for ( ; j < s->tx[i].buf_len; j++)
 621                                                 fec[j] = s->tx[i].buf[j];
 622                                         high_tide = s->tx[i].buf_len;
 623                                 } else {
 624                                         for (j = 0; j < s->tx[i].buf_len; j++)
 625                                                 fec[j] ^= s->tx[i].buf[j];
 626                                 }
 627                         }
 628                         if (encode_open_type(s, buf, buflen, &len, fec, high_tide) < 0)
 629                                 return -1;
 630                 }
 631                 break;
 632         }
 633
 634         if (s->verbose)
 635                 fprintf(stderr, "\n");
 636
 637         s->tx_seq_no++;
 638         return len;
 639 }
 640
 641 int ast_udptl_fd(const struct ast_udptl *udptl)
 642 {
 643         return udptl->fd;
 644 }
 645
 646 void ast_udptl_set_data(struct ast_udptl *udptl, void *data)
 647 {
 648         udptl->data = data;
 649 }
 650
 651 void ast_udptl_set_callback(struct ast_udptl *udptl, ast_udptl_callback callback)
 652 {
 653         udptl->callback = callback;
 654 }
 655
 656 void ast_udptl_setnat(struct ast_udptl *udptl, int nat)
 657 {
 658         udptl->nat = nat;
 659 }
 660
 661 static int udptlread(int *id, int fd, short events, void *cbdata)
 662 {
 663         struct ast_udptl *udptl = cbdata;
 664         struct ast_frame *f;
 665
 666         if ((f = ast_udptl_read(udptl))) {
 667                 if (udptl->callback)
 668                         udptl->callback(udptl, f, udptl->data);
 669         }
 670         return 1;
 671 }
 672
 673 struct ast_frame *ast_udptl_read(struct ast_udptl *udptl)
 674 {
 675         int res;
 676         struct ast_sockaddr addr;
 677         uint16_t seqno = 0;
 678         uint16_t *udptlheader;
 679
 680         /* Cache where the header will go */
 681         res = ast_recvfrom(udptl->fd,
 682                         udptl->rawdata + AST_FRIENDLY_OFFSET,
 683                         sizeof(udptl->rawdata) - AST_FRIENDLY_OFFSET,
 684                         0,
 685                         &addr);
 686         udptlheader = (uint16_t *)(udptl->rawdata + AST_FRIENDLY_OFFSET);
 687         if (res < 0) {
 688                 if (errno != EAGAIN)
 689                         ast_log(LOG_WARNING, "(%s): UDPTL read error: %s\n",
 690                                 LOG_TAG(udptl), strerror(errno));
 691                 ast_assert(errno != EBADF);
 692                 return &ast_null_frame;
 693         }
 694
 695         /* Ignore if the other side hasn't been given an address yet. */
 696         if (ast_sockaddr_isnull(&udptl->them)) {
 697                 return &ast_null_frame;
 698         }
 699
 700         if (udptl->nat) {
 701                 /* Send to whoever sent to us */
 702                 if (ast_sockaddr_cmp(&udptl->them, &addr)) {
 703                         ast_sockaddr_copy(&udptl->them, &addr);
 704                         ast_debug(1, "UDPTL NAT (%s): Using address %s\n",
 705                                   LOG_TAG(udptl), ast_sockaddr_stringify(&udptl->them));
 706                 }
 707         }
 708
 709         if (udptl_debug_test_addr(&addr)) {
 710                 ast_verb(1, "UDPTL (%s): packet from %s (type %d, seq %d, len %d)\n",
 711                          LOG_TAG(udptl), ast_sockaddr_stringify(&addr), 0, seqno, res);
 712         }
 713         if (udptl_rx_packet(udptl, udptl->rawdata + AST_FRIENDLY_OFFSET, res) < 1)
 714                 return &ast_null_frame;
 715
 716         return &udptl->f[0];
 717 }
 718
 719 static void calculate_local_max_datagram(struct ast_udptl *udptl)
 720 {
 721         unsigned int new_max = 0;
 722
 723         if (udptl->local_max_ifp == -1) {
 724                 ast_log(LOG_WARNING, "(%s): Cannot calculate local_max_datagram before local_max_ifp has been set.\n",
 725                         LOG_TAG(udptl));
 726                 udptl->local_max_datagram = -1;
 727                 return;
 728         }
 729
 730         /* calculate the amount of space required to receive an IFP
 731          * of the maximum size supported by the application/endpoint
 732          * that we are delivering them to (local endpoint), and add
 733          * the amount of space required to support the selected
 734          * error correction mode
 735          */
 736         switch (udptl->error_correction_scheme) {
 737         case UDPTL_ERROR_CORRECTION_NONE:
 738                 /* need room for sequence number, length indicator, redundancy
 739                  * indicator and following length indicator
 740                  */
 741                 new_max = 5 + udptl->local_max_ifp;
 742                 break;
 743         case UDPTL_ERROR_CORRECTION_REDUNDANCY:
 744                 /* need room for sequence number, length indicators, plus
 745                  * room for up to 3 redundancy packets
 746                  */
 747                 new_max = 5 + udptl->local_max_ifp + 2 + (3 * udptl->local_max_ifp);
 748                 break;
 749         case UDPTL_ERROR_CORRECTION_FEC:
 750                 /* need room for sequence number, length indicators and a
 751                  * a single IFP of the maximum size expected
 752                  */
 753                 new_max = 5 + udptl->local_max_ifp + 4 + udptl->local_max_ifp;
 754                 break;
 755         }
 756         /* add 5% extra space for insurance, but no larger than LOCAL_FAX_MAX_DATAGRAM */
 757         udptl->local_max_datagram = MIN(new_max * 1.05, LOCAL_FAX_MAX_DATAGRAM);
 758 }
 759
 760 static void calculate_far_max_ifp(struct ast_udptl *udptl)
 761 {
 762         unsigned new_max = 0;
 763
 764         if (udptl->far_max_datagram == -1) {
 765                 ast_log(LOG_WARNING, "(%s): Cannot calculate far_max_ifp before far_max_datagram has been set.\n",
 766                         LOG_TAG(udptl));
 767                 udptl->far_max_ifp = -1;
 768                 return;
 769         }
 770
 771         /* the goal here is to supply the local endpoint (application
 772          * or bridged channel) a maximum IFP value that will allow it
 773          * to effectively and efficiently transfer image data at its
 774          * selected bit rate, taking into account the selected error
 775          * correction mode, but without overrunning the far endpoint's
 776          * datagram buffer. this is complicated by the fact that some
 777          * far endpoints send us bogus (small) max datagram values,
 778          * which would result in either buffer overrun or no error
 779          * correction. we try to accomodate those, but if the supplied
 780          * value is too small to do so, we'll emit warning messages and
 781          * the user will have to use configuration options to override
 782          * the max datagram value supplied by the far endpoint.
 783          */
 784         switch (udptl->error_correction_scheme) {
 785         case UDPTL_ERROR_CORRECTION_NONE:
 786                 /* need room for sequence number, length indicator, redundancy
 787                  * indicator and following length indicator
 788                  */
 789                 new_max = udptl->far_max_datagram - 5;
 790                 break;
 791         case UDPTL_ERROR_CORRECTION_REDUNDANCY:
 792                 /* for this case, we'd like to send as many error correction entries
 793                  * as possible (up to the number we're configured for), but we'll settle
 794                  * for sending fewer if the configured number would cause the
 795                  * calculated max IFP to be too small for effective operation
 796                  *
 797                  * need room for sequence number, length indicators and the
 798                  * configured number of redundant packets
 799                  *
 800                  * note: we purposely don't allow error_correction_entries to drop to
 801                  * zero in this loop; we'd rather send smaller IFPs (and thus reduce
 802                  * the image data transfer rate) than sacrifice redundancy completely
 803                  */
 804                 for (;;) {
 805                         new_max = (udptl->far_max_datagram - 8) / (udptl->error_correction_entries + 1);
 806
 807                         if ((new_max < 80) && (udptl->error_correction_entries > 1)) {
 808                                 /* the max ifp is not large enough, subtract an
 809                                  * error correction entry and calculate again
 810                                  * */
 811                                 --udptl->error_correction_entries;
 812                         } else {
 813                                 break;
 814                         }
 815                 }
 816                 break;
 817         case UDPTL_ERROR_CORRECTION_FEC:
 818                 /* need room for sequence number, length indicators and a
 819                  * a single IFP of the maximum size expected
 820                  */
 821                 new_max = (udptl->far_max_datagram - 10) / 2;
 822                 break;
 823         }
 824         /* subtract 5% of space for insurance */
 825         udptl->far_max_ifp = new_max * 0.95;
 826 }
 827
 828 enum ast_t38_ec_modes ast_udptl_get_error_correction_scheme(const struct ast_udptl *udptl)
 829 {
 830         return udptl->error_correction_scheme;
 831 }
 832
 833 void ast_udptl_set_error_correction_scheme(struct ast_udptl *udptl, enum ast_t38_ec_modes ec)
 834 {
 835         udptl->error_correction_scheme = ec;
 836         switch (ec) {
 837         case UDPTL_ERROR_CORRECTION_FEC:
 838                 udptl->error_correction_scheme = UDPTL_ERROR_CORRECTION_FEC;
 839                 if (udptl->error_correction_entries == 0) {
 840                         udptl->error_correction_entries = 3;
 841                 }
 842                 if (udptl->error_correction_span == 0) {
 843                         udptl->error_correction_span = 3;
 844                 }
 845                 break;
 846         case UDPTL_ERROR_CORRECTION_REDUNDANCY:
 847                 udptl->error_correction_scheme = UDPTL_ERROR_CORRECTION_REDUNDANCY;
 848                 if (udptl->error_correction_entries == 0) {
 849                         udptl->error_correction_entries = 3;
 850                 }
 851                 break;
 852         default:
 853                 /* nothing to do */
 854                 break;
 855         };
 856         /* reset calculated values so they'll be computed again */
 857         udptl->local_max_datagram = -1;
 858         udptl->far_max_ifp = -1;
 859 }
 860
 861 void ast_udptl_set_local_max_ifp(struct ast_udptl *udptl, unsigned int max_ifp)
 862 {
 863         /* make sure max_ifp is a positive value since a cast will take place when
 864          * when setting local_max_ifp */
 865         if ((signed int) max_ifp > 0) {
 866                 udptl->local_max_ifp = max_ifp;
 867                 /* reset calculated values so they'll be computed again */
 868                 udptl->local_max_datagram = -1;
 869         }
 870 }
 871
 872 unsigned int ast_udptl_get_local_max_datagram(struct ast_udptl *udptl)
 873 {
 874         if (udptl->local_max_datagram == -1) {
 875                 calculate_local_max_datagram(udptl);
 876         }
 877
 878         /* this function expects a unsigned value in return. */
 879         if (udptl->local_max_datagram < 0) {
 880                 return 0;
 881         }
 882         return udptl->local_max_datagram;
 883 }
 884
 885 void ast_udptl_set_far_max_datagram(struct ast_udptl *udptl, unsigned int max_datagram)
 886 {
 887         if (!max_datagram || (max_datagram > FAX_MAX_DATAGRAM_LIMIT)) {
 888                 udptl->far_max_datagram = DEFAULT_FAX_MAX_DATAGRAM;
 889         } else {
 890                 udptl->far_max_datagram = max_datagram;
 891         }
 892         /* reset calculated values so they'll be computed again */
 893         udptl->far_max_ifp = -1;
 894 }
 895
 896 unsigned int ast_udptl_get_far_max_datagram(const struct ast_udptl *udptl)
 897 {
 898         if (udptl->far_max_datagram < 0) {
 899                 return 0;
 900         }
 901         return udptl->far_max_datagram;
 902 }
 903
 904 unsigned int ast_udptl_get_far_max_ifp(struct ast_udptl *udptl)
 905 {
 906         if (udptl->far_max_ifp == -1) {
 907                 calculate_far_max_ifp(udptl);
 908         }
 909
 910         if (udptl->far_max_ifp < 0) {
 911                 return 0;
 912         }
 913         return udptl->far_max_ifp;
 914 }
 915
 916 struct ast_udptl *ast_udptl_new_with_bindaddr(struct ast_sched_context *sched, struct io_context *io, int callbackmode, struct ast_sockaddr *addr)
 917 {
 918         struct ast_udptl *udptl;
 919         int x;
 920         int startplace;
 921         int i;
 922         long int flags;
 923
 924         if (!(udptl = ast_calloc(1, sizeof(*udptl))))
 925                 return NULL;
 926
 927         udptl->error_correction_span = udptlfecspan;
 928         udptl->error_correction_entries = udptlfecentries;
 929
 930         udptl->far_max_datagram = -1;
 931         udptl->far_max_ifp = -1;
 932         udptl->local_max_ifp = -1;
 933         udptl->local_max_datagram = -1;
 934
 935         for (i = 0; i <= UDPTL_BUF_MASK; i++) {
 936                 udptl->rx[i].buf_len = -1;
 937                 udptl->tx[i].buf_len = -1;
 938         }
 939
 940         if ((udptl->fd = socket(ast_sockaddr_is_ipv6(addr) ?
 941                                         AF_INET6 : AF_INET, SOCK_DGRAM, 0)) < 0) {
 942                 ast_free(udptl);
 943                 ast_log(LOG_WARNING, "Unable to allocate socket: %s\n", strerror(errno));
 944                 return NULL;
 945         }
 946         flags = fcntl(udptl->fd, F_GETFL);
 947         fcntl(udptl->fd, F_SETFL, flags | O_NONBLOCK);
 948 #ifdef SO_NO_CHECK
 949         if (nochecksums)
 950                 setsockopt(udptl->fd, SOL_SOCKET, SO_NO_CHECK, &nochecksums, sizeof(nochecksums));
 951 #endif
 952         /* Find us a place */
 953         x = (udptlstart == udptlend) ? udptlstart : (ast_random() % (udptlend - udptlstart)) + udptlstart;
 954         if (use_even_ports && (x & 1)) {
 955                 ++x;
 956         }
 957         startplace = x;
 958         for (;;) {
 959                 ast_sockaddr_copy(&udptl->us, addr);
 960                 ast_sockaddr_set_port(&udptl->us, x);
 961                 if (ast_bind(udptl->fd, &udptl->us) == 0) {
 962                         break;
 963                 }
 964                 if (errno != EADDRINUSE) {
 965                         ast_log(LOG_WARNING, "Unexpected bind error: %s\n", strerror(errno));
 966                         close(udptl->fd);
 967                         ast_free(udptl);
 968                         return NULL;
 969                 }
 970                 if (use_even_ports) {
 971                         x += 2;
 972                 } else {
 973                         ++x;
 974                 }
 975                 if (x > udptlend)
 976                         x = udptlstart;
 977                 if (x == startplace) {
 978                         ast_log(LOG_WARNING, "No UDPTL ports remaining\n");
 979                         close(udptl->fd);
 980                         ast_free(udptl);
 981                         return NULL;
 982                 }
 983         }
 984         if (io && sched && callbackmode) {
 985                 /* Operate this one in a callback mode */
 986                 udptl->sched = sched;
 987                 udptl->io = io;
 988                 udptl->ioid = ast_io_add(udptl->io, udptl->fd, udptlread, AST_IO_IN, udptl);
 989         }
 990         return udptl;
 991 }
 992
 993 void ast_udptl_set_tag(struct ast_udptl *udptl, const char *format, ...)
 994 {
 995         va_list ap;
 996
 997         if (udptl->tag) {
 998                 ast_free(udptl->tag);
 999                 udptl->tag = NULL;
1000         }
1001         va_start(ap, format);
1002         if (ast_vasprintf(&udptl->tag, format, ap) == -1) {
1003                 udptl->tag = NULL;
1004         }
1005         va_end(ap);
1006 }
1007
1008 int ast_udptl_setqos(struct ast_udptl *udptl, unsigned int tos, unsigned int cos)
1009 {
1010         return ast_netsock_set_qos(udptl->fd, tos, cos, "UDPTL");
1011 }
1012
1013 void ast_udptl_set_peer(struct ast_udptl *udptl, const struct ast_sockaddr *them)
1014 {
1015         ast_sockaddr_copy(&udptl->them, them);
1016 }
1017
1018 void ast_udptl_get_peer(const struct ast_udptl *udptl, struct ast_sockaddr *them)
1019 {
1020         ast_sockaddr_copy(them, &udptl->them);
1021 }
1022
1023 void ast_udptl_get_us(const struct ast_udptl *udptl, struct ast_sockaddr *us)
1024 {
1025         ast_sockaddr_copy(us, &udptl->us);
1026 }
1027
1028 void ast_udptl_stop(struct ast_udptl *udptl)
1029 {
1030         ast_sockaddr_setnull(&udptl->them);
1031 }
1032
1033 void ast_udptl_destroy(struct ast_udptl *udptl)
1034 {
1035         if (udptl->ioid)
1036                 ast_io_remove(udptl->io, udptl->ioid);
1037         if (udptl->fd > -1)
1038                 close(udptl->fd);
1039         if (udptl->tag)
1040                 ast_free(udptl->tag);
1041         ast_free(udptl);
1042 }
1043
1044 int ast_udptl_write(struct ast_udptl *s, struct ast_frame *f)
1045 {
1046         unsigned int seq;
1047         unsigned int len = f->datalen;
1048         int res;
1049         /* if no max datagram size is provided, use default value */
1050         const int bufsize = (s->far_max_datagram > 0) ? s->far_max_datagram : DEFAULT_FAX_MAX_DATAGRAM;
1051         uint8_t buf[bufsize];
1052
1053         memset(buf, 0, sizeof(buf));
1054
1055         /* If we have no peer, return immediately */
1056         if (ast_sockaddr_isnull(&s->them)) {
1057                 return 0;
1058         }
1059
1060         /* If there is no data length, return immediately */
1061         if (f->datalen == 0)
1062                 return 0;
1063
1064         if ((f->frametype != AST_FRAME_MODEM) ||
1065             (f->subclass.codec != AST_MODEM_T38)) {
1066                 ast_log(LOG_WARNING, "(%s): UDPTL can only send T.38 data.\n",
1067                         LOG_TAG(s));
1068                 return -1;
1069         }
1070
1071         if (len > s->far_max_ifp) {
1072                 ast_log(LOG_WARNING,
1073                         "(%s): UDPTL asked to send %d bytes of IFP when far end only prepared to accept %d bytes; data loss will occur."
1074                         "You may need to override the T38FaxMaxDatagram value for this endpoint in the channel driver configuration.\n",
1075                         LOG_TAG(s), len, s->far_max_ifp);
1076                 len = s->far_max_ifp;
1077         }
1078
1079         /* Save seq_no for debug output because udptl_build_packet increments it */
1080         seq = s->tx_seq_no & 0xFFFF;
1081
1082         /* Cook up the UDPTL packet, with the relevant EC info. */
1083         len = udptl_build_packet(s, buf, sizeof(buf), f->data.ptr, len);
1084
1085         if ((signed int) len > 0 && !ast_sockaddr_isnull(&s->them)) {
1086                 if ((res = ast_sendto(s->fd, buf, len, 0, &s->them)) < 0)
1087                         ast_log(LOG_NOTICE, "(%s): UDPTL Transmission error to %s: %s\n",
1088                                 LOG_TAG(s), ast_sockaddr_stringify(&s->them), strerror(errno));
1089                 if (udptl_debug_test_addr(&s->them))
1090                         ast_verb(1, "UDPTL (%s): packet to %s (type %d, seq %d, len %d)\n",
1091                                  LOG_TAG(s), ast_sockaddr_stringify(&s->them), 0, seq, len);
1092         }
1093
1094         return 0;
1095 }
1096
1097 void ast_udptl_proto_unregister(struct ast_udptl_protocol *proto)
1098 {
1099         AST_RWLIST_WRLOCK(&protos);
1100         AST_RWLIST_REMOVE(&protos, proto, list);
1101         AST_RWLIST_UNLOCK(&protos);
1102 }
1103
1104 int ast_udptl_proto_register(struct ast_udptl_protocol *proto)
1105 {
1106         struct ast_udptl_protocol *cur;
1107
1108         AST_RWLIST_WRLOCK(&protos);
1109         AST_RWLIST_TRAVERSE(&protos, cur, list) {
1110                 if (cur->type == proto->type) {
1111                         ast_log(LOG_WARNING, "Tried to register same protocol '%s' twice\n", cur->type);
1112                         AST_RWLIST_UNLOCK(&protos);
1113                         return -1;
1114                 }
1115         }
1116         AST_RWLIST_INSERT_TAIL(&protos, proto, list);
1117         AST_RWLIST_UNLOCK(&protos);
1118         return 0;
1119 }
1120
1121 static struct ast_udptl_protocol *get_proto(struct ast_channel *chan)
1122 {
1123         struct ast_udptl_protocol *cur = NULL;
1124
1125         AST_RWLIST_RDLOCK(&protos);
1126         AST_RWLIST_TRAVERSE(&protos, cur, list) {
1127                 if (cur->type == chan->tech->type)
1128                         break;
1129         }
1130         AST_RWLIST_UNLOCK(&protos);
1131
1132         return cur;
1133 }
1134
1135 int ast_udptl_bridge(struct ast_channel *c0, struct ast_channel *c1, int flags, struct ast_frame **fo, struct ast_channel **rc)
1136 {
1137         struct ast_frame *f;
1138         struct ast_channel *who;
1139         struct ast_channel *cs[3];
1140         struct ast_udptl *p0;
1141         struct ast_udptl *p1;
1142         struct ast_udptl_protocol *pr0;
1143         struct ast_udptl_protocol *pr1;
1144         struct ast_sockaddr ac0;
1145         struct ast_sockaddr ac1;
1146         struct ast_sockaddr t0;
1147         struct ast_sockaddr t1;
1148         void *pvt0;
1149         void *pvt1;
1150         int to;
1151
1152         ast_channel_lock(c0);
1153         while (ast_channel_trylock(c1)) {
1154                 ast_channel_unlock(c0);
1155                 usleep(1);
1156                 ast_channel_lock(c0);
1157         }
1158         pr0 = get_proto(c0);
1159         pr1 = get_proto(c1);
1160         if (!pr0) {
1161                 ast_log(LOG_WARNING, "Can't find native functions for channel '%s'\n", c0->name);
1162                 ast_channel_unlock(c0);
1163                 ast_channel_unlock(c1);
1164                 return -1;
1165         }
1166         if (!pr1) {
1167                 ast_log(LOG_WARNING, "Can't find native functions for channel '%s'\n", c1->name);
1168                 ast_channel_unlock(c0);
1169                 ast_channel_unlock(c1);
1170                 return -1;
1171         }
1172         pvt0 = c0->tech_pvt;
1173         pvt1 = c1->tech_pvt;
1174         p0 = pr0->get_udptl_info(c0);
1175         p1 = pr1->get_udptl_info(c1);
1176         if (!p0 || !p1) {
1177                 /* Somebody doesn't want to play... */
1178                 ast_channel_unlock(c0);
1179                 ast_channel_unlock(c1);
1180                 return -2;
1181         }
1182         if (pr0->set_udptl_peer(c0, p1)) {
1183                 ast_log(LOG_WARNING, "Channel '%s' failed to talk to '%s'\n", c0->name, c1->name);
1184                 memset(&ac1, 0, sizeof(ac1));
1185         } else {
1186                 /* Store UDPTL peer */
1187                 ast_udptl_get_peer(p1, &ac1);
1188         }
1189         if (pr1->set_udptl_peer(c1, p0)) {
1190                 ast_log(LOG_WARNING, "Channel '%s' failed to talk back to '%s'\n", c1->name, c0->name);
1191                 memset(&ac0, 0, sizeof(ac0));
1192         } else {
1193                 /* Store UDPTL peer */
1194                 ast_udptl_get_peer(p0, &ac0);
1195         }
1196         ast_channel_unlock(c0);
1197         ast_channel_unlock(c1);
1198         cs[0] = c0;
1199         cs[1] = c1;
1200         cs[2] = NULL;
1201         for (;;) {
1202                 if ((c0->tech_pvt != pvt0) ||
1203                         (c1->tech_pvt != pvt1) ||
1204                         (c0->masq || c0->masqr || c1->masq || c1->masqr)) {
1205                                 ast_debug(1, "Oooh, something is weird, backing out\n");
1206                                 /* Tell it to try again later */
1207                                 return -3;
1208                 }
1209                 to = -1;
1210                 ast_udptl_get_peer(p1, &t1);
1211                 ast_udptl_get_peer(p0, &t0);
1212                 if (ast_sockaddr_cmp(&t1, &ac1)) {
1213                         ast_debug(1, "Oooh, '%s' changed end address to %s\n",
1214                                 c1->name, ast_sockaddr_stringify(&t1));
1215                         ast_debug(1, "Oooh, '%s' was %s\n",
1216                                 c1->name, ast_sockaddr_stringify(&ac1));
1217                         ast_sockaddr_copy(&ac1, &t1);
1218                 }
1219                 if (ast_sockaddr_cmp(&t0, &ac0)) {
1220                         ast_debug(1, "Oooh, '%s' changed end address to %s\n",
1221                                 c0->name, ast_sockaddr_stringify(&t0));
1222                         ast_debug(1, "Oooh, '%s' was %s\n",
1223                                 c0->name, ast_sockaddr_stringify(&ac0));
1224                         ast_sockaddr_copy(&ac0, &t0);
1225                 }
1226                 who = ast_waitfor_n(cs, 2, &to);
1227                 if (!who) {
1228                         ast_debug(1, "Ooh, empty read...\n");
1229                         /* check for hangup / whentohangup */
1230                         if (ast_check_hangup(c0) || ast_check_hangup(c1))
1231                                 break;
1232                         continue;
1233                 }
1234                 f = ast_read(who);
1235                 if (!f) {
1236                         *fo = f;
1237                         *rc = who;
1238                         ast_debug(1, "Oooh, got a %s\n", f ? "digit" : "hangup");
1239                         /* That's all we needed */
1240                         return 0;
1241                 } else {
1242                         if (f->frametype == AST_FRAME_MODEM) {
1243                                 /* Forward T.38 frames if they happen upon us */
1244                                 if (who == c0) {
1245                                         ast_write(c1, f);
1246                                 } else if (who == c1) {
1247                                         ast_write(c0, f);
1248                                 }
1249                         }
1250                         ast_frfree(f);
1251                 }
1252                 /* Swap priority. Not that it's a big deal at this point */
1253                 cs[2] = cs[0];
1254                 cs[0] = cs[1];
1255                 cs[1] = cs[2];
1256         }
1257         return -1;
1258 }
1259
1260 static char *handle_cli_udptl_set_debug(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
1261 {
1262         switch (cmd) {
1263         case CLI_INIT:
1264                 e->command = "udptl set debug {on|off|ip}";
1265                 e->usage =
1266                         "Usage: udptl set debug {on|off|ip host[:port]}\n"
1267                         "       Enable or disable dumping of UDPTL packets.\n"
1268                         "       If ip is specified, limit the dumped packets to those to and from\n"
1269                         "       the specified 'host' with optional port.\n";
1270                 return NULL;
1271         case CLI_GENERATE:
1272                 return NULL;
1273         }
1274
1275         if (a->argc < 4 || a->argc > 5)
1276                 return CLI_SHOWUSAGE;
1277
1278         if (a->argc == 4) {
1279                 if (!strncasecmp(a->argv[3], "on", 2)) {
1280                         udptldebug = 1;
1281                         memset(&udptldebugaddr, 0, sizeof(udptldebugaddr));
1282                         ast_cli(a->fd, "UDPTL Debugging Enabled\n");
1283                 } else if (!strncasecmp(a->argv[3], "off", 3)) {
1284                         udptldebug = 0;
1285                         ast_cli(a->fd, "UDPTL Debugging Disabled\n");
1286                 } else {
1287                         return CLI_SHOWUSAGE;
1288                 }
1289         } else {
1290                 struct ast_sockaddr *addrs;
1291                 if (strncasecmp(a->argv[3], "ip", 2))
1292                         return CLI_SHOWUSAGE;
1293                 if (!ast_sockaddr_resolve(&addrs, a->argv[4], 0, 0)) {
1294                         return CLI_SHOWUSAGE;
1295                 }
1296                 ast_sockaddr_copy(&udptldebugaddr, &addrs[0]);
1297                         ast_cli(a->fd, "UDPTL Debugging Enabled for IP: %s\n", ast_sockaddr_stringify(&udptldebugaddr));
1298                 udptldebug = 1;
1299                 ast_free(addrs);
1300         }
1301
1302         return CLI_SUCCESS;
1303 }
1304
1305
1306 static struct ast_cli_entry cli_udptl[] = {
1307         AST_CLI_DEFINE(handle_cli_udptl_set_debug, "Enable/Disable UDPTL debugging")
1308 };
1309
1310 static void __ast_udptl_reload(int reload)
1311 {
1312         struct ast_config *cfg;
1313         const char *s;
1314         struct ast_flags config_flags = { reload ? CONFIG_FLAG_FILEUNCHANGED : 0 };
1315
1316         cfg = ast_config_load2("udptl.conf", "udptl", config_flags);
1317         if (cfg == CONFIG_STATUS_FILEMISSING || cfg == CONFIG_STATUS_FILEUNCHANGED || cfg == CONFIG_STATUS_FILEINVALID) {
1318                 return;
1319         }
1320
1321         udptlstart = 4500;
1322         udptlend = 4999;
1323         udptlfecentries = 0;
1324         udptlfecspan = 0;
1325         use_even_ports = 0;
1326
1327         if (cfg) {
1328                 if ((s = ast_variable_retrieve(cfg, "general", "udptlstart"))) {
1329                         udptlstart = atoi(s);
1330                         if (udptlstart < 1024) {
1331                                 ast_log(LOG_WARNING, "Ports under 1024 are not allowed for T.38.\n");
1332                                 udptlstart = 1024;
1333                         }
1334                         if (udptlstart > 65535) {
1335                                 ast_log(LOG_WARNING, "Ports over 65535 are invalid.\n");
1336                                 udptlstart = 65535;
1337                         }
1338                 }
1339                 if ((s = ast_variable_retrieve(cfg, "general", "udptlend"))) {
1340                         udptlend = atoi(s);
1341                         if (udptlend < 1024) {
1342                                 ast_log(LOG_WARNING, "Ports under 1024 are not allowed for T.38.\n");
1343                                 udptlend = 1024;
1344                         }
1345                         if (udptlend > 65535) {
1346                                 ast_log(LOG_WARNING, "Ports over 65535 are invalid.\n");
1347                                 udptlend = 65535;
1348                         }
1349                 }
1350                 if ((s = ast_variable_retrieve(cfg, "general", "udptlchecksums"))) {
1351 #ifdef SO_NO_CHECK
1352                         if (ast_false(s))
1353                                 nochecksums = 1;
1354                         else
1355                                 nochecksums = 0;
1356 #else
1357                         if (ast_false(s))
1358                                 ast_log(LOG_WARNING, "Disabling UDPTL checksums is not supported on this operating system!\n");
1359 #endif
1360                 }
1361                 if ((s = ast_variable_retrieve(cfg, "general", "T38FaxUdpEC"))) {
1362                         ast_log(LOG_WARNING, "T38FaxUdpEC in udptl.conf is no longer supported; use the t38pt_udptl configuration option in sip.conf instead.\n");
1363                 }
1364                 if ((s = ast_variable_retrieve(cfg, "general", "T38FaxMaxDatagram"))) {
1365                         ast_log(LOG_WARNING, "T38FaxMaxDatagram in udptl.conf is no longer supported; value is now supplied by T.38 applications.\n");
1366                 }
1367                 if ((s = ast_variable_retrieve(cfg, "general", "UDPTLFECEntries"))) {
1368                         udptlfecentries = atoi(s);
1369                         if (udptlfecentries < 1) {
1370                                 ast_log(LOG_WARNING, "Too small UDPTLFECEntries value.  Defaulting to 1.\n");
1371                                 udptlfecentries = 1;
1372                         }
1373                         if (udptlfecentries > MAX_FEC_ENTRIES) {
1374                                 ast_log(LOG_WARNING, "Too large UDPTLFECEntries value.  Defaulting to %d.\n", MAX_FEC_ENTRIES);
1375                                 udptlfecentries = MAX_FEC_ENTRIES;
1376                         }
1377                 }
1378                 if ((s = ast_variable_retrieve(cfg, "general", "UDPTLFECSpan"))) {
1379                         udptlfecspan = atoi(s);
1380                         if (udptlfecspan < 1) {
1381                                 ast_log(LOG_WARNING, "Too small UDPTLFECSpan value.  Defaulting to 1.\n");
1382                                 udptlfecspan = 1;
1383                         }
1384                         if (udptlfecspan > MAX_FEC_SPAN) {
1385                                 ast_log(LOG_WARNING, "Too large UDPTLFECSpan value.  Defaulting to %d.\n", MAX_FEC_SPAN);
1386                                 udptlfecspan = MAX_FEC_SPAN;
1387                         }
1388                 }
1389                 if ((s = ast_variable_retrieve(cfg, "general", "use_even_ports"))) {
1390                         use_even_ports = ast_true(s);
1391                 }
1392                 ast_config_destroy(cfg);
1393         }
1394         if (udptlstart >= udptlend) {
1395                 ast_log(LOG_WARNING, "Unreasonable values for UDPTL start/end ports; defaulting to 4500-4999.\n");
1396                 udptlstart = 4500;
1397                 udptlend = 4999;
1398         }
1399         if (use_even_ports && (udptlstart & 1)) {
1400                 ++udptlstart;
1401                 ast_log(LOG_NOTICE, "Odd numbered udptlstart specified but use_even_ports enabled. udptlstart is now %d\n", udptlstart);
1402         }
1403         if (use_even_ports && (udptlend & 1)) {
1404                 --udptlend;
1405                 ast_log(LOG_NOTICE, "Odd numbered udptlend specified but use_event_ports enabled. udptlend is now %d\n", udptlend);
1406         }
1407         ast_verb(2, "UDPTL allocating from port range %d -> %d\n", udptlstart, udptlend);
1408 }
1409
1410 int ast_udptl_reload(void)
1411 {
1412         __ast_udptl_reload(1);
1413         return 0;
1414 }
1415
1416 void ast_udptl_init(void)
1417 {
1418         ast_cli_register_multiple(cli_udptl, ARRAY_LEN(cli_udptl));
1419         __ast_udptl_reload(0);
1420 }