parser.h

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Implementation of Inter-Asterisk eXchange
 *
 * Copyright (C) 2003, Digium
 *
 * Mark Spencer <[email protected]>
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License
 */

/*!\file
 * \brief Implementation of the IAX2 protocol
 */

#ifndef _IAX2_PARSER_H
#define _IAX2_PARSER_H

#include "asterisk/frame.h"
#include "asterisk/linkedlists.h"
#include "asterisk/crypto.h"
#include "asterisk/netsock2.h"
#include "iax2.h"

struct iax_ies {
   char *called_number;
   char *calling_number;
   char *calling_ani;
   char *calling_name;
   int calling_ton;
   int calling_tns;
   int calling_pres;
   char *called_context;
   char *username;
   char *password;
   iax2_format capability;
   iax2_format format;
   char *codec_prefs;
   char *language;
   int version;
   unsigned short adsicpe;
   char *dnid;
   char *rdnis;
   unsigned int authmethods;
   unsigned int encmethods;
   char *challenge;
   char *md5_result;
   char *rsa_result;
   struct ast_sockaddr apparent_addr;
   unsigned short refresh;
   unsigned short dpstatus;
   unsigned short callno;
   char *cause;
   unsigned char causecode;
   unsigned char iax_unknown;
   int msgcount;
   int autoanswer;
   int musiconhold;
   unsigned int transferid;
   unsigned int datetime;
   char *devicetype;
   char *serviceident;
   int firmwarever;
   unsigned int fwdesc;
   unsigned char *fwdata;
   unsigned char fwdatalen;
   unsigned char *enckey;
   unsigned char enckeylen;
   unsigned int provver;
   unsigned short samprate;
   int provverpres;
   unsigned int rr_jitter;
   unsigned int rr_loss;
   unsigned int rr_pkts;
   unsigned short rr_delay;
   unsigned int rr_dropped;
   unsigned int rr_ooo;
   struct ast_variable *vars;
   char *osptokenblock[IAX_MAX_OSPBLOCK_NUM];
   unsigned int ospblocklength[IAX_MAX_OSPBLOCK_NUM];
   unsigned char calltoken;
   unsigned char *calltokendata;
};

#define DIRECTION_INGRESS 1
#define DIRECTION_OUTGRESS 2

struct iax_frame {
#ifdef LIBIAX
   struct iax_session *session;
   struct iax_event *event;
#else
   int sockfd;
#endif

   /*! /Our/ call number */
   unsigned short callno;
   /*! /Their/ call number */
   unsigned short dcallno;
   /*! Start of raw frame (outgoing only) */
   void *data;
   /*! Length of frame (outgoing only) */
   int datalen;
   /*! How many retries so far? */
   int retries;
   /*! Outgoing relative timestamp (ms) */
   unsigned int ts;
   /*! How long to wait before retrying */
   int retrytime;
   /*! Are we received out of order?  */
   unsigned int outoforder:1;
   /*! Have we been sent at all yet? */
   unsigned int sentyet:1;
   /*! Non-zero if should be sent to transfer peer */
   unsigned int transfer:1;
   /*! Non-zero if this is the final message */
   unsigned int final:1;
   /*! Ingress or outgres */
   unsigned int direction:2;
   /*! Can this frame be cached? */
   unsigned int cacheable:1;
   /*! Outgoing Packet sequence number */
   int oseqno;
   /*! Next expected incoming packet sequence number */
   int iseqno;
   /*! Retransmission ID */
   int retrans;
   /*! is this packet encrypted or not. if set this varible holds encryption methods*/
   int encmethods;
   /*! store encrypt key */
   ast_aes_encrypt_key ecx;
   /*! store decrypt key which corresponds to ecx */
   ast_aes_decrypt_key mydcx;
   /*! random data for encryption pad */
   unsigned char semirand[32];
   /*! Easy linking */
   AST_LIST_ENTRY(iax_frame) list;
   /*! Actual, isolated frame header */
   struct ast_frame af;
   /*! Amount of space _allocated_ for data */
   size_t afdatalen;
   unsigned char unused[AST_FRIENDLY_OFFSET];
   unsigned char afdata[0];   /* Data for frame */
};

struct iax_ie_data {
   unsigned char buf[1024];
   int pos;
};

/* Choose a different function for output */
void iax_set_output(void (*output)(const char *data));
/* Choose a different function for errors */
void iax_set_error(void (*output)(const char *data));
void iax_showframe(struct iax_frame *f, struct ast_iax2_full_hdr *fhi, int rx, struct ast_sockaddr *addr, int datalen);
void iax_frame_subclass2str(enum iax_frame_subclass subclass, char *str, size_t len);

const char *iax_ie2str(int ie);

int iax_ie_append_raw(struct iax_ie_data *ied, unsigned char ie, const void *data, int datalen);
int iax_ie_append_addr(struct iax_ie_data *ied, unsigned char ie, const struct ast_sockaddr *addr);
int iax_ie_append_versioned_uint64(struct iax_ie_data *ied, unsigned char ie, unsigned char version, uint64_t value);
int iax_ie_append_int(struct iax_ie_data *ied, unsigned char ie, unsigned int value);
int iax_ie_append_short(struct iax_ie_data *ied, unsigned char ie, unsigned short value);
int iax_ie_append_str(struct iax_ie_data *ied, unsigned char ie, const char *str);
int iax_ie_append_byte(struct iax_ie_data *ied, unsigned char ie, unsigned char dat);
int iax_ie_append(struct iax_ie_data *ied, unsigned char ie);
int iax_parse_ies(struct iax_ies *ies, unsigned char *data, int datalen);

int iax_get_frames(void);
int iax_get_iframes(void);
int iax_get_oframes(void);

void iax_frame_wrap(struct iax_frame *fr, struct ast_frame *f);
struct iax_frame *iax_frame_new(int direction, int datalen, unsigned int cacheable);
void iax_frame_free(struct iax_frame *fr);
#endif