Mercurial > pidgin
view libpurple/nat-pmp.h @ 15903:6f04fe174f40
Change some stuff from gaim to pidgin
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Sun, 25 Mar 2007 01:28:40 +0000 |
parents | 9cfe41743c65 |
children | 2cf21661f828 |
line wrap: on
line source
/** * @file nat-pmp.h NAT-PMP Implementation * @ingroup core * * purple * * Purple is the legal property of its developers, whose names are too numerous * to list here. Please refer to the COPYRIGHT file distributed with this * source distribution. * * Most code in nat-pmp.h copyright (C) 2007, R. Tyler Ballance, bleep, LLC. * This file is distributed under the 3-clause (modified) BSD license: * Redistribution and use in source and binary forms, with or without modification, are permitted * provided that the following conditions are met: * * Redistributions of source code must retain the above copyright notice, this list of conditions and * the following disclaimer. * Neither the name of the bleep. LLC nor the names of its contributors may be used to endorse or promote * products derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY * OF SUCH DAMAGE. */ #ifndef _PURPLE_NAT_PMP_H #define _PURPLE_NAT_PMP_H #include <stdint.h> #define PURPLE_PMP_LIFETIME 3600 /* seconds */ /* * uint8_t: version, opcodes * uint16_t: resultcode * unint32_t: epoch (seconds since mappings reset) */ typedef enum { PURPLE_PMP_TYPE_UDP, PURPLE_PMP_TYPE_TCP } PurplePmpType; typedef struct { uint8_t version; uint8_t opcode; } PurplePmpIpRequest; typedef struct { uint8_t version; uint8_t opcode; // 128 + n uint16_t resultcode; uint32_t epoch; uint32_t address; } PurplePmpIpResponse; typedef struct { uint8_t version; uint8_t opcode; char reserved[2]; uint16_t privateport; uint16_t publicport; uint32_t lifetime; } PurplePmpMapRequest; typedef struct { uint8_t version; uint8_t opcode; uint16_t resultcode; uint32_t epoch; uint16_t privateport; uint16_t publicport; uint32_t lifetime; } PurplePmpMapResponse; /** * */ /* * TODO: This should probably cache the result of this lookup requests * so that subsequent calls to this function do not require a * round-trip exchange with the local router. */ char *purple_pmp_get_public_ip(); /** * */ PurplePmpMapResponse *purple_pmp_create_map(PurplePmpType type, uint16_t privateport, uint16_t publicport, uint32_t lifetime); /** * */ PurplePmpMapResponse *purple_pmp_destroy_map(PurplePmpType type, uint16_t privateport); #endif /* _PURPLE_NAT_PMP_H_ */