BLOG | DOCUMENTATION | TRAC |  Home --> Documentations --> PJLIB-UTIL Reference stun_simple.h /* $Id: stun_simple.h 3553 2011-05-05 06:14:19Z nanang $ */ /* * Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com) * Copyright (C) 2003-2008 Benny Prijono <benny@prijono.org> * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ #ifndef __PJSTUN_H__ #define __PJSTUN_H__ #include <pjlib-util/types.h> #include <pj/sock.h> PJ_BEGIN_DECL /* * This enumeration describes STUN message types. */ typedef enum pjstun_msg_type { PJSTUN_BINDING_REQUEST = 0x0001, PJSTUN_BINDING_RESPONSE = 0x0101, PJSTUN_BINDING_ERROR_RESPONSE = 0x0111, PJSTUN_SHARED_SECRET_REQUEST = 0x0002, PJSTUN_SHARED_SECRET_RESPONSE = 0x0102, PJSTUN_SHARED_SECRET_ERROR_RESPONSE = 0x0112 } pjstun_msg_type; /* * This enumeration describes STUN attribute types. */ typedef enum pjstun_attr_type { PJSTUN_ATTR_MAPPED_ADDR = 1, PJSTUN_ATTR_RESPONSE_ADDR, PJSTUN_ATTR_CHANGE_REQUEST, PJSTUN_ATTR_SOURCE_ADDR, PJSTUN_ATTR_CHANGED_ADDR, PJSTUN_ATTR_USERNAME, PJSTUN_ATTR_PASSWORD, PJSTUN_ATTR_MESSAGE_INTEGRITY, PJSTUN_ATTR_ERROR_CODE, PJSTUN_ATTR_UNKNOWN_ATTRIBUTES, PJSTUN_ATTR_REFLECTED_FROM, PJSTUN_ATTR_XOR_MAPPED_ADDR = 0x0020 } pjstun_attr_type; /* * This structre describes STUN message header. */ typedef struct pjstun_msg_hdr { pj_uint16_t type; pj_uint16_t length; pj_uint32_t tsx[4]; } pjstun_msg_hdr; /* * This structre describes STUN attribute header. */ typedef struct pjstun_attr_hdr { pj_uint16_t type; pj_uint16_t length; } pjstun_attr_hdr; /* * This structre describes STUN MAPPED-ADDR attribute. */ typedef struct pjstun_mapped_addr_attr { pjstun_attr_hdr hdr; pj_uint8_t ignored; pj_uint8_t family; pj_uint16_t port; pj_uint32_t addr; } pjstun_mapped_addr_attr; typedef pjstun_mapped_addr_attr pjstun_response_addr_attr; typedef pjstun_mapped_addr_attr pjstun_changed_addr_attr; typedef pjstun_mapped_addr_attr pjstun_src_addr_attr; typedef pjstun_mapped_addr_attr pjstun_reflected_form_attr; typedef struct pjstun_change_request_attr { pjstun_attr_hdr hdr; pj_uint32_t value; } pjstun_change_request_attr; typedef struct pjstun_username_attr { pjstun_attr_hdr hdr; pj_uint32_t value[1]; } pjstun_username_attr; typedef pjstun_username_attr pjstun_password_attr; typedef struct pjstun_error_code_attr { pjstun_attr_hdr hdr; pj_uint16_t ignored; pj_uint8_t err_class; pj_uint8_t number; char reason[4]; } pjstun_error_code_attr; typedef struct pjstun_msg { pjstun_msg_hdr *hdr; int attr_count; pjstun_attr_hdr *attr[PJSTUN_MAX_ATTR]; } pjstun_msg; /* STUN message API (stun.c). */ PJ_DECL(pj_status_t) pjstun_create_bind_req( pj_pool_t *pool, void **msg, pj_size_t *len, pj_uint32_t id_hi, pj_uint32_t id_lo); PJ_DECL(pj_status_t) pjstun_parse_msg( void *buf, pj_size_t len, pjstun_msg *msg); PJ_DECL(void*) pjstun_msg_find_attr( pjstun_msg *msg, pjstun_attr_type t); PJ_DECL(pj_status_t) pjstun_get_mapped_addr( pj_pool_factory *pf, int sock_cnt, pj_sock_t sock[], const pj_str_t *srv1, int port1, const pj_str_t *srv2, int port2, pj_sockaddr_in mapped_addr[]); PJ_END_DECL #endif /* __PJSTUN_H__ */   PJLIB-UTIL Open Source, small footprint, and portable asynchronous/caching DNS resolver, text scanner, STUN client, and XML library Copyright (C) 2006-2009 Teluu Inc.