sofia-sip/nta_stateless.h File Reference


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

#include <sofia-sip/nta.h>

Include dependency graph for nta_stateless.h:

Go to the source code of this file.

Functions

SOFIAPUBFUN 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.
SOFIAPUBFUN 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.
SOFIAPUBFUN 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.
SOFIAPUBFUN int nta_msg_ackbye (nta_agent_t *a, msg_t *msg)
 ACK and BYE an unknown 200 OK response to INVITE.


Function Documentation

SOFIAPUBFUN 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 an INVITE request after the client transaction has been terminated. In that case, the UAC can not really accept the call, but it may send a ACK request to UAS followed immediately by BYE using nta_msg_ackbye(). The function does not create a transaction objects, but just sends the ACK and BYE request messages according to the Record-Route and Contact headers in the msg.

SOFIAPUBFUN 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.

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

SOFIAPUBFUN 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.

SOFIAPUBFUN 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.


Sofia-SIP 1.12.1 - Copyright (C) 2006 Nokia Corporation. All rights reserved. Licensed under the terms of the GNU Lesser General Public License.