ssdp_request.c File Reference

#include <mupnp/ssdp/ssdp.h>
#include <mupnp/util/log.h>

Functions
mUpnpSSDPRequest *	mupnp_ssdprequest_new (void)
	Create a new SSDP request message.
void	mupnp_ssdprequest_delete (mUpnpSSDPRequest *ssdpReq)
	Destroy an SSDP request message and free resources.
void	mupnp_ssdprequest_setleasetime (mUpnpSSDPRequest *ssdpReq, mUpnpTime value)
mUpnpTime	mupnp_ssdprequest_getleasetime (mUpnpSSDPRequest *ssdpReq)
char *	mupnp_ssdprequest_tostring (mUpnpSSDPRequest *ssdpReq, mUpnpString *ssdpMsg)

Function Documentation

mupnp_ssdprequest_delete()

void mupnp_ssdprequest_delete

(

mUpnpSSDPRequest *

ssdpReq

)

Destroy an SSDP request message and free resources.

Releases all resources associated with the SSDP request, including header fields and message content.

Parameters

ssdpReq

The SSDP request to destroy. May be NULL (no-op if NULL).

Note

After calling this function, the ssdpReq pointer is invalid.

Thread-safe: Must not be called concurrently on the same request.

See also

mupnp_ssdprequest_new()

mupnp_ssdprequest_getleasetime()

mUpnpTime mupnp_ssdprequest_getleasetime

(

mUpnpSSDPRequest *

ssdpReq

)

mupnp_ssdprequest_new()

mUpnpSSDPRequest * mupnp_ssdprequest_new

(

void

)

Create a new SSDP request message.

Allocates and initializes a new SSDP request object, which is used for:

• M-SEARCH discovery requests
• NOTIFY alive/byebye announcements

SSDP requests are HTTP-based messages sent over UDP multicast or unicast.

Returns

A newly-created mUpnpSSDPRequest on success, or NULL if memory allocation fails.

Note

The returned request must be freed with mupnp_ssdprequest_delete() when no longer needed.

Thread-safe: Can be called concurrently from multiple threads.

See also

mupnp_ssdprequest_delete()

mupnp_ssdprequest_setleasetime()

void mupnp_ssdprequest_setleasetime	(	mUpnpSSDPRequest *	ssdpReq,
		mUpnpTime	value )

mupnp_ssdprequest_tostring()

char * mupnp_ssdprequest_tostring	(	mUpnpSSDPRequest *	ssdpReq,
		mUpnpString *	ssdpMsg )