nat_detect.h

00001 /* $Id: nat_detect.h 1988 2008-06-06 14:47:10Z bennylp $ */
00002 /* 
00003  * Copyright (C) 2003-2007 Benny Prijono <benny@prijono.org>
00004  *
00005  * This program is free software; you can redistribute it and/or modify
00006  * it under the terms of the GNU General Public License as published by
00007  * the Free Software Foundation; either version 2 of the License, or
00008  * (at your option) any later version.
00009  *
00010  * This program is distributed in the hope that it will be useful,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00013  * GNU General Public License for more details.
00014  *
00015  * You should have received a copy of the GNU General Public License
00016  * along with this program; if not, write to the Free Software
00017  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 
00018  */
00019 #ifndef __PJNATH_NAT_DETECT_H__
00020 #define __PJNATH_NAT_DETECT_H__
00021 
00026 #include <pjnath/stun_session.h>
00027 
00028 
00029 PJ_BEGIN_DECL
00030 
00031 
00047 typedef enum pj_stun_nat_type
00048 {
00052     PJ_STUN_NAT_TYPE_UNKNOWN,
00053 
00058     PJ_STUN_NAT_TYPE_ERR_UNKNOWN,
00059 
00065     PJ_STUN_NAT_TYPE_OPEN,
00066 
00071     PJ_STUN_NAT_TYPE_BLOCKED,
00072 
00078     PJ_STUN_NAT_TYPE_SYMMETRIC_UDP,
00079 
00086     PJ_STUN_NAT_TYPE_FULL_CONE,
00087 
00097     PJ_STUN_NAT_TYPE_SYMMETRIC,
00098 
00106     PJ_STUN_NAT_TYPE_RESTRICTED,
00107 
00115     PJ_STUN_NAT_TYPE_PORT_RESTRICTED
00116 
00117 } pj_stun_nat_type;
00118 
00119 
00123 typedef struct pj_stun_nat_detect_result
00124 {
00130     pj_status_t          status;
00131 
00135     const char          *status_text;
00136 
00141     pj_stun_nat_type     nat_type;
00142 
00146     const char          *nat_type_name;
00147 
00148 } pj_stun_nat_detect_result;
00149 
00150 
00155 typedef void pj_stun_nat_detect_cb(void *user_data,
00156                                    const pj_stun_nat_detect_result *res);
00157 
00158 
00166 PJ_DECL(const char*) pj_stun_get_nat_name(pj_stun_nat_type type);
00167 
00168 
00191 PJ_DECL(pj_status_t) pj_stun_detect_nat_type(const pj_sockaddr_in *server,
00192                                              pj_stun_config *stun_cfg,
00193                                              void *user_data,
00194                                              pj_stun_nat_detect_cb *cb);
00195 
00196 
00202 PJ_END_DECL
00203 
00204 
00205 #endif  /* __PJNATH_NAT_DETECT_H__ */
00206