Thu Jul 9 13:40:35 2009

Asterisk developer's documentation


iax2-parser.h

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- A telephony toolkit for Linux.
00003  *
00004  * Implementation of Inter-Asterisk eXchange
00005  * 
00006  * Copyright (C) 2003, Digium
00007  *
00008  * Mark Spencer <markster@digium.com>
00009  *
00010  * This program is free software, distributed under the terms of
00011  * the GNU General Public License
00012  */
00013 
00014 /*!\file
00015  * \brief Implementation of the IAX2 protocol
00016  */
00017  
00018 #ifndef _IAX2_PARSER_H
00019 #define _IAX2_PARSER_H
00020 
00021 #include "asterisk/linkedlists.h"
00022 #include "asterisk/aes.h"
00023 
00024 struct iax_ies {
00025    char *called_number;
00026    char *calling_number;
00027    char *calling_ani;
00028    char *calling_name;
00029    int calling_ton;
00030    int calling_tns;
00031    int calling_pres;
00032    char *called_context;
00033    char *username;
00034    char *password;
00035    unsigned int capability;
00036    unsigned int format;
00037    char *codec_prefs;
00038    char *language;
00039    int version;
00040    unsigned short adsicpe;
00041    char *dnid;
00042    char *rdnis;
00043    unsigned int authmethods;
00044    unsigned int encmethods;
00045    char *challenge;
00046    char *md5_result;
00047    char *rsa_result;
00048    struct sockaddr_in *apparent_addr;
00049    unsigned short refresh;
00050    unsigned short dpstatus;
00051    unsigned short callno;
00052    char *cause;
00053    unsigned char causecode;
00054    unsigned char iax_unknown;
00055    int msgcount;
00056    int autoanswer;
00057    int musiconhold;
00058    unsigned int transferid;
00059    unsigned int datetime;
00060    char *devicetype;
00061    char *serviceident;
00062    int firmwarever;
00063    unsigned int fwdesc;
00064    unsigned char *fwdata;
00065    unsigned char fwdatalen;
00066    unsigned char *enckey;
00067    unsigned char enckeylen;
00068    unsigned int provver;
00069    unsigned short samprate;
00070    int provverpres;
00071    unsigned int rr_jitter;
00072    unsigned int rr_loss;
00073    unsigned int rr_pkts;
00074    unsigned short rr_delay;
00075    unsigned int rr_dropped;
00076    unsigned int rr_ooo;
00077    struct ast_variable *vars;
00078    char *osptokenblock[IAX_MAX_OSPBLOCK_NUM];
00079    unsigned int ospblocklength[IAX_MAX_OSPBLOCK_NUM];
00080 };
00081 
00082 #define DIRECTION_INGRESS 1
00083 #define DIRECTION_OUTGRESS 2
00084 
00085 struct iax_frame {
00086 #ifdef LIBIAX
00087    struct iax_session *session;
00088    struct iax_event *event;
00089 #else
00090    int sockfd;
00091 #endif
00092 
00093    /*! /Our/ call number */
00094    unsigned short callno;
00095    /*! /Their/ call number */
00096    unsigned short dcallno;
00097    /*! Start of raw frame (outgoing only) */
00098    void *data;
00099    /*! Length of frame (outgoing only) */
00100    int datalen;
00101    /*! How many retries so far? */
00102    int retries;
00103    /*! Outgoing relative timestamp (ms) */
00104    unsigned int ts;
00105    /*! How long to wait before retrying */
00106    int retrytime;
00107    /*! Are we received out of order?  */
00108    unsigned int outoforder:1;
00109    /*! Have we been sent at all yet? */
00110    unsigned int sentyet:1;
00111    /*! Non-zero if should be sent to transfer peer */
00112    unsigned int transfer:1;
00113    /*! Non-zero if this is the final message */
00114    unsigned int final:1;
00115    /*! Ingress or outgres */
00116    unsigned int direction:2;
00117    /*! Can this frame be cached? */
00118    unsigned int cacheable:1;
00119    /*! Outgoing Packet sequence number */
00120    int oseqno;
00121    /*! Next expected incoming packet sequence number */
00122    int iseqno;
00123    /*! Retransmission ID */
00124    int retrans;
00125    /*! is this packet encrypted or not. if set this varible holds encryption methods*/
00126    int encmethods;
00127    /*! store encrypt key */
00128    ast_aes_encrypt_key ecx;
00129    /*! store decrypt key which corresponds to ecx */
00130    ast_aes_decrypt_key mydcx;
00131    /*! random data for encryption pad */
00132    unsigned char semirand[32];
00133    /*! Easy linking */
00134    AST_LIST_ENTRY(iax_frame) list;
00135    /*! Actual, isolated frame header */
00136    struct ast_frame af;
00137    /*! Amount of space _allocated_ for data */
00138    size_t afdatalen;
00139    unsigned char unused[AST_FRIENDLY_OFFSET];
00140    unsigned char afdata[0];   /* Data for frame */
00141 };
00142 
00143 struct iax_ie_data {
00144    unsigned char buf[1024];
00145    int pos;
00146 };
00147 
00148 /* Choose a different function for output */
00149 void iax_set_output(void (*output)(const char *data));
00150 /* Choose a different function for errors */
00151 void iax_set_error(void (*output)(const char *data));
00152 void iax_showframe(struct iax_frame *f, struct ast_iax2_full_hdr *fhi, int rx, struct sockaddr_in *sin, int datalen);
00153 void iax_frame_subclass2str(enum iax_frame_subclass subclass, char *str, size_t len);
00154 
00155 const char *iax_ie2str(int ie);
00156 
00157 int iax_ie_append_raw(struct iax_ie_data *ied, unsigned char ie, const void *data, int datalen);
00158 int iax_ie_append_addr(struct iax_ie_data *ied, unsigned char ie, const struct sockaddr_in *sin);
00159 int iax_ie_append_int(struct iax_ie_data *ied, unsigned char ie, unsigned int value);
00160 int iax_ie_append_short(struct iax_ie_data *ied, unsigned char ie, unsigned short value);
00161 int iax_ie_append_str(struct iax_ie_data *ied, unsigned char ie, const char *str);
00162 int iax_ie_append_byte(struct iax_ie_data *ied, unsigned char ie, unsigned char dat);
00163 int iax_ie_append(struct iax_ie_data *ied, unsigned char ie);
00164 int iax_parse_ies(struct iax_ies *ies, unsigned char *data, int datalen);
00165 
00166 int iax_get_frames(void);
00167 int iax_get_iframes(void);
00168 int iax_get_oframes(void);
00169 
00170 void iax_frame_wrap(struct iax_frame *fr, struct ast_frame *f);
00171 struct iax_frame *iax_frame_new(int direction, int datalen, unsigned int cacheable);
00172 void iax_frame_free(struct iax_frame *fr);
00173 #endif

Generated on Thu Jul 9 13:40:35 2009 for Asterisk - the Open Source PBX by  doxygen 1.4.7