sofia-sip/nta_stateless.h File Reference

NTA functions for stateless SIP processing. More...

#include <sofia-sip/nta.h>

Include dependency graph for nta_stateless.h:

Go to the source code of this file.

Defines
#define	NTA_STATELESS_H
	Defined when <sofia-sip/nta_stateless.h> has been included.
Functions
int	nta_msg_tsend (nta_agent_t *agent, msg_t *msg, url_string_t const *u, tag_type_t tag, tag_value_t value,...)
	Forward a request or response message.
int	nta_msg_mreply (nta_agent_t *agent, msg_t *reply, sip_t *sip, int status, char const *phrase, msg_t *req_msg, tag_type_t tag, tag_value_t value,...)
	Reply to a request message.
int	nta_msg_treply (nta_agent_t *self, msg_t *msg, int status, char const *phrase, tag_type_t tag, tag_value_t value,...)
	Reply to a request message.
int	nta_msg_ackbye (nta_agent_t *a, msg_t *msg)
	ACK and BYE an unknown 200 OK response to INVITE.

---

Detailed Description

NTA functions for stateless SIP processing.

Author:

Pekka Pessi <Pekka.Pessi@nokia-email.address.hidden>

Date:

Created: Tue Sep 4 15:54:57 2001 ppessi

---

Define Documentation

#define NTA_STATELESS_H

Defined when <sofia-sip/nta_stateless.h> has been included.

---

Function Documentation

int nta_msg_ackbye	(	nta_agent_t *	agent,
		msg_t *	msg
	)

ACK and BYE an unknown 200 OK response to INVITE.

A UAS may still return a 2XX series response to client request after the client transactions has been terminated. In that case, the UAC can not really accept the call. This function was used to accept and immediately terminate such a call.

Deprecated:

This was a bad idea: see sf.net bug #1750691. It can be used to amplify DoS attacks. Let UAS take care of retransmission timeout and let it terminate the session. As of 1.12.7, this function just returns -1.

int nta_msg_mreply	(	nta_agent_t *	agent,
		msg_t *	reply,
		sip_t *	sip,
		int	status,
		char const *	phrase,
		msg_t *	req_msg,
		tag_type_t	tag,
		tag_value_t	value,
			...
	)

Reply to a request message.

Reply to a request message.

Note:

The ownership of msg is taken over by the function even if the function fails.

int nta_msg_treply	(	nta_agent_t *	agent,
		msg_t *	req_msg,
		int	status,
		char const *	phrase,
		tag_type_t	tag,
		tag_value_t	value,
			...
	)

Reply to a request message.

Parameters:

	agent	nta agent object
	req_msg	request message
	status	status code
	phrase	status phrase (may be NULL if status code is well-known)
	tag,value,...	optional additional headers terminated by TAG_END()

Return values:

	0	when succesful
	-1	upon an error

Note:

The ownership of msg is taken over by the function even if the function fails.

int nta_msg_tsend	(	nta_agent_t *	agent,
		msg_t *	msg,
		url_string_t const *	u,
		tag_type_t	tag,
		tag_value_t	value,
			...
	)

Forward a request or response message.

Note:

The ownership of msg is taken over by the function even if the function fails.