#include "utils/list.h"
#include "http.h"

Data Structures
struct	advertisement_state_machine

struct	subscr_addr

struct	subscription

struct	upnp_wps_device_interface

struct	upnp_wps_device_sm

Macros
#define	UPNP_MULTICAST_ADDRESS "239.255.255.250" /* for UPnP multicasting */

#define	UPNP_MULTICAST_PORT 1900 /* UDP port to monitor for UPnP */

#define	UPNP_SUBSCRIBE_SEC_MIN 1800

#define	UPNP_SUBSCRIBE_SEC (UPNP_SUBSCRIBE_SEC_MIN + 1)

#define	UPNP_WPS_DEVICE_XML_FILE "wps_device.xml"

#define	UPNP_WPS_SCPD_XML_FILE "wps_scpd.xml"

#define	UPNP_WPS_DEVICE_CONTROL_FILE "wps_control"

#define	UPNP_WPS_DEVICE_EVENT_FILE "wps_event"

#define	MULTICAST_MAX_READ 1600 /* max bytes we'll read for UPD request */

Enumerations
enum	advertisement_type_enum { ADVERTISE_UP = 0, ADVERTISE_DOWN = 1, MSEARCH_REPLY = 2 }

Functions
void	format_date (struct wpabuf *buf)

struct subscription *	subscription_start (struct upnp_wps_device_sm sm, const char callback_urls)
	Remember a UPnP control point to send events to. More...

struct subscription *	subscription_renew (struct upnp_wps_device_sm *sm, const u8 uuid[UUID_LEN])

void	subscription_destroy (struct subscription *s)

struct subscription *	subscription_find (struct upnp_wps_device_sm *sm, const u8 uuid[UUID_LEN])

void	subscr_addr_delete (struct subscr_addr *a)

int	get_netif_info (const char net_if, unsigned ip_addr, char **ip_addr_text, u8 mac[ETH_ALEN])
	Get hw and IP addresses for network device. More...

void	msearchreply_state_machine_stop (struct advertisement_state_machine *a)
	Stop M-SEARCH reply state machine. More...

int	advertisement_state_machine_start (struct upnp_wps_device_sm *sm)
	Start SSDP advertisements. More...

void	advertisement_state_machine_stop (struct upnp_wps_device_sm *sm, int send_byebye)
	Stop SSDP advertisements. More...

void	ssdp_listener_stop (struct upnp_wps_device_sm *sm)
	Stop SSDP listered. More...

int	ssdp_listener_start (struct upnp_wps_device_sm *sm)
	Set up for receiving discovery (UDP) packets. More...

int	ssdp_listener_open (void)

int	add_ssdp_network (const char *net_if)
	Add routing entry for SSDP. More...

int	ssdp_open_multicast_sock (u32 ip_addr, const char *forced_ifname)

int	ssdp_open_multicast (struct upnp_wps_device_sm *sm)
	Open socket for sending multicast SSDP messages. More...

int	web_listener_start (struct upnp_wps_device_sm *sm)

void	web_listener_stop (struct upnp_wps_device_sm *sm)

int	event_add (struct subscription s, const struct wpabuf data, int probereq)
	Add a new event to a queue. More...

void	event_delete_all (struct subscription *s)

void	event_send_all_later (struct upnp_wps_device_sm *sm)

void	event_send_stop_all (struct upnp_wps_device_sm *sm)

int	upnp_er_set_selected_registrar (struct wps_registrar reg, struct subscription s, const struct wpabuf *msg)

void	upnp_er_remove_notification (struct wps_registrar reg, struct subscription s)

Detailed Description

See wps_upnp.c for more details on licensing and code history.

Function Documentation

int add_ssdp_network ( const char * net_if )

Add routing entry for SSDP.

Parameters

net_if Selected network interface name

Returns: 0 on success, -1 on failure

This function assures that the multicast address will be properly handled by Linux networking code (by a modification to routing tables). This must be done per network interface. It really only needs to be done once after booting up, but it does not hurt to call this more frequently "to be safe".

int advertisement_state_machine_start ( struct upnp_wps_device_sm * sm )

Start SSDP advertisements.

Parameters

sm	WPS UPnP state machine from upnp_wps_device_init()

Returns: 0 on success, -1 on failure

void advertisement_state_machine_stop	(	struct upnp_wps_device_sm *	sm,
		int	send_byebye
	)

Stop SSDP advertisements.

Parameters

sm	WPS UPnP state machine from upnp_wps_device_init()
send_byebye	Send byebye advertisement messages immediately

int event_add	(	struct subscription *	s,
		const struct wpabuf *	data,
		int	probereq
	)

Add a new event to a queue.

Parameters

s	Subscription
data	Event data (is copied; caller retains ownership)
probereq	Whether this is a Probe Request event

Returns: 0 on success, -1 on error, 1 on max event queue limit reached

int get_netif_info	(	const char *	net_if,
		unsigned *	ip_addr,
		char **	ip_addr_text,
		u8	mac[ETH_ALEN]
	)

Get hw and IP addresses for network device.

Parameters

net_if	Selected network interface name
ip_addr	Buffer for returning IP address in network byte order
ip_addr_text	Buffer for returning a pointer to allocated IP address text
mac	Buffer for returning MAC address

Returns: 0 on success, -1 on failure

void msearchreply_state_machine_stop ( struct advertisement_state_machine * a )

Stop M-SEARCH reply state machine.

Parameters

a	Selected advertisement/reply state

int ssdp_listener_start ( struct upnp_wps_device_sm * sm )

Set up for receiving discovery (UDP) packets.

Parameters

sm	WPS UPnP state machine from upnp_wps_device_init()

Returns: 0 on success, -1 on failure

The SSDP listener is stopped by calling ssdp_listener_stop().

void ssdp_listener_stop ( struct upnp_wps_device_sm * sm )

Stop SSDP listered.

Parameters

sm	WPS UPnP state machine from upnp_wps_device_init()

This function stops the SSDP listener that was started by calling ssdp_listener_start().

int ssdp_open_multicast ( struct upnp_wps_device_sm * sm )

Open socket for sending multicast SSDP messages.

Parameters

sm	WPS UPnP state machine from upnp_wps_device_init()

Returns: 0 on success, -1 on failure

struct subscription* subscription_start	(	struct upnp_wps_device_sm *	sm,
		const char *	callback_urls
	)

Remember a UPnP control point to send events to.

Parameters

sm	WPS UPnP state machine from upnp_wps_device_init()
callback_urls	Callback URLs

Returns: NULL on error, or pointer to new subscription structure.

Data Structures

Macros

Enumerations

Functions

Detailed Description

Function Documentation