comparison libpurple/upnp.h @ 15441:56a2a0bb290a

Fix a crash when a network_listen_range process is canceled before its UPnP port mapping completes, which occurs regularly on certain routers when file transfers are initiated and then quickly finished. Much thanks to Elliott Harris and Eric Richie for their hard work with me hunting this down and fixing it.

15439:a415922e2882

 */

#ifndef _GAIM_UPNP_H_
#define _GAIM_UPNP_H_


#ifdef __cplusplus
extern "C" {
#endif

 * @return The IP address of the network, or NULL if something went wrong
 */
const gchar* gaim_upnp_get_public_ip(void);

/**
 * Maps Ports in a UPnP enabled IGD that sits on the local network to
 * this gaim client. Essentially, this function takes care of the port
 * forwarding so things like file transfers can work behind NAT firewalls
 *
 * @param portmap The port to map to this client
 * @param protocol The protocol to map, either "TCP" or "UDP"
 * @param cb an optional callback function to be notified when the mapping
 *           addition is complete
 * @param cb_data Extra data to be passed to the callback
 */
void gaim_upnp_set_port_mapping(unsigned short portmap, const gchar* protocol,
		GaimUPnPCallback cb, gpointer cb_data);

/**
 * Deletes a port mapping in a UPnP enabled IGD that sits on the local network
 * to this gaim client. Essentially, this function takes care of deleting the

 * @param portmap The port to delete the mapping for
 * @param protocol The protocol to map to. Either "TCP" or "UDP"
 * @param cb an optional callback function to be notified when the mapping
 *           removal is complete
 * @param cb_data Extra data to be passed to the callback
 */
void gaim_upnp_remove_port_mapping(unsigned short portmap,
		const gchar* protocol, GaimUPnPCallback cb, gpointer cb_data);

/*@}*/

#ifdef __cplusplus

15441:56a2a0bb290a

 */

#ifndef _GAIM_UPNP_H_
#define _GAIM_UPNP_H_

typedef struct _UPnPMappingAddRemove UPnPMappingAddRemove;

#ifdef __cplusplus
extern "C" {
#endif

 * @return The IP address of the network, or NULL if something went wrong
 */
const gchar* gaim_upnp_get_public_ip(void);

/**
 * Cancel a pending port mapping request initiated with either
 * gaim_upnp_set_port_mapping() or gaim_upnp_remove_port_mapping().
 *
 * @param mapping_data The data returned when you initiated the UPnP mapping request.
 */
void gaim_upnp_cancel_port_mapping(UPnPMappingAddRemove *mapping_data);

/**
 * Maps Ports in a UPnP enabled IGD that sits on the local network to
 * this gaim client. Essentially, this function takes care of the port
 * forwarding so things like file transfers can work behind NAT firewalls
 *
 * @param portmap The port to map to this client
 * @param protocol The protocol to map, either "TCP" or "UDP"
 * @param cb an optional callback function to be notified when the mapping
 *           addition is complete
 * @param cb_data Extra data to be passed to the callback
 *
 * @return Data which can be passed to gaim_upnp_port_mapping_cancel() to cancel
 */
UPnPMappingAddRemove *gaim_upnp_set_port_mapping(unsigned short portmap, const gchar* protocol,
		GaimUPnPCallback cb, gpointer cb_data);

/**
 * Deletes a port mapping in a UPnP enabled IGD that sits on the local network
 * to this gaim client. Essentially, this function takes care of deleting the

 * @param portmap The port to delete the mapping for
 * @param protocol The protocol to map to. Either "TCP" or "UDP"
 * @param cb an optional callback function to be notified when the mapping
 *           removal is complete
 * @param cb_data Extra data to be passed to the callback
 *
 * @return Data which can be passed to gaim_upnp_port_mapping_cancel() to cancel
 */
UPnPMappingAddRemove *gaim_upnp_remove_port_mapping(unsigned short portmap,
		const gchar* protocol, GaimUPnPCallback cb, gpointer cb_data);

/*@}*/

#ifdef __cplusplus